Programming Interface Information:
The Monitor Records are intended Programming Interfaces that
allow the customer to write programs to obtain services of z/VM.
Control Block Contents
DSECT NAME - MTRDDR FUNCTION - Map a Monitor record. LOCATED BY - Through the Monitor Control Area REFERENCED CONTROL BLOCKS - MRRECHDR Monitor Record Header NAME - MRMTRDDR DESCRIPTIVE NAME - Monitor Event and Sample Configuration Record Domain 1 - Monitor Domain Record 14 - Domain Detail DESCRIPTION - A list of devices or userids that are enabled for monitoring. A separate record is generated for each applicable event or sample domain. NOTES: -- The list of items (MTRDDR_DMITEMS) may be spanned across more than one MRMTRDDR record. The flag, MTRDDR_CONT, indicates whether the list is continued in the next MRMTRDDR record. The record itself will not be spanned across a frame boundary. When the spanning of the list becomes necessary, this record will be followed by an End-of-Frame record (MRMTREOF, Domain 1, Record 13), and the list will be continued in another MRMTRDDR record in the next frame.
MRMTRDDR Control Block ContentsOffsets Dec Hex Type Len Name (Dim) Description 0 0 Structure 28 MTRDDR Start of monitor record 0 0 Character 0 MTRDDR_MRHDR Record header. See MRRECHDR for details. 0 0 Character 20 MRHDR 0 0 Unsigned 2 MRHDRLEN record length in bytes 2 2 Unsigned 2 MRHDRZER field of zeros 4 4 Unsigned 1 MRHDRDM domain identifier 5 5 Unsigned 1 * 6 6 Unsigned 2 MRHDRRC record identifier 8 8 Character 8 MRHDRTOD Time at which this record was built. In time-of-day (TOD) clock format. See IBM System 370 XA Principle of Operation for explanation of format. 16 10 Character 4 * 20 14 Character 0 MRHDR_END End of header 20 14 Character 8 MTRDDR_REQUIRED 20 14 Character 1 MTRDDR_PROFILE Monitor Profile code for this record: 'E' = event record. 'S' = sample record. 21 15 Unsigned 1 MTRDDR_DMNUMBER Code indicating the domain for this record. x'02' = scheduler domain. x'04' = user domain. x'06' = I/O domain. x'07' = seek domain. x'0A' = appldata domain. 22 16 Bitstring 1 MTRDDR_DMSTATUS Code pertaining to the contents of MTRDDR_DMITEMS table, indicating which items of the domain are being (or not being) monitored: x'80' = all items of the domain are being monitored. x'40' = all items in the table --- and only those so listed---are being monitored. x'20' = all items EXCEPT those listed in the table are being monitored. 23 17 Bitstring 1 MTRDDR_CALFLAGS Flag byte 1... .... MTRDDR_CONT OFF = This is the last or only record of this set of MRMTRDDR records pertaining to the list of items for this domain and the event or sample profile. ON = The list of items (in MTRDDR_DMITEMS), continues in the next MRMTRDDR record. .1.. .... * ..1. .... * ...1 .... * .... 1... * .... .1.. * .... ..1. * .... ...1 * 24 18 Signed 4 MTRDDR_DMITEMCT Number of items in the MTRDDR_DMITEMS table in this record. Zero if MTRDDR_DMSTATUS = x'80'. If the list is spanned across more than one record (see MTRDDR_CONT), add up all the MTRDDR_DMITEMCTs of this set to get the total count of the items. 28 1C Character 0 MTRDDR_DMITEMS Table of items of the domain, 8-char userids for user domain, scheduler domain, or appldata domain, 2-byte hex device numbers for I/O or seek domain. See codes in MTRDDR_DMNUMBER and MTRDDR_DMSTATUS.
MRMTRDDR Cross ReferenceHex 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 MTRDDR 0 28 MTRDDR_CALFLAGS 17 1 MTRDDR_CONT 17 80 MTRDDR_DMITEMCT 18 4 MTRDDR_DMITEMS 1C 0 MTRDDR_DMNUMBER 15 1 MTRDDR_DMSTATUS 16 1 MTRDDR_MRHDR 0 0 MTRDDR_PROFILE 14 1 MTRDDR_REQUIRED 14 8
This information is based on z/VM V4R4.0.
Last updated on 22 Jul 2003 at 15:04:23.
Copyright IBM Corporation, 1990, 2003