A CROSS_INVALLIST request allows you to specify that a cross-invalidate operation be performed against a set of 1 to 4096 entries identified by a list of names in the BUFFER storage area or the buffers specified by BUFLIST.

The system references the name elements by an index into the buffer and processes them sequentially beginning with the name block identify by the first index (STARTINDEX) and ending with the data item identified by the last index (ENDINDEX). The name elements are numbered starting with 1.

If any name element fails to identify an existing structure entry, processing either continues or terminates, depending on the value specified for the ERRORACTION keyword. If ERRORACTION=TERMINATE, processing stops and the index value of the name element that caused the problem is returned in the CAACILINDEX field in the IXLYCAA answer area. If ERRORACTION=CONTINUE, processing continues with the next name element.

A CROSS_INVALLIST can complete prematurely because the request exceeds the time-out criteria for the coupling facility. (Time-out criteria is model-dependent.) When a request completes prematurely, the system returns an index value (CAACILINDEX) in the answer area which you can use to restart the CROSS_INVALLIST request. The index value returned when a CROSS_INVALLIST request completes prematurely is the index of the first unprocessed name element.

A CROSS_INVALLIST request can be issued only for cache structures allocated in a coupling facility of CFLEVEL=12 or higher. CROSS_INVALLIST requests issued for a cache structure allocated in a coupling facility of CFLEVEL=0 through 11 will fail.