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 V6R3.0.

Last updated on 22 Jul 2013 at 15:07:38.
Copyright IBM Corporation, 1990, 2013