ABCs of z/OS System Programming Volume 3 - IBM Redbooks

VARY SMS command
Use the VARY SMS command to control SMSVSAM processing.
► Start the VSAM RLS server address space on a single system.
If not started during IPL because of RLSINIT(NO) in the IGDSMSxx PARMLIB member,
you can start the RLS server manually with:
V SMS,SMSVSAM,ACTIVE
► Stop the RLS server address space.
If the SMSVSAM address space fails, it is automatically restarted. If you want to stop the
SMSVSAM address space permanently on a single system, use:
V SMS,SMSVSAM,TERMINATESERVER
Use this command only for specific recovery scenarios that require the SMSVSAM server
to be down and to not restart automatically.
► Fallback from RLS processing.
A detailed procedure about falling back from RLS processing is described in z/OS
DFSMSdfp Storage Administration Reference, SC26-7402. Read it before using the
following command:
V SMS,SMSVSAM,FALLBACK
This command is used as the last step in the disablement procedure to fall back from
SMSVSAM processing.
► Further VARY SMS commands.
There are additional VARY SMS commands available to interact with VSAM RLS. They are:
V SMS,CFCACHE(cachename),ENABLE|QUIESCE
CFVOL(volid),ENABLE|QUIESCE
MONDS(dsname[,dsname...]),ON|OFF
SHCDS(shcdsname),NEW|NEWSPARE|DELETE
SMSVSAM,SPHERE(spherename),ENABLE
FORCEDELETELOCKSTRUCTURE
Refer to z/OS MVS System Commands, SA22-7627 for information about these
commands.
Display commands
There are a several display commands available to provide RLS-related information.
► Display the status of the SMSVSAM address space:
DISPLAY SMS,SMSVSAM{,ALL}
Specify ALL to see the status of all the SMSVSAM servers in the sysplex.
► Display information about the Coupling Facility cache structure:
DISPLAY SMS,CFCACHE(CF_cache_structure_name|*)
► Display information about the Coupling Facility lock structure IGWLOCK00:
DISPLAY SMS,CFLS
This information includes the lock rate, lock contention rate, false contention rate, and
average number of requests waiting for locks.
► Display XCF information for a CF structure:
DISPLAY XCF,STR,STRNAME=structurename
This provides information such as status, type, and policy size for a CF structure.
Chapter 7. DFSMS Transactional VSAM Services 413