$VPXBK | Back to Index page

| Prolog Control Block Contents $VPXBK 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.

$VPXBK Prolog | Top of page

     NAME       : LGRVPXBK
     DESCRIPTION: Relocation mapping for HCPVPXBK
     DSECT      : $VPXBK
     FUNCTION   : LGRVPXBK describes those fields of the VPXBK 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.
     CREATED BY : HCPRLFXF - VPXBK Formatter for LGR
     DELETED BY : HCPRLDRL - Release storage associated with an RDP
     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 HCPVPXBK 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.

$VPXBK Control Block Content | Top of page

     $VPXBK DSECT
    Top of page

    Hex   Dec Type/Val   Lng Label (dup)    Comments
    ---- ---- --------- ---- -------------- --------
    0000    0 Structure      $VPXBK         Relocation mapping for HCPVPXBK
              00000001       $VPX_VER       1 Mapping version number for this
                                            DSECT. Version is independent of
                                            the CP level and need only be
                                            changed when this DSECT is
                                            changed. The convention is to
                                            increment by 1.
    0000    0 Signed       2 $VPX_HDRL      Header length (in bytes)
    0002    2 Signed       2 $VPX_BITL      Length of mapped bits (in bytes)
    0004    4 Signed       4 *              Reserved for future use
              00000008       $VPX_HDLN      *-$VPXBK Length of header (bytes)
          Bit map: Contains the VPXBK flags that are subject to
                   relocation. These bits are defined sequentially,
                   regardless of how they are defined in HCPVPXBK.
                   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 $VPX_BITS (0)  Bit map area
    0008    8 Bitstring    1 $VPX0
              1... ....      $VPXTT0V       X'80' $VPXTT0V VPXFLAG1
              .1.. ....      $VPXTT1V       X'40' $VPXTT1V VPXFLAG1
              ..1. ....      $VPXTT2V       X'20' $VPXTT2V VPXFLAG1
              ...1 ....      $VPXTT3V       X'10' $VPXTT3V VPXFLAG1
              .... 1...      $VPXBTS        X'08' $VPXBTS VPXFLAG1
              .... .1..      $VPX4WCGM      X'04' $VPX4WCGM VPXFLAG1
              .... ..1.      $VPXBLKDC      X'02' $VPXBLKDC VPXFLAG1
              .... ...1      $VPXALLDC      X'01' $VPXALLDC VPXFLAG1
    0009    9 Bitstring    1 $VPX1
              1... ....      $VPXCLPRS      X'80' $VPXCLPRS VPXFLAG2
              .1.. ....      $VPXBIGBF      X'40' $VPXBIGBF VPXFLAG2
              ..1. ....      $VPXOVPRT      X'20' $VPXOVPRT VPXFLAG2
              ...1 ....      $VPXNORML      X'10' $VPXNORML VPXFLAG2
              .... 1...      $VPXLFCB       X'08' $VPXLFCB VPXFLAG2
              .... .1..      $VPXB4WCG      X'04' $VPXB4WCG VPXBFTR1
              .... ..1.      $VPXBBTS       X'02' $VPXBBTS VPXBFTR1
              .... ...1      $VPXBBTS3      X'01' $VPXBBTS3 VPXBPLNI
              00000002       $VPX_BLEN      *-$VPX_BITS Length of bit map
                                            area
          Data:    Contains all HCPVPXBK 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.
                   together with new flag bytes as required.
    000A   10 Bitstring    1 $VPX_DATA (0)  Start of data map
    000A   10 Bitstring    2 $VPXLCNT       CURRENT LINE NUMBER
    000C   12 Bitstring    2 $VPXPAGID      CHANNEL PAGE ID
    000E   14 Bitstring    2 $VPXLODCK      RELATIVE DISPLACEMENT FOR LOAD
                                            CHECKS
    0010   16 Bitstring    1 $VPXWIDTH      CODE FOR FORMS WIDTH
    0011   17 Bitstring    1 $VPXLENTH      CODE FOR FORMS LENGTH
    0012   18 Bitstring    1 $VPXWCGM0      CONTENTS OF WCGM 0
    0013   19 Bitstring    1 $VPXWCGM1      CONTENTS OF WCGM 1
    0014   20 Bitstring    1 $VPXWCGM2      CONTENTS OF WCGM 2
    0015   21 Bitstring    1 $VPXWCGM3      CONTENTS OF WCGM 3
    0016   22 Bitstring    1 $VPXCURTT      CURRENT TRANSLATE TABLE
    0017   23 Bitstring    1 $VPXSVCCW      CURRENT CCW COMMAND CODE
    0018   24 Bitstring    4 $VPXIBUFC      DATA COUNT FOR INTERMEDIATED
                                            BUFFER
    001C   28 Bitstring    2 $VPXBCPID      CHANNEL PAGE ID
    001E   30 Bitstring    2 $VPXBLINP      FCB LINE POSITION
    0020   32 Bitstring    2 $VPXBSPID      STACKED PAGE ID
    0022   34 Bitstring    2 $VPXBFPID      FUSER PAGE ID
    0024   36 Bitstring    2 $VPXBTPID      TRANSFER PAGE ID
    0026   38 Bitstring    1 $VPXBFWTH      FORMS WIDTH CODE
    0027   39 Bitstring    1 $VPXBFLNG      LENGTH OF CURR PAGE (1/2 IN)
    0028   40 Bitstring    1 $VPXBWCG0      WCGM 0 ID
    0029   41 Bitstring    1 $VPXBWCG1      WCGM 1 ID
    002A   42 Bitstring    1 $VPXBWCG2      WCGM 2 ID
    002B   43 Bitstring    1 $VPXBWCG3      WCGM 3 ID
    002C   44 Bitstring    1 $VPXBSTG       STORAGE SIZE, 3800-3
    002D   45 Bitstring  144 $VPXFCB        FCB CURRENTLY LOADED
    00BD  189 Bitstring  256 $VPXTRT0       BYTE MAP FOR UNPRINTABLE
    01BD  445 Bitstring  256 $VPXTRT1       CHARACTERS FOR EACH
    02BD  701 Bitstring  256 $VPXTRT2       OF THE POSSIBLE
    03BD  957 Bitstring  256 $VPXTRT3       TRANSLATE TABLES
    04BD 1213 Bitstring  204 $VPXOVMAP      MAP FOR OVERPRINT DETECTION
              00000589       $VPX_LEN       *-$VPXBK Total length, in bytes
              000000B2       $VPXSIZE       ($VPX_LEN+7)/8 $VPXBK DWord size

