|
Programming Interface Information:
This information is NOT intended to be used as Programming Interfaces of z/VM. |
IUCVB
Control Block Contents
IUCVB DSECT
Cross Reference (Contains links to field and bit definitions)
IUCVB Prolog
NAME : HCPIUCVB
DESCRIPTION: IUCV CONTROL BLOCK
DSECT : IUCVB
FUNCTION : THIS CONTROL BLOCK DEFINES THE INTER-USER COMMUNICATIONS
VEHICLE CONTROL BLOCK FOR AN IUCV USER.
LOCATED BY : -VMDIUCV FIELD OF HCPVMDBK FOR VIRTUAL MACHINES
-CALL TO HCPIUGAI FOR CP SYSTEM SERVICES
CREATED BY : IUCV DECLARE BUFFER FUNCTION - HCPIUJDB
DELETED BY : IUCV RETRIEVE BUFFER FUNCTION - HCPIUERB
RELOCATION CONSIDERATIONS : This control block is relocated as part of a live
guest relocation (LGR). The bits and fields that
need to be relocated are defined in the
corresponding LGRIUCVB COPY file. Whenever changes
are made to this control block, consideration must
be given to any effects these changes will have on
a relocation. If any new fields or bits are
defined, they may need to be relocated. If
existing bits or fields are changed, corresponding
modifications may be required in the LGR version of
this control block. Consider also the effects of
these changes on a relocation involving a back-level
release of CP.
NOTES : The following fields are valid in the base IUCVB only (all
other fields are valid in the base and local IUCVBs):
IUCVCCT - Pointer to user's CCTBK
IUCVBWIN - Dispatch window event count
IUCMXCN - Maximum number of connections
IUCPNDHD - Pending control interrupt queue head
IUCPNDTL - Pending control interrupt queue tail
IUCVSTAT - IUCV status
IUCANYFL - *IDENT authorization particulars
IUCTOTCN - Total number of connections
IUCVBCPX - CPEBK for HCPIVKRS call
IUCBUFCT - Buffer counts
IUCPPAS - Chain of PPABKs
IUCVB Control Block Content
IUCVB DSECT
Hex Dec Type/Val Lng Label (dup) Comments ---- ---- --------- ---- -------------- -------- 0000 0 Structure IUCVB IUCV CONTROL BLOCK 0000 0 Address 4 IUCVMB ADDRESS OF VMDBK 0004 4 Address 4 IUCBFAD1 ADDRESS OF EXTERNAL BUFFER 0008 8 Address 4 IUCBFAD2 2ND PAGE OF EXTERNAL BUFFER 000C 12 Signed 2 IUCBFLN1 LENGTH OF BUFF IN 1ST PAGE - 1 000E 14 Signed 2 IUCBFLN2 LENGTH OF BUFF IN 2ND PAGE - 1 0010 16 Address 4 IUCCBFA1 ADDRESS OF EXTERNAL CNTL BUFFER 0014 20 Address 4 IUCCBFA2 2ND PAGE OF EXTERNAL CNTL BUFFER 0018 24 Signed 2 IUCCBFL1 LENGTH OF CNTL BUFF IN 1ST PAGE 001A 26 Signed 2 IUCCBFL2 LENGTH OF CNTL BUFF IN 2ND PAGE 001C 28 Address 4 IUCVCCT POINTER TO THE USER'S CCT 0020 32 Bitstring 1 IUCVBWIN Dispatch window event count 1... .... IUCVBMAX X'80' IUCVBMAX Event threshhold value .1.. .... IUCVBFRE X'40' IUCVBFRE Free storage threshhold count 0021 33 Bitstring 1 * RESERVED NOTES : The event threshhold for IUCVBWIN is actually x'100'. For performance reasons IUCVBMAX has been defined as an equate so that a TM cam be used to test for the threshhold. 0022 34 Signed 2 IUCMXCN MAX NUM OF CONN FROM DIRECTORY OR DEFAULT 0024 36 Signed 4 IUCPNDHD PENDING CONTROL INT QUEUE HEAD 0028 40 Signed 4 IUCPNDTL PENDING CONTROL INT QUEUE TAIL 002C 44 Bitstring 1 IUCVSTAT IUCV STATUS 1... .... IUCVWAIT X'80' IUCVWAIT IUCV WAIT .1.. .... IUCIDENT X'40' IUCIDENT CONNECT TO *IDENT AUTHORIZED ..1. .... IUCCPBUF X'20' IUCCPBUF CP CREATED IUCVB ...1 .... IUCBROUT X'10' IUCBROUT VIRTUAL MACHINE IS BREAKING OUT .... 1... IUCBUFA X'08' IUCBUFA Application buffer exists in complex .... .1.. IUCBUFC X'04' IUCBUFC Control buffer exists in complex 002D 45 Bitstring 1 IUCANYFL *IDENT AUTHORIZATION PARTICULARS 1... .... IUCANYLI X'80' IUCANYLI RESANY LOCAL IDENTIFY .1.. .... IUCANYLR X'40' IUCANYLR RESANY LOCAL REVOKE ..1. .... IUCANYGI X'20' IUCANYGI RESANY GLOBAL IDENTIFY ...1 .... IUCANYGR X'10' IUCANYGR RESANY GLOBAL REVOKE .... 1... IUCANYWI X'08' IUCANYWI GATEANY IDENTIFY .... .1.. IUCANYWR X'04' IUCANYWR GATEANY REVOKE .... ..1. IUCANYRE X'02' IUCANYRE RESANY AUTHORITY CHECKED .... ...1 IUCANYGT X'01' IUCANYGT GATEANY AUTHORITY CHECKED 002E 46 Signed 2 IUCTOTCN TOTAL NUMBER OF CONNECTIONS 0030 48 Address 4 IUCIBFA1 FIRST PAGE-INTERRUPT BUFFER EXT 0034 52 Address 4 IUCIBFA2 SECOND PAGE-INTERRUPT BUFFER EXT 0038 56 Signed 2 IUCIBFL1 INTERRUPT BUFFER EXT LEN - PG 1 003A 58 Signed 2 IUCIBFL2 INTERRUPT BUFFER EXT LEN - PG 2 003C 60 Signed 4 IUCVBCPX CPEBK for HCPIVKRS call 0040 64 Bitstring 1 IUCAPIN IUCV interrupts enabled 1... .... IUCSNDN X'80' IUCSNDN IUCV Non-priority msgs enabled .1.. .... IUCSNDP X'40' IUCSNDP IUCV priority messages enabled ..1. .... IUCRPYN X'20' IUCRPYN IUCV non-priority reply enabled ...1 .... IUCRPYP X'10' IUCRPYP IUCV priority replies enabled .... 1... IUCICTRL X'08' IUCICTRL IUCV control interrupts enabled 0041 65 Bitstring 1 IUCTLIN IUCV control interrupts enabled 1... .... IUCCLPC X'80' IUCCLPC Pending connections enabled .1.. .... IUCCLCC X'40' IUCCLCC Complete connections enabled ..1. .... IUCCLPS X'20' IUCCLPS Sever interrupts enabled ...1 .... IUCCLPQ X'10' IUCCLPQ Quiesce interrupts enabled .... 1... IUCCLPR X'08' IUCCLPR Resume interrupts enabled 0042 66 Signed 2 * Reserved IUCBUFCT contains both buffer counts. This enables the code to test if both of these fields are zero at the same time. IUCAPBCT and IUCTLBCT must be kept together. 0044 68 Signed 4 IUCBUFCT (0) Buffer counts 0044 68 Signed 2 IUCAPBCT Count of the number of application buffers declared in the complex 0046 70 Signed 2 IUCTLBCT Count of the number of control buffers declared in the complex 0048 72 Signed 4 IUCPPAS Pointer to first point to point accounting block in a chain of PPABKs. 004C 76 Signed 4 * Reserved. Constant values used throughout IUCV 00004000 IUCINTC X'4000' IUCV Interrupt code 0000001E IUCR0MSK 30 IUCV CR0 mask bit 0000000A IUCSIZE (*-IUCVB+7)/8 IUCVB SIZE IN DOUBLEWORDS
IUCVB Storage Layout
*** IUCVB - IUCV CONTROL BLOCK
*
* +---------------------------+---------------------------+
* 0 | IUCVMB | IUCBFAD1 |
* +---------------------------+-------------+-------------+
* 8 | IUCBFAD2 | IUCBFLN1 | IUCBFLN2 |
* +---------------------------+-------------+-------------+
* 10 | IUCCBFA1 | IUCCBFA2 |
* +-------------+-------------+---------------------------+
* 18 | IUCCBFL1 | IUCCBFL2 | IUCVCCT |
* +------+------+-------------+---------------------------+
* 20 |:VBWIN|//////| IUCMXCN | IUCPNDHD |
* +------+------+-------------+------+------+-------------+
* 28 | IUCPNDTL |:VSTAT|:ANYFL| IUCTOTCN |
* +---------------------------+------+------+-------------+
* 30 | IUCIBFA1 | IUCIBFA2 |
* +-------------+-------------+---------------------------+
* 38 | IUCIBFL1 | IUCIBFL2 | IUCVBCPX |
* +------+------+-------------+-------------+-------------+
* 40 |:APIN |:TLIN |/////////////| IUCAPBCT | IUCTLBCT |
* +------+------+-------------+-------------+-------------+
* 48 | IUCPPAS |///////////////////////////|
* +---------------------------+---------------------------+
* 50
*
*** IUCVB - IUCV CONTROL BLOCK
IUCVB Cross Reference
Symbol Dspl Value -------------- ---- ----- IUCANYFL 002D IUCANYGI 002D 20 IUCANYGR 002D 10 IUCANYGT 002D 01 IUCANYLI 002D 80 IUCANYLR 002D 40 IUCANYRE 002D 02 IUCANYWI 002D 08 IUCANYWR 002D 04 IUCAPBCT 0044 IUCAPIN 0040 IUCBFAD1 0004 IUCBFAD2 0008 IUCBFLN1 000C IUCBFLN2 000E IUCBROUT 002C 10 IUCBUFA 002C 08 IUCBUFC 002C 04 IUCBUFCT 0044 IUCCBFA1 0010 IUCCBFA2 0014 IUCCBFL1 0018 IUCCBFL2 001A IUCCLCC 0041 40 IUCCLPC 0041 80 IUCCLPQ 0041 10 IUCCLPR 0041 08 IUCCLPS 0041 20 IUCCPBUF 002C 20 IUCIBFA1 0030 IUCIBFA2 0034 IUCIBFL1 0038 IUCIBFL2 003A IUCICTRL 0040 08 IUCIDENT 002C 40 IUCINTC 004C 00004000 IUCMXCN 0022 IUCPNDHD 0024 IUCPNDTL 0028 IUCPPAS 0048 IUCRPYN 0040 20 IUCRPYP 0040 10 IUCR0MSK 004C 0000001E IUCSIZE 004C 0000000A IUCSNDN 0040 80 IUCSNDP 0040 40 IUCTLBCT 0046 IUCTLIN 0041 IUCTOTCN 002E IUCVBCPX 003C IUCVBFRE 0020 40 IUCVBMAX 0020 80 IUCVBWIN 0020 IUCVCCT 001C IUCVMB 0000 IUCVSTAT 002C IUCVWAIT 002C 80
Copyright IBM Corporation, 1990, 2011