LTE= parameter for procedures

Use the LTE= parameter in procedure to specify the number of lock table entries available in the coupling facility lock structure (in units of 1,048,576). LTE can have a value of blank, zero, or any exact power of 2 up to a maximum of 1024.

For example, a value of LTE=32 would result in a lock table size of 64 MB, assuming a width of 2 bytes for each lock table entry. If the value specified on LTE is incorrect, START terminates with DXR116E CODE=24 and ABENDU2018. This value is only used if SCOPE=GLOBAL or NODISCON and has a default of blank (IRLM calculates the value). The number of lock table entries in the group is used in the order outlined in the list, and the width is controlled by the value specified on MAXUSRS. Both of these are dictated by the first IRLM to connect to the group during initial structure allocation or during a REBUILD:
1
The value specified on the MODIFY irlmproc,SET,LTE= command if greater than zero.
2
The value from the LTE= in the IRLMPROC if greater than zero.
3
The existing logic, which determines the nearest power of 2 after dividing the XES structure size returned on the IXCQUERY call by 2 times the LTE width (based on MAXUSRS).
If an attempt is made to use a nonzero value from either number 1 or number 2 and that value would require more storage than is available in the structure size returned by the XES IXCQUERY issued by IRLM, then the value from the next priority order is used (number 2 or number 3 from the previous list). IRLM does not try to determine how many record table entries the user wants. If the LTE= value consumes most or all the coupling facility lock structure size available, IRLM allows the connect to succeed.
Note: IRLM supports a maximum of 1024 MB lock entries. If a user specifies a high value for lock structure size in a CFRM policy, IRLM calculates the lock entries for the hash table depending upon the number of users (MAXUSRS) and the structure size, and limits the lock entries to a maximum of 1024 MB.
The following table illustrates some of the commonly desired values for lock table entries and the STORAGE that would be needed for the LOCK TABLE portion as a result. The storage available for record table entries is the INITSIZE minus the storage size listed in this table.
Table 1. Common lock table entry values
For LTE= Storage if 2-byte entries Storage if 4-byte entries
8 16 MB 32 MB
16 32 MB 64 MB
32 64 MB 128 MB
64 128 MB 256 MB
128 256 MB 512 MB
256 512 MB 1024 MB