|
Programming Interface Information:
This information is NOT intended to be used as Programming Interfaces of z/VM. |
$VSPBK
Control Block Contents
$VSPBK DSECT
Cross Reference (Contains links to field and bit definitions)
$VSPBK Prolog
NAME : LGRVSPBK
DESCRIPTION: Relocation mapping for HCPVSPBK
DSECT : $VSPBK
FUNCTION : LGRVSPBK describes those fields of the VSPBK 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 : HCPRLFPF - VSPBK 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 HCPVSPBK 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.
$VSPBK Control Block Content
$VSPBK DSECT
Hex Dec Type/Val Lng Label (dup) Comments
---- ---- --------- ---- -------------- --------
0000 0 Structure $VSPBK Relocation mapping for HCPVSPBK
00000001 $VSP_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 $VSP_HDRL Header length (in bytes)
0002 2 Signed 2 $VSP_BITL Length of mapped bits (in bytes)
0004 4 Signed 4 * Reserved for future use
00000008 $VSP_HDLN *-$VSPBK Length of header (bytes)
Bit map: Contains the VSPBK flags that are subject to
relocation. These bits are defined sequentially,
regardless of how they are defined in HCPVSPBK.
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 $VSP_BITS (0) Bit map area
0008 8 Bitstring 1 $VSP0
1... .... $VSPRDR X'80' $VSPRDR VSPQFLG
.1.. .... $VSPPUN X'40' $VSPPUN VSPQFLG
..1. .... $VSPPRT X'20' $VSPPRT VSPQFLG
...1 .... $VSPSRCID X'10' $VSPSRCID VSPQFLG
.... 1... $VSPACTV X'08' $VSPACTV VSPCFLG
.... .1.. $VSPCPYZ X'04' $VSPCPYZ VSPCFLG
.... ..1. $VSPFLALL X'02' $VSPFLALL VSP3800F
0009 9 Bitstring 1 $VSP1
1... .... $VSPCONT X'80' $VSPCONT VSPOFLG
.1.. .... $VSPHOLD X'40' $VSPHOLD VSPOFLG
..1. .... $VSPKEEP X'20' $VSPKEEP VSPOFLG
...1 .... $VSPMSG X'10' $VSPMSG VSPOFLG
.... 1... $VSPSTRT X'08' $VSPSTRT VSPOFLG
.... .1.. $VSPTERM X'04' $VSPTERM VSPOFLG
.... ..1. $VSPEOF X'02' $VSPEOF VSPOFLG
.... ...1 $VSPFOR X'01' $VSPFOR VSPOFLG
000A 10 Bitstring 2 $VSP2
1... .... $VSPRDEFF X'80' $VSPRDEFF VSPGFLAG
.1.. .... $VSPRSCN X'40' $VSPRSCN VSPGFLAG
00000004 $VSP_BLEN *-$VSP_BITS Length of bit map
area
Data: Contains all HCPVSPBK 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.
000C 12 Bitstring 1 $VSP_DATA (0) Start of data map
000C 12 Bitstring 1 $VSPLPP Lines-per-page value (00 or
30-255)
000D 13 Bitstring 1 $VSPCOPY FILE COPY COUNT
000E 14 Bitstring 1 $VSPPGCPY PAGE COPY COUNT (USED ONLY FOR
3800)
000F 15 Bitstring 1 $VSPFLSHC 3800 FLASH COUNT FOR SPOOL FILES
0010 16 Bitstring 1 $VSPMODNO 3800 COPY MOD CHAR SET NUMBER
(0-3)
0011 17 Bitstring 1 $VSPCLASS SPOOL CLASS (A-Z OR 0-9)
0012 18 Bitstring 8 $VSPUSER USERID TO RECIEVE RESULTING SPOOL
FILES
001A 26 Bitstring 8 $VSPDIST DISTRIBUTION CODE
0022 34 Bitstring 8 $VSPDEST DESTination field
002A 42 Bitstring 8 $VSPFINAM FILENAME
0032 50 Bitstring 8 $VSPFITYP FILETYPE
003A 58 Bitstring 8 $VSPFORM FORM NAME
0042 66 Bitstring 4 $VSPFLASH 3800 FORMS OVERLAY (FLASH) NAME
0046 70 Bitstring 4 $VSPFCB 3800 FORMS CONTROL BUFFER (FCB)
NAME
004A 74 Bitstring 4 $VSPCMOD 3800 COPY MODIFICATION NAME
004E 78 Bitstring 4 $VSPCHAR0 3800 CHARACTER SET NAME - FIRST
0052 82 Bitstring 4 $VSPCHAR1 3800 CHARACTER SET NAME - SECOND
0056 86 Bitstring 4 $VSPCHAR2 3800 CHARACTER SET NAME - THIRD
005A 90 Bitstring 4 $VSPCHAR3 3800 CHARACTER SET NAME - FOURTH
005E 94 Bitstring 8 $VSPSRCND Diagnose X'F8' original node
0066 102 Bitstring 8 $VSPSRCUS Diagnose X'F8' original userid
006E 110 Bitstring 4 $VSPGSDT POINTER TO GSDBK CONTAINING TAG
DATA
0072 114 Bitstring 2 $VSPGSDL GSDDCNT from VSPGSDT (GSDDATA
length)
00000074 $VSP_LEN *-$VSPBK Total length, in bytes
0000000F $VSPSIZE ($VSP_LEN+7)/8 $VSPBK DWord size
$VSPBK Storage Layout
*** $VSPBK - Relocation mapping for HCPVSPBK
*
* +-------------+-------------+---------------------------+
* 0 | $VSP_HDRL | $VSP_BITL |///////////////////////////|
* +------+------+-------------+------+------+------+------+
* 8 |$VSP0 |$VSP1 | $VSP2 |:PLPP |:PCOPY|(00E) |(00F) |
* +------+------+-------------+------+------+------+------+
* 10 |(010) |(011) | $VSPUSER- |
* +------+------+-----------------------------------------+
* 18 | -(012) | $VSPDIST- |
* +-------------+-----------------------------------------+
* 20 | -(01A) | $VSPDEST- |
* +-------------+-----------------------------------------+
* 28 | -(022) | $VSPFINAM- |
* +-------------+-----------------------------------------+
* 30 | -(02A) | $VSPFITYP- |
* +-------------+-----------------------------------------+
* 38 | -(032) | $VSPFORM- |
* +-------------+---------------------------+-------------+
* 40 | -(03A) | $VSPFLASH | $VSPFCB- |
* +-------------+---------------------------+-------------+
* 48 | -(046) | $VSPCMOD | $VSPCHAR0- |
* +-------------+---------------------------+-------------+
* 50 | -(04E) | $VSPCHAR1 | $VSPCHAR2- |
* +-------------+---------------------------+-------------+
* 58 | -(056) | $VSPCHAR3 | (05E)- |
* +-------------+---------------------------+-------------+
* 60 | -$VSPSRCND | (066)- |
* +-----------------------------------------+-------------+
* 68 | -$VSPSRCUS | $VSPGSDT- |
* +-------------+-------------+-------------+-------------+
* 70 | -(06E) | $VSPGSDL | 74
* +-------------+-------------+
*
*** $VSPBK - Relocation mapping for HCPVSPBK
$VSPBK Cross Reference
Symbol Dspl Value -------------- ---- ----- $VSP_BITL 0002 $VSP_BITS 0008 $VSP_BLEN 000A 00000004 $VSP_DATA 000C $VSP_HDLN 0004 00000008 $VSP_HDRL 0000 $VSP_LEN 0072 00000074 $VSP_VER 0000 00000001 $VSPACTV 0008 08 $VSPCHAR0 004E $VSPCHAR1 0052 $VSPCHAR2 0056 $VSPCHAR3 005A $VSPCLASS 0011 $VSPCMOD 004A $VSPCONT 0009 80 $VSPCOPY 000D $VSPCPYZ 0008 04 $VSPDEST 0022 $VSPDIST 001A $VSPEOF 0009 02 $VSPFCB 0046 $VSPFINAM 002A $VSPFITYP 0032 $VSPFLALL 0008 02 $VSPFLASH 0042 $VSPFLSHC 000F $VSPFOR 0009 01 $VSPFORM 003A $VSPGSDL 0072 $VSPGSDT 006E $VSPHOLD 0009 40 $VSPKEEP 0009 20 $VSPLPP 000C $VSPMODNO 0010 $VSPMSG 0009 10 $VSPPGCPY 000E $VSPPRT 0008 20 $VSPPUN 0008 40 $VSPRDEFF 000A 80 $VSPRDR 0008 80 $VSPRSCN 000A 40 $VSPSIZE 0072 0000000F $VSPSRCID 0008 10 $VSPSRCND 005E $VSPSRCUS 0066 $VSPSTRT 0009 08 $VSPTERM 0009 04 $VSPUSER 0012 $VSP0 0008 $VSP1 0009 $VSP2 000A
Copyright IBM Corporation, 1990, 2011