Specifying the Vector Entry Index on IXLCACHE Requests

You specify a vector entry index to refer to the data item in your local cache buffer on the following IXLCACHE requests:

IXLCACHE REQUEST=WRITE_DATA
IXLCACHE REQUEST=READ_DATA
IXLCACHE REQUEST=CASTOUT_DATA

The system tracks data items in the local cache buffers through each user's vector entry index that corresponds to the local buffer for the named data item. Users are responsible for defining and maintaining the vector entry index values and for specifying on the IXLCACHE request the index for the data item. On the request, you can specify the vector entry index currently assigned to the data item in the cache structure, a vector entry index that is not currently assigned to the data item in the cache structure, or a vector entry index that is currently assigned to another data item in the cache structure.

Specifying an Assigned Vector Entry Index
To specify the vector entry index currently assigned to the data item, code the vector entry index on VECTORINDEX and the name of the data item on the NAME keyword. The system registers your interest in the data item. It is your responsibility to keep track of the vector entry index you have assigned to the data item and to ensure that you specify that vector entry index.
Specifying a Currently Unassigned Vector Entry Index
To specify a vector entry index that is currently unassigned to a data item, code the unassigned vector entry index on VECTORINDEX and the name of the data item on NAME. The system registers your interest in the data item. The data item can be a new data item that currently does not have an assigned vector entry index, or a data item that is currently assigned a different vector entry index, in which case, the system invalidates the existing vector entry for the data item.
Specifying a Vector Entry Index that is Assigned to Another Data Item
To specify a vector entry index that is currently assigned to a data item to another data item, code the vector entry index for the data item on VECTORINDEX and the name of the data item to which you are assigning the vector entry index on NAME. On the OLDNAME keyword, specify the name of the data item to which the vector entry index is currently assigned. The system registers your interest in the data item specified on NAME and deregisters your interest in the data item specified on OLDNAME. The data item for NAME can be a new data item that currently does not have a vector entry index assigned or a data item that is currently assigned a different vector entry index, in which case, the system invalidates the existing vector entry index for the data item.

For a description of the vector entry index and IXLCACHE REQUEST=WRITE_DATA, see Registering Interest in the Data Item for WRITE_DATA Requests.

For a description of the vector entry index and IXLCACHE REQUEST=READ_DATA, see Registering Interest in the Data Item for READ_ DATA Requests.

For a description of the vector entry index and IXLCACHE REQUEST=CASTOUT_DATA, see Registering Interest in the Data Item for CASTOUT_DATA Requests.