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

VOPBK

Prolog  

Control Block Contents  
   VOPBK DSECT

Storage Layout  

Cross Reference (Contains links to field and bit definitions)  


VOPBK Prolog

 Name       : HCPVOPBK
 Description: HCPVOP simulation fetch/store work area
 DSECT      : VOPBK
 Function   : Work area used by HCPVOP simulation fetch/store
              routines.
 Located by : VMDVOPBK field of the VMDBK
 Created by : HCPBVMBK when a user logs on or when a new vCPU
              is defined
 Deleted by : HCPUSPFF when a user logs off or when a vCPU is
              detached
 Serialized : VMDBK dispatch lock (VMDBK local area)
 Comments   :

 

VOPBK Control Block Content


VOPBK DSECT

Hex   Dec Type/Val   Lng Label (dup)    Comments
---- ---- --------- ---- -------------- --------
0000    0 Structure      VOPBK          HCPVOP simulation fetch/store
                                        work area
0000    0 Signed       4 VOPFLAG (0)
0000    0 Bitstring    1 VOPFLAG0       Flags for HCPVOP processing:
          1... ....      VOPBUFSP       X'80' ..Caller has specified the
                                        ..buffer to use.
          .1.. ....      VOPRWERR       X'40' Indicate register wrap
                                        error
          ..1. ....      VOPSTLOG       X'20' Indicate request store into
                                        guest logical address.
          ...1 ....      VOPFONLY       X'10' Indicate this address space
                                        is read only.
          .... 1...      VOPNXTMV       X'08' More than one section of
                                        data will be moved.
          .... .1..      VOPGOTBF       X'04' HCPVOP got free storage for
                                        the output data buffer. The
                                        address of the buffer is in
                                        VOPBUFAD.
0001    1 Bitstring    1 VOPFLAG1       Additional HCPVOP flags:
          1... ....      VOPGAM64       X'80' HCPVOP may need to execute
                                        in 64-bit addressing mode to
                                        access ESAME mode guest storage
                                        as host logical storage.
          .1.. ....      VOPAMO64       X'40' HCPVOP is currently
                                        executing in 64-bit addressing
                                        mode to handle a V=V ESAME mode
                                        guest guest.
0002    2 Bitstring    1 VOPPURGE       Purge operation bits
0003    3 Bitstring    1 VOPAR          AR number
0004    4 Signed       4 *              Reserved for future IBM use
0008    8 Dbl-Word     8 VOPGWRAP       Mask for address wrap (64-bit)
0010   16 Signed       4 VOPAGSIZ       Page size - 1 (2047/4095)
0014   20 Address      4 VOPASUBR       Subroutine for translation of
                                        guest logical (virtual, real, or
                                        absolute) to host logical
0018   24 Address      4 VOPBUFAD       Pointer to CP operand buffer
001C   28 Address      4 VOPGRHL        Subroutine for translation of
                                        guest real or absolute to host
                                        logical
0020   32 Signed       4 VOPIPLCK       Address of IPTE lock (zero if
                                        relocation not active)
0024   36 Signed       4 VOPARMS (0)    Input parameters
0024   36 Signed       2 VOPLEN         Length of data to be fetched/
                                        stored in bits 0-11.
0024   36 Bitstring    1 *              Bits 0-7 of length.
0025   37 Bitstring    1 VOPINFL0       Bits 8-11 of length and 4 bits
                                        for flags.
          .... 1...      VOPEXPRM       X'08' Additional parameters are
                                        defined in the VNPBK.
          .... .1..      VOPALETS       X'04' Guest-use ALET specified.
          .... ..1.      VOPASITS       X'02' I-ASIT specified.
          .... ...1      VOPMCRCD       X'01' Return an MCRECORD.
