|
Programming Interface Information:
The Monitor Records are intended Programming Interfaces that allow the customer to write programs to obtain services of z/VM. |
MRIODSTC
PrologControl Block Contents
Cross Reference
MRIODSTC Prolog
DSECT NAME - IODSTC
FUNCTION - Map a Monitor record.
LOCATED BY -
Through the Monitor Control Area
REFERENCED CONTROL BLOCKS -
MRRECHDR Monitor Record Header
NAME - MRIODSTC
DESCRIPTIVE NAME - Monitor Event Record
Domain 6 - I/O Domain
Record 20 - State Change
DESCRIPTION - Indicates that a real device has generated a state
change.
NOTES -
Codes defined for IODSTC_CALCODE:
IODSTC_CALCODE_00: '00'X Reserved
IODSTC_CALCODE_BS: '01'X Result of a PSF order X'1F' -
manage alias
IODSTC_CALCODE_1E: '02'X Result of a x'1E' -
PAC state change unit check
MRIODSTC Control Block Contents
Offsets
Dec Hex Type Len Name (Dim) Description
0 0 Structure 68 IODSTC Start of monitor record
0 0 Character 0 IODSTC_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 Unsigned 1 IODSTC_CALCODE State change type code See
defined code values above
21 15 Bitstring 1 * Reserved and available for
IBM use
22 16 Unsigned 2 * Reserved and available for
IBM use
24 18 Bitstring 1 IODSTC_RDEVTYPE Device type code. Unique for
each device within the class in
IODSTC_RDEVCLAS.
25 19 Bitstring 1 IODSTC_RDEVCLAS Device class code. Unique for
each class.
26 1A Unsigned 2 IODSTC_RDEVDVID Device type number in packed
decimal. See IODSTC_RDEVDVIV
for its source.
28 1C Bitstring 1 IODSTC_CALMODLN Device model identifier. See
IODSTC_RDEVDVIV flag for its
source.
29 1D Bitstring 1 IODSTC_RDEVLPM Logical path mask
30 1E Unsigned 2 IODSTC_RDEVDEV Device number in packed
decimal
32 20 Unsigned 4 IODSTC_RDEVSID Host subchannel id
36 24 Character 8 IODSTC_RDEVCHPS Eight channel path ids for
this device
44 2C Unsigned 2 IODSTC_RDEVCUID control unit id in packed
decimal. Applicable only when
IODSTC_RDEVCUIV = on.
46 2E Unsigned 1 IODSTC_RDEVCUMN Control unit model
identifier. Applicable only
when IODSTC_RDEVCUIV = on.
47 2F Bitstring 1 IODSTC_CALFLAGS Flag Byte
1... .... IODSTC_RDEVDVIV OFF = device model number (in
IODSTC_RDEVDVID) and model
identifier (in IODSTC_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.. .... IODSTC_RDEVCUIV When on, Control unit
information is supplied in
IODSTC_RDEVCUID and
IODSTC_RDEVCUMN.
..1. .... *
...1 .... *
.... 1... *
.... .1.. *
.... ..1. *
.... ...1 *
48 30 Character 6 IODSTC_RDEVSER DASD volume serial identifier
54 36 Unsigned 2 * Reserved and available for
IBM use
56 38 Unsigned 4 IODSTC_CALRDEVSID Host subchannel id for the
new base
60 3C Unsigned 2 IODSTC_CALRDEVDEV Device number for the new
base in packed decimal
62 3E Bitstring 1 IODSTC_RDEVPVFG PAV flag to indicate base and
alias DASD
1... .... IODSTC_RDEVPVBA PAV base indicator
.1.. .... IODSTC_RDEVPVAL PAV alias indicator
..1. .... IODSTC_RDEVHPBA HyperPAV Base
...1 .... IODSTC_RDEVHPAL HyperPAV Alias The above
fields are mutually exclusive
.... 1... IODSTC_RDEVFREQ HyperPAV Alias is on the free
queue
.... .1.. *
.... ..1. *
.... ...1 *
63 3F Bitstring 1 * Reserved and available for
IBM use
64 40 Unsigned 2 IODSTC_RDEVHPPL HyperPAV Pool Number Note:
This value is only meaningful
if the IODSTC_RDEVHPBA or
IODSTC_RDEVHPAL flag is set
66 42 Unsigned 2 * Reserved and available for
IBM use.
68 44 Character 0 IODSTC_END
MRIODSTC Cross Reference
Hex Hex
Name Offset Length Value
IODSTC 0 68
IODSTC_CALCODE 14 1
IODSTC_CALFLAGS 2F 1
IODSTC_CALMODLN 1C 1
IODSTC_CALRDEVDEV 3C 2
IODSTC_CALRDEVSID 38 4
IODSTC_END 44 0
IODSTC_MRHDR 0 0
IODSTC_RDEVCHPS 24 8
IODSTC_RDEVCLAS 19 1
IODSTC_RDEVCUID 2C 2
IODSTC_RDEVCUIV 2F 40
IODSTC_RDEVCUMN 2E 1
IODSTC_RDEVDEV 1E 2
IODSTC_RDEVDVID 1A 2
IODSTC_RDEVDVIV 2F 80
IODSTC_RDEVFREQ 3E 08
IODSTC_RDEVHPAL 3E 10
IODSTC_RDEVHPBA 3E 20
IODSTC_RDEVHPPL 40 2
IODSTC_RDEVLPM 1D 1
IODSTC_RDEVPVAL 3E 40
IODSTC_RDEVPVBA 3E 80
IODSTC_RDEVPVFG 3E 1
IODSTC_RDEVSER 30 6
IODSTC_RDEVSID 20 4
IODSTC_RDEVTYPE 18 1
MRHDR 0 20
MRHDR_END 14 0
MRHDRDM 4 1
MRHDRLEN 0 2
MRHDRRC 6 2
MRHDRTOD 8 8
MRHDRZER 2 2
This information is
based on z/VM V6R1.0.
Last updated on 8 Oct 2009 at 21:08:13.
Copyright IBM Corporation, 1990, 2009