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