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 is 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, are 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 are 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, set up 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 wait a considerable time for printing. Although a value as small as 10 is 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 is
alerted through message $HASP050. If you specify 0, no alert is 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=NO|YES
- 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 saves the time stamp that indicates the creation time of an output's JOE,
or whether it instead saves 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 that is 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 is not 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 is not 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 is increased by one for every 8 hours it remains in the system. However, a job's output priority is not increased unless it is at least equal to the value specified in the PRTYLOW= parameter; nor is a job's output priority be increased above the value that is specified in the PRTYHIGH= parameter. If 0 is specified, the values that are 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 is 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 forms 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.