| |
Hex Dec Type/Val Lng Label (dup) Comments
---- ---- --------- ---- -------------- --------
0000 0 Structure RSMBK RSM common area mapping
Now define the RSMBK.
0000 0 Signed 4 RSASAVFR Non-negative count of frames in
use by the save area manager.
Serialized by save page queue
lock (RCCSFQL)
System-real space information
0004 4 Address 4 RSARSAST Host Logical Address ASTE @ for
the system-real space, which
identity maps all of real storage
(including real storage above 2G)
via an RSD (meaning no DAT tables
are required)
0008 8 Signed 4 RSAMSARC Count of machine storage areas
(MSA) below the highest sysgen
frame (RSASTORE)
000C 12 Signed 4 RSAMSASC Count of machine storage areas
(MSA) below the highest sysgen
frame (RSASTORE) or addressable
frame (SYSTORS) whichever is
lower
0010 16 Signed 4 RSAMSARH Count of machine storage areas
(MSA) above the highest sysgen
frame (RSASTORE)
0014 20 Signed 4 RSADPACP Count of DPA frames containing CP
data (includes all frames which
have the FRMCP bit on in FRMCSB0
of their FRMTEs, except for VDISK
frames, which are CP owned, but
contain user data). This is the
count of frames that will be
included in a CP dump, and is
used to allocate additional space
for a CP dump as CP grows.
Compare and Swap logic must be
used to update this field. If
this 32-bit field is treated as
SIGNED, it will overflow when CP
DPA reaches 2G frames, or 8T
bytes. If this 32-bit field is
treated as UNSIGNED, it will
overflow when CP DPA reaches 4G
frames, or 16T bytes.
0018 24 Signed 4 RSATRSAV Count of DPA frames in use for
DEFERIO traces. This count is
used to ensure that the number of
DPA frames allocated for DEFERIO
traces does not exceed 75% of the
pageable pages in the DPA. This
count is serialized by TXCDFRIO,
the DEFERIO frames lock.
001C 28 Signed 4 RSASTORE Real machine actual storage size
below 2G. Calculated during
system init. RSASTORE can be
updated repeatedly by SET STORAGE
processing. No serialization over
RSASTORE is in effect.
Storage for 64 alternate processor PFXPGs are allocated
during initialization from storage following the CP nucleus
and is identity-mapped into the System Execution Space.
The CPU address of the processor is used to index into this
storage when allocating/deallocating prefix pages.
Prefix pages are allocated below 2G in storage. Since they
are allocated from identity-mapped storage the addresses
can be used as host real or host logical (SXS) addresses.
0020 32 Address 4 RSAPFXAF First alternate proc PFXPG addr.
Host real = host logical address.
0024 36 Address 4 RSAPFXND Address of the end of alternate
processor PFXPG table. Points to
the byte just after the last
PFXPG in the table. Host real =
host logical address.
This area contains information generally regarding the
"lazy initialization" of host storage, although there
are other uses here.
0028 40 Signed 4 RSATASKB (0) Task active bits. After system
initialization, always use
Compare-And-Swap to update any
bit in this word.
0028 40 Bitstring 1 RSATSKB0 RSATASKB task bits 0- 7
0029 41 Bitstring 1 RSATSKB1 RSATASKB task bits 8-15
002A 42 Bitstring 1 RSATSKB2 RSATASKB task bits 16-23
002B 43 Bitstring 1 RSATSKB3 RSATASKB task bits 24-31
1... .... RSALzTsk X'80' RSALzTsk Reserved, in
reality. HCPISG uses a work byte
whose bits are defined like the
bits in RSATSKB3. Bit RSALzTsk is
used in that work byte, and is
not actually set in RSATSKB3.
RSALzTsk is defined here only to
reserve the bit so that bit x'80'
is not defined some time in the
future for some other purpose,
thus confusing HCPISG.
.1.. .... RSAPCQUA X'40' RSAPCQUA HCPPCQUA is
unassigning storage
..1. .... RSAneB2G X'20' RSAneB2G Phonetically: RSA
"ini" B2G. Look to initialize
frames < 2G
...1 .... RSAneCNT X'10' RSAneCNT Phonetically: RSA
"ini" CNT. Indicates RSAFNOTI
must be re-calculated.
.... ..1. RSAneSKP X'02' RSAneSKP Lazy
Initialization should skip this
pass, but should be sure to set
SYSTEMMP's VMDINI2G ON.
.... ...1 RSAneTSK X'01' RSAneTSK Phonetically: RSA
"ini" TSK. Indicates low priority
frame initialization task is
active.
002C 44 Signed 4 RSADPAAD Number of frames that are CP
frames in the storage being added
by SET STORAGE
0030 48 Signed 8 RSAFNOTI Count of 'not-init' FRMTEs. This
is the number of FRMTEs which
have not yet been checked to see
if they are usable.
0038 56 Signed 8 RSALGFRM Count of usable frames >= 2G.
Only pageable or available frames
are considered "usable" since
they can be used to satisfy new
requests. Non-pageable frames
can't be stolen so they aren't
considered usable. Pageable type
frames that are pinned are
considered non-pageable while
pinned.
0040 64 Signed 8 RSAGOFFL Count of offline frames >= 2G.
0048 72 Address 8 RSAGSTOR Host Real Address Last
addressable byte, including
storage > 2G. Calculated
during system init. RSAGSTOR can
be updated repeatedly by SET
STORAGE processing. No
serialization over RSAGSTOR is in
effect.
0050 80 Address 8 RSASTORL Host Real Address Highest real
host storage addr, including
STANDY and RESERVED. This is
uncapped. Calculated from SCLP
storage data or Diagnose.
0058 88 Address 8 RSALG1ST Host Logical Address Address of
first FRMTE for frames being
examined for FRMNOTI
0060 96 Address 8 RSALGLST Host Logical Address Address of
last FRMTE for frames being
examined for FRMNOTI
0068 104 Address 8 RSANOTIB Host Logical Address Address of
FRMTE for the highest frame
marked 'not-init'.
Uncleared Global Available lists.
General notes apply to both >2G and <2G.
- There is 1 lock per side of 2G. The singles lock is used.
bkt fix comment.
- There is a stats area in the singles available anchor
used to keep track of, and "predict" the consumption of
frames (on that particular side of 2G.)
- Code knows that the lists are in this immediate order:
A2G Contigs
+RSAMQAncBS A2G Singles
+RSAMQAncBS B2G Contigs
+RSAMQAncBS B2G Singles
Code can get from one to the others by adding or
subtracting a multiple of RSAMQAncBS.
BKT The contigs lock is "dead space" at the moment.
BKT Currently only using the singles thresholds for
BKT replenishment triggering. This has changed.
| >2G Uncleared Global Available Lists Data: |
| |
| Refer to HCPPTE for a description of the organization |
| of these lists. |
>2G Contigs frames available list
0070 112 Dbl-Word 8 RSAAvailAncA2Gc (0)
Avail list anchor above 2G
contigs See RSAMQAnc for a
detailed description of the
fields, including serialization
concerns.
0070 112 Address 8 RSAAvailFPA2Gc Forward pointer.
0078 120 Address 8 RSAAvailBPA2Gc Backward pointer.
0080 128 Signed 8 RSAAvailCntA2Gc
Count of frames on the list.
0088 136 Signed 8 * MI Count of requests
0090 144 Signed 8 * MI Count of returns
0098 152 Signed 8 * MI Count of replens
00A0 160 Signed 8 * MI Count of Orphans From
00A8 168 Signed 8 * MI Count of Orphans To
00B0 176 Signed 8 * MI Count of unfilled
00B8 184 Signed 4 * Low Water Mark
00BC 188 Signed 4 * 4 flag bytes.
00C0 192 Signed 8 RSAAvailLckA2Gc (6)
List lock. This lock is obtained
via macros HCPLKAV and HCPLK2GC.
This lock is released via macros
HCPULAV and HCPUL2GC.
00F0 240 Signed 4 RSAAvailISGA2Gc
The initial threshold value set
by ISG. Begin fields that are
serialized by holding the
RSAMQTLck.
00F4 244 Signed 4 RSAAvailLTA2Gc Low threshold. This is the low
threshold for type any contigs
requests. Compare to the sum of
the count of FRMTEs available for
a type any contigs request. This
includes: + Count FRMTEs on this
list. + Count FRMTEs on <2G
contigs list above the T2 protect
threshold. If the "count" falls
below this threshold, then demand
scan should begin replenishing
singles.
00F8 248 Signed 4 RSAAvailHTA2Gc Available list high threshold.
Point at which Demand scan can
stop replenishing.
00FC 252 Signed 4 RSAAvailPTA2Gc Protect threshold. This protects
the type any contigs from being
raided for pageable singles. For
a single pageable request to be
allocated from a contigs list,
the sum of the available type any
contigs must be over this value.
0100 256 Signed 4 * LT inc Zero.
0104 260 Signed 4 * LT inc
0108 264 Signed 4 * LT dec
010C 268 Signed 4 * LT good.
0110 272 Signed 4 RSAAvailFlgA2Gc (0)
4 compare and swap flag bytes.
0110 272 Address 1 * RSAMQdsc flag
0111 273 Bitstring 1 * RSAMQTLck TS lock.
0112 274 Bitstring 1 * Reserved for IBM use
0113 275 Bitstring 1 * Reserved for IBM use.
0114 276 Address 4 RSAAvailRepRoutineA2Gc
Not used at the moment. BKT
0118 280 Signed 8 * Reserved debug field BKT comment
stats, include serialization
comment.
0120 288 Signed 8 RSAAvailStatsA2Gc (75)
Caution, do not insert anything
between the lists
>2G Singles frames available list
0378 888 Dbl-Word 8 RSAAvailAncA2Gs (0)
Avail list anchor above 2G
singles See RSAMQAnc for a
detailed description of the
fields, including serialization
concerns.
0378 888 Address 8 RSAAvailFPA2Gs Forward pointer.
0380 896 Address 8 RSAAvailBPA2Gs Backward pointer.
0388 904 Signed 8 RSAAvailCntA2Gs
Count of frames on the list.
0390 912 Signed 8 * MI Count of requests
0398 920 Signed 8 * MI Count of returns
03A0 928 Signed 8 * MI Count of replens
03A8 936 Signed 8 * MI Count of Orphans From
03B0 944 Signed 8 * MI Count of Orphans To
03B8 952 Signed 8 * MI Count of unfilled
03C0 960 Signed 4 * Low Water Mark
03C4 964 Signed 4 * 4 flag bytes.
03C8 968 Signed 8 RSAAvailLckA2Gs (6)
List lock. This lock is obtained
via macros HCPLKAV and HCPLK2GA.
This lock is released via macros
HCPULAV and HCPUL2GA.
03F8 1016 Signed 4 RSAAvailISGA2Gs
The initial threshold value set
by ISG. Begin fields that are
serialized by holding the
RSAMQTLck.
03FC 1020 Signed 4 RSAAvailLTA2Gs Low threshold. This is the low
threshold for type any singles
requests. Compare to the sum of
the count of FRMTEs available for
a type any singles request. This
includes: + Count FRMTEs on this
list. + Count FRMTEs on >2G
contigs list above the contigs
protect threshold. + Count FRMTEs
on the <2G singles list above
the T2 protect threshold. + Count
FRMTEs on <2G contigs list
above the T2 protect threshold.
If the "count" falls below this
threshold, then demand scan
should begin replenishing
singles.
0400 1024 Signed 4 RSAAvailHTA2Gs Available list high threshold.
Point at which Demand scan can
stop replenishing.
0404 1028 Signed 4 RSAAvailPTA2Gs No meaning.
0408 1032 Signed 4 * LT inc Zero.
040C 1036 Signed 4 * LT inc
0410 1040 Signed 4 * LT dec
0414 1044 Signed 4 * LT good.
0418 1048 Signed 4 RSAAvailFlgA2Gs (0)
4 compare and swap flag bytes.
0418 1048 Address 1 * RSAMQdsc Description flag
0419 1049 Bitstring 1 * RSAMQTLck TS lock.
041A 1050 Bitstring 1 * Reserved for IBM use
041B 1051 Bitstring 1 * Reserved for IBM use.
041C 1052 Address 4 RSAAvailRepRoutineA2Gs
Not used at the moment. BKT
0420 1056 Signed 8 * Reserved debug field
0428 1064 Signed 8 RSAAvailStatsA2Gs (75)
Caution, do not insert anything
between the lists
| <2G Uncleared Global Available lists data: |
| |
| Refer to HCPPTE for a description of the organization |
| of these lists. |
<2G Contigs frames available list
0680 1664 Dbl-Word 8 RSAAvailAncB2Gc (0)
Avail list anchor below 2G
contigs See RSAMQAnc for a
detailed description of the
fields, including serialization
concerns.
0680 1664 Address 8 RSAAvailFPB2Gc Forward pointer.
0688 1672 Address 8 RSAAvailBPB2Gc Backward pointer.
0690 1680 Signed 8 RSAAvailCntB2Gc
Count of frames on the list.
0698 1688 Signed 8 * MI Count of requests
06A0 1696 Signed 8 * MI Count of returns
06A8 1704 Signed 8 * MI Count of replens
06B0 1712 Signed 8 * MI Count of Orphans From
06B8 1720 Signed 8 * MI Count of Orphans To
06C0 1728 Signed 8 * MI Count of unfilled
06C8 1736 Signed 4 * Low Water Mark
06CC 1740 Signed 4 * 4 flag bytes.
06D0 1744 Signed 8 RSAAvailLckB2Gc (6)
List lock. This lock is obtained
via macros HCPLKAV and HCPLKAVC.
This lock is released via macros
HCPULAV and HCPULAVC.
0700 1792 Signed 4 RSAAvailISGB2Gc
The initial threshold value set
by HCPISG.
Begin fields that are serialized by holding the RSAMQTLck.
Notes : The low threshold, high threshold, and protect
threshold for B2Gc are not currently used. One would
anticipate that it could be a low threshold for T2
contigs, but there is no such protection offered.
0704 1796 Signed 4 * Low threshold. (X'DEAD')
Spurious, perhaps incorrect use
of the following two fields
exist. Keep low! Until properly
addressed.
0708 1800 Signed 4 RSAAvailHTB2Gc Available list high threshold.
070C 1804 Signed 4 RSAAvailPTB2Gc Protect threshold.
0710 1808 Signed 4 * LT inc Zero.
0714 1812 Signed 4 * LT inc
0718 1816 Signed 4 * LT dec
071C 1820 Signed 4 * LT good.
0720 1824 Signed 4 RSAAvailFlgB2Gc (0)
4 compare and swap flag bytes.
0720 1824 Address 1 * RSAMQdsc Description flag
0721 1825 Bitstring 1 * RSAMQTLck TS lock.
0722 1826 Bitstring 1 * Reserved for IBM use.
0723 1827 Bitstring 1 * Reserved for IBM use.
0724 1828 Address 4 RSAAvailRepRoutineB2Gc
Not currently used. BKT
0728 1832 Signed 8 * Reserved debug field
0730 1840 Signed 8 RSAAvailStatsB2Gc (75)
Caution, do not insert anything
between the lists
<2G Singles frames available list
0988 2440 Dbl-Word 8 RSAAvailAncB2Gs (0)
Avail list anchor below 2G
singles See RSAMQAnc for a
detailed description of the
fields, including serialization
concerns.
0988 2440 Address 8 RSAAvailFPB2Gs Forward pointer.
0990 2448 Address 8 RSAAvailBPB2Gs Backward pointer.
0998 2456 Signed 8 RSAAvailCntB2Gs
Count of frames on the list.
09A0 2464 Signed 8 * MI Count of requests
09A8 2472 Signed 8 * MI Count of returns
09B0 2480 Signed 8 * MI Count of replens
09B8 2488 Signed 8 * MI Count of Orphans From
09C0 2496 Signed 8 * MI Count of Orphans To
09C8 2504 Signed 8 * MI Count of unfilled
09D0 2512 Signed 4 * Low Water Mark
09D4 2516 Signed 4 * 4 flag bytes.
09D8 2520 Signed 8 RSAAvailLckB2Gs (6)
List lock. This lock is obtained
via macros HCPLKAV and HCPLKAVL.
This lock is released via macros
HCPULAV and HCPULAVL.
0A08 2568 Signed 4 RSAAvailISGB2Gs
The initial threshold value set
by HCPISG. Begin fields that are
serialized by holding the
RSAMQTLck.
0A0C 2572 Signed 4 RSAAvailLTB2Gs Low Threshold. This is the low
threshold for authorized T2
singles requests. Compare to the
sum of the count of FRMTEs
available for a T2 single
request. This includes: + Count
FRMTEs on this list. + Count
FRMTEs on <2G contigs. If the
"count" falls below this
threshold, then a replenishment
task should replenish to the high
threshold. Must not go below 8,
as it is increased by 1/8th.
0A10 2576 Signed 4 RSAAvailHTB2Gs Available list high threshold.
Point at which the replenishment
routine may stop.
0A14 2580 Signed 4 RSAAvailPTB2Gs Protect threshold. This reserves
a number of <2G frames for
special tasks that are "T2
authorized" (prmAuthT2). For an
unauthorized request to be
allocated from this list, the sum
of the count on this list, plus
the count of FRMTEs on the <2G
contigs over the contigs PT
threshold, must be over this
value.
0A18 2584 Signed 4 * LT inc Zero.
0A1C 2588 Signed 4 * LT inc
0A20 2592 Signed 4 * LT dec
0A24 2596 Signed 4 * LT good.
0A28 2600 Signed 4 RSAAvailFlgB2Gs (0)
4 compare and swap flag bytes.
0A28 2600 Address 1 * RSAMQdsc Description flag
0A29 2601 Bitstring 1 * RSAMQTLck TS lock.
0A2A 2602 Bitstring 1 * Reserved for IBM use
0A2B 2603 Bitstring 1 * Reserved for IBM use.
0A2C 2604 Address 4 RSAAvailRepRoutineB2Gs
Not currently used. BKT
0A30 2608 Signed 8 * Reserved debug field
0A38 2616 Signed 8 RSAAvailStatsB2Gs (75)
>2G deferred frame request queue
******************************--
Deferred frame request queue for tasks waiting
for a frame located >2G only.
See RSADefFRQ for mapping and important comments.
This queue is for tasks waiting for a >2G frame
when the >2G singles available list is empty.
0C90 3216 Dbl-Word 8 RSADefA2G (0) A2G Deferred Frame Request Queue
0C90 3216 Signed 8 * (6) Spin lock.
0CC0 3264 Address 4 * Pointer to First CPEBK.
0CC4 3268 Address 4 * Pointer to Last CPEBK.
0CC8 3272 Signed 4 RSAdefCTA2G Count. (Maintain
MRSTORSG,MRSYTRSG)
End of RSADefA2G definition.
0CCC 3276 Signed 4 * Reserved for IBM use.
End of the >2G Section.
0CD0 3280 Dbl-Word 8 RSAPRLK (3) PTRM address space resolution
lock. This is a formal exclusive
lock, managed by HCPLCK. This
lock serializes RSAASITB during
PTRM address space creation. This
lock must be held to resolve an
"address space fault" when
working with PTRM address spaces.
0CE8 3304 Signed 4 * Reserved for IBM use.
0CEC 3308 Address 4 RSAASITB Ptr to table of i-ASITs for the
PTRM address spaces. RSAPRLK must
be held to validate an entry in
this table. Each table entry is
mapped by the HCPAMTE control
block.
00000400 RSAASITBSZ 128*8 Length of table in bytes
128 entries of length AMTLENTH
0CF0 3312 Character 1 * (0) For source code searching
0CF0 3312 Address 8 RSADPPFW (0) Host Real Address
0CF0 3312 Address 4 * Deferred PGMBK paging list ...
0CF4 3316 Address 4 * (DPPL) forward pointer
0CF8 3320 Address 8 RSADPPBW (0) Host Real Address
0CF8 3320 Address 4 * Deferred PGMBK paging list ...
0CFC 3324 Address 4 * (DPPL) backward pointer
0D00 3328 Address 8 RSAPPAFW (0) Host Real Address
0D00 3328 Address 4 * Paged PGMBK aging list (PPAL) ...
0D04 3332 Address 4 * forward ptr. PPAL is actually a
list of PGMBKs and DAT frames.
0D08 3336 Address 8 RSAPPABW (0) Host Real Address
0D08 3336 Address 4 * Paged PGMBK aging list ...
0D0C 3340 Address 4 * (PPAL) backward pointer.
0D10 3344 Signed 4 RSAPPAQD If non-zero, a task has been
queued for deferred processing of
the PPAL (contains the R13
savearea address of the queueing
task). Set with CS, reset with
store of 0s.
0D14 3348 Signed 4 RSAPPTLK Pageable Page Table Lock This is
an informal spin lock. The lock
must be held when adding FRMTEs
to or removing FRMTEs from the
DPPL or the PPAL. RSAPPTLK is set
to the address obtaining the
lock. When free, its value is
zero. Use Compare-and-Swap to
update. (This lock must also be
held when decrementing a PGMFRMCT
or PGMMIGCT field to zero, and
then seeing if we can put that
PGMBK on the DPPL.) It must be
held while processing the DPPL,
but can be held only while the
PPAL is 'harvested' See HCPHRUPA
prolog for details This lock also
serializes the bit FRMONQUE in a
FRMTE being put on the DPPL or
PPAL. For FRMTEs on the PPAL, the
ONLY procession for them is to an
available list, and FRMONQUE is
then reset.
0D18 3352 Signed 4 RSARESAC Count of resident PTRM pages
>=2G i.e. count of resident
PGMBK frames >= 2G
0D1C 3356 Signed 4 RSATFCNT Total number of trace frames.
0D20 3360 Dbl-Word 8 RSARFRSG Count of frames allocated for
real free storage requests
>2G. This count is updated
using Compare-and-Swap logic.
0D28 3368 Dbl-Word 8 RSAAFRDW Count of doublewords of aligned
real free storage above 2G. This
count includes the number of
doublewords of active as well as
inactive aligned free storage.
This count will always be a
multiple of 512. This count is
updated using Compare-and-Swap
logic.
0D30 3376 Dbl-Word 8 RSAAFRIU Count of doublewords of in use
aligned real free storage above
2G. This count includes only the
active aligned free storage
blocks This count is updated
using Compare-and-Swap logic.
0D38 3384 Signed 4 RSAAFSDW Count of doublewords of aligned
host logical free storage backed
above 2G. This count includes the
number of doublewords of active
as well as inactive aligned free
storage. This count will always
be a multiple of 512. This count
is updated using Compare-and-Swap
logic.
0D3C 3388 Signed 4 RSAAFSDB Count of doublewords of aligned
host logical free storage backed
below 2G. This count includes
active as well as inactive
aligned free storage. This count
will always be a multiple of 512.
This count is updated using
Compare-and-Swap logic.
0D40 3392 Signed 4 RSARFRST Count of frames allocated for
real free storage requests
<2G. This count is updated
using Compare-and-Swap logic.
0D44 3396 Signed 4 RSAAFRDB Count of doublewords of aligned
real free storage below 2G. This
count includes active as well as
inactive aligned free storage.
This count will always be a
multiple of 512. This count is
updated using Compare-and-Swap
logic.
0D48 3400 Signed 4 RSAAFSIU Count of doublewords of in use
aligned host logical free storage
backed above 2G. This count
includes only the active aligned
free storage blocks. This count
is updated using Compare-and-Swap
logic.
0D4C 3404 Signed 4 RSAAFSIB Count of doublewords of in use
aligned host logical free storage
backed below 2G. This count
includes only the active aligned
free storage blocks. This count
is updated using Compare-and-Swap
logic.
0D50 3408 Signed 4 RSAAFRIB Count of doublewords of in use
aligned real free storage below
2G. This count includes only the
active aligned free storage
blocks This count is updated
using Compare-and-Swap logic.
0D54 3412 Signed 4 RSAVCBDW Count of doublewords of
verifiable control block free
storage backed above 2G. This
control block free storage. count
includes the number of
doublewords of active as well as
inactive verifiable control block
free storage and will always be a
multiple of 512. This count is
updated using Compare-and-Swap
logic.
0D58 3416 Signed 4 RSAVCBDB Count of doublewords of
verifiable control block free
storage backed below 2G. This
control block free storage. count
includes the number of
doublewords of active as well as
inactive verifiable control block
free storage and will always be a
multiple of 512. This count is
updated using Compare-and-Swap
logic.
0D5C 3420 Signed 4 RSAVCBIU Count of doublewords of in use
verifiable control block free
storage backed above 2G. This
count includes only the active
verifiable control block free
storage blocks. This count is
updated using Compare-and-Swap
logic.
0D60 3424 Signed 4 RSAVCBIB Count of doublewords of in use
verifiable control block free
storage backed below 2G. This
count includes only the active
verifiable control block free
storage blocks. This count is
updated using Compare-and-Swap
logic.
0D64 3428 Signed 4 RSAVFSDW Count of doublewords of virtual
free storage. This count includes
active as well as inactive
virtual free storage blocks (Note
that inactive means currently
resident on the virtual SUBBK
FRMTE list).
Note that this count represents
virtual storage, not real. The
count is the number of doublewords
within the virtual free storage
CP utility address space currently
in use or residing on the virtual
SUBBK FRMTE lists. This count
will always be a multiple of 2048.
This count is updated using
Compare-and-Swap logic.
0D68 3432 Signed 4 RSAVFSIU Count of doublewords of virtual
free storage in use. This count
includes only active free storage
blocks. Note this count
represents virtual storage, not
real. The count is the number of
doublewords within the virtual
free storage CP utility address
space. This count is updated
using Compare-and-Swap logic.
0D6C 3436 Signed 4 RSANALD Host Real Address ALD for "null"
access list
0D70 3440 Dbl-Word 8 RSANASIT (0) i-ASIT for "null" address space.
The ASTE for the null address
space is guaranteed to designate
both a null access list (RSANALD)
and a null authority table, and
the ASTE ASCE is guaranteed to
designate a segment table with
STL of 1, indicating that the
segment table is two segment
table units in length (2 pages =
8K in z/Arch).
0D70 3440 Address 4 * Null ASTE with IASRACC and
IASFPRIV set. The value is
updated during initialization to
address the null ASTE.
0D74 3444 Signed 4 * ASTE sequence number=1.
0D78 3448 Address 4 RSANDUCT Host Real Address Address of
"null" dispatchable- unit control
table (DUCT).
0D7C 3452 Address 4 RSASHRSP Host Logical Address Anchor for
chain of shareable address
spaces. Chain is serialized by
RSASHRLK.
0D80 3456 Dbl-Word 8 RSAPPTN STE invalidation timestamp of
most recently decoupled frame
(pair) on the PPAL.
0D88 3464 Signed 4 RSAPPTPS ALB/TLB purges started prior to
entering wait
0D8C 3468 Signed 4 RSAPPTPF ALB/TLB purges finished prior to
entering wait
0D90 3472 Signed 4 RSAPPTCS ALB/TLB purges via CSP during
emergency PPAL processing
0D94 3476 Signed 4 * Reserved for IBM use
0D98 3480 Dbl-Word 8 RSASHRLK (3) A shared/exclusive defer lock
serializing the RSASHRSP chain.
0DB0 3504 Dbl-Word 8 RSASPMLK (3) A shared/exclusive defer lock
serializing all SPIBK chains
system-wide.
0DC8 3528 Dbl-Word 8 RSAALCIN (3) An exclusive-only defer lock to
serialize tasks changing an ALD
from the "null" ALD to a non-null
ALD.
0DE0 3552 Signed 4 RSACTSHR Global count of shared address
space resident frames
0DE4 3556 Signed 4 RSABLKGC Count of tasks representing frame
requests requesting or deferred
on RSABLKGF lock
?? Note that RSABLKGF is superceded by demand throttling and
?? and should be removed entirely:
0DE8 3560 Dbl-Word 8 RSABLKGF (3) An exclusive-only defer lock to
serialize tasks obtaining frames
to resolve page faults in a group
of blocked pages. Used when there
are no frames on the available
list.
| RSM allocation counts: |
0E00 3584 Signed 4 RSACPLOK Integer non-negative exact count
of frames that are locked by the
CP LOCK command (PGSCPLOK) below
2G. This count is updated using
Compare-and-Swap logic.
0E04 3588 Signed 4 RSAOFFLN Non-negative count of the number
of offline frames. The count of
offline frames may never be
decremented since once a frame is
marked offline, it is never
brought back online. This field
is initialized during system
initialization and should always
be updated with the available
list spin lock held. However,
because this field may be updated
by the extend free storage
replenishment scan which does not
normally function with the
available list lock held, there
is a minute chance that the count
may be off slightly.
0E08 3592 Signed 4 RSASHARE Non-negative count of frames that
currently are translated as a
shared frame (DCSS/NSS frames
only, shared address space frames
are not included (see RSACTSHR)).
This count is updated using
Compare-and-Swap logic.
0E0C 3596 Signed 4 RSANONPG Count of DPA frames which are
currently non-pageable, including
locked pageable frames, CP owned
or free storage frames, etc. This
field is only updated during
system initialization or using
Compare-and-Swap logic.
0E10 3600 Signed 4 RSAPGABL Count of usable frames in the DPA
including both pageable and
non-pageable (locked, CP owned,
free storage, etc.) frames. It
does not include offline frames.
This field is only updated during
system initialization or using
Compare-and-Swap logic.
0E14 3604 Signed 4 RSACPLKG Integer non-negative exact count
of frames that are locked by the
CP LOCK command (PGSCPLOK) above
2G. This count is updated using
Compare-and-Swap logic.
<2G deferred frame request queue
******************************--
Deferred frame request queue for tasks waiting
for a frame located <2G only.
See RSADefFRQ for mapping and important comments.
This queue is for tasks waiting for a <2G frame
when the <2G singles available list is empty.
0E18 3608 Dbl-Word 8 RSADefB2G (0) B2G Deferred Frame Request Queue
0E18 3608 Signed 8 * (6) Spin lock.
0E48 3656 Address 4 * Pointer to First CPEBK.
0E4C 3660 Address 4 * Pointer to Last CPEBK.
0E50 3664 Signed 4 RSAdefCTB2G Count (Formerly RSAFRQWT)
(Maintain MRSTORSG,MRSYTRSG)
End of RSADefB2G definition.
0E54 3668 Signed 4 RSAFRQMW Count of tasks deferring or
delaying attempting to obtain
multiple frames (for PGMBKs only
at this point). Incremented once
after initial attempt fails,
decremented only after request is
satisfied, or given up on.
0E58 3672 Signed 4 RSAFRQDF Count of deferred multiple frame
requests for PGMBKs Incremented
during actual deferment.
0E5C 3676 Signed 4 RSAFRQDL Count of delayed multiple frame
requests for PGMBKs Incremented
during actual delay.
0E60 3680 Dbl-Word 8 RSAFRQDT Total multiple frame request
delay interval for PGMBKs since
last system timer pop
0E68 3688 Dbl-Word 8 RSAFRQDA Average multiple frame request
delay interval for PGMBKs between
system timer pop instances
Redrive counters for tasks waiting for frames.
0E70 3696 Signed 4 RSARDaANY Count of times HCPPTGRD attempted
to redrive tasks waiting for any
available frame (>= 2G or
<2G) Updated with CS.
(Maintain MRSTORSG)
0E74 3700 Signed 4 RSARDtANY Count of individual task redrives
performed by HCPPTGRD for any
available frame (>= 2G or
<2G) Updated with CS.
(Maintain MRSTORSG)
0E78 3704 Signed 4 RSARDaA2G Count of times HCPPTGRD attempted
to redrive tasks waiting for an
available frame >2G. Updated
with CS. (Maintain MRSTORSG)
0E7C 3708 Signed 4 RSARDtA2G Count of individual task redrives
performed by HCPPTGRD for an
available frame >2G. Updated
with CS. (Maintain MRSTORSG)
0E80 3712 Signed 4 RSARDaB2G Count of HCPPTGRD attempts to
redrive tasks waiting for frames
below 2G. Updated with CS.
(Formerly RSAFRRDA) (Maintain
MRSTORSG)
0E84 3716 Signed 4 RSARDtB2G Count of individual task redrives
performed by HCPPTGRD for frames
below 2G. Updated with CS.
(Formerly RSAFRRDC) (Maintain
MRSTORSG)
0E88 3720 Signed 4 RSADFCHW RSAAGDFC high water mark
0E8C 3724 Signed 4 RSARESBC Count of resident PTRM pages
<2G i.e. count of resident
PGMBK frames <2G
<>2G deferred frame request queue
******************************---
Deferred frame request queue for tasks waiting
for a frame located <>2G. (Also known as type=ANY.)
See RSADefFRQ for mapping and important comments.
This queue is for tasks waiting for a <>2G frame
when both of the singles available lists are empty.
0E90 3728 Dbl-Word 8 RSADefANY (0) ANY Deferred Frame Request Queue
0E90 3728 Signed 8 * (6) Spin lock.
0EC0 3776 Address 4 * Pointer to First CPEBK.
0EC4 3780 Address 4 * Pointer to Last CPEBK.
0EC8 3784 Signed 4 RSAdefCTANY Count (Formerly RSA2GDCT)
(Maintain MRSTORSG,MRSYTRSG)
End of RSADefANY definition.
0ECC 3788 Signed 4 RSAthrDQskip Count of times throttle dq had to
skip user-type deferred request
| Available list replenishment (steal) data: |
0ED0 3792 Dbl-Word 8 * (0)
0ED0 3792 Signed 4 RSADSLOK (0) Demand Scan (Steal) lock. When
held, this lock indicates the
Demand Scan is replenishing the
available list of frames. This
lock is normally obtained via TS.
However CS may be used if
RSARFLOK is set to X'FF' as TS
would and RSADSCPU is set at the
same time.
0ED0 3792 Bitstring 1 RSARFLOK TS lock to prevent triggering of
multiple concurrent steal tasks
0ED1 3793 Bitstring 3 RSADSCPU When non-zero, indicates a CPU is
running the Steal task
0ED4 3796 Bitstring 1 RSATRQLK Delayed Demand Scan TRQBK lock.
This TS lock is used to prevent
stacking multiple TRQBK's when
Demand Scan determines it may
need to reinvoke itself.
0ED5 3797 Bitstring 1 RSAEWLOK TS lock to prevent multiple
instances of HCPALGEW from
running in competition with each
other.
0ED6 3798 Bitstring 1 * Reserved for IBM use
0ED7 3799 Bitstring 1 RSADSFLG Demand Scan flags
1... .... RSATAALL X'80' RSATAALL Any HCPALGTA task
that sees this and is not
returning frames to its caller
should process as much of the
reclaimable section as possible
because an emergency condition
has been detected
0ED8 3800 Dbl-Word 8 * (0)
0ED8 3800 Dbl-Word 8 RSADSTSA Timestamp of when entered
emergency pass in demand scan for
>=2G frames
0EE0 3808 Dbl-Word 8 RSADSTSB Timestamp of when entered
emergency pass in demand scan for
<2G frames
Available list thresholding and statistics.
0EE8 3816 Signed 4 * Reserved.
0EEC 3820 Bitstring 1 RSAThreshFlg Thresholding flag for frame
manager.
1... .... RSADSStarted X'80' When considering raising or
lowering thresholds, we have
started Demand scan.
.1.. .... RSADSEnded X'40' When considering raising or
lowering thresholds, we have
ended Demand scan.
0EED 3821 Bitstring 1 RSAALUST TS Flag to run stats. Obtainer
calls HCPALUST.
0EEE 3822 Bitstring 1 RSAanySltFlg Flag for type ANY singles low
threshold checks for demand
throttling.
.... ...1 RSAanysLTblo X'01' Type ANY singles are below
low threshold
0EEF 3823 Bitstring 1 RSADmThrRdLk Demand Throttling redrive TS lock
0EF0 3824 Signed 4 RSASWPWT Count of available list
replenishment page writes (steal
writes) for < 2G PGMBKs in
frames This count is updated
using Compare-and-Swap logic.
0EF4 3828 Signed 4 RSASWP2G Count of available list
replenishment page writes (steal
writes) for >= 2G PGMBKs in
frames
0EF8 3832 Signed 4 RSACFPCT Count of contiguous frames for
PGMBKs since last demand scan
0EFC 3836 Signed 4 RSACFPAV Average count of contiguous frame
requests for PGMBKs between
demand scan instances
0F00 3840 Signed 4 RSAALFMF Total count of contiguous frames
being scanned for by active
HCPALFMF FREXSCAN tasks
0F04 3844 Signed 4 RSAAVLEP Low threshold adjustment to
account for dynamic free storage
requests made for emulated paging
devices during demand scan
0F08 3848 Dbl-Word 8 * (0)
0F08 3848 Signed 4 RSASTLWT Count of available list
replenishment page writes (steal
writes) for < 2G frames. This
count is updated using
Compare-and-Swap logic.
0F0C 3852 Signed 4 RSASWG2G Count of available list
replenishment page writes (steal
writes) for >= 2G frames
0F10 3856 Bitstring 1 * Reserved for IBM use.
0F11 3857 Bitstring 1 * Reserved for IBM use.
0F12 3858 Bitstring 1 * Reserved for IBM use.
0F13 3859 Bitstring 1 * Reserved for IBM use.
0F14 3860 Address 4 * Reserved for IBM use
0F18 3864 Dbl-Word 8 * (0) Frame table scan extent block
ptrs
0F18 3864 Address 4 RSAFTXFL Host Logical Address Address of
first FTXBK for frames < 2G
0F1C 3868 Address 4 RSAFTXFG Host Logical Address Address of
first FTXBK for frames >= 2G
0F20 3872 Address 4 RSAFTXGC Host Logical Address Address of
first FTXBK on the global chain.
This chain of FTXBKs is
unordered, and ends at the FTXBK
whose FTXNEXTG pointer value is
zero.
0F24 3876 Address 4 * Reserved for IBM use
| Free storage data: |
0F28 3880 Signed 4 RSAFSA2G Non-negative count of doublewords
of system free storage backed
above 2G. Count includes the
number of doublewords of free
storage available. This count is
updated only by HCPFRFDX (free
storage garbage collection) which
runs on the master processor
only.
0F2C 3884 Signed 4 RSAFSB2G Non-negative count of doublewords
of system free storage backed
below 2G. Count includes the
number of doublewords of free
storage available. This count is
updated only by HCPFRFDX (free
storage garbage collection) which
runs on the master processor
only.
0F30 3888 Signed 4 RSAFSYUA Non-negative count of doublewords
of in use system free storage
backed above 2G. This count is
updated only by HCPFRFDX (free
storage garbage collection) which
runs on the master processor
only.
0F34 3892 Signed 4 RSAFSYUB Non-negative count of doublewords
of in use system free storage
backed below 2G. This count is
updated only by HCPFRFDX (free
storage garbage collection) which
runs on the master processor
only.
0F38 3896 Signed 4 RSAFVMUD Count of doublewords of VMDBK
free storage in use above 2G.
Allocated from VMDBKs, VMDBK free
storage pages, and system free
storage pages. This count does
not include the storage allocated
from the free storage subpools.
This count is updated only when
holding FSDVMLK formal spin lock.
0F3C 3900 Signed 4 RSAFVMUB Count of doublewords of VMDBK
free storage in use below 2G.
Allocated from VMDBKs, VMDBK free
storage pages, and system free
storage pages. This count does
not include the storage allocated
from the free storage subpools.
This count is updated only when
holding FSDVMLK formal spin lock.
0F40 3904 Signed 4 RSAVMXFR Count of pages in use for VMDBK
free storage above 2G, i.e., user
free pages allocated. This count
does not include the VMDBKs
themselves. This count is updated
only when holding FSDVMLK formal
spin lock.
0F44 3908 Signed 4 RSAVMXFB Count of pages in use for VMDBK
free storage above 2G, i.e., user
free pages allocated. This count
does not include the VMDBKs
themselves. This count is updated
only when holding FSDVMLK formal
spin lock.
0F48 3912 Signed 4 RSAVMXUD Count of in use user free storage
doublewords (allocated from VMDBK
free storage pages) backed above
2G. This count does not include
storage in the VMDBKs themselves.
This count is updated only when
holding FSDVMLK formal spin lock.
0F4C 3916 Signed 4 RSAVMXUB Count of in use user free storage
doublewords (allocated from VMDBK
free storage pages) backed below
2G. This count does not include
storage in the VMDBKs themselves.
This count is updated only when
holding FSDVMLK formal spin lock.
0F50 3920 Signed 4 RSASYSFR Count of pages in use for system
free storage above 2G. This count
is updated only when holding
FSDVMLK formal spin lock.
0F54 3924 Signed 4 RSASYSFB Count of pages in use for system
free storage below 2G. This count
is updated only when holding
FSDVMLK formal spin lock.
0F58 3928 Signed 4 RSASYSUD Count of system free storage
doublewords above 2G in use
allocated from system free
storage chain. This count is
updated when holding FSDVMLK
formal spin lock.
0F5C 3932 Signed 4 RSASYSUB Count of system free storage
doublewords below 2G in use
allocated from system free
storage chain. This count is
updated when holding FSDVMLK
formal spin lock.
0F60 3936 Signed 4 * Reserved for IBM use
0F64 3940 Signed 4 * Reserved for IBM use
| Data for free storage limit detection. The 3 thresholds |
| will determine when to issue a warning message, put a |
| user into a stopped state and when to logoff a user who |
| is abusing free storage. These fields are updated with |
| Compare-and-Swap logic. |
| The flag field is used to determine whether free storage |
| limit detection is on or off for the system. |
0F68 3944 Dbl-Word 8 * (0) 5 word long area on dword bdy
0F68 3944 Signed 4 RSALIM1 Free storage threshold 1 (WRNG)
0F6C 3948 Signed 4 RSALIM2 Free storage threshold 2 (STOP)
0F70 3952 Signed 4 RSALIM3 Free storage threshold 3 (FORCE)
RSALMFUZ is calculated to be .5% DPA and will be used as the
fuzz around the thresholds to prevent multiple messages from
being issued if the limit oscillates about the threshold.
0F74 3956 Signed 4 RSALMFUZ Free storage threshold fuzz
0F78 3960 Signed 4 RSALIMCS (0) Free storage limits Compare-and-
Swap word
0F78 3960 Bitstring 3 * Reserved for IBM use
0F7B 3963 Bitstring 1 RSALIMCK Free storage limit detection flag
00000000 RSALIMOF X'00' RSALIMOF Free storage limit
detection off
00000001 RSALIMON X'01' RSALIMON Free storage limit
detection on
| Free storage emergency mode counts/timestamps. |
| The RSAFSELK lock must be held to inspect/change |
| these fields. RSAFSELK is obtained via CS logic. |
0F7C 3964 Signed 4 RSAFSELK Free storage emergency mode data
area lock word
0F80 3968 Signed 4 RSAPLPCT Count of processors looping in
HCPFRFGP/GB trying to get an SXS
page backed any for free storage
0F84 3972 Signed 4 RSAPLPCB Count of processors looping in
HCPFRFGP/GB trying to get an SXS
page backed below 2G for free stg
0F88 3976 Signed 4 RSANPGCT Count of consecutive failure
returns from SXPFS where no pages
were available for free storage
0F8C 3980 Signed 4 * Reserved to maintain alignment
0F90 3984 Dbl-Word 8 RSAEMTSA Timestamp of when entered
emergency mode looking for a free
storage page backed any
0F98 3992 Dbl-Word 8 RSAEMTSB Timestamp of when entered
emergency mode looking for a free
storage page backed below
0FA0 4000 Signed 4 RSANPGMX Maximum cap on number of times we
will allow a consecutive failure
from HCPSXPFS when trying to get
a page for free storage
0FA4 4004 Signed 4 RSANPGHI High water mark for number of
consecutive failures from
HCPSXPFS when trying to get a
page for free storage (all
processors)
| Free storage reserved pages data area: |
0FA8 4008 Dbl-Word 8 * (0) This is the free storage reserved
pages data area consisting of a
count of unique extend requests
that have not been satisfied yet,
the free storage reserved pages
anchor, the free storage reserved
pages data area lock word, the
count of free storage reserved
pages required by the system, and
the number of free storage
reserved pages per processor.
Note: The number of free storage
reserved pages per processor must
be positive. Update while holding
the free storage reserved pages
data area Compare-and-Swap lock
word or during system
initialization.
0FA8 4008 Signed 4 RSAXTEND Free storage reserved pages
depletion count (extend
conditions not yet satisfied).
Guest dispatch is disabled when
RSAXTEND is non-zero.
0FAC 4012 Address 4 RSARESAN Reserved pages queue anchor
forward pointer
0FB0 4016 Address 4 RSARSVLK Free storage reserved pages data
area Compare-and-Swap lock word
0FB4 4020 Signed 4 RSARSVSY Total number of free storage
reserved pages required to be on
the reserved pages list Includes
RSAMAXPP frames per online
processor, plus additional frames
per emulated CP owned device
containing page or spool space
(the number of frames is based on
emulated device specific
information provided in the
EDEV).
0FB8 4024 Signed 4 RSAMAXPP Number of free storage reserved
pages required per processor.
Note: Field must be positive.
0FBC 4028 Signed 4 * Reserved for IBM use
| Segment translation data: |
0FC0 4032 Dbl-Word 8 * (0) This is the deferred segment
translation queue data area. It
consists of the queue anchor and
the Compare-and-Swap lock.
0FC0 4032 Address 4 RSADEFAN Host Logical Address Pointer to
first CPEBK of the deferred
segment translation queue
0FC4 4036 Address 4 RSADEFLK Compare-and-Swap lock. Zero means
the lock is not held.
0FC8 4040 Signed 4 RSAPRQWT Non-negative count of tasks
waiting for a page translation
request. This count also includes
tasks waiting for a segment
translation. This count is
updated with Compare-and-Swap
logic.
0FCC 4044 Signed 4 * Reserved for IBM use
| Fixed storage management data: |
This area contains the fixed storage management block.
It contains information regarding the allocation of
contiguous host real storage from the V=F area.
Additionally, information for the dedicated region
facility is kept here to keep track of zone numbers
available for assigning to MHPG users or to CP.
The allocation of storage from the V=F area is
maintained in the fixed storage assignment block
anchored in HCPWRK.
All changes to fields in the fixed storage management
block and in the fixed storage assignment table are
either made during system initialization or are under
the control of the fixed storage management lock.
0FD0 4048 Dbl-Word 8 RSAFSTBK (0) Fixed storage management block
0FD0 4048 Dbl-Word 8 RSAFSLCK (3) Fixed storage mgmt lock (defer)
0FE8 4072 Bitstring 2 RSASA1ST Offset of entry in the fixed
storage assignment table
containing the lowest main
storage origin
0FEA 4074 Bitstring 2 RSASALST Offset of entry in the fixed
storage assignment table
containing the highest main
storage origin
0FEC 4076 Signed 4 RSASTRNG (0) The entire storage range for the
V=F area. (Never changes)
0FEC 4076 Signed 2 RSAMSO Bits 5-15 specify a 1 meg main
storage origin of the V=F area.
Main storage origin is the
address of the first byte, on a
megabyte boundary, of the V=F
area, shifted right 20 bits.
0FEE 4078 Signed 2 RSAMSL Bits 5-15 specify a 1 meg main
storage limit of the V=F area.
Main storage limit is the address
of the last byte of the V=F area,
shifted right 20 bits.
0FF0 4080 Bitstring 1 RSAAZNCT Count of zones available for
guest use, including zones in use
(never changes)
0FF1 4081 Bitstring 1 RSAZPOOL Pool of available zones, not
including those in use
0FF2 4082 Bitstring 2 * Reserved for IBM use
0FF4 4084 Signed 4 * Reserved for IBM use
00000028 RSAFSTLN *-RSAFSTBK Length of FSTBK
00000005 RSAFSTSZ (*-RSAFSTBK+7)/8 Size of FSTBK
| Virtual storage management data: |
0FF8 4088 Dbl-Word 8 RSAVVBLK (0) Virtual Storage Management Block.
This area contains information
needed to manage the System
Virtual Address Space.
0FF8 4088 Bitstring 4 * Reserved for IBM use
0FFC 4092 Address 4 RSAVSLOW Lowest available virtual page.
Initialized by HCPIST at IPL.
Serialized by Compare-and-Swap
Allocation of System Virtual Addresses above RSAVHSAD
is serialized by the High Storage Lock (RSAVHSLK).
1000 4096 Dbl-Word 8 RSAVHSLK (3) High storage lock
1018 4120 Bitstring 4 * Reserved
101C 4124 Address 4 RSAVHSAD High storage starting addr.
Initialized with constant 1G (the
upper half of the addr space).
Must be on a segment boundary
(right most 20 bits must be
zero).
| No-owned resources data area |
| |
| No-owned resources are pageable address space structures|
| that no longer belong to any pageable address space but |
| cannot be reclaimed by CP because someone else has |
| rights to the structure, or the structure is locked or |
| last translated. |
1020 4128 Signed 8 RSANOQLK (6) No-owned resources queue lock.
Lock serializes the no-owned
queues, RSANOQSX, RSANOQFR, and
RSANOQPG. Lock is obtained and
released via macros HCPLKNOR and
HCPULNOR.
Reclaimable no-owned SXSTE queue
1050 4176 Address 8 RSANOXFP (0) SXSTE forward pointer
1050 4176 Address 4 * is initialized to
1054 4180 Address 4 * queue origin
1058 4184 Address 8 RSANOXBP (0) SXSTE backward pointer
1058 4184 Address 4 * is initialized to
105C 4188 Address 4 * queue origin
1060 4192 Bitstring 8 RSANOQFR Reclaimable no-owned FRMTE queue
header
1068 4200 Dbl-Word 8 RSANOQPG No-owned PGMBK queue header
1070 4208 Signed 4 * Reserved for IBM use
1074 4212 Signed 4 RSANOLKL Count of no-owned locked pages in
host logical storage
1078 4216 Dbl-Word 8 RSANOLKA Count of no-owned locked pages in
absolute storage
1080 4224 Signed 4 RSANOLOK Word used to ensure the no own
resource reclaim routine is only
invoked by the dispatcher on one
processor at a time. This ensures
only one of the background or
foreground replenishment tasks
are running at a time. This word
can be in any of the following
states as defined in HCPEQUAT:
DSPNOBFW - no work to do DSPFSCHD
- foreground scheduled DSPFACTV -
foreground active DSPBSCHD -
background scheduled DSPBACTV -
background active Serialized by
compare-and-swap
1084 4228 Signed 4 * Reserved for IBM use.
1088 4232 Signed 8 * Reserved for IBM
| System Execution Space Page Manager (SXSPM) data area |
| |
| These fields are serialized by SXSPM queue lock unless |
| otherwise noted for the individual fields. |
| Use HCPLKSXQ/HCPULSXQ to obtain/release the lock. |
1090 4240 Signed 8 RSASXQLK (6) SXSPM queue lock. This lock is
obtained & released via macros
HCPLKSXQ and HCPULSXQ.
SXS pages may or may not be on one of the queues that the
SXS page manager maintains.
| SXSTE state indicators: |
where queued: | SXSAVAIL | SXSBACKD | an alias |
|-----------|------------|------------|
Avail, backed <2G | 1 | 1 | no |
Avail, backed >2G | 1 | 1 | no |
Avail, unbacked | 1 | 0 | no |
Potentially Steal.| 0 | 1 | yes |
not in SXS queue | 0 | 1 | yes |
not in SXS queue | 0 | 1 | no |
(invalid state) | 0 | 0 | N/A |
(invalid state) | N/A | 0 | yes |
(invalid state) | 1 | N/A | yes |
|******************************-------|
An alias is an SXS page associated with a "pageable FRMTE".
All available SXS pages must be on one of the queues. If
the page is not backed it is on the Available, Unbacked SXS
Page Queue. If it is backed it is on one of the Available,
Backed SXS Page Queues (backed >2G or backed <2G). The one
exception to this rule is for SXSTEs in the Transitory
which are in transition between states. See HCPSXSTE COPY
for details regarding SXSTE states and serialization rules.
All in use SXS pages not associated with a "pageable FRMTE"
will be dequeued; i.e. not on any SXS page mgr queue.
All SXS pages which are associated with "pageable FRMTEs"
but are not locked will be kept on the SXS Potentially
Stealable Page Queue.
All SXS pages which are associated with "pageable FRMTEs"
and are locked may or may not be on the SXS Potentially
Stealable Page Queue. They are initially left on the queue
but are dequeued if the SXS page manager comes across them
when looking for an available page on the Potentially
Stealable Page Queue.
If SXSBACKD is not on, then SXSAVAIL must be on. If an
SXS page is in use as an alias, SXSBACKD must be set.
SXS Available, Unbacked Page Queue
a.k.a SXS Page Queue
10C0 4288 Dbl-Word 8 RSASXQAN (0) SXS Available, Unbacked Page
Queue Anchor. It consists of
forward and backward pointers to
the list of SXSTEs for SXS pages
that are available and not
backed. This area is initialized
during system initialization and
updated only when the SXSPM queue
lock is held.
10C0 4288 Address 8 RSASXQFP SXS page queue forward pointer.
Points to a SXSTE. This is a host
logical address > 2G unless
the queue is empty.
10C8 4296 Address 8 RSASXQBP SXS page queue backward pointer.
Points to a SXSTE. This is a host
logical address > 2G unless
the queue is empty.
10D0 4304 Signed 4 RSASXQCT Count of SXS pages on the SXS
page queue. This represents the
total number of SXS pages that
are available and not backed.
10D4 4308 Signed 4 RSASXQMN Minimum number of pages on the
available, unbacked page queue
before triggering replenishment.
SXS Potentially Stealable Page Queue
10D8 4312 Dbl-Word 8 RSASXPAN (0) SXS Potentially Stealable Page
Queue Anchor. It consists of
forward and backward pointers to
the list of SXSTEs for SXS pages
that are in use as aliases and
are potentially stealable. This
queue is initially empty and
SXSTEs are added to it during
Create Alias processing. This
queue is only updated when the
SXSPM queue lock is held.
10D8 4312 Address 8 RSASXPFP SXS Potentially Stealable Page
Queue forward pointer which
points to a SXSTE. This is a host
logical address > 2G unless
the queue is empty.
10E0 4320 Address 8 RSASXPBP SXS Potentially Stealable Page
Queue backward pointer which
points to a SXSTE. This is a host
logical address > 2G unless
the queue is empty.
10E8 4328 Signed 4 RSASXPCT Count of SXS pages on the SXS
Potentially Stealable Page Queue.
10EC 4332 Signed 4 * Reserved for IBM use.
Queues of Available SXS Pages With Backing Frames
Only SXSTEs with SXSAVAIL=1, SXSBACKD=1 which are not in
use are on these queues and all available, backed SXSTEs
must be on one of the queues unless it is in transition
to or from another state. If they are in the Transitory
state then SXSONQUE will be off.
Which of the queues the SXSTE is on depends on whether the
backing frame resides above or below 2G in real storage.
10F0 4336 Dbl-Word 8 RSASXAAN (0) Anchor for queue of available SXS
pages backed Above 2G.
10F0 4336 Address 8 RSASXAFP Forward pointer for available SXS
pages backed Above 2G. This is a
host logical address >2G
unless the queue is empty.
10F8 4344 Address 8 RSASXABP Backward pointer for available
SXS pages backed Above 2G. This
is a host logical address >2G
unless the queue is empty.
1100 4352 Signed 4 RSASXACT Count of SXS pages on the queue
of SXS pages backed Above 2G.
1104 4356 Signed 4 RSASXAMX Maximum number of pages on the
backed Above 2G queue. Note:
Field must be positive.
1108 4360 Dbl-Word 8 RSASXBAN (0) Anchor for queue of available SXS
pages backed Below 2G.
1108 4360 Address 8 RSASXBFP Forward pointer for available SXS
pages backed Below 2G. This is a
host logical address >2G
unless the queue is empty.
1110 4368 Address 8 RSASXBBP Backward pointer for available
SXS pages backed Below 2G. This
is a host logical address >2G
unless the queue is empty.
1118 4376 Signed 4 RSASXBCT Count of SXS pages on the queue
of SXS pages backed Below 2G.
111C 4380 Signed 4 RSASXBMX Maximum number of pages on the
backed Below 2G queue. Note:
Field must be positive.
SXS Page Request Defer Queue data
1120 4384 Dbl-Word 8 RSASXDAN (0) SXS page request defer anchor.
1120 4384 Address 4 RSASXDFP Defer queue forward pointer. It
is a host logical CPEBK address
unless the queue is empty.
1124 4388 Address 4 RSASXDBP Defer queue backward pointer. It
is a host logical CPEBK address
unless the queue is empty.
1128 4392 Signed 4 RSASXDCT Count deferred SXS page requests
that are waiting for an available
SXS page. This is the sum
RSASXDCA+RSASXDPB+RSASXDPA.
112C 4396 Signed 4 RSASXDCA Count deferred SXS page requests
that are waiting for an available
SXS page for an alias. This is a
subset of RSASXDCT.
1130 4400 Signed 4 RSASXDPB Count deferred SXS page requests
that are waiting for an SXS page
to satisfy a request for a page
backed <2G. This is a subset
of RSASXDCT.
1134 4404 Signed 4 RSASXDPA Count deferred SXS page requests
that are waiting for an SXS page
to satisfy a request for a page
with backing=ANY. This is a
subset of RSASXDCT.
1138 4408 Signed 4 RSASXRDA Count of times an attempt was
made to redrive tasks waiting for
an available SXS page.
113C 4412 Signed 4 RSASXRDC Count of individual task redrives
for tasks waiting for a page.
SXS Page Counts
These counts only include SXS pages managed by the page
manager using the SXS page management table (SXSTEs). This
does not include the SXS pages used for the frame table or
the SXS page management table itself. The total managed
SXS pages is SYSSXSSZ/x'1000' and set at initialization or
by the dynamic storage reconfiguration function.
All managed SXS pages are:
- backed or not backed
- available or in use, unless in the Transitory state.
All backed SXS pages are:
- backed below 2G or backed above 2G. Backed pages may be
in use or available. Available backed pages will be on
one of the available SXS page queues. In use SXS pages
may or may not be on the SXS Potentially Stealable Queue.
Backed pages may be in the Transitory state temporarily
while being converted between the in-use and available
states.
All available SXS pages are:
- not backed, backed <2G, or backed >2G. Each of these
types of available pages are on different queues.
All in use SXS pages:
- must be backed
- are aliases or CP type SXS pages (eg. HCPGETST PAGES=)
All in use CP type SXS pages are:
- permanently allocated at initialization, by the dynamic
storage reconfiguration function, or allocated
later using HCPGETST PAGES= or for free storage using
HCPSXPFS.
Some pages considered in use may be made available by
stealing. This applies to SXS alias pages for translated
pageable frames if the page is not last translated or
locked. All pages in the stealable state will be on the
Potentially Stealable Queue, but not all pages on the
Potentially Stealable Queue will be stealable. See HCPSXSTE
COPY for a discussion of rules for stealing Aliases.
1140 4416 Signed 4 RSASXAVL Count of available SXS pages
including those with backing
frames. The number of available
SXS pages without backing frames
is RSASXAVL-(RSASXACT+RSASXBCT)
which is also RSASXQCT. Does not
include Transitory state SXSTEs.
1144 4420 Signed 4 RSASXUSD Count of SXS pages in use as CP
pages or aliases including
no-owned aliases and SXS pages
assigned to tasks deferred on
frames in the real frame manager.
This value should match
((SYSSXSZ/x'1000')-RSASXAVL).
1148 4424 Signed 4 RSASXUCP Count of SXS pages in use as CP
pages. This includes free
storage, HCPGETST PAGES=, and
permanently allocated at
initialization.
114C 4428 Signed 4 RSASXUID Count of all ID-mapped SXS pages
(host logical = host real addr)
primarily CP nucleus and PFXPGS.
1150 4432 Signed 4 RSASXUFS Count of SXS pages in use as free
storage pages with backing frames
below 2G. These are SXSTEs with
SXSCSB0=x'61'.
1154 4436 Signed 4 RSASXUFG Count of SXS pages in use as free
storage pages with backing frames
above 2G. These are SXSTEs with
SXSCSB0=x'61'.
1158 4440 Signed 4 RSASXUOT Count of pages of other CP types:
(RSASXUCP-(RSASXUID+RSASXUFS
+RSASXUFG).
115C 4444 Signed 4 RSASXBKA Count of SXS pages backed above
2G. This includes RSASXACT as
well as in use SXS pages and
Transitory SXSTEs backed>2G.
1160 4448 Signed 4 RSASXBKB Count of SXS pages backed below
2G. This includes RSASXBCT as
well as in use SXS pages and
Transitory SXSTEs backed<2G.
1164 4452 Signed 4 RSASXALI Count of SXS alias pages
associated with "pageable FRMTEs"
and may be stealable if not last
translated or locked. Also
includes count of no-owned
SXSTEs.
1168 4456 Signed 4 RSASXNOP Count of no-owned SXS aliases.
116C 4460 Signed 4 RSASXCTG Count of SXS pages in use as part
of a contiguous page request from
HCPGETST with PAGES>1. This
count does not include the pages
that were pre-allocated as part
of storage initialization.
The following fields are not serialized by RSASXQLK.
1170 4464 Signed 4 RSASXDFA Count of SXS page requests
deferred in the real frame
manager for ANY backing frame.
Since only requests for single
pages can defer, this is also the
count of pages associated with
those deferred tasks. It is also
the count of frames needed. A
Transitory SXSTE exists for each
deferred frame request. This
count is serialized by CS.
1174 4468 Signed 4 RSASXDFB Count of SXS pages requests
deferred in the real frame
manager for a frame below 2G.
Since only requests for single
pages can defer, this is also the
count of pages associated with
those deferred tasks. It is also
the count of frames needed. A
Transitory SXSTE exists for each
deferred frame request. This
count is serialized by CS.
1178 4472 Signed 4 RSASXCLA Count of locked SXS alias pages
locked by HCPTRANS or command.
Updated in HCPTRANS processor,
not updated by SXS page mgr.
Serialized by Compare-and-Swap.
117C 4476 Signed 4 RSASXCPL Count of SXS alias pages locked
by the CP LOCK command. Updated
in the LOCK command processor,
not updated by SXS page mgr. This
is a subset of RSASXCLA.
Serialized by Compare-and-Swap.
1180 4480 Signed 4 * Reserved for IBM use.
Miscellaneous SXS Page Manager Fields.
1184 4484 Signed 4 RSASXLOK SXSPM redrive process lockword.
Word used to ensure the SXSPM
request redrive routine is only
invoked by the dispatcher on one
processor at a time. This word
can be in any of the following
states as defined in HCPEQUAT:
DSPNOBFW - no work to do DSPFSCHD
- foreground scheduled DSPFACTV -
foreground active DSPBSCHD -
background scheduled DSPBACTV -
background active Serialized by
compare-and-swap
1188 4488 Dbl-Word 8 RSASXFLGS SXS status flag bits
1190 4496 Address 8 RSASXSTO SXS Segment Table Origin for the
segment table that maps the SXS
storage from 0 to SYSSXSSZ. This
is the only section of the SXS
that has PTEs that are updated
after initialization. Because the
entire address range from 0 to
SYSSXSSZ can currently be mapped
by a single segment table, this
STO is used in HCPSXA and HCPSXP
instead of starting at the ASCE
to walk the DAT tables. Starting
at the segment table also depends
on the fact that the segment
table is permanently allocated
during initialization. This field
is set at initialization and
never changes.
1198 4504 Signed 4 RSASXQRA Replenishment Amount - number of
SXS pages to add to available,
unbacked SXS page queue each time
it is replenished. Must be a
multiple of RSASXQBS.
119C 4508 Signed 4 RSASXRPM The minimum number of pages on
the available, unbacked SXS page
queue at the completion of the
replenishment routine since the
system was IPLed.
11A0 4512 Signed 4 RSASXRFC Redrive Failure Count. The number
of consecutive times HCPSXARR ran
and the reserved page list was
depleted or there were deferred
requests but HCPSXARR could not
satisfy any of them. This count
is used by HCPSXARR to determine
when to give up (SXA004 abend).
11A4 4516 Signed 4 RSAIDEND End of the ID-mapped region of
the SXS. Actually address of the
first byte past the end. Set at
initialization and never changed.
End of SXS page manager data area
11A8 4520 Signed 4 * RESERVED FOR IBM USE
11AC 4524 Signed 4 * RESERVED FOR IBM USE
| Cleared Global Available List Data: |
11B0 4528 Dbl-Word 8 RSACALAN (0)
11B0 4528 Signed 8 RSACALFP Forward Pointer: Host Logical
Address of the first FRMTE on the
Cleared Global Available List.
11B8 4536 Signed 8 RSACALBP Backward Pointer: Host Logical
Address of the last FRMTE on the
Cleared Global Available List.
11C0 4544 Signed 8 RSACALCT Non-negative count of the total
number of FRMTEs on the Cleared
Global Available List.
11C8 4552 Address 8 RSACALUT Upper Threshold: Non-negative
target number of FRMTEs for the
background replenishment task to
have on the Cleared Global
Available List. Note: As
currently implemented, this field
can really only be a value that
can be represented with 31 bits.
00000020 RSAINITU 32 Initial, increment, and
decrement value for RSACALUT.
11D0 4560 Address 8 RSACALMT Middle Threshold: Non-negative
target number of FRMTEs for the
foreground replenishment task to
have on the Cleared Global
Available List. Note that we do
not want to fill to the Upper
Threshold in the foreground
because this might take too long
and we'd rather have the
replenishment done in the
background if possible. Note: As
currently implemented, this field
can really only be a value that
can be represented with 31 bits.
00000008 RSAINITM 8 Initial, increment, and
decrement value for RSACALMT.
11D8 4568 Address 8 RSACALLT Lower Threshold: Non-negative
number of FRMTEs on the Cleared
Global Available List below which
the Dispatcher must call a
foreground replenishment task
since the background task is not
being called frequently enough to
keep the list at a sufficient
level. Note: As currently
implemented, this field can
really only be a value that can
be represented with 31 bits.
00000004 RSAINITL 4 Initial, increment, and
decrement value for RSACALLT.
11E0 4576 Signed 8 RSACALLK (6) Spin-lock word to control access
to the Cleared Global Available
List.
1210 4624 Signed 4 RSARCLOK Word used to ensure the list
replenishment routine is only
invoked by the dispatcher on one
processor at a time. This ensures
only one of the background or
foreground replenishment tasks
are running at a time. This word
can be in any of the following
states as defined in HCPEQUAT:
DSPNOBFW - no work to do DSPFSCHD
- foreground scheduled DSPFACTV -
foreground active DSPBSCHD -
background scheduled DSPBACTV -
background active Serialized by
compare-and-swap
1214 4628 Signed 4 * Reserved for IBM use
End of Cleared Global Available List Data Area
| Global IBR Aging List section |
1218 4632 Signed 8 RSAAGESZ Current target size of the aging
list in frames. This is
externalized and subject to SET
AGELIST. This field is set by the
Frame Table manager inversely
proportional to the approach to
the LT.
1220 4640 Dbl-Word 8 RSAIAS Internal Age list size
1228 4648 Signed 2 RSAAGEPC Percent value used to compute the
aging list size (RSAAGESZ) as a
percentage of pageable storage.
The value is in thousandths.
Default is 2%.
122A 4650 Bitstring 1 RSAAGEFL Aging list flags with defaults
set
1... .... RSAAGEFX X'80' RSAAGEFX Aging list is a
fixed size.
.1.. .... RSARECLC X'40' RSARECLC Recalc fairness
values this DS
..1. .... RSAAGEEW X'20' RSAAGEEW Early writes
enabled (default).
122B 4651 Bitstring 1 RSAAGETS TS lock for serializing updates
to the aging list target size
RSAAGESZ and RSAAGEPC.
122C 4652 Signed 4 * Reserved for IBM use.
1230 4656 Dbl-Word 8 RSAAGUWH Head of unwritten section of
Aging List
1238 4664 Dbl-Word 8 RSAAGUWT Tail of unwritten section of
Aging List
1240 4672 Dbl-Word 8 RSAAGINC Count of frames on the aging list
1248 4680 Dbl-Word 8 RSAAGRCH Head of reclaimable section of
Aging List
1250 4688 Dbl-Word 8 RSAAGRCT Tail of reclaimable section of
Aging List
1258 4696 Signed 8 RSAAGINL (6) Spin lock that governs updates to
ASCCTAGLa2g/b2g
1288 4744 Dbl-Word 8 RSAEWNDD Number of frames on the Aging
List that need to be written they
are known to be changed
1290 4752 Dbl-Word 8 RSAEWRFO Number of frames on the Aging
List, above the early write ptr,
that are referenced-only and do
not need to be written
1298 4760 Signed 4 RSAEWCIF Number of changed frames that are
absent from the Aging List b/c
they are in flight for an "early
write
129C 4764 Signed 4 RSAEWRIF Number of ref'd-only frames
absent from the Aging List b/c
they are in flight for an "early
write
12A0 4768 Dbl-Word 8 RSAAGRdy Number of reclaimable frames
below the early write pointer.
This is a total value. The pages
may or may not have been
rewritten.
12A8 4776 Dbl-Word 8 RSAReclaimHT Target size of the reclaimable
section.
12B0 4784 Dbl-Word 8 RSAReclaimLT Trigger writes when reclaimable
section falls below this value.
12B8 4792 Dbl-Word 8 RSAAGRdyRefNw Number of reclaimable frames
below the early write ptr whose
pages were referenced-only and
not written.
12C0 4800 Dbl-Word 8 RSAAGRdyRefWrt Number of reclaimable frames
below the early write ptr whose
pages were referenced-only and
written for load balancing.
12C8 4808 Signed 4 RSANXTSC VMDBK to resume scanning at
12CC 4812 Signed 4 * Reserved for IBM use.
12D0 4816 Address 4 RSADSFHD DSFBK head; zero if DSFBK list is
empty; head DSFBK.DSFBPNT will be
0.
12D4 4820 Address 4 RSADSFTL DSFBK tail; zero if DSFBK list is
empty; tail DSFBK.DSFFPNT will be
0.
12D8 4824 Address 4 RSADSFCR DSFBK cursor. If Demand Scan
active, this is the DSFBK
currently in use. If Demand Scan
is not active, this is the next
DSFBK to be used. If Demand Scan
never started, or if all DSFBKs
have been removed, this pointer
is zero.
12DC 4828 Address 4 RSADSFBK DSFBK bank. Push down stack of
unused DSFBKs using DSFFPNT,
terminated with a pointer value
of all FFs.
12E0 4832 Signed 2 RSADSFCT Count of preallocated DSFBKs
12E2 4834 Signed 2 RSADSUCT Count of preallocated DSUBKs per
DSFBK.
000012D0 RSADSIHD RSADSFHD
000012D4 RSADSITL RSADSFTL
000012D8 RSADSICR RSADSFCR
000012DC RSADSIBK RSADSFBK
000012E0 RSADSICT RSADSFCT
12E4 4836 Signed 2 * Reserved for IBM use.
12E6 4838 Signed 2 RSADSORD Demand Scan ordinal count
12E8 4840 Signed 4 RSAAGDFC Deficit: The number of frames by
which HCPALDTA came up short when
handling a request; increased by
HCPALDTA, decreased by HCPALDIR;
when non-zero, HCPALDIR will send
frames directly to frame manager
rather than putting them on Aging
List reclaimable section
12EC 4844 Signed 4 RSADSCyclicRestart
MI number of times Demand Scan
couldn't follow the global cyclic
list and had to restart from the
SYSTEM VMDBK
12F0 4848 Address 8 RSAAGLRL Address of last lock releaser.
12F8 4856 Address 8 * Reserved for IBM use
1300 4864 Address 8 * Reserved for IBM use
| Anti-Aliasing data area |
NOTES : When HCPISGTP decides that the storage configuration
supports anti-aliasing it will turn on RSAAAON,
initialize RSAAAPFX to be the top half megabyte of
lowest online range of storage, and set RSAAASXS to
the value to use for SYSSXSSZ. When RSAAAON is set
frame table and SXSTB initialization will use the
alternate origins specified in RSAAAFTO and RSAAASTO,
respectively.
1308 4872 Signed 4 RSAAAFLG (0) Anti-aliasing status flags
1308 4872 Bitstring 3 * RESERVED
130B 4875 Bitstring 1 RSAAASTA Anti-Aliasing status
1... .... RSAAAON X'80' RSAAAON ON = Anti-aliasing
is active
130C 4876 Signed 4 RSAAAPFX Alternate processor PFXPG table
origin when using anti-aliasing.
1310 4880 Dbl-Word 8 RSAAASXS (0) Anti-aliasing SYSSXSSZ value.
1310 4880 Bitstring 8 * DEFAULT VALUE TO USE WHEN
ANTI-ALIASING IS ON, AND
SYSGTORS=8G-1 OR SYSGTORS=2G-1,
AND SYSSXSSZ WAS NOT REDUCED BY
USE OF A REGULATOR RANGE.
1318 4888 Dbl-Word 8 RSAAAFTO (0) Frame Table Origin when using
1318 4888 Bitstring 8 * ANTI-ALIASING. (5G-112M)
1320 4896 Dbl-Word 8 RSAAASTO (0) SXSTB Origin when using
1320 4896 Bitstring 8 * ANTI-ALIASING. (2T+1G-32M)
| Emergency PGMBK allocation section |
NOTES :
If HCPPPIGF attempts to obtain a PGMBK but fails
too many times, an emergency PGMBK will be allocated
from this queue.
1328 4904 Dbl-Word 8 * (0) Alignment
1328 4904 Bitstring 1 RSAemTS Test-and-Set controls access to
these next fields
1329 4905 Bitstring 1 RSAemFL Emergency PGMBK pool flags
.... 1... RSAemRP X'08' RSAemRP Replenishment
required
132A 4906 Bitstring 1 * (2) Reserved for IBM use
132C 4908 Signed 4 RSAemERG Count of all attempts to get an
emergency PGMBK, including when
the pool was empty. May wrap.
1330 4912 Address 8 RSAemFMT A(FRMTE that starts the queue)
1338 4920 Signed 4 RSAemCPc Count of emergency PGMBKs. Number
of frames is equal to RSAemCPc *
2
133C 4924 Signed 4 RSAemDFR Count of deferrals of guests. May
wrap.
1340 4928 Signed 4 RSAemBLO Count of times when the pool
dipped below RSAemLO. May wrap.
1344 4932 Signed 4 RSAemPTY Count of times the pool was
empty. May wrap.
1348 4936 Address 4 RSAemCPq A(deferred CPEBK queue)
134C 4940 Address 4 RSAemRPT A(replenishment task CPEBK)
End of fields controlled by RSAemTS.
1350 4944 Signed 4 RSAemLO Lo threshold. Updated only under
the VARY PROCESSOR lock. Computed
value is PGMBKperPROC * #online
processors
1354 4948 Signed 4 RSAemHI Hi threshold. Updated only under
the VARY PROCESSOR lock.
| Demand Scan Steal Counts: |
All of the fields in this section are cumulative counters
and are serialized by RSADSLOK, except where noted.
1358 4952 Signed 8 RSADSTmAct Amount of time (in TOD units)
demand scan was running.
1360 4960 Signed 4 RSAChgWrtOld Changed pgs written to old slot.
1364 4964 Signed 4 RSAChgWrtNew Changed pgs written to new slot.
1368 4968 Signed 4 RSARefWrtBypass
Ref-only pgs not rewritten.
136C 4972 Signed 4 RSARefWrtNew Ref-only pgs rewritten for load
balancing.
1370 4976 Signed 4 RSAAGReclm Frames reclaimed.
1374 4980 Signed 4 RSAPgQHi High water mark for paging queue
backlog. Serialized by CS. Zeroed
by Monitor at each sample.
1378 4984 Signed 4 RSAPgOvr Times a paging overrun detected.
137C 4988 Signed 4 RSAExMet Times demand scan exited because
need met.
1380 4992 Signed 4 RSAExTim Times demand scan exited because
it exceeded time limit.
1384 4996 Signed 4 RSAExCPU Times demand scan exited because
it was running on suboptimal CPU.
1388 5000 Signed 4 * Reserved for IBM use.
138C 5004 Signed 4 RSAInvUFO UFO pages invalidated.
1390 5008 Signed 4 RSAInvVUFO VUFO (private VDisk) pages
invalidated.
1394 5012 Signed 4 RSAInvSUFO SUFO pages invalidated.
1398 5016 Signed 4 RSARvlUFO UFO pages revalidated. Serialized
by CS.
139C 5020 Signed 4 RSARvlVUFO VUFO (private VDisk) pages
revalidated. Serialized by CS.
13A0 5024 Signed 4 RSARvlSUFO SUFO pages revalidated.
Serialized by CS.
13A4 5028 Signed 4 RSARvlAGL Aging List pages revalidated.
Serialized by RSAAGINL.
13A8 5032 Signed 4 RSAWrtOnDmd Frames reclaimed immediately
after page content written to
aux. Serialized by RSAAGINL.
13AC 5036 Signed 4 RSADSCycle Complete iterations through -
VUFO - Adjuncts - MDC, VMLAN, and
relocation - SUFO - Global Cyclic
List
13B0 5040 Signed 4 RSAUsrVisit Count of users visited and one or
more pages were made IBR.
13B4 5044 Signed 4 RSAUsrSkip Count of users skipped because of
serialization or SET RESERVED.
13B8 5048 Signed 4 RSAAGRvlRefNw Ref-only pgs revalidated without
first being rewritten.
13BC 5052 Signed 4 RSAAGRvlRefWrt Ref-only pgs revalidated after
being rewritten.
13C0 5056 Signed 4 RSAAGRvlChgNw Changed pgs revalidated without
first being rewritten.
13C4 5060 Signed 4 RSAAGRvlChgWrt Changed pgs revalidated after
being rewritten.
In most cases when a frame reaches the bottom of the Aging
List it can be immediately reclaimed. However, situations
arise where this is not the case. Each of the following
RSAALSKx counters identify a situation preventing reclaim.
13C8 5064 Signed 4 RSAALSKL Frames that were locked/pinned.
13CC 5068 Signed 4 RSAALSKF Frames for which frame
serialization could not be
obtained.
13D0 5072 Signed 4 RSAALSKP Frames for which page
serialization could not be
obtained.
13D4 5076 Signed 4 RSAALSKR Frames requeued because of SET
RESERVED setting.
13D8 5080 Signed 4 RSARVHST Glbl revalidation historical rate
13DC 5084 Signed 4 RSAIVHST Glbl invalidation historical rate
13E0 5088 Signed 4 RSARVCT Glbl recent revalidation count
13E4 5092 Signed 4 RSAIVCT Glbl recent invalidation count
| Available List Floor Constants |
13E8 5096 Signed 4 RSAAVLFT <2G Singles list Floor
13EC 5100 Signed 4 RSAAVCFT <2G Contigs list Floor
13F0 5104 Signed 4 RSAAVLFG >2G Singles list Floor
13F4 5108 Signed 4 RSAAVCFG >2G Contigs list Floor
| Demand Scan 'unsatisfied' counts |
13F8 5112 Signed 4 RSADSCD0 <2G Singles unsatisfied count
13FC 5116 Signed 4 RSADSCDG >2G Singles unsatisfied count
1400 5120 Signed 4 * Reserved for IBM use.
1404 5124 Signed 4 * Reserved for IBM use.
1408 5128 Signed 4 * Reserved for IBM use.
140C 5132 Signed 4 * Reserved for IBM use.
1410 5136 Signed 4 * Reserved for IBM use.
1414 5140 Signed 4 RSMStatWord (0)
Paging system status word
1414 5140 Bitstring 1 RSMPSTATB1 Paging system status byte 1
1... .... RSMPGTHR X'80' RSMPGTHR Paging throttle
indicator
1415 5141 Bitstring 3 *
1418 5144 Signed 4 * (4) Reserved for IBM use.
| PGMBK Steal Performance Indicators |
Updates to these fields are serialized by RSADSLOK.
1428 5160 Dbl-Word 8 RSAVGPST Average time spent (in TOD units)
in PGMBK Steal per PGMBK
| SXS status flag bits |
1188 4488 Bitstring 5 * Reserved
118D 4493 Bitstring 1 RSASXINI SXSPM initialization flags.
1... .... RSASXIMX X'80' RSASXIMX When set indicates
the maximum available, backed
page queue size values are set to
values used during
initialization. The values get
reset after seeing SYSSINIT is
off.
118E 4494 Bitstring 1 RSASXREP SXSPM queue replenishment flags
1... .... RSASXRPF X'80' RSASXRPF Replenishment
failed to steal any aliases the
last time it ran.
.1.. .... RSASXRPL X'40' RSASXRPL Replenishment
stole less aliases than
replenishment amt (RSASXQRA)
118F 4495 Bitstring 1 RSASXPQS Potentially stealable queue
status bits
1... .... RSASXNST X'80' ON = SX Page Mgr is
prohibited from using the
stealable queue (RSASXPAN) for
anything other than free storage.
Turned on by HCPSXPFS only
| Frame Table Extent Block data: |
We wish to verify that
1) the FTXBKs that we allocate here inside the RSMBK
are of the correct size, and
2) the COPY and the PLXCOPY versions of the RSMBK match.
Since most modules do not include HCPFTXBK, the equate
FTXSIZE generally will not be defined. If it is not
defined yet, we will define it here so that search
engines can find it here.
- If it is defined already, that means HCPFTXBK has been
included, so the CKMAINT will perform a true test.
- If HCPFTXBK is included later, then the compile will
get a "duplicate definition" error and the order of
includes will need to be fixed.
- If the FTXBK control block is changed, this CKMAINT
check will fail, so this COPY file will need to be
fixed, which should lead one to fix the PLXCOPY file
as well.
00000008 FTXSIZE 8 FTXBK is 8 dwords
The following two pre-allocated FTXBKs are mapped by the
FTXBK DSECT in HCPFTXBK COPY and must be kept consistent if
changes are made to either HCPRSMBK or HCPFTXBK.
1430 5168 Dbl-Word 8 RSAFTXBL (0)
1430 5168 Dbl-Word 8 * (8)
1430 5168 Address 4 * Next FTXBK address
1434 5172 Address 4 * Previous FTXBK address
1438 5176 Address 4 * Global "next" chain
1470 5232 Dbl-Word 8 RSAFTXBG (0)
1470 5232 Dbl-Word 8 * (8)
1470 5232 Address 4 * Next FTXBK address
1474 5236 Address 4 * Previous FTXBK address
1478 5240 Address 4 * Global "next" chain
14B0 5296 Signed 8 * (2) Reserved for IBM
End of Frame Table Extent Block data
| QDIO fields |
14C0 5312 Address 8 RSAAGLKS Reserved for IBM use
14C8 5320 Address 8 RSAAGLKE Reserved for IBM use
14D0 5328 Address 8 RSAFOBSL FOB Supply List anchor
14D8 5336 Address 8 RSAFOBRL FOB Release List anchor
14E0 5344 Address 4 RSATGTSK A(TG task CPEBK)
14E4 5348 Signed 4 RSAFOBCT Count of FCP Operation Blocks
(FOBs) that are currently in the
system. This includes all FOBs
that are on processor local
available lists as well as those
that are currently in use.
14E8 5352 Signed 4 RSAFOBGC Count of FOBs on Global Lists
14EC 5356 Signed 4 RSAFOBGH High threshold for FOBs on Global
Lists
14F0 5360 Signed 4 RSAFOBGZ Count of Global Pool gone empty
14F4 5364 Bitstring 1 RSAFOBLK Lock for FOB Supply List
14F5 5365 Bitstring 1 RSAFOBTK HCPFOB tasks started? X'FF' means
'yes'
14F6 5366 Bitstring 1 * RESERVED FOR IBM USE
14F7 5367 Bitstring 1 * RESERVED FOR IBM USE
| Fields for reserved frame counts |
| |
| Notes : |
| - The fields in this section along with the reserved |
| frame setting in the VMDBK (VMDMXRVP) are serialized |
| with the RSARSDLK. |
| - Either RSARSDLK or the applicable global SNTBK lock |
| is sufficient to run an RSDBK chain (NSUSGQLK for |
| RSARSDDC and NSUSYQLK for RSARSDNS). However, both |
| a share of the global SNTBK lock AND exclusive access |
| to RSARSDLK are needed to update any RSDBK in the |
| chain. This ensures the state of the NSS or DCSS |
| does not change while the RSDBK is being manipulated. |
| - No serialization is required to read RSARSVPG |
| or RSARSDMX (for example, by Monitor). |
14F8 5368 Dbl-Word 8 RSARSDLK (3) Reserved frames defer lock.
1510 5392 Signed 4 RSARSVSS Total count of frames reserved
for NSSs and DCSSs only.
1514 5396 Signed 4 RSARSVPG Total count of frames reserved
for users, NSSs, and DCSSs.
1518 5400 Signed 8 RSARSDMX Maximum number of frames that can
be reserved as specified on the
STORAGE RESERVED SYSMAX config
statement or via the SET RESERVED
SYSMAX command.
1520 5408 Signed 4 RSARSDDC Chain of RSDBKs containing the
reserved frame settings for DCSSs
that are not loaded.
1524 5412 Signed 4 RSARSDNS Chain of RSDBKs containing the
reserved frame settings for NSSs
that are not loaded.
| Managed Buffer Set Circular Linked List |
| This anchor (RSAFMBBK) is serialized by the spin lock |
| RSAMBSLK. This lock also serializes the fields MBBNEXT |
| and MBBPREV in each HCPMBBK that is part of this |
| circular linked list, since these fields are the next |
| and back pointers for this list's elements. |
| This circular linked list is managed by the module |
| HCPMBS. |
1528 5416 Address 4 RSAFMBBK Anchor to the Managed Buffer Set
circular linked list.
152C 5420 Bitstring 1 RSAMBSLK Managed Buffer Set spin lock. It
serializes RSAFMBBK; it also
serializes the MBBNEXT and
MBBPREV fields of the HCPMBBKs
that are part of this list.
152D 5421 Bitstring 3 * Reserved for IBM
| Managed Frame Request Circular Linked List. |
| This anchor (RSAFRQCR) is serialized by the spin lock |
| RSAFRQLK. This lock also serializes the fields FRQNEXT |
| and FRQPREV in each HCPFRQBK that is part of this |
| circular linked list, since these fields are the next |
| and back pointers for this list's elements. |
| This circular linked list is managed by the module |
| HCPFRQ. |
1530 5424 Address 4 RSAFRQCR Pointer to current frame request
being serviced by HCPFRQ.
1534 5428 Bitstring 1 RSAFRQLK HCPFRQBK queue mgmt spin lock. It
serializes RSAFRQCR; it also
serializes the FRQNEXT and
FRQPREV fields of the HCPFRQBKs
that are part of this list.
1535 5429 Bitstring 1 RSAFRQAA HCPFRQAA task active indicator
X'FF' means 'active'
1536 5430 Bitstring 2 * Reserved for IBM
1538 5432 Address 8 RSAFRQFF Address of 1st frame on list
1540 5440 Address 8 RSAFRQLF Address of last frame on list
1548 5448 Signed 4 RSAFRQCT Count of frames on list for
current FRQBK
154C 5452 Signed 4 RSAFRQND Count of frames still needed for
current FRQBK
1550 5456 Signed 4 RSAFRQAC Count of frames needed for ALL
FRQBKs (for RAS)
1554 5460 Signed 4 RSAFRQDS Cumulative count of frames that
FRQDS released during demand scan
1558 5464 Signed 4 RSAFRQFS Cumulative count of times
HCPFRQFS was called
155C 5468 Signed 4 RSAFRQSV SVGBK address used when taking
desperate measures to avoid
FRF002
| Live Guest Relocation Global Values |
1560 5472 Signed 8 RSACPTRG Initial value of changed pages
threshold used to determine when
to discontinue the pre-quiesce
memory passes. This value is
stored in RLOCPTRG prior to
memory move. RLOCPTRG is
re-evaluated and updated by
HCPRLSCM after several memory
move passes have been made.
1568 5480 Signed 4 RSAMXPAS Maximum number of pre-quiesce
memory passes. This value is
stored in RLOMXPAS prior to
memory move. The number of
pre-quiesce memory passes may
actually be much less that this
value due to the algorithms in
HCPRLSCM for limiting passes if
substantial progress in reaching
the changed page threshold
(RLOCPTRG) is not being made or
if the the threshold is reached.
156C 5484 Signed 4 RSASNDMX Maximum number of outstanding
sends allowed before the memory
move send task delays. This value
is stored in RLOSNDMX prior to
memory move. The delay prevents
the memory move task from getting
too far ahead of the ISFC
communication link.
1570 5488 Signed 4 RSARMMAX The maximum number of memory move
messages awaiting recovery before
the send task delays. This value
is stored in RLORMMAX prior to
memory move. The delay allows the
outstanding Recover_Message tasks
to run.
1574 5492 Signed 4 RSATSLMF Value used in computation to
determine whether to open a
window to allow other CP tasks to
run. It is used by the LGR PGMBK
walker and the destination side
receive loop. This value is
multiplied with the dispatch
minor time slice and then
compared against time elapsed
since a window was last opened.
Generic TLB/ALB Purge DAT Table Aging List area
The Generic TLB/ALB Purge DAT Table Aging List (GTPAL for
short) is for blocks previously used as DAT tables which
cannot be returned for reuse until all real processors
have purged their TLBs and ALBs.
The blocks are either 2K blocks from absolute aligned
free, or 1-4 frames from HCPGETFR.
This is a doubly linked circular list that includes the
header, but the forward and backward pointers of the
blocks are non-standard.
See the AGINBLK DSECT in HCPHRU for details of the
queueing and timestamp and type representation within the
aging blocks on the queue.
All fields from here down to RSAGTPLK are serialized by
RSAGTPLK.
1578 5496 Address 8 RSAGTPAF Aging list forward pointer,
64-bit host absolute address of
the first block on the chain.
Initialized to point to its own
header (empty)
1580 5504 Address 8 RSAGTPAB Aging list backward pointer,
64-bit host absolute address of
the last block on the chain.
Initialized to point to its own
header (empty)
1588 5512 Signed 4 RSAGTPAC Count of blocks on queue (total)
Note these next 5 counts must be
kept in order in their respective
positions, as they are maintained
by indexing based on the number
of frames in the block (or 0 for
a page table).
158C 5516 Signed 4 RSAGTPAP Count of 2048 byte page tables
(from AFR) on queue
1590 5520 Signed 4 RSAGTPA1 Count of single frames on queue
1594 5524 Signed 4 RSAGTPA2 Count of 2 frame sets on queue
1598 5528 Signed 4 RSAGTPA3 Count of 3 frame sets on queue
159C 5532 Signed 4 RSAGTPA4 Count of 4 frame sets on queue
15A0 5536 Signed 4 RSAGTPLK Aging queue lock This is an
informal spin lock. RSAGTPLK is
set to the address obtaining the
lock. When free, its value is
zero. Use Compare-and-Swap to
update.
15A4 5540 Signed 4 * Reserved for IBM use
Frame table chain pointers
15A8 5544 Address 8 RSAFTOFTE Host real addr of FRMTE for frame
used for first frame table page.
15B0 5552 Address 8 RSASTOFTE Host real addr of FRMTE for frame
used for first SXS table page.
15B8 5560 Signed 4 RSAFTCKS Checksum for FRMTEs on the
RSAFTOFTE chain.
15BC 5564 Signed 4 RSASTCKS Checksum for FRMTEs on the
RSASTOFTE chain.
Stand-alone dump crashkernel memory allocation info.
The SAD crashkernel memory is allocated during system
initialization, and will not span across the 2G line.
Only one of RSACKMB2G or RSACKMA2G will be non-zero.
For more information about the Stand-alone dump
crashkernel memory see HCPDMO.
15C0 5568 Address 8 RSACKMEM Absolute address of crashkernel
memory used for stand-alone dump
when allocated; otherwise 0. This
field is only updated during
system initialization.
00008000 RSACKMSZ 32768 The number of contiguous
frames allocated for stand-alone
dump crashkernel memory. This
number specifies the size of
crashkernel memory required by
the currently supported version
of stand-alone dump.
15C8 5576 Signed 4 RSACKMB2G Count of CP frames below 2G
allocated as stand-alone dump
crashkernel memory. The count is
not included in RSADPACP. This
field is only updated during
system initialization. (Maintain
MRMTRMEM)
15CC 5580 Signed 4 RSACKMA2G Count of CP frames above 2G
allocated as stand-alone dump
crashkernel memory. The count is
not included in RSADPACP. This
field is only updated during
system initialization. (Maintain
MRMTRMEM)
Start of RSM Dynamic Memory Upgrade work area
This area will be used to accumulate the changes to be
applied once all the new frames, lists, counts, and
whatever else is affected by the SET STORAGE command
have been prepared.
Definitions for fields that are not part of the
real RSMBK common area
15D0 5584 Signed 8 rsaPFXFTLEN Length of frame table
15D8 5592 Signed 8 rsaPFXSTLEN SXSTB size
15E0 5600 Bitstring 1 rsaPFXGPFLG General purpose flag PFX2GU -
usable storage exists >2G
(flag)
15E1 5601 Bitstring 1 rsaVMDLOWW0 work bit VMDINI2G - >2G frame
initialization required
15E2 5602 Bitstring 6 * Reserved for IBM
15E8 5608 Signed 8 rsaSYSGTORS - new SYSGTORS
15F0 5616 Signed 8 rsaSYSSXSSZ - new SYSSXSSZ
15F8 5624 Signed 8 * - Reserved for IBM use.
1600 5632 Signed 4 rsaSYSTORS - new SYSTORS
1604 5636 Signed 4 * - Reserved for IBM use.
Delta-Pinned-Page-Count Array
- DPPA for page class 1
- accumulated system pin counts
Delta-Pinned-Page-Count Array (DPPCA) for page class 1
Used by both hardware and software to maintain pinned
page counts for page class 1 pages. Page class 1 is
used for NSS/DCSS imbedded shared pages. This array
is pointed to by the class 1
Delta-Pinned-Page-Count-Array Origin in the prefix
area, PFXDPPCAO. The page class 0 array is used for
base address space pages owned by the user and
resides in the virtual configuration's base ASCBK.
System total Pinned-Page-Count page class 0 B2G
System total Pinned-Page-Count page class 0 A2G
Accumulated by HCPLALRU at pin count roll-up
System total Pinned-Page-Count page class 1 B2G
System total Pinned-Page-Count page class 1 A2G
Accumulated by HCPLALRU at pin count roll-up
1608 5640 Dbl-Word 8 RSADPPCA (0) Delta-pinned-page count array
1608 5640 Signed 4 RSADPPB Delta-pinned-page count for all
class 1 pages pinned below 2G
160C 5644 Signed 4 RSADPPA Delta-pinned-page count for all
class 1 pages pinned at or above
2G
1610 5648 Signed 8 RSApin0B System total class 0 B2G
1618 5656 Signed 8 RSApin0A System total class 0 A2G
1620 5664 Signed 8 RSApin1B System total class 1 B2G
1628 5672 Signed 8 RSApin1A System total class 1 A2G
1630 5680 Signed 8 RSAPINW PCIe pinned count warning limit
1638 5688 Signed 8 RSAPINF PCIe pinned count fail limit
1640 5696 Signed 8 * Reserved for IBM
1648 5704 Signed 8 RSAAGCHW RSAAGINC high water mark; ser'd
by Aging List lock
Paging / Demand Scan handshaking fields - current as of the
most recent paging I/O completion (serialized by CPVOL
list lock)
?? Should dequeue / redrive update as well??
?? Calculated before or after dq/rd??
1650 5712 Signed 4 RSAPgAvlMWBwd Available paging MW bandwidth -
the number of additional page
writes that can be started before
write bandwidth "fills up",
according to existing MW queue
lengths and the HCPSMOWF tuning
factor
1654 5716 Signed 4 RSAPgTotQS Total queued single reads&writes
on active paging volumes
1658 5720 Signed 4 RSAPgTotQMR Total queued MultiReads on active
paging volumes
165C 5724 Signed 4 RSAPgTotQMW Total queued MultiWrites on
active paging volumes
Throttle counts
1660 5728 Signed 4 RSAwrThrots Count of times write throttling
affected decisions
1664 5732 Signed 4 RSAdmThrots Count of times demand throttling
affected decisions
1668 5736 Dbl-Word 8 * (0)
1668 5736 Bitstring 128 RSAIOAT IO ADDRESS TABLE work area
These fields are added here at the end
to maintain offsets once a customer has
received code for the release.
16E8 5864 Signed 8 RSAftcounts (0)
4 half word counts of frame table
scans. The only permissible use
of this field should be a test
for zero vs. nonzero.
16E8 5864 Signed 2 RSAsftANY Number of frame table scans
active for a singles frame above
or below 2G.
16EA 5866 Signed 2 RSAsftB2G Number of frame table scans
active for a singles frame below
2G only.
16EC 5868 Signed 2 RSAcftANY Number of frame table scans
active for a contigs frame above
or below 2G.
16EE 5870 Signed 2 RSAcftB2G Number of frame table scans
active for a contigs frame below
2G only.
16F0 5872 Signed 4 RSAprThrots Count of times a partial write
throttle occurred because the
need was limited by bandwidth
End of RSM common area
000002DF RSASZD (*-RSMBK+7)/8 Size in D-words
| Define a local DSECT that maps a "managed" queue. |
| It is used for the following queues. |
| RSAAvailAncB2Gs - Below 2G singles available list. |
| RSAAvailAncB2Gc - Below 2G contigs available list. |
| RSAAvailAncA2Gs - Above 2G singles available list. |
| RSAAvailAncA2Gc - Above 2G contigs available list. |
| This facilitates logic when manipulating the lists. |
Hex Dec Type/Val Lng Label (dup) Comments
---- ---- --------- ---- -------------- --------
0000 0 Structure RSAMQAnc RSM common area mapping
The following fields, down to the lock
are serialized by the lock.
0000 0 Address 8 RSAMQFP Forward pointer. Points to self
when empty.
0008 8 Address 8 RSAMQBP Backward pointer. Points to
forward pointer when empty.
0010 16 Signed 8 RSAMQCnt Count of things on the queue.
Zero when empty. Logical count of
frames that are currently on the
available list. This field is
initialized during system
initialization.
0018 24 Signed 8 RSAMQMIReq MI Count of requests.
0020 32 Signed 8 RSAMQMIRet MI Count of returns.
0028 40 Signed 8 RSAMQMIRep MI Count of replens.
0030 48 Signed 8 RSAMQMIOF MI Count of FRMTES orphaned from
0038 56 Signed 8 RSAMQMIOT MI Count of FRMTES orphaned to
0040 64 Signed 8 RSAMQUnfilled Number of unfulfilled requests.
0048 72 Signed 4 RSAMQLWM Low water mark of count. Reset by
threshold manager.)
004C 76 Signed 4 * (0) Serialized flag. (Serialized by
RSAMQLck.)
004C 76 Bitstring 1 RSAMQSFG1 Serialized flag 1.
1... .... RSAMQStats X'80' RSAMQStats Must call the
stats routine.
004D 77 Bitstring 1 RSAMQTFg Threshold flag. Serialization
note: Bits are set holding the
RSAMQLck. However: Byte may be
zeroed, unserialized. (Use OI/NI
to turn bits on and off with the
lock held, but keep in mind, it
could be set to zero.) Bits
marked with * are always turned
on/off/zeroed with lock held.
(Only in lists with actual
thresholds, see (?)
1... .... RSAMQSeeLT X'80' When considering lowering
the low
.1.. .... RSAMQSeeHT X'40' When considering raising
the low
..1. .... RSAMQHTSeen X'20' *The process to decrement
has
...1 .... RSAMQDSSeen X'10' *The process to decrement
continues
.... 1... RSAMQDSESeen X'08' *The process to decrement
continues
.... .1.. RSAMQHTT2 X'04' T2 saw HT.
.... ..11 RSAMQJB X'03' Jouney Begins
004E 78 Bitstring 1 RSAMQCH Count high by this much.
004F 79 Bitstring 1 * Reserved for IBM use
0050 80 Signed 8 RSAMQLck (6) Queue lock. This lock is obtained
& released via macros HCPLKAV and
HCPULAV.
0080 128 Signed 4 RSAMQISG The "initial value" set by ISG.
RAS only. Begin fields that are
serialized by holding the
RSAMQTLck.
0084 132 Signed 4 RSAMQLT Queue low threshold. Indicates
when a replenishment task should
be invoked providing a buffer for
the system until more things
become available. If CNT=LT then
no replenishment is needed.
0088 136 Signed 4 RSAMQHT Queue high threshold. Indicates
when a replenishment task can or
should stop. If CNT=HT
replenishment can stop.
008C 140 Signed 4 RSAMQPT Protected Threshold. For contigs
avail queues: Pageable singles
will not be taken at/below this
value. For singles avail queues:
no meaning. (maybe for SPXtape)
Theory-This should not be less
than HT if a PGMBK steal function
could be making PGMBKs. No sense
doing all that work just to have
a single request break it up.
0090 144 Signed 4 RSAMQIncZ Number of times LT incremented
because CNT hit zero.
0094 148 Signed 4 RSAMQIncCnt Number of times LT incremented
because CNT got to close to zero.
0098 152 Signed 4 RSAMQDecCNT Number of times LT decremented
because CNT didn't get close
enough to zero.
009C 156 Signed 4 RSAMQLTGood Number of times LT found good End
fields that are serialized by
holding the RSAMQTLck.
00A0 160 Signed 4 RSAMQCSFlg (0) 4 compare and swap flag bytes.
00A0 160 Bitstring 1 RSAMQdsc Description flag (Never changes)
1... .... RSAIsA2G X'80' RSAIsA2G Anchor holds
frames >2G
.1.. .... RSAIsContig X'40' RSAIsContig Anchor holds
contigs
.... ...1 RSAIsDMUWork X'01' RSAIsDMUWork This Anchor is
in the DMU work RSMBK.
00A1 161 Bitstring 1 RSAMQTLck TS lock that gives you permission
to update RSAMQLT,RSAMQHT,RSAMQPT
and to do a STC on RSAMQTFg.
00A2 162 Bitstring 1 * Reserved for IBM use
00A3 163 Bitstring 1 * Reserved for IBM use
00A4 164 Address 4 RSAMQRepRoutine
Replenishment routine. Not used
at the moment. BKT
00A8 168 Signed 8 RSAMQdbg currently low water mark since
last time thresholds adjusted.
00B0 176 Signed 8 RSAMQQstats (15)
Statistics for requests.
0128 296 Signed 8 RSAMQTstats (15)
Statistics for returns.
01A0 416 Signed 8 RSAMQPstats (15)
Statistics for replenishme
0218 536 Signed 8 RSAMQOTstats (15)
Statistics for Orphan To
0290 656 Signed 8 RSAMQOFstats (2)
Statistics for Orphan From
00000308 RSAMQAncBS *-RSAMQFP Length of an Anchor.
BKT Reviewer, point out hard
coded constants :-)
Define a local DSECT that maps the stats in the managed
queues.
Notes : This DSECT is used significantly in macros. For
this reason, they do HCPUSINGS. If an HCPUSING is used
in code, it should not be done over associated macros.
Serialization. Some fields are serialized by the
Available list lock (ALL) and some fields are serialized
by the RSAALUST TS lock (ALU).
| |