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}).
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.
Table 1. Comparison of SET
SMS with SETSMSDifference |
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.
Table 2. Incorrect Combinations
of SETSMS ParametersParameter |
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 |