|
Programming Interface Information:
The Monitor Records are intended Programming Interfaces that allow the customer to write programs to obtain services of z/VM. |
MRIODCAD
PrologControl Block Contents
Cross Reference
MRIODCAD Prolog
DSECT NAME - IODCAD
FUNCTION - Map a Monitor record.
LOCATED BY -
Through the Monitor Control Area
REFERENCED CONTROL BLOCKS -
MRRECHDR Monitor Record Header
NAME - MRIODCAD
DESCRIPTIVE NAME - Monitor Sample Record
Domain 6 - I/O Domain
Record 4 - Cache Activity Data
DESCRIPTION - Records cache activities. Generated for each device
that is attached to a caching control unit such as
a 3880 model 11, 13, 21, and 23, or a 3990 model 3.
Its purpose is to enable management of the paging
cache in the storage directors.
NOTES:
-- Data in IODCAD_CALDATA depends on the type of device being
monitored. The IODCAD_STATUS code indicates what kind of data
is in it.
-- For the 3880 Model 11, only the storage director that
owns the cache is recorded.
-- This record is not created for the secondary of a PPRC
pair.
-- This record is not created for PAV Alias devices
-- This record is not created for HyperPAV Alias devices
MRIODCAD Control Block Contents
Offsets
Dec Hex Type Len Name (Dim) Description
0 0 Structure 264 IODCAD
0 0 Character 0 IODCAD_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 4 IODCAD_RDEVSID host subchannel I.D. number
defined at initialization
24 18 Signed 4 IODCAD_STATUS code pertaining to contents
and mapping of the
IODCAD_CALDATA data area: -2
= No data because an I/O
request to obtain cache
information exceeded an
internal timer value and was
cancelled. -1 = No data
because the device is a
potential SIE ASSIST device.
0 = I/O Error in producing
the record. No data. 1 = data
from one storage director of
a 3880. Mapped by
IODCAD_CALDSSC. 2 = data from
both storage directors of a
3880. Mapped by
IODCAD_CALDSSC. 3 = data from
a 3990 model 3 or 6, a Shark,
a 9394, or a 9696 Mapped by
IODCAD_CALPSF.
28 1C Bitstring 40 IODCAD_CALSSS Subsystem status, as
returned by the SENSE
SUBSYSTEM STATUS command.
Layout and contents, which
depend on the device, are
described in the device's
hardware manuals. If the
device returns more than 40
bytes of subsystem status,
field IODCAD_CALSSS2 contains
the additional status
28 1C Character 6 * Defined in device hardware
manuals (see above).
34 22 Signed 2 IODCAD_PSFLEN Length (in bytes) of
performance statistics which
are stored in IODCAD_CALPSF
for this device. If this
field is zero, then the
performance statistics length
is 96 bytes.
36 24 Character 32 * Defined in device hardware
manuals (see above).
68 44 Character 192 IODCAD_CALDATA Data area. Contains status
and/or performance data. See
code in IODCAD_STATUS. Layout
and contents, which depend on
the device, are described in
the device's hardware
manuals.
260 104 Bitstring 4 IODCAD_CALSSS2 Additional subsystem status
as returned by the SENSE
SUBSYSTEM STATUS command.
Layout and contents, which
depend on the device, are
described in the device's
hardware manuals.
264 108 Character 0 IODCAD_END
IODCAD_CALDSSC Status and performance data collected from a 3880 control
unit. If IODCAD_STATUS = 1 data was collected only from the first
storage director. IODCAD_CALSSC2 will not apply. If IODCAD_STATUS = 2
data was collected from both storage directors.
Offsets
Dec Hex Type Len Name (Dim) Description
0 0 Structure 160 IODCAD_CALDSSC
0 0 Bitstring 80 IODCAD_CALSSC1 Subsystem performance data,
as returned by the SENSE
SUBSYSTEM COUNTS command for
the first storage director
80 50 Bitstring 80 IODCAD_CALSSC2 Subsystem performance data,
as returned by the SENSE
SUBSYSTEM COUNTS command for
the second storage director.
Applicable only when
IODCAD_STATUS = 2.
IODCAD_CALPSF Status and performance data collected from a 3990 model 3
or 6 a 9394 a 9696 or a Shark. Applicable only when IODCAD_STATUS = 3.
Offsets
Dec Hex Type Len Name (Dim) Description
0 0 Structure 192 *
0 0 Character 192 IODCAD_CALPSF Subsystem performance data,
as returned by the PERFORM
SUBSYSTEM FUNCTION, READ
SUBSYSTEM DATA (PERFORMANCE
STATISTICS) CCW chain
MRIODCAD Cross Reference
Hex Hex
Name Offset Length Value
IODCAD 0 264
IODCAD_CALDATA 44 192
IODCAD_CALDSSC 0 160
IODCAD_CALPSF 0 192
IODCAD_CALSSC1 0 80
IODCAD_CALSSC2 50 80
IODCAD_CALSSS 1C 40
IODCAD_CALSSS2 104 4
IODCAD_END 108 0
IODCAD_MRHDR 0 0
IODCAD_PSFLEN 22 2
IODCAD_RDEVSID 14 4
IODCAD_STATUS 18 4
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 V6R2.0.
Last updated on 23 Nov 2011 at 15:33:04.
Copyright IBM Corporation, 1990, 2011