Changing the SMS status of a storage group or volume

Use the VARY SMS command to change the status of a storage group or volume that the storage management subsystem (SMS) controls. The command allows data sets in the storage group or volume to be allocated/accessed, or not allocated/accessed, to jobs. If the system you issue the command from is defined as part of a system group, but you did not specify the system or system group parameter, then the default is the current system and the command fails.

The possible states of a volume or storage group are:

ENABLE: Allows the system or system group to allocate and access data sets.
DISABLE: Prevents the system or system group from allocating or accessing existing data sets.
DISABLE,NEW: Prevents the system or system group from allocating new data sets; existing data sets can be accessed.
Note: For DISABLE and DISABLE,NEW, jobs needing the denied data sets can potentially fail during execution.
QUIESCE: Prevents JES3 from scheduling a job that creates new data sets or accesses existing data sets.
Once a job has been scheduled on either JES2 or JES3, SMS only selects the volume or storage group for a new data set if there are no other choices. There is no effect on the allocating or accessing of existing data sets.

Note: The QUIESCE state is not valid for object or object backup storage groups.
QUIESCE,NEW: Prevents JES3 from scheduling jobs that create new data sets or modify (DISP=MOD) existing data sets.
Once the job has been scheduled on either JES2 or JES3, SMS only selects the volume or storage group for a new data set if there are no other choices. There is no effect on the allocating or accessing of existing data sets.

Note: The QUIESCE state is not valid for object or object backup storage groups.

The syntax of the VARY SMS command is:

 
V SMS,{{STORGRP|SG}(storgrp,[*|ALL|system[,system]...])},{QUIESCE|Q}[,NEW|,N]
      {                                                } {ENABLE|E }
      {{VOLUME|VOL}(volume,[*|ALL|system[,system]...]) } {DISABLE|D}[,NEW|,N]

STORGRP or SG(storgrp[,system,...])

Identifies the storage group and, optionally, the system or system group that the SMS status change is to affect. If you omit system or specify an *, the command affects only the system on which you issue the command. If the system you issue the command from is defined to SMS as part of a system group, then the command fails.

If you specify ALL, the command affects all systems and system groups in the complex. With ALL, the command is effective directly on the issuing system, and the sharing systems in the SMSPLEX see the updates in the COMMDS at the regular interval processing. Rapid use of several commands might overlap in updates of the COMMDS, increasing delay in the propagation through the sharing systems active configuration due to serialization timing.

To specify a storage group named “ALL”, you must enclose the name in parentheses ((ALL)) to distinguish it from all storage groups.

VOLUME or VOL(volume[,system,...])

Identifies the volume and, optionally, the system or system group that the SMS status change is to affect. If you omit system or specify an *, the command affects only the system on which you issue the command. If the system you issue the command from is defined to SMS as part of a system group, then the command fails.

If you specify ALL, the command affects all systems and system groups in the complex. With ALL, the command is effective directly on the issuing system, and the sharing systems in the SMSPLEX see the update in the COMMDS at the regular interval processing. Rapid use of several commands might overlap in updates of the COMMDS, increasing delay in the propagation through the sharing systems active configuration due to serialization timing.

To specify a volume named “ALL”, you must enclose the name in parentheses ((ALL)) to distinguish it from all volumes.

ENABLE or E

SMS is to permit allocation of new and old data sets from the specified storage group or volume on the designated system(s) or system group(s).

QUIESCE or Q[,NEW or ,N]

For QUIESCE, a JES3 system prevents the scheduling of jobs that create new data sets or accessing existing data sets from the specified storage group or volume. For QUIESCE,NEW a JES3 system prevents the scheduling of jobs that create new data sets or modify (DISP=MOD) existing data sets from the specified storage group or volume.

Once the job has been scheduled on JES2 or JES3, SMS only selects the volume or storage group for a new data set if there are no other choices. There is no effect on the allocating or accessing of existing data sets.

DISABLE or D[,NEW or ,N]

For DISABLE, SMS is not to allow allocation or accessing of existing data sets in the specified storage group or volume.

For DISABLE,NEW, SMS is not to select the volume or storage group for a new data set.

Note: For DISABLE and DISABLE,NEW, jobs needing the denied data sets can potentially fail during execution. You should specify these parameters only under the direction of your storage administrator.

Example 1:

To tell SMS not to allow allocation of new data sets from storage group SG1 on system MVS2, enter:

VARY SMS,STORGRP(SG1,MVS2),DISABLE,N

Note: This command works only if the specified system is defined explicitly to SMS. If the system is defined to SMS as part of a system group, the command fails.

Example 2:

To tell SMS to allow allocation of both new and old data sets from storage group SG1 on all MVS™ systems, enter:

VARY SMS,STORGRP(SG1,ALL),ENABLE

Note: This command works only if the specified system is defined explicitly to SMS. If the system is defined to SMS as part of a system group, the command fails.

Example 3:

To tell SMS to allow allocation of both new and old data sets from volume SMS001 on system MVS3, enter:

VARY SMS,VOLUME(SMS001,MVS3),ENABLE

Example 4:

To (1) tell a JES3 system to prevent scheduling a job required volume SMS001 on MVS3, and (2) tell SMS, once a job is scheduled, to only select volume SMS001 on MVS3 for a new data set if there are no other choices, enter:

VARY SMS,VOLUME(SMS001,MVS3),QUIESCE

Note: This command works only if the specified system is defined explicitly to SMS. If the system is defined to SMS as part of a system group, the command fails.