|
Programming Interface Information:
This information is NOT intended to be used as Programming Interfaces of z/VM. |
PTHBK
Control Block Contents
PTHBK DSECT
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
Copyright IBM Corporation, 1990, 2007