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