NAME       : HCPNICBK
 DESCRIPTION: Virtual Network Interface Card block
 DSECT      : NICBK
 FUNCTION   :
              Define a structure to represent a Network Interface
              Card.  One NICBK exists for each Virtual Adapter.
              Each NICBK is associated with a set of Virtual
              Network Interface Devices (VDEV/NIDBK).
 LOCATED BY -
   VDEVNIC  = Pointer to owning adapter NICBK
   NIDNICBK = Pointer to owning adapter NICBK
   LNKNICHD = Pointer to chain of coupled adapter NICBK
 CREATED BY :
              CP DEFINE command processing (module HCPVDB)
 DELETED BY :
              CP DETACH command processing (module HCPVDB)
 REFERENCES :
              HCPDVTYP COPY - Specific device types
              HCPEQUAT COPY - General CP equates
 RELOCATION CONSIDERATIONS : None
 COMMENTS   :
              - Exist in the system execution space.
              - Not known by Hardware.
              - See Serialization comments in the Assembler section.

 NICBK DSECT
Top of page

Hex   Dec Type/Val   Lng Label (dup)    Comments
---- ---- --------- ---- -------------- --------
0000    0 Structure      NICBK          Virtual Network Interface Card block
      Static Area -
        The fields in this area are relatively constant.
        They are initialized when the adapter (NIC) is
        created, and may be referenced with minimal
        serialization (just enough to be sure your pointer
        to the NICBK is valid).
0000    0 Character    8 NICDESC        NIC Description (e.g. HIPER)
0008    8 Bitstring   10 NICOWNBS (0)   NIC Owner fields
0008    8 Character    8 NICOWNER       NIC Owner VM Userid
0010   16 Signed       2 NICBASE        NIC Base Virtual Device Address
0012   18 Signed       2 NICLAST        NIC Last Virtual Device Address
0014   20 Signed       2 NICDEVS        NIC Device Count
0016   22 Bitstring    1 NICTYPE        Network Device Type
          00000001       NICHIPR        1 NICHIPR HiperSockets adapter
                                        type
          00000002       NICQDIO        2 NICQDIO QDIO adapter type
          00000003       NICVSW         3 NICVSW QDIO adapter for
                                        physical UPLINK or VSwitch MAC
                                        Management NIC
          00000006       NICBRIDG       6 NICBRIDG IQD adapter for a
                                        Bridge Port
0017   23 Bitstring    1 NICTRANP       Transport type
          00000001       NICIP          1 NICIP Layer 3 IP datagrams
          00000002       NICETHER       2 NICETHER Layer 2 Ethernet
                                        frames
          00000003       NICUNKWN       3 NICUNKWN Unknown NIC type -
                                        never coupled
0018   24 Bitstring    2 NICCUTYP       Simulated Control Unit Type
001A   26 Bitstring    1 NICCUMDL       Simulated Control Unit Model
001B   27 Bitstring    2 NICDVTYP       Simulated Device Type
001D   29 Bitstring    1 NICDVMDL       Simulated Device Model
001E   30 Bitstring    1 NICCHPTP       CHPID type for this adapter
001F   31 Bitstring    1 NICCHPID       CHPID for this adapter
0020   32 Address      4 NICVDEV        Host logical Addr of Base VDEV
0024   36 Signed       4 NICMFS         MFS (bytes) for current LAN
0028   40 Bitstring    6 NICMAC         MAC Address for this adapter
002E   46 Bitstring    2 NICTKUID       Latest unique token id
0030   48 Address      4 NICTKLST       List of Unique Tokens HL @ of
                                        chain of TKNBKs (See HCPIPY)
      NICVLANS represents the Authorized VID set.
        When NICVLANS==NULL it means the switch simulation
          does not restrict the virtual NIC to any specific
          VID set.
          This also would be the case for a Logical Guest Port
          used to represent a guest on the HiperSockets Bridge.
        When NICVLANS==nonzero it points to the DVLHEAD
          structure representing the Authorized VID set for
          this virtual NIC on this virtual switch.
0034   52 Address      4 NICVLANS       Pointer to list of VLAN groups
0038   56 Signed       2 NICVLCTR       Size of Authorized VID set
003A   58 Signed       2 NIC_VIDINST    Authorized VLAN instance
003C   60 Address      4 NICVLCPT       Ptr to cached VLCBKs (VLCCACHE)
      NIC Adapter Lock -
      Notes      : LKWRDSIZ == 3 doublewords.
