$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       : LGRIUCVB
 DESCRIPTION: Relocation mapping for HCPIUCVB
 DSECT      : $IUCVB
 FUNCTION   : LGRIUCVB describes those fields of the IUCVB that
              will be migrated to the destination system during
              guest relocation.
 LOCATED BY : This is a mapping of the RDODATA area within the
              RDOBK during guest relocation.
 RELOCATION CONSIDERATIONS : This control block is used during live guest
              relocation.  It is used to relocate a control block
              defined in a corresponding HCP COPY file.  Any
              fields or bits defined in HCPIUCVB which are
              required on the destination system must be defined
              here, and code must be added to migrate the field
              or bit during a relocation.
 
 
  $IUCVB Control Block Content Top of page
 

 $IUCVB DSECT Top of page
Hex Dec Type/Val Lng Label (dup) Comments ---- ---- --------- ---- -------------- -------- 0000 0 Structure $IUCVB Relocation mapping for HCPIUCVB 00000001 $IUC_VER 1 Mapping version number 0000 0 Signed 2 $IUC_HDRL Header length (in bytes) 0002 2 Signed 2 $IUC_BITL Length of mapped bits (in bytes) 0004 4 Signed 4 * Reserved for future use 00000008 $IUC_HDLN *-$IUCVB Length of header (bytes) Bit map: Contains the IUCVB flags that are subject to relocation. These bits are defined sequentially, regardless of how they are defined in HCPIUCVB. This yields a consistent mapping that ensures compatibility when a guest is relocated between systems at differing service levels. Names in the comments column indicate the control block byte which contains the flag. This name is subject to change if the flag definition changes. ====> NEVER change bits which already exist here. ====> NEVER change the order of bits in this section. ====> ALWAYS add new bits at the end of this section, together with new flag bytes as required. 0008 8 Signed 2 $IUC_BITS (0) Bit map area 0008 8 Bitstring 1 $IUC0 1... .... $IUCVBMAX X'80' $IUCVBMAX IUCVBWIN .1.. .... $IUCVBFRE X'40' $IUCVBFRE IUCVBWIN ..1. .... $IUCVWAIT X'20' $IUCVWAIT IUCVSTAT ...1 .... $IUCIDENT X'10' $IUCIDENT IUCVSTAT .... 1... $IUCCPBUF X'08' $IUCCPBUF IUCVSTAT .... .1.. $IUCBROUT X'04' $IUCBROUT IUCVSTAT .... ..1. $IUCBUFA X'02' $IUCBUFA IUCVSTAT .... ...1 $IUCBUFC X'01' $IUCBUFC IUCVSTAT 0009 9 Bitstring 1 $IUC1 1... .... $IUCANYLI X'80' $IUCANYLI IUCANYFL .1.. .... $IUCANYLR X'40' $IUCANYLR IUCANYFL ..1. .... $IUCANYGI X'20' $IUCANYGI IUCANYFL ...1 .... $IUCANYGR X'10' $IUCANYGR IUCANYFL .... 1... $IUCANYWI X'08' $IUCANYWI IUCANYFL .... .1.. $IUCANYWR X'04' $IUCANYWR IUCANYFL .... ..1. $IUCANYRE X'02' $IUCANYRE IUCANYFL .... ...1 $IUCANYGT X'01' $IUCANYGT IUCANYFL 000A 10 Bitstring 1 $IUC2 1... .... $IUCSNDN X'80' $IUCSNDN IUCAPIN .1.. .... $IUCSNDP X'40' $IUCSNDP IUCAPIN ..1. .... $IUCRPYN X'20' $IUCRPYN IUCAPIN ...1 .... $IUCRPYP X'10' $IUCRPYP IUCAPIN .... 1... $IUCICTRL X'08' $IUCICTRL IUCAPIN .... .1.. $IUCCLPC X'04' $IUCCLPC IUCTLIN .... ..1. $IUCCLCC X'02' $IUCCLCC IUCTLIN .... ...1 $IUCCLPS X'01' $IUCCLPS IUCTLIN 000B 11 Bitstring 1 $IUC3 1... .... $IUCCLPQ X'80' $IUCCLPQ IUCTLIN .1.. .... $IUCCLPR X'40' $IUCCLPR IUCTLIN 00000004 $IUC_BLEN *-$IUC_BITS Length of bit map area Data: Contains all HCPIUCVB data that is subject to relocation, except for flag bits, which are handled separately. All fields are defined as XLnn to avoid alignment warnings and to pack the data efficiently. ====> NEVER change fields which already exist here. ====> NEVER change the order of fields in this section. ====> ALWAYS add new fields at the end of this section. 000C 12 Bitstring 1 $IUC_DATA (0) Start of data map 000C 12 Bitstring 4 $IUCVMB ADDRESS OF VMDBK 0010 16 Bitstring 4 $IUCBFAD1 ADDRESS OF EXTERNAL BUFFER 0014 20 Bitstring 4 $IUCBFAD2 2ND PAGE OF EXTERNAL BUFFER 0018 24 Bitstring 2 $IUCBFLN1 LENGTH OF BUFF IN 1ST PAGE - 1 001A 26 Bitstring 2 $IUCBFLN2 LENGTH OF BUFF IN 2ND PAGE - 1 001C 28 Bitstring 4 $IUCCBFA1 ADDRESS OF EXTERNAL CNTL BUFFER 0020 32 Bitstring 4 $IUCCBFA2 2ND PAGE OF EXTERNAL CNTL BUFFER 0024 36 Bitstring 2 $IUCCBFL1 LENGTH OF CNTL BUFF IN 1ST PAGE 0026 38 Bitstring 2 $IUCCBFL2 LENGTH OF CNTL BUFF IN 2ND PAGE 0028 40 Bitstring 4 $IUCVCCT -> RDO offset to $CCTBK 002C 44 Bitstring 2 $IUCMXCN MAX NUM OF CONN FROM DIR OR DFLT 002E 46 Bitstring 4 $IUCPNDHD -> RDO offset to $IPRML 0032 50 Bitstring 2 $IUCTOTCN TOTAL NUMBER OF CONNECTIONS 0034 52 Bitstring 4 $IUCIBFA1 FIRST PAGE-INTERRUPT BUFFER EXT 0038 56 Bitstring 4 $IUCIBFA2 SECOND PAGE-INTERRUPT BUFFER EXT 003C 60 Bitstring 2 $IUCIBFL1 INTERRUPT BUFFER EXT LEN - PG 1 003E 62 Bitstring 2 $IUCIBFL2 INTERRUPT BUFFER EXT LEN - PG 2 0040 64 Bitstring 2 $IUCAPBCT Count of appl buffers in complex 0042 66 Bitstring 2 $IUCTLBCT Count of ctl buffers in complex 00000044 $IUC_LEN *-$IUCVB Total length, in bytes 00000009 $IUC_SZ ($IUC_LEN+7)/8 Size in doublewords
 
 
  $IUCVB Storage Layout Top of page
 
          
