JSQ(1) General Commands Manual JSQ(1)
NAME
jsq - show job scheduler's queue and resource levels
SYNOPSIS
jsq [ -V | --version ] [ -v | --verbose | -d level | --debug=level ] [
-h | --help ] [ -p | --paths ] [ -n | --simulate ] [ -a ]
DESCRIPTION
Jsq shows the status of pending and running jobs in jsd(1)'s queue and
the maximum and current consumption of each resource.
CONFIGURATION
None
OPTIONS
-d level, --debug=level Determines how verbose this program will be.
The message types displayed for the different
values of level are as follows: 0 displays no
messages; 1 displays only errors, 2 displays
errors and warnings; 3 displays errors, warn-
ings and informational messages; higher values
display errors, warnings, informational mes-
sages and various messages intended for debug-
ging. The default is 2.
-h, --help Displays a brief usage message.
-p, --paths Lists the compiled-in paths of various files
and directories that this program uses. -n,
--simulate Some external commands that this
program runs may be displayed rather than ac-
tually executed. BEWARE: different programs
implement different levels of simulation; so
this option may work perfectly; on the other
hand it may do nothing at all!
-v, --verbose Equivalent to -d 3.
-V, --version Prints the program's version number and exits.
-a Includes the status of completed and cancelled
jobs in jsd(1)'s queue.
EXIT STATUS
On success jsq returns zero. On failure it returns non-zero and dis-
plays a diagnostic message.
FILES
None.
ENVIRONMENT VARIABLES
JS_NAME or LOGNAME If JS_NAME is set then it is used to set the
name of the instance of jsd(1) with which to
communicate. If that is not set then LOGNAME
is used instead. If that is also not set then
an error occurs.
EXAMPLES
This command shows all jobs in the queue, including those that have
been completed, and the maximum and current consumption of each re-
source:
jsq -a
CAVEATS
None
STANDARDS
This manual page documents version 2 of jsq.
SEE ALSO
js-config(1), jsc(1), jsd(1), jss(1)
AUTHOR
Alexis Huxley <alexishuxley@gmail.com>
COPYRIGHT & DISTRIBUTION POLICY
Copyright (C) 2015-2024 Alexis Huxley
This program is free software; you can redistribute it and/or modify it
under the terms of the GNU General Public License as published by the
Free Software Foundation; either version 2 of the License, or (at your
option) any later version.
This program is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of MER-
CHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General
Public License for more details.
You should have received a copy of the GNU General Public License along
with this program; if not, write to the Free Software Foundation, Inc.,
675 Mass Ave, Cambridge, MA 02139, USA.
26 Jul 2024 JSQ(1)
