$D Q - Display the number of jobs queued
Function
To display the number of jobs on a particular queue and the percentage of spool disk use.
Syntax
Parameters
- Q
- JES2 displays the number of jobs on the specified job queue.
- memname
- Specifies the identifier (one to four characters using A-Z, 0-9, $, #, and @) of a member in the JES2 multi-access spool configuration that has affinity for the job.
- ANY
- JES2 displays the number of jobs on the specified queue whose affinity is for any member in the multi-access spool configuration.
- ALL
- JES2 displays the number of jobs on the specified queue, regardless of affinity. The counts are given for each member in the multi-access spool configuration. A job is counted multiple times if its queued affinity includes multiple members.
- IND
- JES2 displays
the number of jobs on the specified queue whose affinity is for members
operating in independent mode. Note: The first two operands of the $D Q command (those operands concerning affinity) are positional in nature; if entered, they must be in the order shown.
- V=volser
- JES2 displays job information and percentage of spool disk utilization for all jobs that have data on the spool volume specified by volser.
- R=
- The
output group destination or range of destinations (low to high) for
which job information is displayed. If you omit this operand or specify
this operand without a node id when entering the command from a remote
workstation or another node (through a node send command, $Nn), JES2
displays only those jobs with a default print/punch routing to that
particular remote or node. Therefore, if you want to display jobs
with print/punch routing of the target node, this operand must be
specified with a node id of the target node (for example, R=N2.U25
or R=NEWYORK.R41.) For further information, refer to the section on
SEND commands through the network. See Route codes for additional information. The value for all routing numbers
can range from 1 to 32767. The valid specifications are:
- LOCAL|ANYLOCAL
- Indicates that the number of jobs queued is displayed at the local node.
- destid
- Indicates that the number of jobs queued is displayed at the specified node(s) through an alias for the name of the node.
- Nnnnn|nodename
- Indicates that the number of jobs queued is displayed at the specified node(s) through the decimal node identifier or an EBCDIC nodename.
- NnnnnRmmmm|node.remote
- Indicates that the number of jobs queued is displayed at the remote Rmmmm at the node Nnnnn. Rmmmm can also be specified as RMmmmm or RMTmmmm.
- Ummmm
- Indicates that the number of jobs queued is displayed at a special local routing. Wild cards are not supported.
- node.destid
- Indicates that the number of jobs queued is displayed at a destination at the specified node. The destid refers to both the node and the remote.
- node.*
- Displays output for all userids at the local node.
- remote
- Indicates that the number of jobs queued is displayed at a remote
destination. Remote can be specified in any of the following ways:
- LOCAL|ANYLOCAL
- Indicates that the number of jobs queued is displayed at the local node.
- Rmmmm
- Indicates that the number of jobs queued is displayed at the specified remote. Rmmmm can also be specified as RMmmmm or RMTmmmm.
- destid
- Indicates that the number of jobs queued is displayed at a destid referring to a remote.
- *
- Displays all output for the local node, including special local, userid, and a remote workstation on the local node.
- node.*-node.*
- Displays all output for each node in the range. The range may include the local node.
- Nnnnn-Nnnnn
- Displays all output for each node in the range. The range may include the local node.
- NnnnnRmmmm-NnnnnRmmmm
- Displays a range of remotes at a node. Both node identifiers must be the same.
- Rmmmm-Rmmmm
- Displays all output for each remote in the range.
- Unnnn-Unnnn
- Displays all output for each special local node in the range. Wild cards are not supported.
For the second value of the destination range, all specification values from the R= parameter are valid except for *, node.* and Ummmm. Refer to the syntax diagram.
- Q=CNV
- JES2 displays
the number of jobs waiting for conversion. You can specify one of
the following values for cnv:
- *
- JES2 displays the number of jobs waiting for conversion in all classes (including STC and TSU). Specifying CNV* is equivalent to specifying CNV.
- class
- The execution class for which jobs waiting for conversion are counted.
- STC or $
- JES2 displays the number of started tasks waiting for conversion. This operand can be abbreviated $.
- TSU or @
- JES2 displays the number of time-sharing users waiting for conversion. This operand can be abbreviated @.
- Q=XEQ
- JES2 displays
the number of jobs waiting for execution. You can specify one of the
following values for xeq:
- *
- JES2 displays the number of jobs waiting for execution in all classes (including STC and TSU). Specifying XEQ* is equivalent to specifying XEQ.
- class
- The execution class for which jobs waiting for execution are counted.
- STC or $
- JES2 displays the number of started tasks waiting for execution. This operand can be abbreviated $.
- TSU or @
- JES2 displays the number of time-sharing users waiting for execution. This operand can be abbreviated @.
- Q=OUT
- JES2 displays the number of jobs waiting for output processing.
- Q=PPU
- JES2 displays the number of jobs waiting for print/punch processing.
- Q=HOLD
- JES2 displays the number of jobs waiting for any activity and in hold status.
- Q=XMT
- JES2 displays
the number of jobs queued for execution on other nodes. See Route codes for additional information. The destination
that is converted to the lower (or only) route code should be specified
first, followed by the destination with the higher route code. If,
for example, NEWYORK is the node name equivalent to N1 and DENVER
is the node name equivalent to N10, then Q=XMT NEWYORK-DENVER is the
order required to display jobs on the transmit queue for nodes N1,N2,...N10.
The valid specifications are:
- LOCAL|ANYLOCAL
- Indicates that the number of jobs queued is displayed at the local node.
- Nnnnn|nodename
- Indicates that the number of jobs queued is displayed at the specified node through the decimal node identifier or an EBCDIC nodename. You can also specify a range (low to high).
- destid
- Indicates that the number of jobs queued is displayed at the specified node(s) through an alias for the name of the node.
Note: Since the system only transmits jobs to NJE nodes, destinations that refer to a remote work station are converted to the node to which that remote workstation is attached.
Authority Required
This command requires display authority. The description of the $T RDRnn command explains how to ensure that the authority of the appropriate MVS™ system command group is assigned.
This command requires read security access authority. For a description of assigning command input authority, see z/OS JES2 Initialization and Tuning Guide.
Processing Considerations
If you do not specify the Q= parameter, JES2 displays the number of jobs in each of the queues described above, except the HOLD queue.
Scope
MAS-wide. This command can display information about jobs on any or all members of the MAS, depending on the parameters you provide.
Messages
- $HASP630 — displays the SPOOL volume status, if you specify the V= operand.
- $HASP642 — displays the number of jobs in HOLD, if you specify Q=HOLD.
- $HASP643 — displays the number of jobs in the print/punch queue.
- $HASP644 — displays the number of jobs in the output queue.
- $HASP645 — displays the number of jobs in the transmit queue (XMT).
- $HASP646 — displays the percentage of spool utilization.
- $HASP647 — displays the number of jobs on the conversion and execution queues.
Examples
1 $dq,spl2
$HASP647 1 XEQ A SPL2
$HASP647 1 XEQ H SPL2
$HASP643 3 PPU LOCAL ANY
$HASP646 10 PERCENT SPOOL UTILIZATION
2 $dq,spl2,q=hold,v=spool4
$HASP642 1 HOLD SPL2
$HASP630 VOLUME SPOOL4 ACTIVE 25 PERCENT UTILIZATION
There is 1 job on the hold queue on a member identified as SPL2. 25 percent of volume SPOOL4 is allocated.
3
$dq,q=xeqc
$HASP647 1 XEQ C IBM1
$HASP647 67.8095 PERCENT SPOOL UTILIZATION