NAME       : HCPDSCBK
 DESCRIPTION: Demand Scan Control Block
 DSECT      : DSCBK
 FUNCTION   :
              The Demand Scan Control Block (DSCBK) contains
              information about the Available List Demand Scan
              operation.  The DSCBK is persistent and some
              information is saved between Demand Scans.
 CREATED BY : Assembly at Entry Point HCPRSMSC.
 DELETED BY : none
 RELOCATION CONSIDERATIONS : None

 DSCBK DSECT
Top of page

Hex   Dec Type/Val   Lng Label (dup)    Comments
---- ---- --------- ---- -------------- --------
0000    0 Structure      DSCBK          Demand Scan Control Block
0000    0 Signed       4 *              Reserved for IBM use
0004    4 Signed       4 DSCINPUT (0)   Demand Scan Input Word DSCINPUT
                                        is a word of "input status" hints
                                        for other parts of the system to
                                        communicate information "hints"
                                        to demand scan. NOTES : DSCINPUT
                                        fields are NOT serialized, by the
                                        demand scan lock or anything
                                        else.
0004    4 Bitstring    1 *              Reserved
      The following bytes are used to make sure that only
      one CPEBK is stacked for a deferred call to various places.
0005    5 Bitstring    1 *              Reserved
0006    6 Bitstring    1 DSCFMVLK       Indicate that the deferred call
                                        to HCPFMVDS has been stacked
0007    7 Bitstring    1 *              Reserved end of DSCINPUT
0008    8 Bitstring    1 *              reserved
0009    9 Bitstring    1 DSCALRDS       A deferred call to HCPALRDS is
                                        either stacked or running
000A   10 Bitstring    1 * (2)          reserved
000C   12 Bitstring    1 DSCppFLAG      Flag for HCPALRPP and his spawn.
          1... ....      dscSLHeld      X'80' dscSLHeld The RSAPPGSL
                                        stack lock was held on entry to
                                        HCPALRPP (indirect call) and must
                                        be released before exiting.
      The next two bytes are strictly for RAS tracking purposes.
000D   13 Bitstring    1 dscTrack1      Tracking flag 1
000E   14 Bitstring    1 dscTrack2      Tracking flag 2
000F   15 Bitstring    1 *              reserved
0010   16 Signed       4 *              Reserved
0014   20 Signed       4 *              Reserved
      These fields apply to the current Demand Scan.
0018   24 Signed       4 * (2)          Reserved Output from subroutine
                                        CALCMORE in HCPALU. Updated by
                                        CALCMORE. Not changed until the
                                        next call to CALCMORE. These are
                                        "type-any" needs and represent a
                                        current need. (I.E. Deficit
                                        numbers are not factored in.)
0020   32 Dbl-Word     8 DSCREQSingles  Singles Frames needed.
0028   40 Dbl-Word     8 DSCREQContigs  Contigs Frames needed.
      Input area for DPPL Processing.  Note, these fields are
      rather unserialized.  It may be possible for demand scan to
      run several times before a stacked call to DPPL processing.
      Thus, these fields are maintained as a maximum.  Cleared
      when DPPL processing has referenced them.
0030   48 Signed       8 DSCDPPLSingles Singles Frames needed.
0038   56 Signed       8 DSCDPPLContigs Contigs Frames needed.
0040   64 Signed       8 DSCDPPLTarget  Adjusted target for processing.
0048   72 Signed       8 * (5)          Reserved for IBM use
0070  112 Signed       4 *              Reserved for IBM use
      These fields are primarily for diagnostic purposes.
      They should not affect the operation of Demand Scan.
0074  116 Bitstring    1 DSCDEBUG       Debug Flags
          1... ....      DSCACTIV       X'80' DSCACTIV Demand Scan is
                                        ACTIVE
0075  117 Bitstring    3 *              reserved
0078  120 Signed       8 DSCCOUNT       Count the number of times we
                                        entered Demand Scan (HCPALDSC)
