$D Q

Function

To display the number of jobs on a particular queue and the percentage of spool disk use.

Syntax


>>-$D--Q--+----------+--+-------------+------------------------->
          +-,IND-----+  '-,V=--volser-'   
          +-,memname-+                    
          +-,ANY-----+                    
          +-,ALL-----+                    
          '-,IND-----'                    

>--,R=--+--------------------------------------+---------------->
        +-LOCAL--|--ANYLOCAL-------------------+   
        +-destid-------------------------------+   
        +-N--nnnn--|--nodename-----------------+   
        +-N--nnnn--R--mmmm--|--node--.--remote-+   
        +-U--mmmm------------------------------+   
        +-node--.--destid----------------------+   
        +-node--.--*---------------------------+   
        +-remote-------------------------------+   
        +-*------------------------------------+   
        +-node.*-node.*------------------------+   
        +-Nnnnn-Nnnnn--------------------------+   
        +-NnnnnRmmmm-NnnnnRmmmm----------------+   
        +-Rmmmm-Rmmmm--------------------------+   
        '-Ummmm-Ummmm--------------------------'   

>--,Q=--+-CNV--+-CLASS-----+------------+----------------------><
        |      +-STC--|--$-+            |   
        |      +-TSU--|--@-+            |   
        |      '-*---------'            |   
        +-XEQ--+-CLASS-----+------------+   
        |      +-STC--|--$-+            |   
        |      +-TSU--|--@-+            |   
        |      '-*---------'            |   
        +-OUT---------------------------+   
        +-PPU---------------------------+   
        +-HOLD--------------------------+   
        '-XMT--+-LOCAL--|--ANYLOCAL---+-'   
               +-N--nnnn--|--nodename-+     
               '-destid---------------'

Parameters

Q

JES2 displays the number of jobs on the specified job queue.

memname

The 1 to 4 alphanumeric character identifier of a member in the multi-access spool configuration. JES2 displays the number of jobs on the specified queue whose affinities include the member specified by member name.

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, SA32-0991.

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

JES2 issues the following messages in response to the $D Q commands:

$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

There is 1 job awaiting execution in class A and 1 in class H on a member identified as SPL2. There are 3 jobs in the print/punch queue. 10 percent of spool space is being used.

 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