$D O Group - Display output characteristics

Function

To display the output characteristics of specified output groups or individual job output elements (JOEs).

Syntax

Read syntax diagramSkip visual syntax diagram$D O Group GroupGRP nn-mm*'output'(,nn*-mm*output'output') Selection limiting keywordsDisplay limiting keywords
Display limiting keywords
Read syntax diagramSkip visual syntax diagram,ALL,Burst,CC=( ,ABENDCODETYPE),CMDauth,CRTIME,AgeDAys,CFCB,FLashO,Forms,HELD,HOLD,HOLDRC,Hours,/JC/JOBCORR=^=><job correlator,JMJOBMASK,LONG,OFFS,OUTDisp,OUTGrp,PAGEs,Priority,PRMode,Queue,READY,REBUILD,RECords,DestRoutecde,SECLABEL,STATus,TSOavail,USERID,Writer
Selection limiting keywords
Read syntax diagramSkip visual syntax diagram,/ALL,/Burst=^=NoYes,CC=( ,ABENDCODETYPE),/CMDauth=^=cmdauth(,cmdauth),/Age/DAys><days,/C/FCB=^=><fcb,/FLash/O=^=><flash,/Forms=^=><forms,/HELD,/HOLD=^=NONEOPERSYS,/HOLDRC=^=><holdrc,/Hours><hours,/JC/JOBCORR=^=><job correlator,/JOBGROUP=^=><jobgroupname,/JM/JOBMASK=^=><jobmask,/OUTDisp=^=HHOLDKKEEPLLEAVEPPURGEWWRITE,/OUTGrp=^=outgrp,/PAGEs=^=><pages,/Priority=^=><priority,/PRMode=^=><prmode,/Queue=^=queue,/READY,/REBUILD=^=NoYes,/RECords=^=><records,/Dest/Routecde=^=><routecde,/SECLABEL=^=><seclabel,/TSOavail=^=NoYes,/T/UCS=^=><ucs,/TPJOBID=^=><jobid,/TPJOBN=^=><jobname,/USERID=^=><userid,/Writer=^=><writer
Notes:
  • 1 cmdauth can be coded up to 2 times

Parameters

