Description

A READ_COSTATS request allows you to retrieve statistical information for the specified cast-out classes in the range beginning with COCLASSB and ending with COCLASSE. The information is returned in the storage areas specified by BUFLIST or BUFFER. The format of the information returned depends on the level of the coupling facility in which the structure is allocated and on the COSTATSFMT specification. For cache structures allocated in a coupling facility of CFLEVEL=5 or higher, you can use the COSTATSFMT keyword to specify the level of detailed information that is to be returned.

For structures allocated in a coupling facility of CFLEVEL=4 or lower, or if COSTATSFMT=COCOUNTSLIST is specified, the format of the information returned is described by the CCIH and CCIHCOUNTS mappings of the IXLYCCIH mapping macro and consists of:

The first and last cast-out classes for which information was returned.
For each cast-out class for which information was returned, the number of data elements associated with data entries in the indicated cast-out class.

For structures allocated in a coupling facility of CFLEVEL=5 or higher, when COSTATSFMT=COSTATSLIST, the format of the information returned is described by the CCIH, CCIHCOSTATSLIST, and CCIHCCIBS mappings of the IXLYCCIH mapping macro. The information returned consists of:

The first and last cast-out classes for which information was returned.
For each cast-out class for which information was returned, the number of data elements associated with data entries in the indicated cast-out class and the user data that was written to the directory entry when the IXLCACHE WRITE_DATA request was invoked. If the structure was allocated with a UDF order queue, the field contains the user data of the first entry on the UDF order queue. If the structure was allocated without UDF order queues, the field contains the user date of the first entry on the cast-out class queue.
(The UDFORDER keyword of IXLCONN is used to allocate a cache structure with UDF order queues.)