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

MRIODCHS

Prolog
Control Block Contents
Cross Reference

MRIODCHS Prolog

 DSECT NAME - IODCHS
 FUNCTION - Map a Monitor record.
 LOCATED BY -
        Through the Monitor Control Area
 REFERENCED CONTROL BLOCKS -
        MRRECHDR    Monitor Record Header
 NAME - MRIODCHS
 DESCRIPTIVE NAME - Monitor Sample Record
                    Domain 6  - I/O Domain
                    Record 49 - EDEVICE CHPID activity
 DESCRIPTION - Describes activity on a CHPID since the first
               associated EDEVice using that CHPID came online.
 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.

MRIODCHS Control Block Contents

Offsets
Dec  Hex  Type        Len  Name (Dim)             Description
 
   0   0  Structure   148  IODCHS                 Start of monitor record
   0   0  Character     0  IODCHS_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  IODCHS_CHAUTIME        Timestamp (TOD) of the most
                                                  recent data set collection.
  28  1C  Unsigned      2  IODCHS_CHANMPTH        Number of path(s) using
                                                  this chpid
  30  1E  Unsigned      2  *                      Reserved for IBM use
  32  20  Unsigned      1  IODCHS_CHACHPID        CHPID number
  33  21  Unsigned      3  *                      Reserved for IBM use
  36  24  Unsigned      4  IODCHS_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  IODCHS_CHAINPRQ        The number of requests
                                                  causing Read operations on
                                                  this chpid since activation -
                                                  cumulative (eight-byte
                                                  unsigned binary)
  48  30  Character     8  IODCHS_CHAOUTRQ        The number of requests
                                                  causing write operations on
                                                  this chpid since activation -
                                                  cumulative (eight-byte
                                                  unsigned binary)
  56  38  Character     8  IODCHS_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  IODCHS_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  IODCHS_CHARESET        Seconds since last channel
                                                  reset - cumulative
                                                  (eight-byte unsigned binary)
  80  50  Unsigned      4  IODCHS_CHASCALL        The overall number of calls
                                                  to gather data - cumulative
  84  54  Character     8  IODCHS_CHASTIME        Cumulative time
                                                  to gather data
                                                  in time-of-day (TOD) format.
                                                  (eight-byte unsigned binary)
  92  5C  Unsigned      4  IODCHS_CHASERRS        Number of data calls that
                                                  failed with error -
                                                  cumulative

IODCHS_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 IODCHS_CHASMPLS Cumulative count of samples 100 64 Unsigned 1 IODCHS_CHAPROCU Overall utilization of the processor in the FCP channel, percentage - cardinal 101 65 Unsigned 3 * Reserved for IBM use 104 68 Unsigned 4 IODCHS_CHAPROCS Cumulative sum of processor utilization 108 6C Character 8 IODCHS_CHAPROCQ Sum of squares of processor utilization 116 74 Unsigned 1 IODCHS_CHABUSUT Overall utilization of the bus in the FCP channel, percentage - cardinal 117 75 Unsigned 3 * Reserved for IBM use 120 78 Unsigned 4 IODCHS_CHABUSSM Cumulative sum of bus utilization 124 7C Character 8 IODCHS_CHABUSSQ Sum of squares of bus utilization 132 84 Unsigned 1 IODCHS_CHAADAPU Overall utilization of the FCP channel's integrated Fibre Channel adapter, percentage - cardinal 133 85 Unsigned 3 * Reserved for IBM use 136 88 Unsigned 4 IODCHS_CHAADAPS Cumulative sum of adapter utilization 140 7C Character 8 IODCHS_CHAADAPQ Sum of squares of adapter utilization 148 94 Character 0 IODCHS_END

MRIODCHS Cross Reference

                      Hex           Hex
Name                  Offset Length Value
 
IODCHS                     0    148
IODCHS_CHAADAPQ           7C      8
IODCHS_CHAADAPS           88      4
IODCHS_CHAADAPU           84      1
IODCHS_CHABUSSM           78      4
IODCHS_CHABUSSQ           7C      8
IODCHS_CHABUSUT           74      1
IODCHS_CHACHPID           20      1
IODCHS_CHAINPMB           38      8
IODCHS_CHAINPRQ           28      8
IODCHS_CHANMPTH           1C      2
IODCHS_CHAOUTMB           40      8
IODCHS_CHAOUTRQ           30      8
IODCHS_CHAPROCQ           6C      8
IODCHS_CHAPROCS           68      4
IODCHS_CHAPROCU           64      1
IODCHS_CHAPRTYP           24      4
IODCHS_CHARESET           48      8
IODCHS_CHASCALL           50      4
IODCHS_CHASERRS           5C      4
IODCHS_CHASMPLS           60      4
IODCHS_CHASTIME           54      8
IODCHS_CHAUTIME           14      8
IODCHS_END                94      0
IODCHS_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:50:21.
Copyright IBM Corporation, 1990, 2018