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

NODBK

Prolog  

Control Block Contents  
   NODBK DSECT

Storage Layout  

Cross Reference (Contains links to field and bit definitions)  


NODBK Prolog

 NAME       : HCPNODBK
 DESCRIPTION: ISFC Node description block
 DSECT      : NODBK
 FUNCTION   : Maintain information about an ISFC node
              in the collection.
 LOCATED BY : HCPBUTNT  points to the linked list of NODBKs.
 CREATED BY : HCPBUUAN  whenever called to create a node.
 DELETED BY : HCPBUURN  whenever a node is deleted from collection.
 SERIALIZED : The ISFC global lock (HCPBDSGL) and the Kernel Communi-
              cations Lock (KCMLKWRD).
              -- In order to change the NODBK chain, both locks must
              be held EXCLUSIVE.
              -- A search of the NODBK chain may be done with either
              lock held SHARED.
              Fields in the NODXBK section are serialized by the
              NODXLOCK.
              All other fields are protected by the ISFC Global Lock.
 RELOCATION CONSIDERATIONS : None

 

NODBK Control Block Content


NODBK DSECT

Hex   Dec Type/Val   Lng Label (dup)    Comments
---- ---- --------- ---- -------------- --------
0000    0 Structure      NODBK          ISFC Node description block
      NODBK management.
0000    0 Character    8 NODEID         REMOTE NODE ID
0008    8 Signed       4 NODLNKAD       ADDRESS OF LNKBK WILL BE ZERO FOR
                                        LOCAL NODE
000C   12 Signed       4 NODNEXT        ADDR OF NEXT NODBK IN TABLE
0010   16 Signed       4 NODPTHAD       ADDRESS OF PTHBK FOR NODBK
0014   20 Signed       4 NODCAP (0)     CAPABILITIES
0014   20 Bitstring    1 NODCAP1        FIRST BYTE OF CAPABILITIES
          1... ....      NODRES         X'80' NODRES WANTS RESOURCES AND
                                        GATEWAYS
          .1.. ....      NODUSER        X'40' NODUSER ACCEPTS USERID
                                        SEARCHES
          ..1. ....      NODPASS        X'20' NODPASS ACCEPTS PASSWORD
                                        SEARCHES
          ...1 ....      NODBCR         X'10' NODBCR Supports broadcast
                                        routing
          .... 1...      NODCSAR        X'08' NODCSAR Supports CS_Area
          .... .1..      NODPWE         X'04' NODPWE Supports password
                                        encryption
          .... ..1.      NODIDENT       X'02' NODIDENT Accepts *IDENT
                                        verify reqs
          .... ...1      NODALERT       X'01' NODALERT Alert focal point
0015   21 Bitstring    1 NODCAP2        Second Capabilities Byte
          1... ....      NODEJRNL       X'80' NODEJRNL Enhanced
                                        Journaling handled
          .1.. ....      NODDIUCV       X'40' NODDIUCV Distributed IUCV
                                        handled
          ..1. ....      NODCPAP        X'20' NODCPAP CP Applications and
                                        big IUCV send handled by this
                                        node
          ...1 ....      NODVARLN       X'10' NODVARLN VM-defined
                                        variable-length section after the
                                        FMH5 supported.
          .... 1...      NODVFYND       X'08' NODVFYND VERIFY NODE
                                        supported
          .... .1..      NODSOCK        X'04' NODSOCK Sockets supported
0016   22 Bitstring    2 *              Save - future Capabilities
0018   24 Bitstring    8 NODPACQU       MDEBK queue awaiting pacing
0020   32 Signed       4 NODSNTCT       COUNT OF FRAMES SENT SINCE LAST
                                        PACE
0024   36 Signed       4 NODPACCT       NUMBER OF FRAMES THAT CAN BE SENT
0028   40 Bitstring    1 NODFLAGS       FLAG BYTE
          1... ....      NODESTAB       X'80' NODESTAB NODE IS ALREADY
                                        ESTABLISHED
          .1.. ....      NODPACRQ       X'40' NODPACRQ WE REQUESTED
                                        PACING RESPONSE
          ..1. ....      NODGONE        X'20' NODGONE THIS NODE IS GONE
          ...1 ....      NODPACAN       X'10' NODPACAN We owe a pacing
                                        response
          .... 1...      NODREMOT       X'08' NODREMOT Node is remote
0029   41 Bitstring    3 *              Reserved for IBM Use
002C   44 Signed       4 NODAPPCM       POINTER TO APPC MAILBOX ENTRY
0030   48 Signed       4 NODCMPM        POINTER TO CMP MAILBOX ENTRY
0034   52 Signed       4 NODLINKM       POINTER TO LINK MAILBOX ENTRY
0038   56 Signed       4 NODFRMIU       NUMBER OF FRAMES IN USE BY NODE
003C   60 Signed       4 NODTHRES       RESUME VALUE FOR THIS NODE
0040   64 Signed       4 NODPTHIU       Number of active PTHBKs
0044   68 Signed       4 NODIUCVM       IUCV mailbox entry
0048   72 Signed       4 NODCPAPM       Pointer to CP applications
                                        mailbox entry
004C   76 Signed       4 NODRESPD       Pending Resource msg MDEBK
0050   80 Signed       4 *              Reserved
0054   84 Signed       4 *              Reserved
0058   88 Signed       4 NODPLXMS       VMPLEX System Mask
005C   92 Signed       2 NODPLXSL       VMPLEX Slot Number
005E   94 Signed       2 *              Reserved
      - Discarded fields report traffic destined for this node,
        but no path was found to the node.