0080  128 Signed       4 *              Reserved
0084  132 Address      4 DSCWHOEX       Previous HCPCALL before CALCMORE
0088  136 Signed       8 DSCppProcInt   Process intensity field. Used to
                                        know if this is the subsequent
                                        processing of the DPPL after a
                                        demand scan. Compared to
                                        DSCCount, but is not itself a
                                        count.
0090  144 Signed       8 * (4)          Reserved for IBM use
00B0  176 Signed       4 *              Reserved for IBM use
00B4  180 Signed       4 DSCALSKF       Times an Aging List page was not
                                        taken (i.e. was skipped) because
                                        we couldn't get frame ser.
00B8  184 Signed       4 DSCALSKP       Times an Aging List page was not
                                        taken (i.e. was skipped) because
                                        we couldn't get PTE serializ.
00BC  188 Signed       4 *              Reserved
00C0  192 Signed       4 *              Reserved
00C4  196 Signed       4 *              Reserved
      Communication from the frame manager to subroutine CALCMORE.
00C8  200 Dbl-Word     8 DSCRSingles    (Rate) Need for type any singles.
00D0  208 Dbl-Word     8 DSCRContigs    (Rate) Need for type any contigs.
      CALCMORE data area.
      These values represent harvested rate based information.
      Not technically output, but only used for Demand scan calls.
00D8  216 Dbl-Word     8 DSCHSingles    (Rate) Harvested need for
                                        singles.
00E0  224 Dbl-Word     8 DSCHContigs    (Rate) Harvested need for
                                        contigs.
      These values are the rate based need to use for the current
      call to CALCMORE.  (Either DSCHSingles at the beginning of
      a new Demand scan.   Or a Delta at the end of a Demand scan.)
      Not technically output, but only used for Demand scan calls.
00E8  232 Dbl-Word     8 DSCNSingles    Rate based need for singles.
00F0  240 Dbl-Word     8 DSCNContigs    Rate based need for contigs.
      "Who invoked demand scan" data:
00F8  248 Signed       4 DSCwhoFg (0)
00F8  248 Bitstring    1 DSCwhoRq       Who invoked demand scan (debug
                                        only build) - all requestors
00F9  249 Bitstring    1 DSCwhoFl       Who invoked demand scan (debug
                                        only build) - who actually
                                        flagpoled
      Equates for DSCwhoRq and DSCwhoFl
          1... ....      DSCwhoDSEW     X'80' 1 ALG DSEarlyWrite
          .1.. ....      DSCwhoDSRS     X'40' 2 ALDSC DSRestart
          ..1. ....      DSCwhoTHRS     X'20' 3 ALUDS Threshold
          ...1 ....      DSCwhoAGRV     X'10' 4 PFR AgingRevals
          .... 1...      DSCwhoFRDF     X'08' 5 PTF FrameReqDefer
          .... .1..      DSCwhoLGR      X'04' 6 RLT LGR EQU X'02' 7
                                        Unused.
          .... ...1      DSCwhoAgIn     X'01' 8 ALUDS AgeSizeInc
00FA  250 Bitstring    1 * (2)          Reserved for DSCwhoFg expansion,
                                        must remain 0s
      Array of counts of times each task attempted to flag Demand
      scan to start:
00FC  252 Signed       4 DSCwhoCtArray (8)
                                        (debug only build)
00FC  252 Signed       4 DSCwhoCtDSEW   1 ALG DSEarlyWrite
0100  256 Signed       4 DSCwhoCtDSRS   2 ALDSC DSRestart
0104  260 Signed       4 DSCwhoCtTHRS   3 ALUDS DSThreshold
0108  264 Signed       4 DSCwhoCtAGRV   4 PFR AgingRevals
010C  268 Signed       4 DSCwhoCtFRDF   5 PTF FrameReqDefer
0110  272 Signed       4 DSCwhoCtLGR    6 RLT LGR
0114  276 Signed       4 *              7 Unused.
0118  280 Signed       4 DSCwhoCTAgIn   8 ALUDS AgeSizeInc
0120  288 Signed       8 * (8)          Reserved for IBM use.
      DPPL Processing area.
      This area is cleared at the start of DPPL Processing.  If
      DSCppEnd is filled in, then DPPL processing has ended.
