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' 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' 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 V5R2.0. Last updated on 12 Apr 2006 at 17:18:22 EDT.
Copyright IBM Corporation, 1990, 2005