Marking a Data Item as Unreferenced: Summary

You use the RESET_REFBIT request to mark as unreferenced specified data items.

To identify the data items that the system is to mark as unreferenced, use the NAME, NAMEMASK, and CRITERIA keywords.
Use these keywords together to identify a single data item or a group of data items whose names match a specified character selection pattern or match the criteria specified on the request.

If time-out criteria for the coupling facility are exceeded, the RESET_REFBIT request can complete prematurely. When a request completes prematurely, the system returns a token in the CAARESTOKEN field of the answer area. You can use this token to restart the request from the point at which it completed prematurely.

To restart a request, first process the data based on the count information that the RESET_REFBIT returns in the ANSAREA. After processing the data, code the IXLCACHE REQUEST=RESET_REFBIT request as you previously coded it with the exception of the RESTOKEN keyword. The RESTOKEN keyword must specify the token that the system returned.

There are other keywords that are required and some that are optional. For a description of keywords that are applicable to all IXLCACHE requests, see: