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
Storage Layout
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
..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 V4R2.0.
Last updated on 15 Oct 2001 at 08:04:23.
Copyright IBM Corporation, 1990, 2001
