Programming Interface Information:
The Monitor Records are intended Programming Interfaces that allow the customer to write programs to obtain services of z/VM. |
MRIODCHD
PrologControl Block Contents
Cross Reference
MRIODCHD Prolog
DSECT NAME - IODCHD FUNCTION - Map a Monitor record. LOCATED BY - Through the Monitor Control Area REFERENCED CONTROL BLOCKS - MRRECHDR Monitor Record Header NAME - MRIODCHD DESCRIPTIVE NAME - Monitor Event Record Domain 6 - I/O Domain Record 48 - CHPID is no longer in use for EDEVICE activity DESCRIPTION - Indicates that a CHPID is no longer in use by any EDEV(s) NOTES - Note that the timestamp and data for the CHPID activity record might be identical to that in the previous record in cases where there was a delay in the capturing of the data. In this case there is effectively no interval reported on between this pair of records and a later record with a different timestamp must be used to compute usage for the CHPID.
MRIODCHD Control Block Contents
Offsets Dec Hex Type Len Name (Dim) Description 0 0 Structure 148 IODCHD Start of monitor record 0 0 Character 0 IODCHD_MRHDR Record header. See MRRECHDR for details. 0 0 Character 20 MRHDR 0 0 Unsigned 2 MRHDRLEN 2 2 Unsigned 2 MRHDRZER 4 4 Unsigned 1 MRHDRDM 5 5 Unsigned 1 * 6 6 Unsigned 2 MRHDRRC 8 8 Character 8 MRHDRTOD 16 10 Character 4 * 20 14 Character 0 MRHDR_END 20 14 Character 8 IODCHD_CHAUTIME Timestamp (TOD) of the most recent data collection. 28 1C Unsigned 4 IODCHD_CHANMPTH Number of path(s) using this CHPID 32 20 Unsigned 1 IODCHD_CHACHPID CHPID number 33 21 Unsigned 3 * Reserved 36 24 Unsigned 4 IODCHD_CHAPRTYP The type of the local port X'00000001'- port type unknown X'00000003'- port not accessible X'00000005'- N_Port attached to a fabric X'00000021'- port is point-to-point attached to a device 40 28 Character 8 IODCHD_CHAINPRQ The number of requests causing read operations on this chpid since activation - cumulative (eight-byte unsigned binary) 48 30 Character 8 IODCHD_CHAOUTRQ The number of requests causing write operations on this chpid since activation - cumulative (eight-byte unsigned binary) 56 38 Character 8 IODCHD_CHAINPMB The amount of data in megabytes that has been received for this chpid since activation - cumulative (eight-byte unsigned binary) 64 40 Character 8 IODCHD_CHAOUTMB The amount of data in megabytes that has been sent for this chpid since activation - cumulative (eight-byte unsigned binary) 72 48 Character 8 IODCHD_CHARESET Seconds since last channel reset - cumulative (eight-byte unsigned binary) 80 50 Unsigned 4 IODCHD_CHASCALL The overall number of calls to gather data - cumulative 84 54 Character 8 IODCHD_CHASTIME Cumulative time to gather data, in time-of-day (TOD) format. 92 5C Unsigned 4 IODCHD_CHASERRS Number of data calls that failed with error - cumulative
IODCHD_CHASMPLS is a count of the number of samples of data that have been taken for this record since Monitor began. It is used by the reduction program in relation to the cumulative values below.
Offsets Dec Hex Type Len Name (Dim) Description 96 60 Unsigned 4 IODCHD_CHASMPLS Cumulative count of samples 100 64 Unsigned 1 IODCHD_CHAPROCU Overall utilization of the processor in the chpid, percentage - cardinal 101 65 Unsigned 3 * Reserved 104 68 Unsigned 4 IODCHD_CHAPROCS Cumulative sum of processor utilization 108 6C Character 8 IODCHD_CHAPROCQ Sum of squares of processor utilization 116 74 Unsigned 1 IODCHD_CHABUSUT Overall utilization of the bus in the chpid, percentage - cardinal 117 75 Unsigned 3 * Reserved 120 78 Unsigned 4 IODCHD_CHABUSSM Cumulative sum of bus utilization 124 7C Character 8 IODCHD_CHABUSSQ Sum of squares of bus utilization 132 84 Unsigned 1 IODCHD_CHAADAPU Overall utilization of the chpid's integrated Fibre Channel adapter, percentage - cardinal 133 85 Unsigned 3 * Reserved 136 88 Unsigned 4 IODCHD_CHAADAPS Cumulative sum of adapter utilization 140 8C Character 8 IODCHD_CHAADAPQ Sum of squares of adapter utilization 148 94 Character 0 IODCHD_END
MRIODCHD Cross Reference
Hex Hex Name Offset Length Value IODCHD 0 148 IODCHD_CHAADAPQ 8C 8 IODCHD_CHAADAPS 88 4 IODCHD_CHAADAPU 84 1 IODCHD_CHABUSSM 78 4 IODCHD_CHABUSSQ 7C 8 IODCHD_CHABUSUT 74 1 IODCHD_CHACHPID 20 1 IODCHD_CHAINPMB 38 8 IODCHD_CHAINPRQ 28 8 IODCHD_CHANMPTH 1C 4 IODCHD_CHAOUTMB 40 8 IODCHD_CHAOUTRQ 30 8 IODCHD_CHAPROCQ 6C 8 IODCHD_CHAPROCS 68 4 IODCHD_CHAPROCU 64 1 IODCHD_CHAPRTYP 24 4 IODCHD_CHARESET 48 8 IODCHD_CHASCALL 50 4 IODCHD_CHASERRS 5C 4 IODCHD_CHASMPLS 60 4 IODCHD_CHASTIME 54 8 IODCHD_CHAUTIME 14 8 IODCHD_END 94 0 IODCHD_MRHDR 0 0 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 V6R4.0.
Last updated on 26 March 2018 at 14:28:21.
Copyright IBM Corporation, 1990, 2018