Cross-Invalidating a Data Item: Summary

Use the cross-invalidate function to invalidate the copies of one or more data items for other users.

To identify the data item, specify the data item name on the NAME keyword. If you want to invalidate only the named data item, omit the NAMEMASK keyword.
To invalidate all data items whose name matches a specified character pattern, code both the NAME and NAMEMASK keywords. NAME must specify a data item name that contains the specified character pattern. NAMEMASK must specify a bit-string with the bits that correspond to the specified character pattern set to B'1'. For examples of how to use NAME and NAMEMASK, see Using Filters for Names on Requests.

If the coupling facility time-out criteria are exceeded, the cross-invalidate request completes prematurely. For the time-out of a request, the system returns a token that you can use to restart the request from the point at which it timed-out. The system returns the token in the CAARESTOKEN field of the answer area. To restart a request that completes prematurely, code the IXLCACHE REQUEST=CROSS_INVAL request as you previously coded it with the exception of the RESTOKEN keyword. The RESTOKEN keyword must specify the token that the system returned when the cross-invalidate request ended prematurely.

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: