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

#### PTHBK

Prolog

Control Block Contents
PTHBK DSECT

Storage Layout

Cross Reference (Contains links to field and bit definitions)

#### PTHBK Prolog

     NAME       : HCPPTHBK
     DESCRIPTION: ISFC Path description block
     DSECT      : PTHBK
     FUNCTION   : Maintain information about an ISFC path
                  from a remote system.
     LOCATED BY : HCPBTBPA  anchor for PTHBKS located by path ID
                  HCPBTBSA  anchor for PTHBKS located by session ID
                  TRGBK points to PTHBK.
     CREATED BY : HCPBUVAP  whenever called to create a path.
     DELETED BY : HCPBUVRP  whenever a path is complete and released.
     SERIALIZED : The ISFC global lock (HCPBDSGL).

#### PTHBK Control Block Content

#### PTHBK DSECT

    Hex   Dec Type/Val   Lng Label (dup)    Comments
    ---- ---- --------- ---- -------------- --------
    0000    0 Structure      PTHBK          ISFC Path description block
          PTHBK management.
    0000    0 Signed       4 PTHLSESS       LOCAL SESSION ID
    0004    4 Signed       4 PTHRSESS       REMOTE SESSION ID
    0008    8 Signed       2 PTHMSGIS       LAST MESSAGE ID SENT
    000A   10 Signed       2 PTHMSGIR       LAST MESSAGE ID RECEIVED
    000C   12 Signed       4 PTHMSGQ        QUEUE OF INCOMPLETE MESSAGES
                                            RECVD
    0010   16 Signed       4 PTHBYTES       NUMBER OF BYTES SENT
    0014   20 Signed       4 PTHBYTER       NUMBER OF BYTES RECEIVED
    0018   24 Signed       4 PTHPIPFR       PIP DATA MDEBK FOR CONNECT
    001C   28 Character    4 PTHMAIL        MAILBOX NAME
    0020   32 Signed       4 PTHTRGQ        QUEUE OF WORK WAITING AT TARGET
    0024   36 Signed       4 PTHTRGTL       TARGET QUEUE TAIL POINTER
    0028   40 Signed       2 *              RESERVED
    002A   42 Bitstring    1 PTHFLAGS       FLAGS
              1... ....      PTHACCST       X'80' PTHACCST ACCOUNTING STARTED
                                            FOR PATH
              ...1 ....      PTHPACRQ       X'10' PTHPACRQ REQUESTED PACING
                                            RESPONSE
              .... 1...      PTHCOMP        X'08' PTHCOMP SESSION IS COMPLETE
              .... .1..      PTHBIGS        X'04' PTHBIGS Big send in
                                            progress, queue
              .... ..1.      PTHBUSY        X'02' PTHBUSY PATH IS BUSY
              .... ...1      PTHPACAN       X'01' PTHPACAN OWE A PACING
                                            ANSWER ON THIS PATH
    002B   43 Bitstring    1 PTHFLAG2       FLAGS
              1... ....      PTHOCLOS       X'80' PTHOCLOS We sent close to
                                            source (passthru) or partner
                                            (non-passthru)
              .1.. ....      PTHICLOS       X'40' PTHICLOS We received close
                                            from source (passthru) or partner
                                            (non-passthru)
              ..1. ....      PTHMCLOS       X'20' PTHMCLOS Mailbox is done
                                            with PTHBK
              ...1 ....      PTHLCLOS       X'10' PTHLCLOS Line driver sent
                                            close to source (passthru) or
                                            partner (non-passthru)
              .... 1...      PTHOCLOT       X'08' PTHOCLOT We sent close to
                                            target (passthru only)
              .... .1..      PTHICLOT       X'04' PTHICLOT We received close
                                            from target (passthru only)
              .... ..1.      PTHMCLOT       X'02' PTHMCLOT For completeness
                                            only (see above)
              .... ...1      PTHLCLOT       X'01' PTHLCLOT Line driver sent
                                            close to target (passthru only)
    002C   44 Signed       4 PTHMBAD        DISPLACEMENT TO MAILBOX
                                            INFORMATION
    0030   48 Signed       2 PTHPNDSN       COUNT OF OUTSTANDING SENDS
    0032   50 Bitstring    1 PTHFLAG3       USED FOR MBEFLAG
              1... ....      PTHACCT        X'80' PTHACCT CUT ACCOUTING
                                            RECORDS
    0033   51 Bitstring    1 PTHPFLAG       Flags for passthru session
              1... ....      PTHPASS        X'80' PTHPASS Indicates a
                                            passthru conv
              .1.. ....      PTHTARG        X'40' PTHTARG From target side of
                                            session (can only be set if
                                            PTHPASS set)
              .... ...1      PTHGOING       X'01' PTHGOING ISFC Close started
          The following are the APPC and IUCV extensions.
    0034   52 Signed       2 PTHLPATH       LOCAL PATHID
    0036   54 Bitstring    1 PTHFLGAP       APPC FLAG BYTE
              1... ....      PTHPURGE       X'80' PTHPURGE PURGE THINGS ON
                                            THIS PATH
              .1.. ....      PTHSEVER       X'40' PTHSEVER PATH WAS SEVERED
              ..1. ....      PTHGONE        X'20' PTHGONE PTHBK NOT IN ISFC
                                            PATH TABLE NOTES : PTHSEVER and
                                            PTHGONE are also set in HCPAAT on
                                            a delayed connect and turned off
                                            when the connect completes.
              ...1 ....      PTHGATWY       X'10' PTHGATWY GATEWAY IS IN
                                            PTHTPN
              .... 1...      PTHPRIV        X'08' PTHPRIV USERID IS IN PTHTPN
              .... .1..      PTHVALID       X'04' PTHVALID PATH IS A VALID
                                            IUCV PATH
              .... ..1.      PTHSVFCI       X'02' PTHSVFCI FCI received on a
                                            SEVER
              .... ...1      PTHCSTRP       X'01' PTHCSTRP CS data length
                                            stripped
    0037   55 Bitstring    1 PTHSTATE       PATH CURRENT STATE
              00000001       PTHRESET       X'01' PTHRESET PATH IS IN RESET
                                            STATE
              00000002       PTHCONN        X'02' PTHCONN PATH IS IN CONNECT
                                            STATE
              00000003       PTHSEND        X'03' PTHSEND PATH IS IN SEND
                                            STATE
              00000004       PTHRECV        X'04' PTHRECV PATH IS IN RECEIVE
                                            STATE
              00000005       PTHCONF        X'05' PTHCONF PATH IS IN CONFIRM
                                            STATE
              00000006       PTHSEVST       X'06' PTHSEVST PATH IS IN SEVER
                                            STATE
    0038   56 Signed       4 PTHPEND        POINTER TO PENDING FRAME
    003C   60 Signed       4 *              RESERVED
    0040   64 Bitstring    8 PTHSRCQ        QUEUE OF WORK AT THE SOURCE
    0048   72 Signed       4 PTHNODAD       ADDRESS OF NODBK
    004C   76 Signed       4 PTHRCVCT       Count of received 4K frames
    0050   80 Signed       4 PTHSNTCT       COUNT OF FRAMES SINCE LAST PACE
    0054   84 Signed       4 PTHPACCT       RESERVED
    0058   88 Character    8 PTHAUSER       ACCESS USERID
    0060   96 Character    8 PTHTPN         TPN OR GATEWAY NAME
    0068  104 Character    8 PTHFMHTP       TPN given in FMH5
    0070  112 Dbl-Word     8 *              Reserved space
    0078  120 Address      4 PTHENTSN       Address of the send routine
    007C  124 Signed       4 * (3)          Reserved
    0088  136 Signed       2 PTHCMHLN       CM header length
    008A  138 Signed       2 PTHMHLEN       Mailbox header length
    008C  140 Signed       4 * (3)          Reserved
              00000013       PTHSIZE        (*-PTHBK+7)/8 Size of PTHBK in
                                            doublewords
    0050   80 Signed       4 PTHNODEP       Target NODBK for passthru
    0054   84 Signed       4 PTHPSESS       Source session for passthru
          The following fields are defined for IUCV needs. These
          overlay the APPC/VM specific fields in the PTHBK.
    0058   88 Character    8 PTHUSER        IUCV userid for path
    0060   96 Character    8 PTHTRGU        Target userid
    0068  104 Signed       4 PTHRPLY        IUCV Reply pending queue
    006C  108 Signed       4 PTHRPLYT       IUCV Reply queue tail
    0070  112 Dbl-Word     8 *              Reserved space
          The following fields are defined for CP application mailbox
          needs. These overlay some of the APPC/VM specific fields
          in the PTHBK.
    0036   54 Bitstring    1 PTHFLGCP       Flag
              ..1. ....      PTHGONNE       X'20' PTHGONNE Inbound CLOSE
                                            received and TRGBK for path
                                            removed from CP application TRGBK
                                            chain.
    0058   88 Character    8 PTHAPPLS       Source CP application
    0060   96 Character    8 PTHAPPLT       Target CP application
    0068  104 Character    8 PTHNODET       Target node
    0070  112 Signed       4 PTHACTBK       Addr of application's ACTBK
    0074  116 Signed       4 PTHTRGBK       Path's TRGBK address
          The following are the flags defined in PTHFLAGS.
          The following are the flags defined in PTHFLAG2.
          Notes      : On a passthru conversation, the PTH*CLOS bits repre-
                sent closes sent to/from the source and the PTH*CLOT
                bits represent closes sent to/from the target.  Also
                note that the PTHMCLO* bits are automatically set on a
                passthru conversation, since the data is never presen-
                ted to the mailbox(es) on the intermediate node(s) of
                a passthru conversation.
                On a normal (non-passthru) conversation, the PTH*CLOT
                bits are not necessary.  They are immediately set.
                A conversation is non-passthru on the nodes where the
                source and target reside (whether there are zero or
                more nodes in between).  The PTH*CLOS bits represent
                closes sent to/from the 'partner' (could be the source,
                target, or an intermediate node).
                Note that PTHMCLOT does not supply any significant
                information about the target.  It is always set.  We
                keep it defined for completeness and to make it easier
                to determine when we have received all closes
                (PTHFLAG2 = X'FF') so we can release the PTHBK.
          The following are the flags defined in PTHFLAG3.
          The following are the flags defined in PTHPFLAG.
          The following are the flags defined in PTHFLGAP.
          The following are the flags defined in PTHFLGCP.
          The following are the flags defined in PTHSTATE.
          NOTES      : These values correspond to the values defined for
                IPSTATE IN IPARML.

