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.
 RELOCATION CONSIDERATIONS : 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 CNUIDFY FUNCTION IS CONNECT TO
                                        IDENTIFY
          00000002       CNUCNREV       2 CNUCNREV FUNCTION IS CONNECT TO
                                        REVOKE
0009    9 Bitstring    1 CNUFLAG        SCOPE OF FUNCTION FLAG BYTE
          00000080       CNUGLOBL       X'80' CNUGLOBL RESOURCE IS A
                                        GLOBAL RESOURCE
          00000040       CNUSECNO       X'40' CNUSECNO SECURITY(NONE)
                                        INDICATION
          00000020       CNUSYSTM       X'20' CNUSYSTM SYSTEM RESOURCE
                                        INDICATION
          00000010       CNURINDR       X'10' CNURINDR Indirect resource
                                        (through TSAF)
          00000008       CNUNODRQ       X'08' CNUNODRQ Gateway node ID
                                        requested (ISFC)
          00000004       CNUIGNOR       X'04' CNUIGNOR Ignored identify
                                        request from ISFC
          00000002       CNURELST       X'02' CNURELST Release input
                                        CNUBK storage (ISFC)
          00000001       CNUPXSEC       X'01' CNUPXSEC 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 CNUTREG RESOURCE IS A
                                        REGISTERED RESOURCE
          00000001       CNUTGATE       1 CNUTGATE 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' CNUFLUSH 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 V6R2.0. Last updated on 21 Nov 2011 at 10:55:54 EDT.
Copyright IBM Corporation, 1990, 2011