File control coupling facility data table pool wait element (FCPW)
The file control coupling facility data table (CFDT) pool wait element (FCPW) represents a task that attempted to issue a request to a CFDT that resides in a particular pool, but that must wait because there are no available request slots. Depending on the kind of request, the FCPW represents a locking request slot (LRS) wait or a MaxReqs wait. A flag in the FCPW indicates the kind of wait.
The FCPW is created when a task goes into a MaxReqs or LRS wait. It is obtained by using a getmain request from the pool wait element subpool, and appended to a chain of wait elements for the pool. The wait chains are anchored in the pool element (FCPE), with one FCPW for each task that is waiting. The FCPE contains head and tail fields for the chains of LRS and MaxReqs FCPWs (FCPE_FIRST_LRS_WAITER, FCPE_LAST_LRS_WAITER, FCPE_FIRST_WAITER, and FCPE_LAST_WAITER). The chains are manipulated using logic that does not require any special case code for the ends of the chains, but that does mean that when the chains are empty, the head and tail fields contain a special initial value, rather than zero.
- A pointer to the next FCPW in the chain (if no next FCPW, this contains the special initial value)
- A pointer to previous FCPW in the chain (if no previous FCPW, this contains the special initial value)
- The suspend token for the wait
- The task token of the waiting task
- The suspend start time