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 244 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 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 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 MTRDEV_EDEVTYPE EDEV emulation type 72 48 Character 8 MTRDEV_EDEVTABL SCSI Disk Attributes Table Name 80 50 Character 160 MTRDEV_EDEVPTHS 8 EDEV path triplets 80 50 Character 20 MTRDEV_EDEVPTH1 Path 1 80 50 Character 2 * Reserved for IBM use 82 52 Character 2 MTRDEV_EDEVFCP1 FCP device number 84 54 Character 8 MTRDEV_EDEVWPN1 World wide port number 92 5C Character 8 MTRDEV_EDEVLUN1 Logical unit number 100 64 Character 20 MTRDEV_EDEVPTH2 Path 2 100 64 Character 2 * Reserved for IBM use 102 66 Character 2 MTRDEV_EDEVFCP2 FCP device number 104 68 Character 8 MTRDEV_EDEVWPN2 World wide port number 112 70 Character 8 MTRDEV_EDEVLUN2 Logical unit number 120 78 Character 20 MTRDEV_EDEVPTH3 Path 3 120 78 Character 2 * Reserved for IBM use 122 7A Character 2 MTRDEV_EDEVFCP3 FCP device number 124 7C Character 8 MTRDEV_EDEVWPN3 World wide port number 132 84 Character 8 MTRDEV_EDEVLUN3 Logical unit number 140 8C Character 20 MTRDEV_EDEVPTH4 Path 4 140 8C Character 2 * Reserved for IBM use 142 8E Character 2 MTRDEV_EDEVFCP4 FCP device number 144 90 Character 8 MTRDEV_EDEVWPN4 World wide port number 152 98 Character 8 MTRDEV_EDEVLUN4 Logical unit number 160 A0 Character 20 MTRDEV_EDEVPTH5 Path 5 160 A0 Character 2 * Reserved for IBM use 162 A2 Character 2 MTRDEV_EDEVFCP5 FCP device number 164 A4 Character 8 MTRDEV_EDEVWPN5 World wide port number 172 AC Character 8 MTRDEV_EDEVLUN5 Logical unit number 180 B4 Character 20 MTRDEV_EDEVPTH6 Path 6 180 B4 Character 2 * Reserved for IBM use 182 B6 Character 2 MTRDEV_EDEVFCP6 FCP device number 184 B8 Character 8 MTRDEV_EDEVWPN6 World wide port number 192 C0 Character 8 MTRDEV_EDEVLUN6 Logical unit number 200 C8 Character 20 MTRDEV_EDEVPTH7 Path 7 200 C8 Character 2 * Reserved for IBM use 202 CA Character 2 MTRDEV_EDEVFCP7 FCP device number 204 CC Character 8 MTRDEV_EDEVWPN7 World wide port number 212 D4 Character 8 MTRDEV_EDEVLUN7 Logical unit number 220 DC Character 20 MTRDEV_EDEVPTH8 Path 8 220 DC Character 2 * Reserved for IBM use 222 DE Character 2 MTRDEV_EDEVFCP8 FCP device number 224 E0 Character 8 MTRDEV_EDEVWPN8 World wide port number 232 E8 Character 8 MTRDEV_EDEVLUN8 Logical unit number 240 F0 Bitstring 1 MTRDEV_PREFPATH Preferred path mask 241 F1 Character 3 * Reserved and available for IBM use. 244 F4 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 244 MTRDEV_CALFLAGS 2B 1 MTRDEV_CALMODLN 18 1 MTRDEV_CALRDEVDEV 44 2 MTRDEV_CALRDEVSID 40 4 MTRDEV_CALTHROT 2B 08 MTRDEV_EDEVFCP1 52 2 MTRDEV_EDEVFCP2 66 2 MTRDEV_EDEVFCP3 7A 2 MTRDEV_EDEVFCP4 8E 2 MTRDEV_EDEVFCP5 A2 2 MTRDEV_EDEVFCP6 B6 2 MTRDEV_EDEVFCP7 CA 2 MTRDEV_EDEVFCP8 DE 2 MTRDEV_EDEVLUN1 5C 8 MTRDEV_EDEVLUN2 70 8 MTRDEV_EDEVLUN3 84 8 MTRDEV_EDEVLUN4 98 8 MTRDEV_EDEVLUN5 AC 8 MTRDEV_EDEVLUN6 C0 8 MTRDEV_EDEVLUN7 D4 8 MTRDEV_EDEVLUN8 E8 8 MTRDEV_EDEVPTHS 50 160 MTRDEV_EDEVPTH1 50 20 MTRDEV_EDEVPTH2 64 20 MTRDEV_EDEVPTH3 78 20 MTRDEV_EDEVPTH4 8C 20 MTRDEV_EDEVPTH5 A0 20 MTRDEV_EDEVPTH6 B4 20 MTRDEV_EDEVPTH7 C8 20 MTRDEV_EDEVPTH8 DC 20 MTRDEV_EDEVTABL 48 8 MTRDEV_EDEVTYPE 47 1 MTRDEV_EDEVWPN1 54 8 MTRDEV_EDEVWPN2 68 8 MTRDEV_EDEVWPN3 7C 8 MTRDEV_EDEVWPN4 90 8 MTRDEV_EDEVWPN5 A4 8 MTRDEV_EDEVWPN6 B8 8 MTRDEV_EDEVWPN7 CC 8 MTRDEV_EDEVWPN8 E0 8 MTRDEV_END F4 0 MTRDEV_MRHDR 0 0 MTRDEV_PREFPATH F0 1 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 V5R2.0.
Last updated on 11 Dec 2005 at 20:54:24.
Copyright IBM Corporation, 1990, 2005