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

#### MRMTRAZN

Prolog
Control Block Contents
Cross Reference

#### MRMTRAZN Prolog

     DSECT NAME - MTRAZN
     FUNCTION - Map a Monitor record.
     LOCATED BY -
            Through the Monitor control area
     REFERENCED CONTROL BLOCKS -
            MRRECHDR    Monitor Record Header
     NAME - MRMTRAZN
     DESCRIPTIVE NAME - Monitor Sample Configuration Record
                        Domain 1  - Monitor Domain
                        Record 36 - Available Zone Information
     DESCRIPTION - AvlZn information, including information
                   for memory reclamations.

                   When MTRAZN_C is 1 then there are more monitor
                   records generated in the same interval with
                   each record having MTRAZN_C = 1, except the
                   final record which has MTRAZN_C = 0.

#### MRMTRAZN Control Block Contents

    Offsets
    Dec  Hex  Type        Len  Name (Dim)             Description

       0   0  Structure    36+ MTRAZN                 Start of monitor record
       0   0  Character     0  MTRAZN_MRHDR           Record header. See MRRECHDR
                                                      for details.
       0   0  Character    20  MRHDR
       0   0  Unsigned      2  MRHDRLEN
       2   2  Unsigned      2  MRHDRZER
       4   4  Unsigned      1  MRHDRDM
       5   5  Unsigned      1  *
       6   6  Unsigned      2  MRHDRRC
       8   8  Character     8  MRHDRTOD
      16  10  Character     4  *
      20  14  Character     0  MRHDR_END
      20  14  Unsigned      4  MTRAZN_RSAMCHNG        Cumulative count of memory
                                                      reconfigs that have taken
                                                      place on the system
      24  18  Unsigned      4  MTRAZN_NUMZONES_RECORD Nbr of zones in record
      28  1C  Unsigned      2  MTRAZN_CALENTSZ        The size (in bytes) of each
                                                      MTRAZN_AvlZnData entry
      30  1E  Unsigned      2  MTRAZN_CALENTDSP       The displacement (in bytes)
                                                      from the beginning of this
                                                      record to the first
                                                      MTRAZN_AvlZnData entry. The
                                                      entries are consecutive
                                                      storage starting with the
                                                      first at this displacement
      32  20  Unsigned      2  *                      Reserved for IBM use
      34  22  Unsigned      1  *                      Reserved for IBM use
      35  23  Unsigned      1  *                      Reserved for IBM use
              1... ....        MTRAZN_C               Record continuation
                                                      identifier. Set when there are
                                                      more records, off in the
                                                      last record.
              .1.. ....        *
              ..1. ....        *
              ...1 ....        *
              .... 1...        *
              .... .1..        *
              .... ..1.        *
              .... ...1        *
      36  24  Character     0  MTRAZN_CALENTS         Start of the array for
                                                      AvlZns
    Start of the AvlZn's information

       0   0  Structure   136  MTRAZN_AVLZNDATA
       0   0  Character     8  MTRAZN_AVLCID          AvlZn ID
       8   8  Unsigned      8  MTRAZN_AVLLOW          First FRMTE addr that
                                                      belongs.
      16  10  Unsigned      8  MTRAZN_AVLHIGH         Last FRMTE addr that
                                                      belongs.
      24  18  Unsigned      2  MTRAZN_AVLRF           Repetition factor.
      26  1A  Unsigned      1  MTRAZN_AVLFLAG0        Flag, AvlZn description
              1... ....        MTRAZN_ISANODE         Node
              .1.. ....        MTRAZN_TOTHELEFT       Node or Zone, to the left
              ..1. ....        *
              ...1 ....        *
              .... 1...        *
              .... .1..        *
              .... ..1.        *
              .... ...1        *
      27  1B  Unsigned      1  MTRAZN_AVLFLAG1        Flag, AvlZn description
              1... ....        MTRAZN_AVLISA2G        Zone holds frames >2G
              .1.. ....        MTRAZN_AVLISSTATIC     Is in HCPRSM, not Free
                                                      storage
              ..1. ....        MTRAZN_AVLISRECON      AvlZn is a reconfigurable
                                                      zone
              ...1 ....        MTRAZN_AVLISDSRBASE    First in group that makes
                                                      up one DSR unit. Only on for
                                                      zones with AvlIsRecon
              .... 1...        MTRAZN_AVLR2PPENDING   Reconfig to Perm pending
              .... .1..        MTRAZN_AVLDUMMY
              .... ..1.        MTRAZN_AVLISINIT2      Zone is starting to init
              .... ...1        MTRAZN_AVLISINIT1      Zone is initializing
      28  1C  Unsigned      1  MTRAZN_AVLNOALLOC      Flag, do not allocate this
                                                      AvlZn
              1... ....        MTRAZN_AVLVACATING     Zone is in process of being
                                                      vacated
              .1.. ....        *
              ..1. ....        *
              ...1 ....        *
              .... 1...        *
              .... .1..        *
              .... ..1.        MTRAZN_AVLEMPTY
              .... ...1        *
      29  1D  Character     3  *                      Reserved for IBM use
      32  20  Unsigned      8  MTRAZN_AVLVACATEFAILED Cumulative count of
                                                      attempts made to vacate this
                                                      AvlZn without success. Does not
                                                      include cancel requests due
                                                      to paging threshold or by
                                                      user request. When AvlCreateTime
                                                      changes, this counter gets reset
                                                      to zero.
      40  28  Unsigned      8  MTRAZN_AVLCREATETIME   TOD clock at creation time.
      48  30  Unsigned      8  MTRAZN_AVLCONTIGS      Cardinal count of AvlZn
                                                      Contigs
      56  38  Unsigned      8  MTRAZN_AVLSINGLES      Cardinal count of AvlZn
                                                      Singles
      64  40  Unsigned      8  MTRAZN_AVLCONTSTK      Cardinal count of return
                                                      stack Contigs
      72  48  Unsigned      8  MTRAZN_AVLSINGSTK      Cardinal count of return
                                                      stack Singles
      80  50  Unsigned      4  MTRAZN_AVLTACPT        Prorated TACPT
      84  54  Unsigned      4  MTRAZN_AVLT2SPT        Prorated T2SPT
    VCZBK information

      88  58  Unsigned      1  MTRAZN_VCZBK_MEANINGFUL Flag field
              1... ....        MTRAZN_VCZBK_FILLED    VCZBK fields are filled in
              .1.. ....        *
              ..1. ....        *
              ...1 ....        *
              .... 1...        *
              .... .1..        *
              .... ..1.        *
              .... ...1        *
      89  59  Unsigned      1  MTRAZN_VCZSTATF        Status Flags
              1... ....        MTRAZN_VCZRUNNG        Stacked/running
              .1.. ....        MTRAZN_VCZWAITN        Waiting
              ..1. ....        MTRAZN_VCZDMDCN        Reclamation cnclld/halted
              ...1 ....        MTRAZN_VCZDSRCN        DSRUnit cancelled
              .... 1...        MTRAZN_VCZWINDO        In a DSBOW open window
              .... .1..        *
              .... ..1.        MTRAZN_VCZFRXFR        Next pass should be done
                                                      frame by frame.
              .... ...1        MTRAZN_VCZDONE         Completed
      90  5A  Unsigned      1  MTRAZN_VCZFLAGS        Informational Flags
              1... ....        MTRAZN_VCZBASE         VCZBK for base zone of
                                                      DSRUnit
              .1.. ....        *
              ..1. ....        *
              ...1 ....        *
              .... 1...        *
              .... .1..        *
              .... ..1.        *
              .... ...1        *
      91  5B  Unsigned      1  MTRAZN_VCZPEERU        TS byte for use only during
                                                      halt
      92  5C  Character     8  MTRAZN_VCZSTRTS        Starting timestamp
     100  64  Unsigned      4  MTRAZN_VCZPASS         Cumulative count of completed
                                                      passes.
     104  68  Unsigned      4  MTRAZN_VCZMRCAB        Cardinal count ABsent
     108  6C  Unsigned      4  MTRAZN_VCZOFFLN        Cardinal count of frames
                                                      offline in zone
     112  70  Unsigned      4  MTRAZN_VCZDU2GO        Cardinal count of zones
                                                      not finished vacating in this
                                                      DSRUnit (only valid in VCZBK
                                                      with VCZBASE=1)
     116  74  Unsigned      4  MTRAZN_VCZPAGESMOVED   Cumulative count of pages
                                                      moved by HCPPTEFS
     120  78  Unsigned      4  MTRAZN_VCZPGSKPSER     Cumulative count of times a
                                                      page was skipped because
                                                      necessary serialization could
                                                      not be obtained.
     124  7C  Unsigned      4  MTRAZN_VCZPGSKPPIN     Cumulative count of times a
                                                      page was skipped because it
                                                      was locked/pinned
     128  80  Unsigned      4  MTRAZN_VCZPGSKPFRM     Cumulative count of times a
                                                      page was skipped and the
                                                      HCPVACAT thread was suspended
                                                      because no frame was
                                                      available to receive the pg
                                                      content
     132  84  Unsigned      4  MTRAZN_VCZLASTSKPS     Last pass during which a
                                                      FRMTE was skipped
     136  88  Character     0  MTRAZN_END

