Specifying the Data to be Cast Out

When you cast out data, you can cast out only the data for the data item, cast out only adjunct data, or cast out both.

For example, if the data for a data item needs to be backed up on permanent storage, but the adjunct data for the data item contains control information that does not need to be backed up, you need only cast out the data for the data item. On the other hand, for adjunct data that must be backed up on permanent storage, you need to cast out both the data and the adjunct data for the data item.

To cast-out only the data for the data item, identify the local cache buffers by coding either BUFFER or BUFLIST (you must specify one of these keywords) and their related keywords. Omit the ADJAREA keyword.

To cast-out adjunct data only, code the ADJAREA keyword and omit the BUFFER keyword. Optionally, you can code the BUFLIST keyword and its related keywords. If you code BUFLIST, BUFNUM must specify a value of zero.

To cast out both the data item and adjunct data, code BUFFER or BUFLIST and their related keywords, and ADJAREA.

Consider the following when you issue these requests:

If there is data in the cache structure for the requested data item, the system transfers the data to your local cache buffer.
If you specify ADJAREA and the cache structure supports adjunct areas, the system returns the adjunct data to the area specified on ADJAREA.
If the cache structure does not support ADJAREA, the area specified on ADJAREA remains unchanged.
If there is no data in the data entry or no adjunct data, your local cache buffer and adjunct area are left unchanged.