|
Programming Interface Information:
This information is NOT intended to be used as Programming Interfaces of z/VM. |
CONBK
Control Block Contents
CONBK DSECT
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 (20) 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 (7) ALLOCATE DATA MSGBLOK
*** Start of CNUBK map **** The value of CNUSIZE for datamap is 7
00E0 224 Bitstring 56 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
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 500 CONSGIDV (0) Beginning of SGID information
0257 599 Bitstring 500 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
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 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
Copyright IBM Corporation, 1990, 2002