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


Connecting to a Cache Structure

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

This topic describes the IXLCONN parameters that you code to connect to a cache structure. To help you code the IXLCONN macro, use the general IXLCONN guidance information in Connecting to a Coupling Facility Structure together with the information provided here.

The first application that connects to a cache structure allocates the structure and defines its attributes. Subsequent connectors to the structure use the structure as it has been allocated by the first connector. The following IXLCONN parameters define the attributes of the cache structure or its connector:
ALLOWDUPREBLD
Specifies whether this connection allows user-managed duplexing rebuild to be initiated for the cache structure.
ELEMCHAR or ELEMINCRNUM
Specifies the data element size for the cache structure.
MAXELEMNUM
Specifies the maximum number of data elements per data entry. For a coupling facility of CFLEVEL=0, the maximum number can be from 1 to 16. For a coupling facility of CFLEVEL=1 or higher, the maximum number can be from 1 to 255.
DIRRATIO
Specifies the directory component of the directory-to-element ratio.
ELEMENTRATIO
Specifies the element component of the directory-to-element ratio.
ADJUNCT
Specifies whether the cache structure is to contain adjunct areas.
VECTORLEN
Specifies the maximum number of data items for which the connection can have concurrent registration.
NUMCOCLASS
Specifies the maximum number of cast-out classes that can be used by the connection.
NUMSTGCLASS
Specifies the maximum number of storage classes that can be used by the connection.
UDFORDER
Specifies whether a user data field (UDF) order queue should be maintained for each cast-out class for the structure. Applicable only to cache structures allocated in a coupling facility with CFLEVEL=5 or higher.
NAMECLASSMASK
Specifies the name class mask pattern definition to be applied to entry names at connect time. Name classes are used by the coupling facility to assign each entry to a name class within the structure. Name classes can be used to improve the processing efficiency of IXLCACHE REQUEST=DELETE_NAME command. Applicable only to cache structures allocated in a coupling facility with CFLEVEL=7 or higher.
SUPPRESSEVENTS
Specifies whether the origination of certain connection and disconnection events should be suppressed for this connector. The following events can be suppressed for their originator: New Connection, Existing Connection, Rebuild New Connection, Rebuild Existing Connection, and Discontinued or Failed Connection. Suppression of these events may provide a significant performance benefit at connect or disconnect time to connectors who do not need the information presented. See Suppressing Certain Events for a Connector.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014