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 - 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   148  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      4  *                      Reserved for IBM use
  36  24  Unsigned      2  IODFCS_FCARDEV         FCP device number
  38  26  Unsigned      2  *                      Reserved for IBM use
  40  28  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
  44  2C  Unsigned      4  *                      Reserved for IBM use
  48  30  Character     8  IODFCS_FCAINPRQ        The number of requests
                                                  causing read operations on
                                                  this FCP device since
                                                  activation - cumulative
                                                  (eight-byte unsigned binary)
  56  38  Character     8  IODFCS_FCAOUTRQ        The number of requests
                                                  causing write operations on
                                                  this FCP device since
                                                  activation - cumulative
                                                  (eight-byte unsigned binary)
  64  40  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)
  72  48  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)
  80  50  Character     8  IODFCS_FCARESET        The time in seconds since
                                                  FCP device activation
                                                  -cumulative (eight-byte
                                                  unsigned binary)
  88  58  Character     8  IODFCS_FCALATEN        Aggregate of channel and
                                                  fabric latency - cumulative
                                                  in nanoseconds.
                                                  (eight-byte unsigned binary)
  96  60  Character     8  IODFCS_FCABUFOF        Count of the number of
                                                  times there has been a buffer
                                                  overflow condition -
                                                  cumulative (eight-byte
                                                  unsigned binary)
 104  68  Character     8  IODFCS_FCASTIME        Cumulative time across calls
                                                  to gather data,
                                                  in time-of-day (TOD) format.
 112  70  Unsigned      4  IODFCS_FCASCALL        The overall number of calls
                                                  to gather data - cumulative
 116  74  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 120 78 Unsigned 4 IODFCS_FCASMPLS Cumulative count of samples 124 7C 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 126 7E Unsigned 2 * Reserved for IBM use 128 80 Unsigned 4 IODFCS_FCAQDSUM This is the sum of the samples of the number of buffers in use 132 84 Character 8 IODFCS_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 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) 148 94 Character 0 IODFCS_END

MRIODFCS Cross Reference

                      Hex           Hex
Name                  Offset Length Value
 
IODFCS                     0    148
IODFCS_END                94      0
IODFCS_FCABUFOF           60      8
IODFCS_FCAINPMB           40      8
IODFCS_FCAINPRQ           30      8
IODFCS_FCALATEN           58      8
IODFCS_FCANMPTH           1C      4
IODFCS_FCAOUTMB           48      8
IODFCS_FCAOUTRQ           38      8
IODFCS_FCAPRTYP           28      4
IODFCS_FCAQDPTH           7C      2
IODFCS_FCAQDSQR           84      8
IODFCS_FCAQDSUM           80      4
IODFCS_FCAQSECS           8C      8
IODFCS_FCARDEV            24      2
IODFCS_FCARESET           50      8
IODFCS_FCASCALL           70      4
IODFCS_FCASERRS           74      4
IODFCS_FCASMPLS           78      4
IODFCS_FCASTIME           68      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 V7R1.0.

Last updated on 11 Sept 2018 at 15:46:21.
Copyright IBM Corporation, 1990, 2018