Programming Interface Information: This information is NOT intended to be used as Programming Interfaces of z/VM.

#### RCCBK

Prolog

Control Block Contents
RCCBK DSECT

Storage Layout

Cross Reference (Contains links to field and bit definitions)

#### RCCBK Prolog

     NAME       : HCPRCCBK
     DESCRIPTION: RCPU DATA AREA MAPPING
     DSECT      : RCCBK
     FUNCTION   :
                  This control block maps the RCPU data area and
                  defines constants used by the RCPU subsystem.
     LOCATED IN -
                  HCPRCCCM - RPCU common data area
     CREATED BY :
                  System initialization
     DELETED BY :
                  System termination
     SERIALIZED :

#### RCCBK Control Block Content

#### RCCBK DSECT

    Hex   Dec Type/Val   Lng Label (dup)    Comments
    ---- ---- --------- ---- -------------- --------
    0000    0 Structure      RCCBK          RCPU DATA AREA MAPPING
                 SAVBK management zappable constants and queues
    0000    0 Dbl-Word     8 RCCURCQ        SAVBK reclaim queue (unsorted)
    0008    8 Address      4 RCCSRCQ        SAVBK reclaim queue (sorted)
    000C   12 Address      4 RCCSFQ         SAVE frame queue
    0010   16 Signed       4 RCCRCNUM       Number of SAVBKs being reclaimed
    0014   20 Signed       4 RCCSVNUM       Number of SAVBKs allocated
    0018   24 Dbl-Word     8 RCCSFQL (6)    SAVE frame queue lock
    0048   72 Signed       8 RCCICFAB       Incomplete frame reclaim time
                                            limit in seconds
    0050   80 Signed       8 RCCLNINT       HCPSAMFS sampling period, 10 sec.
    0058   88 Signed       4 RCCNOINT       Number of intervals to average
              .... 1...      RCCMXAVS       8 RCCMXAVS Scaling factor for
                                            below &VX1NASG
    005C   92 Signed       4 RCCMAXAV       Maximum percentage of buffers
                                            available
    0060   96 Signed       4 RCCMINSV       Minimum number of saveareas per
                                            processor
    0064  100 Address      1 RCCSTFLG       Free storage availability flags
              1... ....      RCCSAVL        X'80' RCCSAVL Free storage
                                            available for SAVBKs
    0065  101 Bitstring    1 * (3)          Reserved for future IBM use
                 MP Defer Data Area
                 Checkpoint determination intervals
    0068  104 Signed       8 RCCMPDLY       1/10 second, until adjusted by
                                            HCPISR to be a function of the
                                            minor timeslice.
    0070  112 Dbl-Word     8 *              Reserved for IBM use
    0078  120 Address      1 RCCMPDAC       MP Defer Active Test & Set flag
    0079  121 Bitstring    3 *              Reserved
                 "CP Loss of Control" deferred work queues
    007C  124 Address      4 RCCMPCQ0       Work for which 0 or more MP
                                            checkpoints have occurred
    0080  128 Address      4 RCCMPCQ1       Work for which 1 or more MP
                                            checkpoints have occurred
                 "Loss of Control" deferred work queues
    0084  132 Address      4 RCCMPSQ0       Work for which 0 or more MP
                                            checkpoints have occurred
    0088  136 Address      4 RCCMPSQ1       Work for which 1 or more MP
                                            checkpoints have occurred
            RCCCPUAA:  Array of CPU addresses for online processors
            Function   :  Used to get the CPU address of a CPU with a
                       given PFXINDEX. The PFXINDEX divided by 2 is
                       the displacement of a CPU's entry in this
                       array.  VMDHPLDV can also be used to find a
                       CPU's  entry in this array due to the direct
                       relationship (VMDHDVSH) between VMDHPLDV and
                       PFXINDEX for a given CPU.  Finally, since
                       VMDHPLDV is just the displacement of the
                       PLDV in the array of PLDVs (HCPDSVST), the
                       address of a PLDV can be used to index into
                       this array as well.  The following are useful
                       relationships:
                        1) VMDHPLDV = addr(PLDV) - addr(HCPDSVST)
                        2) PFXINDEX = VMDHPLDV / 2**VMDHDVSH
                        3) RCCCPUAA index = PFXINDEX / 2
            Serialized :
                       This array should be changed only when the
                       VARY lock is held or for the IPL processor
                       at initialization time.
                       No serialization needed to examine an entry.
                       When an entry in the array is being examined,
                       a value of x'FFFF' means the processor is no
                       longer available.  Any value other than
                       x'FFFF' means either that the processor is
                       available or that the processor has been
                       varied off but the 2 minute wait interval
                       before its storage is released has not
                       expired.  Do not assume that the processor
                       is available just because its entry in this
                       array is other than x'FFFF'.
    008C  140 Signed       2 RCCCPUAA (64)  CPU address array

#### RCCBK Storage Layout

    *** RCCBK - RCPU DATA AREA MAPPING
    *
    *     +-------------------------------------------------------+
    *   0 |                       RCCURCQ                         |
    *     +---------------------------+---------------------------+
    *   8 |         RCCSRCQ           |          RCCSFQ           |
    *     +---------------------------+---------------------------+
    *  10 |         RCCRCNUM          |         RCCSVNUM          |
    *     +---------------------------+---------------------------+
    *  18 |                                                       |
    *     =                       RCCSFQL                         =
    *     |                                                       |
    *     +-------------------------------------------------------+
    *  48 |                       RCCICFAB                        |
    *     +-------------------------------------------------------+
    *  50 |                       RCCLNINT                        |
    *     +---------------------------+---------------------------+
    *  58 |         RCCNOINT          |         RCCMAXAV          |
    *     +---------------------------+------+--------------------+
    *  60 |         RCCMINSV          |:STFLG|////////////////////|
    *     +---------------------------+------+--------------------+
    *  68 |                       RCCMPDLY                        |
    *     +-------------------------------------------------------+
    *  70 |///////////////////////////////////////////////////////|
    *     +------+--------------------+---------------------------+
    *  78 |:MPDAC|////////////////////|         RCCMPCQ0          |
    *     +------+--------------------+---------------------------+
    *  80 |         RCCMPCQ1          |         RCCMPSQ0          |
    *     +---------------------------+---------------------------+
    *  88 |         RCCMPSQ1          |                           |
    *     +---------------------------+                           |
    *  90 |                                                       |
    *     =                       RCCCPUAA                        =
    *     |                           +---------------------------+
    *     |                           | 10C
    *     +---------------------------+
    *
    *** RCCBK - RCPU DATA AREA MAPPING

#### RCCBK Cross Reference

    Symbol         Dspl Value
    -------------- ---- -----
    RCCCPUAA       008C
    RCCICFAB       0048
    RCCLNINT       0050
    RCCMAXAV       005C
    RCCMINSV       0060
    RCCMPCQ0       007C
    RCCMPCQ1       0080
    RCCMPDAC       0078
    RCCMPDLY       0068
    RCCMPSQ0       0084
    RCCMPSQ1       0088
    RCCMXAVS       0058 08
    RCCNOINT       0058
    RCCRCNUM       0010
    RCCSAVL        0064 80
    RCCSFQ         000C
    RCCSFQL        0018
    RCCSRCQ        0008
    RCCSTFLG       0064
    RCCSVNUM       0014
    RCCURCQ        0000

This information is based on z/VM V6R1.0. Last updated on 18 Feb 2010 at 08:59:30 EDT.
Copyright IBM Corporation, 1990, 2008