Programming Interface Information:
The Monitor Records are intended Programming Interfaces that
allow the customer to write programs to obtain services of z/VM.
Control Block Contents
DSECT NAME - ISFNOD FUNCTION - Map a Monitor record. LOCATED BY - Through the Monitor Control Area REFERENCED CONTROL BLOCKS - MRRECHDR Monitor Record Header NAME - MRISFNOD DESCRIPTIVE NAME - Monitor Sample Record Domain 9 - ISFC Domain Record 4 - ISFC Logical Link Activity DESCRIPTION - Writes a sample record to record activity for an ISFC logical link. NOTES - 1. This record counts ISFC logical link traffic in two sets of counters. The two counter sets distinguish between two distinct kinds of traffic: 1a. 'Local' traffic, whose origin or destination is the local node, and 1b. 'Forwarded' traffic, which is traffic that the local node is merely forwarding, or relaying, on behalf of other nodes in the collection. 2. ISFC links handle two distinct types of traffic: 2a. "Legacy" traffic, which largely speaking is APPC/VM or IUCV traffic. 2b. ISFC transport traffic. One example of this is traffic related to guest relocations. 3. Legacy traffic that flows on a logical link is ALWAYS counted in the logical link's local-traffic counters (_LNKLR* and _LNKLS*), no matter what the origin node or destination node of the legacy traffic might be. 4. ISFC transport traffic whose origin was this system and which is transmitted out a logical link is counted in the logical link's local-traffic-sent counters (_LNKLS*). 5. ISFC transport traffic whose destination is this system and which is received on a logical link is counted in the logical link's local-traffic-received counters, (_LNKLR*). 6. ISFC transport traffic whose origin was some other system and which is transmitted out a logical link is counted in the logical link's forwarded-traffic-sent counters (_LNKFS*). 7. ISFC transport traffic whose destination is some other system and which is received on a logical link is counted in the logical link's forwarded-traffic-received counters (_LNKFR*). 8. If a sample cannot be obtained due to lock contention, a single D9R4 record will be generated with ISFNOD_NODEID set to "********"
MRISFNOD Control Block Contents
Offsets Dec Hex Type Len Name (Dim) Description 0 0 Structure 304 ISFNOD Start of monitor record 0 0 Character 0 ISFNOD_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 ISFNOD_NODEID The node on the other end of this logical link. 28 1C Character 8 ISFNOD_LNKLRCMS Messages received on this link destined for this system. 36 24 Character 8 ISFNOD_LNKLRCBT Bytes received on this link destined for this system. 44 2C Character 8 ISFNOD_LNKLSNMS Messages sent on this link originating from this system. 52 34 Character 8 ISFNOD_LNKLSNBT Bytes sent on this link originating from this system. 60 3C Character 8 ISFNOD_LNKFRCMS Messages received on this link and retransmitted on another link. 68 44 Character 8 ISFNOD_LNKFRCBT Bytes received on this link and retransmitted on another link. 76 4C Character 8 ISFNOD_LNKFSNMS Messages sent on this link that came in on another link. 84 54 Character 8 ISFNOD_LNKFSNBT Bytes sent on this link that came in on another link. 92 5C Character 8 ISFNOD_LNKDRCMS Messages received on this link with an unknown node as the destination. 100 64 Character 8 ISFNOD_LNKDRCBT Bytes received on this link with an unknown node as the destination. 108 6C Character 8 * Reserved and no longer valid. 116 74 Character 8 * Reserved and no longer valid. 124 7C Unsigned 2 ISFNOD_LNKDEVCT Count of link devices making up the logical link. 126 7E Unsigned 2 * Reserved 128 80 Unsigned 4 ISFNOD_LNKTX_PENDCT Work units waiting for a link to be available so they can be sent. 132 84 Unsigned 4 ISFNOD_LNKTX_THRCT Count of the number of times the link had to start throttling threads on the sending side 136 88 Unsigned 4 ISFNOD_LNKTQ_QUECTR Messages queued waiting to be processed. 140 8C Unsigned 2 * Reserved and no longer valid. 142 8E Unsigned 2 ISFNOD_LNKRX_CTR Work units that were received in the wrong order, in the queue 144 90 Unsigned 4 ISFNOD_LNKRXTHR Count of the number of times the receiving side got throttled due to storage. 148 94 Character 8 ISFNOD_LNKCT_WRDATA Count of the write opera- tions started for the logical link. 156 9C Character 8 ISFNOD_LNKCT_RDDATA Count of the read operat- tions started for the logical link. 164 A4 Character 8 ISFNOD_LNKCT_WRCOLL Count of the write collisions experienced on the logical link. 172 AC Character 8 * Reserved for IBM use. 180 B4 Character 8 ISFNOD_LNKCT_TXIMMED Count of the packages sent in an I/O operation other than the I/O that sent their control data, but on the same link device. 188 BC Character 8 ISFNOD_LNKCT_RXIMMED Count of the packages received in an I/O opera- tion other than the I/O that received their control data, but on the same link device. 196 C4 Character 8 ISFNOD_LNKCT_TXASYNC Count of the packages sent in an I/O operation other than the I/O that sent their control data, and not tied to the same link device. 204 CC Character 8 ISFNOD_LNKCT_RXASYNC Count of the packages received in an I/O opera- tion other than the I/O that received their control data, and not tied to the same link device. 212 D4 Character 8 ISFNOD_LNKCT_TXIMBED Count of the packages sent in the same I/O operation that sent their control data. 220 DC Character 8 ISFNOD_LNKCT_RXIMBED Count of the packages received in the same I/O operation that received their control data. 228 E4 Character 8 ISFNOD_LNKTX_PNDBYTES Sample of the number of bytes waiting to be sent on the logical link. 236 EC Character 8 ISFNOD_LNKHW_PNDBYTES The highest value since system IPL for the sample of the number of bytes waiting to be sent on the logical link. 244 F4 Character 4 ISFNOD_LNKTX_ASYNCCT The number of times I/O operations switched into asynchronous mode to avoid a storage overrun problem on the target system. 248 F8 Character 4 ISFNOD_LNKTX_DEVCT The number of devices in the logical link assigned to write opera- tions. 252 FC Character 4 ISFNOD_LNKRX_DEVCT The number of devices in the logical link assigned to read opera- tions. 256 100 Character 8 ISFNOD_NODXSYTO An estimate of the difference between the local system's time-of-day clock and the remote system's time-of-day clock, if the node on the other end of this logical link is a member of the same SSI cluster. 264 108 Character 8 ISFNOD_NODXRTMY The round-trip time for the message exchange used to create the ISFNOD_NODXSYTO estimate, if the node on the other end of this logical link is a member of the same SSI cluster. 272 110 Character 8 ISFNOD_NODXTOPT The remote system's estimate of ISFNOD_NODXSYTO for the local system, if the node on the other end of this logical link is a member of the same SSI cluster. 280 118 Unsigned 4 ISFNOD_LNKRXOOO Cumulative count of the work units that were received in the wrong order. 284 11C Unsigned 4 ISFNOD_LNKMBBHW The highest value since the last sample for the number of buffers in use for the link's managed buffer set. 288 120 Unsigned 4 ISFNOD_LNKMBBMAX Cardinal count of the maximum number of buffers that can be allocated by this managed buffer set. 292 124 Unsigned 4 ISFNOD_LNKMBBINIT Initial requested value for the number of buffers to allocate for this managed buffer set. 296 128 Unsigned 4 ISFNOD_LNKTX_WAITSNT Cumulative count of the number of packages for which control data has been sent not tied to the same link device. 300 12C Unsigned 4 ISFNOD_LNKCAPCT Cumulative count of the number of not-full packages closed due to time-out. 304 130 Character 0 ISFNOD_END
MRISFNOD Cross Reference
Hex Hex Name Offset Length Value ISFNOD 0 304 ISFNOD_END 130 0 ISFNOD_LNKCAPCT 12C 4 ISFNOD_LNKCT_RDDATA 9C 8 ISFNOD_LNKCT_RXASYNC CC 8 ISFNOD_LNKCT_RXIMBED DC 8 ISFNOD_LNKCT_RXIMMED BC 8 ISFNOD_LNKCT_TXASYNC C4 8 ISFNOD_LNKCT_TXIMBED D4 8 ISFNOD_LNKCT_TXIMMED B4 8 ISFNOD_LNKCT_WRCOLL A4 8 ISFNOD_LNKCT_WRDATA 94 8 ISFNOD_LNKDEVCT 7C 2 ISFNOD_LNKDRCBT 64 8 ISFNOD_LNKDRCMS 5C 8 ISFNOD_LNKFRCBT 44 8 ISFNOD_LNKFRCMS 3C 8 ISFNOD_LNKFSNBT 54 8 ISFNOD_LNKFSNMS 4C 8 ISFNOD_LNKHW_PNDBYTES EC 8 ISFNOD_LNKLRCBT 24 8 ISFNOD_LNKLRCMS 1C 8 ISFNOD_LNKLSNBT 34 8 ISFNOD_LNKLSNMS 2C 8 ISFNOD_LNKMBBHW 11C 4 ISFNOD_LNKMBBINIT 124 4 ISFNOD_LNKMBBMAX 120 4 ISFNOD_LNKRX_CTR 8E 2 ISFNOD_LNKRX_DEVCT FC 4 ISFNOD_LNKRXOOO 118 4 ISFNOD_LNKRXTHR 90 4 ISFNOD_LNKTQ_QUECTR 88 4 ISFNOD_LNKTX_ASYNCCT F4 4 ISFNOD_LNKTX_DEVCT F8 4 ISFNOD_LNKTX_PENDCT 80 4 ISFNOD_LNKTX_PNDBYTES E4 8 ISFNOD_LNKTX_THRCT 84 4 ISFNOD_LNKTX_WAITSNT 128 4 ISFNOD_MRHDR 0 0 ISFNOD_NODEID 14 8 ISFNOD_NODXRTMY 108 8 ISFNOD_NODXSYTO 100 8 ISFNOD_NODXTOPT 110 8 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 5 Oct 2016 at 14:51:39.
Copyright IBM Corporation, 1990, 2016