0160  352 Dbl-Word     8 DSCppClear (0) Start of the area cleared.
      These fields have equivalent fields in the RSMBK.
      They represent the last time the DPPL was
      processed, over all the tasks (including runtime in
      HCPALRPX) and will be/were rolled into the RSMBK
      counts when the final spawned task completed.
0160  352 Signed       8 DSCppRtm       Processing time. Includes: -
                                        scanning the rDPPL/initiating I/O
                                        - scanning the PPAL - scanning
                                        any vDPPL/initiating I/O This is
                                        the run time of all tasks
                                        spawned. It does not include time
                                        spent waiting to be unstacked.
                                        The start and end times of each
                                        task is maintained in the task's
                                        SVGBK and the delta is rolled in
                                        as each task completes.
0168  360 Signed       8 DSCpdRVis      Count of PGMBKs visited on the
                                        rDPPL by HCPHRUPD processing.
0170  368 Signed       8 DSCvxVVis      Count of PGMBKs visited on the
                                        vDPPL by HCPHRUPX processing.
0178  376 Signed       8 DSCpdRRmv      MICount of PGMBKs removed from
                                        the rDPPL by HCPHRUPD processing
                                        destined for auxillary storage.
0180  384 Signed       8 DSCvxTime      Cummulative amount of time spent
                                        processing the vDPPLs.
0188  392 Signed       8 DSCvRmv        MICount of PGMBKs removed from
                                        the vDPPL by vDPPL processing
                                        destined for auxillary storage.
0190  400 Signed       8 DSCNoPTILx     Count of times rDPPL processing
                                        did not get PTILx (for any case).
0198  408 Signed       8 DSCNoPTILxO    Count of times DPPL processing
                                        did not get PTILx specifically
                                        for an outbound relocating guest.
                                        (LGR). (Left on rDPPL).
01A0  416 Signed       8 DSCRelo        Count of times rDPPL processing
                                        did not get PTILx and relocated
                                        the FRMTE from the rDPPL to a
                                        vDPPL.
01A8  424 Signed       8 *              Reserved for IBM use
01B0  432 Signed       8 DSCrLoaded     Count of PGMBKs found on the
                                        rDPPL that had resident frames.
                                        (Floated).
01B8  440 Signed       8 DSCvLoaded     Count of PGMBKs found on the
                                        vDPPL that had resident frames.
                                        (Floated).
01C0  448 Signed       8 DSCrLocked     Count of PGMBKs found on the
                                        rDPPL that were locked. (Left on
                                        rDPPL)
01C8  456 Signed       8 DSCvLocked     Count of PGMBKs found on the
                                        vDPPL that were locked. (Left on
                                        rDPPL)
01D0  464 Signed       8 DSCrIURL       Count of PGMBKs found on the
                                        rDPPL that were in use for
                                        relocation. (Left on rDPPL)
01D8  472 Signed       8 DSCvIURL       Count of PGMBKs found on the
                                        vDPPL that were in use for
                                        relocation. (Left on rDPPL)
01E0  480 Signed       8 DSCrNonP       Count of PGMBKs found on the
                                        rDPPL that were not pageable.
                                        (Floated).
01E8  488 Signed       8 DSCvNonP       Count of PGMBKs found on the
                                        vDPPL that were not pageable.
                                        (Floated).
01F0  496 Signed       8 DSCrLogoff     Count of PGMBKs found on the
                                        rDPPL for a guest that was
                                        logging off. (Floated).
01F8  504 Signed       8 DSCvLogoff     Count of PGMBKs found on the
                                        vDPPL for a guest that was
                                        logging off. (Floated).
0200  512 Signed       8 DSCrTrans      Count of PGMBKs found on the
                                        rDPPL that were being translated.
                                        (Left on rDPPL)
0208  520 Signed       8 DSCvTrans      Count of PGMBKs found on the
                                        vDPPL that were being translated.
                                        (Left on rDPPL)
0210  528 Signed       8 DSCrNoGetOwn   Count of PGMBKs found on the
                                        rDPPL that HCPHRU could not get
                                        ownership of.
0218  536 Signed       8 DSCvNoGetOwn   Count of PGMBKs found on the
                                        vDPPL that HCPHRU could not get
                                        ownership of.
      These fields don't have equivalent fields in the RSMBK and
      represent only the last time we processed.
0220  544 Signed       8 DSCppStart     Last TOD when we entered HCPALRPP
                                        and processed the DPPL and PPAL.
0228  552 Signed       8 DSCppEnd       Last TOD when the final task
                                        completed. Note, comparing
                                        DSCppStart to DSCppEnd will
                                        include idle time spent waiting
                                        for spawned tasks to be
                                        dispatched.
0230  560 Dbl-Word     8 DSCpdStart     TOD when the rDPPL was run by
                                        HCPHRUPD.
0238  568 Dbl-Word     8 DSCpdEnd       TOD when the DPPL loop was
                                        completed by HCPHRUPD.
0240  576 Dbl-Word     8 DSCpdReceive   Number moved from receive queue
                                        to work queue before processing.
0248  584 Signed       8 dscPPGPLCounti A RAS only count of increments
                                        and
0250  592 Signed       8 dscPPGPLCounto decrements to rsaPPGPLCount.
0258  600 Signed       8 dscAllStart    TOD when HCPALL was called to
                                        begin processing vDPPLs.
0260  608 Signed       8 dscAllEnd      TOD when HCPALL returned.
0268  616 Signed       8 * (8)          Reserved for IBM use. (Cleared!)
02A8  680 Dbl-Word     8 DSCppEndCl (0) End of the area cleared.
          CppEndCl       DSCppCLlenB    DSCppEndCl-DSCppClear DSCppCLlenB
                                        Length of area that gets cleared
                                        when HCPALRPP starts its
                                        processing.
02A8  680 Bitstring    1 DSC$END (0)    End of DSCBK
          000002A8       DSCBKLN        *-DSCBK DSCBK length (in bytes)
          00000055       DSCBKSZ        (*-DSCBK+7)/8 DSCBK size (in
                                        doublewords)

          
*** DSCBK - Demand Scan Control Block
*
*     +---------------------------+------+------+------+------+
*   0 |///////////////////////////|//////|//////|:FMVLK|//////|
*     +------+------+-------------+------+------+------+------+
*   8 |//////|:ALRDS|/////////////|(00C) |(00D) |(00E) |//////|
*     +------+------+-------------+------+------+------+------+
*  10 |///////////////////////////|///////////////////////////|
*     +---------------------------+---------------------------+
*  18 |///////////////////////////////////////////////////////|
*     +-------------------------------------------------------+
*  20 |                    DSCREQSINGLES                      |
*     +-------------------------------------------------------+
*  28 |                    DSCREQCONTIGS                      |
*     +-------------------------------------------------------+
*  30 |                    DSCDPPLSINGLES                     |
*     +-------------------------------------------------------+
*  38 |                    DSCDPPLCONTIGS                     |
*     +-------------------------------------------------------+
*  40 |                    DSCDPPLTARGET                      |
*     +-------------------------------------------------------+
*  48 |///////////////////////////////////////////////////////|
*     =///////////////////////////////////////////////////////=
*     |///////////////////////////////////////////////////////|
*     +---------------------------+------+--------------------+
*  70 |///////////////////////////|:DEBUG|////////////////////|
*     +---------------------------+------+--------------------+
*  78 |                       DSCCOUNT                        |
*     +---------------------------+---------------------------+
*  80 |///////////////////////////|         DSCWHOEX          |
*     +---------------------------+---------------------------+
*  88 |                     DSCPPPROCINT                      |
*     +-------------------------------------------------------+
*  90 |///////////////////////////////////////////////////////|
*     =///////////////////////////////////////////////////////=
*     |///////////////////////////////////////////////////////|
*     +---------------------------+---------------------------+
*  B0 |///////////////////////////|         DSCALSKF          |
*     +---------------------------+---------------------------+
*  B8 |         DSCALSKP          |///////////////////////////|
*     +---------------------------+---------------------------+
*  C0 |///////////////////////////|///////////////////////////|
*     +---------------------------+---------------------------+
*  C8 |                     DSCRSINGLES                       |
*     +-------------------------------------------------------+
*  D0 |                     DSCRCONTIGS                       |
*     +-------------------------------------------------------+
*  D8 |                     DSCHSINGLES                       |
*     +-------------------------------------------------------+
*  E0 |                     DSCHCONTIGS                       |
*     +-------------------------------------------------------+
*  E8 |                     DSCNSINGLES                       |
*     +-------------------------------------------------------+
*  F0 |                     DSCNCONTIGS                       |
*     +------+------+-------------+---------------------------+
*  F8 |:WHORQ|:WHOFL|/////////////|                           |
*     +------+------+-------------+                           |
* 100 |                                                       |
*     =                    DSCWHOCTARRAY                      =
*     |                           +---------------------------+
*     |                           | 11C
*     +---------------------------+
*
*** DSCBK - Demand Scan Control Block
          
