Summary of MVS operator commands

Table 1 provides a summary of MVS™ operator commands available to assist in the operation of a coupling facility. The complete syntax of each command is in z/OS MVS System Commands.

Table 1. Summary of MVS commands for managing a coupling facility
MVS Command	Use for Coupling Facility
CONFIG CHP	Use this command to change the physical status of a CHPID for a coupling facility link. The DISPLAY MATRIX command displays the CHPID information for coupling facility CHPIDs.
DUMP	Use this command to dump cache and list structure information, both control information and data. Control information includes directory/registration information, list controls, list entry controls, storage and castout class controls, and optionally adjunct data; data includes list or cache entry data and optionally adjunct data. Lock structures cannot be dumped.
DISPLAY CF	Displays storage and attachment information about coupling facilities attached to the system on which the command is processed. The request can be for one or more named coupling facilities or all coupling facilities. The information displayed includes: Coupling facility unique identifiers Device, subchannel, and CHPID status Utilization of dump space. Coupling facility level Volatility status of the coupling facility. DISPLAY CF is the command used to show how coupling facility and structure resources are being used in the sysplex, with the purpose of identifying possible adjustments or modifications to a CFRM policy. With z/OS® Release 2, a coupling facility at CFLEVEL=11 and higher will provide information about coupling facilities to which it has CF-to-CF connectivity in the display output section titled “REMOTELY CONNECTED COUPLING FACILITIES”. For each remotely connected coupling facility for each “subject” coupling facility, the system will display the following information: The node descriptor (ND) The cfname (Only displayed when the remotely connected coupling facility is connected to the system on which the DISPLAY CF request is being performed; otherwise, N/A is displayed.) See message IXL150I for a description of the information returned from a DISPLAY CF command.
DISPLAY XCF
DISPLAY XCF,COUPLE	Use to display XCF information that includes status of optional functions of z/OS (for example, the CFLCRMGMT function) and summary information about couple data sets.
DISPLAY XCF,COUPLE,TYPE=CFRM	Displays information about CFRM couple data sets in use in the sysplex. The information includes: Physical attributes of the CFRM couple data set (name, volume serial number, device address, and time the data set was formatted) Maximum number of systems that the primary CFRM couple data set can support Names of the systems using the CFRM couple data set.
DISPLAY XCF,STRUCTURE,...	Displays information about coupling facility structures in a policy. The information displayed may be summary or detailed information, depending on what options are specified on the command. The information includes: The status of each structure in the active CFRM policy Whether or not the CFRM couple data set needs to be reformatted, and if so, the number of structures and connections to be used in reformatting In which coupling facility the structure is allocated, with the identifying characteristics of the coupling facility The structure size, both as specified in the CFRM policy and the actual size allocated (when detailed information is requested) Connections to the structure, both maximum allowed and current, with specific information about each connector (when detailed information is requested) Preference and exclusion list information for the structure (when detailed information is requested) Pending policy information if a policy change is pending for the structure. When a structure is in a rebuild process, the primary structure is referred to as the “old” structure and the secondary structure is referred to as the “new” structure. See messages IXC359I and IXC360I for a description of the information returned from a DISPLAY XCF,STR command.
DISPLAY XCF,CF,...	Displays information about one or more coupling facilities defined in the active CFRM policy. Summary or detailed information may be obtained. The information includes: Whether or not the CFRM couple data set needs to be reformatted, and if so, the number of structures and connections to be used in reformatting Name and unique identifiers of each coupling facility as specified by the CFRM policy Size of the dump space, as specified in the policy (when detailed information is requested) Storage increment size (when detailed information is requested) Names of the systems attached to each coupling facility (when detailed information is requested) Names of the structures allocated in each coupling facility (when detailed information is requested). See messages IXC361I and IXC362I for a description of the information returned from a DISPLAY XCF,CF command.
DISPLAY XCF,POLICY,TYPE=CFRM	Displays information about the CFRM policy in use in the sysplex. The information includes: The name of the active CFRM policy The status of the policy The date and time the policy was started The date and time the policy was last updated.
DISPLAY XCF,REALLOCATE...	Displays information about the REALLOCATE process.
SETXCF
SETXCF COUPLE,TYPE=CFRM,...	Use this command to control use of the CFRM couple data set — to identify the primary CFRM couple data set (PCOUPLE= ), the alternate CFRM couple data set (ACOUPLE= ), or to switch from using the primary to using the alternate (PSWITCH).
SETXCF START,...	Use this command to initiate processing for coupling facility resources. SETXCF START,POLICY,TYPE=CFRM is used to activate a CFRM administrative policy in the sysplex SETXCF START,REBUILD,STRNAME or CFNAME is used to initiate the rebuild process for one or more named coupling facility structures or for all structures in a coupling facility. The system does not start rebuild for XCF signaling structures when the command specifies all structures in a named coupling facility. The PATHIN and PATHOUT options with STRNAME are used to start the use of a structure as an inbound or outbound XCF signaling path. SETXCF START,MAINTMODE,CFNAME places a coupling facility in maintenance mode before taking a coupling facility down for maintenance. SETXCF START,REALLOCATE initiates the REALLOCATE process to recognize the need to relocate structure instances.
SETXCF STOP,...	Use this command to halt the processing that is currently being done for coupling facility resources. SETXCF STOP,POLICY,TYPE=CFRM is used to deactivate the current active policy. SETXCF STOP,REBUILD,STRNAME or CFNAME is used to discontinue the rebuild process for one or more named coupling facility structures or for all structures in a coupling facility. The PATHIN and PATHOUT options with STRNAME are used to discontinue the use of a structure as an inbound or outbound XCF signaling path. SETXCF STOP,MAINTMODE,CFNAME takes a coupling facility out of maintenance mode after returning the CF to the sysplex once maintenance is complete. SETXCF STOP,REALLOCATE stops an in-progress REALLOCATE process.
SETXCF FORCE,...	Use this command to clean up coupling facility resources in a coupling facility The resource can be either a structure actively in use in the sysplex, a connection to a structure, a dump associated with a structure, all failed-persistent connections to a structure, or dump serialization for a structure.
SETXCF FUNCTIONS,...	Use the SETXCF FUNCTIONS command to enable or disable optional functions of z/OS (for example, the CFLCRMGMT function).
SETXCF MODIFY,...	Use this command to change structure attributes of a coupling facility structure defined for XCF signaling.
VARY PATH	Use this command to change the state of the logical paths that lead to a coupling facility. The DISPLAY CF command displays the CHPIDs associated with a logical path to a coupling facility. Note that a logical path to a coupling facility is designated by a CHPID and a coupling facility name, not a CHPID and device number.
VARY XCF	Use this command to remove a system from the sysplex through the sysplex partitioning process.