$VPXBK Storage Layout | Top of page

    *** $VPXBK - Relocation mapping for HCPVPXBK
    *
    *     +-------------+-------------+---------------------------+
    *   0 | $VPX_HDRL   | $VPX_BITL   |///////////////////////////|
    *     +------+------+-------------+-------------+-------------+
    *   8 |$VPX0 |$VPX1 |  $VPXLCNT   | $VPXPAGID   | $VPXLODCK   |
    *     +------+------+------+------+------+------+------+------+
    *  10 |(010) |(011) |(012) |(013) |(014) |(015) |(016) |(017) |
    *     +------+------+------+------+------+------+------+------+
    *  18 |        $VPXIBUFC          | $VPXBCPID   | $VPXBLINP   |
    *     +-------------+-------------+-------------+------+------+
    *  20 | $VPXBSPID   | $VPXBFPID   | $VPXBTPID   |(026) |(027) |
    *     +------+------+------+------+------+------+------+------+
    *  28 |(028) |(029) |(02A) |(02B) |:XBSTG|                    |
    *     +------+------+------+------+------+                    |
    *  30 |                                                       |
    *     =                       $VPXFCB                         =
    *     |                                  +--------------------+
    *     |                                  |                    |
    *     +----------------------------------+                    |
    *  C0 |                                                       |
    *     =                       $VPXTRT0                        =
    *     |                                  +--------------------+
    *     |                                  |                    |
    *     +----------------------------------+                    |
    * 1C0 |                                                       |
    *     =                       $VPXTRT1                        =
    *     |                                  +--------------------+
    *     |                                  |                    |
    *     +----------------------------------+                    |
    * 2C0 |                                                       |
    *     =                       $VPXTRT2                        =
    *     |                                  +--------------------+
    *     |                                  |                    |
    *     +----------------------------------+                    |
    * 3C0 |                                                       |
    *     =                       $VPXTRT3                        =
    *     |                                  +--------------------+
    *     |                                  |                    |
    *     +----------------------------------+                    |
    * 4C0 |                                                       |
    *     =                      $VPXOVMAP                        =
    *     |      +------------------------------------------------+
    *     |      | 589
    *     +------+
    *
    *** $VPXBK - Relocation mapping for HCPVPXBK

$VPXBK Cross Reference | Top of page

    Symbol         Dspl Value
    -------------- ---- -----
    $VPX_BITL      0002
    $VPX_BITS      0008
    $VPX_BLEN      0009 00000002
    $VPX_DATA      000A
    $VPX_HDLN      0004 00000008
    $VPX_HDRL      0000
    $VPX_LEN       04BD 00000589
    $VPX_VER       0000 00000001
    $VPXALLDC      0008 01
    $VPXBBTS       0009 02
    $VPXBBTS3      0009 01
    $VPXBCPID      001C
    $VPXBFLNG      0027
    $VPXBFPID      0022
    $VPXBFWTH      0026
    $VPXBIGBF      0009 40
    $VPXBLINP      001E
    $VPXBLKDC      0008 02
    $VPXBSPID      0020
    $VPXBSTG       002C
    $VPXBTPID      0024
    $VPXBTS        0008 08
    $VPXBWCG0      0028
    $VPXBWCG1      0029
    $VPXBWCG2      002A
    $VPXBWCG3      002B
    $VPXB4WCG      0009 04
    $VPXCLPRS      0009 80
    $VPXCURTT      0016
    $VPXFCB        002D
    $VPXIBUFC      0018
    $VPXLCNT       000A
    $VPXLENTH      0011
    $VPXLFCB       0009 08
    $VPXLODCK      000E
    $VPXNORML      0009 10
    $VPXOVMAP      04BD
    $VPXOVPRT      0009 20
    $VPXPAGID      000C
    $VPXSIZE       04BD 000000B2
    $VPXSVCCW      0017
    $VPXTRT0       00BD
    $VPXTRT1       01BD
    $VPXTRT2       02BD
    $VPXTRT3       03BD
    $VPXTT0V       0008 80
    $VPXTT1V       0008 40
    $VPXTT2V       0008 20
    $VPXTT3V       0008 10
    $VPXWCGM0      0012
    $VPXWCGM1      0013
    $VPXWCGM2      0014
    $VPXWCGM3      0015
    $VPXWIDTH      0010
    $VPX0          0008
    $VPX1          0009
    $VPX4WCGM      0008 04

This information is based on z/VM 7.2.0 Last updated on 24 Jun 2020 at 09:32:17 EDT.
Copyright IBM Corporation, 1990, 2020