#### PTHBK Storage Layout

    *** PTHBK - ISFC Path description block
    *
    *     +---------------------------+---------------------------+
    *   0 |         PTHLSESS          |         PTHRSESS          |
    *     +-------------+-------------+---------------------------+
    *   8 |  PTHMSGIS   |  PTHMSGIR   |         PTHMSGQ           |
    *     +-------------+-------------+---------------------------+
    *  10 |         PTHBYTES          |         PTHBYTER          |
    *     +---------------------------+---------------------------+
    *  18 |         PTHPIPFR          |         PTHMAIL           |
    *     +---------------------------+---------------------------+
    *  20 |         PTHTRGQ           |         PTHTRGTL          |
    *     +-------------+------+------+---------------------------+
    *  28 |/////////////|:FLAGS|:FLAG2|         PTHMBAD           |
    *     +-------------+------+------+-------------+------+------+
    *  30 |  PTHPNDSN   |:FLAG3|:PFLAG|  PTHLPATH   |:FLGAP|:STATE|
    *     +-------------+------+------+-------------+------+------+
    *  38 |         PTHPEND           |///////////////////////////|
    *     +---------------------------+---------------------------+
    *  40 |                       PTHSRCQ                         |
    *     +---------------------------+---------------------------+
    *  48 |         PTHNODAD          |         PTHRCVCT          |
    *     +---------------------------+---------------------------+
    *  50 |         PTHSNTCT          |         PTHPACCT          |
    *     +---------------------------+---------------------------+
    *  58 |                       PTHAUSER                        |
    *     +-------------------------------------------------------+
    *  60 |                        PTHTPN                         |
    *     +-------------------------------------------------------+
    *  68 |                       PTHFMHTP                        |
    *     +-------------------------------------------------------+
    *  70 |///////////////////////////////////////////////////////|
    *     +---------------------------+---------------------------+
    *  78 |         PTHENTSN          |///////////////////////////|
    *     +---------------------------+///////////////////////////|
    *     |///////////////////////////////////////////////////////|
    *     +-------------+-------------+---------------------------+
    *  88 |  PTHCMHLN   |  PTHMHLEN   |///////////////////////////|
    *     +-------------+-------------+///////////////////////////|
    *     |///////////////////////////////////////////////////////|
    *     +-------------------------------------------------------+
    *  98
    *
    *** PTHBK - ISFC Path description block

    *** Overlay for PTHSNTCT in PTHBK
    *
    *     +---------------------------+---------------------------+
    *  50 |         PTHNODEP          |         PTHPSESS          |
    *     +---------------------------+---------------------------+
    *  58
    *
    *** Overlay for PTHSNTCT in PTHBK

    *** Overlay for PTHAUSER in PTHBK
    *
    *     +-------------------------------------------------------+
    *  58 |                       PTHUSER                         |
    *     +-------------------------------------------------------+
    *  60 |                       PTHTRGU                         |
    *     +---------------------------+---------------------------+
    *  68 |         PTHRPLY           |         PTHRPLYT          |
    *     +---------------------------+---------------------------+
    *  70 |///////////////////////////////////////////////////////|
    *     +-------------------------------------------------------+
    *  78
    *
    *** Overlay for PTHAUSER in PTHBK

    *** Overlay for PTHFLGAP in PTHBK
    *
    *                                               +------+
    *  30 ...                                    36 |:FLGCP| 37
    *                                               +------+
    *
    *** Overlay for PTHFLGAP in PTHBK

    *** Overlay for PTHAUSER in PTHBK
    *
    *     +-------------------------------------------------------+
    *  58 |                       PTHAPPLS                        |
    *     +-------------------------------------------------------+
    *  60 |                       PTHAPPLT                        |
    *     +-------------------------------------------------------+
    *  68 |                       PTHNODET                        |
    *     +---------------------------+---------------------------+
    *  70 |         PTHACTBK          |         PTHTRGBK          |
    *     +---------------------------+---------------------------+
    *  78
    *
    *** Overlay for PTHAUSER in PTHBK