output
Specifies 1 to 8 alphanumeric, special ($, #, or @) or wildcard characters (or a combination of them) that can be used to select a subset of job groups whose job group name matches this combination of characters (mask).
‘output'
The name of the job group that is displayed. This name must appear as coded on the JOBGROUP statement and must be enclosed in apostrophes. If more than one job group exists with this name, all output is displayed.
JC|JOBCORR=job correlator
Specifies a combination of 1-64 alphanumeric, special (colon, period or underscore) and wildcard characters that can be used to select a subset of job groups that have a matching job correlator. For a description of wildcard characters, refer to Using wildcards.
Age|DAys<days | Age|DAys>days
Specifies the age of affected output in days. Only output more (with DAYS>nn) or less (with DAYS<nn) than the specified number of days in age are displayed. The days are counted from the current hour.
ALL
JES2 displays the specified job group's output elements based on the presence of filters as follows:
ALL specified? Filters? Meaning
YES YES ALL is ignored.
YES NO Command applies to all job output elements belonging to the specified group.
NO YES ALL is not considered.
NO NO Command applies to all job output elements belonging to the specified group.
Burst={No|Yes}
Displays whether the printed output is to be burst into separate sheets (Yes) or to be in continuous, fanfold mode (No).
CC=(ABEND|CANcelled|COMPleted|FLUSHED|RC)
Specifies the completion information that is associated with the job group.
ABEND
Displays the last ABEND code reported by the termination of a dependent job in the job group.
CANcelled
Indicates the job group was canceled by the operator.
COMPleted
Displays only job groups that completed.
FLUSHED
Displays job groups that were flushed by job group processing.
RC
Displays the highest return code for any terminated dependent job in the job group.

The job group completion code keyword provides a quick method for checking the status of the execution of dependent jobs in the job group. As a dependent job in the job group completes execution, the completion information of the job is evaluated to determine whether it affects the CC value of the job group. If the return code of the dependent job is higher than the value currently tracked by the job group, then the job group completion code is updated to match the return code of that dependent job. If a dependent job terminates with an ABEND code, the job group completion code is updated to that ABEND code. At that point, the job group completion code field reports an ABEND code, and reports the last ABEND code that is returned by the termination of a dependent job. Also, if the job group becomes FLUSHED because of job group processing, the job group completion code field reports the maximum return code or the last ABEND code reported by terminating dependent jobs.

C|FCB=fcb
A 1 to 4 alphanumeric character or special character ($ # @) identifier for the data set forms control or carriage specifications.
CMDauth=(auth1{,auth2})
Only the output that can be affected from the specified remote(s) or node(s) will be released. The valid specifications are:
LOCAL|ANYLOCAL
Only the local devices at the local node can affect the output.
Nnnnn|nodename
Only local devices at the specified node can affect the output.
Rnnnn
Only the specified remote device can affect the output.
NnnnnRnnnn|nodename.Rnnnn
Only the specified remote device at the specified remote node can affect the output.
destid
A destid corresponding to any of the above remote devices.
Note: Specification of the CMDAUTH filter does not override the authority of the console from which the command is issued; both the authority of the console and the specified CMDAUTH filter must match for the job group to be affected.
CRTIME
Displays the time this piece of output was created.
Dest|Routecde=routecde
The destination assigned to the job output element(s). You may specify a remote destination (workstation), another node, or a specific local device. The value for all routing numbers can range from 1 to 32767.

If this command originates from another node in the network and the D|ROUTECDE= operand does not specify a node (first-level destination), the receiving node defaults the first-level destination to the node were 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 D|ROUTECDE= operand to the sending node. If another node is desired, specify a destination on the D|ROUTECDE= operand that will resolve to the desired node (first-level destination) at the receiving node.
Note:
  1. If an output group is queued for transmission and an operator changes its destination, the userid portion of the routing is lost. If an output group is interrupted while printing and the destination is changed, the output group will begin printing from the top when it is printed at the new destination.
  2. NODENAME=REQUIRED on the DESTDEF initialization statement will cause JES2 to require that a userid be prefixed with a node name.
  3. Greater than (> or >=) and less than (< or <=) filters may be used in conjunction to support route code ranges. For example, you could specify the filters R>=R1,R<=R7 to affect output for all remotes in the range R1 to R7. Note that:
    • The destination being filtered upon is converted to its binary equivalent prior to the comparison.
    • When using nodal ranges, a specification of "nodename.*" must be used. Only the nodal routing of the output will be compared.
The following specifications are valid:
LOCAL|ANYLOCAL
Indicates that job groups are to be printed or punched at the local node.
destid
Indicates that job groups are to be printed or punched at the specified node(s). You can specify this location by an alias for the name of a node. If destid is specified alone, it refers to both the node and the remote.
Nnnnn|nodename
Indicates that job groups are to be printed or punched at the specified node(s). You can specify a node using the decimal node identifier or an EBCDIC nodename.
NnnnnRmmmm|node.remote|node.userid
Indicates routing to the remote Rmmmm at the node Nnnnn. Rmmmm can also be specified as RMmmmm or RMTmmmm.
Ummmm
Indicates special local routing.
node.destid
Indicates 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 is reassigned, you can use the destid to send to this node.
remote
Indicates routing to a remote. Remote can be specified in any of the following ways:
LOCAL|ANYLOCAL
Indicates that job groups are to be printed or punched at the local node.
Rmmmm
Indicates routing to the specified remote. Rmmmm can also be specified as RMmmmm or RMTmmmm.
destid
Indicates routing to a destid referring to a remote.
userid
Indicates routing to a valid TSO userid.
node.*
Indicates that the node name is to be modified to the specified node name, but the remote name will remain the same.
*
Indicates that the node name is to be modified to the local node name, but the remote name will remain the same.
Forms=forms
A 1 to 8 alphanumeric or special character ($ # @) identifier for the print or punch forms.
HELD
Output is HELD if it is destined for this node and the output disposition is HOLD or LEAVE.
HOLD={NONE|OPER|SYS}
This operand explicitly sets the operator HOLD type. The only hold type that can be set using this operand is OPER. This parameter prevents JES2 from selecting an output group for any processing other than purging. Specifying HOLD= for an output group is more restrictive than specifying an output group's output disposition. OUTDISP=HOLD or LEAVE prevents JES2 from selecting an output group for print/punch or external writer processing only.

Specifying the REL= parameter on this command makes the output available for processing.

HOLDRC=holdrc
Displays the hold reason code for system held output groups (HOLD=SYS).
H|Hours>hours | H|Hours<hours
Displays the age of affected output in hours. Only output more (with HOURS>nn) or less (with HOURS<nn) than the specified number of hours in age are affected.
JOBGROUP=jobgroupname
Displays 1 to 8 alphanumeric, special ($, #, or @) or wildcard characters (or a combination of them) that can be used to select a subset of job groups whose job group name matches this combination of characters (mask).
JOBMASK|JM=jobmask
Displays 1 - to 8 - alphanumeric, special ($, #, or @) or wildcard characters (or a combination of them) that can be used to select a subset of job groups whose job group name matches this combination of characters (mask).
Note:
  1. This is a positional parameter. Specify this following the job_id.
  2. The JOBMASK parameter is not valid with the 'jobname' parameter.
LONG
Displays additional information.
Note: Because LONG automatically triggers a "long" display, you cannot add additional display-limiting parameters on this command; however, you can add selection-limiting parameters.
OUTGrp=outgrp
The job output element(s) that are displayed.
grpid
The 1– to 8–character alphanumeric group ID that is either specified by the user in the JCL or generated by JES2.
joeid1
A number assigned by JES2 to distinguish between job output elements within the output group.
joeid2
A number assigned by JES2 to distinguish between several copies of grpid.joeid1.
OUTDISP={H|HOLD|K|KEEP|L|LEAVE|P| PURGE|W|WRITE}
Indicates that you wish to display the output for the specified job groups that matches this current disposition. Specify WRITE, HOLD, LEAVE, or KEEP.
Note: If you do not specify this parameter, all output with a disposition of WRITE, HOLD, KEEP, or LEAVE will be modified.
FLASH|O=flash
A 1 to 4 alphanumeric or special character ($ # @) overlay name (FLASH).
PAGEs
Output groups with the specified number of pages are displayed.
PRIORITY=priority
The queue selection priority (0-255) assigned to the job output element(s).
PRmode=prmode
The process mode (1 to 8 alphanumeric characters) for the job output element(s).
QUEUE=queue
The output class (A-Z and 0-9) assigned to the job output element(s).
READY
Output is READY if it is not HELD.
REBUILD={No|Yes}
Output on the rebuild queue is to be cancelled (Yes) or not cancelled (No).
RECORDS=records
The number of print records associated with the output group.
SECLABEL=seclabel
The security label associated with the output group.
TSOavail={No|Yes}
Indicates whether the output group is available for TSO OUTPUT processing.
USERID=userid
The userid associated with the output group.
Writer=writer
A 1 to 8 alphanumeric or special character ($ # @) writer name assigned to the job output element(s).

Authority Required

This command requires job 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 update security access authority.

Processing considerations

  • If you use this command to change both the destination and other output characteristics, those changes to the other output characteristics are ignored for duplicate output groups (those groups created by specifying more than one job copy or by issuing the $N command to repeat the processing of an output group).
  • If any of the characteristics that you specify on this command are also specified as work selection criteria with the WS= parameter on the device initialization statement or using the $T device command, then those characteristics are compared against the matching output device specifications; work is selected accordingly.
  • If the following characteristics are modified, the output group will begin printing from the top when the output starts printing again.
    • Burst
    • FCB
    • Destination
    • Form
    • Overlay (Flash)
    • Process mode(PRMODE)
    • Writer name
  • Once a held output group has been released (the output disposition is changed to WRITE or KEEP), the group is no longer available for processing by the TSO/E OUTPUT command. For more information, see message $HASP686.

Scope

MAS-wide. This command has an effect across the entire MAS.

Messages

The $HASP686 message displays the current output characteristics for each job output element specified.