Programming Interface Information:
The Monitor Records are intended Programming Interfaces that allow the customer to write programs to obtain services of z/VM. |
MRIODFCD
PrologControl 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