PDEBK - 32-bit CP - V4R4.0

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

#### PDEBK

Prolog

Control Block Contents
PDEBK DSECT

Storage Layout

Cross Reference (Contains links to field and bit definitions)

#### PDEBK Prolog

     NAME       : HCPPDEBK
     DESCRIPTION: PATH DESCRIPTOR ENTRY
     DSECT      : PDEBK
     FUNCTION   : HOLDS INFORMATION ABOUT AN IUCV OR APPC/VM PATH.
     LOCATED BY : CCTPDSEG FIELD IN HCPCCTBK
     CREATED BY : HCPIUFGP FOR IUCV CONNECT AND APPCVM CONNECT
     DELETED BY : HCPIULSV FOR SEVER

#### PDEBK Control Block Content

#### PDEBK DSECT

    Hex   Dec Type/Val   Lng Label (dup)    Comments
    ---- ---- --------- ---- -------------- --------
    0000    0 Structure      PDEBK          PATH DESCRIPTOR ENTRY
    0000    0 Signed       2 PDEMSGCT       CNT OF OUTSTANDING MSGS ON PATH
    0002    2 Signed       2 PDETGPID       TARGET PATH ID
    0004    4 Address      4 PDETGCCT       TARGET CCT ADDRESS
    0008    8 Signed       4 PDETGLKA       TARGET IUCV LOCKWORD POINTER
    000C   12 Bitstring    1 PDEFLAGS       STATUS
              1... ....      PDEVALID       X'80' VALID PATH
              .1.. ....      PDESEND        X'40' SEND ALLOWED ON THIS PATH
              ..1. ....      PDEPRTY        X'20' MAY INITIATE PRIORITY
                                            MESSAGES
              ...1 ....      PDEPRMD        X'10' MAY PUT DATA IN PARMLIST
              .... 1...      PDEPHELD       X'08' Path held by first invoker
         PDEVALID, PDEPEND1, PDEPEND2, and PDESERVD ( PEND1 + PDEND2) are the
         main flags used to indicate the status of one half of a path. The main
         combination's that will occur are
         PDEPEND1 on - The side of the path that has issued a CONNECT PDEPEND2
         on - The side of the path that will issue an ACCEPT PDEVALID on - This
         side of the path is fully established. PDEVALID + PDESEVRD on - Partner
         has severed their side.
         If see PDEPHELD + PDESEVRD on, indicates that a SEVER has occurred on a
         path where the original function that set PDEPHELD had to release the
         IUCV lock for a brief time
         PDEPHELD is set for two different reasons.
         First, when the IUCV or APPCVM code is making a a call to an ESM and
         has given up the Invoker's IUCV lock from IUCV CONNECT APPCVM CONNECT
         IUCV SEVER APPCVM SEVER Second, when IUCV ACCEPT is going for the
         partner's lock, PDEPHELD on protects the Acceptor's PDEBK.
         The purpose of PDEPHELD is to give the calling function control over
         the disposition of a PDEBK when PDEPHELD is ON.
              .... .1..      PDECNTRL       X'04' CONTROL PATH
              .... ..1.      PDEPEND1       X'02' INITIATED CONNECTION
              .... ...1      PDEPEND2       X'01' INCOMING CONNECTION
              .... ....      PDEZERO        X'00' PDEBK INVALID AND AVAILABLE
              00000003       PDESEVRD       PDEPEND1+PDEPEND2 ENTRY HAS BEEN
                                            SEVERED
    000D   13 Bitstring    1 PDEAPPFL       APPC/VM FLAGS
              1... ....      PDEAPPC        X'80' APPC/VM PATH
              .1.. ....      PDEAPSCF       X'40' SENDCNF/SENDCNFD PERMITTED
              ..1. ....      PDEAPRCQ       X'20' MSGBLOK QUEUED ON RECEIVE
                                            QUEUE
              ...1 ....      PDEAPSNQ       X'10' MSGBLOK QUEUED ON SEND
                                            QUEUE
              .... 1...      PDEAPPND       X'08' FUNCTION PENDING ON THIS
                                            PATH
              .... .1..      PDEAPSRQ       X'04' SENDREQ PENDING ON THIS
                                            PATH
              .... ..1.      PDEAPMPD       X'02' MESSAGE PENDING BUT NOT IN
                                            RECEIVE STATE
              .... ...1      PDEPURGE       X'01' IUCV PURGE allowed on this
                                            path
         NOTES : PDESTATE IS AN EXTERNAL VALUE. IF A NEW STATE IS ADDED THERE
         ARE TABLES IN THE MODULES WHICH HANDLE SEND, RECEIVE AND SEVER
         PROCESSING WHICH HAVE CORRESPONDING ENTRIES ADDED.
    000E   14 Bitstring    1 PDESTATE       APPC/VM STATE CODES
              .... ...1      PDESRSET       X'01' PATH IN RESET STATE
              .... ..1.      PDESTCON       X'02' PATH IN CONNECT STATE
              .... ..11      PDESTSND       X'03' PATH IN SEND STATE
              .... .1..      PDESTRCV       X'04' PATH IN RECEIVE STATE
              .... .1.1      PDESTCFM       X'05' PATH IN CONFIRM STATE
              .... .11.      PDESTSVR       X'06' PATH IN SEVER STATE
              .... .111      PDESDEFR       X'07' PATH IN DEFER_RECEIVE STATE
              .... 1...      PDESDEFS       X'08' PATH IN DEFER_SEVER STATE
              .... 1..1      PDESPREP       X'09' PATH IN PREPARE_RECEIVED
                                            STATE
              .... 1.1.      PDESSRCM       X'0A' PATH IN STATE ...
                                            SOLICITED_REQUEST_COMMIT_RECEIVED
              .... 1.11      PDESURCM       X'0B' PATH IN STATE ...
                                            UNSOLICITED_REQUEST_COMMIT_RECEIV
                                            ED
              .... 11..      PDESCMTD       X'0C' PATH IN COMMITED_RECEIVED
                                            STATE
              .... 11.1      PDESBOUT       X'0D' PATH IN BACKOUT_RECEIVED
                                            STATE
              .... 111.      PDESBKRQ       X'0E' PATH IN BACKOUT_REQUIRED
                                            STATE
    000F   15 Bitstring    1 PDEAPPF2       SECOND APPC/VM FLAG BYTE
              1... ....      PDECMSRV       X'80' COMMUNICATION SERVER PATH
              .1.. ....      PDELGDOK       X'40' WILLING TO RECEIVE LOG_DATA
              ..1. ....      PDELGDAT       X'20' LOG_DATA PENDING ON PATH
              ...1 ....      PDELDSVR       X'10' PATH SEVERED WITH LOG_DATA
              .... 1...      PDETGOK        X'08' TARGET PATH IS STILL VALID
              .... .1..      PDESNCPT       X'04' SYNCPT FLOWS ALLOWED ON
                                            PATH
              .... ..1.      PDECHGDR       X'02' CHANGE DIRECTION IS OK
              .... ...1      PDEPDSPF       X'01' SETSTATE INV- SYNCPT FLOW
                                            PENDING
    0010   16 Bitstring    1 PDEAPPF3       THIRD APPC/VM FLAG BYTE
              1... ....      PDELRCNV       X'80' ONLY FIRST BYTE OF LOGICAL
                                            RECORD LENGTH AVAILABLE IN
                                            CURRENT BUFFER
              .1.. ....      PDEACIMM       X'40' ALLOCATE STATE AND RECEIVE
                                            STATE
              ..1. ....      PDESTBKR       X'20' BACKOUT_REQUIRED SET VIA
                                            SETSTATE
              ...1 ....      PDEMDRCV       X'10' REQUEST RECEIVE STATE
                                            MODIFIER
              .... 1...      PDEMDSVR       X'08' REQUEST SEVER STATE
                                            MODIFIER
              .... .1..      PDEGOTPR       X'04' PREPARE RECEIVED ON PATH
              .... ..1.      PDESNTPR       X'02' PREPARE SENT ON PATH
              .... ...1      PDESNCIP       X'01' SYNCPOINT IN PROGRESS
    0011   17 Bitstring    1 PDEAPPF4       STATE RELATED FIELDS CONTROL
              1... ....      PDENEWLU       X'80' PARTNER SUPPORTS RECEIVING
                                            LUWID
              .1.. ....      PDEPHAS2       X'40' IN 2ND PHASE OF 2-PHASE
                                            SYNCPT
              ..1. ....      PDEAPPCW       X'20' PATH IN APPCVM WAIT
              ...1 ....      PDESUSPC       X'10' PATH IN SUSPENDED CONNECT
              .... 1...      PDEALLAV       X'08' PDESADDR IS VALID CONBK
                                            ADDRESS CONBK IS ALLOCATION DATA
              .... .1..      PDECCED        X'04' PDESADDR IS VALID CCED
                                            ADDRESS
              .... ..1.      PDEALTID       X'02' THIS PATH SET VMDALTID,
                                            SEVERING THIS PATH WILL CLEAR IT
              .... ...1      PDELUWID       X'01' STOP SENDBACK, SENDERR FOR
                                            NOW
    0012   18 Signed       2 PDELRECL       LENGTH REMAINING IN LOGICAL
                                            RECORD
    0014   20 Signed       4 PDESADDR       STATE RELATED ADDRESS IUSBK OR
                                            CONBK ADDRESS
    0018   24 Signed       2 PDEMSGLM       MESSAGE LIMIT
    001A   26 Bitstring    1 PDESAVST       PREVIOUS STATE OF PATH
    001B   27 Bitstring    1 PDEAPPF5       FIFTH FLAG BYTE
              1... ....      PDECANCL       X'80' Suspended CONNECT has been
                                            can- celled, blocks will be
                                            released
              .... 1...      PDESVSIP       X'08' SEVER ISSUED DURING SYNCPT
              .... .1..      PDEPBRIP       X'04' PARTNER SPECIFIED RIP ON
                                            BACKOUT
              .... ..1.      PDELGPRT       X'02' LOG DATA PARTIALLY RECEIVED
              .... ...1      PDELGSNC       X'01' LOG DATA SENT DURING SYNCPT
    001C   28 Address      4 PDEPPA         Address of the PPA block for this
                                            connection.
              00000004       PDESIZE        (*-PDEBK+7)/8 PDEBK SIZE IN
                                            DOUBLEWORDS
         NOTES : IN ORDER FOR THE PDEBK MANAGEMENT CODE TO WORK PROPERLY THE
         FOLLOWING TWO VALUES MUST ALWAYS BE ROUNDED TO THE NEAREST DOUBLE WORD
         VALUE.
              00000008       PDENTMIN       8 MIN NUMBER OF PDEBKS TO BE
                                            BUILT
              00000080       PDENTMAX       128 MAXIMUM PDEBKS IN A PDSEG

