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.