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.2.0 Last updated on 24 Jun 2020 at 09:29:44 EDT.
Copyright IBM Corporation, 1990, 2020