#### MRMTRAZN 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
    MTRAZN                     0     36+
    MTRAZN_AVLCID              0      8
    MTRAZN_AVLCONTIGS         30      8
    MTRAZN_AVLCONTSTK         40      8
    MTRAZN_AVLCREATETIME      28      8
    MTRAZN_AVLDUMMY           1B           04
    MTRAZN_AVLEMPTY           1C           02
    MTRAZN_AVLFLAG0           1A      1
    MTRAZN_AVLFLAG1           1B      1
    MTRAZN_AVLHIGH            10      8
    MTRAZN_AVLISA2G           1B           80
    MTRAZN_AVLISDSRBASE       1B           10
    MTRAZN_AVLISINIT1         1B           01
    MTRAZN_AVLISINIT2         1B           02
    MTRAZN_AVLISRECON         1B           20
    MTRAZN_AVLISSTATIC        1B           40
    MTRAZN_AVLLOW              8      8
    MTRAZN_AVLNOALLOC         1C      1
    MTRAZN_AVLRF              18      2
    MTRAZN_AVLR2PPENDING      1B           08
    MTRAZN_AVLSINGLES         38      8
    MTRAZN_AVLSINGSTK         48      8
    MTRAZN_AVLTACPT           50      4
    MTRAZN_AVLT2SPT           54      4
    MTRAZN_AVLVACATEFAILED    20      8
    MTRAZN_AVLVACATING        1C           80
    MTRAZN_AVLZNDATA           0    136
    MTRAZN_C                  23           80
    MTRAZN_CALENTDSP          1E      2
    MTRAZN_CALENTS            24      0
    MTRAZN_CALENTSZ           1C      2
    MTRAZN_END                88      0
    MTRAZN_ISANODE            1A           80
    MTRAZN_MRHDR               0      0
    MTRAZN_NUMZONES_RECORD    18      4
    MTRAZN_RSAMCHNG           14      4
    MTRAZN_TOTHELEFT          1A           40
    MTRAZN_VCZBASE            5A           80
    MTRAZN_VCZBK_FILLED       58           80
    MTRAZN_VCZBK_MEANINGFUL   58      1
    MTRAZN_VCZDMDCN           59           20
    MTRAZN_VCZDONE            59           01
    MTRAZN_VCZDSRCN           59           10
    MTRAZN_VCZDU2GO           70      4
    MTRAZN_VCZFLAGS           5A      1
    MTRAZN_VCZFRXFR           59           02
    MTRAZN_VCZLASTSKPS        84      4
    MTRAZN_VCZMRCAB           68      4
    MTRAZN_VCZOFFLN           6C      4
    MTRAZN_VCZPAGESMOVED      74      4
    MTRAZN_VCZPASS            64      4
    MTRAZN_VCZPEERU           5B      1
    MTRAZN_VCZPGSKPFRM        80      4
    MTRAZN_VCZPGSKPPIN        7C      4
    MTRAZN_VCZPGSKPSER        78      4
    MTRAZN_VCZRUNNG           59           80
    MTRAZN_VCZSTATF           59      1
    MTRAZN_VCZSTRTS           5C      8
    MTRAZN_VCZWAITN           59           40
    MTRAZN_VCZWINDO           59           08

    This information is
    based on z/VM V7R2.0.

    Last updated on 25 February 2021 at 15:34:07.

    Copyright IBM Corporation, 1990, 2021