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
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   92  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  Unsigned     4  STOXSG_XSTMAXCT        Number of times the target
                                                    time is lowered
     72  48  Unsigned     4  STOXSG_XSTRLOCT        Number of time the migration
                                                    threshold buffer increased
     76  4C  Unsigned     4  STOXSG_XSTRHICT        Number of times the migration
                                                    threshold buffer decreased
     80  50  Unsigned     4  STOXSG_XSTUSRDM        Number of dormant guest owned
                                                    address spaces that were the
                                                    target of migration
     84  54  Unsigned     4  STOXSG_XSTUSRCY        Number of non-dormant guest
                                                    owned address spaces that were
                                                    the target of migration
     88  58  Unsigned     4  STOXSG_XSTCTPGM        Count of PGMBKs selected
                                                    while migrating
     92  5C  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     92
    STOXSG_END                5C      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_XSTCTPGM           58      4
    STOXSG_XSTCYCLS           34      4
    STOXSG_XSTGUEST           38      4
    STOXSG_XSTLOTHR           30      4
    STOXSG_XSTMAXCT           44      4
    STOXSG_XSTMIGS            14      4
    STOXSG_XSTNOIO            3C      8
    STOXSG_XSTRHICT           4C      4
    STOXSG_XSTRLOCT           48      4
    STOXSG_XSTSUMAG           1C      8
    STOXSG_XSTUSRCY           54      4
    STOXSG_XSTUSRDM           50      4

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

    Last updated on 8 Oct 2009 at 21:08:13.

    Copyright IBM Corporation, 1990, 2009