Programming Interface Information:
This information is NOT intended to be used as Programming Interfaces of z/VM. |
CNUBK
Control Block Contents
CNUBK DSECT
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
Copyright IBM Corporation, 1990, 2011