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

#### SSDBK

Prolog

Control Block Contents
SSDBK DSECT

Storage Layout

Cross Reference (Contains links to field and bit definitions)

#### SSDBK Prolog

     NAME       : HCPSSDBK
     DESCRIPTION: SYSTEM SMOOTHED DATA BLOCK
     DSECT      : SSDBK
     FUNCTION   : MAPS PERMANENT FREE STORAGE WHICH CONTAINS
                  THE DATA HISTORY NEEDED FOR SMOOTHING OVER
                  TIME.
     LOCATED BY : SRMSTPTB FIELD IN THE SRMBK
     CREATED BY : HCPISR AT SYSTEM INITIALIZATION.
     DELETED BY : NOT DELETED.  PERMANENT FREE STORAGE.
     Comments   : - This control block is acquired by HCPISR at
                  system initialization for the exclusive use
                  of HCPSTP.  Since HCPSTP is a single-threaded
                  system task, there are no serialization
                  requirements for the data.
                  - There are 6 areas of the SSDBK.  The last is defined
                  by the ORG on SSDREST.  The first 5 are all the same
                  size and are 1st defined by the ORG on SSDTABLE.
                  The corresponding areas are defined as follows.  If
                  R1 points to an entry in the first area then:
                  0*SSDTBL(,R1) - Value from CP data accumulator
                  1*SSDTBL(,R1) - Contains new sample average
                  smoothed over DRATE.
                  2*SSDTBL(,R1) - Current delta value (observed) in
                  the CP data accumulator this time.
                  3*SSDTBL(,R1) - Previous delta value (observed)
                  in the CP data accumulator last
                  time.  (ONLY CALCULATED FOR
                  SUBROUTINE SDATF.  THIS VALUE IS
                  CALCULATED FOR DEBUGGING ONLY)
                  4*SSDTBL(,R1) - Contains new sample average
                  smoothed over HRATE.
                  - The following equats may be used to address the data.
                  -  No offset is needed to access the
                  value from the CP accumulator.
                  - DRATEAVE = 1*SSDTBL
                  - CDELTA   = 2*SSDTBL
                  - PDELTA   = 3*SSDTBL
                  - HRATEAVE = 4*SSDTBL

#### SSDBK Control Block Content

