Registering Interest in a List of Data Items: Summary

You use a register name list request to register interest in up to 32 data items.

The request must identify the data items by building a list of registration blocks in a buffer. Each registration block contains information about the data item, such as name, storage class, and whether a directory entry should be assigned.

The request must indicate the first and last registration block in the list of registration blocks that the system is to process.

To identify the first registration block, use the STARTINDEX keyword.
To identify the last registration block, use the ENDINDEX keyword.

The request can complete prematurely for the following reasons:

The coupling facility timed-out.
A registration block specified an incorrect storage class or the target storage class was full.
A registration block specified an incorrect local cache vector index.

Each time a request completes prematurely, the system returns an index value. You can use the index value to identify the registration block that might have caused the premature completion. You can also use the index value to restart the request.

There are other keywords that are required and some that are optional. Some of these keywords apply to all IXLCACHE requests and others apply to just REG_NAMELIST requests. For a description of keywords applicable to all IXLCACHE requests, see: