About cookies on this site Our websites require some cookies to function properly (required). In addition, other cookies may be used with your consent to analyze site usage, improve the user experience and for advertising. For more information, please review your options. By visiting our website, you agree to our processing of information as described in IBM’sprivacy statement. To provide a smooth navigation, your cookie preferences will be shared across the IBM web domains listed here.
Programming Interface Information:
The Monitor Records are intended Programming Interfaces that allow the customer to write programs to obtain services of z/VM. |
MRIODFCS
PrologControl 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 V7R4.0.
Last updated on 04 September 2025 at 19:14:05.
Copyright IBM Corporation, 1990, 2025