Programming Interface Information: The Monitor Records are intended Programming Interfaces that allow the customer to write programs to obtain services of z/VM.

#### MRSTOXSG

Prolog
Control Block Contents
Storage Layout
Cross Reference

#### MRSTOXSG Prolog

####

####

     DSECT NAME - STOXSG
     FUNCTION - Map a Monitor record.
     LOCATED BY -
            Through the Monitor Control Area
     REFERENCED CONTROL BLOCKS -
            MRRECHDR -  Monitor Record Header
     NAME - MRSTOXSG
     DESCRIPTIVE NAME - Monitor Sample Record
                        Domain 3 - Storage Domain
                        Record 9 - Expanded Storage Data
     DESCRIPTION - Expanded storage data.  Generated only when expanded
                   storage has been attached.

    MRSTOXSG Control Block Contents

    Offsets
    Dec Hex  Type       Len  Name (Dim)          Description

      0   0  Structure   68  STOXSG
      0   0  Character    0  STOXSG_MRHDR        Record header
      0   0  Character   20  MRHDR
      0   0  Unsigned     2  MRHDRLEN            record length in bytes
      2   2  Unsigned     2  MRHDRZER            field of zeros
      4   4  Unsigned     1  MRHDRDM             domain identifier
      5   5  Unsigned     1  *
      6   6  Unsigned     2  MRHDRRC             record identifier
      8   8  Character    8  MRHDRTOD            Time at which this record was
                                                 built. In time-of-day (TOD) clock
                                                 format. See IBM System 370 XA
                                                 Principle of Operation for
                                                 explanation of format.
     16  10  Character    4  *
     20  14  Character    0  MRHDR_END           End of header
     20  14  Unsigned     4  STOXSG_XSTMIGS      Number of migrate invocations
     24  18  Unsigned     4  STOXSG_XSTBLKDM     Number of expanded storage
                                                 blocks migrated from dormant
                                                 guests
     28  1C  Bitstring    8  STOXSG_XSTSUMAG     Total age of all expanded
                                                 storage blocks migrated
     36  24  Unsigned     4  STOXSG_XSTBLKCY     Number of expanded storage
                                                 blocks migrated from non-dormant
                                                 guests
     40  28  Unsigned     4  STOXSG_XSTBLKSH     Number of expanded storage
                                                 blocks migrated from shared
                                                 systems (NSS/DCSS)
     44  2C  Unsigned     4  STOXSG_XSTBLKSY     Number of expanded storage
                                                 blocks migrated from the CP system
                                                 address space.
     48  30  Unsigned     4  STOXSG_XSTLOTHR     Migration low threshold. If
                                                 XSTCTXAV falls below XSTLOTHR, the
                                                 migration task will be kicked off.
                                                 This value may change at the end
                                                 of each migration.
     52  34  Unsigned     4  STOXSG_XSTCYCLS     Number of times the migrator has
                                                 made a complete circuit of the
                                                 cyclic list
     56  38  Unsigned     4  STOXSG_XSTCPDAL     Total number of expanded storage
                                                 blocks migrated allocated to
                                                 guests
     56  38  Unsigned     4  STOXSG_XSTGUEST     Alternate name to
                                                 STOXSG_XSTCPDAL
     60  3C  Bitstring    8  STOXSG_XSTNOIO      Number of expanded storage
                                                 blocks that could be released by
                                                 the migrator without having to
                                                 perform I/O. These are pages that
                                                 have not been modified since they
                                                 were last written to DASD.
                                                 Additionally, for user pages, the
                                                 page must have been brought into
                                                 storage as part of a block and not
                                                 referenced.
     68  44  Character    0  STOXSG_END

    MRSTOXSG Cross Reference

                          Hex           Hex
    Name                 Offset Length Value

    MRHDR                   0     20
    MRHDR_END              14      0
    MRHDRDM                 4      1
    MRHDRLEN                0      2
    MRHDRRC                 6      2
    MRHDRTOD                8      8
    MRHDRZER                2      2
    STOXSG                  0     68
    STOXSG_END             44      0
    STOXSG_MRHDR            0      0
    STOXSG_XSTBLKCY        24      4
    STOXSG_XSTBLKDM        18      4
    STOXSG_XSTBLKSH        28      4
    STOXSG_XSTBLKSY        2C      4
    STOXSG_XSTCPDAL        38      4
    STOXSG_XSTCYCLS        34      4
    STOXSG_XSTGUEST        38      4
    STOXSG_XSTLOTHR        30      4
    STOXSG_XSTMIGS         14      4
    STOXSG_XSTNOIO         3C      8
    STOXSG_XSTSUMAG        1C      8

    This information is
    based on z/VM V4R3.0.

    Last updated on 1 May 2002 at 16:20:33.

    Copyright IBM Corporation, 1990, 2002