$D N

Function

To display the following information for the specified jobs:

Job number
Job name
Job status
Job class
Job priority
Job's affinities for MAS member(s)
Percentage of spool disk utilization

Syntax


>>-$D--N--+----------+--+-------------+------------------------->
          +-,memname-+  '-,V=--volser-'   
          +-,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

N

JES2 displays job information for the specified jobs.

Note: You must specify at least one operand, unless you are issuing this command from an RJE terminal. If you do not specify any operands, JES2 issues the $HASP606 message indicating that you supplied an insufficient number of operands.

memname

JES2 displays information for all jobs whose affinities for member(s) of the MAS include the member identified by the 1 to 4 character member name.

ANY

JES2 displays information for all jobs with affinities of ANY.

ALL

JES2 displays information for all jobs in the multi-access spool configuration, regardless of affinity. If a job has affinity with more than one member, it is displayed only once.

IND

JES2 displays information for all jobs whose affinity is for members operating in independent mode. When you specify IND with memname, JES2 displays only those jobs with IND affinity and member name affinity. When you specify IND with ANY, JES2 displays all jobs with the affinity of ANY and IND. When you specify IND with ALL or when it is specified alone, JES2 displays all jobs with the IND affinity.

Note:

The first two operands of the $D N command (those operands concerning affinity) are positional in nature; if entered, they must be in the order shown.
The ANY and IND parameters refer only to jobs awaiting execution/conversion. Affinity is ignored for jobs awaiting print/punch processing; in this case, specifying ANY or IND results in a list of all waiting jobs.

V=volser

JES2 displays information 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 JES2 displays job information. 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. The value for all routing numbers can range from 1 to 32767. See Route codes for a description of how to specify route codes.

Note: NODENAME=REQUIRED on the DESTDEF initialization statement will cause JES2 to require that a userid be prefixed with a node name.

The valid specifications are:

LOCAL|ANYLOCAL

Indicates that job queue information is displayed at the local node.

destid

Indicates that job queue information is displayed at the specified node(s) through an alias for the name of the node. If destid is specified alone, it refers to both the node and the remote.

Nnnnn|nodename

Indicates that job queue information is displayed at the specified node(s) through the decimal node identifier or an EBCDIC nodename.

NnnnnRmmmm|node.remote

Indicates that job queue information is sent to the remote Rmmmm at the node Nnnnn. Rmmmm can also be specified as RMmmmm or RMTmmmm.

Ummmm

Indicates a special local routing for job queue information. Wild cards are not supported.

node.destid

Indicates that job queue information is displayed 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 job queue information is displayed at a remote. Remote can be specified in any of the following ways:

LOCAL|ANYLOCAL: Indicates that job queue information is displayed at the local node.
Rmmmm: Indicates that job queue information is displayed at the specified remote. Rmmmm can also be specified as RMmmmm or RMTmmmm.
destid: Indicates that job queue information 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.

Ummmm-Ummmm

Displays all output for each special local node in the range. Wild cards are not supported.

Q=CNV

Jobs waiting for conversion are displayed. You can specify one of the following values for cnv:

*

Jobs waiting for conversion in all classes are displayed. Specifying CNV* is equivalent to specifying CNV. Must be used as

Q=CNV*

Cannot be used by itself.

class

The execution class of jobs waiting for conversion are displayed.

STC|$

Started tasks waiting for conversion are displayed. This operand can be abbreviated $.

TSU|@

Time-sharing users waiting for conversion are displayed. This operand can be abbreviated @.

Q=XEQ

Jobs waiting for execution are displayed. You can specify one of the following values for xeq:

*

Jobs waiting for execution in all classes are displayed. Specifying XEQ* is equivalent to specifying XEQ. Must be used as

Q=XEQ*

. Cannot be used by itself.

class

The execution class of jobs waiting for execution are displayed.

STC|$

Started tasks waiting for execution are displayed. This operand can be abbreviated $.

TSU|@

Time-sharing users waiting for execution are displayed. This operand can be abbreviated @.

Q=OUT

Jobs waiting for output processing are displayed.

Q=PPU

Jobs queued for print/punch processing are displayed. When JES2 displays the status of a job awaiting print/punch processing, only the default print and punch routings are listed. This does not necessarily mean the job has any output data sets awaiting print/punch processing for the default destination; there might be one or more specially routed data sets awaiting output. The $D N display does not provide this type of job output information.

Q=HOLD

Jobs waiting for any activity and in hold status are displayed.

Q=XMT

Jobs queued for network transmission are displayed. See Route codes. for a description of how to specify route codes. 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.

If this command originates from another node in the network and the Q= operand does not specify a node (first-level destination), the receiving node defaults the first-level destination to the node where the command originated.

If this command is sent to another node in the network using the $N command, be aware that the receiving node will default the node (first-level destination) of the Q= operand to the sending node. If another node is desired, specify a destination on the Q= operand that will resolve to the desired node (first level destination) at the receiving node.

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.
NODENAME=REQUIRED on the DESTDEF initialization statement will cause JES2 to require that a userid be prefixed with a node name.

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 specify only the Q= operand and omit all other operands (with the exception of the L= operand), JES2 displays information for jobs that have execution affinity for the member to which the console entering the command is attached.
If you omit the Q= operand, JES2 displays information for jobs in the following categories:
- All jobs queued for conversion
- All jobs queued for execution
- All jobs queued for network transmission
- All jobs queued for the output processor
- All jobs queued for print/punch
Information for jobs in hold status is not displayed.

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

The $HASP890 message displays job number, job name, job status, job class, job priority, and job member affinities. The $HASP646 message displays the percentage of spool utilization.

Examples

 1   $D N

  $dn,all,r=local,q=xeq
  JOB00017  $HASP890 JOB(MYJOB)
  $HASP890 JOB(MYJOB)     STATUS=(AWAITING EXECUTION),CLASS=H,
  $HASP890                PRIORITY=9,SYSAFF=(ANY),HOLD=(JOB)
           $HASP646 9.1346 PERCENT SPOOL UTILIZATION

JES2 displays information for all jobs in the MAS configuration that are waiting for conversion and/or execution whose output routings are local.

 2 
$dn,q=xeqc
                                         
JOB00011  $HASP890 JOB(JLNK1007)                             
$HASP890 JOB(JLNK1007)  STATUS=(AWAITING EXECUTION),CLASS=C, 
$HASP890                PRIORITY=9,SYSAFF=(ANY),HOLD=(NONE)