Programming Interface Information:
The Monitor Records are intended Programming Interfaces that allow the customer to write programs to obtain services of z/VM. |
MRMTRAZN
PrologControl 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