0040   64 Dbl-Word     8 NICLKWRD (3)   Adapter Lockword
      Adapter Management Area -
        The fields in this area are used in the normal
        operation of the adapter (NIC).  In general,
        these fields are serialized by the NIC Adapter Lock:
        - Hold NICLKWRD EXCLUSIVE to update
        - Hold NICLKWRD SHARED to reference
      NICRFCTR is used to protect the NICBK over a stacked call.
      - NICRFCTR is updated using Compare and Swap (CS) logic.
      - NICLKWRD (Shared or Exclusive) must be held to update
        NICRFCTR.
      - The code that intends to initiate a deferred (stacked)
        call must increment NICRFCTR (using CS logic).
      - The code that is dispatched asynchronously should
        perform the following steps:
        (1) Obtain NICLKWRD (Shared or Exclusive)
        (2) Decrement NICRFCTR (using CS logic).
        (3) If NICDLPRG=1 (Delete in Progress),
               If NICRFCTR = 0,
                  Obtain NICLKWRD Exclusive (see HCPLCKSX).
                  Call HCPNICDX to Destroy this NICBK.
                  Exit without attempting to release NICLKWRD.
               If NICRFCTR > 0,
                  Release NICLKWRD and exit.
0058   88 Signed       4 NICRFCTR       Outstanding Reference count
005C   92 Bitstring    1 NICCFLG        Adapter Configuration flags
          1... ....      NICINPRG       X'80' NICINPRG Initialization in
                                        Progress
          .1.. ....      NICDLPRG       X'40' NICDLPRG Delete in Progress
          ..1. ....      NICCNLAN       X'20' NICCNLAN Connected to a
                                        SYSTEM LAN
          ...1 ....      NICPVLAN       X'10' NICPVLAN Connected to a
                                        PRIVATE LAN
          .... 1...      NICREADY       X'08' NICREADY LAN READY
          .... .1..      NICROUTR       X'04' NICROUTR NETROUTER is set
                                        (USER DIRECT)
          .... ..1.      NICPAUT        X'02' NICPAUT Promiscuous Mode
                                        Authority
          .... ...1      NICLGLAN       X'01' NICLGLAN Connected as a
                                        LOGICAL Guest Port (HiperSockets)
005D   93 Bitstring    1 NICVLFLG       VLAN attribute flags
          1... ....      NICVLGBL       X'80' NICVLGBL Global VLAN
                                        (NICPVID) is set
          .1.. ....      NICVLUSR       X'40' NICVLUSR User selects from
                                        NICVLANS list
          ..1. ....      NICVLFLT       X'20' NICVLFLT Filter by VID set
          ...1 ....      NICVLNON       X'10' NICVLNON No VLAN capability
005E   94 Signed       2 NICPVID        Port VLAN ID
0060   96 Address      4 NICNIDHD       Host logical address of the first
                                        NIDBK, chained by NIDFPNT/NIDBPNT
0064  100 Address      4 NICNIDTL       HL @ of the last NIDBK
0068  104 Signed       4 NICMGPOR (0)   Port number and ifIndex
0068  104 Signed       4 NICMGIFI       Alternate label
006C  108 Signed       4 NICRPORT       Requested port for couple
0070  112 Address      4 NICMSVBK       Pointer to NICBASE MSVBK Once set
                                        this is not cleared
      Device Specific Area -
