Programming Interface Information:
The Monitor Records are intended Programming Interfaces that allow the customer to write programs to obtain services of z/VM. |
MRMTRDEV
PrologControl Block Contents
Cross Reference
MRMTRDEV Prolog
DSECT NAME - MTRDEV FUNCTION - Map a Monitor record. LOCATED BY - Through the Monitor Control Area Deleted By - HCPMNNRF Free the DCSS When All Records Are Processed REFERENCED CONTROL BLOCKS - MRRECHDR Monitor Record Header NAME - MRMTRDEV DESCRIPTIVE NAME - Monitor Sample Configuration Record Domain 1 - Monitor Domain Record 6 - Device Configuration Data DESCRIPTION - Describes the configuration of a real device. A separate record is generated for each real device defined to the system. NOTES: - If the device is offline (see MTRDEV_RDEVOFFL), only the following fields will be valid: MTRDEV_MRHDR MTRDEV_RDEVTYPE MTRDEV_RDEVCLAS MTRDEV_RDEVDEV MTRDEV_RDEVSHAR MTRDEV_RDEVSER
MRMTRDEV Control Block Contents
Offsets Dec Hex Type Len Name (Dim) Description 0 0 Structure 72 MTRDEV Start of monitor record 0 0 Character 0 MTRDEV_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 Bitstring 1 MTRDEV_RDEVTYPE Device type code. Unique for each device within the class in MTRDEV_RDEVCLAS. 21 15 Bitstring 1 MTRDEV_RDEVCLAS Device class code. Unique for each class. 22 16 Unsigned 2 MTRDEV_RDEVDVID Device type number in packed decimal. See MTRDEV_RDEVDVIV for its source. 24 18 Unsigned 1 MTRDEV_CALMODLN Device model identifier. See MTRDEV_RDEVDVIV flag for its source. 25 19 Bitstring 1 MTRDEV_RDEVLPM Logical path mask 26 1A Unsigned 2 MTRDEV_RDEVDEV Device number in packed decimal 28 1C Unsigned 4 MTRDEV_RDEVSID Host subchannel id 32 20 Character 8 MTRDEV_RDEVCHPS Eight channel path ids for this device 40 28 Unsigned 2 MTRDEV_RDEVCUID control unit id in packed decimal. Applicable only when MTRDEV_RDEVCUIV = on. 42 2A Unsigned 1 MTRDEV_RDEVCUMN Control unit model identifier. Applicable only when MTRDEV_RDEVCUIV = on. 43 2B Bitstring 1 MTRDEV_CALFLAGS Flag Byte 1... .... MTRDEV_RDEVDVIV OFF = device model number (in MTRDEV_RDEVDVID) and model identifier (in MTRDEV_CALMODLN) were provided by user through the RDEVICE macro or device sensing at IPL time. ON = device type number and model identifier were provided by the device at device initialization time. .1.. .... MTRDEV_RDEVCUIV When on, control unit information is supplied in MTRDEV_RDEVCUID and MTRDEV_RDEVCUMN. ..1. .... MTRDEV_RDEVOFFL OFF = Device is online. ON = Device is offline. ...1 .... MTRDEV_RDEVSHAR OFF = This is a CP-owned CPVOL. ON = This is a shared CPVOL. Applicable only if this record represents a CPVOL device (see MTRDEV_RDEVCLAS and/or MTRDEV_RDEVDVID). .... 1... MTRDEV_CALTHROT OFF = Device is not throttled ON = Device is throttled .... .1.. * .... ..1. * .... ...1 * 44 2C Character 1 MTRDEV_RDCRCUC Real CU Code 45 2D Character 1 MTRDEV_RDCOBRCO OBR Code 46 2E Character 6 MTRDEV_RDEVSER DASD volume serial identifier 52 34 Unsigned 4 MTRDEV_THRDLYS Cummulative count of the number of times I/O was delayed for a throttled device. 56 38 Character 8 MTRDEV_THRIORTE I/O rate expressed as the TOD clock increment between I/O operations. 64 40 Unsigned 4 MTRDEV_CALRDEVSID Host subchannel id of the base PAV when RDEVPVAL is on, zero otherwise 68 44 Unsigned 2 MTRDEV_CALRDEVDEV Device number of the base PAV when RDEVPVAL is on, zero otherwise 70 46 Bitstring 1 MTRDEV_RDEVPVFG PAV flag to indicate base and alias DASD 1... .... MTRDEV_RDEVPVBA PAV base indicator .1.. .... MTRDEV_RDEVPVAL PAV alias indicator Bases and aliases are mutually exclusive ..1. .... * ...1 .... * .... 1... * .... .1.. * .... ..1. * .... ...1 * 71 47 Bitstring 1 * Reserved and available for IBM use 72 48 Character 0 MTRDEV_END
MRMTRDEV 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 MTRDEV 0 72 MTRDEV_CALFLAGS 2B 1 MTRDEV_CALMODLN 18 1 MTRDEV_CALRDEVDEV 44 2 MTRDEV_CALRDEVSID 40 4 MTRDEV_CALTHROT 2B 08 MTRDEV_END 48 0 MTRDEV_MRHDR 0 0 MTRDEV_RDCOBRCO 2D 1 MTRDEV_RDCRCUC 2C 1 MTRDEV_RDEVCHPS 20 8 MTRDEV_RDEVCLAS 15 1 MTRDEV_RDEVCUID 28 2 MTRDEV_RDEVCUIV 2B 40 MTRDEV_RDEVCUMN 2A 1 MTRDEV_RDEVDEV 1A 2 MTRDEV_RDEVDVID 16 2 MTRDEV_RDEVDVIV 2B 80 MTRDEV_RDEVLPM 19 1 MTRDEV_RDEVOFFL 2B 20 MTRDEV_RDEVPVAL 46 40 MTRDEV_RDEVPVBA 46 80 MTRDEV_RDEVPVFG 46 1 MTRDEV_RDEVSER 2E 6 MTRDEV_RDEVSHAR 2B 10 MTRDEV_RDEVSID 1C 4 MTRDEV_RDEVTYPE 14 1 MTRDEV_THRDLYS 34 4 MTRDEV_THRIORTE 38 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