CONBK | Back to Index page

| Prolog Control Block Contents CONBK DSECT Storage Layout Cross Reference (Contains links to field and bit definitions) |
Programming Interface Information: This information is NOT intended to be used as Programming Interfaces of z/VM.

CONBK Prolog | Top of page

     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)
     RELOCATION CONSIDERATIONS : None
     NOTES      : THIS COPY FILE REQUIRES THE FOLLOWING IN ORDER
                  TO GENERATE PROPERLY:
                  - IPARMLX
                  - HCPMSGBK
                  - HCPCNUBK

CONBK Control Block Content | Top of page

     CONBK DSECT
    Top of page

    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' CONRNONE SECURTY(NONE) ON
                                            CONNECT OK
              ...1 ....      CONRINDR       X'10' CONRINDR This is an
                                            indirect connect
    00EA  234 Bitstring    1 *              RESERVED
    00EB  235 Bitstring    1 CONRTYPE       TYPE OF RESOURCE PROVIDED
              00000001       CONRGATE       X'01' CONRGATE 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' CONVIDVL 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.
    01D4  468 Character    8 CONVSLAB       Source VMDSLAB value
              000000A4       CONVFIX        *-CONVSIIL VM AREA FIXED FIELDS
                                            LENGTH
              000000AC       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.
    01DC  476 Bitstring  131 CONFMH5 (0)    FMH5 ATTACH
    01DC  476 Bitstring    1 *              FMH5 TOTAL LENGTH
    01DD  477 Bitstring    1 *              TYPE IS FMH5 (X'12')
    01DE  478 Bitstring    2 *              ATTACH CMD CODE (X'02FF')
    01E0  480 Bitstring    1 CONFFLAG       FLAG FIELD
              1... ....      CONFAV         X'80' CONFAV ALREADY-VERIFIED
                                            INDICATOR
              .... 1...      CONFPIP        X'08' CONFPIP PIP PRESENT
              00000005       CONFFIXL       *-CONFMH5 1ST 5 BYTES ARE FIXED
    01E1  481 Bitstring    1 *              FIXED LENGTH FIELDS LENGTH
    01E2  482 Bitstring    1 CONFTYPE       CONVERSATION TYPE
              000000D0       CONFBASC       X'D0' CONFBASC BASIC CONVERSATION
              000000D1       CONFMAPC       X'D1' CONFMAPC MAPPED
                                            CONVERSATION
    01E3  483 Bitstring    1 *              RESERVED
    01E4  484 Bitstring    1 CONFSYNC       SYNCHRONIZATION LEVEL
              00000080       CONFSYPT       X'80' CONFSYPT SYNCLVL=SYNCPT,
                                            CNF, BKOUT
              00000040       CONFCONF       X'40' CONFCONF SYNCLVL=CONFIRM
    01E5  485 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.
    01E6  486 Character   64 CONFTPN        TRANSACTION PROGRAM NAME
              0000004A       CONFLEN        *-CONFMH5 MAXIMUM FMH5 LENGTH
    0226  550 Bitstring   21 *              SECURITY AREA OF FMH5
    023B  571 Character   27 CONFLUW (0)    LUWID FIELDS
    023B  571 Bitstring    1 CONFLUWL       LUWID FIELD LENGTH
    023C  572 Character   26 CONFLUWI       LUWID
    0256  598 Character    9 CONFCCF (0)    CONVERSAT CORRELATOR FIELDS
    0256  598 Bitstring    1 CONFCCL        CONVERSATION CORRELATOR LEN
    0257  599 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.
    025F  607 Bitstring  500 CONSGIDV (0)   Beginning of SGID information
    025F  607 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.
    0453 1107 Bitstring    8 CONCOMSV (0)
    0453 1107 Bitstring    1 CONCFLAG       FLAG BYTE
              .1.. ....      CONCPBFL       X'40' CONCPBFL PIP ADDRESS IS
                                            BUFFER LIST NOTES : CONCPBFL MUST
                                            MATCH IPXPBUFL'S VALUE IN IPARMLX
                                            COPY
    0454 1108 Bitstring    2 CONCPLEN       LENGTH OF PIP DATA
    0456 1110 Bitstring    1 *              RESERVED
    0457 1111 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.
              0000008C       CONBKSZ        (*-CONBK+7)/8 SIZE OF CONBK IN
                                            DOUBLEWORDS

