DBHBK | Back to Index page

| Prolog Control Block Contents DBHBK DSECT DBHNBK DSECT DBHCTRS DSECT Storage Layout Cross Reference (Contains links to field and bit definitions) |
Programming Interface Information: This information is NOT intended to be used as Programming Interfaces of z/VM.

DBHBK Prolog | Top of page

     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 Control Block Content | Top of page

     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 Storage Layout | Top of page

    *** 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

DBHBK Cross Reference | Top of page

    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

This information is based on z/VM 7.2.0 Last updated on 24 Jun 2020 at 09:27:36 EDT.
Copyright IBM Corporation, 1990, 2020