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 V4R2.0. Last updated on 17 Oct 2001 at 16:07:58 EDT.
Copyright IBM Corporation, 1990, 2001