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

#### RSMBK

Prolog

Control Block Contents
RSMBK DSECT
RSMANCHR DSECT

Storage Layout

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 Signed       4 *              Reserved for IBM use in 390 image
    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 RSAPPTOD       PPAL time stamp for MDC frames
                                            This field is serialized by CDS.
                                            It must be updated only with
                                            increasingly later TOD values.
                                            ESA/390 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.
    0204  516 Signed       4 *              Reserved for IBM use
         | 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          |///////////////////////////|
    *     +---------------------------+---------------------------+
    *  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 |                       RSAPPTOD                        |
    *     +-------------------------------------------------------+
    * 188 |                                                       |
    *     =                       RSASHRLK                        =
    *     |                                                       |
    *     +-------------------------------------------------------+
    * 1A0 |                                                       |
    *     =                       RSASPMLK                        =
    *     |                                                       |
    *     +-------------------------------------------------------+
    * 1B8 |                                                       |
    *     =                       RSAALCIN                        =
    *     |                                                       |
    *     +---------------------------+---------------------------+
    * 1D0 |         RSACTSHR          |///////////////////////////|
    *     +---------------------------+---------------------------+
    * 1D8 |                                                       |
    *     =                       RSABLKGF                        =
    *     |                                                       |
    *     +---------------------------+---------------------------+
    * 1F0 |         RSACPLOK          |         RSAOFFLN          |
    *     +---------------------------+---------------------------+
    * 1F8 |         RSASHARE          |         RSANONPG          |
    *     +---------------------------+---------------------------+
    * 200 |         RSAPGABL          |///////////////////////////|
    *     +---------------------------+---------------------------+
    * 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
    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
    RSAPPTLK       0150
    RSAPPTOD       0180
    RSAPRLK        00A8
    RSAPRQWT       0340
    RSARECHW       0314
    RSARESAN       0324
    RSARESLK       02A0
    RSARESSA       02C0
    RSARFLOK       0258
    RSARINTA       02A0
    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 V4R3.0.
    Last updated on 30 Apr 2002 at 17:28:34 EDT.

    Copyright IBM Corporation, 1990, 2002