$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 7.2.0 Last updated on 24 Jun 2020 at 09:32:04 EDT.
Copyright IBM Corporation, 1990, 2020