PRKBK Back to Index page
 
Prolog 
Control Block Contents 
   PRKBK DSECT
Storage Layout 
Cross Reference (Contains links to field and bit definitions)
Programming Interface Information:
This information is NOT intended to be
used as Programming Interfaces of z/VM.


  PRKBK Prolog Top of page
  
 NAME       : HCPPRKBK
 DESCRIPTION: PARK/UNPARK RELATED DATA AREAS
 DSECT      : PRKBK
 FUNCTION   : Fields used to decide parked CPUs, master,
              and unparked CPUs when there are topology
              or white space changes.
 LOCATED BY :
              HCPRCCPK - Park/UnPark Related Structures
 CREATED BY :
              System initialization
 DELETED BY :
              System termination
 SERIALIZED : These fields are serialized by the Vary
              Processor Lock (HCPRCCVA).
 RELOCATION CONSIDERATIONS : None
              Notes      : It is the desired end state, not what needs to
              change.  The request is created by HCPHICCU
              while holding the Vary Processor Lock, and the
              entire request is processed by HCPMPCTP with
              a continuous hold of the Vary Processor Lock.
 
 
  PRKBK Control Block Content Top of page
  




 PRKBK DSECT
Top of page


Hex   Dec Type/Val   Lng Label (dup)    Comments
---- ---- --------- ---- -------------- --------
0000    0 Structure      PRKBK          PARK/UNPARK RELATED DATA AREAS
0000    0 Bitstring    1 PRKPKFLG       Flag indicating new request
          .... ...1      PRKPKNEW       X'01' PRKPKNEW New request to be
                                        processed
0001    1 Bitstring    3 *              Reserved for IBM use
0004    4 Signed       4 *              Reserved for IBM use
0008    8 Dbl-Word     8 * (0)
0008    8 Bitstring   64 PRKPKMST       Mask of master CPU
0048   72 Bitstring   64 PRKUPMKS (6)   Desired unpark masks
0048   72 Bitstring   64 PRKCPMK        Unpark mask for CP CPUs
0088  136 Bitstring    1 *              Reserved for IBM use
00C8  200 Bitstring   64 PRKZAPMK       Unpark mask for zAAP CPUs
0108  264 Bitstring   64 PRKIFLMK       Unpark mask for IFL CPUs
0148  328 Bitstring   64 PRKICFMK       Unpark mask for ICF CPUs
0188  392 Bitstring   64 PRKZIPMK       Unpark mask for zIIP CPUs
          .... .1..      PRKUPMSK_SHFT  4 PRKUPMSK_SHFT shift to convert
                                        SRMXTBL into a prope offset into
                                        PRKUPMKS array verify shift value
                                        will properly index the SRMXTBL.
                                        we index a value of 4 because it
                                        is an array of 4 byte addresses.
                                        We also multiply by 8 to convert
                                        the byte value into a bit value
                                        for the CKMAINT.
01C8  456 Bitstring   14 PRKPKWRK       Work area for HCPMPCTP
01C8  456 Bitstring   64 PRKWUPKS (6)   Array of calculated unpark masks
0348  840 Bitstring   64 PRKWPRKS (6)   Array of calculated park masks
          .... .11.      PRKARRAY_SHFT  6 PRKARRAY_SHFT shift to get
                                        proper offset into calculated
                                        park/unpark array verify shift
                                        value will properly index the
                                        park/unpark array.
04C8 1224 Bitstring   64 PRKWVOUP       Vary-off mask of unparked procs
0508 1288 Bitstring   64 PRKWVOPK       Vary-off mask of parked procs
          00000600       PRKBSIZE       (*-PRKBK+255)/256*256 consume a
                                        full number of cache lines
 
 
  PRKBK Storage Layout Top of page
  
          
*** PRKBK - PARK/UNPARK RELATED DATA AREAS
*
*     +------+--------------------+---------------------------+
*   0 |:PKFLG|////////////////////|///////////////////////////|
*     +------+--------------------+---------------------------+
*   8 |                                                       |
*     =                       PRKPKMST                        =
*     |                                                       |
*     +-------------------------------------------------------+
*  48 |                                                       |
*     =                       PRKUPMKS                        =
*     |                                                       |
*     +-------------------------------------------------------+
* 1C8 |///////////////////////////////////////////////////////|
*     =///////////////////////////////////////////////////////=
*     |///////////////////////////////////////////////////////|
*     +-------------------------------------------------------+
* 548
*
*** PRKBK - PARK/UNPARK RELATED DATA AREAS
          
*** Overlay for PRKUPMKS in PRKBK
*
*     +-------------------------------------------------------+
*  48 |                                                       |
*     =                       PRKCPMK                         =
*     |                                                       |
*     +------+------------------------------------------------+
*  88 |//////|////////////////////////////////////////////////|
*     +------+////////////////////////////////////////////////|
*  90 |///////////////////////////////////////////////////////|
*     =///////////////////////////////////////////////////////=
*     |///////////////////////////////////////////////////////|
*     +-------------------------------------------------------+
*  C8 |                                                       |
*     =                       PRKZAPMK                        =
*     |                                                       |
*     +-------------------------------------------------------+
* 108 |                                                       |
*     =                       PRKIFLMK                        =
*     |                                                       |
*     +-------------------------------------------------------+
* 148 |                                                       |
*     =                       PRKICFMK                        =
*     |                                                       |
*     +-------------------------------------------------------+
* 188 |                                                       |
*     =                       PRKZIPMK                        =
*     |                                                       |
*     +-------------------------------------------------------+
* 1C8 |                       PRKPKWRK                        |
*     |                                         +-------------+
*     |                                         | 1D6
*     +-----------------------------------------+
*
*** Overlay for PRKUPMKS in PRKBK
          
*** Overlay for PRKPKWRK in PRKBK
*
*     +-------------------------------------------------------+
* 1C8 |                                                       |
*     =                       PRKWUPKS                        =
*     |                                                       |
*     +-------------------------------------------------------+
* 348 |                                                       |
*     =                       PRKWPRKS                        =
*     |                                                       |
*     +-------------------------------------------------------+
* 4C8 |                                                       |
*     =                       PRKWVOUP                        =
*     |                                                       |
*     +-------------------------------------------------------+
* 508 |                                                       |
*     =                       PRKWVOPK                        =
*     |                                                       |
*     +-------------------------------------------------------+
* 548
*
*** Overlay for PRKPKWRK in PRKBK
 
 
  PRKBK Cross Reference Top of page
  
 
Symbol         Dspl Value
-------------- ---- -----
PRKARRAY_SHFT  0348 06
PRKBSIZE       0508 00000600
PRKCPMK        0048
PRKICFMK       0148
PRKIFLMK       0108
PRKPKFLG       0000
PRKPKMST       0008
PRKPKNEW       0000 01
PRKPKWRK       01C8
PRKUPMKS       0048
PRKUPMSK_SHFT  0188 04
PRKWPRKS       0348
PRKWUPKS       01C8
PRKWVOPK       0508
PRKWVOUP       04C8
PRKZAPMK       00C8
PRKZIPMK       0188
 
This information is based on z/VM 7.3.0 Last updated on 22 Jun 2022 at 15:53:42 EDT.
Copyright IBM Corporation, 1990, 2022