SETSMS command
Use the SETSMS command when the Storage Management Subsystem (SMS) is active (running) to change a subset of SMS parameters from the console without changing the active IGDSMSxx member of SYS1.PARMLIB. Changes that you make with the SETSMS command persist until a subsequent SETSMS command is run for the same option, until the next SET SMS=xx command is run, or until the next system IPL.
Use the SETSMS command to:
- Activate a new SMS configuration by specifying an active configuration data set (ACDS), a source control data set (SCDS), or both data sets. This action affects all MVS™ systems in the SMS complex.
- Replace the active configuration data set (ACDS) by specifying an ACDS different from the one that SMS is currently using. This action affects all MVS systems in the SMS complex.
- Replace the communications data set. This action affects all MVS systems in the SMS complex.
- Save the active configuration in a data set.
- Override (but do not physically change) the specifications of the keyword CA_RECLAIM in IGDSMSxx and data classes.
- Change the synchronization interval (INTERVAL). This change applies only to the system on which you issue the SETSMS command.
- Change the interval (DINTERVAL) that SMS waits between reading device statistics from the 3990-3 control unit (applicable only if the 3990-3 is installed and has at least one SMS-controlled volume). This change applies only to the system on which you issue the SETSMS command.
- Change the number of seconds that the dss component of DFMSMS will wait during backup processing for quiesce data set requests to complete (DSSTIMEOUT).
- Change the interval that SMS waits between recording cache control unit summaries (applicable only if the 3990-3 is installed and has at least one SMS-controlled volume). This change applies only to the system on which you issue the SETSMS command.
- Change the interval that SMS waits between recording of BMF (buffer management facility) statistics. This change applies only to the system on which you issue the SETSMS command.
- Change the maximum number of times that the buffer management facility (BMF) least recently used (LRU) routine will pass over inactive buffers before making them available for reuse (LRUCYCLES).
- Change the number of seconds that the buffer management facility (BMF) will wait between calls to the BMF data space cache LRU (least recently used) routine (LRUTIME).
- Specify trace options for SMS. This change applies only to the system on which you issue the SETSMS command.
- Specify deadlock detection intervals.
- Change the SMF interval time for recording SMF type 42 records.
- Change the new log of logs name, used by DFSMStvs.
- Change the maximum number of unique lock requests that a single unit of recovery can make.
- Change the quiesce exit timeout value to specify the amount of time the DFSMStvs quiesce exits will allow to elapse before concluding that a quiesce cannot be completed successfully.
- Change the maximum time that a VSAM RLS or DFSMStvs request is to wait for a required lock before the request is assumed to be in deadlock.
- Change the virtual storage size that is used to cache PDSE directory buffers in the SMSPDSE1 restartable address space. The directory buffers reside in 64-bit addressable virtual memory. The PDSE1_DIRECTORY_STORAGE parameter allows a change of the PDSE1_DIRECTORY_STORAGE that is either defaulted at IPL, or specified in the IGDSMSxx parameter in SYS1.PARMLIB. You must restart the SMSPDSE1 address space in order for this change to become effective.
- Change the hiperspace storage size that is used for PDSE member caching in the SMSPDSE1 restartable address space. The PDSE1_HSP_SIZE parameter allows a change of the PDSE1_HSP_SIZE that is either defaulted at IPL or specified in the IGDSMSxx parameter in SYS1.PARMLIB. You must restart the SMSPDSE1 address space in order for this change to become effective.
- Change the buffer-beyond-close option that is used to manage the cache of PDSE directory and member buffers in the SMSPDSE1 restartable address space. The directory buffers reside in 64-bit addressable virtual memory and optionally member data resides in a hiperspace. The PDSE1_BUFFER_BEYOND_CLOSE parameter allows a change of the PDSE1_BUFFER_BEYOND_CLOSE that is either defaulted at IPL, or specified in the IGDSMSxx parameter in SYS1.PARMLIB. You must restart the SMSPDSE1 address space in order for this change to become effective.
- Suppress DELETE/RENAME messages issued to hardcopy and job logs. See SUPPRESS_DRMSGS({YES|NO}).
Change the values of the automatic class selection
(ACS) read-only variable &USER_ACSVAR. The values for &USER_ACSVAR
are specified in the IGDSMSxx parameter in SYS1.PARMLIB.
For more information about the ACDS, SCDS, and COMMDS data sets, see z/OS DFSMSdfp Storage Administration and z/OS DFSMSdfp Diagnosis.
If you are not sure about the differences between SET SMS and SETSMS, see Table 1.
| Difference | SET SMS Command | SETSMS Command |
|---|---|---|
| When and how to use the command | Initializes SMS parameters and starts SMS if it has been defined but not started at IPL time. Changes SMS parameters if SMS is already running. | Changes SMS parameters only when SMS is running. |
| Where the parameters are entered | In the IGDSMSxx member of SYS1.PARMLIB. | At the console. |
| What default values are available | Default values are used for unspecified parameters except for BLOCKTOKENSIZE. If you omit BLOCKTOKENSIZE, the previous value in effect remains in effect. In z/OS® 1.7, the original value of BLOCKTOKENSIZE is REQUIRE and in z/OS 1.8 and later the original value of BLOCKTOKENSIZE is NOREQUIRE. | No default values. Unspecified parameters remain unchanged. |
Some combinations of SETSMS parameters are not valid. Table 2 shows these incorrect combinations.
Requirement: The SCDS is a required parameter if the ACDS does not contain a valid configuration.
Note: The SCDS is a required parameter if the ACDS does not contain
a valid configuration.
| Parameter | ACDS | SCDS | COMMDS | SAVEACDS |
|---|---|---|---|---|
| ACDS | N/A | Not Valid | Not Valid | |
| SCDS | N/A | Not Valid | Not Valid | |
| COMMDS | Not Valid | Not Valid | N/A | Not Valid |
| SAVEACDS | Not Valid | Not Valid | Not Valid | N/A |