Programming Interface Information:
This information is NOT intended to be
used as Programming Interfaces of z/VM.

NCABK

Prolog  

Control Block Contents  
   NCABK DSECT

Storage Layout  

Cross Reference (Contains links to field and bit definitions)  


NCABK Prolog

 NAME       : HCPNCABK
 DESCRIPTION: Network Card Accounting Block.
 DSECT      : NCABK
 FUNCTION   :
              This structure contains accounting information for
              a fully-simulated Network Interface Card (NIC).
 LOCATED BY :
              NICNCABK - Pointer to NCABK (when accounting is enabled)
 CREATED BY :
              COUPLE processing when the adapter is connected to a
              VM LAN segment with ACCOUNTING enabled.
              SET LAN processing when the adapter is connected to a
              VM LAN segment for which ACCOUNTING is being enabled.
 DELETED BY :
              UNCOUPLE processing when the adapter is disconnected
              from a VM LAN segment with ACCOUNTING enabled.
              SET LAN processing when the adapter is connected to a
              VM LAN segment for which ACCOUNTING is being disabled.
 REFERENCES : none.
 SERIALIZED :
              Adapter Counter Lock (NICCTRLK) must be held EXCLUSIVE
              to update these fields.
              Adapter Counter Lock (NICCTRLK) must be held SHARED
              to safely reference these fields.
 RELOCATION CONSIDERATIONS : None
 COMPATIBILITY AND MIGRATION CONCERNS : None.
 GENERAL NOTES      :

 

NCABK Control Block Content


NCABK DSECT

Hex   Dec Type/Val   Lng Label (dup)    Comments
---- ---- --------- ---- -------------- --------
0000    0 Structure      NCABK          Network Card Accounting Block.
      Linkage to associated structures.
0000    0 Address      4 NCANICBK       Pointer to NICBK (adapter)
0004    4 Address      4 NCALANBK       Pointer to LANBK (network)
      TOD Clock Value when first connected to the LAN
0008    8 Dbl-Word     8 NCACONN        Connection TOD Clock
      Counters reside in this area.
0010   16 Dbl-Word     8 NCACTRS (0)    Begin counters
      Count Unicast bytes exchanged with a NON-ROUTER.
0010   16 Dbl-Word     8 NCATXUCN       Bytes Sent to a Non-Router
0018   24 Dbl-Word     8 NCARXUCN       Bytes Received from a Non-Router
      Count Unicast bytes exchanged with a designated ROUTER.
        Note that the presence of the NETROUTER user directory
        option designates the user as a "ROUTER" for this
        purpose.
0020   32 Dbl-Word     8 NCATXUCR       Bytes Sent to a Router
0028   40 Dbl-Word     8 NCARXUCR       Bytes Received from a Router
      Count Multicast bytes exchanged.
0030   48 Dbl-Word     8 NCATXMC        Bytes Sent via Multicast
0038   56 Dbl-Word     8 NCARXMC        Bytes Received via Multicast
      Count Broadcast bytes exchanged.
0040   64 Dbl-Word     8 NCATXBC        Bytes Sent via Broadcast
0048   72 Dbl-Word     8 NCARXBC        Bytes Received via Broadcast
      Count Unicast Non-Router packets exchanged with the LAN.
0050   80 Signed       4 NCATXUPK       Unicast Packets Sent
0054   84 Signed       4 NCARXUPK       Unicast Packets Received
      Count Unicast Router packets exchanged with the LAN.
0058   88 Signed       4 NCATXRPK       Router Packets Sent
005C   92 Signed       4 NCARXRPK       Router Packets Received
      Count Multicast packets exchanged with the LAN.
0060   96 Signed       4 NCATXMPK       Multicast Packets Sent
0064  100 Signed       4 NCARXMPK       Multicast Packets Received
      Count Broadcast packets exchanged with the LAN.
0068  104 Signed       4 NCATXBPK       Broadcast Packets Sent
006C  108 Signed       4 NCARXBPK       Broadcast Packets Received
      End of NCACTRS area.
          00000060       NCACTRLN       *-NCACTRS Length of counter area
      End of Structure.
          00FFFF90       NCABKLN        NCABK-* Length in bytes
          0000000E       NCABKSZ        (*-NCABK+7)/8 Size in double
                                        words

 

NCABK Storage Layout

          
*** NCABK - Network Card Accounting Block.
*
*     +---------------------------+---------------------------+
*   0 |         NCANICBK          |         NCALANBK          |
*     +---------------------------+---------------------------+
*   8 |                       NCACONN                         |
*     +-------------------------------------------------------+
*  10 |                       NCATXUCN                        |
*     +-------------------------------------------------------+
*  18 |                       NCARXUCN                        |
*     +-------------------------------------------------------+
*  20 |                       NCATXUCR                        |
*     +-------------------------------------------------------+
*  28 |                       NCARXUCR                        |
*     +-------------------------------------------------------+
*  30 |                       NCATXMC                         |
*     +-------------------------------------------------------+
*  38 |                       NCARXMC                         |
*     +-------------------------------------------------------+
*  40 |                       NCATXBC                         |
*     +-------------------------------------------------------+
*  48 |                       NCARXBC                         |
*     +---------------------------+---------------------------+
*  50 |         NCATXUPK          |         NCARXUPK          |
*     +---------------------------+---------------------------+
*  58 |         NCATXRPK          |         NCARXRPK          |
*     +---------------------------+---------------------------+
*  60 |         NCATXMPK          |         NCARXMPK          |
*     +---------------------------+---------------------------+
*  68 |         NCATXBPK          |         NCARXBPK          |
*     +---------------------------+---------------------------+
*  70
*
*** NCABK - Network Card Accounting Block.

 

NCABK Cross Reference

Symbol         Dspl Value
-------------- ---- -----
NCABKLN        006C 00FFFF90
NCABKSZ        006C 0000000E
NCACONN        0008
NCACTRLN       006C 00000060
NCACTRS        0010
NCALANBK       0004
NCANICBK       0000
NCARXBC        0048
NCARXBPK       006C
NCARXMC        0038
NCARXMPK       0064
NCARXRPK       005C
NCARXUCN       0018
NCARXUCR       0028
NCARXUPK       0054
NCATXBC        0040
NCATXBPK       0068
NCATXMC        0030
NCATXMPK       0060
NCATXRPK       0058
NCATXUCN       0010
NCATXUCR       0020
NCATXUPK       0050

This information is based on z/VM V6R2.0. Last updated on 21 Nov 2011 at 11:11:25 EDT.
Copyright IBM Corporation, 1990, 2011