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 V5R4.0.
Last updated on 5 Sep 2008 at 09:11:41.
Copyright IBM Corporation, 1990, 2008