RTVBK | Back to Index page

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

RTVBK Prolog | Top of page

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

     RTVBK DSECT
    Top of page

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

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

    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 7.2.0 Last updated on 24 Jun 2020 at 09:30:07 EDT.
Copyright IBM Corporation, 1990, 2020