| |
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)
| |