Reading Cast-out Statistics: Summary

You read cast-out statistics to determine the total number of data entries that are assigned to cast-out classes.

To identify the range of cast-out classes whose statistics are to be read, code the COCLASSB and COCLASSE keywords. COCLASSB identifies the number for the cast-out class at the beginning of the range and COCLASSE for the number of the cast-out class at the end of the range.
To identify the buffers where the system is to return the cast-out statistics, code either BUFLIST or the BUFFER and their related keywords.
To specify the format of the information returned for structures allocated in a coupling facility with CFLEVEL=5 or higher, code the COSTATSFMT keyword.

The system returns, to buffer offset 0, a fullword: the high-order two-bytes identify the first cast-out class whose statistics were read. The low-order two-bytes identify the last cast-out class whose statistics were read. IXLYCCIH maps the first word of the buffer. Following this fullword are the entries that contain the cast-out class statistics. The format of these entries is dependent on the level of coupling facility in which the structure is allocated and the COSTATSFMT sepcification.

The request can complete prematurely if the buffer is not large enough to hold all of the data to be returned. To restart the request, add 1 to the cast-out class number that the system returned in the low-order two bytes of the first word in the buffer. Specify the increment on the COCLASSB keyword and reissue the IXLCACHE REQUEST=READ_COSTATS request as previously coded (except for the new value of COCLASSB).

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: