|
Programming Interface Information:
This information is NOT intended to be used as Programming Interfaces of z/VM. |
RSMBK
Control Block Contents
RSMBK DSECT
RSMANCHR DSECT
Cross Reference (Contains links to field and bit definitions)
RSMBK Prolog
NAME : HCPRSMBK
DESCRIPTION: RSM common area mapping
DSECT : RSMBK and RSMANCHR
FUNCTION : Map the Real Storage Management Data Area located
in the data module HCPRSM that contains anchors,
locks and counts for Real Storage Management data.
LOCATED BY : HCPRSMCM RSM Common Area
HCPRSMFR Free storage VMDBK chain anchor and count
HCPRSMPR Free storage PERSYS chain anchor and count
HCPRSMSV Free storage SYSTEM chain anchor and count
CREATED BY : System IPL (HCPLOD)
DELETED BY : Never deleted. Reinitialized with next system IPL.
RSMBK Control Block Content
RSMBK DSECT
Hex Dec Type/Val Lng Label (dup) Comments
---- ---- --------- ---- -------------- --------
0000 0 Structure RSMBK RSM common area mapping
Real Storage Management Common Data Area. Located by HCPRSMCM.
0000 0 Signed 4 RSASAVFR Non-negative count of frames in
use by the save area manager.
Compare-and-Swap to update.
System-identity space information
0004 4 Signed 4 RSAIDSTD STD (or half-ASCE in ESAME build)
for the system-identity space
which identity maps all real
storage below 2G. In the 390
build, also used to designate the
system-execution space.
0008 8 Address 4 RSAIDAST ASTE for the system-identity
space which identity maps all
real storage below 2G.
000C 12 Address 4 RSARSAST 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) ESAME
image only
0010 16 Dbl-Word 8 RSALRFA (0) Queue of frames that are waiting
release plus a lock word.
0010 16 Signed 4 RSALRFQ HCPLRFBK queue, any frame found
to be locked during release
processing will have a block on
this queue pointing to it. This
field points to the first such
block and is '0' if there are
none.
0014 20 Signed 4 RSALRFLK RSALRFQ's lock. This lock must be
held when changing the RSALRFQ
field. This lock is set to the
address obtaining the lock when
it is obtained, and is '0'
otherwise.
0018 24 Signed 4 RSAMSARC Count of machine storage areas
(MSA) below the highest sysgen
frame (RSASTORE)
001C 28 Signed 4 RSAMSASC Count of machine storage areas
(MSA) below the highest sysgen
frame (RSASTORE) or addressable
frame (SYSTORS) whichever is
lower
0020 32 Signed 4 RSAMSARH Count of machine storage areas
(MSA) above the highest sysgen
frame (RSASTORE)
0024 36 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.
0028 40 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.
002C 44 Signed 4 RSASTORE Real machine actual storage size
below 2G. Calculated during
system init.
This area contains information regarding the use or non-use of host
storage above the 2G line. All fields serialized by >= 2G available
list lock-RSA2GLCK except where noted otherwise.
0030 48 Signed 4 RSATASKB Task active bits. C/S to update.
0030 48 Bitstring 1 RSATSKB0 Task bits 0- 7
0031 49 Bitstring 1 RSATSKB1 Task bits 8-15
0032 50 Bitstring 1 RSATSKB2 Task bits 16-23
0033 51 Bitstring 1 RSATSKB3 Task bits 24-31
.... ...1 RSA2GTSK X'01' Indicates low priority
>= 2G frame initialization
task is active.
0034 52 Signed 4 * Reserved for IBM use
0038 56 Signed 8 RSAFNOTI Count of FRMTEs marked 'not
init'. This is the number of
FRMTEs which have not yet been
checked to see if they are
usable.
0040 64 Signed 8 RSALGFRM Count of usable frames >= 2G.
0048 72 Signed 8 RSAGOFFL Count of offline frames >= 2G.
0050 80 Signed 8 RSAGSTOR Actual storage size -1 including
storage >= 2G. This is not
exact until testing of large real
storage has ended. Unlike
SYSGTORS, this value is not
capped.
0058 88 Signed 8 RSASTORL Highest real host storage addr.
This is uncapped. Calculated from
SCLP storage data or Diagnose.
This value is not adjusted.
0060 96 Address 8 RSALG1ST Address of first FRMTE for frames
>= 2G. This address is above
any offline frames at the 2G
line. It does not skip 'not-init'
frames.
0068 104 Address 8 RSALGLST Address of last FRMTE for frames
>= 2G. This address is below
any offline frames at the high
end of storage. It does not skip
'not-init' frames.
0070 112 Address 8 RSANOTIB Address of FRMTE for the lowest
frame >= 2G marked 'not-init'.
If greater than RSALGLST then all
frames >= 2G are initialized
and RSAGSTOR is accurate.
0078 120 Signed 8 RSA2GLCK (3) >= 2G available list lock.
This lock is obtained & released
via macros HCPLK2GA and HCPUL2GA.
0090 144 Address 8 RSA2GAHD >= 2G available list lock
queue header. Points to a FRMTE.
0098 152 Address 8 * Reserved for IBM use
00A0 160 Signed 8 RSA2GAVL Count of frames on the >= 2G
available list.
00A8 168 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.
00C0 192 Dbl-Word 8 RSAASITB (16) 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.
0140 320 Address 4 RSADPPFW Deferred PGMBK paging list (DPPL)
forward pointer
0144 324 Address 4 RSADPPBW Deferred PGMBK paging list (DPPL)
backward pointer
0148 328 Address 4 RSAPPAFW Paged PGMBK aging list (PPAL)
forward pointer. PPAL is actually
a list of PGMBKs and DAT frames.
014C 332 Address 4 RSAPPABW Paged PGMBK aging list (PPAL)
backward pointer.
0150 336 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, the PPAL, or the misc free
storage aging queue. 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.)
0154 340 Signed 4 RSAAFSDW Count of doublewords of aligned
free storage. 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.
0158 344 Signed 4 RSAAFSIU Count of doublewords of aligned
free storage in use. This count
includes only the active aligned
free storage blocks. This count
is updated using Compare-and-Swap
logic.
015C 348 Signed 4 RSAVCBDW Count of doublewords of
verifiable control block free
storage. This 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.
0160 352 Signed 4 RSAVCBIU Count of doublewords of
verifiable control block free
storage in use. This count
includes only the active
verifiable control block free
storage blocks. This count is
updated using Compare-and-Swap
logic.
0164 356 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.
0168 360 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.
016C 364 Signed 4 RSANALD ALD for "null" access list
0170 368 Dbl-Word 8 RSANASIT 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 STD (390) / ASCE (ESAME)
is guaranteed to designate a
segment table with STL of 1,
indicating that the segment table
is two segment table units in
length (128 bytes in 390, 2 pages
= 8K in ESAME).
0178 376 Address 4 RSANDUCT Address of "null" dispatchable-
unit control table (DUCT).
017C 380 Address 4 RSASHRSP Anchor for chain of shareable
address spaces. Chain is
serialized by RSASHRLK.
0180 384 Dbl-Word 8 RSAMFSAA Miscellaneous free storage aging
queue anchor. Locked by RSAPPTLK.
Items on this queue are free
storage blocks which like DAT
tables must be aged before reuse.
End of queue is a zero pointer.
ESAME image only
0188 392 Dbl-Word 8 RSASHRLK (3) A shared/exclusive defer lock
serializing the RSASHRSP chain.
01A0 416 Dbl-Word 8 RSASPMLK (3) A shared/exclusive defer lock
serializing all SPIBK chains
system-wide.
01B8 440 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.
01D0 464 Signed 4 RSACTSHR Global count of shared address
space resident frames
01D4 468 Signed 4 * Reserved for IBM use
01D8 472 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:
01F0 496 Signed 4 RSACPLOK Integer non-negative exact count
of frames that are locked by the
CP LOCK command (FRMCPLOK). This
count is updated using
Compare-and-Swap logic.
01F4 500 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.
01F8 504 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.
01FC 508 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.
0200 512 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.
The following field belongs up above with the PPAL header field
definitions RSAPPAFW and RSAPPABW.
0204 516 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.
Available list data:
0208 520 Dbl-Word 8 RSAAVLAN (0) Available list data area with
forward and backward pointers to
the standard list of available 4K
frames, a backward pointer for
the list of available 16K blocks
(for IFSNT allocation requests)
and the three doubleword area for
the available list spin lock.
This area is initialized during
system initialization and updated
only when the available list lock
is held.
0208 520 Address 4 RSAAVLFP Available list forward ptr
020C 524 Address 4 RSAAVLBP Available list backward ptr
0210 528 Dbl-Word 8 RSAAVLLK (3) Available list spin lock
0228 552 Address 4 RSA16KBP Backward pointer to list of
available 16K blocks. They are
chained via the backward pointer
in the FRMTE for the last frame
in each 16K block
022C 556 Signed 4 * Reserved for IBM use
0230 560 Dbl-Word 8 RSAFRQAN (0) Frame request defer anchor
0230 560 Address 4 RSAFRQFP Forward pointer
0234 564 Address 4 RSAFRQBP Backward pointer
0238 568 Signed 4 RSA2GDCT Count of deferred frame requests
that are waiting for any
available frame. This plus
RSAFRQWT is the total wait count.
(ESAME only, not used in ESA/390)
023C 572 Signed 4 * Reserved for IBM use
0240 576 Signed 4 RSA2GRDA Count of times HCPPTGRD attempted
to redrive tasks waiting for any
available frame (>= 2G or
<2G) (ESAME only, not used in
ESA/390)
0244 580 Signed 4 RSA2GRDC Count of individual task redrives
performed by HCPPTGRD for any
available frame (>= 2G or
<2G) (ESAME only, not used in
ESA/390)
0248 584 Signed 4 RSAAVAIL Non-negative count of frames that
are currently on the < 2G
frames available list. This field
is initialized during system
initialization and updated only
when the available list lock is
held.
024C 588 Signed 4 * (0) These fields are grouped together
024C 588 Signed 4 RSAFRQWT Non-negative count of deferred
requests for real frames which
have not yet been satisfied since
there are no frames available.
Requests are for frames < 2G.
Also see RSA2GDCT. Update by
holding the available list spin
lock.
0250 592 Signed 4 RSAFRRDA Count of HCPPTGRD attempts to
redrive tasks waiting for frames
below 2G. Update by holding the
available list spin lock.
0254 596 Signed 4 RSAFRRDC Count of individual task redrives
performed by HCPPTGRD for frames
below 2G. Update by holding the
available list spin lock.
Available list replenishment (steal) data:
0258 600 Dbl-Word 8 * (0)
0258 600 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.
0258 600 Bitstring 1 RSARFLOK TS lock to prevent triggering of
multiple concurrent steal tasks
0259 601 Bitstring 3 RSADSCPU When non-zero, indicates a CPU is
running the Steal task
025C 604 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.
025D 605 Bitstring 3 * Reserved for IBM use
0260 608 Dbl-Word 8 * (0) Available list high threshold
which indicates how many frames
should be taken by the available
list replenishment functions to
satisfy the current user and
system needs for frames. These
fields are updated with
Compare-and-Swap logic.
0260 608 Signed 4 RSAAVLHT < 2G avbl list high threshold
0264 612 Signed 4 RSAAVLHG >= 2G avbl list high threshold
0268 616 Signed 4 * (2) Reserved for IBM use
0270 624 Dbl-Word 8 * (0) Available list low threshold
(which indicates when the demand
scan should be invoked providing
a buffer for the system until
more frames become available),
the decrement count (which says
how many times the demand scan
has run since the low threshold
was last checked for
decrementing. It wasn't
decremented if it was recently
incremented.), and the decrement
flag (which is on when the
threshold was not incremented
recently and may be decremented).
These fields are updated with
Compare-and-Swap logic except at
initialization time. The count
and flag fields are used to
determine whether or not to
decrement the low threshold in
this run of the demand scan.
0270 624 Signed 4 RSAAVLLT Available list low threshold for
frames < 2G
0274 628 Signed 4 RSADECCT Decrement low threshold count for
frames < 2G
0278 632 Signed 4 RSADECCS (0) DECREMENT FLAG COMP. & SWAP WORD
0278 632 Bitstring 2 * Reserved for IBM use
027A 634 Bitstring 1 RSADECFG Decrement low threshold flag for
frames >= 2G (ESAME only, not
used in ESA/390)
00000000 RSADECNG X'00' Flag is off, don't
decrement the low threshold until
flag goes on
00000001 RSADECGY X'01' Flag is on, the >=2G low
threshold may now be decremented
027B 635 Bitstring 1 RSADECFL Decrement low threshold flag for
frames < 2G
00000000 RSADECNO X'00' Flag is off, don't
decrement the low threshold until
flag goes on (low threshold was
recently incremented)
00000001 RSADECYS X'01' Flag is on, the low
threshold may not be decremented
027C 636 Signed 4 RSAAVLLG >=2G available list low
threshold (ESAME only, not used
in ESA/390)
0280 640 Signed 4 RSADECCG Decrement >=2G low threshold
count (ESAME only, not used in
ESA/390)
0284 644 Signed 4 * (3) Reserved for IBM use
0290 656 Dbl-Word 8 * (0)
0290 656 Signed 4 RSASTLWT Count of available list
replenishment page writes (steal
writes) for < 2G frames. This
count is updated using
Compare-and-Swap logic.
0294 660 Signed 4 RSASWG2G Count of available list
replenishment page writes (steal
writes) for >= 2G frames
(ESAME only, not used in ESA/390)
0298 664 Signed 4 * (2) Reserved for IBM use
Reset interval data area:
02A0 672 Dbl-Word 8 RSARINTA (8) Reset interval data and work area
02A0 672 Address 4 RSARESLK Reset interval data area lock
This field is updated using
Compare-and-Swap logic.
02A4 676 Signed 4 * Reserved for IBM use
02A8 680 Signed 4 RSAALLTA Total number of frames taken by
the available list replenishment
functions since System IPL. This
count is updated using
Compare-and-Swap logic.
02AC 684 Signed 4 RSAAVGDU Average number of users in the
dispatch list (samples taken by
HCPALURS). This count is updated
only when the reset interval data
area lock (RSARESLK) is held.
02B0 688 Signed 4 RSAAVGRT Average number of frames taken by
the available list replenishment
functions per second. This count
is updated only when the reset
interval data area lock
(RSARESLK) is held.
02B4 692 Signed 4 RSAOLDTA Total number of frames taken by
the available list replenishment
functions at the time of the last
reset interval calculation. This
count is updated only when the
reset interval data area lock
(RSARESLK) is held.
02B8 696 Dbl-Word 8 * (0)
02B8 696 Signed 8 RSAOLDTD TOD at the time of the last reset
interval calculation. This count
is updated only when the reset
interval data area lock
(RSARESLK) is held.
02C0 704 Dbl-Word 8 * (0)
02C0 704 Signed 8 RSARESSA Reset interval for shared address
spaces in TOD units This count is
updated only when the reset
interval data area lock
(RSARESLK) is held or at
initialization time.
02C8 712 Dbl-Word 8 * (3) Reserved for IBM use
Free storage data:
02E0 736 Signed 4 RSAFSTOR Non-negative count of doublewords
of system free storage. Count
includes the number of double-
words of free storage available
as well as in use but does not
include any V=R free storage.
This count is updated only when
the Compare-and-Swap lock
FRESTOLK in HCPFRE is held or at
initialization time.
02E4 740 Signed 4 RSAFSYUD Non-negative count of doublewords
of system free storage in use
(not including V=R free storage).
This count is updated with
Compare-and-Swap logic or at
initialization time.
02E8 744 Signed 4 RSAFVMUD Count of doublewords of non-V=R
VMDBK free storage in use.
Allocated from VMDBKs, VMDBK free
storage frames, and system free
storage frames. This count does
not include the storage allocated
from the free storage subpools or
from V=R area. This count is
updated only when holding FSDVMLK
formal spin lock.
02EC 748 Signed 4 RSAVMXFR Count of frames in use for VMDBK
free storage, i.e., user free
frames allocated. This count does
not include the VMDBKs
themselves. This count is updated
only when holding FSDVMLK formal
spin lock.
02F0 752 Signed 4 RSAVMXUD Count of user free storage
doublewords in use (allocated
from VMDBK free storage frames).
This count does not include
storage in the VMDBKs themselves.
This count is updated only when
holding FSDVMLK formal spin lock.
02F4 756 Signed 4 RSASYSFR Count of frames in use for system
free storage. This count is
updated only when holding FSDVMLK
formal spin lock.
02F8 760 Signed 4 RSASYSUD Count of system free storage
doublewords in use, allocated
from system free storage chain.
This count is updated with
Compare-and-Swap logic.
02FC 764 Signed 4 RSAXFREE Count of frames allocated for
free storage. This count is
updated with Compare-and-Swap
logic.
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.
0300 768 Dbl-Word 8 * (0) 5 word long area on dword bdy
0300 768 Signed 4 RSALIM1 Free storage threshold 1 (WRNG)
0304 772 Signed 4 RSALIM2 Free storage threshold 2 (STOP)
0308 776 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.
030C 780 Signed 4 RSALMFUZ Free storage threshold fuzz
0310 784 Signed 4 RSALIMCS (0) Free storage limits Compare-and-
Swap word
0310 784 Bitstring 3 * Reserved for IBM use
0313 787 Bitstring 1 RSALIMCK Free storage limit detection flag
00000000 RSALIMOF X'00' Free storage limit
detection off
00000001 RSALIMON X'01' Free storage limit
detection on
V=R free storage data area:
0314 788 Signed 4 RSARECHW Recovery area high water mark.
Approximate address of the
highest storage used in the V=R
recovery area. If the difference
between this address and the
address of the end of the
recovery area is > 64K, you
probably want to decrease the
size of the recovery area by the
difference minus 64K. This
address is approximate since it's
not serialized. It may be updated
simultaneously by any number of
processors. If it is updated
simultaneously, it will be less
than the exact address of the
highest byte used. This address
will correct itself on the next
non-simultaneous update.
0318 792 Signed 4 RSAVRSPR Count of V=R subpool releases. If
this count is greater than 0, you
probably want to increase the
size of the V=R recovery area.
This count is approximate since
it's not serialized. It may be
updated simultaneously by any
number of processors. If it is
updated simultaneously, it will
be less than the exact number of
V=R subpool releases. If it is
zero, it is exact.
031C 796 Signed 4 RSAFVRUD Non-negative count of doublewords
of V=R free storage in use. This
count is updated with
Compare-and-Swap logic.
Free storage reserved frames data area:
0320 800 Dbl-Word 8 * (0) This is the free storage reserved
frames data area consisting of a
count of unique extend requests
that have not been satisfied yet,
the free storage reserved frames
anchor, the free storage reserved
frames data area lock word, the
count of free storage reserved
frames required by the system,
and the number of free storage
reserved frames per processor.
Note: The number of free storage
reserved frames per processor
must be positive. Update while
holding the free storage reserved
frames data area Compare-and-Swap
lock word or during system
initialization.
0320 800 Signed 4 RSAXTEND Count of frames missing from the
free storage reserved frames list
i.e., count of unique extend
conditions not yet satisfied.
0324 804 Address 4 RSARESAN Reserved frames queue anchor
forward pointer
0328 808 Address 4 RSARSVLK Free storage reserved frames data
area Compare-and-Swap lock word
032C 812 Signed 4 RSARSVSY Total number of free storage
reserved frames required to be on
the reserved frames list
0330 816 Signed 4 RSAMAXPP Number of free storage reserved
frames required per processor.
Note: Field must be positive.
0334 820 Signed 4 * Reserved for IBM use
Segment translation data:
0338 824 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.
0338 824 Address 4 RSADEFAN Deferred segment translation
queue anchor forward pointer
033C 828 Address 4 RSADEFLK Compare-and-Swap lock. Zero means
the lock is not held.
0340 832 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.
0344 836 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=R region. 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=R region 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.
0348 840 Dbl-Word 8 RSAFSTBK (0) Fixed storage management block
0348 840 Dbl-Word 8 RSAFSLCK (3) Fixed storage mgmt lock (defer)
0360 864 Bitstring 2 RSASA1ST Offset of entry in the fixed
storage assignment table
containing the lowest main
storage origin
0362 866 Bitstring 2 RSASALST Offset of entry in the fixed
storage assignment table
containing the highest main
storage origin
0364 868 Signed 4 RSASTRNG (0) The entire storage range for the
V=R region. (Never changes)
0364 868 Signed 2 RSAMSO Bits 5-15 specify a 1 meg main
storage origin of the V=R region.
Main storage origin is the
address of the first byte, on a
megabyte boundary, of the V=R
region, shifted right 20 bits.
0366 870 Signed 2 RSAMSL Bits 5-15 specify a 1 meg main
storage limit of the V=R region.
Main storage limit is the address
of the last byte of the V=R
region, shifted right 20 bits.
0368 872 Bitstring 1 RSAAZNCT Count of zones available for
guest use, including zones in use
(never changes)
0369 873 Bitstring 1 RSAZPOOL Pool of available zones, not
including those in use
036A 874 Bitstring 2 * Reserved for IBM use
036C 876 Signed 4 * Reserved for IBM use
00000028 RSAFSTLN *-RSAFSTBK Length of FSTBK
00000028 RSAFSTSZ (*-RSAFSTBK+7/8) Size of FSTBK
Virtual storage management data:
0370 880 Dbl-Word 8 RSAVVBLK (0) Virtual Storage Management Block.
This area contains information
needed to manage the System
Virtual Address Space.
0370 880 Bitstring 4 * Reserved for IBM use
0374 884 Address 4 RSAVSLOW Lowest available virtual page. It
is initialized to the virtual
address of the last module in the
CP nucleus. Serialized by
Compare-and-Swap
Allocation of System Virtual Addresses above RSAVHSAD is serialized by
the High Storage Lock (RSAVHSLK).
0378 888 Dbl-Word 8 RSAVHSLK (3) High storage lock
0390 912 Bitstring 4 * Reserved
0394 916 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).
This section maps the three free frames anchors. Use EXTRNs
HCPRSMFR/HCPRSMSV/HCPRSMPR to locate them.
RSMANCHR DSECT
Hex Dec Type/Val Lng Label (dup) Comments
---- ---- --------- ---- -------------- --------
0000 0 Structure RSMANCHR RSM common area mapping
0000 0 Dbl-Word 8 * (0) HCPRSMFR, HCPRSMSV, and HCPRSMPR
are list anchors that contain the
address of the first FRMTE which
represents a free storage frame
with available space of the
appropriate type to be examine
when allocating or deallocating
VMDBK (Guestperm), System
(Sysperm), or Persistent System
(Persys) free storage,
respectively. The count of FRMTEs
on the list follows the anchor.
0000 0 Address 4 RSMFRCHN Anchor for FRMTE chain of free
storage frames with avbl space
0004 4 Signed 4 RSMFRCNT Count of FRMTEs chained on
RSMBK Storage Layout
*** RSMBK - RSM common area mapping
*
* +---------------------------+---------------------------+
* 0 | RSASAVFR | RSAIDSTD |
* +---------------------------+---------------------------+
* 8 | RSAIDAST | RSARSAST |
* +---------------------------+---------------------------+
* 10 | RSALRFQ | RSALRFLK |
* +---------------------------+---------------------------+
* 18 | RSAMSARC | RSAMSASC |
* +---------------------------+---------------------------+
* 20 | RSAMSARH | RSADPACP |
* +---------------------------+---------------------------+
* 28 | RSATRSAV | RSASTORE |
* +---------------------------+---------------------------+
* 30 | RSATASKB |///////////////////////////|
* +---------------------------+///////////////////////////|
* 38 |///////////////////////////////////////////////////////|
* =///////////////////////////////////////////////////////=
* |///////////////////////////////////////////////////////|
* +---------------------------+---------------------------+
* 2E0 | RSAFSTOR | RSAFSYUD |
* +---------------------------+---------------------------+
* 2E8 | RSAFVMUD | RSAVMXFR |
* +---------------------------+---------------------------+
* 2F0 | RSAVMXUD | RSASYSFR |
* +---------------------------+---------------------------+
* 2F8 | RSASYSUD | RSAXFREE |
* +---------------------------+---------------------------+
* 300 | RSALIM1 | RSALIM2 |
* +---------------------------+---------------------------+
* 308 | RSALIM3 | RSALMFUZ |
* +--------------------+------+---------------------------+
* 310 |////////////////////|:LIMCK| RSARECHW |
* +--------------------+------+---------------------------+
* 318 | RSAVRSPR | RSAFVRUD |
* +---------------------------+---------------------------+
* 320 | RSAXTEND | RSARESAN |
* +---------------------------+---------------------------+
* 328 | RSARSVLK | RSARSVSY |
* +---------------------------+---------------------------+
* 330 | RSAMAXPP |///////////////////////////|
* +---------------------------+---------------------------+
* 338 | RSADEFAN | RSADEFLK |
* +---------------------------+---------------------------+
* 340 | RSAPRQWT |///////////////////////////|
* +---------------------------+---------------------------+
* 348 | |
* = RSAFSLCK =
* | |
* +-------------+-------------+-------------+-------------+
* 360 | RSASA1ST | RSASALST | RSAMSO | RSAMSL |
* +------+------+-------------+-------------+-------------+
* 368 |:AZNCT|:ZPOOL|/////////////|///////////////////////////|
* +------+------+-------------+---------------------------+
* 370 |///////////////////////////| RSAVSLOW |
* +---------------------------+---------------------------+
* 378 | |
* = RSAVHSLK =
* | |
* +---------------------------+---------------------------+
* 390 |///////////////////////////| RSAVHSAD |
* +---------------------------+---------------------------+
* 398
*
*** RSMBK - RSM common area mapping
*** Overlay for RSATASKB in RSMBK
*
* +------+------+------+------+---------------------------+
* 30 |:TSKB0|:TSKB1|:TSKB2|:TSKB3|///////////////////////////|
* +------+------+------+------+---------------------------+
* 38 | RSAFNOTI |
* +-------------------------------------------------------+
* 40 | RSALGFRM |
* +-------------------------------------------------------+
* 48 | RSAGOFFL |
* +-------------------------------------------------------+
* 50 | RSAGSTOR |
* +-------------------------------------------------------+
* 58 | RSASTORL |
* +-------------------------------------------------------+
* 60 | RSALG1ST |
* +-------------------------------------------------------+
* 68 | RSALGLST |
* +-------------------------------------------------------+
* 70 | RSANOTIB |
* +-------------------------------------------------------+
* 78 | |
* = RSA2GLCK =
* | |
* +-------------------------------------------------------+
* 90 | RSA2GAHD |
* +-------------------------------------------------------+
* 98 |///////////////////////////////////////////////////////|
* +-------------------------------------------------------+
* A0 | RSA2GAVL |
* +-------------------------------------------------------+
* A8 | |
* = RSAPRLK =
* | |
* +-------------------------------------------------------+
* C0 | |
* = RSAASITB =
* | |
* +---------------------------+---------------------------+
* 140 | RSADPPFW | RSADPPBW |
* +---------------------------+---------------------------+
* 148 | RSAPPAFW | RSAPPABW |
* +---------------------------+---------------------------+
* 150 | RSAPPTLK | RSAAFSDW |
* +---------------------------+---------------------------+
* 158 | RSAAFSIU | RSAVCBDW |
* +---------------------------+---------------------------+
* 160 | RSAVCBIU | RSAVFSDW |
* +---------------------------+---------------------------+
* 168 | RSAVFSIU | RSANALD |
* +---------------------------+---------------------------+
* 170 | RSANASIT |
* +---------------------------+---------------------------+
* 178 | RSANDUCT | RSASHRSP |
* +---------------------------+---------------------------+
* 180 | RSAMFSAA |
* +-------------------------------------------------------+
* 188 | |
* = RSASHRLK =
* | |
* +-------------------------------------------------------+
* 1A0 | |
* = RSASPMLK =
* | |
* +-------------------------------------------------------+
* 1B8 | |
* = RSAALCIN =
* | |
* +---------------------------+---------------------------+
* 1D0 | RSACTSHR |///////////////////////////|
* +---------------------------+---------------------------+
* 1D8 | |
* = RSABLKGF =
* | |
* +---------------------------+---------------------------+
* 1F0 | RSACPLOK | RSAOFFLN |
* +---------------------------+---------------------------+
* 1F8 | RSASHARE | RSANONPG |
* +---------------------------+---------------------------+
* 200 | RSAPGABL | RSAPPAQD |
* +---------------------------+---------------------------+
* 208 | RSAAVLFP | RSAAVLBP |
* +---------------------------+---------------------------+
* 210 | |
* = RSAAVLLK =
* | |
* +---------------------------+---------------------------+
* 228 | RSA16KBP |///////////////////////////|
* +---------------------------+---------------------------+
* 230 | RSAFRQFP | RSAFRQBP |
* +---------------------------+---------------------------+
* 238 | RSA2GDCT |///////////////////////////|
* +---------------------------+---------------------------+
* 240 | RSA2GRDA | RSA2GRDC |
* +---------------------------+---------------------------+
* 248 | RSAAVAIL | RSAFRQWT |
* +---------------------------+---------------------------+
* 250 | RSAFRRDA | RSAFRRDC |
* +------+--------------------+------+--------------------+
* 258 |:RFLOK| RSADSCPU |:TRQLK|////////////////////|
* +------+--------------------+------+--------------------+
* 260 | RSAAVLHT | RSAAVLHG |
* +---------------------------+---------------------------+
* 268 |///////////////////////////////////////////////////////|
* +---------------------------+---------------------------+
* 270 | RSAAVLLT | RSADECCT |
* +-------------+------+------+---------------------------+
* 278 |/////////////|:DECFG|:DECFL| RSAAVLLG |
* +-------------+------+------+---------------------------+
* 280 | RSADECCG |///////////////////////////|
* +---------------------------+///////////////////////////|
* |///////////////////////////////////////////////////////|
* +---------------------------+---------------------------+
* 290 | RSASTLWT | RSASWG2G |
* +---------------------------+---------------------------+
* 298 |///////////////////////////////////////////////////////|
* +-------------------------------------------------------+
* 2A0 | |
* = RSARINTA =
* | |
* +-------------------------------------------------------+
* 2E0
*
*** Overlay for RSATASKB in RSMBK
*** Overlay for RSARINTA in RSMBK
*
* +---------------------------+---------------------------+
* 2A0 | RSARESLK |///////////////////////////|
* +---------------------------+---------------------------+
* 2A8 | RSAALLTA | RSAAVGDU |
* +---------------------------+---------------------------+
* 2B0 | RSAAVGRT | RSAOLDTA |
* +---------------------------+---------------------------+
* 2B8 | RSAOLDTD |
* +-------------------------------------------------------+
* 2C0 | RSARESSA |
* +-------------------------------------------------------+
* 2C8 |///////////////////////////////////////////////////////|
* =///////////////////////////////////////////////////////=
* |///////////////////////////////////////////////////////|
* +-------------------------------------------------------+
* 2E0
*
*** Overlay for RSARINTA in RSMBK
*** RSMANCHR - RSM common area mapping
*
* +---------------------------+---------------------------+
* 0 | RSMFRCHN | RSMFRCNT |
* +---------------------------+---------------------------+
* 8
*
*** RSMANCHR - RSM common area mapping
RSMBK Cross Reference
Symbol Dspl Value
-------------- ---- -----
RSAAFSDW 0154
RSAAFSIU 0158
RSAALCIN 01B8
RSAALLTA 02A8
RSAASITB 00C0
RSAAVAIL 0248
RSAAVGDU 02AC
RSAAVGRT 02B0
RSAAVLAN 0208
RSAAVLBP 020C
RSAAVLFP 0208
RSAAVLHG 0264
RSAAVLHT 0260
RSAAVLLG 027C
RSAAVLLK 0210
RSAAVLLT 0270
RSAAZNCT 0368
RSABLKGF 01D8
RSACPLOK 01F0
RSACTSHR 01D0
RSADECCG 0280
RSADECCS 0278
RSADECCT 0274
RSADECFG 027A
RSADECFL 027B
RSADECGY 027A 00000001
RSADECNG 027A 00000000
RSADECNO 027B 00000000
RSADECYS 027B 00000001
RSADEFAN 0338
RSADEFLK 033C
RSADPACP 0024
RSADPPBW 0144
RSADPPFW 0140
RSADSCPU 0259
RSADSLOK 0258
RSAFNOTI 0038
RSAFRQAN 0230
RSAFRQBP 0234
RSAFRQFP 0230
RSAFRQWT 024C
RSAFRRDA 0250
RSAFRRDC 0254
RSAFSLCK 0348
RSAFSTBK 0348
RSAFSTLN 036C 00000028
RSAFSTOR 02E0
RSAFSTSZ 036C 00000028
RSAFSYUD 02E4
RSAFVMUD 02E8
RSAFVRUD 031C
RSAGOFFL 0048
RSAGSTOR 0050
RSAIDAST 0008
RSAIDSTD 0004
RSALGFRM 0040
RSALGLST 0068
RSALG1ST 0060
RSALIMCK 0313
RSALIMCS 0310
RSALIMOF 0313 00000000
RSALIMON 0313 00000001
RSALIM1 0300
RSALIM2 0304
RSALIM3 0308
RSALMFUZ 030C
RSALRFA 0010
RSALRFLK 0014
RSALRFQ 0010
RSAMAXPP 0330
RSAMFSAA 0180
RSAMSARC 0018
RSAMSARH 0020
RSAMSASC 001C
RSAMSL 0366
RSAMSO 0364
RSANALD 016C
RSANASIT 0170
RSANDUCT 0178
RSANONPG 01FC
RSANOTIB 0070
RSAOFFLN 01F4
RSAOLDTA 02B4
RSAOLDTD 02B8
RSAPGABL 0200
RSAPPABW 014C
RSAPPAFW 0148
RSAPPAQD 0204
RSAPPTLK 0150
RSAPRLK 00A8
RSAPRQWT 0340
RSARECHW 0314
RSARESAN 0324
RSARESLK 02A0
RSARESSA 02C0
RSARFLOK 0258
RSARINTA 02A0
RSARSAST 000C
RSARSVLK 0328
RSARSVSY 032C
RSASALST 0362
RSASAVFR 0000
RSASA1ST 0360
RSASHARE 01F8
RSASHRLK 0188
RSASHRSP 017C
RSASPMLK 01A0
RSASTLWT 0290
RSASTORE 002C
RSASTORL 0058
RSASTRNG 0364
RSASWG2G 0294
RSASYSFR 02F4
RSASYSUD 02F8
RSATASKB 0030
RSATRQLK 025C
RSATRSAV 0028
RSATSKB0 0030
RSATSKB1 0031
RSATSKB2 0032
RSATSKB3 0033
RSAVCBDW 015C
RSAVCBIU 0160
RSAVFSDW 0164
RSAVFSIU 0168
RSAVHSAD 0394
RSAVHSLK 0378
RSAVMXFR 02EC
RSAVMXUD 02F0
RSAVRSPR 0318
RSAVSLOW 0374
RSAVVBLK 0370
RSAXFREE 02FC
RSAXTEND 0320
RSAZPOOL 0369
RSA16KBP 0228
RSA2GAHD 0090
RSA2GAVL 00A0
RSA2GDCT 0238
RSA2GLCK 0078
RSA2GRDA 0240
RSA2GRDC 0244
RSA2GTSK 0033 01
RSMFRCHN 0000
RSMFRCNT 0004
This information is
based on z/VM V4R4.0.
Last updated on 30 Jul 2003 at 13:10:08 EDT.
Copyright IBM Corporation, 1990, 2003