Programming Interface Information: This information is NOT intended to be used as Programming Interfaces of z/VM.

#### 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

#### CNUBK Cross Reference

    Symbol         Dspl Value
    -------------- ---- -----
    CNUBSIZE       000C 00000010
    CNUCNREV       0008 00000002
    CNUENTSD       000C
    CNUEXTSZ       0034 00000028
    CNUFCODE       0008
    CNUFLAG        0009
    CNUFLAG1       0030
    CNUFLUSH       0030 80
    CNUGLOBL       0009 00000080
    CNUGWNOD       0020
    CNUHOPS        0028
    CNUIDFY        0008 00000001
    CNUIGNOR       0009 00000004
    CNUINST        002A
    CNUNODRQ       0009 00000008
    CNUOWNOD       0018
    CNUPATH        002C
    CNUPXSEC       0009 00000001
    CNURELST       0009 00000002
    CNURESID       0000
    CNURINDR       0009 00000010
    CNURTYPE       000B
    CNUSECNO       0009 00000040
    CNUSIZE        0034 00000007
    CNUSVRCD       000A
    CNUSYSTM       0009 00000020
    CNUTGATE       000B 00000001
    CNUTREG        000B 00000000
    CNUVMID        0010

This information is based on z/VM V5R2.0. Last updated on 12 Apr 2006 at 16:45:39 EDT.
Copyright IBM Corporation, 1990, 2005