|
Programming Interface Information:
This information is NOT
intended to be
used as Programming Interfaces of VM/ESA. It is to be used for diagnosis only. |
CONBK
Cross Reference (Contains links to field and bit definitions)
CONBK Prolog
NAME : HCPCONBK
DESCRIPTION: APPCVM CONNECT BLOCK
DSECT : CONBK
FUNCTION : CONTAINS INFORMATION RELATED TO AN APPCVM CONNECT
LOCATED BY : PDESADDR FIELD OF PDEBK (WHEN PDEALLAV IS SET)
DCRSCEXT FIELD OF DCRBK
CREATED BY : HCPIUP
DELETED BY : HCPIUB (ACCEPT PROCESSING)
HCPIUL (SEVER PROCESSING)
HCPIUN (RECEIVE PROCESSING)
HCPIUP (CONNECT PROCESSING)
HCPIUQ (DELAYED CONNECT PROCESSING)
NOTES : THIS COPY FILE REQUIRES THE FOLLOWING IN ORDER
TO GENERATE PROPERLY:
- IPARMLX
- HCPMSGBK
- HCPCNUBK
CONBK Control Block Content
CONBK DSECT
Hex Dec Type/Val Lng Label (dup) Comments ---- ---- --------- ---- -------------- -------- 0000 0 Structure CONBK APPCVM CONNECT BLOCK NOTES : WHEN THE INVOKER OF APPCVM CONNECT SPECIFIES FMH5=NO, ANY DATA PROVIDED BY THE INVOKER IN THE CONNECTION PARAMETER LIST EXTENSION (CPLE) IS PLACED IN THE CONIDATA AREA OF CONBK. THE ADDRESS AND LENGTH OF THE CPLE IS PROVIDED BY THE INVOKER IN IPBFADR2 AND IPBFLN2F. CP WILL USE THIS INFORMATION WHEN BUILDING THE ALLOCATE DATA PORTION OF THIS CONTROL BLOCK. THE CONIDATA AREA IS MAPPED BY THE IPARMLX DSECT IN IPARMLX COPY. **** THE VALUE OF IPXDWSIZ FOR DATAMAP IS 20 0000 0 Dbl-Word 8 CONIDATA (IPXDWSIZ) CON EXT PLIST INPUT AREA 00A0 160 Signed 4 CONLENTH EXTENSION LENGTH IN DOUBLEWORDS 00A4 164 Signed 4 CONADLEN ACTUAL ALLOCATE DATA LENGTH **** THE VALUE OF MSGSIZE FOR DATAMAP IS 7 00A8 168 Dbl-Word 8 CONMSGBK (MSGSIZE) ALLOCATE DATA MSGBLOK *** Start of CNUBK map **** The value of CNUSIZE for datamap is 7 00E0 224 Bitstring 0 CONRWORK (0) INPUT TO HCPIDRFN 00E0 224 Character 8 CONRNAME RESOURCE/GATEWAY NAME 00E8 232 Bitstring 1 * RESERVED 00E9 233 Bitstring 1 CONRSLVL RESOURCE'S SECURITY LEVEL .1.. .... CONRNONE X'40' SECURTY(NONE) ON CONNECT OK ...1 .... CONRINDR X'10' This is an indirect connect 00EA 234 Bitstring 1 * RESERVED 00EB 235 Bitstring 1 CONRTYPE TYPE OF RESOURCE PROVIDED 00000001 CONRGATE X'01' CONRNAME CONTAINS A GATEWAY 00EC 236 Bitstring 4 * RESERVED 00F0 240 Character 8 CONRUSER USERID OF RESOURCE OWNER 00F8 248 Bitstring 32 * Reserved *** End of CNUBK map 0118 280 Bitstring 1 CONPSWDL LENGTH OF PSWD TO ENCRYPT 0119 281 Bitstring 3 * RESERVED 011C 284 Signed 4 CONPSWDA ADDR OF PSWD TO ENCRYPT 0120 288 Character 8 CONALTID SOURCE'S VMDALTID VALUE NOTES : THE NODE PORTION OF THE ALLOCATE DATA FOLLOWS. THIS IS NEVER PROVIDED BY THE SOURCE OF THE CONNECT. IT IS FILLED IN BY CP AFTER A BROADCAST REQUEST TO LOCATE A PRIVATE SERVER IN THE COLLECTION. THIS IS ONLY PART OF THE ALLOCATE DATA WHEN WE ARE ROUTING A PRIVATE SERVER CONNECT THROUGH TSAF TO ANOTHER NODE IN THE COLLECTION. TSAF NEEDS THIS INFORMATION IN ORDER TO ROUTE THE CONNECT TO THE NODE WHERE THE PRIVATE SERVER IS LOCATED. 0128 296 Character 8 CONNODE USERS NODE IN COLLECTION 00000130 CONFIXED *-CONBK FIXED LENGTH OF CONBK NOTES : THE VM AREA AND FMH5 PORTION OF THE ALLOCATE DATA FOLLOWS. WHEN FMH5=YES, THE INVOKER OF CONNECT PROVIDES THIS DATA. HENCE THE SIZE OF THIS AREA WILL VARY AND ONLY CONVMARE, CONVTOTL, CONVFIXL AND CONVCOML CAN BE REFERENCED DIRECTLY. WHEN FMH5=NO, CP BUILDS THE ALLOCATE DATA. HENCE THE SIZE OF THIS AREA IS FIXED AND REPRESENTS THE LARGEST POSSIBLE VM AREA/FMH5 CP CAN BUILD. 0130 304 Character 164 CONVMARE (0) VM AREA OF ALLOCATE DATA 0130 304 Signed 2 CONVTOTL TOTAL LENGTH 0132 306 Signed 2 CONVFIXL FIXED LENGTH FIELDS LENGTH 0134 308 Signed 2 * RESERVED 0136 310 Signed 2 CONVCOML VM COM SERVER AREA LENGTH 0138 312 Bitstring 1 CONVSIIL SESSION INSTANCE ID LENGTH 0139 313 Bitstring 1 CONVLFQL LOCAL FULLY QUAL LU LENGTH 013A 314 Bitstring 1 CONVRFQL REMOTE FULLY QUAL LU LENGTH 013B 315 Character 5 * RESERVED 0140 320 Character 8 CONVMODE MODE NAME SPECIFIED 0148 328 Character 8 CONVSII SESSION INSTANCE IDENTIFIER 0150 336 Character 16 CONVLKL (0) LOCALLY KNOWN LUNAME 0150 336 Character 8 CONVLUQ LUNAME QUALIFIER 0158 344 Character 8 CONVTLU TARGET LUNAME 0160 352 Character 16 CONVPLKL (0) PARTNER LOCAL KNOWN LUNAME 0160 352 Character 8 CONVPLUQ PARTNER LUNAME QUALIFIER 0168 360 Character 8 CONVPTLU PARTNER TARGET LUNAME 0170 368 Character 17 CONVLFQ LOCAL FULLY QUALIFIED LU 0181 385 Character 17 CONVRFQ REMOTE FULLY QUALIFIED LU 0192 402 Character 6 * RESERVED 0198 408 Character 8 CONVALT "CURRENT" ALTID FOR TARGET 01A0 416 Character 8 CONVVCIT VIRT CONFIGURATION ID TOKEN The next set of information, along with the variable-length supplementary group ID (SGID) information, is passed on each connect so that the server at the other end can have access to POSIX access control information. 01A8 424 Bitstring 1 CONVIDFL Access control flags 1... .... CONVIDVL X'80' The UID/GID information has been filled in. 01A9 425 Bitstring 3 * Reserved for IBM use. 01AC 428 Signed 4 CONVEUID Effective UID of the process issuing the CONNECT. 01B0 432 Signed 4 CONVEGID Effective GID of the process issuing the CONNECT. 01B4 436 Signed 4 CONVRUID Real UID of the process issuing the CONNECT. 01B8 440 Signed 4 CONVRGID Real GID of the process issuing the CONNECT. 01BC 444 Signed 4 CONVIDLN Length of the supplementary GID information (may be in the range zero to NGMAXMAX*4). 01C0 448 Signed 4 CONVVARL Total length of the VM-defined variable length section of this block. This section begins after the FMH5 and is followed by the communication server area. 00000094 CONVVRSL *-CONVMARE VMA area length including the variable-length section length field. This field must be distinct from CPEVMLEN to allow future expansion. 01C4 452 Character 16 CONVCBPL (0) Partner LUNAME to use in connecting back to the partner. 01C4 452 Character 8 CONVCBLQ LUNAME qualifier to use in connecting back to the partner. Contains one of the following: *USERID if the connection originated on the same system as the target. (The value is equal to that in CONVPLUQ.) <gatelu> if the connection is through AVS or an unknown comserv. (The value is equal to that in CONVPLUQ.) <system gateway name of originating system> if the connection is through ISFC or TSAF. <system gateway name of the gateway system> if the connection is passing from a CS collection to a TSAF collection or vice versa. 01CC 460 Character 8 CONVCBTL Target luname to use in connecting back to the partner. This should always be equal to CONVPTLU; it's added here for ease of use. 0000009C CONVFIX *-CONVSIIL VM AREA FIXED FIELDS LENGTH 000000A4 CONVMLEN *-CONVMARE LENGTH OF VM AREA NOTES : HCPIUP CONTAINS THE TEMPLATE FOR INITIALIZING THE FIRST 10 BYTES OF THE FMH5 THAT CP BUILDS. SOME OF THESE VALUES WILL BE OVERRIDEN IN HCPIUP BASED ON INFORMATION PROVIDED BY THE SOURCE OF THE CONNECT. 01D4 468 Bitstring 131 CONFMH5 (0) FMH5 ATTACH 01D4 468 Bitstring 1 * FMH5 TOTAL LENGTH 000000FF CONFMXLN 255 Maximum length of the FMH5 01D5 469 Bitstring 1 * TYPE IS FMH5 (X'12') 01D6 470 Bitstring 2 * ATTACH CMD CODE (X'02FF') 01D8 472 Bitstring 1 CONFFLAG FLAG FIELD 1... .... CONFAV X'80' ALREADY-VERIFIED INDICATOR .... 1... CONFPIP X'08' PIP PRESENT 00000005 CONFFIXL *-CONFMH5 1ST 5 BYTES ARE FIXED 01D9 473 Bitstring 1 * FIXED LENGTH FIELDS LENGTH 01DA 474 Bitstring 1 CONFTYPE CONVERSATION TYPE 000000D0 CONFBASC X'D0' BASIC CONVERSATION 000000D1 CONFMAPC X'D1' MAPPED CONVERSATION 01DB 475 Bitstring 1 * RESERVED 01DC 476 Bitstring 1 CONFSYNC SYNCHRONIZATION LEVEL 00000080 CONFSYPT X'80' SYNCLVL=SYNCPT, CNF, BKOUT 00000040 CONFCONF X'40' SYNCLVL=CONFIRM 01DD 477 Bitstring 1 CONFTPNL TRANSACTION PRG NAME LENGTH NOTES : THE TPN, SECURITY AREA, LUWID THAT CP BUILDS CAN VARY IN SIZE UP TO THE MAXIMUM SIZE DEFINED HERE. YOU MUST CALCULATE ADDRESSABILITY TO THE FOLLOWING LABELS WHEN BUILDING THE FMH5. 01DE 478 Character 64 CONFTPN TRANSACTION PROGRAM NAME 0000004A CONFLEN *-CONFMH5 MAXIMUM FMH5 LENGTH 021E 542 Bitstring 21 * SECURITY AREA OF FMH5 0233 563 Character 27 CONFLUW (0) LUWID FIELDS 0233 563 Bitstring 1 CONFLUWL LUWID FIELD LENGTH 0234 564 Character 26 CONFLUWI LUWID 024E 590 Character 9 CONFCCF (0) CONVERSAT CORRELATOR FIELDS 024E 590 Bitstring 1 CONFCCL CONVERSATION CORRELATOR LEN 024F 591 Character 8 CONFCC CONVERSATION CORRELATOR Beginning of the VM-defined variable-length section. This section directly follows the FMH5 and precedes the communication server area. It consists of zero or more variable-length areas. The sum of the lengths of all of the information in this section is defined in CONVVARL. Supplementary GID information area This section comes immediately after the FMH5 and contains the supplementary group IDs (part of the set of POSIX access control values). The length of this section is in CONVIDLN in the VMA area; if the length is zero, there are no supplementary group IDs. The valid range for the length is zero to NGMAXMAX*4; APPC/VM connect processing checks to ensure that this area does not grow too big for APPC/VM connect processing to handle. Each SGID is four bytes long. The first starts at displacement zero in this area, the second at displacement four, and so on. 0257 599 Bitstring 0 CONSGIDV (0) Beginning of SGID information 0257 599 Bitstring 0 CONSGIDS Supplementary GIDs End of the VM-defined variable-length section. NOTES : THE VM COMMUNICATIONS SERVER AREA PORTION OF THE ALLOCATE DATA FOLLOWS. WHEN FMH5=YES, A COMMUNICATION SERVER CAN PROVIDE THIS AREA ON CONNECT. THIS INFORMATION IS NOT PASSED ON TO THE TARGET OF THE CONNECT. 044B 1099 Bitstring 8 CONCOMSV (0) 044B 1099 Bitstring 1 CONCFLAG FLAG BYTE .1.. .... CONCPBFL X'40' PIP ADDRESS IS BUFFER LIST NOTES : CONCPBFL MUST MATCH IPXPBUFL'S VALUE IN IPARMLX COPY 044C 1100 Bitstring 2 CONCPLEN LENGTH OF PIP DATA 044E 1102 Bitstring 1 * RESERVED 044F 1103 Bitstring 4 CONCPADR ADDRESS OF PIP DATA 00000001 CONCSIZE (*-CONCOMSV+7)/8 CONCOMSV SIZE IN DOUBLEWORDS Block size - to be used only by the creator of the block. 0000008B CONBKSZ (*-CONBK+7)/8 SIZE OF CONBK IN DOUBLEWORDS
CONBK Storage Layout
*** CONBK - APPCVM CONNECT BLOCK * * +-------------------------------------------------------+ * 0 | | * = CONIDATA = * | | * +---------------------------+---------------------------+ * A0 | CONLENTH | CONADLEN | * +---------------------------+---------------------------+ * A8 | | * = CONMSGBK = * | | * +-------------------------------------------------------+ * E0 | CONRNAME | * +------+------+------+------+---------------------------+ * E8 |//////|:RSLVL|//////|:RTYPE|///////////////////////////| * +------+------+------+------+---------------------------+ * F0 | CONRUSER | * +-------------------------------------------------------+ * F8 |///////////////////////////////////////////////////////| * =///////////////////////////////////////////////////////= * |///////////////////////////////////////////////////////| * +------+--------------------+---------------------------+ * 118 |:PSWDL|////////////////////| CONPSWDA | * +------+--------------------+---------------------------+ * 120 | CONALTID | * +-------------------------------------------------------+ * 128 | CONNODE | * +-------------+-------------+-------------+-------------+ * 130 | CONVTOTL | CONVFIXL |/////////////| CONVCOML | * +------+------+------+------+-------------+-------------+ * 138 |:VSIIL|:VLFQL|:VRFQL|//////////////////////////////////| * +------+------+------+----------------------------------+ * 140 | CONVMODE | * +-------------------------------------------------------+ * 148 | CONVSII | * +-------------------------------------------------------+ * 150 | CONVLUQ | * +-------------------------------------------------------+ * 158 | CONVTLU | * +-------------------------------------------------------+ * 160 | CONVPLUQ | * +-------------------------------------------------------+ * 168 | CONVPTLU | * +-------------------------------------------------------+ * 170 | | * = CONVLFQ = * | +------------------------------------------------+ * 180 | | | * +------+ | * | CONVRFQ | * | +-----------------------------------------+ * 190 | |/////////////////////////////////////////| * +-------------+-----------------------------------------+ * 198 | CONVALT | * +-------------------------------------------------------+ * 1A0 | CONVVCIT | * +------+--------------------+---------------------------+ * 1A8 |:VIDFL|////////////////////| CONVEUID | * +------+--------------------+---------------------------+ * 1B0 | CONVEGID | CONVRUID | * +---------------------------+---------------------------+ * 1B8 | CONVRGID | CONVIDLN | * +---------------------------+---------------------------+ * 1C0 | CONVVARL | CONVCBLQ- | * +---------------------------+---------------------------+ * 1C8 | -(1C4) | CONVCBTL- | * +---------------------------+------+------+-------------+ * 1D0 | -(1CC) |//////|//////|/////////////| * +------+------+------+------+------+------+-------------+ * 1D8 |:FFLAG|//////|:FTYPE|//////|:FSYNC|:FTPNL| | * +------+------+------+------+------+------+ | * 1E0 | | * = CONFTPN = * | +-------------+ * | |/////////////| * +-----------------------------------------+/////////////| * 220 |///////////////////////////////////////////////////////| * =///////////////////////////////////////////////////////= * |////////////////////+------+---------------------------+ * 230 |////////////////////|:FLUWL| | * +--------------------+------+ | * 238 | | * = CONFLUWI = * | +------+------+ * 248 | |:FCCL |(24F)-| * +-----------------------------------------+------+------+ * 250 | -CONFCC | | * +------------------------------------------------+ | * 258 | | * = CONSGIDS = * | +------+-------------+------+------+ * 448 | |:CFLAG| CONCPLEN |//////|(44F)-| * +--------------------+------+-------------+------+------+ * 450 | -CONCPADR | 453 * +--------------------+ * *** CONBK - APPCVM CONNECT BLOCK
CONBK Cross Reference
(contains links to field and bit definitions)Symbol Dspl Value -------------- ---- -----CONADLEN 00A4
CONALTID 0120
CONBKSZ 044F 0000008B
CONCFLAG 044B
CONCOMSV 044B
CONCPADR 044F
CONCPBFL 044B 40
CONCPLEN 044C
CONCSIZE 044F 00000001
CONFAV 01D8 80
CONFBASC 01DA 000000D0
CONFCC 024F
CONFCCF 024E
CONFCCL 024E
CONFCONF 01DC 00000040
CONFFIXL 01D8 00000005
CONFFLAG 01D8
CONFIXED 0128 00000130
CONFLEN 01DE 0000004A
CONFLUW 0233
CONFLUWI 0234
CONFLUWL 0233
CONFMAPC 01DA 000000D1
CONFMH5 01D4
CONFMXLN 01D4 000000FF
CONFPIP 01D8 08
CONFSYNC 01DC
CONFSYPT 01DC 00000080
CONFTPN 01DE
CONFTPNL 01DD
CONFTYPE 01DA
CONIDATA 0000
CONLENTH 00A0
CONMSGBK 00A8
CONNODE 0128
CONPSWDA 011C
CONPSWDL 0118
CONRGATE 00EB 00000001
CONRINDR 00E9 10
CONRNAME 00E0
CONRNONE 00E9 40
CONRSLVL 00E9
CONRTYPE 00EB
CONRUSER 00F0
CONRWORK 00E0
CONSGIDS 0257
CONSGIDV 0257
CONVALT 0198
CONVCBLQ 01C4
CONVCBPL 01C4
CONVCBTL 01CC
CONVCOML 0136
CONVEGID 01B0
CONVEUID 01AC
CONVFIX 01CC 0000009C
CONVFIXL 0132
CONVIDFL 01A8
CONVIDLN 01BC
CONVIDVL 01A8 80
CONVLFQ 0170
CONVLFQL 0139
CONVLKL 0150
CONVLUQ 0150
CONVMARE 0130
CONVMLEN 01CC 000000A4
CONVMODE 0140
CONVPLKL 0160
CONVPLUQ 0160
CONVPTLU 0168
CONVRFQ 0181
CONVRFQL 013A
CONVRGID 01B8
CONVRUID 01B4
CONVSII 0148
CONVSIIL 0138
CONVTLU 0158
CONVTOTL 0130
CONVVARL 01C0
CONVVCIT 01A0
CONVVRSL 01C0 00000094
Last updated on 3 Aug 1999 at 11:47:13 EDT.
Copyright IBM Corporation, 1990, 1999