qb 1 LOCAL 05 July 1994
NAME
qb - query one or more batch queues (HP/UX)
SYNTAX
qb all [nolist|list] [l|lf] | [l|lf] QUEUE [QUEUE ... ]
parallel
private
single
fda
all :: a special token to list all the 'par' queues
parallel :: a special token to list only parallel queues
single :: a special token to list only the single host queues
medium :: list queues best for "medium" sized jobs
large :: list designated queues for really large jobs
private :: a special token to list only the 'private' queues
fda :: a special token to list all the 'fda' queues
nolist :: suppress listing of queue entries (processes only)
l,lf :: long or long,full listing (default is full)
QUEUE :: the name of a batch queue; prompted for if not supplied
l :: long listing, showing memory usage (SZ; 4K chunks)
lf :: long, full listing, showing memory usage, userid, full command
SYNOPSIS
If no arguments are supplied, queue name(s) are prompted for, and the special
tokens (all, parallel, etc.) are not valid in response to the prompt. The
queue name(s) are validated against the list of queues maintained in
/batch/batch_queues, and 'qb' skips to the next queue name or exits if
the queue is not defined. Multiple queue names may be entered either as
arguments or in response to the prompt; the optional flags "l" or "lf" will
change the listing format for active queue processes.
The command lists the status (ps -f) of any active
jobs, and all processes belonging to the userid owning the active batch job
for each queue name supplied, or all queues for the "all" token. To reduce
extraneous processes from interactive sessions, programs such as xterm, csh,
hpterm, dmx, and vuewm are excluded explicitly from the process listing. The
contents of each 'queue.txt' file are also listed, but can be suppressed for
the special tokens via the keyword "nolist".
Note that the options following a special token are positional; to override
the default "full" listing of processes, one of the list/nolist keywords must
be used ('qb single l' is not valid; 'qb single nolist l' is okay).
EXAMPLES
% == prompt
% qb all
(queue listing)
% qb single nolist
(queue listing)
% qb par0 par11 par4
(queue listing)
% qb
Queue name(s)
l par9 par15
(queue listing)
FILES
/usr/local/bin:
qb query batch queues; user command
/batch:
batch_queues the list of active queues
queue.txt queue entry file for an active queue
SEE ALSO
submit, batchq, whodo, kill, remsh
AUTHORS
Initial Aegis batch system by BR Brooks, with contributions by RM Venable.
Unix /bin/csh translation and enhancements by RM Venable.
BUGS
You tell me: rvenable@deimos.cber.nih.gov
Information and HTML Formatting Courtesy of:
NHLBI/LBC Computational Biophtsics Section
FDA/CBER/OVRR Biophysics Laboratory