#### SSDBK DSECT

    Hex   Dec Type/Val   Lng Label (dup)    Comments
    ---- ---- --------- ---- -------------- --------
    0000    0 Structure      SSDBK          SYSTEM SMOOTHED DATA BLOCK
    0000    0 Bitstring 2200 SSDTABLE       Total size of 5 copies of SSDTB
    0898 2200 Bitstring   40 SSDREST        SIZE OF DATA AREA AFTER TABLES
              00000118       SSDSIZE        (*-SSDBK+7)/8 DOUBLEWORD SIZE OF
                                            SSDBK
    0000    0 Dbl-Word     8 SSDTB          TABLE START; X'FF'S EYECATCHER
    0008    8 Dbl-Word     8 SSDELP         ELAPSED TIME
    0010   16 Signed       4 SSDSTL         STEAL PAGES INCREMENT
    0014   20 Signed       4 SSDTRM         DENOMINATOR TERM FOR STEAL CALC.
    0018   24 Dbl-Word     8 SSDTRD         TIME A USER TAKES TO READ A PAGE
    0020   32 Signed       4 SSDWSS         PROJECTED WSS
    0024   36 Signed       4 SSDPGIO        DASD PAGE I/O OPERATIONS
    0028   40 Signed       4 SSDC1CUM       ACCUMULATED CLASS 1 USERS
    002C   44 Signed       4 SSDC1WSS       ACCUMULATED CLASS 1 WSS
    0030   48 Signed       4 SSDC1PGR       ACCUMULATED CLASS 1 PAGING RATE
    0034   52 Signed       4 SSDXSTUF       XSTORE info for average age
    0038   56 Signed       4 SSDAUWSS       AVERAGE USER'S WSS
    003C   60 Signed       4 SSDAUPGR       AVERAGE USER'S PAGING RATE
    0040   64 Signed       4 SSDSRWP        SYSTEM RESOURCE WEIGHT FOR PAGING
    0044   68 Signed       4 SSDSRWS        SYSTEM RESOURCE WEIGHT " STORAGE
    0048   72 Signed       4 SSDSTEAL       SYSTEM WIDE STEAL VALUE
    004C   76 Signed       4 SSDEXPF1       CLASS 1 EXPANSION FACTOR ACCUM
    0050   80 Signed       4 SSDEXPF2       CLASS 2 EXPANSION FACTOR ACCUM
    0054   84 Signed       4 SSDEXPF3       CLASS 3 EXPANSION FACTOR ACCUM
    0058   88 Signed       4 SSDXSTR        XSTORE PAGE RATE (PGIN + PGOUT)
    005C   92 Signed       4 SSDXMIG        XSTORE MIGRATE RATE
    0060   96 Signed       4 SSDMDCPR       MiniDisk Cache: XSTORE Reads
    0064  100 Signed       4 SSDMDCPW       MiniDisk Cache: XSTORE Writes
    0068  104 Signed       4 SSDXMI2        XSTORE migrates for MDC adjusted
                                            every other STP intervl
    006C  108 Signed       4 SSDMDCIA       MiniDisk Cache: I/Os avoided
    0070  112 Signed       4 SSDMDCNA       MiniDisk Cache: I/Os not avoided
    0074  116 Signed       4 SSDSTL2        Paging steal rates for MDC
                                            adjusted every other STP intervl
    0078  120 Signed       4 SSDDORM        COUNT OF DORMANT LIST USERS.
    007C  124 Signed       4 SSDTCDEL       Count of pages stolen from full
                                            track cache
    0080  128 Signed       4 SSDTCXDL       Count of XSTORE blocks deleted
                                            from full track cache
    0084  132 Signed       4 SSDPGDBS (20)  Array of blk sizes built by steal
                                            (HCPPGDBS)
              00000014       SSDBSSZ        (*-SSDPGDBS)/4 Size of SSDPGDBS
                                            array.
    00D4  212 Signed       4 SSDPGDBM (20)  Array of blk sizes built by
                                            migrate (HCPPGDBM)
              00000014       SSDBMSZ        (*-SSDPGDBM)/4 Size of SSDPGDBM
                                            array.
    0124  292 Signed       4 SSDPGDBR (20)  Array of blk sizes read
                                            (HCPPGDBR)
              00000014       SSDBRSZ        (*-SSDPGDBR)/4 Size of SSDPGDBR
                                            array.
          THE FOLLOWING TABLE HOLDS SMOOTHED LIST ACCUMULATORS FOR
          THE NUMBER OF USERS AND LOADING USERS IN THE DISPATCH
          AND ELIGIBLE LISTS.
          THE ORDER HERE IS CRITICAL AND SHOULD NOT BE CHANGED
          WITHOUT THOROUGH EXAMINATION OF HOW THEY ARE USED IN
          HCPSTPGS'S CODE (ORDER MATCHES WITH SRMUSERC IN SRMBK).
              00000174       SSDUSERC       * START OF THE USER COUNTERS
    0174  372 Signed       4 SSDDL          TOTAL DLIST USER COUNT
    0178  376 Signed       4 SSDD0          CLASS 0 DLIST USER COUNT
    017C  380 Signed       4 SSDD1          CLASS 1 DLIST USER COUNT
    0180  384 Signed       4 SSDD2          CLASS 2 DLIST USER COUNT
    0184  388 Signed       4 SSDD3          CLASS 3 DLIST USER COUNT
    0188  392 Signed       4 SSDLD0         CLASS 0 LOADING DLIST USER COUNT
    018C  396 Signed       4 SSDLD1         CLASS 1 LOADING DLIST USER COUNT
    0190  400 Signed       4 SSDLD2         CLASS 2 LOADING DLIST USER COUNT
    0194  404 Signed       4 SSDLD3         CLASS 3 LOADING DLIST USER COUNT
    0198  408 Signed       4 SSDE0          CLASS 0 ELIST USER COUNT
    019C  412 Signed       4 SSDE1          CLASS 1 ELIST USER COUNT
    01A0  416 Signed       4 SSDE2          CLASS 2 ELIST USER COUNT
    01A4  420 Signed       4 SSDE3          CLASS 3 ELIST USER COUNT
    01A8  424 Signed       4 SSDLE0         CLASS 0 LOADING ELIST USER COUNT
    01AC  428 Signed       4 SSDLE1         CLASS 1 LOADING ELIST USER COUNT
    01B0  432 Signed       4 SSDLE2         CLASS 2 LOADING ELIST USER COUNT
    01B4  436 Signed       4 SSDLE3         CLASS 3 LOADING ELIST USER COUNT
              00000044       SSDUSERL       *-SSDUSERC LENGTH OF THE USER
                                            TABLE
              000001B8       SSDTBL         *-SSDTB TABLE LENGTH IN BYTES
                                            NOTES : The following macro
                                            invocation causes an assemble
                                            NOTES : error (ARITHMETIC
                                            OVERFLOW) if the coded table size
                                            is NOTES : insufficient.
    0898 2200 Bitstring   34 SSDUSERB       STARTING ADDRESS OF A BUFFER
                                            CONTAINING CORRESPONDING HALFWORD
                                            FIELDS TO SSDUSERC'S FULLWORD
                                            FIELDS. IT IS USED TO HOLD THE
                                            DISPATCH AND ELIGIBLE LIST COUNTS
                                            TO BE SMOOTHED.
              000008BA       SSDUSRBE       * ENDING ADDRESS OF SSDUSERB
              000001B8       DRATEAVG       1*SSDTBL
              00000370       CDELTA         2*SSDTBL
              00000528       PDELTA         3*SSDTBL
              000006E0       HRATEAVG       4*SSDTBL

