$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