z/OS MVS Programming: Sysplex Services Guide
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


The Remainder of the Buffer

z/OS MVS Programming: Sysplex Services Guide
SA23-1400-00

The data in the remainder of the buffer depends on whether you have specified the COSTATSFMT keyword. COSTATSFMT is valid only for structures allocated in a coupling facility with CFLEVEL=5 or higher.
  • For structures allocated in a coupling facility with CFLEVEL=4 or lower, or when COSTATSFMT=COCOUNTSLIST is specified or defaulted to, the remainder of the buffer is as follows:

    The remainder of the buffer consists of four-byte entries. There is a one-to-one correspondence between each four-byte entry and a cast-out class in the range of cast-out classes for which the information is returned. Each entry contains the number of cache structure data elements allocated to the corresponding cast-out class. The first buffer entry corresponds to the cast-out class specified on the COCLASSB keyword. The next entry corresponds to the next sequentially numbered cast-out class, and so forth.

    The following chart summarizes the buffer format and contents upon return from the request:

    Offset Contents
    +0 Number of the first cast-out class reported on
    +2 Number of the last cast-out class reported on
    +4 Number of data elements allocated for the cast-out class specified by COCLASSB
    +8 Number of data elements allocated for the next sequential cast-out class.
    +(4 * n) Number of data elements allocated for the last cast-out class where n is the total number of elements returned in the buffer.

    Mapping CCIHCOUNTS of IXLYCCIH maps the information returned for structures allocated in a coupling facility with CFLEVEL=4 or lower or by specifying COSTATSFMT=COCOUNTSLIST.

  • For structures allocated in a coupling facility with CFLEVEL=5 or higher and for which COSTATSFMT=COSTATSLIST is specified, the remainder of the buffer is as follows:

    The remainder of the buffer, starting at offset 32, consists of 16-byte entries. There is a one-to-one correspondence between each 16-byte entry and a cast-out class in the range of cast-out classes for which the information is returned. Each entry contains the number of cache structure data elements allocated to the corresponding cast-out class and eight bytes of user data. If the structure has been allocated with a UDF order queue for each cast-out class, the eight bytes is the user data of the first entry on the UDF order queue. If the structure has not been allocated with a UDF order queue, the eight bytes is the user data of the first entry on the cast-out class queue. The first buffer entry corresponds to the cast-out class specified on the COCLASSB keyword. The next entry corresponds to the next sequentially numbered cast-out class, and so forth.

    The following chart summarizes the buffer format and contents upon return from the request:

    Offset Contents
    +0 Number of the first cast-out class reported on
    +2 Number of the last cast-out class reported on
    +4 Reserved
    +32 Cast-out class entry data for the cast-out class specified by COCLASSB.
    • Number of data elements allocated
    • User data
    +64 Cast-out class entry data for the next sequential cast-out class.
    +(32 * n) Number of data elements allocated for the last cast-out class where n is the total number of elements returned in the buffer.

    Mapping CCIHCCIBS of IXLYCCIH maps the information returned for structures allocated in a coupling facility with CFLEVEL=5 or higher when COSTATSFMT=COSTATSLIST is specified. For a description if IXLYCCIH, see z/OS® MVS™ Data Areas in the z/OS Internet library.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014