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 FCP 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   152  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  8C  Character     8  IODCHS_CHAADAPQ        Sum of squares of adapter
                                                      utilization
     148  94  Unsigned      4  IODCHS_CHANMPT2        Full-width CHANMPTH
     152  98  Character     0  IODCHS_END

#### MRIODCHS Cross Reference

                          Hex           Hex
    Name                  Offset Length Value

    IODCHS                     0    152
    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_CHANMPT2           94      4
    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 V7R2.0.

    Last updated on 05 August 2020 at 20:42:21.

    Copyright IBM Corporation, 1990, 2020