Summary of IXLCACHE Requests

To request cache services, you issue the IXLCACHE macro. You identify the service you want by specifying the name of the service on the REQUEST keyword. Table 1 identifies, for various IXLCACHE services, how to code the REQUEST keyword, and indicates the cache methods that typically use the service. An “X” indicates the request is typically used with the corresponding cache method. Where necessary, notes provide additional clarification. The table also provides references to the topics where the individual requests are discussed in detail.
Table 1. Description of IXLCACHE Services
To request a service to: Code REQUEST= Store- in Store- through Directory- only Where described
Define and write a new data item to the cache structure, and register interest in the data item. WRITE_DATA X X   WRITE_DATA: Writing a Data Item to a Cache Structure
Write a changed data item to the cache structure and invalidate any copies of the data item that are in other users' local cache buffers. WRITE_DATA X See note 1   WRITE_DATA: Writing a Data Item to a Cache Structure
Write data from a list of entries to the cache structure, and register interest in the data items. WRITE_DATALIST X X   WRITE_DATALIST:Writing Multiple Data Items to a Cache Structure
Read a data item from a cache structure to your local cache buffer and register interest in the data item. READ_DATA X X   READ_DATA: Reading a Data Item from a Cache Structure
Define a directory entry for a new data item to the cache structure and register interest in that data item. READ_DATA     X READ_DATA: Reading a Data Item from a Cache Structure
Register interest in a list of data items. REG_NAMELIST See note 3 X X X REG_NAMELIST: Registering Interest in a List of Data Items
Lock a data item for cast-out and read the data item from a cache structure to your local cache buffer for the purpose of writing the data to permanent storage. Also mark the data item as unchanged. CASTOUT_DATA X     CASTOUT_DATA: Casting Out Data from a Cache Structure
Lock a set of data items for cast-out and read the data items from a cache structure to your local storage for the purpose of writing the data to permanent storage. Also mark the data item as unchanged. CASTOUT_DATALIST X     CASTOUT_DATALIST: Casting Out a List of Data Items
Unlock cast-out locks that you previously obtained. UNLOCK_CASTOUT X X   UNLOCK_CASTOUT: Releasing Cast-Out Locks
Unlock a single cast-out lock that you previously obtained. UNLOCK_CO_NAME X X   UNLOCK_CO_NAME: Releasing a Single Cast-Out Lock
Invalidate other user's local copies of a data item. CROSS_INVAL     X CROSS_INVAL: Invalidating Other Users' Copies of Data Items
Invalidate other user's local copies of a set of data items. CROSS_INVALLIST     X CROSS_INVALLIST: Invalidating a List of Data Items
Delete one or more data items from a cache structure and deregister all users' interest. DELETE_NAME X X X DELETE_NAME: Deleting Data Items From a Cache Structure
Delete one or more data items from a cache structure and deregister all users' interest. DELETE_NAMELIST X X X DELETE_NAMELIST: Deleting a List of Data Items
Activate, deactivate, or change a reclaim vector. SET_RECLVCTR X X See note 2 SET_RECLVCTR: Overriding or Restoring the Default Reclaim Algorithm
Mark as recently referenced one or more data items, and move the data item(s) to the end of the storage class queue as most recently used. PROCESS_REFLIST X X See note 2 PROCESS_REFLIST: Marking Data Items as Referenced
In the associated directory entry for the specified data item(s) in the cache structure, indicate as not recently referenced and return a count of the number of data entries that currently have the reference bit set. RESET_REFBIT X X X RESET_REFBIT: Marking Data Items as Unreferenced
Read directory information for one or more data items. READ_DIRINFO X X X READ_DIRINFO: Reading Cache Directory Entries
Read cast-out class information for one or more data items. READ_COCLASS X     READ_COCLASS: Reading A Cast-Out Class
Read cast-out class statistics for one or more cast-out classes. READ_COSTATS X     READ_COSTATS: Reading Cast-Out Class Statistics
Read storage class statistics for a specified storage class. READ_STGSTATS X X See note 2 READ_STGSTATS: Reading Storage Class Statistics
Note:
  1. Store-in users mark the data as changed. Store-through users mark the data as unchanged because they intend to immediately update the data on permanent storage.
  2. Directory-only users might use the request to manage reclamation of directory storage.
  3. REG_NAMELIST users can also use the request to define a directory entry for a new data item and register interest in the data item, as with a READ_DATA request.