CONBK Storage Layout | Top of page

    *** 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)           |        CONVSLAB-          |
    *     +---------------------------+------+------+-------------+
    * 1D8 |          -(1D4)           |//////|//////|/////////////|
    *     +------+------+------+------+------+------+-------------+
    * 1E0 |:FFLAG|//////|:FTYPE|//////|:FSYNC|:FTPNL|             |
    *     +------+------+------+------+------+------+             |
    * 1E8 |                                                       |
    *     =                       CONFTPN                         =
    *     |                                         +-------------+
    *     |                                         |/////////////|
    *     +-----------------------------------------+/////////////|
    * 228 |///////////////////////////////////////////////////////|
    *     =///////////////////////////////////////////////////////=
    *     |////////////////////+------+---------------------------+
    * 238 |////////////////////|:FLUWL|                           |
    *     +--------------------+------+                           |
    * 240 |                                                       |
    *     =                       CONFLUWI                        =
    *     |                                         +------+------+
    * 250 |                                         |:FCCL |(257)-|
    *     +-----------------------------------------+------+------+
    * 258 |                    -CONFCC                     |      |
    *     +------------------------------------------------+      |
    * 260 |                                                       |
    *     =                       CONSGIDS                        =
    *     |                    +------+-------------+------+------+
    * 450 |                    |:CFLAG|  CONCPLEN   |//////|(457)-|
    *     +--------------------+------+-------------+------+------+
    * 458 |     -CONCPADR      | 45B
    *     +--------------------+
    *
    *** CONBK - APPCVM CONNECT BLOCK

CONBK Cross Reference | Top of page

    Symbol         Dspl Value
    -------------- ---- -----
    CONADLEN       00A4
    CONALTID       0120
    CONBKSZ        0457 0000008C
    CONCFLAG       0453
    CONCOMSV       0453
    CONCPADR       0457
    CONCPBFL       0453 40
    CONCPLEN       0454
    CONCSIZE       0457 00000001
    CONFAV         01E0 80
    CONFBASC       01E2 000000D0
    CONFCC         0257
    CONFCCF        0256
    CONFCCL        0256
    CONFCONF       01E4 00000040
    CONFFIXL       01E0 00000005
    CONFFLAG       01E0
    CONFIXED       0128 00000130
    CONFLEN        01E6 0000004A
    CONFLUW        023B
    CONFLUWI       023C
    CONFLUWL       023B
    CONFMAPC       01E2 000000D1
    CONFMH5        01DC
    CONFPIP        01E0 08
    CONFSYNC       01E4
    CONFSYPT       01E4 00000080
    CONFTPN        01E6
    CONFTPNL       01E5
    CONFTYPE       01E2
    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       025F
    CONSGIDV       025F
    CONVALT        0198
    CONVCBLQ       01C4
    CONVCBPL       01C4
    CONVCBTL       01CC
    CONVCOML       0136
    CONVEGID       01B0
    CONVEUID       01AC
    CONVFIX        01D4 000000A4
    CONVFIXL       0132
    CONVIDFL       01A8
    CONVIDLN       01BC
    CONVIDVL       01A8 80
    CONVLFQ        0170
    CONVLFQL       0139
    CONVLKL        0150
    CONVLUQ        0150
    CONVMARE       0130
    CONVMLEN       01D4 000000AC
    CONVMODE       0140
    CONVPLKL       0160
    CONVPLUQ       0160
    CONVPTLU       0168
    CONVRFQ        0181
    CONVRFQL       013A
    CONVRGID       01B8
    CONVRUID       01B4
    CONVSII        0148
    CONVSIIL       0138
    CONVSLAB       01D4
    CONVTLU        0158
    CONVTOTL       0130
    CONVVARL       01C0
    CONVVCIT       01A0
    CONVVRSL       01C0 00000094

This information is based on z/VM 7.2.0 Last updated on 24 Jun 2020 at 09:27:27 EDT.
Copyright IBM Corporation, 1990, 2020