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