gtpd1m2xDatabase Reference

Coupling Facility Commands

The commands are used to display entries in the coupling facility trace table (CFTT) and manage the CFs in a processor configuration. The following lists the CF commands and their functions:

Function
Description

 ZCFCH 
Manages CF cache structures.

 ZDCFT 
Displays entries in the CFTT. See Coupling Facility Trace Table for more information.

 ZMCFT ADD 
Adds a CF to a processor configuration.

 ZMCFT CLEAR 
Removes from a CF the CF structures that are not known to this processor configuration.

 ZMCFT DELETE 
Removes a CF from a processor configuration.

 ZMCFT DISPLAY 
Displays the status of one or more CFs in the complex.

 ZMCFT ENABLE 
Resumes normal operations of a CF that was active previously, but became inactive when an error occurred.

 ZMCFT REMOVE 
Removes all inactive connections a processor has to a CF structure.

 ZMCFT RESETLOCK 
Resets a CF lock to an available state.

See TPF Operations for more information about these commands.

Using the Coupling Facility Commands

This section shows a scenario of how you might use the CF commands to manage CFs in a processor configuration by providing examples that span a series of commands.

Example 1: In the following example, two CFs are added to a processor configuration. First, a CF named CFONE, which is attached to symbolic device address (SDA) 1001, is added. Then, a CF named CFTWO, which is attached to SDA 510, is added.

A third CF named CFTHREE is enabled (normal operations are resumed on a CF that had been disabled) after a previous error interrupted it and the error has since been corrected. A TPF system tries to enable a fourth CF named CFFOUR after a previous error interrupted it and the error has not been corrected.

+--------------------------------------------------------------------------------+
|User:    ZMCFT ADD CFONE 1001                                                   |
|System:  MCFT0001I 07.59.28 CFMADD - COUPLING FACILITY CFONE ADDED - 2          |
|                            PATHS EXIST                                         |
|                                                                                |
|User:    ZMCFT ADD CFTWO 510                                                    |
|System:  MCFT0001I 07.55.28 CFMADD - COUPLING FACILITY CFTWO ADDED - 2          |
|                            PATHS EXIST                                         |
|                                                                                |
|User:    ZMCFT ENABLE CFTHREE                                                   |
|System:  MCFT0008I 07.52.15 CFMENA - COUPLING FACILITY CFTHREE ENABLED          |
|                                                                                |
|User:    ZMCFT ENABLE CFFOUR                                                    |
|System:  MCFT0007E 07.50.15 CFMENA - COUPLING FACILITY CFFOUR COULD NOT         |
|                            BE ENABLED                                          |
+--------------------------------------------------------------------------------+

Example 2: In the following example, the fourth CF named CFFOUR is deleted from a processor configuration. By mistake, an attempt is made to delete the first CF named CFONE after a function started running on it.

+--------------------------------------------------------------------------------+
|User:    ZMCFT DELETE CFFOUR                                                    |
|System:  MCFT0002I 07.59.28 CFMDEL - COUPLING FACILITY CFFOUR DELETED           |
|                                                                                |
|User:    ZMCFT DELETE CFONE                                                     |
|System:  MCFT0011T 07:57.24 CFMDEL - COUPLING FACILITY CFONE NOT DELETED - THERE|
|                            ARE STILL STRUCTURES ALLOCATED                      |
+--------------------------------------------------------------------------------+

Example 3: In the following example, you tried to add the first CF named CFONE to a processor configuration again. You also tried to add a fifth CF named CFFIVE to a processor configuration, but the SDA you specified is already being used by another CF.

+--------------------------------------------------------------------------------+
|User:    ZMCFT ADD CFONE 500                                                    |
|System:  MCFT0006T 07.59.20 CFMADD - COUPLING FACILITY CFONE HAS ALREADY BEEN   |
|                                     ADDED                                      |
|                                                                                |
|User:    ZMCFT ADD CFFIVE 510                                                   |
|System:  MCFT0020T 07.59.25 CFMADD - COUPLING FACILITY ATTACHED TO SDA 510 HAS  |
|                                     ALREADY BEEN ADDED WITH NAME CFTWO         |
+--------------------------------------------------------------------------------+