About cookies on this site Our websites require some cookies to function properly (required). In addition, other cookies may be used with your consent to analyze site usage, improve the user experience and for advertising. For more information, please review your options. By visiting our website, you agree to our processing of information as described in IBM’sprivacy statement. To provide a smooth navigation, your cookie preferences will be shared across the IBM web domains listed here.
|
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