*** Overlay for DSCwhoCtArray in DSCBK
*
*                                 +---------------------------+
*  F8 ...                      FC |       DSCWHOCTDSEW        |
*     +---------------------------+---------------------------+
* 100 |       DSCWHOCTDSRS        |       DSCWHOCTTHRS        |
*     +---------------------------+---------------------------+
* 108 |       DSCWHOCTAGRV        |       DSCWHOCTFRDF        |
*     +---------------------------+---------------------------+
* 110 |       DSCWHOCTLGR         |///////////////////////////|
*     +---------------------------+---------------------------+
* 118 |       DSCWHOCTAGIN        |///////////////////////////|
*     +---------------------------+---------------------------+
* 120 |///////////////////////////////////////////////////////|
*     =///////////////////////////////////////////////////////=
*     |///////////////////////////////////////////////////////|
*     +-------------------------------------------------------+
* 160 |                       DSCPPRTM                        |
*     +-------------------------------------------------------+
* 168 |                      DSCPDRVIS                        |
*     +-------------------------------------------------------+
* 170 |                      DSCVXVVIS                        |
*     +-------------------------------------------------------+
* 178 |                      DSCPDRRMV                        |
*     +-------------------------------------------------------+
* 180 |                      DSCVXTIME                        |
*     +-------------------------------------------------------+
* 188 |                       DSCVRMV                         |
*     +-------------------------------------------------------+
* 190 |                      DSCNOPTILX                       |
*     +-------------------------------------------------------+
* 198 |                     DSCNOPTILXO                       |
*     +-------------------------------------------------------+
* 1A0 |                       DSCRELO                         |
*     +-------------------------------------------------------+
* 1A8 |///////////////////////////////////////////////////////|
*     +-------------------------------------------------------+
* 1B0 |                      DSCRLOADED                       |
*     +-------------------------------------------------------+
* 1B8 |                      DSCVLOADED                       |
*     +-------------------------------------------------------+
* 1C0 |                      DSCRLOCKED                       |
*     +-------------------------------------------------------+
* 1C8 |                      DSCVLOCKED                       |
*     +-------------------------------------------------------+
* 1D0 |                       DSCRIURL                        |
*     +-------------------------------------------------------+
* 1D8 |                       DSCVIURL                        |
*     +-------------------------------------------------------+
* 1E0 |                       DSCRNONP                        |
*     +-------------------------------------------------------+
* 1E8 |                       DSCVNONP                        |
*     +-------------------------------------------------------+
* 1F0 |                      DSCRLOGOFF                       |
*     +-------------------------------------------------------+
* 1F8 |                      DSCVLOGOFF                       |
*     +-------------------------------------------------------+
* 200 |                      DSCRTRANS                        |
*     +-------------------------------------------------------+
* 208 |                      DSCVTRANS                        |
*     +-------------------------------------------------------+
* 210 |                     DSCRNOGETOWN                      |
*     +-------------------------------------------------------+
* 218 |                     DSCVNOGETOWN                      |
*     +-------------------------------------------------------+
* 220 |                      DSCPPSTART                       |
*     +-------------------------------------------------------+
* 228 |                       DSCPPEND                        |
*     +-------------------------------------------------------+
* 230 |                      DSCPDSTART                       |
*     +-------------------------------------------------------+
* 238 |                       DSCPDEND                        |
*     +-------------------------------------------------------+
* 240 |                     DSCPDRECEIVE                      |
*     +-------------------------------------------------------+
* 248 |                    DSCPPGPLCOUNTI                     |
*     +-------------------------------------------------------+
* 250 |                    DSCPPGPLCOUNTO                     |
*     +-------------------------------------------------------+
* 258 |                     DSCALLSTART                       |
*     +-------------------------------------------------------+
* 260 |                      DSCALLEND                        |
*     +-------------------------------------------------------+
* 268 |///////////////////////////////////////////////////////|
*     =///////////////////////////////////////////////////////=
*     |///////////////////////////////////////////////////////|
*     +-------------------------------------------------------+
*
*** Overlay for DSCwhoCtArray in DSCBK

 
Symbol         Dspl Value
-------------- ---- -----
dscAllEnd      0260
dscAllStart    0258
dscPPGPLCounti
               0248
