Technical data

Setting Up and Maintaining Queues
14.7 Maintaining Queues
Qualifier Description
/ALL_JOBS Displays information about all jobs for the selected queues.
/BRIEF Displays a brief listing of information about job entries in the queue.
The brief listing is the default for the SHOW QUEUE command.
/FILES Adds a list of files associated with each job to the display.
/FULL Displays complete queue and job information (also displays any ACLs set
for the queues).
/SUMMARY Displays the total number of executing, pending, holding, retained, and
timed release jobs. The jobs themselves are not displayed.
You can also combine certain qualifiers to further delineate the queue information
you want to display.
Table 14–5 defines queue statuses returned by SHOW QUEUE.
Table 14–5 Queue Statuses Displayed in the SHOW QUEUE Command
Queue Status Description
Aligning Queue manager is processing a START/QUEUE/ALIGN command.
Autostart
inactive
Queue was stopped and needs to be activated. For more information,
see Section 14.8.4.
Available Queue is processing at least one job but is capable of processing
additional concurrent jobs.
Busy Queue cannot process additional jobs because of one or more jobs in
progress.
Closed Queue is closed and will not accept new jobs until it is set open. For
more information, see Section 14.7.1.4.
Device
unavailable
Device to which the queue is assigned is not available.
Idle Queue is not processing any jobs and is capable of doing so.
Paused A STOP/QUEUE command has been executed.
Pausing Queue manager is processing a STOP/QUEUE command.
Remote Queue is assigned to a physical device that is not connected to the local
system.
Resuming Queue manager is processing a START/QUEUE command on a paused
queue.
Server Queue processing is directed to a server symbiont.
Stalled Symbiont processing temporarily halted due to device-related problem.
Starting Queue has been started, but the symbiont process is not yet active.
Stopped Queue is stopped and will not process work until started.
Stop pending Queue will be in the stopped state when current jobs have finished
executing.
Stopping Queue is being stopped.
To display the forms or characteristics available on a system, use the SHOW
QUEUE/FORM or SHOW QUEUE/CHARACTERISTICS command.
You can further customize the type of queue information you want to monitor
by writing a command procedure that uses the F$GETQUI lexical function.
F$GETQUI invokes the $GETQUI system service to return information stored in
the queue database.
Setting Up and Maintaining Queues 14–57