gtpo1m2cOperations

ZCFCH-Manage Coupling Facility Cache Structures

Use this command to manage coupling facility (CF) cache structures.

Requirements and Restrictions

This command must be entered from the basic subsystem (BSS).

Format




DISPlay
displays information about the CF cache structure.

COunts
displays the current storage class counters for the CF cache structure.

cache
is the 4- to 12- character alphanumeric name of the target CF cache structure. The first character of the CF cache structure name must be an alphabetic character.

FILE
displays the contents of the processor shared CF cache control record.

MODify
sets the number of entries defined for the CF cache structure in the processor shared CF cache control record. The number of entries specified overrides the number of entries specified on the newCache function call that is issued by the application to create the CF cache structure. The change is not active until the next time theCF cache structure is created on the CF.

SIZE entrysize
specifies the number of entries defined for the CF cache structure where entrysize is a decimal number from 0 to 999 999 999.

REMove
allows you to remove the cache definition for the specified CF cache structure from the processor shared CF cache control record. This action does not affect the CF cache structure that is currently active.

Additional Information

Online help information is available for this command. To display the help information, enter one of the following:

ZCFCH HELP

ZCFCH ?

Examples

The following example shows information about the processor shared CF cache control record.

+--------------------------------------------------------------------------------+
|User:    ZCFCH DISP FILE                                                        |
|                                                                                |
|System:  CFCH0002I 19.29.52 CF CACHE CONTROL RECORD DISPLAY                     |
|         NAME HISNHER       SIZE   000000200                                    |
|         NAME HERNHIS       SIZE   000000300                                    |
|         DISPLAY COMPLETE                                                       |
+--------------------------------------------------------------------------------+

The following example shows information about the current storage class counters for the CF cache structure.

+--------------------------------------------------------------------------------+
|User:    ZCFCH DISP CO TPF_FS_INODE                                             |
|                                                                                |
|System:  CFCH0005I 15.15.48 CF STORAGE CLASS 1 COUNTER DISPLAY                  |
|         NAME TPF_FS_INODE                                                      |
|         DIRECTORY HIT               0000000008                                 |
|         READ MISS, ASSIGNED         0000000064                                 |
|         DIRECTORY                   0000000064                                 |
|         COUNTERS WITH ZERO WERE NOT DISPLAYED                                  |
|         DISPLAY COMPLETE                                                       |
+--------------------------------------------------------------------------------+

The following example changes the number of entries for CF cache structure HISNHER to 300.

+--------------------------------------------------------------------------------+
|User:    ZCFCH MODIFY HISNHER SIZE 300                                          |
|                                                                                |
|SYSTEM:  CFCH0017I 12.20.22 CACHE HISNHER    SUCCESSFULLY MODIFIED              |
+--------------------------------------------------------------------------------+

Related Information