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

#### MRSTOAZN

Prolog
Control Block Contents
Cross Reference

#### MRSTOAZN Prolog

     DSECT NAME - STOAZN
     FUNCTION - Map a Monitor record.
     LOCATED BY -
            Through the Monitor control area
     REFERENCED CONTROL BLOCKS -
            MRRECHDR    Monitor Record Header
     NAME - MRSTOAZN
     DESCRIPTIVE NAME - Monitor Sample Record
                        Domain 3  - Storage Domain
                        Record 25 - Available Zone Information
     DESCRIPTION - AvlZn information, including information
                   for memory reclamations.

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

#### MRSTOAZN Control Block Contents

    Offsets
    Dec  Hex  Type        Len  Name (Dim)             Description

       0   0  Structure    36+ STOAZN                 Start of monitor record
       0   0  Character     0  STOAZN_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  STOAZN_RSAMCHNG        Cumulative count of memory
                                                      reconfigs that have taken
                                                      place on the system
      24  18  Unsigned      4  STOAZN_NUMZONES_RECORD Nbr of zones in record
      28  1C  Unsigned      2  STOAZN_CALENTSZ        The size (in bytes) of each
                                                      STOAZN_AvlZnData entry
      30  1E  Unsigned      2  STOAZN_CALENTDSP       The displacement (in bytes)
                                                      from the beginning of this
                                                      record to the first
                                                      STOAZN_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... ....        STOAZN_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  STOAZN_CALENTS         Start of the array for
                                                      AvlZns
    Start of the AvlZn's information

       0   0  Structure   136  STOAZN_AVLZNDATA
       0   0  Character     8  STOAZN_AVLCID          AvlZn ID
       8   8  Unsigned      8  STOAZN_AVLLOW          First FRMTE addr that
                                                      belongs.
      16  10  Unsigned      8  STOAZN_AVLHIGH         Last FRMTE addr that
                                                      belongs.
      24  18  Unsigned      2  STOAZN_AVLRF           Repetition factor.
      26  1A  Unsigned      1  STOAZN_AVLFLAG0        Flag, AvlZn description
              1... ....        STOAZN_ISANODE         Node
              .1.. ....        STOAZN_TOTHELEFT       Node or Zone, to the left
              ..1. ....        *
              ...1 ....        *
              .... 1...        *
              .... .1..        *
              .... ..1.        *
              .... ...1        *
      27  1B  Unsigned      1  STOAZN_AVLFLAG1        Flag, AvlZn description
              1... ....        STOAZN_AVLISA2G        Zone holds frames >2G
              .1.. ....        STOAZN_AVLISSTATIC     Is in HCPRSM, not Free
                                                      storage
              ..1. ....        STOAZN_AVLISRECON      AvlZn is a reconfigurable
                                                      zone
              ...1 ....        STOAZN_AVLISDSRBASE    First in group that makes
                                                      up one DSR unit. Only on for
                                                      zones with AvlIsRecon
              .... 1...        STOAZN_AVLR2PPENDING   Reconfig to Perm pending
              .... .1..        STOAZN_AVLDUMMY
              .... ..1.        STOAZN_AVLISINIT2      Zone is starting to init
              .... ...1        STOAZN_AVLISINIT1      Zone is initializing
      28  1C  Unsigned      1  STOAZN_AVLNOALLOC      Flag, do not allocate this
                                                      AvlZn
              1... ....        STOAZN_AVLVACATING     Zone is in process of being
                                                      vacated
              .1.. ....        *
              ..1. ....        *
              ...1 ....        *
              .... 1...        *
              .... .1..        *
              .... ..1.        STOAZN_AVLEMPTY
              .... ...1        *
      29  1D  Character     3  *                      Reserved for IBM use
      32  20  Unsigned      8  STOAZN_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  STOAZN_AVLCREATETIME   TOD clock at creation time.
      48  30  Unsigned      8  STOAZN_AVLCONTIGS      Cardinal count of AvlZn
                                                      Contigs
      56  38  Unsigned      8  STOAZN_AVLSINGLES      Cardinal count of AvlZn
                                                      Singles
      64  40  Unsigned      8  STOAZN_AVLCONTSTK      Cardinal count of return
                                                      stack Contigs
      72  48  Unsigned      8  STOAZN_AVLSINGSTK      Cardinal count of return
                                                      stack Singles
      80  50  Unsigned      4  STOAZN_AVLTACPT        Prorated TACPT
      84  54  Unsigned      4  STOAZN_AVLT2SPT        Prorated T2SPT
    VCZBK information

      88  58  Unsigned      1  STOAZN_VCZBK_MEANINGFUL Flag field
              1... ....        STOAZN_VCZBK_FILLED    VCZBK fields are filled in
              .1.. ....        *
              ..1. ....        *
              ...1 ....        *
              .... 1...        *
              .... .1..        *
              .... ..1.        *
              .... ...1        *
      89  59  Unsigned      1  STOAZN_VCZSTATF        Status Flags
              1... ....        STOAZN_VCZRUNNG        Stacked/running
              .1.. ....        STOAZN_VCZWAITN        Waiting
              ..1. ....        STOAZN_VCZDMDCN        Reclamation cnclld/halted
              ...1 ....        STOAZN_VCZDSRCN        DSRUnit cancelled
              .... 1...        STOAZN_VCZWINDO        In a DSBOW open window
              .... .1..        *
              .... ..1.        STOAZN_VCZFRXFR        Next pass should be done
                                                      frame by frame.
              .... ...1        STOAZN_VCZDONE         Completed
      90  5A  Unsigned      1  STOAZN_VCZFLAGS        Informational Flags
              1... ....        STOAZN_VCZBASE         VCZBK for base zone of
                                                      DSRUnit
              .1.. ....        *
              ..1. ....        *
              ...1 ....        *
              .... 1...        *
              .... .1..        *
              .... ..1.        *
              .... ...1        *
      91  5B  Unsigned      1  STOAZN_VCZPEERU        TS byte for use only during
                                                      halt
      92  5C  Character     8  STOAZN_VCZSTRTS        Starting timestamp
     100  64  Unsigned      4  STOAZN_VCZPASS         Cumulative count of completed
                                                      passes.
     104  68  Unsigned      4  STOAZN_VCZMRCAB        Cardinal count Absent
     108  6C  Unsigned      4  STOAZN_VCZOFFLN        Cardinal count of frames
                                                      offline in zone
     112  70  Unsigned      4  STOAZN_VCZDU2GO        Cardinal count of zones not
                                                      finished vacating in this
                                                      DSRUnit (only valid in VCZBK
                                                      with VCZBASE=1)
     116  74  Unsigned      4  STOAZN_VCZPAGESMOVED   Cumulative count of pages
                                                      moved by HCPPTEFS
     120  78  Unsigned      4  STOAZN_VCZPGSKPSER     Cumulative count of times a
                                                      page was skipped because
                                                      necessary serialization could
                                                      not be obtained.
     124  7C  Unsigned      4  STOAZN_VCZPGSKPPIN     Cumulative count of times a
                                                      page was skipped because it
                                                      was locked/pinned
     128  80  Unsigned      4  STOAZN_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  STOAZN_VCZLASTSKPS     Last pass during which a
                                                      FRMTE was skipped

