Changing GMS components *MODIFY,G

Function

Use the *MODIFY,G command to alter the status of the GMS component of JES3. GMS parameters should only be changed as directed by the system programmer.

Use the SP parameter on the *MODIFY,G command to reassign spool data for all jobs that run on a specific main or all mains from one spool partition to another.

Syntax


>>-+-*MODIFY-+--,--G--+-,--main-+------------------------------->
   '-*F------'        '-,--ALL--'   

>--+-,--CHK-------------------------------------------------+--><
   +-+-,--CLASS-+--,--class--+-,--ON--+---------------------+   
   | '-,--C-----'            '-,--OFF-'                     |   
   +-+-,--GROUP-+--,--group--+-+-,--ON--+-----------------+-+   
   | '-,--G-----'            | '-,--OFF-'                 | |   
   |                         +-,--ALLOC--+-,--DEMAND--+---+ |   
   |                         |           +-,--DYNAMIC-+   | |   
   |                         |           +-,--IPL-----+   | |   
   |                         |           '-,--MANUAL--'   | |   
   |                         +-,--BAR--,--nn--------------+ |   
   |                         +-,--INIT--,--nnn------------+ |   
   |                         +-,--JSPAN--,--nnn-----------+ |   
   |                         +-,--MODE--+-,--JES-+--------+ |   
   |                         |          '-,--WLM-'        | |   
   |                         '-,--UNALLOC--+-,--DEMAND--+-' |   
   |                                       +-,--DYNAMIC-+   |   
   |                                       '-,--MANUAL--'   |   
   +-+-,--SELECT-+--+-,--CHOICE-+--,--val-------------------+   
   | '-,--S------'  +-,--INCL---+                           |   
   |                +-,--INCR---+                           |   
   |                +-,--MAGEL--+                           |   
   |                +-,--MAGER--+                           |   
   |                +-,--MAXI---+                           |   
   |                +-,--MODE---+                           |   
   |                +-,--SAGEL--+                           |   
   |                +-,--SAGER--+                           |   
   |                +-,--SBAR---+                           |   
   |                '-,--SDEPTH-'                           |   
   '-,--SP--,--spart----------------------------------------'

Parameters

main or ALL

Specifies the main or all mains (ALL) to which the command applies.

CHK

Specifies that the current GMS status is to be checkpointed.

C or CLASS

Specifies that a CLASS initialization statement parameter is to be modified.

class

Specifies the name of the class to be modified.

ON or OFF

Specifies that the class named is to be enabled (ON) or disabled (OFF) for scheduling on the named main.

G or GROUP

Specifies that a GROUP initialization statement parameter is to be modified.

group

Specifies the name of the group to be modified.

ON or OFF

Specifies that the group named is to be enabled (ON) or disabled (OFF) for scheduling on the named main.

INIT,nnn

Specifies the number of dedicated initiators (nnn) to be assigned to the specified JES-managed group.

The INIT option can only be modified when the group is in JES mode.

ALLOC,opt

Specifies that the group initiator allocation option is to be modified. The allocation option determines when the execution resources are to be allocated to the JES-managed group. Four options are available: DEMAND, DYNAMIC, IPL, or MANUAL.

The ALLOC option can only be modified when the group is in JES mode.

DEMAND: Indicates that initiators are to be allocated to satisfy the requirements of selectable jobs in this group. The maximum number of initiators allowed is determined by the dedicated initiator count on the GROUP initialization statement.
DYNAMIC: Indicates that all execution resources are to be allocated when the first job of this group is eligible for scheduling on a main.
IPL: Indicates that the execution resources are to be allocated whenever IPL occurs on the main associated with this group. If subsequent reallocation is necessary, it must be done manually.
MANUAL: Specifies that the execution resources are to be allocated whenever the operator enters an *MODIFY command to turn the group on.

UNALLOC,opt

Specifies that the deallocation option is to be modified. The deallocation option determines when the execution resources are to be released from the JES-managed group. Three options are available: DEMAND, DYNAMIC, or MANUAL.

The UNALLOC option can only be modified when the group is in JES mode.

DEMAND: Indicates that the initiators are to be deallocated when the number of selectable jobs for this group is less than the number of inactive initiators for this group.
DYNAMIC: Indicates that all execution resources are to be released when no selectable jobs exist for this group.
MANUAL: Indicates that no execution resources are to be released until the operator disables the job class group with an *MODIFY command. MANUAL is the deallocation option for the default group JS3BATCH.

BAR,nn

Specifies that the JES-managed group scheduling barrier be changed to the number specified by nn.

The BAR option can only be modified when the group is in JES mode.

JSPAN,nnn

Specifies that the JES-managed group job span be changed to the number specified by nnn.

The JSPAN option can only be modified when the group is in JES mode.

MODE,JES | WLM

Specifies whether the group named is to be managed by JES (MODE,JES) or managed by WLM (MODE,WLM).

S or SELECT

Specifies that a SELECT initialization statement parameter is to be modified.

opt,val: Specifies the option to be modified and its new value. The following valid keywords override their counterparts on the SELECT initialization statement: CHOICE, INCL, INCR, MAGEL, MAGER, SAGEL, SAGER, SBAR, SDEPTH, and MODE (name specified in the NAME parameter). MAXI (maximum initiator count) is also a valid option to modify. The MAXI option is valid only if the maximum initiator value has been set because of a *START INIT command failure.
The maximum initiator count value should not exceed the current setting of the MAXUSER parameter (in the SYS1.PARMLIB member IEASYSXX), less the number of started tasks and TSO/E logons allowed.
Note: All is not a valid MAXI value. The MAXI value must be numeric.

SP

Assigns the specified main to the selected spool partition

spart

Specifies the name of a spool partition.

Results

JES3 assigns the specified main(s) to the selected spool partition unless the partition is a dummy partition, in which case JES3 allows the data to overflow.
JES3 writes spool data for each new job that runs on the specified main to the new partition unless other partitions were specifically assigned for the job's job class, SYSOUT data, or on the job's //*MAIN control statement.
The command does not affect spool data for jobs that are running at the time you enter the command.
The change does not remain in effect after you warm start JES3.

Examples

Allocate three initiators for group BATCH on SY1:

*F,G,SY1,G,BATCH,INIT,3

Deallocate all initiators for group BATCH on SY1:

*F,G,SY1,G,BATCH,INIT,0
IAT8456 GMS MODIFY  COMPLETE NO ERRORS -  SY1

Change mode from JES management to WLM management for group GRPA:

*F,G,ALL,G,GRPA,MODE,WLM
IAT8103 MODE CHANGED TO WLM FOR GROUP GRPA

Change the spool partition assigned to contain spool data for all jobs that execute on main SY3 from partition PARTB to PARTD:

*F,G,SY3,SP,PARTD