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

VUDBK

Prolog  

Control Block Contents  
   VUDBK DSECT

Storage Layout  

Cross Reference (Contains links to field and bit definitions)  


VUDBK Prolog

 NAME       : HCPVUDBK
 DESCRIPTION: Vestigial User Data Block
 DSECT      : VUDBK
 FUNCTION   : To contain Vestigial User Data (historical data for
              resources owned by the user which have since been
              destroyed).
 LOCATED BY : VMDVUDBK Field of a base VMDBK
 CREATED BY : VUDBKs are dynamically created by HCPASMDS or
              HCPASNRS when destroying an address space.
 DELETED BY : VUDBKs are deleted during log-off processing.
 SERIALIZED : Access to this control block is obtained by acquiring
              the owning user's VUDBK spin lock.
 RELOCATION CONSIDERATIONS : This block is sent to the destination system during a
              relocation. Any changes made to it should be done in a
              compatible manner. Offsets for existing fields should
              not change; any new fields should be added to the end.
              If changes are made to this block, consideration
              should also be given to creating and sending a
              LGRVUDBK COPY file (i.e., a relocation mapping file).

 

VUDBK Control Block Content


VUDBK DSECT

Hex   Dec Type/Val   Lng Label (dup)    Comments
---- ---- --------- ---- -------------- --------
0000    0 Structure      VUDBK          Vestigial User Data Block
0000    0 Address      4 VUDOWNER       Pointer to (base) VMDBK of owning
                                        virtual configuration.
0004    4 Signed       4 *              Reserved for IBM use.
      Cumulative historical counts, accumulated while
      destroyed address spaces were private.
0008    8 Signed       4 VUDCPPST       Count of private address space
                                        pages stolen.
000C   12 Signed       4 VUDCPPGR       Count of private address space
                                        pages read from DASD.
0010   16 Signed       4 VUDCPPGW       Count of private address space
                                        pages written to DASD.
0014   20 Signed       4 VUDCPXRD       Count of private address space
                                        pages read from XSTORE.
0018   24 Signed       4 VUDCPXWT       Count of private address space
                                        pages written to XSTORE.
001C   28 Signed       4 VUDCPMIG       Count of private address space
                                        pages migrated by CP from XSTORE
                                        to DASD.
0020   32 Signed       4 *              Reserved for IBM use
0024   36 Signed       4 *              Reserved for IBM use
      Cumulative historical counts, accumulated while
      destroyed address spaces were shared.
0028   40 Signed       4 VUDCSPST       Count of shared address space
                                        pages stolen.
002C   44 Signed       4 VUDCSPGR       Count of shared address space
                                        pages read from DASD.
0030   48 Signed       4 VUDCSPGW       Count of shared address space
                                        pages written to DASD.
0034   52 Signed       4 VUDCSXRD       Count of shared address space
                                        pages read from XSTORE.
0038   56 Signed       4 VUDCSXWT       Count of shared address space
                                        pages written to XSTORE.
003C   60 Signed       4 VUDCSMIG       Count of shared address space
                                        pages migrated by CP from XSTORE
                                        to DASD.
0040   64 Signed       4 *              Reserved for IBM use
0044   68 Signed       4 *              Reserved for IBM use
          00000048       VUDLEN         *-VUDBK Length of VUDBK in bytes
          00000009       VUDSIZE        (*-VUDBK+7)/8 Size of VUDBK in
                                        doublewords

 

VUDBK Storage Layout

          
*** VUDBK - Vestigial User Data Block
*
*     +---------------------------+---------------------------+
*   0 |         VUDOWNER          |///////////////////////////|
*     +---------------------------+---------------------------+
*   8 |         VUDCPPST          |         VUDCPPGR          |
*     +---------------------------+---------------------------+
*  10 |         VUDCPPGW          |         VUDCPXRD          |
*     +---------------------------+---------------------------+
*  18 |         VUDCPXWT          |         VUDCPMIG          |
*     +---------------------------+---------------------------+
*  20 |///////////////////////////|///////////////////////////|
*     +---------------------------+---------------------------+
*  28 |         VUDCSPST          |         VUDCSPGR          |
*     +---------------------------+---------------------------+
*  30 |         VUDCSPGW          |         VUDCSXRD          |
*     +---------------------------+---------------------------+
*  38 |         VUDCSXWT          |         VUDCSMIG          |
*     +---------------------------+---------------------------+
*  40 |///////////////////////////|///////////////////////////|
*     +---------------------------+---------------------------+
*  48
*
*** VUDBK - Vestigial User Data Block

 

VUDBK Cross Reference

Symbol         Dspl Value
-------------- ---- -----
VUDCPMIG       001C
VUDCPPGR       000C
VUDCPPGW       0010
VUDCPPST       0008
VUDCPXRD       0014
VUDCPXWT       0018
VUDCSMIG       003C
VUDCSPGR       002C
VUDCSPGW       0030
VUDCSPST       0028
VUDCSXRD       0034
VUDCSXWT       0038
VUDLEN         0044 00000048
VUDOWNER       0000
VUDSIZE        0044 00000009

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