*** $IUCVB - Relocation mapping for HCPIUCVB
*
*     +-------------+-------------+---------------------------+
*   0 | $IUC_HDRL   | $IUC_BITL   |///////////////////////////|
*     +------+------+------+------+---------------------------+
*   8 |$IUC0 |$IUC1 |$IUC2 |$IUC3 |         $IUCVMB           |
*     +------+------+------+------+---------------------------+
*  10 |        $IUCBFAD1          |        $IUCBFAD2          |
*     +-------------+-------------+---------------------------+
*  18 | $IUCBFLN1   | $IUCBFLN2   |        $IUCCBFA1          |
*     +-------------+-------------+-------------+-------------+
*  20 |        $IUCCBFA2          | $IUCCBFL1   | $IUCCBFL2   |
*     +---------------------------+-------------+-------------+
*  28 |         $IUCVCCT          |  $IUCMXCN   | $IUCPNDHD-  |
*     +-------------+-------------+-------------+-------------+
*  30 |   -(02E)    | $IUCTOTCN   |        $IUCIBFA1          |
*     +-------------+-------------+-------------+-------------+
*  38 |        $IUCIBFA2          | $IUCIBFL1   | $IUCIBFL2   |
*     +-------------+-------------+-------------+-------------+
*  40 | $IUCAPBCT   | $IUCTLBCT   | 44
*     +-------------+-------------+
*
*** $IUCVB - Relocation mapping for HCPIUCVB
 
 
  $IUCVB Cross Reference Top of page
 
 
Symbol         Dspl Value
-------------- ---- -----
$IUC_BITL      0002
$IUC_BITS      0008
$IUC_BLEN      000B 00000004
$IUC_DATA      000C
$IUC_HDLN      0004 00000008
$IUC_HDRL      0000
$IUC_LEN       0042 00000044
$IUC_SZ        0042 00000009
$IUC_VER       0000 00000001
$IUCANYGI      0009 20
$IUCANYGR      0009 10
$IUCANYGT      0009 01
$IUCANYLI      0009 80
$IUCANYLR      0009 40
$IUCANYRE      0009 02
$IUCANYWI      0009 08
$IUCANYWR      0009 04
$IUCAPBCT      0040
$IUCBFAD1      0010
$IUCBFAD2      0014
$IUCBFLN1      0018
$IUCBFLN2      001A
$IUCBROUT      0008 04
$IUCBUFA       0008 02
$IUCBUFC       0008 01
$IUCCBFA1      001C
$IUCCBFA2      0020
$IUCCBFL1      0024
$IUCCBFL2      0026
$IUCCLCC       000A 02
$IUCCLPC       000A 04
$IUCCLPQ       000B 80
$IUCCLPR       000B 40
$IUCCLPS       000A 01
$IUCCPBUF      0008 08
$IUCIBFA1      0034
$IUCIBFA2      0038
$IUCIBFL1      003C
$IUCIBFL2      003E
$IUCICTRL      000A 08
$IUCIDENT      0008 10
$IUCMXCN       002C
$IUCPNDHD      002E
$IUCRPYN       000A 20
$IUCRPYP       000A 10
$IUCSNDN       000A 80
$IUCSNDP       000A 40
$IUCTLBCT      0042
$IUCTOTCN      0032
$IUCVBFRE      0008 40
$IUCVBMAX      0008 80
$IUCVCCT       0028
$IUCVMB        000C
$IUCVWAIT      0008 20
$IUC0          0008
$IUC1          0009
$IUC2          000A
$IUC3          000B
 
This information is based on z/VM 6.3.0 Last updated on 22 May 2013 at 13:56:36 EDT.
Copyright IBM Corporation, 1990, 2013