0026   38 Bitstring    1 VOPINFLG       Input flags.
          1... ....      VOPLAP         X'80' Apply low address
                                        protection
          1... ....      VOPLAPFO       X'80' Apply low address
                                        protection
          .1.. ....      VOPPROT        X'40' Apply key protection
          ..1. ....      VOPGA64R       X'20' For entry points which
                                        accept a guest operand address
                                        input in R1, input guest 64-bit
                                        address is provided in 64-bit
                                        wide input R1; for all entry
                                        points which deal with guest
                                        operands, HCPVOP internally
                                        represents the 64-bit guest
                                        operand address in 64-bit R1.
          ...1 ....      VOPGA64S       X'10' For entry points which
                                        accept a guest operand address
                                        input in R1, input guest 64-bit
                                        address is provided in a 64-bit
                                        host real storage area pointed to
                                        by the 31-bit host real address
                                        in 32-bit input R1; for all entry
                                        points which deal with guest
                                        operands, HCPVOP internally
                                        represents the 64-bit guest
                                        operand address in a 64-bit host
                                        real storage area pointed to by
                                        the 31-bit host real address in
                                        31-bit R1. Notes : If neither
                                        VOPGA64R or VOPGA64S are on, then
                                        HCPVOP internally represents the
                                        31 bit guest operand address in
                                        32 bit R1, and, for all entry
                                        points which accept a guest
                                        operand address in R1, the R1
                                        input is a 31-bit guest operand
                                        address in 32-bit input R1. Notes
                                        : For entry points which accept a
                                        guest operand address input in
                                        R1, VOPGA64R and VOPGA64S are
                                        used to map both bits 18-19 of
                                        the input R0 parameter and also
                                        the copy of the input R0
                                        parameter saved in the VOPARMS /
                                        VOPINFLG fields. All entry points
                                        which deal with guest operands
                                        but do NOT accept a guest opeand
                                        address input in R1 have bits
                                        18-19 of the input R0 parameter
                                        undefined, and use the VOPERAND
                                        subroutine to determine the guest
                                        operand address. For these entry
                                        points, VOPGA64R and VOPGA64S are
                                        used both to MODIFY the local
                                        copy of the input R0 parameter
                                        (to indicate how VOPERAND has
                                        represented the guest operand
                                        address) and to map the copy of
                                        input R0 parameter (as modified
                                        by VOPERAND) saved in the VOPARMS
                                        / VOPINFLG fields. Needless to
                                        say, this is all much more
                                        confusing than it ought to be,
                                        but further cleanup is left for
                                        later, and should include an
                                        overhaul of HCPVINOP - HCPVOP
                                        interfaces.
          .... 1...      VOPREGW        X'08' Wrap register to R0 when
                                        RX=15
          .... .11.      VOPWRP64       X'06' 64-bit wrap rule
          .... .1..      VOPWRPD        X'04' Diagnose wrap rule
          .... ..1.      VOPWRP31       X'02' 31-bit wrap rule
          .... ...1      VOPREALA       X'01' Input is guest real address
0027   39 Bitstring    1 VOPCODE        The forth byte of input parm.
                                        First 4 bit is align code next 4
                                        bit is operand code or AR number
                                        or address space mode
0028   40 Dbl-Word     8 VOPASCE (0)    Address-Space-Control Element
                                        (ASCE), ESAME guest
0028   40 Signed       4 VOPASCEH       High half of ASCE, ESAME guest
                                        Reserved, 390 guest
002C   44 Signed       4 VOPASCEL (0)   Low half of ASCE, ESAME guest
002C   44 Bitstring    1 VOPASCB4       Byte 4 of ASCE, ESAME guest
002D   45 Bitstring    1 VOPASCB5       Byte 5 of ASCE, ESAME guest
002E   46 Bitstring    1 VOPASCB6       Byte 6 of ASCE, ESAME guest
002F   47 Bitstring    1 VOPASCB7       Byte 7 of ASCE, ESAME guest
0028   40 Signed       4 *              Reserved, 390 guest
002C   44 Signed       4 VOPSTD (0)     Segment-Table Designation (STD),
                                        390 guest
002C   44 Bitstring    1 VOPSTDB0       Byte 0 of STD, 390 guest
002D   45 Bitstring    1 VOPSTDB1       Byte 1 of STD, 390 guest
002E   46 Bitstring    1 VOPSTDB2       Byte 2 of STD, 390 guest
002F   47 Bitstring    1 VOPSTDB3       Byte 3 of STD, 390 guest
0030   48 Dbl-Word     8 VOPGADDR (0)   Input address (64-bit)
0030   48 Signed       4 VOPHADDR       High half of large input address
0034   52 Signed       4 VOPADDR        Low half (31-bit) input address
     Longer data moves can be handled in up to three sections. The host
     logical address for each section, as well as the length of each
     section, are saved in this small array with 3 entries. Each entry has a
     64-bit host logical address field (VOPGHLAD), the right half of which
     is mapped as a 31-bit host logical address field (VOPHLADR), and a
     length field (VOPHLLEN). The same names are used for all three entries,
     the table is accessed using an index register containing a multiple of
     the entry length (VOPHLAEL).