#### SSDBK Storage Layout

    *** SSDBK - SYSTEM SMOOTHED DATA BLOCK
    *
    *     +-------------------------------------------------------+
    *   0 |                                                       |
    *     =                       SSDTABLE                        =
    *     |                                                       |
    *     +-------------------------------------------------------+
    * 898 |                                                       |
    *     =                       SSDREST                         =
    *     |                                                       |
    *     +-------------------------------------------------------+
    * 8C0
    *
    *** SSDBK - SYSTEM SMOOTHED DATA BLOCK

    *** Overlay for SSDTABLE in SSDBK
    *
    *     +-------------------------------------------------------+
    *   0 |                        SSDTB                          |
    *     +-------------------------------------------------------+
    *   8 |                        SSDELP                         |
    *     +---------------------------+---------------------------+
    *  10 |          SSDSTL           |          SSDTRM           |
    *     +---------------------------+---------------------------+
    *  18 |                        SSDTRD                         |
    *     +---------------------------+---------------------------+
    *  20 |          SSDWSS           |         SSDPGIO           |
    *     +---------------------------+---------------------------+
    *  28 |         SSDC1CUM          |         SSDC1WSS          |
    *     +---------------------------+---------------------------+
    *  30 |         SSDC1PGR          |         SSDXSTUF          |
    *     +---------------------------+---------------------------+
    *  38 |         SSDAUWSS          |         SSDAUPGR          |
    *     +---------------------------+---------------------------+
    *  40 |         SSDSRWP           |         SSDSRWS           |
    *     +---------------------------+---------------------------+
    *  48 |         SSDSTEAL          |         SSDEXPF1          |
    *     +---------------------------+---------------------------+
    *  50 |         SSDEXPF2          |         SSDEXPF3          |
    *     +---------------------------+---------------------------+
    *  58 |         SSDXSTR           |         SSDXMIG           |
    *     +---------------------------+---------------------------+
    *  60 |         SSDMDCPR          |         SSDMDCPW          |
    *     +---------------------------+---------------------------+
    *  68 |         SSDXMI2           |         SSDMDCIA          |
    *     +---------------------------+---------------------------+
    *  70 |         SSDMDCNA          |         SSDSTL2           |
    *     +---------------------------+---------------------------+
    *  78 |         SSDDORM           |         SSDTCDEL          |
    *     +---------------------------+---------------------------+
    *  80 |         SSDTCXDL          |                           |
    *     +---------------------------+                           |
    *  88 |                                                       |
    *     =                       SSDPGDBS                        =
    *     |                           +---------------------------+
    *     |                           |                           |
    *     +---------------------------+                           |
    *  D8 |                                                       |
    *     =                       SSDPGDBM                        =
    *     |                           +---------------------------+
    *     |                           |                           |
    *     +---------------------------+                           |
    * 128 |                                                       |
    *     =                       SSDPGDBR                        =
    *     |                           +---------------------------+
    * 170 |                           |          SSDDL            |
    *     +---------------------------+---------------------------+
    * 178 |          SSDD0            |          SSDD1            |
    *     +---------------------------+---------------------------+
    * 180 |          SSDD2            |          SSDD3            |
    *     +---------------------------+---------------------------+
    * 188 |          SSDLD0           |          SSDLD1           |
    *     +---------------------------+---------------------------+
    * 190 |          SSDLD2           |          SSDLD3           |
    *     +---------------------------+---------------------------+
    * 198 |          SSDE0            |          SSDE1            |
    *     +---------------------------+---------------------------+
    * 1A0 |          SSDE2            |          SSDE3            |
    *     +---------------------------+---------------------------+
    * 1A8 |          SSDLE0           |          SSDLE1           |
    *     +---------------------------+---------------------------+
    * 1B0 |          SSDLE2           |          SSDLE3           |
    *     +---------------------------+---------------------------+
    * 1B8
    *
    *** Overlay for SSDTABLE in SSDBK

    *** Overlay for SSDREST in SSDBK
    *
    *     +-------------------------------------------------------+
    * 898 |                                                       |
    *     =                       SSDUSERB                        =
    *     |             +-----------------------------------------+
    *     |             | 8BA
    *     +-------------+
    *
    *** Overlay for SSDREST in SSDBK

