qstat-torque (1) - Linux Manuals
qstat-torque: show status of pbs batch jobs
NAME
qstat - show status of pbs batch jobs
SYNOPSIS
qstat [-f [-1]] [-l] [-W site_specific] [-x] [job_identifier... | destination...]
qstat [-a|-i|-r|-e] [-l] [-n [-1]] [-s] [-G|-M] [-R] [-u user_list] [job_identifier... |
qstat -Q [-f [-1]][-W site_specific] [-l] [destination...]
qstat -q [-G|-M] [-l] [destination...]
qstat -B [-f [-1]][-W site_specific] [-l] [server_name...]
When requesting job status, synopsis format 1 or 2,
qstat
will output information about each
or all jobs at each
Jobs for which the user does not have status privilege are not displayed.
When requesting queue or server status, synopsis format 3 through 5, qstat
will output information about each
echo sleep 20 | qsub -t 0-299 189[].pali
Individual jobs in the array are now also noted using square brackets instead of
dashes; for example, here is part of the output of qstat -t for the preceding array:
189[299].napali STDIN[299] dbeer 0 Q batch
If the operand is a job identifier, it must be in the following form:
If the operand is a destination identifier, it is one of the following
three forms:
If the
option is given, the operands are destination identifiers as specified
above. If
is specified, the status of that queue at the default server will be given.
If
is specified, the status of the named queue at the named server will be given.
If
is specified, the status of all queues at
the named server will be given.
If no destination is specified, the status of all queues at the default
server will be given.
If the
option is given, the operand is the name of a server.
If job status is being displayed in the default format and the
option is not specified, the following items are displayed on a single
line, in the specified order, separated by white space:
If job status is being displayed and the
option is specified, the output will depend on whether
qstat
was compiled to use a
Tcl
interpreter. See the configuration section
for details. If
Tcl
is not being used,
full display for each job consists of the header line:
If any of the options -a, -i, -r, -u, -n, -s, -G or -M are provided,
the alternative display format for jobs is used.
The following items are displayed on a single
line, in the specified order, separated by white space:
Displaying Queue Status
If queue status is being displayed and the
option was not specified, the following items are displayed on a single
line, in the specified order, separated by white space:
If queue status is being displayed and the
option is specified, the output will depend on whether
qstat
was compiled to use a
Tcl
interpreter. See the configuration section
for details. If
Tcl
is not being used,
the full display for each queue consists of the header line:
If the -q option is specified, queue information is displayed in the
alternative format: The following information is displayed on a single
line:
Displaying Server Status
If batch server status is being displayed and the
option is not specified, the following items are displayed on a single
line, in the specified order, separated by white space:
If server status is being displayed and the
option is specified, the output will depend on whether
qstat
was compiled to use a
Tcl
interpreter. See the configuration section
for details. If
Tcl
is not being used,
the full display for the server consist of the header line:
the
flags
list would contain
The
operands
list contains all other command line arguments following the flags.
There will always be at least one element in
operands
because if no operands are typed by the user, the default destination
or server name is used. The
objects
list contains all the information retrieved from the server(s)
so the Tcl interpreter can run once to format the entire output.
This list has the same number of elements as the
operands
list. Each element is another list with two elements. The first
element is a string giving the type of objects to be found in the
second. The string can take the values
"server", "queue", "job" or "error". The second element will be a
list in which each element is a single batch status object of the type given
by the string discussed above. In the case of "error", the list
will be empty. Each object is again a list.
The first element is the name of the object. The second is a list
of attributes. The third element will be the object text.
All three of these object elements correspond with fields in the structure
which is described in detail for each type of object by the man pages for
pbs_statjob(3), pbs_statque(3), and pbs_statserver(3).
Each attribute in the second element
list whose elements correspond with the
structure. Each will be a list with two elements. The first will be
the attribute name and the second will be the attribute value.
If the qstat command fails to process any operand, the
command exits with a value greater than zero.
DESCRIPTION
The
qstat
command is used to request the status of jobs, queues, or a batch server.
The requested status is written to standard out.
OPTIONS
Host names may be wild carded on the left end, e.g. "*.nasa.gov".
User_name without a "@host" is equivalent to "user_name@*", that is at any host.
OPERANDS
If neither the
nor the
option is given, the operands on the qstat
command must be either job identifiers or destinations identifiers.
where
is the job identifier assigned at submittal time, see
qsub.
If the
is omitted, the name of the default server will be used.
If
is supplied, the request will be for the job identifier currently at that
Server.
If
is specified, the request is for status of all jobs in that queue at the
default server. If the
form is given, the request is for status of all jobs at that server.
If a full destination identifier,
is given, the request is for status of all jobs in the named queue at the
named server.
STANDARD OUTPUT
Displaying Job Status
E -
H -
Q -
R -
T -
W -
S -
job identifier
Followed by one line per job attribute of the form:
If the -R option is provided, the line contains:
The last three fields may not contain useful information at all sites
or on all systems.
Note: Remaining walltime does not account for walltime multiplication factors.
queue_name
Followed by one line per queue attribute of the form:
- either the letter E if the queue is Enabled or D if Disabled, and
- either the letter R if the queue is Running (started) or S if Stopped.
server name
Followed by one line per server attribute of the form:
STANDARD ERROR
The qstat command will write a diagnostic message to standard error for
each error occurrence.
CONFIGURATION
If
qstat
is compiled with an option to include a
Tcl
interpreter, using the
flag to get a full display causes a check to be made for a script file
to use to output the requested information. The first location checked
is $HOME/.qstatrc. If this does not exist, the next location
checked is administrator configured. If one of these is found, a
Tcl
interpreter is started and the script file is passed to it along
with three global variables. The command line arguments
are split into two variable named
flags
and
operands .
The status information is passed in a variable named
objects .
All of these variables are
Tcl
lists.
The
flags
list contains the name of the command (usually "qstat") as its first
element. Any other elements are command line option flags with any
options they use, presented in the order given on the command line.
They are broken up individually so that if two flags are given
together on the command line, they are separated in the list.
For example, if the user typed
EXIT STATUS
Upon successful processing of all the operands presented to the
qstat command, the exit status will be a value of zero.
SEE ALSO
qalter(1B), qsub(1B), pbs_alterjob(3B), pbs_statjob(3B), pbs_statque(3B),
pbs_statserver(3B), pbs_submit(3B),
pbs_job_attributes(7B), pbs_queue_attributes(7B), pbs_server_attributes(7B),
pbs_resources_*(7B) where * is system type, and the PBS ERS.