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 320 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 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.. MTRDEV_ENCRYCAP When on, device is encryption capable. .... ..1. MTRDEV_EQIEQHSH When on, user-specified EQID information supplied in MTRDEV_EQIEQID .... ...1 MTRDEV_EQIDUHSH When on, system-generated EQID information supplied in MTRDEV_EQIDUID 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 Cumulative 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 ..1. .... MTRDEV_RDEVHPBA HyperPAV Base ...1 .... MTRDEV_RDEVHPAL HyperPAV Alias The above fields are mutually exclusive .... 1... MTRDEV_RDEVFREQ HyperPAV Alias is on the free queue .... .1.. MTRDEV_RDEVESE Extent Space Efficient .... ..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 1 * Reserved for IBM use 81 51 Character 1 MTRDEV_EDEVCHP1 Channel Path ID 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 1 * Reserved for IBM use 101 65 Character 1 MTRDEV_EDEVCHP2 Channel Path ID 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 1 * Reserved for IBM use 121 79 Character 1 MTRDEV_EDEVCHP3 Channel Path ID 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 1 * Reserved for IBM use 141 8D Character 1 MTRDEV_EDEVCHP4 Channel Path ID 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 1 * Reserved for IBM use 161 A1 Character 1 MTRDEV_EDEVCHP5 Channel Path ID 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 1 * Reserved for IBM use 181 B5 Character 1 MTRDEV_EDEVCHP6 Channel Path ID 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 1 * Reserved for IBM use 201 C9 Character 1 MTRDEV_EDEVCHP7 Channel Path ID 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 1 * Reserved for IBM use 221 DD Character 1 MTRDEV_EDEVCHP8 Channel Path ID 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 Bitstring 1 MTRDEV_EDEVATTR EDEV attributes 1... .... MTRDEV_EDEVSCSI General SCSI Attribute .1.. .... MTRDEV_EDEV2105 2105 SCSI Attributes ..1. .... MTRDEV_EDEVFASD Fibre array storage driver ...1 .... MTRDEV_EDEV2107 2107 SCSI Attributes .... 1... MTRDEV_EDEV1750 1750 SCSI Attributes .... .1.. MTRDEV_EDEV2145 2145 SCSI Attributes .... ..1. MTRDEV_EDEVXIV XIV SCSI Attributes .... ...1 MTRDEV_EDEVFLSH FLASH SCSI Attributes 242 F2 Unsigned 2 MTRDEV_RDEVHPPL HyperPAV Pool Number Note: This value is only meaningful if the MTRDEV_RDEVHPBA or MTRDEV_RDEVHPAL flag is set 244 F4 Character 4 MTRDEV_CALDEVFLAGS ----------------------------- ---------------------- Only if MTRDEV_EDEVFASD then these bits are valid: ----------------------------- ---------------------- 244 F4 Bitstring 1 * 1... .... * .1.. .... * ..1. .... * ...1 .... * .... 1... * .... .1.. SZQFCWOB FASD -cache without batteries .... ..1. SZQFFWT FASD -force write thru on two minute warning from ups .... ...1 SZQFCME FASD -cache mirror enable 245 F5 Bitstring 1 * 1... .... SZQFABPR FASD -alt ctrl batteries present .1.. .... SZQFBPR FASD -batteries present ..1. .... SZQFACMA FASD -alt ctrl cache mirror active ...1 .... SZQFCMA FASD -ctrl cache mirror active .... 1... SZQFABOK FASD -alt ctrl batteries ok .... .1.. SZQFBOK FASD -ctrl batteries ok .... ..1. SZQFRCA FASD -read cache active .... ...1 SZQFWCA FASD -write cache active 246 F6 Character 2 * Reserved and available EDEVICE path connection types 0=not connected/unknown 1=point to point 2=switched 3=arbitrated loop 248 F8 Unsigned 1 MTRDEV_EDEVPATHCONN1 249 F9 Unsigned 1 MTRDEV_EDEVPATHCONN2 250 FA Unsigned 1 MTRDEV_EDEVPATHCONN3 251 FB Unsigned 1 MTRDEV_EDEVPATHCONN4 252 FC Unsigned 1 MTRDEV_EDEVPATHCONN5 253 FD Unsigned 1 MTRDEV_EDEVPATHCONN6 254 FE Unsigned 1 MTRDEV_EDEVPATHCONN7 255 FF Unsigned 1 MTRDEV_EDEVPATHCONN8 256 100 Character 1 MTRDEV_RDCEXFC Device extended features 1... .... * .1.. .... MTRDEV_RDCXRC Device supports XRC ..1. .... MTRDEV_RDCPPRC Device supports PPRC CCWs ...1 .... * .... 1... * .... .1.. * .... ..1. * .... ...1 * 257 101 Character 3 * Reserved and available for future IBM use 260 104 Character 40 MTRDEV_EQIDUID System-generated EQID 300 12C Character 8 MTRDEV_EQIEQID User-specified EQID 308 134 Bitstring 1 MTRDEV_DEVCHAR Device Characteristics 1... .... MTRDEV_DEVCHAR_DED Encrypted Device .1.. .... MTRDEV_DEVCHAR_SSD Solid-State Drive ..1. .... * ...1 .... * .... 1... * .... .1.. * .... ..1. * .... ...1 * 309 135 Character 1 * Reserved and available for future IBM use 310 136 Unsigned 2 MTRDEV_CUIDSSID If the device is a DASD this field contains the subsystem ID (SSID). If the device is a non-DASD this field contains binary zeroes. 312 138 Unsigned 4 MTRDEV_RDEVMEXT Maximum cylinder/block 316 13C Character 4 * Reserved for future use 320 140 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 320 MTRDEV_CALDEVFLAGS F4 4 MTRDEV_CALFLAGS 2B 1 MTRDEV_CALMODLN 18 1 MTRDEV_CALRDEVDEV 44 2 MTRDEV_CALRDEVSID 40 4 MTRDEV_CALTHROT 2B 08 MTRDEV_CUIDSSID 136 2 MTRDEV_DEVCHAR 134 1 MTRDEV_DEVCHAR_DED 134 80 MTRDEV_DEVCHAR_SSD 134 40 MTRDEV_EDEVATTR F1 1 MTRDEV_EDEVCHP1 51 1 MTRDEV_EDEVCHP2 65 1 MTRDEV_EDEVCHP3 79 1 MTRDEV_EDEVCHP4 8D 1 MTRDEV_EDEVCHP5 A1 1 MTRDEV_EDEVCHP6 B5 1 MTRDEV_EDEVCHP7 C9 1 MTRDEV_EDEVCHP8 DD 1 MTRDEV_EDEVFASD F1 20 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_EDEVFLSH F1 01 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_EDEVPATHCONN1 F8 1 MTRDEV_EDEVPATHCONN2 F9 1 MTRDEV_EDEVPATHCONN3 FA 1 MTRDEV_EDEVPATHCONN4 FB 1 MTRDEV_EDEVPATHCONN5 FC 1 MTRDEV_EDEVPATHCONN6 FD 1 MTRDEV_EDEVPATHCONN7 FE 1 MTRDEV_EDEVPATHCONN8 FF 1 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_EDEVSCSI F1 80 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_EDEVXIV F1 02 MTRDEV_EDEV1750 F1 08 MTRDEV_EDEV2105 F1 40 MTRDEV_EDEV2107 F1 10 MTRDEV_EDEV2145 F1 04 MTRDEV_ENCRYCAP 2B 04 MTRDEV_END 140 0 MTRDEV_EQIDUHSH 2B 01 MTRDEV_EQIDUID 104 40 MTRDEV_EQIEQHSH 2B 02 MTRDEV_EQIEQID 12C 8 MTRDEV_MRHDR 0 0 MTRDEV_PREFPATH F0 1 MTRDEV_RDCEXFC 100 1 MTRDEV_RDCOBRCO 2D 1 MTRDEV_RDCPPRC 100 20 MTRDEV_RDCRCUC 2C 1 MTRDEV_RDCXRC 100 40 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_RDEVESE 46 04 MTRDEV_RDEVFREQ 46 08 MTRDEV_RDEVHPAL 46 10 MTRDEV_RDEVHPBA 46 20 MTRDEV_RDEVHPPL F2 2 MTRDEV_RDEVLPM 19 1 MTRDEV_RDEVMEXT 138 4 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 SZQFABOK F4 08 SZQFABPR F4 80 SZQFACMA F4 20 SZQFBOK F4 04 SZQFBPR F4 40 SZQFCMA F4 10 SZQFCME F4 01 SZQFCWOB F4 04 SZQFFWT F4 02 SZQFRCA F4 02 SZQFWCA F4 01
This information is based on z/VM V6R4.0.
Last updated on 23 May 2018 at 14:40:21.
Copyright IBM Corporation, 1990, 2018