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 V6R4.0.

Last updated on 9 March 2018 at 13:53:21.
Copyright IBM Corporation, 1990, 2018