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

#### PPRLG

Prolog

Control Block Contents
PPRLG DSECT

Storage Layout

Cross Reference (Contains links to field and bit definitions)

#### PPRLG Prolog

     Name       : HCPPPRLG
     Description: Pending Page Release Log
     DSECT      : PPRLG
     Function   : This block contains address pairs that represent
                  guest real page frames that are in the pending
                  release state.
     Located by : VMDPPRLG points to the PPRLG for that guest.
     Created by : HCPFST when B2FF is issued and no log exits.
     Deleted by : HCPPPRFR after processing the log.

#### PPRLG Control Block Content

#### PPRLG DSECT

    Hex   Dec Type/Val   Lng Label (dup)    Comments
    ---- ---- --------- ---- -------------- --------
    0000    0 Structure      PPRLG          Pending Page Release Log
    0000    0 Dbl-Word     8 PPRLGENT       PPRLG entry
              00000008       PPRLGESZ       *-PPRLGENT PPRLG entry size in
                                            bytes
    0008    8 Dbl-Word     8 * (120)        Log (56-small, 120-large)
              000003C8       PPRLGOFS       *-PPRLG Displacement to Last
                                            entry
    03C8  968 Dbl-Word     8 PPRLE          Last entry
              000003D0       PPRLGSZ        *-PPRLG Log size in bytes
    03D0  976 Dbl-Word     8 PPRIASIT       I-ASIT for log's space
    03D8  984 Bitstring    1 PPRFLAG        Flag byte
              1... ....      PPRSTKD        X'80' PPRSTKD HCPPPRDF call
                                            stacked This flag is set to
                                            indicate that HCPPPRFR/KP/KL has
                                            been unable to completely process
                                            the PPRLG, and has stacked a call
                                            to entry HCPPPRDF. If a
                                            subsequent invocation of one of
                                            HCPPPRFR/KP/KL occurs prior to
                                            the unstack of the call to
                                            HCPPPRDF, this flag will inform
                                            HCPPPRFR/KP/KL that call to
                                            HCPPPRDF is already stacked, and
                                            another one is not necessary.
              .1.. ....      PPRFRET        X'40' PPRFRET HCPPPRFR requests
                                            log fret This flag is set to
                                            indicate to HCPPPRDF that it
                                            should NOT process the log, just
                                            fret it. HCPPPRFR sets it if
                                            PPRSTKD is already set.
    03D9  985 Bitstring    1 * (7)          reserved
              0000007C       PPRLGDWD       (*-PPRLG+7)/8 Log size + lock in
                                            Dwds. Total size + hdrs = 128DW
    0000    0 Signed       4 PPRLO          Low page range
    0004    4 Signed       4 PPRHI          High address of range

#### PPRLG Storage Layout

    *** PPRLG - Pending Page Release Log
    *
    *     +-------------------------------------------------------+
    *   0 |                       PPRLGENT                        |
    *     +-------------------------------------------------------+
    *   8 |///////////////////////////////////////////////////////|
    *     =///////////////////////////////////////////////////////=
    *     |///////////////////////////////////////////////////////|
    *     +-------------------------------------------------------+
    * 3C8 |                        PPRLE                          |
    *     +-------------------------------------------------------+
    * 3D0 |                       PPRIASIT                        |
    *     +------+------------------------------------------------+
    * 3D8 |:FLAG |////////////////////////////////////////////////|
    *     +------+------------------------------------------------+
    * 3E0
    *
    *** PPRLG - Pending Page Release Log

    *** Overlay for PPRLGENT in PPRLG
    *
    *     +---------------------------+---------------------------+
    *   0 |          PPRLO            |          PPRHI            |
    *     +---------------------------+---------------------------+
    *   8
    *
    *** Overlay for PPRLGENT in PPRLG

#### PPRLG Cross Reference

    Symbol         Dspl Value
    -------------- ---- -----
    PPRFLAG        03D8
    PPRFRET        03D8 40
    PPRHI          0004
    PPRIASIT       03D0
    PPRLE          03C8
    PPRLGDWD       03D9 0000007C
    PPRLGENT       0000
    PPRLGESZ       0000 00000008
    PPRLGOFS       0008 000003C8
    PPRLGSZ        03C8 000003D0
    PPRLO          0000
    PPRSTKD        03D8 80

This information is based on z/VM V6R1.0. Last updated on 18 Feb 2010 at 08:58:11 EDT.
Copyright IBM Corporation, 1990, 2008