$D F

Function

To display the following information about data set groups queued (ready) for output. That is, output groups (displayable with $DOjob) with OUTDISP=WRITE or KEEP that are routed to the local node and are not busy:

Route code
Forms required
Carriage required
Train required
Forms overlay frame, if required
Bursting, if required
Number of jobs queued for each output class
Process mode

By default, if the job is held (as displayed by $Djob) then JES2 doesn't count the output group.

One or more parameters on this command accepts wild cards. Parameter descriptions will note that.

Syntax


>>-$D--F-------------------------------------------------------->

>--,R=--+--------------------+--Nnnnn-Nnnnn--Rmmmm-Rmmmm--Unnnn-Unnnn--NnnnnRmmmm-NnnnnRmmmm--->
        +-LOCAL--|--ANYLOCAL-+                                                                  
        +-Nnnnn|nodename-----+                                                                  
        +-destid-------------+                                                                  
        +-NnnnnRmmmm---------+                                                                  
        +-Ummmm--------------+                                                                  
        +-node.remote--------+                                                                  
        +-node.userid--------+                                                                  
        +-node.destid--------+                                                                  
        +-remote-------------+                                                                  
        +-userid-------------+                                                                  
        +-*------------------+                                                                  
        +-node.*-------------+                                                                  
        +-node.*-------------+                                                                  
        +- ------------------+                                                                  
        '-node.*-------------'                                                                  

>--,J=-+----------+--,D=-+------+------------------------------><
       +-J|JOBn-n-+      +-H----+   
       +-S|STCn-n-+      +-HELD-+   
       '-T|TSUn-n-'      +-A----+   
                         '-ALL--'

Parameters

F

JES2 displays the number of data sets queued for output.

R=

Specifies a destination for a piece of output. Indicates that output sent to the specified destinations can be selected. The value for all routing numbers can range from 1 to 32767. You can also specify wild cards on this parameter. See Route codes for a description of how to specify route codes and Using wildcards for information on wild cards.

If this command originates from another node in the network and the R= 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 R= operand to the sending node. If another node is desired, specify a destination on the R= operand that will resolve to the desired node (first level destination) at the receiving node.

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

Valid specifications are:

LOCAL|ANYLOCAL

Indicates that only output for the local node is displayed.

Nnnnn|nodename

Indicates that output for jobs is displayed at the node(s) specified through the decimal node identifier or an EBCDIC nodename.

destid

Indicates that only output for the node(s) represented by the destid is displayed.

NnnnnRmmmm|node.remote|node.userid

Indicates that output for jobs is displayed at remote Rmmmm at the node Nnnnn. Rmmmm can also be specified as RMmmmm or RMTmmmm.

Ummmm

Indicates that job output is displayed as special local routing. Wild cards are not supported.

node.destid

Indicates that output for a job is displayed at a destination at the specified node. The destid refers to both the node and the remote. The node specified in the destid must be the same as the node portion of the route code. If the number of the remote has been reassigned, you can use the destid to send to this node.

remote

Indicates job output display routing to a remote. Remote can be specified in any of the following ways:

LOCAL|ANYLOCAL: Indicates that output for the jobs is displayed at the local node.
Rmmmm: Indicates that output for the jobs is displayed at the specified remote.
destid: Indicates that output for the jobs is displayed at a destid that refers to a remote.

userid

Indicates routing to a valid TSO userid. If the userid ends in *, this route code refers to all userids beginning with the characters that precede the *, up to but not including the *.

For more information about specifying userids as remotes, refer to Route codes.

*

Displays all output for the local node, including special local, userid, and a remote workstation on the local node.

node.*

Displays output for all userids at 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.

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.

NnnnnRmmmm-NnnnnRmmmm

Displays a range of remotes at a node. Both node identifiers must be the same.

J=J|JOBn[-n]

The batch job or range of batch jobs for which job output information is displayed.

J=S|STCn[-n]

The started task or range of started tasks for which job output information is displayed.

J=T|TSUn[-n]

The time-sharing user or range of time-sharing users for whom job output information is displayed.

D=H|HELD|A|ALL

D=(A|ALL) tells JES2 to consider ready output groups even if the owning job is held. D=(H|HELD) tells JES2 to only count ready output groups belonging to held jobs. If you omit this parameter, JES2 displays job output information for all jobs.

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.

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 $HASP621 message displays the destination and processing requirements of the work on the output forms queue.

Example

 1   $df,r=local

  $HASP621 OUT R=LOCAL   F=STD   C=**** T=**** W= (NONE)
  $HASP621  PRMODE=LINE  CLASS     A=3     B=1

JES2 displays job output information for released jobs that route their output to remote workstations off the local node.