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 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 V7R3.0.
Last updated on 09 September 2022 at 14:52:05.
Copyright IBM Corporation, 1990, 2022