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

#### MRMTRPAG

Prolog
Control Block Contents
Cross Reference

#### MRMTRPAG Prolog

####

####

     DSECT NAME - MTRPAG
     FUNCTION - Map a Monitor record.
     LOCATED BY -
            Through the Monitor Control Area
     REFERENCED CONYTOL BLOCKS -
            MRRECHDR    Monitor Record Header
     NAME - MRMTRPAG
     DESCRIPTIVE NAME - Monitor Sample Configuration Record
                        Domain 1 - Monitor Domain
                        Record 8 - Paging Configuration Data
     DESCRIPTION - Identifies paging and spooling space available
                   on CP owned DASD. A separate record is generated
                   for each contiguous paging area and each contiguous
                   spooling area on a CP volume.

    MRMTRPAG Control Block Contents

    Offsets
    Dec Hex  Type       Len  Name (Dim)             Description

      0   0  Structure   48  MTRPAG                 Start of monitor record
      0   0  Character    0  MTRPAG_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  Character    6  MTRPAG_CPVOLSER        Volume serial identifier
     26  1A  Unsigned     1  MTRPAG_RDCPCYL         Number of pages per cylinder.
                                                    Not applicable for FBA devices.
                                                    See MTRPAG_FBA
     27  1B  Bitstring    1  MTRPAG_CALFLAGS        Flag byte
              1... ....      MTRPAG_FBA             When on, this device is a FBA
                                                    (Fixed Block Access) DASD.
              .1.. ....      *
              ..1. ....      *
              ...1 ....      *
              .... 1...      *
              .... .1..      *
              .... ..1.      *
              .... ...1      *
     28  1C  Character    4  MTRPAG_CALTYPE         'PAGE' = paging space, 'SPOL'
                                                    = spooling space
     32  20  Signed       4  MTRPAG_CALCYLNO        Space allocation. Number of
                                                    cylinders for a non-FBA DASD,
                                                    or number of pages for a FBA
                                                    DASD. See MTRPAG_FBA
     36  24  Signed       4  MTRPAG_CALSTART        Start of the paging or
                                                    spooling area. A cylinder
                                                    number for a non-FBA DASD, or a
                                                    page number for a FBA DASD. See
                                                    MTRPAG_FBA
     40  28  Unsigned     4  MTRPAG_RDEVSID         Host subchannel id
     44  2C  Unsigned     2  MTRPAG_RDEVDEV         Device number
     46  2E  Unsigned     2  *                      Reserved and available for
                                                    for IBM use
     48  30  Character    0  MTRPAG_END

    MRMTRPAG 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
    MTRPAG                     0     48
    MTRPAG_CALCYLNO           20      4
    MTRPAG_CALFLAGS           1B      1
    MTRPAG_CALSTART           24      4
    MTRPAG_CALTYPE            1C      4
    MTRPAG_CPVOLSER           14      6
    MTRPAG_END                30      0
    MTRPAG_FBA                1B           80
    MTRPAG_MRHDR               0      0
    MTRPAG_RDCPCYL            1A      1
    MTRPAG_RDEVDEV            2C      2
    MTRPAG_RDEVSID            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