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' Indicates this is Product
                                            Block
    0001    1 Bitstring    1 PPLFLAG1       Status Flag for Enablement block
              1... ....      PPLENABL       X'80' Product is Enabled
              .1.. ....      PPLDISAB       X'40' Product is Disabled
              ...1 ....      PPLDESCR       X'10' Definition Contains
                                            Description
              ..1. 1111      PPLRES2F       X'2F' ** 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 V5R2.0. Last updated on 12 Apr 2006 at 17:18:21 EDT.
Copyright IBM Corporation, 1990, 2005