|
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 72 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 * Reserved and available for IBM
use
72 48 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 72
MTRDEV_CALFLAGS 2B 1
MTRDEV_CALMODLN 18 1
MTRDEV_CALRDEVDEV 44 2
MTRDEV_CALRDEVSID 40 4
MTRDEV_CALTHROT 2B 08
MTRDEV_END 48 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 V4R4.0.
Last updated on 22 Jul 2003 at 15:04:23.
Copyright IBM Corporation, 1990, 2003