$D F - Display the job output forms queue
Function
- 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
One or more parameters on this command accepts wild cards. Parameter descriptions will note that.
Syntax
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.
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.