Function

To specify the job output characteristics of JES2.

Parameters

COPIES=nnn

The maximum number (1-255) of job output copies that may 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 COPIES= value, JES2 automatically reduces the requested number to the COPIES= value.

Note:

1. The specified COPIES= value does not affect those jobs that are already on the hardcopy queue.
2. Specifying this parameter does not affect requests for multiple copies of data sets made with a OUTPUT JCL statement or a /*OUTPUT control statement.

Scope: Single Member.

DSLIMIT=10M|4B

DSLIMIT=10M specifies that any job on the system is limited to 10 Million (9999999) SPOOL data sets over the entire lifetime of the job. After this limit is reached, attempts to create additional SPOOL data sets will fail. DSLIMIT=4B specifies that jobs are allowed to continue 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.

Scope: MAS-Wide.

JOENUM=nnnnnn

Specifies the number (10-1000000) of output elements (JOEs) to exist in the JES2 system. This number can be increased or decreased by operator command. If JOENUM is increased, JES2 may assign a larger value to BERTNUM to reduce the chance of a shortage of BERTs. However, installations should monitor BERT usage (using $D CKPTSPACE,BERTUSE and the $HASP050 message) to ensure they do not run out of BERTs.

JOEWARN=nnn

The percentage (0-100) of job output elements used at which the $HASP050 message alerts the operator of a shortage of job output elements. JES2 deletes this message from the console when the resource shortage is relieved (either by a decrease in resource use or an increase in the threshold).

Note:

1. If you specify 0, no alert is given.
2. The specified value is applied only to those jobs that have not yet been selected for execution.

Scope: MAS-Wide.

OUTTIME={CREATE|UPDATE}

Specifies whether JES2 maintains the timestamp marking the creation time of an output's JOE, or whether it saves the time the JOE was last modified.

CREATE

JES2 fills in the JOE time only when the job creates the output.

UPDATE

JES2 updates the JOE time whenever the JOE is modified.

Scope: Single Member.

PRTYHIGH=nnn

The upper priority limit (0-255) to be associated with the JES2 job output priority aging feature. JES2 does not priority-age a job output element if its priority is (or becomes) equal to or greater than the PRTYHIGH value. JES2 does not priority-age a job output element unless its initial priority is equal to or greater than the PRTYLOW value.

Note:

1. If zero is specified, no priority aging is performed.
2. The PRTYRATE parameter on the OUTDEF statement specifies the number (0-1440) of time periods into which a 24-hour period is to be divided for use in increasing a job output element's priority by the JES2 priority aging feature. For example, if PRTYRATE=4 is specified, JES2 increases a job output element's priority by one for every 6 hours it remains in the system.

Scope: MAS-Wide.

PRTYLOW=nnn

The lower priority limit (0-255) to be associated with the JES2 job output priority aging feature. JES2 priority-ages a job output element only if its initial priority is equal to or greater than the value of PRTYLOW. JES2 does not priority-age a job output element above the PRTYHIGH value.

Note: The specified value is applied only to those jobs that have not yet been selected for execution.

Scope: MAS-Wide.

PRTYOUT={No|Yes}

Specifies whether the priority specification (PRTY=) on the JCL OUTPUT statement is to be supported (Y) or ignored (N).

Note: The specified value is applied only to those jobs that have not yet entered the system.

Scope: Single Member.

PRYORATE=nnnn

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.

Scope: MAS-Wide.

SAPI_OPT={No|Yes}

Enables (Yes) or disables (No) SAPI POST work selection optimization. For details see z/OS JES2 Initialization and Tuning Guide, SA32-0991.

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.

Scope: Single Member.

SEGLIM=nnnnn

Specifies the maximum number of output segments (1-99999) JES2 creates for a given SYSOUT data set. When the number of segments exceeds the value SEGLIM, JES2 no longer segments the SYSOUT. The SEGLIM parameter has a range from 1 to 99999. The extreme values produce the following results:

SEGLIM=1

Prohibits output segmentation

SEGLIM=99999

Allows practically unlimited output segmentation

Scope: Single member.

WS_OPT={No|Yes}

Enables (Yes) or disables (No) SAPI GET JOE Index work selection optimization on this member. For details see z/OS JES2 Initialization and Tuning Guide, SA32-0991.

No

Disables SAPI GET JOE Index work selection optimization. The GET code reverts to the z/OS version 1.13 level of JES2 work selection processing.

Yes

Enables SAPI GET JOE Index work selection optimization.

Note: Enablement happens asynchronously to the command and could take several minutes. The $HASP144 message signals the start of the asynchronous enablement process for the $TOUTDEF,WS_OPT=YES command. The $HASP145 message is issued when this asynchronous enablement process is complete. During enablement, the GET code uses the z/OS version 1.13 level of JES2 work selection processing.

Scope: MAS-Wide.

Authority Required

This command requires system 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 control security access authority. For a description of assigning command input authority, see z/OS JES2 Initialization and Tuning Guide, SA32-0991.

Processing Considerations

See the individual operand descriptions to determine the effect this command has on jobs in different phases of execution.

Note: The BRODCAST parameter is obsolete. JES2 OUTDEF processing always processes as if BRODCAST=YES is in effect.

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 displays the current values of all the parameters on the OUTDEF initialization statement.

 2   $toutdef,SAPI_OPT=yes       
      $HASP836 OUTDEF                                          
      $HASP836 OUTDEF  COPIES=255,DMNDSET=NO,JOENUM=200,JOEFREE=191, 
      $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,SAPI_OPT=YES,WS_OPT=NO,E58ALL=NO  

 3   $toutdef,WS_OPT=yes 
     $HASP836 OUTDEF                                     
     $HASP144 JOE Index build initiated                         
     $HASP836 OUTDEF                                            
     $HASP836 OUTDEF  COPIES=255,DMNDSET=NO,JOENUM=200,JOEFREE=191,  
     $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,SAPI_OPT=YES,                      
     $HASP836         WS_OPT=YES-IN-PROGRESS,E58ALL=NO               
     $HASP145 JOE Index build complete