|
Programming Interface Information:
The Monitor Records are intended Programming Interfaces that allow the customer to write programs to obtain services of z/VM. |
MRIODSZI
PrologControl Block Contents
Cross Reference
MRIODSZI Prolog
DSECT NAME - IODSZI
FUNCTION - Map a Monitor record.
LOCATED BY -
Through the Monitor Control Area
REFERENCED CONTROL BLOCKS -
MRRECHDR Monitor Record Header
NAME - MRIODSZI
DESCRIPTIVE NAME - Monitor Sample Record
Domain 6 - I/O Domain
Record 24 - SCSI Device Activity
DESCRIPTION - Describes I/O activities of an emulated device.
A separate record is generated for each online device
enabled for monitoring.
NOTES:
If IODSZI_PTHEXTVER = 1 then PCM Path Statistics are available.
- See IODSZI_PTHEXTSZ for the size of the data for each path,
IODSZI_PTHEXTCT for the number of paths, and IODSZI_PTHEXTOF
for the offest to the beginning of the PCM Path Statistics.
The Path Transfers (IODSZI_PTH1XFERS to IODSZI_PTH8XFERS) sum
may be greater than the Disk Transfers (IODSZI_DSKXFERS) for
the following reasons:
(1) Retrying I/O will increment the path transfers count for
the specified path, but not the disk transfers count.
(2) Sending IOCTL commands does not cause a disk transfer, but
the path transfers count is still incremented, as a path
is used to send the IOCTL command.
MRIODSZI Control Block Contents
Offsets Dec Hex Type Len Name (Dim) Description 0 0 Structure 396+ IODSZI 0 0 Character 0 IODSZI_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 2 IODSZI_RDEVDEV Device number 22 16 Unsigned 2 IODSZI_PTHEXTVER Path extension version 0 = no extension 1 = version 1 24 18 Character 36 IODSZI_DKSTAT 24 18 Bitstring 1 IODSZI_DSKSTAT Disk status - X'80' = busy and X'40' = not busy 25 19 Bitstring 1 * Reserved for future IBM use 26 1A Unsigned 2 * Reserved for future IBM use 28 1C Unsigned 4 IODSZI_DSKTIME Amount of time disk is active (in seconds) 32 20 Unsigned 4 IODSZI_DSKXRATE Kbytes/sec transfer rate 36 24 Unsigned 4 IODSZI_DSKBLKSZ Number of bytes in a block 40 28 Unsigned 4 IODSZI_DSKXFERS Number of transfers to/from disk 44 2C Unsigned 4 IODSZI_DSKBLKSR Number of blocks read from disk 48 30 Unsigned 4 IODSZI_DSKBLKSW Number of blocks written to disk 52 34 Unsigned 4 IODSZI_DSKSEEKO Number of seek operations for disk 56 38 Unsigned 4 IODSZI_DSKQDEPTH Queue depth 60 3C Character 32 IODSZI_PTH1INFO 60 3C Unsigned 2 IODSZI_PTH1ID Pathid number - this number correlates with the slot in MTRDEV_EDEVPTHS and IODVON_EDEVPTHS which contain the triplet info 62 3E Bitstring 1 IODSZI_PTH1STAT Path status - X'80' = busy and X'40' = not busy 63 3F Bitstring 1 * Reserved for future IBM use 64 40 Unsigned 4 IODSZI_PTH1TIME Amount of time path is active (in seconds) 68 44 Unsigned 4 IODSZI_PTH1XRATE Kbytes/sec transfer rate 72 48 Unsigned 4 IODSZI_PTH1XFERS Number of transfers to/from disk 76 4C Unsigned 4 IODSZI_PTH1BLKSR Number of blocks read from disk 80 50 Unsigned 4 IODSZI_PTH1BLKSW Number of blocks written to disk 84 54 Unsigned 4 IODSZI_PTH1SEEKO Number of seek operations for disk 88 58 Unsigned 4 IODSZI_PTH1QDEPTH Queue depth 92 5C Character 32 IODSZI_PTH2INFO 92 5C Unsigned 2 IODSZI_PTH2ID Pathid number - this number correlates with the slot in MTRDEV_EDEVPTHS and IODVON_EDEVPTHS which contain the triplet info 94 5E Bitstring 1 IODSZI_PTH2STAT Path status - X'80' = busy and X'40' = not busy 95 5F Bitstring 1 * Reserved for future IBM use 96 60 Unsigned 4 IODSZI_PTH2TIME Amount of time path is active (in seconds) 100 64 Unsigned 4 IODSZI_PTH2XRATE Kbytes/sec transfer rate 104 68 Unsigned 4 IODSZI_PTH2XFERS Number of transfers to/from disk 108 6C Unsigned 4 IODSZI_PTH2BLKSR Number of blocks read from disk 112 70 Unsigned 4 IODSZI_PTH2BLKSW Number of blocks written to disk 116 74 Unsigned 4 IODSZI_PTH2SEEKO Number of seek operations for disk 120 78 Unsigned 4 IODSZI_PTH2QDEPTH Queue depth 124 7C Character 32 IODSZI_PTH3INFO 124 7C Unsigned 2 IODSZI_PTH3ID Pathid number - this number correlates with the slot in MTRDEV_EDEVPTHS and IODVON_EDEVPTHS which contain the triplet info 126 7E Bitstring 1 IODSZI_PTH3STAT Path status - X'80' = busy and X'40' = not busy 127 7F Bitstring 1 * Reserved for future IBM use 128 80 Unsigned 4 IODSZI_PTH3TIME Amount of time path is active (in seconds) 132 84 Unsigned 4 IODSZI_PTH3XRATE Kbytes/sec transfer rate 136 88 Unsigned 4 IODSZI_PTH3XFERS Number of transfers to/from disk 140 8C Unsigned 4 IODSZI_PTH3BLKSR Number of blocks read from disk 144 90 Unsigned 4 IODSZI_PTH3BLKSW Number of blocks written to disk 148 94 Unsigned 4 IODSZI_PTH3SEEKO Number of seek operations for disk 152 98 Unsigned 4 IODSZI_PTH3QDEPTH Queue depth 156 9C Character 32 IODSZI_PTH4INFO 156 9C Unsigned 2 IODSZI_PTH4ID Pathid number - this number correlates with the slot in MTRDEV_EDEVPTHS and IODVON_EDEVPTHS which contain the triplet info 158 9E Bitstring 1 IODSZI_PTH4STAT Path status - X'80' = busy and X'40' = not busy 159 9F Bitstring 1 * Reserved for future IBM use 160 A0 Unsigned 4 IODSZI_PTH4TIME Amount of time path is active (in seconds) 164 A4 Unsigned 4 IODSZI_PTH4XRATE Kbytes/sec transfer rate 168 A8 Unsigned 4 IODSZI_PTH4XFERS Number of transfers to/from disk 172 AC Unsigned 4 IODSZI_PTH4BLKSR Number of blocks read from disk 176 B0 Unsigned 4 IODSZI_PTH4BLKSW Number of blocks written to disk 180 B4 Unsigned 4 IODSZI_PTH4SEEKO Number of seek operations for disk 184 B8 Unsigned 4 IODSZI_PTH4QDEPTH Queue depth 188 BC Character 32 IODSZI_PTH5INFO 188 BC Unsigned 2 IODSZI_PTH5ID Pathid number - this number correlates with the slot in MTRDEV_EDEVPTHS and IODVON_EDEVPTHS which contain the triplet info 190 BE Bitstring 1 IODSZI_PTH5STAT Path status - X'80' = busy and X'40' = not busy 191 BF Bitstring 1 * Reserved for future IBM use 192 C0 Unsigned 4 IODSZI_PTH5TIME Amount of time path is active (in seconds) 196 C4 Unsigned 4 IODSZI_PTH5XRATE Kbytes/sec transfer rate 200 C8 Unsigned 4 IODSZI_PTH5XFERS Number of transfers to/from disk 204 CC Unsigned 4 IODSZI_PTH5BLKSR Number of blocks read from disk 208 D0 Unsigned 4 IODSZI_PTH5BLKSW Number of blocks written to disk 212 D4 Unsigned 4 IODSZI_PTH5SEEKO Number of seek operations for disk 216 D8 Unsigned 4 IODSZI_PTH5QDEPTH Queue depth 220 DC Character 32 IODSZI_PTH6INFO 220 DC Unsigned 2 IODSZI_PTH6ID Pathid number - this number correlates with the slot in MTRDEV_EDEVPTHS and IODVON_EDEVPTHS which contain the triplet info 222 DE Bitstring 1 IODSZI_PTH6STAT Path status - X'80' = busy and X'40' = not busy 223 DF Bitstring 1 * Reserved for future IBM use 224 E0 Unsigned 4 IODSZI_PTH6TIME Amount of time path is active (in seconds) 228 E4 Unsigned 4 IODSZI_PTH6XRATE Kbytes/sec transfer rate 232 E8 Unsigned 4 IODSZI_PTH6XFERS Number of transfers to/from disk 236 EC Unsigned 4 IODSZI_PTH6BLKSR Number of blocks read from disk 240 F0 Unsigned 4 IODSZI_PTH6BLKSW Number of blocks written to disk 244 F4 Unsigned 4 IODSZI_PTH6SEEKO Number of seek operations for disk 248 F8 Unsigned 4 IODSZI_PTH6QDEPTH Queue depth 252 FC Character 32 IODSZI_PTH7INFO 252 FC Unsigned 2 IODSZI_PTH7ID Pathid number - this number correlates with the slot in MTRDEV_EDEVPTHS and IODVON_EDEVPTHS which contain the triplet info 254 FE Bitstring 1 IODSZI_PTH7STAT Path status - X'80' = busy and X'40' = not busy 255 FF Bitstring 1 * Reserved for future IBM use 256 100 Unsigned 4 IODSZI_PTH7TIME Amount of time path is active (in seconds) 260 104 Unsigned 4 IODSZI_PTH7XRATE Kbytes/sec transfer rate 264 108 Unsigned 4 IODSZI_PTH7XFERS Number of transfers to/from disk 268 10C Unsigned 4 IODSZI_PTH7BLKSR Number of blocks read from disk 272 110 Unsigned 4 IODSZI_PTH7BLKSW Number of blocks written to disk 276 114 Unsigned 4 IODSZI_PTH7SEEKO Number of seek operations for disk 280 118 Unsigned 4 IODSZI_PTH7QDEPTH Queue depth 284 11C Character 32 IODSZI_PTH8INFO 284 11C Unsigned 2 IODSZI_PTH8ID Pathid number - this number correlates with the slot in MTRDEV_EDEVPTHS and IODVON_EDEVPTHS which contain the triplet info 286 11E Bitstring 1 IODSZI_PTH8STAT Path status - X'80' = busy and X'40' = not busy 287 11F Bitstring 1 * Reserved for future IBM use 288 120 Unsigned 4 IODSZI_PTH8TIME Amount of time path is active (in seconds) 292 124 Unsigned 4 IODSZI_PTH8XRATE Kbytes/sec transfer rate 296 128 Unsigned 4 IODSZI_PTH8XFERS Number of transfers to/from disk 300 12C Unsigned 4 IODSZI_PTH8BLKSR Number of blocks read from disk 304 130 Unsigned 4 IODSZI_PTH8BLKSW Number of blocks written to disk 308 134 Unsigned 4 IODSZI_PTH8SEEKO Number of seek operations for disk 312 138 Unsigned 4 IODSZI_PTH8QDEPTH Queue depth 316 13C Unsigned 2 IODSZI_PTHEXTSZ Size of a path extension 318 13E Unsigned 2 IODSZI_PTHEXTCT Number of path extensions 320 140 Unsigned 2 IODSZI_PTHEXTOF Offset to first path 322 142 Unsigned 2 * Reserved for future IBM use 324 144 Character 8 IODSZI_DSKUTIME Amount of time disk is active (microseconds) 332 14C Character 8 IODSZI_PTH1UTIME Amount of time path is active (microseconds) 340 154 Character 8 IODSZI_PTH2UTIME Amount of time path is active (microseconds) 348 15C Character 8 IODSZI_PTH3UTIME Amount of time path is active (microseconds) 356 164 Character 8 IODSZI_PTH4UTIME Amount of time path is active (microseconds) 364 16C Character 8 IODSZI_PTH5UTIME Amount of time path is active (microseconds) 372 174 Character 8 IODSZI_PTH6UTIME Amount of time path is active (microseconds) 380 176 Character 8 IODSZI_PTH7UTIME Amount of time path is active (microseconds) 388 184 Character 8 IODSZI_PTH8UTIME Amount of time path is active (microseconds) 396 18C Character 0 IODSZI_END
Path extension 1 - PCM Path Statistics Offsets Dec Hex Type Len Name (Dim) Description 0 0 Structure 128 IODSZI_PX1PCMST 0 0 Unsigned 4 IODSZI_PX1PATHID Path ID of the path to extend 4 4 Unsigned 4 IODSZI_PX1SELECT Number of times this path has been selected for an I/O operation 8 8 Unsigned 4 IODSZI_PX1APERRO Cumulative count of all adapter errors, including those specified below 12 C Unsigned 4 IODSZI_PX1APSOFT Cumulative count of generic adapter software errors 16 10 Unsigned 4 IODSZI_PX1APHARD Cumulative count of generic adapter hardware errors 20 14 Unsigned 4 IODSZI_PX1APTRAN Cumulative count of generic transport errors 24 18 Unsigned 4 IODSZI_PX1TIMEOU Cumulative count of device timeouts 28 1C Unsigned 4 IODSZI_PX1SCERRO Cumulative count of all SCSI errors, including those specified below 32 20 Unsigned 4 IODSZI_PX1SCRESV Cumulative count of SCSI reservation conflict errors 36 24 Unsigned 4 IODSZI_PX1SCQFUL Cumulative count of SCSI device queue full errors 40 28 Unsigned 4 IODSZI_PX1SCBUSY Cumulative count of SCSI device busy errors 44 2C Unsigned 4 IODSZI_PX1SCACAA Cumulative count of SCSI ACA active errors 48 30 Unsigned 4 IODSZI_PX1SCTSKA Cumulative count of SCSI aborted task errors 52 34 Unsigned 4 IODSZI_PX1SCCOND Cumulative count of all check conditions, including those specified below 56 38 Unsigned 4 IODSZI_PX1CHKMED Cumulative count of medium check conditions 60 3C Unsigned 4 IODSZI_PX1CHKHRD Cumulative count of hardware check conditions 64 40 Unsigned 4 IODSZI_PX1CHKNRD Cumulative count of not ready check conditions 68 44 Unsigned 4 IODSZI_PX1CHKABT Cumulative count of task aborted check conditions 72 48 Unsigned 4 * Reserved for future IBM use 76 4C Unsigned 1 IODSZI_PX1LASTER Type of the most recent error received on this path 0 = no error 1 = an adapter error that is not one of the following three 2 = generic adapter software error 3 = generic adapter hardware error 4 = generic transfer error 5 = generic timeout error 6 = device reservation conflict error 7 = device queue full error 8 = device busy error 9 = device abort task error 10 = a check condition that is not one of the following four 11 = medium check condition 12 = hardware check condition 13 = not ready check condition 14 = task aborted check condition 77 4D Unsigned 1 * Reserved for future IBM use 78 4E Unsigned 2 * Reserved for future IBM use 80 50 Character 8 IODSZI_PX1LASTET Time of the most recent error received on this path in time-of-day (TOD) format 88 58 Unsigned 4 IODSZI_PX1FAILUR Cumulative count of path failures due to all error types, including those specified below 92 5C Unsigned 4 IODSZI_PX1FAILIO Cumulative count of path failures due to general IO errors 96 60 Unsigned 4 IODSZI_PX1FAILAP Cumulative count of path failures due to adapter errors 100 64 Unsigned 4 IODSZI_PX1FAILSC Cumulative count of path failures due to SCSI sense errors 104 68 Unsigned 4 IODSZI_PX1FAILQF Cumulative count of path failures due to inquiry qualifying bit errors 108 6C Unsigned 4 IODSZI_PX1FAILOP Cumulative count of path failures due to initialization IO errors 112 70 Unsigned 4 IODSZI_PX1FAILHC Cumulative count of path failures due to diagnostic IO errors 116 74 Unsigned 1 IODSZI_PX1LASTRS Reason for the most recent failure 0 = no reason given 1 = an IO operation was retried too many times 2 = an adapter error made us not want to retry the command 3 = a SCSI sense error made us not want to retry the command 4 = a SCSI inquiry qualifying bit made us not want to retry the command 5 = path failure occurred during path initialization 6 = path failure occurred during diagnostics 117 75 Unsigned 1 * Reserved for future IBM use 118 76 Unsigned 2 * Reserved for future IBM use 120 78 Character 8 IODSZI_PX1LASTFT Time of the most recent failure in time-of-day (TOD) format
MRIODSZI Cross Reference
Hex Hex
Name Offset Length Value
IODSZI 0 396+
IODSZI_DKSTAT 18 36
IODSZI_DSKBLKSR 2C 4
IODSZI_DSKBLKSW 30 4
IODSZI_DSKBLKSZ 24 4
IODSZI_DSKQDEPTH 38 4
IODSZI_DSKSEEKO 34 4
IODSZI_DSKSTAT 18 1
IODSZI_DSKTIME 1C 4
IODSZI_DSKUTIME 144 8
IODSZI_DSKXFERS 28 4
IODSZI_DSKXRATE 20 4
IODSZI_END 18C 0
IODSZI_MRHDR 0 0
IODSZI_PTHEXTCT 13E 2
IODSZI_PTHEXTOF 140 2
IODSZI_PTHEXTSZ 13C 2
IODSZI_PTHEXTVER 16 2
IODSZI_PTH1BLKSR 4C 4
IODSZI_PTH1BLKSW 50 4
IODSZI_PTH1ID 3C 2
IODSZI_PTH1INFO 3C 32
IODSZI_PTH1QDEPTH 58 4
IODSZI_PTH1SEEKO 54 4
IODSZI_PTH1STAT 3E 1
IODSZI_PTH1TIME 40 4
IODSZI_PTH1UTIME 14C 8
IODSZI_PTH2UTIME 154 8
IODSZI_PTH3UTIME 15C 8
IODSZI_PTH4UTIME 164 8
IODSZI_PTH5UTIME 16C 8
IODSZI_PTH6UTIME 174 8
IODSZI_PTH7UTIME 17C 8
IODSZI_PTH8UTIME 184 8
IODSZI_PTH1XFERS 48 4
IODSZI_PTH1XRATE 44 4
IODSZI_PTH2BLKSR 6C 4
IODSZI_PTH2BLKSW 70 4
IODSZI_PTH2ID 5C 2
IODSZI_PTH2INFO 5C 32
IODSZI_PTH2QDEPTH 78 4
IODSZI_PTH2SEEKO 74 4
IODSZI_PTH2STAT 5E 1
IODSZI_PTH2TIME 60 4
IODSZI_PTH2XFERS 68 4
IODSZI_PTH2XRATE 64 4
IODSZI_PTH3BLKSR 8C 4
IODSZI_PTH3BLKSW 90 4
IODSZI_PTH3ID 7C 2
IODSZI_PTH3INFO 7C 32
IODSZI_PTH3QDEPTH 98 4
IODSZI_PTH3SEEKO 94 4
IODSZI_PTH3STAT 7E 1
IODSZI_PTH3TIME 80 4
IODSZI_PTH3XFERS 88 4
IODSZI_PTH3XRATE 84 4
IODSZI_PTH4BLKSR AC 4
IODSZI_PTH4BLKSW B0 4
IODSZI_PTH4ID 9C 2
IODSZI_PTH4INFO 9C 32
IODSZI_PTH4QDEPTH B8 4
IODSZI_PTH4SEEKO B4 4
IODSZI_PTH4STAT 9E 1
IODSZI_PTH4TIME A0 4
IODSZI_PTH4XFERS A8 4
IODSZI_PTH4XRATE A4 4
IODSZI_PTH5BLKSR CC 4
IODSZI_PTH5BLKSW D0 4
IODSZI_PTH5ID BC 2
IODSZI_PTH5INFO BC 32
IODSZI_PTH5QDEPTH D8 4
IODSZI_PTH5SEEKO D4 4
IODSZI_PTH5STAT BE 1
IODSZI_PTH5TIME C0 4
IODSZI_PTH5XFERS C8 4
IODSZI_PTH5XRATE C4 4
IODSZI_PTH6BLKSR EC 4
IODSZI_PTH6BLKSW F0 4
IODSZI_PTH6ID DC 2
IODSZI_PTH6INFO DC 32
IODSZI_PTH6QDEPTH F8 4
IODSZI_PTH6SEEKO F4 4
IODSZI_PTH6STAT DE 1
IODSZI_PTH6TIME E0 4
IODSZI_PTH6XFERS E8 4
IODSZI_PTH6XRATE E4 4
IODSZI_PTH7BLKSR 10C 4
IODSZI_PTH7BLKSW 110 4
IODSZI_PTH7ID FC 2
IODSZI_PTH7INFO FC 32
IODSZI_PTH7QDEPTH 118 4
IODSZI_PTH7SEEKO 114 4
IODSZI_PTH7STAT FE 1
IODSZI_PTH7TIME 100 4
IODSZI_PTH7XFERS 108 4
IODSZI_PTH7XRATE 104 4
IODSZI_PTH8BLKSR 12C 4
IODSZI_PTH8BLKSW 130 4
IODSZI_PTH8ID 11C 2
IODSZI_PTH8INFO 11C 32
IODSZI_PTH8QDEPTH 138 4
IODSZI_PTH8SEEKO 134 4
IODSZI_PTH8STAT 11E 1
IODSZI_PTH8TIME 120 4
IODSZI_PTH8XFERS 128 4
IODSZI_PTH8XRATE 124 4
IODSZI_PX1APERRO 8 4
IODSZI_PX1APHARD 10 4
IODSZI_PX1APSOFT C 4
IODSZI_PX1APTRAN 14 4
IODSZI_PX1CHKABT 3C 4
IODSZI_PX1CHKHRD 3C 4
IODSZI_PX1CHKMED 38 4
IODSZI_PX1CHKNRD 40 4
IODSZI_PX1FAILAP 60 4
IODSZI_PX1FAILHC 70 4
IODSZI_PX1FAILIO 5C 4
IODSZI_PX1FAILOP 6C 4
IODSZI_PX1FAILQF 68 4
IODSZI_PX1FAILSC 64 4
IODSZI_PX1FAILUR 58 4
IODSZI_PX1LASTER 4C 1
IODSZI_PX1LASTET 50 8
IODSZI_PX1LASTFT 78 8
IODSZI_PX1LASTRS 74 1
IODSZI_PX1PATHID 0 4
IODSZI_PX1PCMST 0 128
IODSZI_PX1SCACAA 2C 4
IODSZI_PX1SCBUSY 28 4
IODSZI_PX1SCCOND 34 4
IODSZI_PX1SCERRO 1C 4
IODSZI_PX1SCQFUL 24 4
IODSZI_PX1SCRESV 20 4
IODSZI_PX1SCTSKA 30 4
IODSZI_PX1SELECT 4 4
IODSZI_PX1TIMEOU 18 4
IODSZI_RDEVDEV 14 2
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 V7R3.0.
Last updated on 12 September 2022 at 19:23:05.
Copyright IBM Corporation, 1990, 2022