|
Programming Interface Information:
This information is NOT intended to be used as Programming Interfaces of z/VM. |
$VPXBK
Control Block Contents
$VPXBK DSECT
Cross Reference (Contains links to field and bit definitions)
$VPXBK Prolog
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
$VPXBK DSECT
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
*** $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
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
Copyright IBM Corporation, 1990, 2011