|
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 240 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 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 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 240
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 F0 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 V5R1.0.
Last updated on 13 Sep 2004 at 11:25:22.
Copyright IBM Corporation, 1990, 2004