Restarting a REQUEST=READ_DIRINFO Request that Ends Prematurely

The IXLCACHE REQUEST=READ_DIRINFO request can complete prematurely for the following reasons:

The local cache buffer cannot hold all of the available information.
The request exceeds the time-out criteria for the coupling facility (Time-out criteria is model-dependent.)

Be sure to process the information returned from this request before reissuing the request. The data returned from this request will be overwritten if you specify the same buffer address. Continue to reissue the request until the return code indicates that all processing has completed.

For general information about restarting a request, see Restarting a Request that Ends Prematurely.

On most IXLCACHE requests, the system returns information related to the request in the answer area. You specify the answer area on the ANSLEN and ANSAREA keywords. With certain events, the information in the answer area might not be valid. See Determining Valid Information in the Answer Area.

When the request completes, the system returns information to the answer area. When the request is not valid, the system returns non-zero return and reason codes.

For the mapping of the answer area, see the IXLYCAA mapping macro described in z/OS® MVS™ Data Areas in the z/OS Internet library. For a description of answer area fields and return and reason codes for the request, see z/OS MVS Programming: Sysplex Services Reference.