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

#### MRIODFCD

Prolog
Control Block Contents
Cross Reference

#### MRIODFCD Prolog

     DSECT NAME - IODFCD
     FUNCTION - Map a Monitor record.
     LOCATED BY -
            Through the Monitor Control Area
     REFERENCED CONTROL BLOCKS -
            MRRECHDR    Monitor Record Header
     NAME - MRIODFCD
     DESCRIPTIVE NAME - Monitor Event Record
                        Domain 6  - I/O Domain
                        Record 52 - FCP device no longer in use for
                                    EDEVICE activity
     DESCRIPTION - Indicates that an FCP device 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.
           - Aggregate of channel and fabric latency- In the past this
             was reported in channel ticks, which are channel-dependent.
             Instead, these are now reported in microseconds since
             the EDEV code has the channel tick value available.

#### MRIODFCD Control Block Contents

    Offsets
    Dec  Hex  Type        Len  Name (Dim)             Description

       0   0  Structure   148  IODFCD                 Start of monitor record
       0   0  Character     0  IODFCD_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  IODFCD_FCAUTIME        Timestamp (TOD) of the most
                                                      recent data collection.
      28  1C  Unsigned      4  IODFCD_FCANMPTH        Number of online EDEV paths
                                                      using this FCP device
      32  20  Unsigned      4  *                      Reserved for IBM use
      36  24  Unsigned      2  IODFCD_FCARDEV         FCP device number
      38  26  Unsigned      2  *                      Reserved for IBM use
      40  28  Unsigned      4  IODFCD_FCAPRTYP        The adapter type
                                                      x'00000001' Ficon Adapter
                                                      x'00000002' Ficon Express
                                                      x'00000003' Ficon Express2
                                                      x'00000004' Ficon Express4
                                                      x'00000005' Ficon Express8
                                                      x'00000006' Ficon Express8S
                                                      x'00000007' Ficon Express16S
                                                      x'00000008' Ficon Express16XS
      44  2C  Unsigned      4  *                      Reserved for IBM use
      48  30  Character     8  IODFCD_FCAINPRQ        The number of requests
                                                      causing read operations on
                                                      this FCP device since
                                                      activation - cumulative
                                                      (eight-byte unsigned binary)
      56  38  Character     8  IODFCD_FCAOUTRQ        The number of requests
                                                      causing write operations on
                                                      this FCP device since
                                                      activation - cumulative
                                                      (eight-byte unsigned binary)
      64  40  Character     8  IODFCD_FCAINPMB        The amount of data
                                                      in megabytes
                                                      that has
                                                      been received for this FCP
                                                      device on read requests since
                                                      activation - cumulative
                                                      (eight-byte
                                                      unsigned binary)
      72  48  Character     8  IODFCD_FCAOUTMB        The amount of data
                                                      in megabytes
                                                      that has
                                                      been sent for this FCP device
                                                      in write requests since
                                                      activation - cumulative
                                                      (eight-byte
                                                      unsigned binary)
      80  50  Character     8  IODFCD_FCARESET        The time in seconds since
                                                      FCP device activation
                                                      -cumulative (eight-byte
                                                      unsigned binary)
      88  58  Character     8  IODFCD_FCALATEN        Aggregate of channel and
                                                      fabric latency - cumulative.
                                                      In nanoseconds. (eight-byte
                                                      unsigned binary)
      96  60  Character     8  IODFCD_FCABUFOF        Count of the number of
                                                      times there has been a buffer
                                                      overflow condition -
                                                      cumulative (eight-byte
                                                      unsigned binary)
     104  68  Character     8  IODFCD_FCASTIME        Cumulative time across calls
                                                      to gather data,
                                                      in time-of-day (TOD) format.
     112  70  Unsigned      4  IODFCD_FCASCALL        The overall number of calls
                                                      to gather data - cumulative
     116  74  Unsigned      4  IODFCD_FCASERRS        Number of data calls that
                                                      failed with error -
                                                      cumulative
    IODFCD_FCASMPLS 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

     120  78  Unsigned      4  IODFCD_FCASMPLS        Cumulative count of samples
     124  7C  Unsigned      2  IODFCD_FCAQDPTH        This is the number of
                                                      buffers in use. This will be
                                                      used for generating an
                                                      average of queue fill usage -
                                                      cardinal
     126  7E  Unsigned      2  *                      Reserved for IBM use
     128  80  Unsigned      4  IODFCD_FCAQDSUM        This is the sum of the
                                                      samples of the number of
                                                      buffers in use
     132  84  Character     8  IODFCD_FCAQDSQR        This is the sum of squares
                                                      of the samples of the
                                                      number of buffers in use
                                                      (eight-byte unsigned
                                                      binary)
     140  8C  Character     8  IODFCD_FCAQSECS        The total time in
                                                      microseconds that requests
                                                      have spent queued in the QDIO
                                                      outbound queue in the
                                                      container - cumulative
                                                      (eight-byte unsigned binary)
     148  94  Character     0  IODFCD_END

#### MRIODFCD Cross Reference

                          Hex           Hex
    Name                  Offset Length Value

    IODFCD                     0    148
    IODFCD_END                94      0
    IODFCD_FCABUFOF           60      8
    IODFCD_FCAINPMB           40      8
    IODFCD_FCAINPRQ           30      8
    IODFCD_FCALATEN           58      8
    IODFCD_FCANMPTH           1C      4
    IODFCD_FCAOUTMB           48      8
    IODFCD_FCAOUTRQ           38      8
    IODFCD_FCAPRTYP           28      4
    IODFCD_FCAQDPTH           7C      2
    IODFCD_FCAQDSQR           84      8
    IODFCD_FCAQDSUM           80      4
    IODFCD_FCAQSECS           8C      8
    IODFCD_FCARDEV            24      2
    IODFCD_FCARESET           50      8
    IODFCD_FCASCALL           70      4
    IODFCD_FCASERRS           74      4
    IODFCD_FCASMPLS           78      4
    IODFCD_FCASTIME           68      8
    IODFCD_FCAUTIME           14      8
    IODFCD_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 09 August 2020 at 16:01:21.

    Copyright IBM Corporation, 1990, 2020