OEM Lock Help

The application that owns the structure is responsible for documenting how to determine the following information.  For a more detailed description of each of the input fields, please refer to the IXLCONN macro.

To calculate the size of an OEM lock structure provide the following input data:

Number of lock entries:

Use this input parameter to specify the number of lock entries to be allocated for the coupling facility lock structure.  If the value for LOCKENTRIES is not a power of 2, it is rounded upward to the nearest power of 2.

If the lock structure supports record data, a value of zero for LOCKENTRIES is not valid.  If the lock structure does not support record data, a value of zero indicates that the system should obtain the largest possible number of lock entries given the structure's allocated size.

Max number of connectors:

Use this input parameter to specify the maximum number of connectors that may connect to and use the lock structure.  This is the maximum number of connectors per structure specified when the primary CFRM couple data set was formatted (ITEM NAME(CONNECT) NUMBER(xx)).  CFSizer will use the smaller of this number or the release-specific maximum number of systems in a sysplex.  If you bring into use a new primary CFRM couple data set formatted for a greater number of connectors per structure, you must repeat this calculation, since the new value will be applied if you rebuild the structure or re-IPL the sysplex.

Max number of record data entries:

Use this input parameter to specify the maximum number of record data entries for the coupling facility lock structure.  If the value for the maximum number of record data entries is 0, the system assumes a pure lock structure with no record table.  If the value for the maximum number of record data entries is 0, then the structure is not alterable.

Alterable:

Use this input parameter to specify whether the lock structure is alterable or not alterable.

ALTERABLE=YES

The lock structure can be altered.

ALTERABLE=NO

The lock structure can not be altered.

If the maximum number of record data entries is 0, then alterable must be NO.

Asynchronous Duplexing:

Use this input parameter to indicate whether the structure will be eligible for asynchronous duplexing. If the CFRM policy description for this structure specifies

DUPLEX(ALLOWED|ENABLED,dupoptions)

where dupoptions includes ASYNC or ASYNCONLY, then specify YES. Otherwise, specify NO.