#### PDEBK Storage Layout

    *** PDEBK - PATH DESCRIPTOR ENTRY
    *
    *     +-------------+-------------+---------------------------+
    *   0 |  PDEMSGCT   |  PDETGPID   |         PDETGCCT          |
    *     +-------------+-------------+------+------+------+------+
    *   8 |         PDETGLKA          |:FLAGS|:APPFL|:STATE|:APPF2|
    *     +------+------+-------------+------+------+------+------+
    *  10 |:APPF3|:APPF4|  PDELRECL   |         PDESADDR          |
    *     +------+------+------+------+---------------------------+
    *  18 |  PDEMSGLM   |:SAVST|:APPF5|          PDEPPA           |
    *     +-------------+------+------+---------------------------+
    *  20
    *
    *** PDEBK - PATH DESCRIPTOR ENTRY

#### PDEBK Cross Reference

    Symbol         Dspl Value
    -------------- ---- -----
    PDEACIMM       0010 40
    PDEALLAV       0011 08
    PDEALTID       0011 02
    PDEAPMPD       000D 02
    PDEAPPC        000D 80
    PDEAPPCW       0011 20
    PDEAPPFL       000D
    PDEAPPF2       000F
    PDEAPPF3       0010
    PDEAPPF4       0011
    PDEAPPF5       001B
    PDEAPPND       000D 08
    PDEAPRCQ       000D 20
    PDEAPSCF       000D 40
    PDEAPSNQ       000D 10
    PDEAPSRQ       000D 04
    PDECANCL       001B 80
    PDECCED        0011 04
    PDECHGDR       000F 02
    PDECMSRV       000F 80
    PDECNTRL       000C 04
    PDEFLAGS       000C
    PDEGOTPR       0010 04
    PDELDSVR       000F 10
    PDELGDAT       000F 20
    PDELGDOK       000F 40
    PDELGPRT       001B 02
    PDELGSNC       001B 01
    PDELRCNV       0010 80
    PDELRECL       0012
    PDELUWID       0011 01
    PDEMDRCV       0010 10
    PDEMDSVR       0010 08
    PDEMSGCT       0000
    PDEMSGLM       0018
    PDENEWLU       0011 80
    PDENTMAX       001C 00000080
    PDENTMIN       001C 00000008
    PDEPBRIP       001B 04
    PDEPDSPF       000F 01
    PDEPEND1       000C 02
    PDEPEND2       000C 01
    PDEPHAS2       0011 40
    PDEPHELD       000C 08
    PDEPPA         001C
    PDEPRMD        000C 10
    PDEPRTY        000C 20
    PDEPURGE       000D 01
    PDESADDR       0014
    PDESAVST       001A
    PDESBKRQ       000E 0E
    PDESBOUT       000E 0D
    PDESCMTD       000E 0C
    PDESDEFR       000E 07
    PDESDEFS       000E 08
    PDESEND        000C 40
    PDESEVRD       000C 00000003
    PDESIZE        001C 00000004
    PDESNCIP       0010 01
    PDESNCPT       000F 04
    PDESNTPR       0010 02
    PDESPREP       000E 09
    PDESRSET       000E 01
    PDESSRCM       000E 0A
    PDESTATE       000E
    PDESTBKR       0010 20
    PDESTCFM       000E 05
    PDESTCON       000E 02
    PDESTRCV       000E 04
    PDESTSND       000E 03
    PDESTSVR       000E 06
    PDESURCM       000E 0B
    PDESUSPC       0011 10
    PDESVSIP       001B 08
    PDETGCCT       0004
    PDETGLKA       0008
    PDETGOK        000F 08
    PDETGPID       0002
    PDEVALID       000C 80
    PDEZERO        000C 00

This information is based on z/VM V4R4.0. Last updated on 29 Jul 2003 at 15:58:26 EDT.
Copyright IBM Corporation, 1990, 2003