Changing JES3 job class characteristics *MODIFY,C=class

Function

Use the *MODIFY,C=class command to:

Reassign spool data for all jobs in a specific job class from one spool partition to another.
Control the spinning of JESlog data sets.
Control writing to the JESMSGLG data set.
Control whether batch jobs are allowed to use system symbols in JCL.
Switch a class from one group to another.
Change the following class limits:
- SDEPTH
- TDEPTH
- TLIMIT
- MDEPTH
- MLIMIT

Syntax


>>-+-*MODIFY-+--,--C--=--class---------------------------------->
   '-*F------'                   

>--+-,--SP--=--spart---------------------+---------------------><
   +-,--GROUP--=--group------------------+   
   +-,--SDEPTH--=--nnn-------------------+   
   +-,--TDEPTH--=--+-,nnn--+-------------+   
   |               '-,NONE-'             |   
   +-,--MDEPTH--=--main--+-,nnn--+-------+   
   |                     '-,NONE-'       |   
   +-,--TLIMIT--=--class--+-,nnn--+------+   
   |                      '-,NONE-'      |   
   +-,--MLIMIT--=--main,class--+-,nnn--+-+   
   |                           '-,NONE-' |   
   +-,--JESMSG--=--+-LOG---+-------------+   
   |               +-NOLOG-+             |   
   |               '-STD---'             |   
   +-,--SPIN--=--+-NO-----+--------------+   
   |             +-YES----+              |   
   |             +-hh:mm--+              |   
   |             +-+hh:mm-+              |   
   |             +-nnn----+              |   
   |             +-nnn--K-+              |   
   |             '-nnn--M-'              |   
   '-,--SYSSYM--=--+-ALLOW----+----------'   
                   '-DISALLOW-'

Parameters

C=class

Specifies the name of a job class to be modified. JES3 reassigns spool data for all jobs in this job class to the specified spool partition.

SP=spart

Specifies the name of the spool partition. JES3 writes spool data for all jobs in the specified job class to this partition.

GROUP=group

Specifies the name of a job class group.

SDEPTH=nnn

Specifies the number of jobs requiring mountable devices. You can specify from 0 to 255 jobs.

TDEPTH=nnn or NONE

Specifies the number of jobs in this class that can execute in the total JES3 complex at one time. You can specify from 0 to 255 jobs.

If you specify NONE, you are indicating that you no longer want TDEPTH to be used for job scheduling. For example, TDEPTH=NONE indicates that TDEPTH is not to be used for determining whether a job should be selected for execution. Specifying TDEPTH=0 is not the same as specifying TDEPTH=NONE. TDEPTH=0 will stop jobs from being scheduled.

MDEPTH=main,nnn or MDEPTH=NONE

Specifies the number of jobs in this class that can execute on a given processor at one time. You can specify from 0 to 255 jobs.

If you specify NONE, you are indicating that you no longer want MDEPTH to be used for job scheduling. For example, MDEPTH=main,NONE indicates that MDEPTH is not to be used for determining whether a job should be selected for execution. Specifying MDEPTH=main,0 is not the same as specifying MDEPTH=main,NONE. MDEPTH=main,0 will stop jobs from being scheduled on that system.

Note: Do not enclose main,nnn in parentheses.

TLIMIT=class,nnn or TLIMIT=NONE

Specifies the number of jobs of other job classes that can execute in the total JES3 complex and still let jobs in this class execute. You can specify from 0 to 255 jobs.

If you specify NONE, you are indicating that you no longer want TLIMIT to be used for job scheduling. For example, TLIMIT=class,NONE indicates that TLIMIT is not to be used for determining whether a job should be selected for execution. Specifying TLIMIT=class,0 is not the same as specifying TLIMIT=class,NONE. TLIMIT=class,0 will stop jobs from being scheduled on that system.

Note: Do not enclose class,nnn in parentheses.

MLIMIT=main,class,nnn or MLIMIT=main,class,NONE

Specifies the number of jobs of other job classes that can execute on a given processor and still let jobs in this class execute. You can specify from 0 to 255 jobs.

If you specify NONE, you are indicating that you no longer want MLIMIT to be used for job scheduling. For example, MLIMIT=main,class,NONE indicates that MLIMIT is not to be used for determining whether a job should be selected for execution. Specifying MLIMIT=main,class,0 is not the same as specifying MLIMIT=main,class,NONE. MLIMIT=main,class,0 will stop jobs from being scheduled on that system.

Note: Do not enclose main,class,nnn in parentheses.

JESMSG=

LOG: Specifies that all WTOs and WTORs are logged in the JESMSGLG spool data set.
NOLOG: Specifies that all WTOs and WTORs are not logged in the JESMSGLG spool data set.
STD: Specifies that the JESMSG= keyword on the STANDARDS initialization statement will determine whether JES3 suppresses WTOs and WTORs.

SPIN=

YES: Specifies that JESlog data sets are eligible to be spun.
NO: Specifies that JESlog data sets are not eligible to be spun.
hh:mm: Specifies that the JESlog data sets will be spun every day at the time indicated by hh:mm. The range of hh is 00 through 23. The range of mm is 00 through 59.
+hh:mm: Specifies the time interval between the spinning of JESlog data sets. The range of hh is 00 through 99. The range of mm is 00 through 59 unless hh has a value of 00 in which case mm has a range of 10 through 59.
nnn: Specifies that the JESlog data sets will be spun each time either of the data sets has nnn lines written to it since the last spin operation or from the start of job selection. The range of nnn is 500 through 999.
nnnK: Same as SPIN=nnn except that nnn represents thousands of lines. The range of nnn is 1 through 999.
nnnM: Same as SPIN=nnn except that nnn represents millions of lines. The range of nnn is 1 through 999.

SYSSYM=ALLOW or DISALLOW

Specifies whether batch jobs of this class are allowed to use system symbols in JCL.

ALLOW: If you specify ALLOW, batch JCL is allowed to use system symbols. System symbols in batch JCL are replaced with values from a system where the job is eligible to execute. This system is derived from the set of systems defined for this class, the system affinity of the job, and the scheduling environment of the job (at the time of conversion). It is possible for symbols and their values to come from a system that differs from the system where the batch job executes, which can occur when there are several systems on which the job is eligible to execute.
DISALLOW: If you specify DISALLOW, batch JCL is not allowed to use system symbols. System symbols are not replaced with values when the JCL is processed.

Results

When the *MODIFY,C=class command is used to change the spool partition:
- JES3 assigns the specified job class to the specified spool partition unless the partition is a dummy partition. If the partition is a dummy partition, JES3 allows the data to overflow.
- JES3 writes spool data for each new job in the job class to the new spool partition unless other partitions were specifically assigned for the job's SYSOUT data or in the job's //*MAIN control statement.
- The command does not affect spool data for jobs in the specified class that already have processed before you entered the command.
Only the *MODIFY,C,=class,GROUP=group command remains in effect over a JES3 hot start. The change is lost if a cold, warm, or hot start with refresh is performed.

Example

Change the spool partition assigned to contain spool data for all jobs in job class D from partition PARTB to PARTC:

*F,C=D,SP=PARTC