Description

An UNLOCK_CASTOUT request allows you to release the cast-out locks for multiple data items that are named in the storage areas specified by either BUFFER or BUFLIST. The data items listed by name in the buffer(s) are referenced by an index into the buffer(s), and are processed sequentially beginning with the data item identified by the first index (FIRSTNAME) and ending with the data item identified by the last index (LASTNAME). Besides releasing cast-out locks, the request updates the parity and user data in the directory entry for each data item named in the list. The parity and user data for each data item should also be supplied in the buffer(s). (See mapping macro IXLYCUNB for how the buffer(s) should be arranged.)

Once the cast-out lock is released for a data item, the data item might or might not remain associated with its cast-out class:

If the data entry contains unchanged data, the data item is disassociated from any previously specified cast-out class.
If the data entry contains changed data (the entry could have had changed data written to it while the cast-out lock was held), the data item is left associated with the last specified cast-out class.

You can also specify that a currently unchanged data item remain associated with its cast-out class by overriding its changed indicator in the directory entry for the data item to indicate the data item is changed. This information should also be supplied in the buffer(s).

An UNLOCK_CASTOUT request can either fail or complete prematurely for the following reasons:

A data item named in the buffer(s) does not exist in the structure. The index of the failing name is returned in the answer area (ANSAREA). All names preceding the failing name are processed.
You do not hold the cast-out lock for a data item named in the buffer(s). The index of the failing name and the value of the cast-out lock are returned in the answer area because of either a user or PROCESSID mismatch. All names preceding the failing name are processed.
The request has exceeded the model-dependent time-out criteria. The index of the next name to be processed is returned in the answer area. All names preceding this name are processed.

The index value of the data item name that caused the problem is returned in CAAULINDEX. You may update FIRSTNAME to point after CAAULINDEX, and reissue the request.