0038   56 Dbl-Word     8 VOPHLAEN (0)   A host logical address section
                                        entry
0038   56 Dbl-Word     8 VOPGHLAD (0)   Host logical address of the first
                                        section (64-bit)
0038   56 Signed       4 *              (high half of VOPGHVA1)
003C   60 Address      4 VOPHLADR       Host logical address of the first
                                        section (31-bit)
0040   64 Signed       4 VOPHLLEN       Length of the first section -1
0044   68 Signed       4 *              reserved for IBM use
          00000010       VOPHLAEL       *-VOPHLAEN Length of one entry
0048   72 Bitstring    1 * (32)         Space for two more entries
0068  104 Dbl-Word     8 VOPIASIT       I-ASIT for the guest-absolute
                                        address space to be accessed.
0070  112 Signed       4 VOPEXADR       Address of the extended parameter
                                        list, if one exists.
0074  116 Signed       4 VOPEXFLG (0)   Flag field from the extended
                                        parameter list.
0074  116 Bitstring    1 VOPEXFB0       Byte 0 of VOPEXFLG
          1... ....      VOPBAUTO       VNPBAUTO BUFADDR=AUTO was
                                        specified
          .1.. ....      VOPLNFLD       VNPLNFLD The LENFIELD operand was
                                        specified, and the length to
                                        fetch is found in the halfword
                                        whose displacement is in
                                        VOPLENFD.
          ..1. ....      VOPMXLEN       VNPMXLEN The MAXLEN operand was
                                        specified, and the maximum length
                                        to fetch is in VOPMAXLN.
0075  117 Bitstring    1 VOPEXFB1       Byte 1 of VOPEXFLG
0076  118 Bitstring    1 VOPEXFB2       Byte 2 of VOPEXFLG
0077  119 Bitstring    1 VOPEXFB3       Byte 3 of VOPEXFLG
0078  120 Signed       4 VOPLENFD       Displacement of the field from
                                        which to fetch the parameter list
                                        length.
007C  124 Signed       4 VOPLUNIT       Units in which the length to
                                        fetch is expressed.
0080  128 Address      2 VOPMAXLN       Maximum length to fetch, in DWs.
0082  130 Signed       2 VOPLENTH       Length fetched from LENFIELD
0084  132 Signed       4 *              reserved for IBM use
0088  136 Dbl-Word     8 VOPPSW         Guest PSW (bits 0-64) HCPVOP only
                                        uses VOPPSW to save the bits in
                                        the beginning of the guest's PSW.
                                        It has no need for the
                                        instruction address. So, VOPPSW
                                        is large enough to save the
                                        entire PSW for a 390 mode guest
                                        or the first half of an ESAME
                                        mode guest.
          00000090       VOPBKLEN       *-VOPBK Define the length of the
                                        DSECT
          00000012       VOPBKSIZ       (VOPBKLEN+7)/8 Size of VOPBK in
                                        doublewords

 

