IBM: CNUBK

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.

CNUBK

Prolog

Control Block Contents

CNUBK DSECT

Storage Layout

Cross Reference (Contains links to field and bit definitions)

CNUBK Prolog

 NAME       : HCPCNUBK
 DESCRIPTION: USER DATA MAPPING FOR *IDENT
 DSECT      : CNUBK
 FUNCTION   : PROVIDES A MAPPING OF THE USER DATA AREA PASSED
              BY A VIRTUAL MACHINE (AUTHORIZED TO IDENTIFY/REVOKE
              A PARTICULAR RESOURCE/GATEWAY) TO THE *IDENT SYSTEM
              SERVICE DURING CONNECT PROCESSING.
              NOTE THAT THE FIRST X'10' BYTES OF THE CNUBK MAP TO
              IPUSER IN THE IPARML.  THIS AREA SHOULD NEVER CHANGE.
 LOCATED BY : IPUSER IN THE IUCV/APPC PARAMATER LIST (IPARML),
              UNLESS CREATED BY ISFC.
 CREATED BY : CONNECTING VIRTUAL MACHINE OR ISFC.
              NOTES      : When adding fields to the CNUBK, 8 bytes
              must be added at a time. This is because
              the CONBK includes a CNUBK and specifies
              its length in terms of doublewords.
 DELETED BY : CONNECTING VIRTUAL MACHINE OR ISFC.
 SERIALIZED : NONE.

CNUBK Control Block Content


CNUBK DSECT
Hex   Dec Type/Val   Lng Label (dup)    Comments
---- ---- --------- ---- -------------- --------
0000    0 Structure      CNUBK          USER DATA MAPPING FOR *IDENT
0000    0 Character    8 CNURESID       RESOURCE ID
0008    8 Bitstring    1 CNUFCODE       FUNCTION CODE
          00000001       CNUIDFY        1 FUNCTION IS CONNECT TO IDENTIFY
          00000002       CNUCNREV       2 FUNCTION IS CONNECT TO REVOKE
0009    9 Bitstring    1 CNUFLAG        SCOPE OF FUNCTION FLAG BYTE
          00000080       CNUGLOBL       X'80' RESOURCE IS A GLOBAL
                                        RESOURCE
          00000040       CNUSECNO       X'40' SECURITY(NONE) INDICATION
          00000020       CNUSYSTM       X'20' SYSTEM RESOURCE INDICATION
          00000010       CNURINDR       X'10' Indirect resource (through
                                        TSAF)
          00000008       CNUNODRQ       X'08' Gateway node ID requested
                                        (ISFC)
          00000004       CNUIGNOR       X'04' Ignored identify request
                                        from ISFC
          00000002       CNURELST       X'02' Release input CNUBK storage
                                        (ISFC)
          00000001       CNUPXSEC       X'01' Server wishes to exchange
                                        information about POSIX security
                                        values with CP.
000A   10 Bitstring    1 CNUSVRCD       SEVER CODE
000B   11 Bitstring    1 CNURTYPE       TYPE OF RESOURCE
          00000000       CNUTREG        0 RESOURCE IS A REGISTERED
                                        RESOURCE
          00000001       CNUTGATE       1 RESOURCE IS A GATEWAY
000C   12 Address      4 CNUENTSD       Send routine (used internally)
          00000010       CNUBSIZE       *-CNUBK LENGTH OF CONNECT USER
                                        DATA AREA The following fields
                                        are not part of the normal
                                        connect user data. They serve as
                                        an extension and are referenced
                                        by HCPIDRFN or ISFC.
0010   16 Character    8 CNUVMID        FOR IDRFN OUTPUT, RESOURCE
                                        OWNER'S USERID IS PLACED HERE.
0018   24 Character    8 CNUOWNOD       ISFC node id
0020   32 Character    8 CNUGWNOD       ISFC gateway node id
0028   40 Signed       2 CNUHOPS        Number of ISFC hops to resource
002A   42 Signed       2 CNUINST        Instance number of the resource
002C   44 Signed       4 CNUPATH        Path ID to resource owner
0030   48 Bitstring    1 CNUFLAG1       Flags for ISFC functions
          1... ....      CNUFLUSH       X'80' Send (flush) any pending
                                        messages
0031   49 Bitstring    3 *              Reserved for IBM use
0034   52 Signed       4 *              Reserved for IBM use
          00000007       CNUSIZE        (*-CNUBK+7)/8 SIZE OF CNUBK IN
                                        DOUBLEWORDS
          00000028       CNUEXTSZ       *-CNUVMID SIZE OF EXTENSION IN
                                        BYTES

CNUBK Storage Layout

*** CNUBK - USER DATA MAPPING FOR *IDENT
*
*     +-------------------------------------------------------+
*   0 |                       CNURESID                        |
*     +------+------+------+------+---------------------------+
*   8 |:FCODE|:FLAG |:SVRCD|:RTYPE|         CNUENTSD          |
*     +------+------+------+------+---------------------------+
*  10 |                       CNUVMID                         |
*     +-------------------------------------------------------+
*  18 |                       CNUOWNOD                        |
*     +-------------------------------------------------------+
*  20 |                       CNUGWNOD                        |
*     +-------------+-------------+---------------------------+
*  28 |  CNUHOPS    |  CNUINST    |         CNUPATH           |
*     +------+------+-------------+---------------------------+
*  30 |:FLAG1|////////////////////|///////////////////////////|
*     +------+--------------------+---------------------------+
*  38
*
*** CNUBK - USER DATA MAPPING FOR *IDENT