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   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 V4R4.0.
Last updated on 22 Jul 2003 at 15:04:23.
Copyright IBM Corporation, 1990, 2003