Programming Interface Information:
The Monitor Records are intended Programming Interfaces that allow the customer to write programs to obtain services of z/VM. |
MRSTOAZN
PrologControl 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 V7R3.0.
Last updated on 09 September 2022 at 15:07:05.
Copyright IBM Corporation, 1990, 2022