0060   96 Dbl-Word     8 NODDSNMS       "Sent" Messages discarded
0068  104 Dbl-Word     8 NODDSNBT       "Sent" Bytes discarded
0070  112 Dbl-Word     8 NODXLOCK (3)   Node Extension Lock
      Sync Services Area
0088  136 Signed       4 * (3)          Reserved
0094  148 Signed       2 NODXHOPS       Hops to this node
0096  150 Bitstring    2 *              Reserved
0098  152 Address      4 NODXNEIG       NODBK of neighbor node used to
                                        get to this node.
009C  156 Signed       4 *              Reserved
00A0  160 Dbl-Word     8 NODXSYRQ       Node Sync Request value
00A8  168 Dbl-Word     8 NODXSYRS       Node Sync Response value
00B0  176 Dbl-Word     8 NODXSYTC       Latest Completed Time Sync Check
00B8  184 Dbl-Word     8 NODXSYTO       Time Sync Offset
00C0  192 Dbl-Word     8 NODXRTMY       Time Sync Round trip
00C8  200 Dbl-Word     8 NODXTOPT       TS Offset (partner's view)
00D0  208 Dbl-Word     8 NODXIPLN       New IPL TOD value for node
00D8  216 Dbl-Word     8 * (3)          Reserved for IBM use
          0000001E       NODSIZE        (*-NODBK+7)/8

 

NODBK Storage Layout

          
*** NODBK - ISFC Node description block
*
*     +-------------------------------------------------------+
*   0 |                        NODEID                         |
*     +---------------------------+---------------------------+
*   8 |         NODLNKAD          |         NODNEXT           |
*     +---------------------------+------+------+-------------+
*  10 |         NODPTHAD          |:CAP1 |:CAP2 |/////////////|
*     +---------------------------+------+------+-------------+
*  18 |                       NODPACQU                        |
*     +---------------------------+---------------------------+
*  20 |         NODSNTCT          |         NODPACCT          |
*     +------+--------------------+---------------------------+
*  28 |:FLAGS|////////////////////|         NODAPPCM          |
*     +------+--------------------+---------------------------+
*  30 |         NODCMPM           |         NODLINKM          |
*     +---------------------------+---------------------------+
*  38 |         NODFRMIU          |         NODTHRES          |
*     +---------------------------+---------------------------+
*  40 |         NODPTHIU          |         NODIUCVM          |
*     +---------------------------+---------------------------+
*  48 |         NODCPAPM          |         NODRESPD          |
*     +---------------------------+---------------------------+
*  50 |///////////////////////////|///////////////////////////|
*     +---------------------------+-------------+-------------+
*  58 |         NODPLXMS          |  NODPLXSL   |/////////////|
*     +---------------------------+-------------+-------------+
*  60 |                       NODDSNMS                        |
*     +-------------------------------------------------------+
*  68 |                       NODDSNBT                        |
*     +-------------------------------------------------------+
*  70 |                                                       |
*     =                       NODXLOCK                        =
*     |                                                       |
*     +-------------------------------------------------------+
*  88 |///////////////////////////////////////////////////////|
*     |///////////////////////////+-------------+-------------+
*  90 |///////////////////////////|  NODXHOPS   |/////////////|
*     +---------------------------+-------------+-------------+
*  98 |         NODXNEIG          |///////////////////////////|
*     +---------------------------+---------------------------+
*  A0 |                       NODXSYRQ                        |
*     +-------------------------------------------------------+
*  A8 |                       NODXSYRS                        |
*     +-------------------------------------------------------+
*  B0 |                       NODXSYTC                        |
*     +-------------------------------------------------------+
*  B8 |                       NODXSYTO                        |
*     +-------------------------------------------------------+
*  C0 |                       NODXRTMY                        |
*     +-------------------------------------------------------+
*  C8 |                       NODXTOPT                        |
*     +-------------------------------------------------------+
*  D0 |                       NODXIPLN                        |
*     +-------------------------------------------------------+
*  D8 |///////////////////////////////////////////////////////|
*     =///////////////////////////////////////////////////////=
*     |///////////////////////////////////////////////////////|
*     +-------------------------------------------------------+
*  F0
*
*** NODBK - ISFC Node description block

 

NODBK Cross Reference

Symbol         Dspl Value
-------------- ---- -----
NODALERT       0014 01
NODAPPCM       002C
NODBCR         0014 10
NODCAP         0014
NODCAP1        0014
NODCAP2        0015
NODCMPM        0030
NODCPAP        0015 20
NODCPAPM       0048
NODCSAR        0014 08
NODDIUCV       0015 40
NODDSNBT       0068
NODDSNMS       0060
NODEID         0000
NODEJRNL       0015 80
NODESTAB       0028 80
NODFLAGS       0028
NODFRMIU       0038
NODGONE        0028 20
NODIDENT       0014 02
NODIUCVM       0044
NODLINKM       0034
NODLNKAD       0008
NODNEXT        000C
NODPACAN       0028 10
NODPACCT       0024
NODPACQU       0018
NODPACRQ       0028 40
NODPASS        0014 20
NODPLXMS       0058
NODPLXSL       005C
NODPTHAD       0010
NODPTHIU       0040
NODPWE         0014 04
NODREMOT       0028 08
NODRES         0014 80
NODRESPD       004C
NODSIZE        00D8 0000001E
NODSNTCT       0020
NODSOCK        0015 04
NODTHRES       003C
NODUSER        0014 40
NODVARLN       0015 10
NODVFYND       0015 08
NODXHOPS       0094
NODXIPLN       00D0
NODXLOCK       0070
NODXNEIG       0098
NODXRTMY       00C0
NODXSYRQ       00A0
NODXSYRS       00A8
NODXSYTC       00B0
NODXSYTO       00B8
NODXTOPT       00C8

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