NAME       : HCPDBHBK
 DESCRIPTION: ISFC Directory Broadcast header block
 DSECT      : DBHBK
 FUNCTION   : Maintain information about an ISFC directory
              broadcast.
 LOCATED BY : Local work registers.
 CREATED BY : HCPSCF    to perform a directory broadcast.
 DELETED BY : HCPACP    when the directory broadcast is completed.
 SERIALIZED : The ISFC global lock (HCPBDSGL).
 RELOCATION CONSIDERATIONS : None

 DBHBK DSECT
Top of page

Hex   Dec Type/Val   Lng Label (dup)    Comments
---- ---- --------- ---- -------------- --------
0000    0 Structure      DBHBK          ISFC Directory Broadcast header block
      DBHBK management.
      This is the DBHBK prefix (this part is not transmitted).
0000    0 Signed       4 DBHPREV        ADD OF PREVIOUS TABLE ENTRY
0004    4 Signed       4 DBHNEXT        ADD OF NEXT TABLE ENTRY
0008    8 Signed       4 DBHRSPID       Request id for response
000C   12 Bitstring    1 DBHFLAGS       FLAG BYTE
          1... ....      DBHUDONE       X'80' DBHUDONE Userid search is
                                        done
          .1.. ....      DBHPDONE       X'40' DBHPDONE Password
                                        Verification is done
          ..1. ....      DBHBCRRQ       X'20' DBHBCRRQ Broadcast Routing
                                        request
          ...1 ....      DBHKILL        X'10' DBHKILL Kill this request
                                        (no response). DBHKILL is set if
                                        the link goes down or if the
                                        DBHBK has been on the Directory
                                        response list for one complete
                                        link timer interval.
          .... 1...      DBHJRNLD       X'08' DBHJRNLD Journaling already
                                        done
          .... .1..      DBHDIUCV       X'04' DBHDIUCV IUCV userid search
                                        request
          .... ...1      DBHRESPD       X'01' DBHRESPD CPEBK is stacked
                                        for completion
          11.. ....      DBHADONE       DBHUDONE+DBHPDONE DBHADONE All
                                        requests are done
000D   13 Bitstring    1 DBHFLAGB       Additional flag bits
          1... ....      DBHPRMRQ       X'80' DBHPRMRQ This request has
                                        duplicates
          .1.. ....      DBHSECRQ       X'40' DBHSECRQ This is a
                                        duplicate request
000E   14 Bitstring    2 *              RESERVED
0010   16 Signed       4 DBHNLIST       Pointer to DBHNBK chain
0014   20 Signed       4 DBHCPEX        CPEXBLOK ADDRESS
0018   24 Character    8 DBHNODE        TARGET NODE ID FOR USERID
0020   32 Character    8 DBHSUSER       SOURCE USERID (JOURNALING)
0028   40 Signed       4 DBHBLIST       NODE LIST OF BAD PASSWORDS
002C   44 Signed       4 DBHLSESS       Copy of CMP MBX PTHLSESS
0030   48 Character    8 DBHACCJL       Acess userid for Journaling
0038   56 Bitstring    8 DBHTOD         TOD local request created
0040   64 Address      4 DBHDUPRQ       Pointer to master DBHBK
      This is the Directory Broadcast frame header.
        This portion of the DBHBK is transmitted along with
        one or more DBEBK frames (based on DBHNREQS value).
0044   68 Character   24 DBHDRST (0)    Start of architected header
0044   68 Signed       4 DBHDRLEN       LENGTH OF HEADER
0048   72 Signed       4 DBHNREQS       NUMBER OF DIRECTORY REQUESTS
004C   76 Bitstring   16 DBHDESC (0)    Descriptor (ID||Node||id)
004C   76 Signed       4 DBHREQID       DIR BROADCAST REQUEST ID
0050   80 Character    8 DBHORIGN       Originating node ID
0058   88 Signed       4 DBHORIGI       Originating request ID
          00000018       DBHDRLN        *-DBHDRST
          0000005C       DBHDRL1        *-DBHBK
      One or more DBEBK structures should follow this DBHBK.
005C   92 Bitstring    1 DBHREQ1 (0)    First DBEBK appears here
      DBHNBK - Node Element Block
      Notes      :
        Each DBHNBK represents a reference to an ISFC Node.
        One DBHNBK is added to the DBHNLIST chain each time a
        request is sent to a remote node.  That entry is removed
        when the response arrives from that node.
        One DBHNBK is added to the DBHBLIST chain each time a
        bad response arrives from a node.


 DBHNBK DSECT
Top of page