#### PTHBK Cross Reference

    Symbol         Dspl Value
    -------------- ---- -----
    PTHACCST       002A 80
    PTHACCT        0032 80
    PTHACTBK       0070
    PTHAPPLS       0058
    PTHAPPLT       0060
    PTHAUSER       0058
    PTHBIGS        002A 04
    PTHBUSY        002A 02
    PTHBYTER       0014
    PTHBYTES       0010
    PTHCMHLN       0088
    PTHCOMP        002A 08
    PTHCONF        0037 00000005
    PTHCONN        0037 00000002
    PTHCSTRP       0036 01
    PTHENTSN       0078
    PTHFLAGS       002A
    PTHFLAG2       002B
    PTHFLAG3       0032
    PTHFLGAP       0036
    PTHFLGCP       0036
    PTHFMHTP       0068
    PTHGATWY       0036 10
    PTHGOING       0033 01
    PTHGONE        0036 20
    PTHGONNE       0036 20
    PTHICLOS       002B 40
    PTHICLOT       002B 04
    PTHLCLOS       002B 10
    PTHLCLOT       002B 01
    PTHLPATH       0034
    PTHLSESS       0000
    PTHMAIL        001C
    PTHMBAD        002C
    PTHMCLOS       002B 20
    PTHMCLOT       002B 02
    PTHMHLEN       008A
    PTHMSGIR       000A
    PTHMSGIS       0008
    PTHMSGQ        000C
    PTHNODAD       0048
    PTHNODEP       0050
    PTHNODET       0068
    PTHOCLOS       002B 80
    PTHOCLOT       002B 08
    PTHPACAN       002A 01
    PTHPACCT       0054
    PTHPACRQ       002A 10
    PTHPASS        0033 80
    PTHPEND        0038
    PTHPFLAG       0033
    PTHPIPFR       0018
    PTHPNDSN       0030
    PTHPRIV        0036 08
    PTHPSESS       0054
    PTHPURGE       0036 80
    PTHRCVCT       004C
    PTHRECV        0037 00000004
    PTHRESET       0037 00000001
    PTHRPLY        0068
    PTHRPLYT       006C
    PTHRSESS       0004
    PTHSEND        0037 00000003
    PTHSEVER       0036 40
    PTHSEVST       0037 00000006
    PTHSIZE        008C 00000013
    PTHSNTCT       0050
    PTHSRCQ        0040
    PTHSTATE       0037
    PTHSVFCI       0036 02
    PTHTARG        0033 40
    PTHTPN         0060
    PTHTRGBK       0074
    PTHTRGQ        0020
    PTHTRGTL       0024
    PTHTRGU        0060
    PTHUSER        0058
    PTHVALID       0036 04

This information is based on z/VM V6R1.0. Last updated on 18 Feb 2010 at 08:58:34 EDT.
Copyright IBM Corporation, 1990, 2008