#### MRSTOAZN 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
    STOAZN                     0     36+
    STOAZN_AVLCID              0      8
    STOAZN_AVLCONTIGS         30      8
    STOAZN_AVLCONTSTK         40      8
    STOAZN_AVLCREATETIME      28      8
    STOAZN_AVLDUMMY           1B           04
    STOAZN_AVLEMPTY           1C           02
    STOAZN_AVLFLAG0           1A      1
    STOAZN_AVLFLAG1           1B      1
    STOAZN_AVLHIGH            10      8
    STOAZN_AVLISA2G           1B           80
    STOAZN_AVLISDSRBASE       1B           10
    STOAZN_AVLISINIT1         1B           01
    STOAZN_AVLISINIT2         1B           02
    STOAZN_AVLISRECON         1B           20
    STOAZN_AVLISSTATIC        1B           40
    STOAZN_AVLLOW              8      8
    STOAZN_AVLNOALLOC         1C      1
    STOAZN_AVLRF              18      2
    STOAZN_AVLR2PPENDING      1B           08
    STOAZN_AVLSINGLES         38      8
    STOAZN_AVLSINGSTK         48      8
    STOAZN_AVLTACPT           50      4
    STOAZN_AVLT2SPT           54      4
    STOAZN_AVLVACATEFAILED    20      8
    STOAZN_AVLVACATING        1C           80
    STOAZN_AVLZNDATA           0    136
    STOAZN_C                  23           80
    STOAZN_CALENTDSP          1E      2
    STOAZN_CALENTS            24      0
    STOAZN_CALENTSZ           1C      2
    STOAZN_ISANODE            1A           80
    STOAZN_MRHDR               0      0
    STOAZN_NUMZONES_RECORD    18      4
    STOAZN_RSAMCHNG           14      4
    STOAZN_TOTHELEFT          1A           40
    STOAZN_VCZBASE            5A           80
    STOAZN_VCZBK_FILLED       58           80
    STOAZN_VCZBK_MEANINGFUL   58      1
    STOAZN_VCZDMDCN           59           20
    STOAZN_VCZDONE            59           01
    STOAZN_VCZDSRCN           59           10
    STOAZN_VCZDU2GO           70      4
    STOAZN_VCZFLAGS           5A      1
    STOAZN_VCZFRXFR           59           02
    STOAZN_VCZLASTSKPS        84      4
    STOAZN_VCZMRCAB           68      4
    STOAZN_VCZOFFLN           6C      4
    STOAZN_VCZPAGESMOVED      74      4
    STOAZN_VCZPASS            64      4
    STOAZN_VCZPEERU           5B      1
    STOAZN_VCZPGSKPFRM        80      4
    STOAZN_VCZPGSKPPIN        7C      4
    STOAZN_VCZPGSKPSER        78      4
    STOAZN_VCZRUNNG           59           80
    STOAZN_VCZSTATF           59      1
    STOAZN_VCZSTRTS           5C      8
    STOAZN_VCZWAITN           59           40
    STOAZN_VCZWINDO           59           08

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

    Last updated on 26 February 2021 at 15:23:07.

    Copyright IBM Corporation, 1990, 2021