$VSPBK | Back to Index page

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

$VSPBK Prolog | Top of page

     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 | Top of page

     $VSPBK DSECT
    Top of page

    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 | Top of page

    *** $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 | Top of page

    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

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