|
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 256 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.. MTRDEV_ENCRYCAP When on, device is encryption
capable.
.... ..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
..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.. *
.... ..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 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. *
.... ...1 *
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 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 256
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_EDEVATTR F1 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_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_EDEV1750 F1 08
MTRDEV_EDEV2105 F1 40
MTRDEV_EDEV2107 F1 10
MTRDEV_EDEV2145 F1 04
MTRDEV_ENCRYCAP 2B 04
MTRDEV_END 100 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_RDEVFREQ 46 08
MTRDEV_RDEVHPAL 46 10
MTRDEV_RDEVHPBA 46 20
MTRDEV_RDEVHPPL F2 2
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
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 V5R3.0.
Last updated on 12 Jun 2007 at 12:35:23.
Copyright IBM Corporation, 1990, 2007