Programming Interface Information:
The Monitor Records are intended Programming Interfaces that
allow the customer to write programs to obtain services of z/VM.

MRIODCHD

Prolog
Control 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