To identify the data item, code the data item name on the NAME keyword.

You can cast-out a data item regardless of whether you have registered interest in the data item. You also have the option to register interest as part of the cast-out operation. If you do not want to register interest, code REGUSER=NO. To register interest, code REGUSER=YES and VECTORINDEX to assign a vector entry. If you assign a vector entry that is currently assigned to another data item, specify that data item name on the OLDNAME keyword. The system deregisters your interest in the data item specified on the OLDNAME keyword.

Optionally, you can identify your task or process as the holder of the data item's cast-out lock. To do this, specify the task or process identifier on the PROCESSID keyword. By providing this identifier, you enable other users to determine which task or process holds the data item's cast-out lock.

To read a data item for cast-out, identify your local cache buffers by coding either BUFFER, or BUFLIST and their related keywords. The system transfers the data item from the data entry to your local cache buffers. If the data entry does not contain changed data, the system does not obtain the cast-out lock for the data item and does not cast out the data to your local cache buffers. Return and reason codes indicate the error, and the system does not register interest for the user in the data item.

If the cache structure supports adjunct data, you can read the adjunct data for cast-out by coding the ADJAREA keyword. The system transfers the adjunct data from the cache structure to the buffer specified on the ADJAREA keyword.