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

RTVBK

Prolog  

Control Block Contents  
   RTVBK DSECT

Storage Layout  

Cross Reference (Contains links to field and bit definitions)  


RTVBK Prolog

 NAME       : HCPRTVBK
 DESCRIPTION: CP Program Function Key Retrieve Block
 DSECT      : RTVBK
 FUNCTION   : The RTVBK contains information used to
              handle PFKey RETRIEVE requests
 LOCATED BY : HCPPFUNC field PFUNRTV
 CREATED BY : HCPPFK
 DELETED BY : HCPPFK
 RELOCATION CONSIDERATIONS : This control block is relocated as part of a live
              guest relocation (LGR).  The bits and fields that
              need to be relocated are defined in the
              corresponding LGRRTVBK COPY file.  Whenever changes
              are made to this control block, consideration must
              be given to any effects these changes will have on
              a relocation.  If any new fields or bits are
              defined, they may need to be relocated.  If
              existing bits or fields are changed, corresponding
              modifications may be required in the LGR version of
              this control block.  Consider also the effects of
              these changes on a relocation involving a back-level
              release of CP.

 

RTVBK Control Block Content


RTVBK DSECT

Hex   Dec Type/Val   Lng Label (dup)    Comments
---- ---- --------- ---- -------------- --------
0000    0 Structure      RTVBK          CP Program Function Key Retrieve Block
0000    0 Signed       2 RTVALLOC       Number of RETRIEVE PF keys
                                        alloc'd
0002    2 Signed       2 RTVBFREQ       Number of RETRIEVE buffers
                                        requested
0004    4 Signed       2 RTVDFCNT       Number of RETRIEVE PF keys
                                        defined
0006    6 Signed       2 RTVBFCNT       Number of RETRIEVE buffers so far
0008    8 Signed       2 RTVLSRTV       Last retrieved entry
000A   10 Signed       2 *              Reserved
000C   12 Signed       2 *              Reserved
000E   14 Signed       2 *              Reserved
0010   16 Dbl-Word     8 * (0)
          00000002       RTVBKHL        (*-RTVBK+7)/8 Length of RTVBK
                                        Header in dw
      The RTVGSDBK field is repeated (RTVALLOC) times.
0010   16 Address      4 RTVGSDBK       A(GSDBK)

 

RTVBK Storage Layout

          
*** RTVBK - CP Program Function Key Retrieve Block
*
*     +-------------+-------------+-------------+-------------+
*   0 |  RTVALLOC   |  RTVBFREQ   |  RTVDFCNT   |  RTVBFCNT   |
*     +-------------+-------------+-------------+-------------+
*   8 |  RTVLSRTV   |/////////////|/////////////|/////////////|
*     +-------------+-------------+-------------+-------------+
*  10 |         RTVGSDBK          | 14
*     +---------------------------+
*
*** RTVBK - CP Program Function Key Retrieve Block

 

RTVBK Cross Reference

Symbol         Dspl Value
-------------- ---- -----
RTVALLOC       0000
RTVBFCNT       0006
RTVBFREQ       0002
RTVBKHL        0010 00000002
RTVDFCNT       0004
RTVGSDBK       0010
RTVLSRTV       0008

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