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

#### PPLBK

Prolog

Control Block Contents
PPLBK DSECT

Storage Layout

Cross Reference (Contains links to field and bit definitions)

#### PPLBK Prolog

     Name       : HCPPPLBK
     Description: Product Parameter List Block
     DSECT      : PPLBK
     Function   : Contains information relating to Products
                  that is used by diagnose x'27C' interface to
                  CP.  This block is used to pass information
                  to and from the virtual machine.
     Located by : Register Rx contains the guest real address
                  of the PPLBK at the time Diagnose X'27C'
                  is issued.
     Created by : The Program issuing Diagnose X'27C'
     Deleted by : The Program issuing Diagnose X'27C'
     Serialized : The Program issuing Diagnose X'27C'
     Comments   : The PPLBK is fetched by CP from guest storage
                  when Diagnose X'27C' is issued by the guest.
                  The PPLBK will be stored back in guest storage
                  by CP upon completion of the specific
                  diagnose function.

#### PPLBK Control Block Content

#### PPLBK DSECT

    Hex   Dec Type/Val   Lng Label (dup)    Comments
    ---- ---- --------- ---- -------------- --------
    0000    0 Structure      PPLBK          Product Parameter List Block
    0000    0 Bitstring    1 PPLTYPE        Type of enablement block
              00000001       PPLPROD        X'01' PPLPROD Indicates this is
                                            Product Block
    0001    1 Bitstring    1 PPLFLAG1       Status Flag for Enablement block
              1... ....      PPLENABL       X'80' PPLENABL Product is Enabled
              .1.. ....      PPLDISAB       X'40' PPLDISAB Product is
                                            Disabled
              ...1 ....      PPLDESCR       X'10' PPLDESCR Definition
                                            Contains Description
              ..1. 1111      PPLRES2F       X'2F' PPLRES2F ** Reserved for
                                            IBM use **
    0002    2 Bitstring   14 PPLRESV1       ** Reserved for IBM use **
    0010   16 Dbl-Word     8 * (0)
    0010   16 Character    8 PPLPRDID       Product Identifier (7 or 8 chars)
    0018   24 Signed       4 PPLDESCL       Length of product description
    001C   28 Address      4 PPLDESCA       Address of product description
              1111 1111      PPLMXDES       X'FF' Maximum product Description
                                            size
              00000020       PPLBKSZ        (*-PPLBK) Size of PPLBK in bytes
              00000004       PPLBKSZD       (*-PPLBK+7)/8 Size of PPLBK in
                                            Doublewords

#### PPLBK Storage Layout

    *** PPLBK - Product Parameter List Block
    *
    *     +------+------+-----------------------------------------+
    *   0 |:TYPE |:FLAG1|                PPLRESV1                 |
    *     +------+------+                                         |
    *     |                                                       |
    *     +-------------------------------------------------------+
    *  10 |                       PPLPRDID                        |
    *     +---------------------------+---------------------------+
    *  18 |         PPLDESCL          |         PPLDESCA          |
    *     +---------------------------+---------------------------+
    *  20
    *
    *** PPLBK - Product Parameter List Block

#### PPLBK Cross Reference

    Symbol         Dspl Value
    -------------- ---- -----
    PPLBKSZ        001C 00000020
    PPLBKSZD       001C 00000004
    PPLDESCA       001C
    PPLDESCL       0018
    PPLDESCR       0001 10
    PPLDISAB       0001 40
    PPLENABL       0001 80
    PPLFLAG1       0001
    PPLMXDES       001C FF
    PPLPRDID       0010
    PPLPROD        0000 00000001
    PPLRESV1       0002
    PPLRES2F       0001 2F
    PPLTYPE        0000

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