gtpd1m3b | Database Reference |
This section will help you to understand how to use the serialized list structure as well as provide information about the CF locking functions and the format of the CF lock.
As discussed previously in Coupling Facility List Structure, a serialized list structure is a list structure that contains a lock table. The lock table is an array of exclusive locks whose purpose and scope are defined by the application. Lock table locks can provide a serialization mechanism for lists, list entries, or any other list structure entity you designate. The first connector to a CF list structure specifies whether it is to be a serialized list structure and, if so, the number of lock entries to be allocated in the lock table. Figure 60 shows a serialized list structure.
The CF lock is used to serialize operations on the CF and is 16 bytes long. Figure 66 shows the format of the CF lock.
Figure 66. Format of the CF Lock
In the CF lock:
The CF lock is considered corrupted when the available state indicator does not contain the characters 'TPF' and the CF lock is not set to all zeros.
The following scenarios illustrate how the content of the CF lock changes when different CF operations are performed or various system states occur.
Figure 67. Format of the CF Lock When a CF Is in Available State
Figure 68. Format of the CF Lock When a CF Is in a Nonavailable State
Figure 69. Format of the CF Lock When the Lock Holder Field Is Set to Zero
When the lock holder field is not set to X'00', it is set toP+1, where P is the processor ordinal number of the processor holding the CF lock. For example, if processor C has a processor ordinal number of 1, the lock holder field would be set to X'02' (1 + 1). Figure 70 shows the format of the CF lock when the lock holder field is set to the processor ordinal number of processor C.