VOPBK Storage Layout

          
*** VOPBK - HCPVOP simulation fetch/store work area
*
*     +------+------+------+------+---------------------------+
*   0 |:FLAG0|:FLAG1|:PURGE|VOPAR |///////////////////////////|
*     +------+------+------+------+---------------------------+
*   8 |                       VOPGWRAP                        |
*     +---------------------------+---------------------------+
*  10 |         VOPAGSIZ          |         VOPASUBR          |
*     +---------------------------+---------------------------+
*  18 |         VOPBUFAD          |         VOPGRHL           |
*     +---------------------------+-------------+-------------+
*  20 |         VOPIPLCK          |   VOPLEN    |/////////////|
*     +---------------------------+-------------+/////////////|
*     |///////////////////////////////////////////////////////|
*     +---------------------------+---------------------------+
*  30 |         VOPHADDR          |         VOPADDR           |
*     +---------------------------+---------------------------+
*  38 |///////////////////////////|         VOPHLADR          |
*     +---------------------------+---------------------------+
*  40 |         VOPHLLEN          |///////////////////////////|
*     +---------------------------+---------------------------+
*  48 |///////////////////////////////////////////////////////|
*     =///////////////////////////////////////////////////////=
*     |///////////////////////////////////////////////////////|
*     +-------------------------------------------------------+
*  68 |                       VOPIASIT                        |
*     +---------------------------+------+------+------+------+
*  70 |         VOPEXADR          |:EXFB0|:EXFB1|:EXFB2|:EXFB3|
*     +---------------------------+------+------+------+------+
*  78 |         VOPLENFD          |         VOPLUNIT          |
*     +-------------+-------------+---------------------------+
*  80 |  VOPMAXLN   |  VOPLENTH   |///////////////////////////|
*     +-------------+-------------+---------------------------+
*  88 |                        VOPPSW                         |
*     +-------------------------------------------------------+
*  90
*
*** VOPBK - HCPVOP simulation fetch/store work area
          
*** Overlay for VOPLEN in VOPBK
*
*                                 +------+------+------+------+
*  20 ...                      24 |//////|:INFL0|:INFLG|:CODE |
*     +---------------------------+------+------+------+------+
*  28 |         VOPASCEH          |:ASCB4|:ASCB5|:ASCB6|:ASCB7|
*     +---------------------------+------+------+------+------+
*  30
*
*** Overlay for VOPLEN in VOPBK
          
*** Overlay for VOPASCE in VOPBK
*
*     +---------------------------+------+------+------+------+
*  28 |///////////////////////////|:STDB0|:STDB1|:STDB2|:STDB3|
*     +---------------------------+------+------+------+------+
*  30
*
*** Overlay for VOPASCE in VOPBK

 

VOPBK Cross Reference

Symbol         Dspl Value
-------------- ---- -----
VOPADDR        0034
VOPAGSIZ       0010
VOPALETS       0025 04
VOPAMO64       0001 40
VOPAR          0003
VOPARMS        0024
VOPASCB4       002C
VOPASCB5       002D
VOPASCB6       002E
VOPASCB7       002F
VOPASCE        0028
VOPASCEH       0028
VOPASCEL       002C
VOPASITS       0025 02
VOPASUBR       0014
VOPBAUTO       0074 80
VOPBKLEN       0088 00000090
VOPBKSIZ       0088 00000012
VOPBUFAD       0018
VOPBUFSP       0000 80
VOPCODE        0027
VOPEXADR       0070
VOPEXFB0       0074
VOPEXFB1       0075
VOPEXFB2       0076
VOPEXFB3       0077
VOPEXFLG       0074
VOPEXPRM       0025 08
VOPFLAG        0000
VOPFLAG0       0000
VOPFLAG1       0001
VOPFONLY       0000 10
VOPGADDR       0030
VOPGAM64       0001 80
VOPGA64R       0026 20
VOPGA64S       0026 10
VOPGHLAD       0038
VOPGOTBF       0000 04
VOPGRHL        001C
VOPGWRAP       0008
VOPHADDR       0030
VOPHLADR       003C
VOPHLAEL       0044 00000010
VOPHLAEN       0038
VOPHLLEN       0040
VOPIASIT       0068
VOPINFLG       0026
VOPINFL0       0025
VOPIPLCK       0020
VOPLAP         0026 80
VOPLAPFO       0026 80
VOPLEN         0024
VOPLENFD       0078
VOPLENTH       0082
VOPLNFLD       0074 40
VOPLUNIT       007C
VOPMAXLN       0080
VOPMCRCD       0025 01
VOPMXLEN       0074 20
VOPNXTMV       0000 08
VOPPROT        0026 40
VOPPSW         0088
VOPPURGE       0002
VOPREALA       0026 01
VOPREGW        0026 08
VOPRWERR       0000 40
VOPSTD         002C
VOPSTDB0       002C
VOPSTDB1       002D
VOPSTDB2       002E
VOPSTDB3       002F
VOPSTLOG       0000 20
VOPWRPD        0026 04
VOPWRP31       0026 02
VOPWRP64       0026 06

This information is based on z/VM V4R2.0. Last updated on 17 Oct 2001 at 17:12:46 EDT.
Copyright IBM Corporation, 1990, 2001