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

#### MRIODFCS

Prolog
Control Block Contents
Cross Reference

#### MRIODFCS Prolog

     DSECT NAME - IODFCS
     FUNCTION - Map a Monitor record.
     LOCATED BY -
            Through the Monitor Control Area
     REFERENCED CONTROL BLOCKS -
            MRRECHDR    Monitor Record Header
     NAME - MRIODFCS
     DESCRIPTIVE NAME - Monitor Sample Record
                        Domain 6  - I/O Domain
                        Record 50 - EDEVICE FCP Device Activity
     DESCRIPTION - Describes activity on an FCP device since it 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.

#### MRIODFCS Control Block Contents

    Offsets
    Dec  Hex  Type        Len  Name (Dim)             Description

       0   0  Structure   140  IODFCS                 Start of monitor record
       0   0  Character     0  IODFCS_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  IODFCS_FCAUTIME        Timestamp (TOD) of the most
                                                      recent data collection.
      28  1C  Unsigned      4  IODFCS_FCANMPTH        Number of path(s) using
                                                      this FCP device
      32  20  Unsigned      2  IODFCS_FCARDEV         FCP device number
      34  22  Unsigned      2  *                      Reserved for IBM use
      36  24  Unsigned      4  IODFCS_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
      40  28  Character     8  IODFCS_FCAINPRQ        The number of requests
                                                      causing read operations on
                                                      this FCP device since
                                                      activation - cumulative
                                                      (eight-byte unsigned binary)
      48  30  Character     8  IODFCS_FCAOUTRQ        The number of requests
                                                      causing write operations on
                                                      this FCP device since
                                                      activation - cumulative
                                                      (eight-byte unsigned binary)
      56  38  Character     8  IODFCS_FCAINPMB        The amount of data
                                                      in megabytes
                                                      that has
                                                      been received for this FCP
                                                      device in read requests since
                                                      activation - cumulative
                                                      (eight-byte
                                                      unsigned binary)
      64  40  Character     8  IODFCS_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)
      72  48  Character     8  IODFCS_FCARESET        The time in seconds since
                                                      FCP device activation
                                                      -cumulative (eight-byte
                                                      unsigned binary)
      80  50  Character     8  IODFCS_FCALATEN        Aggregate of channel and
                                                      fabric latency - cumulative
                                                      in nanoseconds.
                                                      (eight-byte unsigned binary)
      88  58  Character     8  IODFCS_FCABUFOF        Count of the number of
                                                      times there has been a buffer
                                                      overflow condition -
                                                      cumulative (eight-byte
                                                      unsigned binary)
      96  60  Character     8  IODFCS_FCASTIME        Cumulative time across calls
                                                      to gather data,
                                                      in time-of-day (TOD) format.
     104  68  Unsigned      4  IODFCS_FCASCALL        The overall number of calls
                                                      to gather data - cumulative
     108  6C  Unsigned      4  IODFCS_FCASERRS        Number of data calls that
                                                      failed with error -
                                                      cumulative
    IODFCS_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

     112  70  Unsigned      4  IODFCS_FCASMPLS        Cumulative count of samples
     116  74  Unsigned      2  IODFCS_FCAQDPTH        This is the number of
                                                      buffers in use. This will be
                                                      used for generating an
                                                      average of queue fill usage -
                                                      cardinal
     118  76  Unsigned      2  *                      Reserved for IBM use
     120  78  Unsigned      4  IODFCS_FCAQDSUM        This is the sum of the
                                                      samples of the number of
                                                      buffers in use
     124  7C  Character     8  IODFCS_FCAQDSQR        This is the sum of squares
                                                      of the samples of the
                                                      number of buffers in use
                                                      (eight-byte unsigned
                                                      binary)
     132  84  Character     8  IODFCS_FCAQSECS        The total time in
                                                      microseconds that requests
                                                      have spent queued in the QDIO
                                                      outbound queue in the
                                                      container - cumulative
                                                      (eight-byte unsigned binary)
     140  8C  Character     0  IODFCS_END

#### MRIODFCS Cross Reference

                          Hex           Hex
    Name                  Offset Length Value

    IODFCS                     0    140
    IODFCS_END                8C      0
    IODFCS_FCABUFOF           58      8
    IODFCS_FCAINPMB           38      8
    IODFCS_FCAINPRQ           28      8
    IODFCS_FCALATEN           50      8
    IODFCS_FCANMPTH           1C      4
    IODFCS_FCAOUTMB           40      8
    IODFCS_FCAOUTRQ           30      8
    IODFCS_FCAPRTYP           24      4
    IODFCS_FCAQDPTH           74      2
    IODFCS_FCAQDSQR           7C      8
    IODFCS_FCAQDSUM           78      4
    IODFCS_FCAQSECS           84      8
    IODFCS_FCARDEV            20      2
    IODFCS_FCARESET           48      8
    IODFCS_FCASCALL           68      4
    IODFCS_FCASERRS           6C      4
    IODFCS_FCASMPLS           70      4
    IODFCS_FCASTIME           60      8
    IODFCS_FCAUTIME           14      8
    IODFCS_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 04 March 2025 at 17:25:21.

    Copyright IBM Corporation, 1990, 2025