Programming Interface Information:
This information is NOT intended to be
used as Programming Interfaces of z/VM.

$VDATA

Prolog  

Control Block Contents  
   $VDATA DSECT

Storage Layout  

Cross Reference (Contains links to field and bit definitions)  


$VDATA Prolog

 NAME       : LGRVDATA
 DESCRIPTION: Relocation mapping for miscellaneous
              variable-length data
 DSECT      : $VDATA
 FUNCTION   : LGRVDATA is used to map blocks of varying-length
              data that need to be relocated.
 LOCATED BY : This is a mapping of the RDODATA area within the
              RDOBK during guest relocation.
 RELOCATION CONSIDERATIONS : None

 

$VDATA Control Block Content


$VDATA DSECT

Hex   Dec Type/Val   Lng Label (dup)    Comments
---- ---- --------- ---- -------------- --------
0000    0 Structure      $VDATA         Relocation mapping for miscellaneous
          00000001       $VDA_VER       1 Mapping version number
0000    0 Signed       2 $VDA_HDRL      Header length (in bytes)
0002    2 Signed       2 $VDA_BITL      Length of mapped bits (in bytes)
0004    4 Signed       2 $VDA_DATL      Length of data area (in bytes)
0006    6 Signed       2 *              Reserved for future use
          00000008       $VDA_HDLN      *-$VDATA Length of header (bytes)
      Bit map: This is a special-purpose mapping for relocation
               usage only. There are no flag bits.
0008    8 Signed       2 $VDA_BITS (0)  Bit map area
          00000000       $VDA_BLEN      *-$VDA_BITS Length of bit map
                                        area
      Fixed fields: This is a special-purpose mapping for
               relocation use only. The fields defined here do
               not relate to any other control block.
               New fields should only be added at the end of
               this section, to retain downward compatibility.
0008    8 Bitstring    1 $VDA_DATA (0)  Start of data map
0008    8 Bitstring    4 $VDANEXT       ->RDO offset to next chunk
000C   12 Bitstring    4 $VDALEN        Bytes in this chunk
          00000008       $VDA_DLEN      *-$VDA_DATA Length of fixed data
                                        area
      Data:    This is a variable-length area that will contain
               the data to be relocated.
0010   16 Bitstring    1 $VDABUFF (0)   Start of variable data
          00000010       $VDA_LEN       *-$VDATA Total length, in bytes
          00000002       $VDA_SZ        ($VDA_LEN+7)/8 Size in
                                        doublewords

 

$VDATA Storage Layout

          
*** $VDATA - Relocation mapping for miscellaneous
*
*     +-------------+-------------+-------------+-------------+
*   0 | $VDA_HDRL   | $VDA_BITL   | $VDA_DATL   |/////////////|
*     +-------------+-------------+-------------+-------------+
*   8 |         $VDANEXT          |         $VDALEN           |
*     +---------------------------+---------------------------+
*
*** $VDATA - Relocation mapping for miscellaneous

 

$VDATA Cross Reference

Symbol         Dspl Value
-------------- ---- -----
$VDA_BITL      0002
$VDA_BITS      0008
$VDA_BLEN      0008 00000000
$VDA_DATA      0008
$VDA_DATL      0004
$VDA_DLEN      000C 00000008
$VDA_HDLN      0006 00000008
$VDA_HDRL      0000
$VDA_LEN       0010 00000010
$VDA_SZ        0010 00000002
$VDA_VER       0000 00000001
$VDABUFF       0010
$VDALEN        000C
$VDANEXT       0008

This information is based on z/VM V6R2.0. Last updated on 21 Nov 2011 at 11:35:44 EDT.
Copyright IBM Corporation, 1990, 2011