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, userids, or identifiers of domain specific subsets 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 Contents
Offsets 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 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 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'05' = processor 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. x'00' = all items are not being monitored. Note: This flag does not indicate the status of PCIF class. The status of PCIF class is indicated by MTRDDR_PCIST. 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.. .... MTRDDR_PCIST OFF = PCIF class is disabled. Note that this bit is only valid for EVENT IO and SAMPLE IO. Since a user can only enable PCIF class for those two domains. ON = PCIF class is enabled. Note that this bit is only valid for EVENT IO and SAMPLE IO. Since a user can only enable PCIF class for those two domains. ..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, 8-char identifier for processor domain. See codes in MTRDDR_DMNUMBER and MTRDDR_DMSTATUS.
MRMTRDDR 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 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_PCIST 17 40 MTRDDR_PROFILE 14 1 MTRDDR_REQUIRED 14 8
This information is based on z/VM V6R4.0.
Last updated on 4 Oct 2016 at 15:04:23.
Copyright IBM Corporation, 1990, 2016