IUCVB Back to Index page
 
Prolog 
Control Block Contents 
   IUCVB DSECT
Storage Layout 
Cross Reference (Contains links to field and bit definitions)
Programming Interface Information:
This information is NOT intended to be
used as Programming Interfaces of z/VM.


  IUCVB Prolog Top of page
 
 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 Top of page
 

 IUCVB DSECT Top of page
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 Top of page
 
          
*** 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 Top of page
 
 
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
 
This information is based on z/VM 7.2.0 Last updated on 24 Jun 2020 at 09:28:41 EDT.
Copyright IBM Corporation, 1990, 2020