Hex   Dec Type/Val   Lng Label (dup)    Comments
---- ---- --------- ---- -------------- --------
0000    0 Structure      DBHNBK         ISFC Directory Broadcast header block
0000    0 Character    8 DBHNNAME       Referenced Node ID
0008    8 Address      4 DBHNNEXT       Pointer to next DBHNBK
          00000002       DBHNBKSZ       ((*-DBHNBK)+7)/8 Size of DBHNBK
                                        in dwords
      Directory Broadcast counters -
      Notes      :
        There is one instance of this structure at HCPBDSCT.
        These counters are maintained because they were useful
        for verifying proper operation during development.


 DBHCTRS DSECT
Top of page

Hex   Dec Type/Val   Lng Label (dup)    Comments
---- ---- --------- ---- -------------- --------
0000    0 Structure      DBHCTRS        ISFC Directory Broadcast header block
0000    0 Signed       4 DBH_REQUESTS   Requests received
0004    4 Signed       4 DBH_RESPONSES  Responses sent
0008    8 Signed       4 DBH_RELAYS     Relays Started
000C   12 Signed       4 DBH_RELAYCOMP  Relays Completed
0010   16 Signed       4 DBH_DUPREQS    Duplicate Requests received
0014   20 Signed       4 DBH_DUPRESP    Duplicate Responses sent
          00000018       DBHCTRLN       *-DBHCTRS Length of DBHCTRS

          
*** DBHBK - ISFC Directory Broadcast header block
*
*     +---------------------------+---------------------------+
*   0 |         DBHPREV           |         DBHNEXT           |
*     +---------------------------+------+------+-------------+
*   8 |         DBHRSPID          |:FLAGS|:FLAGB|/////////////|
*     +---------------------------+------+------+-------------+
*  10 |         DBHNLIST          |         DBHCPEX           |
*     +---------------------------+---------------------------+
*  18 |                       DBHNODE                         |
*     +-------------------------------------------------------+
*  20 |                       DBHSUSER                        |
*     +---------------------------+---------------------------+
*  28 |         DBHBLIST          |         DBHLSESS          |
*     +---------------------------+---------------------------+
*  30 |                       DBHACCJL                        |
*     +-------------------------------------------------------+
*  38 |                        DBHTOD                         |
*     +---------------------------+---------------------------+
*  40 |         DBHDUPRQ          |         DBHDRLEN          |
*     +---------------------------+---------------------------+
*  48 |         DBHNREQS          |         DBHREQID          |
*     +---------------------------+---------------------------+
*  50 |                       DBHORIGN                        |
*     +---------------------------+---------------------------+
*  58 |         DBHORIGI          |
*     +---------------------------+
*
*** DBHBK - ISFC Directory Broadcast header block
          
*** DBHNBK - ISFC Directory Broadcast header block
*
*     +-------------------------------------------------------+
*   0 |                       DBHNNAME                        |
*     +---------------------------+---------------------------+
*   8 |         DBHNNEXT          | C
*     +---------------------------+
*
*** DBHNBK - ISFC Directory Broadcast header block
          
*** DBHCTRS - ISFC Directory Broadcast header block
*
*     +---------------------------+---------------------------+
*   0 |       DBH_REQUESTS        |      DBH_RESPONSES        |
*     +---------------------------+---------------------------+
*   8 |        DBH_RELAYS         |      DBH_RELAYCOMP        |
*     +---------------------------+---------------------------+
*  10 |       DBH_DUPREQS         |       DBH_DUPRESP         |
*     +---------------------------+---------------------------+
*  18
*
*** DBHCTRS - ISFC Directory Broadcast header block

 
Symbol         Dspl Value
-------------- ---- -----
DBH_DUPREQS    0010
DBH_DUPRESP    0014
DBH_RELAYCOMP  000C
DBH_RELAYS     0008
DBH_REQUESTS   0000
DBH_RESPONSES  0004
DBHACCJL       0030
DBHADONE       000C C0
DBHBCRRQ       000C 20
DBHBLIST       0028
DBHCPEX        0014
DBHCTRLN       0014 00000018
DBHDESC        004C
DBHDIUCV       000C 04
DBHDRLEN       0044
DBHDRLN        0058 00000018
DBHDRL1        0058 0000005C
DBHDRST        0044
DBHDUPRQ       0040
DBHFLAGB       000D
DBHFLAGS       000C
DBHJRNLD       000C 08
DBHKILL        000C 10
DBHLSESS       002C
DBHNBKSZ       0008 00000002
DBHNEXT        0004
DBHNLIST       0010
DBHNNAME       0000
DBHNNEXT       0008
DBHNODE        0018
DBHNREQS       0048
DBHORIGI       0058
DBHORIGN       0050
DBHPDONE       000C 40
DBHPREV        0000
DBHPRMRQ       000D 80
DBHREQID       004C
DBHREQ1        005C
DBHRESPD       000C 01
DBHRSPID       0008
DBHSECRQ       000D 40
DBHSUSER       0020
DBHTOD         0038
DBHUDONE       000C 80