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

#### MRSYTXSP

Prolog
Control Block Contents
Cross Reference

#### MRSYTXSP Prolog

####

####

     DSECT NAME - SYTXSP
     FUNCTION - Map a Monitor record.
     LOCATED BY -
            Through the Monitor Control Area
     REFERENCED CONTROL BLOCKS -
            MRRECHDR    Monitor Record Header
     NAME - MRSYTXSP
     DESCRIPTIVE NAME - Monitor Sample Record
                        Domain 0 - System Domain
                        Record 5 - Expanded Storage Data (per processor)
     DESCRIPTION - Assesses use and benefits derived from expanded
                   storage. A separate record is generated for each
                   online processor. This information should be used
                   with record MRSYTXSG (Domain 0, Record 14) for a
                   complete picture of expanded storage use.

    MRSYTXSP Control Block Contents

    Offsets
    Dec Hex  Type       Len  Name (Dim)             Description

      0   0  Structure   56  SYTXSP                 Start of monitor record
      0   0  Character    0  SYTXSP_MRHDR           Record header. See MRRECHDR
                                                    for details.
      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     2  SYTXSP_PFXCPUAD        Processor address
     22  16  Unsigned     2  *                      Reserved for IBM use
     24  18  Unsigned     4  SYTXSP_PFXPGIN         Number of fastpath PAGINs for
                                                    this CP. Does not include those
                                                    in SYTXSP_PLSPGIN.
     28  1C  Unsigned     4  SYTXSP_PLSPGIN         Number of PGINs that could
                                                    not be handled by the page
                                                    fault fastpath for this CP
     32  20  Unsigned     4  SYTXSP_PLSPGOUT        Number of CP PGOUTs (to move
                                                    contents of real storage frame
                                                    to the expanded storage so that
                                                    the frame may be added to the
                                                    available list)
     36  24  Unsigned     4  SYTXSP_PLSPGXRD        Number of page table
                                                    translations that resulted in a
                                                    page read from expanded
                                                    storage.
     40  28  Unsigned     4  SYTXSP_PLSPGXWT        Number of page tables paged
                                                    to expanded storage
     44  2C  Unsigned     4  SYTXSP_PLSPGMRX        Number of page table
                                                    translations that resulted in a
                                                    page read from expanded storage
                                                    during expanded storage
                                                    migration.
     48  30  Unsigned     4  SYTXSP_PLSPGMRD        Number of page table
                                                    translations that resulted in a
                                                    page read from auxiliary
                                                    storage (DASD) during expanded
                                                    storage migration.
     52  34  Unsigned     1  SYTXSP_PFXCPUTY        CPU Type. Valid values: X'00'
                                                    - General Purpose (CP) X'02' -
                                                    zSeries Application Assist
                                                    (zAAP) X'03' - Integrated
                                                    Facility for Linux (IFL) X'04'
                                                    - Internal Coupling Facility
                                                    (ICF) X'05' - zSeries
                                                    Integrated Information (zIIP)
     53  35  Character    3  *                      Reserved for IBM use
     56  38  Character    0  SYTXSP_END

    MRSYTXSP 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
    SYTXSP                     0     56
    SYTXSP_END                38      0
    SYTXSP_MRHDR               0      0
    SYTXSP_PFXCPUAD           14      2
    SYTXSP_PFXCPUTY           34      1
    SYTXSP_PFXPGIN            18      4
    SYTXSP_PLSPGIN            1C      4
    SYTXSP_PLSPGMRD           30      4
    SYTXSP_PLSPGMRX           2C      4
    SYTXSP_PLSPGOUT           20      4
    SYTXSP_PLSPGXRD           24      4
    SYTXSP_PLSPGXWT           28      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