$D OUTDEF - Display output definition options
Function
To display output definitions.
Syntax
Parameters
- COPIES
- Specifies
the maximum number (1-255) of job output copies that can be requested
in the accounting field of your JOB statement or on a /*JOBPARM control
statement.
Scope: Single Member. The response to this command will be a display of information about this member only.
- DMNDSET
- Specifies whether inline printer setup will be allowed for data sets whose SYSOUT class matches the job message class.
- DSLIMIT
- Specifies
the current limit on the number of SPOOL data sets that any job can
create during the entire lifetime of the job. One of the following
values is displayed:
- 10M
- A job is allowed to create up to 10 Million (9,999,999) data sets.
- 4B
- A job is allowed to create up to 4 Billion (4,294,967,296) data sets.
Scope: MAS-Wide, This command displays MAS-wide information.
- JOEFREE
- The
number of available job output elements.
Scope: MAS-Wide. This command can display information about jobs on any or all members of the MAS depending upon the parameters you provide.
- JOENUM
- Specifies
the number (10-400000) of job elements (JOEs)
to be generated.
Scope: MAS-Wide. This command can display information about jobs on any or all members of the MAS depending upon the parameters you provide.
- JOERBLDQ
- Displays
YES if there are output elements on the rebuild queue.
Scope: MAS-Wide. This command can display information about jobs on any or all members of the MAS depending upon the parameters you provide.
- JOEUSE
- Displays
the number of JOEs of different types in the JES2 checkpoint.
Scope: MAS-Wide. The response to this command will be a display of MAS-Wide information.
- JOEWARN
- Specifies
the percentage (0-100) of use of job output elements at which the
operator will be alerted through message $HASP050.
Scope: MAS-Wide. This command can display information about jobs on any or all members of the MAS depending upon the parameters you provide.
- LDEV_OPT
- Displays
whether POST work selection optimization for JES2 local devices (printers
and punches) is enabled for this member.
Scope: Single Member. The response to this command will be a display of information about this member only.
- OUTTIME
- Specifies
whether JES2 will save the time stamp that indicates the creation
time of an output's JOE, or whether it will instead save the time
when the JOE was last updated.
Scope: Single Member. The response to this command will be a display of information about this member only.
- PRTYHIGH
- Specifies
the upper priority limit (0-255) to be associated with the JES2 job
priority aging feature.
Scope: MAS-Wide. This command can display information about jobs on any or all members of the MAS depending upon the parameters you provide.
- PRTYLOW
- Specifies
the lower priority limit (0-255) to be associated with the JES2 job
priority aging feature.
Scope: MAS-Wide. This command can display information about jobs on any or all members of the MAS depending upon the parameters you provide.
- PRTYOUT
- Specifies
whether the priority specification on the JCL OUTPUT statement is
supported (Yes) or ignored (No).
Scope: Single Member. The response to this command will be a display of information about this member only.
- PRYORATE
- Specifies
the number (0-1440) of time periods into which a 24-hour day is to
be divided for use in increasing a job's output priority by the JES2
output priority aging feature.
Scope: MAS-Wide. This command can display information about jobs on any or all members of the MAS depending upon the parameters you provide.
- SAPI_OPT
- Displays
whether SAPI POST work selection optimization is enabled for this
member.
Scope: Single Member. The response to this command will be a display of information about this member only.
- SEGLIM
- Specifies
the maximum number of output segments (1-99999) JES2 creates for a
SYSOUT data set.
Scope: Single Member. The response to this command will be a display of information about this member only.
- STDFORM
- Specifies
1 to 8 character identifier to be used as a default forms ID when
a forms ID is not specified.
Scope: Single Member. The response to this command will be a display of information about this member only.
- USERSET
- Specifies
whether the user is permitted (Yes) or not permitted (No) to create
demand setup JOEs through the use of the JCL OUTPUT statement.
Scope: Single member. The response to this command will be a display of information about this member only.
- WS_OPT
- Displays
whether SYSOUT GET JOE Index work selection optimization
is enabled for the MAS. Depending on the current state of the SYSOUT
work selection optimization, one of the following values is displayed:
- NO
- SYSOUT work selection optimization is disabled.
- YES
- SYSOUT work optimization is enabled and fully functional.
- YES-IN-PROGRESS
- SYSOUT work selection optimization has been enabled but the request is still being processed in the background. When the request completes, message $HASP145 is issued.
- YES-SUSPENDED
- SYSOUT work selection optimization was enabled but has been suspended due to an error found in the internal JES2 processing. SYSOUT work selection optimization can be completely disabled by issuing $TOUTDEF,WS_OPT=NO or re-enabled by issuing $TOUTDEF,WS_OPT=YES. JES2 attempts to re-enable SYSOUT work selection optimization automatically whenever any MAS member starts.
Scope: MAS-Wide. The response to this command will be a display of MAS-Wide information.
Authority Required
This command requires display authority.
This command requires read security access authority. For a description of assigning command input authority, see z/OS JES2 Initialization and Tuning Guide.
Scope
The scope of this command varies by parameter. See the description of each parameter for its scope.
The values supplied for some parameters on this command will be in effect across the entire MAS, while the values supplied for other parameters will be in effect for this member only.
Depending on your installation's setup, you might want the parameters for this command to be applied to all members of the MAS (to ensure a consistent environment across the MAS). If so, you can use the MVS™ ROUTE *ALL command to issue this command to all active members (if the JES2 command character is the same on all members). See z/OS MVS System Commands for more information on using the ROUTE *ALL command.
Messages
The $HASP836 message is issued in response to this command.
Example
1 $doutdef
$HASP836 OUTDEF
$HASP836 OUTDEF COPIES=255,DMNDSET=NO,JOENUM=200,JOEFREE=198,
$HASP836 JOEWARN=80,OUTTIME=CREATE,PRTYLOW=0,
$HASP836 PRTYHIGH=255,PRTYOUT=NO,PRYORATE=0,SEGLIM=100,
$HASP836 STDFORM=STD,USERSET=NO,JOERBLDQ=NONE,
$HASP836 DSLIMIT=10M,E58ALL=NO
JES2 provides information about output definitions.
2 $doutdef,sapi_opt
$HASP836 OUTDEF SAPI_OPT=NO
SAPI POST work selection optimization
is not enabled. 3 $doutdef,ws_opt
$HASP836 OUTDEF WS_OPT=YES
SAPI GET -- JOE Index -- work selection
optimization is enabled. 4 $doutdef,ws_opt
$HASP836 OUTDEF WS_OPT= YES-IN-PROGRESS
JOE Index was created but is not yet
usable because it is being built by the asynchronous process. 5 $doutdef,ws_opt
$HASP836 OUTDEF WS_OPT=YES-SUSPENDED
SAPI GET -- JOE Index work selection
optimization was enabled, but an error caused it to become unusable.
The suspended JOE Index can be destroyed using $TOUTDEF,WS_OPT=NO
command and rebuilt using $TOUTDEF,WS_OPT=YES command. JES2 automatically
attempts to rebuild a suspended JOE index every time a JES2 member
starts. 6 $doutdef,joeuse
$HASP836 OUTDEF
$HASP836 OUTDEF CURRENT JOE UTILIZATION
$HASP836 TYPE COUNT
$HASP836 -------- ---------
$HASP836 WORK 50000
$HASP836 CHAR 440
$HASP836 INDEX 300
$HASP836 FREE 34000
The JOE counts for the MAS are displayed.