Parameter Description for OUTDEF
- COPIES=nnn|255
- 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. If the number of copies requested
is greater than the value of COPIES, the request is reduced to the
value of COPIES. No error message is produced. The setting of this
parameter does not affect requests for multiple copies of data sets
through the JCL OUTPUT or DD statements or /*OUTPUT control statement.
Modification: $T OUTDEF operator command.
- DMNDSET=Yes|No
- Specifies whether inline printer setup will be allowed for data
sets whose SYSOUT class matches the job message class.
If DMNDSET=Yes, all SYSOUT data sets that are not specified for special processing in any other way (for example, HOLD) and whose class matches the message class, will be printed on one printer with appropriate setup messages to the operator as the data sets are printed.
If DMNDSET=No is specified or if the SYSOUT class does not match the message class, separate class work queues will be created for each unique setup required. Thus, data sets can be printed simultaneously on all printers available, or deferred until a printer is set up to process all work for the separate class.
See the USERSET= parameter on this statement and z/OS JES2 Initialization and Tuning Guide for a discussion of the interrelationship of these two parameters.
Modification: Single-member warm start.
- DSLIMIT=10M|4B
- The SPOOL data set limit of 10M specifies that any job is limited
to 10 Million (9999999) SPOOL data sets for the entire lifetime of
the job. After this limit is reached, attempts to create additional
SPOOL data sets will fail. Specifying DSLIMIT=4B allows jobs to create
additional SPOOL data sets—up to 4 Billion (4294967296) data
sets. Note: The DSLIMIT setting does not have any effect on the first 10M (9,999,999) SPOOL data sets that are created by a job.
Modification: $T OUTDEF operator command.
- JOENUM=nnnnnn
- Specifies the number (must be no
greater than 2,500,000) of job output elements (JOEs) to be generated.
JOEs are required for unique combinations of:
- SYSOUT class, setup characteristics, process mode, and other output criteria that appear in a job that is queued for output whether the SYSOUT is in held status or ready to be printed.
- Forms ID, UCS ID, and FCB ID, and groupid for all jobs currently queued for output.
When determining the number of JOEs, remember that multiple JOEs can be concurrently active for the 3800 printer's output, and that a JOE is not freed until the 3800 stacks its associated output.
Note: Use this parameter to increase the limit for the JNUM resource that is reported on the HASP050 message.Performance Considerations: If the value specified for JOENUM= is too small, jobs will wait a considerable time for printing. Although a value as small as 10 will be accepted; a value smaller than the default degrades throughput. (JES2 calculates the default as the JOBNUM= parameter value on the JOBDEF initialization statement times 2.5.) If the value is too large, the processor time and the number of page faults needed to search the elements increases. The default value should keep printers and punches busy without tying up too much virtual storage. As a rough approximation, you can determine the starting value of JOEs per job as twice the number of output classes per job. (For further discussion of the factors affecting the number of job output elements, see z/OS JES2 Initialization and Tuning Guide.)
If you use the $T OUTDEF command to increase JOENUM=, only do so when you can allow your system to experience temporary performance degradation while all JES2 systems read the checkpoint data set.
Modification: $T OUTDEF operator command to increase or decrease the number of JOEs.
- JOEWARN=nnn|80
- Specifies the percentage (1–99) of use of
job output elements at which the operator will be alerted through
message $HASP050. If you specify 0, no alert will be given.
Modification: $T OUTDEF operator command. Note that this parameter cannot be modified through a hot start, quick start or single-member warm start.
- LDEV_OPT=YES|NO
- Enables (Yes) or disables (No) POST output work selection optimization
for local JES2 managed devices (printers and punches). For details
see z/OS JES2 Initialization and Tuning Guide.
- YES
- Enables POST work selection optimization for local devices.
- NO
- Disables POST output work selection optimization for local devices. POST code reverts to the z/OS version 2.1 level of JES2 work selection processing.
Modification: $T OUTDEF operator command.
Scope: Single Member.
- OUTTIME=CREATE|UPDATE
- Specifies whether JES2 will save the timestamp that indicates
the creation time of an output's JOE, or whether it will instead save
the time when the JOE was last updated. You can use a $O command to
change the disposition of all output based on the time elapsed between
the current time and the JOE time. Changing held output's disposition
based on its age releases spool space and job queue elements (JQEs)
occupied by output that is no longer needed. For more information
on the $O command, see z/OS JES2 Commands.
- CREATE
- JES2 fills in the JOE time only when the job creates the output.
- UPDATE
- JES2 updates the JOE time every time the JOE is updated.
Modification: $T OUTDEF operator command.
- PRTYHIGH=nnn|255
- Specifies the upper priority limit (0-255) to be associated with
the JES2 job priority aging feature. A job's output will not be priority-aged
if its priority is (or becomes) greater than or equal to the value
specified in this parameter. If the job is on the $HARDCPY queue,
the job queue element is not aged; only the job output element is
aged.
Modification: $T OUTDEF operator command. Note that this parameter cannot be modified through a hot start, quick start or single-member warm start.
- PRTYLOW=nnn|0
- Specifies the lower priority limit (0-255) to be associated with
the JES2 job priority-aging feature. A job's output will not be priority-aged
unless its priority is initially equal to or greater than this value.
If the job is on the $HARDCPY queue, the job queue element is not
aged; only the job output element is aged. (See the PRYORATE= parameter;
the PRYORATE= specification controls the priority aging rate of jobs
scheduled for execution and output.)
Modification: $T OUTDEF operator command. Note that this parameter cannot be modified through a hot start, quick start or single-member warm start.
- PRTYOUT=Yes|No
- Specifies whether the priority specification (PRTY= keyword) on
the JCL OUTPUT statement is supported (Yes) or ignored (No).
Modification: $T OUTDEF operator command.
- PRYORATE=nnnn|0
- 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.
For example, if 3 is specified, a job's output priority will be increased by one for every 8 hours it remains in the system. However, a job's output priority will not be increased unless it is at least equal to the value specified in the PRTYLOW= parameter; nor will a job's output priority be increased above the value specified in the PRTYHIGH= parameter. If 0 is specified, the values specified in the PRTYLOW= and PRTYHIGH= parameters are ignored. See z/OS JES2 Initialization and Tuning Guide for a discussion of output priority aging.
Modification: $T OUTDEF operator command. Note that this parameter cannot be modified through a hot start, quick start or single-member warm start.
- SAPI_OPT={No|Yes}
- Enables (Yes) or disables (No) SAPI POST work selection optimization.
For details see z/OS JES2 Initialization and Tuning Guide.
- No
- Disables SAPI POST work selection optimization. POST code reverts to the z/OS version 1.13 level of JES2 work selection processing.
- Yes
- Enables SAPI POST work selection optimization.
Modification: $T OUTDEF operator command.
Scope: Single Member.
- SEGLIM=nnnnn|100
- Specifies the maximum number of output segments (1-99999) JES2
creates for a SYSOUT data set. When the number of segments exceeds
this number, JES2 no longer segments the SYSOUT. SEGLIM=1 prohibits
SYSOUT segmentation. SEGLIM=99999 allows practically unlimited SYSOUT
segmentation. See z/OS JES2 Initialization and Tuning Guide for more information about dividing output into segments.
Modification: $T OUTDEF operator command. If you modify this parameter value and then restart JES2 with a hot start, the parameter value in effect before termination will be used.
- STDFORM=vvvvvvvv|STD
- Specifies a 1- to 8-character identifier to be used as a default
forms ID when a forms ID is not specified. It also specifies the default
initial setup of all printers and punches at JES2 initialization.
Note: Special characters (for example, the period (.) ) are not allowed.
Modification: Single-member warm start.
- USERSET=Yes|No
- Specifies whether the user is permitted (Yes) or not permitted
(No) to create demand setup JOEs through use of the JCL OUTPUT statement.
If Yes is specified, JES2 will form demand setup output groups according
to the user's definition. See the DMNDSET= parameter on this statement
and z/OS JES2 Initialization and Tuning Guide for the relationship between
this parameter and user-defined output data set groups.
Modification: Single-member warm start.
- WS_OPT=No|Yes
- Enables (Yes) or disables (No) JOE index based SYSOUT work selection
optimization. For details see z/OS JES2 Initialization and Tuning Guide.
- No
- Disables JOE index based SYSOUT selection optimization. SYSOUT work selection reverts to the z/OS Version 1.13 level of JES2 work selection processing.
- Yes
- Enables JOE index based SYSOUT selection optimization.
Modification: $T OUTDEF operator command.
Scope: MAS