dscPPGPLCounto
               0250
dscSLHeld      000C 80
dscTrack1      000D
dscTrack2      000E
DSC$END        02A8
DSCpdEnd       0238
DSCpdReceive   0240
DSCpdRRmv      0178
DSCpdRVis      0168
DSCpdStart     0230
DSCppClear     0160
DSCppCLlenB    02A8 CppEndCl
DSCppEnd       0228
DSCppEndCl     02A8
DSCppFLAG      000C
DSCppProcInt   0088
DSCppRtm       0160
DSCppStart     0220
DSCrIURL       01D0
DSCrLoaded     01B0
DSCrLocked     01C0
DSCrLogoff     01F0
DSCrNonP       01E0
DSCrNoGetOwn   0210
DSCrTrans      0200
DSCvxTime      0180
DSCvxVVis      0170
DSCvIURL       01D8
DSCvLoaded     01B8
DSCvLocked     01C8
DSCvLogoff     01F8
DSCvNonP       01E8
DSCvNoGetOwn   0218
DSCvRmv        0188
DSCvTrans      0208
DSCwhoAgIn     00F9 01
DSCwhoAGRV     00F9 10
DSCwhoCtArray  00FC
DSCwhoCtAGRV   0108
DSCwhoCtDSEW   00FC
DSCwhoCtDSRS   0100
DSCwhoCtFRDF   010C
DSCwhoCtLGR    0110
DSCwhoCtTHRS   0104
DSCwhoCTAgIn   0118
DSCwhoDSEW     00F9 80
DSCwhoDSRS     00F9 40
DSCwhoFg       00F8
DSCwhoFl       00F9
DSCwhoFRDF     00F9 08
DSCwhoLGR      00F9 04
DSCwhoRq       00F8
DSCwhoTHRS     00F9 20
DSCACTIV       0074 80
DSCALRDS       0009
DSCALSKF       00B4
DSCALSKP       00B8
DSCBKLN        02A8 000002A8
DSCBKSZ        02A8 00000055
DSCCOUNT       0078
DSCDEBUG       0074
DSCDPPLContigs
               0038
DSCDPPLSingles
               0030
DSCDPPLTarget  0040
DSCFMVLK       0006
DSCHContigs    00E0
DSCHSingles    00D8
DSCINPUT       0004
DSCNoPTILx     0190
DSCNoPTILxO    0198
DSCNContigs    00F0
DSCNSingles    00E8
DSCRelo        01A0
DSCRContigs    00D0
DSCREQContigs  0028
DSCREQSingles  0020
DSCRSingles    00C8
DSCWHOEX       0084