z/OS MVS Programming: Sysplex Services Guide
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


Requesting a Minimum CFLEVEL

z/OS MVS Programming: Sysplex Services Guide
SA23-1400-00

Use the MINCFLEVEL parameter to specify the minimum coupling facility level in which to allocate the structure. The value of MINCFLEVEL must be equal to or less than the value of CFLEVEL.

Specifying MINCFLEVEL prevents the system from allocating the structure in a coupling facility from the structure's preference list that is at a lower coupling facility level than MINCFLEVEL. This applies to initial allocation, user-managed rebuild allocation, and user-managed duplexing allocation. If the structure's preference list does not contain a suitable coupling facility in which to allocate the structure, the system rejects the IXLCONN request with reason code IXLRSNCODENOFAC. The CONAFACILITYARRAY, which contains information about each coupling facility in which allocation was attempted, will contain the reason code CONARSNINSUFFCFLEVELUSER for each coupling facility that was not chosen because it did not meet the specified MINCFLEVEL requirement.

If a structure is already allocated, the system will prevent connectors that specify MINCFLEVEL to connect to the structure if the MINCFLEVEL specified is higher than the coupling facility level in which the structure is allocated. This applies to both initial connect and rebuild connect. The system rejects the IXLCONN request to connect with reason code IXLRSNCODEINSUFFCFLEVELUSER when the structure is allocated in a lower level coupling facility than MINCFLEVEL. The CFLEVEL at which the structure is currently allocated is returned in CONAFACILITYCFLEVEL.

Connectors must be aware when specifying the MINCFLEVEL keyword that if connectors specify different values for MINCFLEVEL it is possible for some connectors to be unable to connect to the structure. It might also be true that the installation does not have a coupling facility at the requested MINCFLEVEL, in which case the connect request would never be successful.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014