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 (3)    SAVE frame queue lock
    0030   48 Signed       8 RCCICFAB       Incomplete frame reclaim time
                                            limit
    0038   56 Signed       8 RCCLNINT       HCPSAMFS sampling period, 10 sec.
    0040   64 Signed       4 RCCNOINT       Number of intervals to average
              .... 1...      RCCMXAVS       8 Scaling factor for below
                                            &VX1NASG
    0044   68 Signed       4 RCCMAXAV       Maximum percentage of buffers
                                            available
    0048   72 Signed       4 RCCMINSV       Minimum number of saveareas per
                                            processor
    004C   76 Address      1 RCCSTFLG       Free storage availability flags
              1... ....      RCCSAVL        X'80' Free storage available for
                                            SAVBKs
    004D   77 Bitstring    1 * (3)          Reserved for future IBM use
                 MP Defer Data Area
                 Checkpoint determination intervals
    0050   80 Signed       8 RCCMPDLY       1/10 second, until adjusted by
                                            HCPISR to be a function of the
                                            minor timeslice.
    0058   88 Dbl-Word     8 *              Reserved for IBM use
    0060   96 Address      1 RCCMPDAC       MP Defer Active Test & Set flag
    0061   97 Bitstring    3 *              Reserved
                 "CP Loss of Control" deferred work queues
    0064  100 Address      4 RCCMPCQ0       Work for which 0 or more MP
                                            checkpoints have occurred
    0068  104 Address      4 RCCMPCQ1       Work for which 1 or more MP
                                            checkpoints have occurred
                 "Loss of Control" deferred work queues
    006C  108 Address      4 RCCMPSQ0       Work for which 0 or more MP
                                            checkpoints have occurred
    0070  112 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**5 (use 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'.
    0074  116 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                         =
    *     |                                                       |
    *     +-------------------------------------------------------+
    *  30 |                       RCCICFAB                        |
    *     +-------------------------------------------------------+
    *  38 |                       RCCLNINT                        |
    *     +---------------------------+---------------------------+
    *  40 |         RCCNOINT          |         RCCMAXAV          |
    *     +---------------------------+------+--------------------+
    *  48 |         RCCMINSV          |:STFLG|////////////////////|
    *     +---------------------------+------+--------------------+
    *  50 |                       RCCMPDLY                        |
    *     +-------------------------------------------------------+
    *  58 |///////////////////////////////////////////////////////|
    *     +------+--------------------+---------------------------+
    *  60 |:MPDAC|////////////////////|         RCCMPCQ0          |
    *     +------+--------------------+---------------------------+
    *  68 |         RCCMPCQ1          |         RCCMPSQ0          |
    *     +---------------------------+---------------------------+
    *  70 |         RCCMPSQ1          |                           |
    *     +---------------------------+                           |
    *  78 |                                                       |
    *     =                       RCCCPUAA                        =
    *     |                           +---------------------------+
    *     |                           | F4
    *     +---------------------------+
    *
    *** RCCBK - RCPU DATA AREA MAPPING

#### RCCBK Cross Reference

    Symbol         Dspl Value
    -------------- ---- -----
    RCCCPUAA       0074
    RCCICFAB       0030
    RCCLNINT       0038
    RCCMAXAV       0044
    RCCMINSV       0048
    RCCMPCQ0       0064
    RCCMPCQ1       0068
    RCCMPDAC       0060
    RCCMPDLY       0050
    RCCMPSQ0       006C
    RCCMPSQ1       0070
    RCCMXAVS       0040 08
    RCCNOINT       0040
    RCCRCNUM       0010
    RCCSAVL        004C 80
    RCCSFQ         000C
    RCCSFQL        0018
    RCCSRCQ        0008
    RCCSTFLG       004C
    RCCSVNUM       0014
    RCCURCQ        0000

This information is based on z/VM V5R2.0. Last updated on 12 Apr 2006 at 17:19:24 EDT.
Copyright IBM Corporation, 1990, 2005