Function
To display output definitions.
Syntax
>>-$D--OUTDEF--+-----------+--+------------+--+------------+---->
'-,--COPIES-' '-,--DMNDSET-' '-,--DSLIMIT-'
>--+------------+--+-----------+--+-------------+--------------->
'-,--JOEFREE-' '-,--JOENUM-' '-,--JOERBLDQ-'
>--+-----------+--+------------+--+------------+---------------->
'-,--JOEUSE-' '-,--JOEWARN-' '-,--OUTTIME-'
>--+-------------+--+------------+--+------------+-------------->
'-,--PRTYHIGH-' '-,--PRTYLOW-' '-,--PRTYOUT-'
>--+-------------+--+-------------+--+-----------+-------------->
'-,--PRYORATE-' '-,--SAPI_OPT-' '-,--SEGLIM-'
>--+------------+--+------------+--+-----------+---------------><
'-,--STDFORM-' '-,--USERSET-' '-,--WS_OPT-'
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.
- 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 SAPI 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.
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, SA38-0666 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.