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

Last updated on 09 September 2022 at 15:08:05.
Copyright IBM Corporation, 1990, 2022