0074  116 Bitstring    1 NICQDFMT       QDIO Queue Format
0075  117 Bitstring    1 NICVPORT       Virtual Port attributes
          00000000       NICVPORT_NONE  0 NICVPORT_NONE = Disabled
          00000001       NICVPORT_ACCESS
                                        1 NICVPORT_ACCESS = Access Port
                                        (untagged)
          00000002       NICVPORT_TRUNK 2 NICVPORT_TRUNK = Trunk Port
                                        (tagged or mix
0076  118 Bitstring    1 NICAFLG        Authorization flags
          1... ....      NICAUTHX       X'80' NICAUTHX Authorized by the
                                        ESM
          .1.. ....      NICUSRPN       X'40' NICUSRPN User-defined
                                        PORTNUMBER set
0077  119 Bitstring    9 NICADPTK (0)   Adapter Name : Length||Token
0077  119 Bitstring    1 NICADPNL       Length of NICADPNM Token
0078  120 Character    8 NICADPNM       Adapter Name Token
0080  128 Signed       4 NICMPCCT       Count of established MPC groups
0084  132 Address      4 NICMPCHD       Host logical address of the first
                                        MPCBK, chained by MPCNEXT/MPCPREV
0088  136 Address      4 NICMPCTL       HL @ of the last MPCBK
008C  140 Signed       2 NICMAXIQ       Maximum INPUT Queues per MPC
008E  142 Signed       2 NICMAXOQ       Maximum OUTPUT Queues per MPC
0090  144 Signed       2 NICIPMAX       IP Table Limit for this adapter
0092  146 Signed       2 NICIPCTR       IP Table Count for this adapter
0094  148 Bitstring   16 NICDEFIP       Default IP Address (accounting)
00A4  164 Signed       2 NICLLMAX       IP Table Limit for this adapter
00A6  166 Signed       2 NICLLCTR       IP Table Count for this adapter
00A8  168 Address      4 NICPROM        Pointer to the NIDBK in PROMISC
00AC  172 Bitstring    1 NICPPCNT       Maximum number of ports
00AD  173 Bitstring    1 NICPPORT       Configured port number
00AE  174 Bitstring    1 NICLFLG        SSI LGR Relocation flags
          1... ....      NICLGRGA       X'80' NICLGRGA - Grat ARP needed
                                        after SETVMAC
00AF  175 Bitstring    1 NICPFLG        Processing Flags
          1... ....      NICACTIV       X'80' NICACTIV UpLink Port is
                                        Still Active
          .1.. ....      NICIVLPT       X'40' NICIVLPT IVL NIC Port
          ..1. ....      NICPFTKO       X'20' NICPFTKO Take-Over Pseudo
                                        NIC Port
          .... ...1      NICSPCPT       X'01' NICSPCPT Special Data
                                        Transfer Port
00B0  176 Bitstring    2 *              Reserved for future IBM use
      LGR level/version (NICLGRLV)
       Contains the level of the source LGRVDEV data when this
       NIC is the subject of a relocation.  See also LGRVDEV COPY
       which describes which fields are relevant at each version.
       Valid when VMDRLFLG bits VMDRLINP+VMDRLOIB are on.
       NICLGRLV was first stored with PITS 2U05379 after PITS
       2U04209 defined Version 2.
         $VDEV_VER = 2 indicates the following fields are passed
         to the target:
           NICVLANS
           NICVLCTR
           NICPVID
           NICVPORT
           LANVLFLT
00B2  178 Signed       2 NICLGRLV       Source (NIC)VDEV LGR data version
00B4  180 Signed       4 *              Reserved for Future IBM Use
      LAN Management Area -
        The fields in this area are used to connect the
        adapter (NIC) to a Virtual LAN.
        To connect or disconnect this adapter (NIC) to/from
        a Virtual LAN, the following locks must be obtained
        (in this sequence):
        - The LAN Lock (LANLKWRD) EXCLUSIVE
        - The NIC Adapter Lock (NICLKWRD) EXCLUSIVE
        To reference these fields (e.g. while following
        the chain) you only need to hold LANLKWRD SHARED.
        - Access to the field NICNCABK and the contents of
          the NCABK are serialized by the NICCTRLK.
00B8  184 Dbl-Word     8 NICPTRS (0)    L:NICBK Pointers
00B8  184 Address      4 NICFPNT        NEXT L:NICBK on the List
00BC  188 Address      4 NICBPNT        PREV L:NICBK on the List
00C0  192 Signed       4 *              Reserved for Future IBM Use
00C4  196 Address      4 NICLANBK       Host logical address of the
                                        associated LANBK. If NICCNLAN=1
                                        this is a System LAN. Otherwise
                                        this is the PRIVATE LAN that
                                        represents a disconnected
                                        adapter.
00C8  200 Address      4 NICSIGA        SIGA Simulation routine Linkage:
                                        HCPCALL R15 Input/Output: Like
                                        HCPIQQWR TMODEAR or TMODESTD
00CC  204 Address      4 NICNCABK       Host logical address of the NCABK
00D0  208 Address      4 NICESMVL       ESM VLAN List Pointer
      Adapter Router entries.
00D4  212 Address      4 NICRXTBL       Pointer to IPNBK(Router) list
00D8  216 Signed       2 NICRXCTR       Count of Router entries
      Pending TX Counter Update
      This field is serialized by the Test and Set Instruction.
00DA  218 Bitstring    1 NICTXPND       TX Counter Update Pending x'00' :
                                        Not Pending x'FF' : Counter
                                        Update Pending
      PQUPLINKTX priority assigned to this NIC
      Notes      : For performance reasons, the values of NICTXUPL must
            be muliples of the size of each entry (NIDXSIZE) in
            the NID Transmission Queue Array (NIDTRANS).
00DB  219 Bitstring    1 NICTXUPL       Uplink TX Priority for this NIC
          00000000       NICTXCP        0 NICTXCP Queue 0 z/VM (CP use)
          00000010       NICTXHI        16 NICTXHI Queue 1 High (Guest
                                        use)
          00000010       NICTXRCV       16 NICTXRCV Queue 1 IVL Recovery
          00000020       NICTXNM        32 NICTXNM Queue 2 Normal (Guest
                                        use)
          00000030       NICTXLO        48 NICTXLO Queue 3 Low (Guest
                                        use)
          00000030       NICTXLST       NICTXLO NICTXLST Last Valid
                                        Output Queue Index
00DC  220 Address      4 NICVRTBK       VSWITCH Routing Table
      Adapter Counter LKWRD.
         The adapter counter lock word serializes the field
         NICNCABK, the contents of the NCABK, and the adapter
         counters (starting with NICCTRS).
         This lock also serializes the NICCCLBK pointer and the
         contents of the CCLBK.
      Notes      : LKWRDSIZ == 3 doublewords.
00E0  224 Dbl-Word     8 NICCTRLK (3)   Adapter Counter Lockword
      NICCCLBK is a pointer to the Counters Clear Block CCLBK.
      This control block is created when SET VSWITCH COUNTERS
      CLEAR {DATA|ERRORS|DISCARDED|ALL} is called.
      The control block contains timestamps for DATA, ERRORS
      and DISCARDED.  It also contains delta values for the
      counter values (errors, discarded, transmitted packets,
      transmitted bytes, received packets and received bytes).
      The delta values will be used when calculating
      the correct values to be displayed by the QUERY commands.
      This pointer and the CCLBK structure are serialized by
      the Adapter Counter Lockword (NICCTRLK).
00F8  248 Address      4 NICCCLBK       Pointer to CCLBK-Counters clear
      Adapter Counters
0100  256 Dbl-Word     8 NICCTRS (0)    Start of NICBK counters
      The following set of counters are used to keep track of a
      specific port's attempt to acquire key locks or queue work
      in the main line data transfer path.  In addition to
      keeping track of the lock requests, a corresponding
      counter will indicate the number of times the port had to
      wait to perform the function.
      The following information is kept on a per port basis,
      including both real and virtual guest LAN ports:
        LANBK (LANLKWRD) lock requests sending or receiving data.
        NICBK (NICLKWRD) lock requests when sending data to
                        another port.
        NICBK (NICLKWRD) lock requests when receiving data from
                        another port.
        Queueing and removing work (NDMBKs) on a target's port
0100  256 Dbl-Word     8 NIC_LOCKREQS   LANBK lock request
0108  264 Dbl-Word     8 NIC_LANDEFER   LANBK lock deferrals
0110  272 Dbl-Word     8 NIC_TXREQS     NICBK lock requests sending data
0118  280 Dbl-Word     8 NIC_TXDEFERS   NICBK lock deferrals sending data
0120  288 Dbl-Word     8 NIC_RXREQS     NICBK lock requests receiving
                                        data
0128  296 Dbl-Word     8 NIC_RXDEFERS   NICBK lock deferrals receiving
                                        data
0130  304 Dbl-Word     8 NIC_STKREQS    Number of times we queued work on
                                        a target port
0138  312 Dbl-Word     8 NIC_STKDEFERS  Times it took multiple attempts
                                        to queue work on a target port
0140  320 Dbl-Word     8 NIC_SESRXPCI   Count of PCI (or AIF) events
                                        reflected for input queues.
0148  328 Dbl-Word     8 NIC_SESTXPCI   Count of PCI (or AIF) events
                                        reflected for output queues.
      Adapter Transmit and Receive Counters
      Counters are maintained on a queue basis - one set for
      Transmit (output) and one set for Receive (input).
      The number of input and output queues can vary based
      on the port represented by this NIC.
      Most ports will have 1 input queue and 1 output queue.
      A UPLINK device will have 1 input queue and either 1, 2,
      or 4 output queues.
      If a VSwitch is configured for PRIQUEUING ON and the
      UPLINK device has PQ_ON, then 4 output queues are created.
      For the IVL VSwitch with PRIQUEUING ON and the device has
      PQ_ON, then 2 output queues are created.
      All other UPLINK devices will have 1 input queue and 1
      output queue.
     **** RECALL that the counters are maintained in the NICBK
     **** from the perspective of the simulated LAN segment. For
     **** an UPLINK NIC, this means it is the RX counters that
     **** represent the output queues.
      -- For simplicity sake, 1 set of NICTX counters and 4
      -- sets of NICRX counters are included/allocated here,
      -- although is only a VSwitch UPLINK device that will
      -- ever reference more than 1 NICRX set.
      The following counters have delta values saved in the
      Counters Clear Block (CCLBK).  See NICCCLBK above.
0150  336 Dbl-Word     8 NICTXCTS (0)   NICTX counters - 1 set per NIC
0150  336 Dbl-Word     8 NICTXBYT       Total Bytes Sent
0158  344 Dbl-Word     8 NICTXPKT (0)   TX Packets extracted
0158  344 Signed       4 NICTXPKTHI     - High half
015C  348 Signed       4 NICTXPKTLO     - Low half
0160  352 Dbl-Word     8 NICTXDSC (0)   TX Packets discarded
0160  352 Signed       4 NICTXDSCHI     - High half
0164  356 Signed       4 NICTXDSCLO     - Low half
0168  360 Dbl-Word     8 NICTXERR (0)   TX Bad Packets discarded
0168  360 Signed       4 NICTXERRHI     - High half
016C  364 Signed       4 NICTXERRLO     - Low half
0170  368 Dbl-Word     8 * (0)          Insure DW Alignment of Overlay
0170  368 Bitstring  128 NICRXCTS       NICRX counters - 1-4 sets per NIC
          000000F0       NICCTRLN       *-NICCTRS Length of NICBK
                                        counters
      Pointer to structure of vlan counters (VLCBK)
      Will contain:
      Pointer back to owning NICBK (A or AD)
      and 3 double word counters:
      # of Frames IN   (VLCIN)
      # of Frames OUT  (VLCOUT)
      # of Frames IN Discarded (VLCINDSC)
      # of Frames OUT Discarded (VLCOUTDC)
      For each VLAN (1-4094)
01F0  496 Dbl-Word     8 NICCTRVL (4)   Reserve a MLTBK here
0210  528 Bitstring    4 *              Reserved for IBM use
      DEDICATE_ADAPTER simulation.
0214  532 Bitstring    1 NICHWDED       DEDICATE_ADAPTER status
          1... ....      NICHWDED_ON    X'80' NICHWDED_ON - Adapter is
                                        dedicated now
0215  533 Bitstring    1 *              Reserved for IBM use
0216  534 Signed       2 NICDEDUA       Unit Address (offset) of owner
0218  536 Bitstring    6 NICDEDMA       ExclusiveUsageMAC
021E  542 Bitstring    2 *              Reserved for IBM use
0220  544 Bitstring    8 NICDEDID       ExclusiveUsageID
      Logical Guest Port Network Token
      This field is only valid for a bridge connected Logical
      Guest Port.  The Network Token is assigned by firmware.
0228  552 Dbl-Word     8 NICTOKEN (0)   Entire Network Token
0228  552 Signed       2 NICTDEV        Device Number
022A  554 Bitstring    1 NICTCSID       Channel Subsystem ID (CSSID)
022B  555 Bitstring    1 NICTIID        Image ID (IID)
022C  556 Bitstring    1 NICTSSID       Subchannel Set ID (SSID)
022D  557 Bitstring    1 NICTCHPI       CHPID Number (CHPID)
022E  558 Signed       2 NICTCHID       Channel ID (CHID)
      NICLG3DP and NICLG3DP_E are serialized by the BPBCFGLK and
      should be the only flags defined in NICLGFLG.
0230  560 Bitstring    1 NICLGFLG       Logical Guest Port flags
          1... ....      NICLG3DP       X'80' NICLG3DP - Used for
                                        resolving CHSC x'3D'
          .1.. ....      NICLG3DP_E     X'40' NICLG3DP_E - Used for
                                        resolving CHSC x'3D'
0231  561 Bitstring    5 *              Reserved for future IBM use
      NICBCFGC is a counter of the number of deferred
      changes for a HS Logical Guest Port.
      It is serialized by the BPBCFGLK which ensures only one
      Bridge Port Configuration change is being handled at a
      time and allows the safe increment/decrement of NICBCFGC
      without holding the NICLKWRD lock.
      This counter is used when deciding whether a Logical Guest
      Port can be removed when there are no longer any MACs or
      VLANs associated with the port.  If there are still pending
      changes (NICBCFGC>0) then new/additional MACs may be in the
      queue to be added and therefore the port should not be
      removed.  The counter should be incremented before stacking
      a call to HCPSWFNC to add/delete a MAC or VLAN for the HS
      logical guest port.  HCPSWFNC will decrement the count as
      it processes the change.
0236  566 Signed       2 NICBCFGC       Configuration Count
0238  568 Signed       4 *              Reserved for Future IBM Use
      Attributes from the NICDEF command.
        When NICDDCFG==1 NICDDNET contains the NICDEF LAN
        identification (owner||name) for an automatic
        connection to the network.
        When NICDDCFM==1 the NICDEF LAN configuration is
        mandatory (This virtual NIC can only couple to the
        configured network).
        When NICDDLAN==1 NICDDNET contains the LAN information
        (owner||name) from a SPECIAL/NICDEF statement.  This
        identifies the LAN (but does NOT authorize connection).
023C  572 Bitstring    1 NICDDFLG       Authorization flags
          1... ....      NICDDCFG       X'80' NICDDCFG NICDEF LAN is
                                        configured
          .1.. ....      NICDDCFM       X'40' NICDDCFM NICDEF LAN is
                                        mandatory
          ..1. ....      NICDDLAN       X'20' NICDDLAN LAN is named
                                        (NICDDNET*)
023D  573 Bitstring    3 *              Reserved for Future IBM Use
0240  576 Address      4 NICVNABK       Pointer to VNABK (from NICDEF)
0244  580 Bitstring   16 NICDDNET (0)   Configured network (owner||name)
0244  580 Character    8 NICDDNET_OWNER Configured network owner
024C  588 Character    8 NICDDNET_NAME  Configured network name
      End of the NICBK.
0258  600 Dbl-Word     8 NIC$END (0)    End of the NICBK structure
          00000258       NICBKLN        *-NICBK Length of NICBK in bytes
          0000004B       NICBKSZ        (*-NICBK+7)/8 Size of NICBK in
                                        doublewords
      NIC RX Array Entry
      An NIC representing an UPLINK can have 1, 2, or 4 sets of
      NICRX counters.  All other NICs have 1 set.
      To obtain the overall total of RX values, one needs to
      add up the 4 Array Entries.  If a queue is not used, the
      counters should be 0.
0170  368 Dbl-Word     8 NICRXBYT (0)   RX Bytes Received
0170  368 Signed       4 NICRXBYTHI     - High half
0174  372 Signed       4 NICRXBYTLO     - Low half
0178  376 Dbl-Word     8 NICRXPKT (0)   RX Packets received
0178  376 Signed       4 NICRXPKTHI     - High half
017C  380 Signed       4 NICRXPKTLO     - Low half
0180  384 Dbl-Word     8 NICRXDSC (0)   RX Packets discarded/overflow
0180  384 Signed       4 NICRXDSCHI     - High half
0184  388 Signed       4 NICRXDSCLO     - Low half
0188  392 Dbl-Word     8 NICRXERR (0)   RX Bad Packets discarded
0188  392 Signed       4 NICRXERRHI     - High half
018C  396 Signed       4 NICRXERRLO     - Low half
          00000020       NICRXSZB       *-NICRXBYT Length of NIC RX Array
                                        Entry
          00000000       NICRXSQ0       NICRXSZB*0 Queue 0 offset
          00000020       NICRXSQ1       NICRXSZB*1 Queue 1 offset
          00000040       NICRXSQ2       NICRXSZB*2 Queue 2 offset
          00000060       NICRXSQ3       NICRXSZB*3 Queue 3 offset
          00000004       NICRXMAX       4 Maximum number of NIC RX
                                        entries
          00000002       NICRXIVL       2 Number of NIC RX entries for
                                        IVL
      Define the DSECT for the VLCBK cache entries that are
      pointed to by NICVLCPT.

          
*** NICBK - Virtual Network Interface Card block
*
*     +-------------------------------------------------------+
*   0 |                       NICDESC                         |
*     +-------------------------------------------------------+
*   8 |                       NICOWNER                        |
*     +-------------+-------------+-------------+------+------+
*  10 |  NICBASE    |  NICLAST    |  NICDEVS    |:TYPE |:TRANP|
*     +-------------+------+------+------+------+------+------+
*  18 |  NICCUTYP   |:CUMDL|  NICDVTYP   |:DVMDL|:CHPTP|:CHPID|
*     +-------------+------+------+------+------+------+------+
*  20 |         NICVDEV           |          NICMFS           |
*     +---------------------------+-------------+-------------+
*  28 |                 NICMAC                  |  NICTKUID   |
*     +---------------------------+-------------+-------------+
*  30 |         NICTKLST          |         NICVLANS          |
*     +-------------+-------------+---------------------------+
*  38 |  NICVLCTR   |NIC_VIDINST  |         NICVLCPT          |
*     +-------------+-------------+---------------------------+
*  40 |                                                       |
*     =                       NICLKWRD                        =
*     |                                                       |
*     +---------------------------+------+------+-------------+
*  58 |         NICRFCTR          |:CFLG |:VLFLG|  NICPVID    |
*     +---------------------------+------+------+-------------+
*  60 |         NICNIDHD          |         NICNIDTL          |
*     +---------------------------+---------------------------+
*  68 |         NICMGIFI          |         NICRPORT          |
*     +---------------------------+------+------+------+------+
*  70 |         NICMSVBK          |:QDFMT|:VPORT|:AFLG |:ADPNL|
*     +---------------------------+------+------+------+------+
*  78 |                       NICADPNM                        |
*     +---------------------------+---------------------------+
*  80 |         NICMPCCT          |         NICMPCHD          |
*     +---------------------------+-------------+-------------+
*  88 |         NICMPCTL          |  NICMAXIQ   |  NICMAXOQ   |
*     +-------------+-------------+-------------+-------------+
*  90 |  NICIPMAX   |  NICIPCTR   |                           |
*     +-------------+-------------+                           |
*     |                       NICDEFIP                        |
*     |                           +-------------+-------------+
*  A0 |                           |  NICLLMAX   |  NICLLCTR   |
*     +---------------------------+------+------+------+------+
*  A8 |         NICPROM           |:PPCNT|:PPORT|:LFLG |:PFLG |
*     +-------------+-------------+------+------+------+------+
*  B0 |/////////////|  NICLGRLV   |///////////////////////////|
*     +-------------+-------------+---------------------------+
*  B8 |         NICFPNT           |         NICBPNT           |
*     +---------------------------+---------------------------+
*  C0 |///////////////////////////|         NICLANBK          |
*     +---------------------------+---------------------------+
*  C8 |         NICSIGA           |         NICNCABK          |
*     +---------------------------+---------------------------+
*  D0 |         NICESMVL          |         NICRXTBL          |
*     +-------------+------+------+---------------------------+
*  D8 |  NICRXCTR   |:TXPND|:TXUPL|         NICVRTBK          |
*     +-------------+------+------+---------------------------+
*  E0 |                                                       |
*     =                       NICCTRLK                        =
*     |                                                       |
*     +---------------------------+---------------------------+
*  F8 |         NICCCLBK          |///////////////////////////|
*     +---------------------------+---------------------------+
* 100 |                     NIC_LOCKREQS                      |
*     +-------------------------------------------------------+
* 108 |                     NIC_LANDEFER                      |
*     +-------------------------------------------------------+
* 110 |                      NIC_TXREQS                       |
*     +-------------------------------------------------------+
* 118 |                     NIC_TXDEFERS                      |
*     +-------------------------------------------------------+
* 120 |                      NIC_RXREQS                       |
*     +-------------------------------------------------------+
* 128 |                     NIC_RXDEFERS                      |
*     +-------------------------------------------------------+
* 130 |                     NIC_STKREQS                       |
*     +-------------------------------------------------------+
* 138 |                    NIC_STKDEFERS                      |
*     +-------------------------------------------------------+
* 140 |                     NIC_SESRXPCI                      |
*     +-------------------------------------------------------+
* 148 |                     NIC_SESTXPCI                      |
*     +-------------------------------------------------------+
* 150 |                       NICTXBYT                        |
*     +---------------------------+---------------------------+
* 158 |        NICTXPKTHI         |        NICTXPKTLO         |
*     +---------------------------+---------------------------+
* 160 |        NICTXDSCHI         |        NICTXDSCLO         |
*     +---------------------------+---------------------------+
* 168 |        NICTXERRHI         |        NICTXERRLO         |
*     +---------------------------+---------------------------+
* 170 |                                                       |
*     =                       NICRXCTS                        =
*     |                                                       |
*     +-------------------------------------------------------+
* 1F0 |                                                       |
*     =                       NICCTRVL                        =
*     |                                                       |
*     +---------------------------+------+------+-------------+
* 210 |///////////////////////////|:HWDED|//////|  NICDEDUA   |
*     +---------------------------+------+------+-------------+
* 218 |                NICDEDMA                 |/////////////|
*     +-----------------------------------------+-------------+
* 220 |                       NICDEDID                        |
*     +-------------+------+------+------+------+-------------+
* 228 |  NICTDEV    |:TCSID|:TIID |:TSSID|:TCHPI|  NICTCHID   |
*     +------+------+------+------+------+------+-------------+
* 230 |:LGFLG|//////////////////////////////////|  NICBCFGC   |
*     +------+--------------------+------+------+-------------+
* 238 |///////////////////////////|:DDFLG|////////////////////|
*     +---------------------------+------+--------------------+
* 240 |         NICVNABK          |     NICDDNET_OWNER-       |
*     +---------------------------+---------------------------+
* 248 |          -(244)           |      NICDDNET_NAME-       |
*     +---------------------------+---------------------------+
* 250 |          -(24C)           |///////////////////////////|
*     +---------------------------+---------------------------+
*
*** NICBK - Virtual Network Interface Card block
          
*** Overlay for ORG in NICBK
*
*     +---------------------------+---------------------------+
* 170 |        NICRXBYTHI         |        NICRXBYTLO         |
*     +---------------------------+---------------------------+
* 178 |        NICRXPKTHI         |        NICRXPKTLO         |
*     +---------------------------+---------------------------+
* 180 |        NICRXDSCHI         |        NICRXDSCLO         |
*     +---------------------------+---------------------------+
* 188 |        NICRXERRHI         |        NICRXERRLO         |
*     +---------------------------+---------------------------+
* 190
*
*** Overlay for ORG in NICBK

 
Symbol         Dspl Value
-------------- ---- -----
NIC$END        0258
NIC_LANDEFER   0108
NIC_LOCKREQS   0100
NIC_RXDEFERS   0128
NIC_RXREQS     0120
NIC_SESRXPCI   0140
NIC_SESTXPCI   0148
NIC_STKDEFERS  0138
NIC_STKREQS    0130
NIC_TXDEFERS   0118
NIC_TXREQS     0110
NIC_VIDINST    003A
NICACTIV       00AF 80
NICADPNL       0077
NICADPNM       0078
NICADPTK       0077
NICAFLG        0076
NICAUTHX       0076 80
NICBASE        0010
NICBCFGC       0236
NICBKLN        0258 00000258
NICBKSZ        0258 0000004B
NICBPNT        00BC
NICBRIDG       0016 00000006
NICCCLBK       00F8
NICCFLG        005C
NICCHPID       001F
NICCHPTP       001E
NICCNLAN       005C 20
NICCTRLK       00E0
NICCTRLN       0170 000000F0
NICCTRS        0100
NICCTRVL       01F0
NICCUMDL       001A
NICCUTYP       0018
NICDDCFG       023C 80
NICDDCFM       023C 40
NICDDFLG       023C
NICDDLAN       023C 20
NICDDNET       0244
NICDDNET_NAME  024C
NICDDNET_OWNER
               0244
NICDEDID       0220
NICDEDMA       0218
NICDEDUA       0216
NICDEFIP       0094
NICDESC        0000
NICDEVS        0014
NICDLPRG       005C 40
NICDVMDL       001D
NICDVTYP       001B
NICESMVL       00D0
NICETHER       0017 00000002
NICFPNT        00B8
NICHIPR        0016 00000001
NICHWDED       0214
NICHWDED_ON    0214 80
NICINPRG       005C 80
NICIP          0017 00000001
NICIPCTR       0092
NICIPMAX       0090
NICIVLPT       00AF 40
NICLANBK       00C4
NICLAST        0012
NICLFLG        00AE
NICLGFLG       0230
NICLGLAN       005C 01
NICLGRGA       00AE 80
NICLGRLV       00B2
NICLG3DP       0230 80
NICLG3DP_E     0230 40
NICLKWRD       0040
NICLLCTR       00A6
NICLLMAX       00A4
NICMAC         0028
NICMAXIQ       008C
NICMAXOQ       008E
NICMFS         0024
NICMGIFI       0068
NICMGPOR       0068
NICMPCCT       0080
NICMPCHD       0084
NICMPCTL       0088
NICMSVBK       0070
NICNCABK       00CC
NICNIDHD       0060
NICNIDTL       0064
NICOWNBS       0008
NICOWNER       0008
NICPAUT        005C 02
NICPFLG        00AF
NICPFTKO       00AF 20
NICPPCNT       00AC
NICPPORT       00AD
NICPROM        00A8
NICPTRS        00B8
NICPVID        005E
NICPVLAN       005C 10
NICQDFMT       0074
NICQDIO        0016 00000002
NICREADY       005C 08
NICRFCTR       0058
NICROUTR       005C 04
NICRPORT       006C
NICRXBYT       0170
NICRXBYTHI     0170
NICRXBYTLO     0174
NICRXCTR       00D8
NICRXCTS       0170
NICRXDSC       0180
NICRXDSCHI     0180
NICRXDSCLO     0184
NICRXERR       0188
NICRXERRHI     0188
NICRXERRLO     018C
NICRXIVL       018C 00000002
NICRXMAX       018C 00000004
NICRXPKT       0178
NICRXPKTHI     0178
NICRXPKTLO     017C
NICRXSQ0       018C 00000000
NICRXSQ1       018C 00000020
NICRXSQ2       018C 00000040
NICRXSQ3       018C 00000060
NICRXSZB       018C 00000020
NICRXTBL       00D4
NICSIGA        00C8
NICSPCPT       00AF 01
NICTCHID       022E
NICTCHPI       022D
NICTCSID       022A
NICTDEV        0228
NICTIID        022B
NICTKLST       0030
NICTKUID       002E
NICTOKEN       0228
NICTRANP       0017
NICTSSID       022C
NICTXBYT       0150
NICTXCP        00DB 00000000
NICTXCTS       0150
NICTXDSC       0160
NICTXDSCHI     0160
NICTXDSCLO     0164
NICTXERR       0168
NICTXERRHI     0168
NICTXERRLO     016C
NICTXHI        00DB 00000010
NICTXLO        00DB 00000030
NICTXLST       00DB 00000030
NICTXNM        00DB 00000020
NICTXPKT       0158
NICTXPKTHI     0158
NICTXPKTLO     015C
NICTXPND       00DA
NICTXRCV       00DB 00000010
NICTXUPL       00DB
NICTYPE        0016
NICUNKWN       0017 00000003
NICUSRPN       0076 40
NICVDEV        0020
NICVLANS       0034
NICVLCPT       003C
NICVLCTR       0038
NICVLFLG       005D
NICVLFLT       005D 20
NICVLGBL       005D 80
NICVLNON       005D 10
NICVLUSR       005D 40
NICVNABK       0240
NICVPORT       0075
NICVPORT_ACCESS
               0075 00000001
NICVPORT_NONE  0075 00000000
NICVPORT_TRUNK
               0075 00000002
NICVRTBK       00DC
NICVSW         0016 00000003