#### SSDBK Cross Reference

    Symbol         Dspl Value
    -------------- ---- -----
    CDELTA         0898 00000370
    DRATEAVG       0898 000001B8
    HRATEAVG       0898 000006E0
    PDELTA         0898 00000528
    SSDAUPGR       003C
    SSDAUWSS       0038
    SSDBMSZ        00D4 00000014
    SSDBRSZ        0124 00000014
    SSDBSSZ        0084 00000014
    SSDC1CUM       0028
    SSDC1PGR       0030
    SSDC1WSS       002C
    SSDDL          0174
    SSDDORM        0078
    SSDD0          0178
    SSDD1          017C
    SSDD2          0180
    SSDD3          0184
    SSDELP         0008
    SSDEXPF1       004C
    SSDEXPF2       0050
    SSDEXPF3       0054
    SSDE0          0198
    SSDE1          019C
    SSDE2          01A0
    SSDE3          01A4
    SSDLD0         0188
    SSDLD1         018C
    SSDLD2         0190
    SSDLD3         0194
    SSDLE0         01A8
    SSDLE1         01AC
    SSDLE2         01B0
    SSDLE3         01B4
    SSDMDCIA       006C
    SSDMDCNA       0070
    SSDMDCPR       0060
    SSDMDCPW       0064
    SSDPGDBM       00D4
    SSDPGDBR       0124
    SSDPGDBS       0084
    SSDPGIO        0024
    SSDREST        0898
    SSDSIZE        0898 00000118
    SSDSRWP        0040
    SSDSRWS        0044
    SSDSTEAL       0048
    SSDSTL         0010
    SSDSTL2        0074
    SSDTABLE       0000
    SSDTB          0000
    SSDTBL         01B4 000001B8
    SSDTCDEL       007C
    SSDTCXDL       0080
    SSDTRD         0018
    SSDTRM         0014
    SSDUSERB       0898
    SSDUSERC       0124 00000174
    SSDUSERL       01B4 00000044
    SSDUSRBE       0898 000008BA
    SSDWSS         0020
    SSDXMIG        005C
    SSDXMI2        0068
    SSDXSTR        0058
    SSDXSTUF       0034

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