Programming Interface Information: The Monitor Records are intended Programming Interfaces that allow the customer to write programs to obtain services of z/VM.

#### MRISFNOD

Prolog
Control Block Contents
Cross Reference

#### MRISFNOD Prolog

     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 V7R2.0.

    Last updated on 08 August 2020 at 21:40:39.

    Copyright IBM Corporation, 1990, 2020