RSAQHDR | Back to Index page

| Prolog Control Block Contents RSAQHDR DSECT RSADefFRQ DSECT RSMANCHR DSECT RSAIOATD DSECT Storage Layout Cross Reference (Contains links to field and bit definitions) |
Programming Interface Information: This information is NOT intended to be used as Programming Interfaces of z/VM.

RSAQHDR Control Block Content | Top of page

     RSAQHDR DSECT
    Top of page

    Hex   Dec Type/Val   Lng Label (dup)    Comments
    ---- ---- --------- ---- -------------- --------
    0000    0 Structure      RSAQHDR        RSM common area mapping
    0000    0 Address      8 RSAQHDRFPNT    Forward pointer
    0008    8 Address      8 RSAQHDRBPNT    Backward pointer
    0010   16 Signed       4 RSAQHDRCNT     Count (4-byte)
         | Define a local DSECT that maps each of the               |
         | deferred frame request queues.                           |
         |                                                          |
         | For a description of the deferred frame request queues,  |
         | see the module prolog of HCPPTE.                         |
         |                                                          |
         | Notes      :  The lock and pointers for each of the three       |
         | deferred frame request queues are only addressable       |
         | via this DSECT (RSADefSP, RSADefPF and RSADefPL).        |
         | The counts are named individually so that they may       |
         | be "peeked at" without the corresponding lock            |
         | held, and collected by monitor without the lock          |
         | held.  The lock for the approprate deferred frame        |
         | request queue must be held to update the counts.         |

     RSADefFRQ DSECT
    Top of page

    Hex   Dec Type/Val   Lng Label (dup)    Comments
    ---- ---- --------- ---- -------------- --------
    0000    0 Structure      RSADefFRQ      RSM common area mapping
    0000    0 Signed       8 RSADefSP (6)   Spin lock.
    0030   48 Address      4 RSADefPF       Pointer to First CPEBK. Only
                                            valid if RSADefCT not 0. (Last
                                            task to dequeue does not modify.)
    0034   52 Address      4 RSADefPL       Pointer to Last CPEBK. Only valid
                                            if RSADefCT not 0. (Last task to
                                            dequeue does not modify.)
    0038   56 Signed       4 RSADefCT       Non-negative count of frame
                                            requests deferred on this frame
                                            request defer queue. Individually
                                            defined as:
    003C   60 Address      4 * (0)          Force a cross reference
    003C   60 Address      4 * (0)          Force a cross reference
    003C   60 Address      4 * (0)          Force a cross reference
         | This section maps the three free frames anchors.         |
         | Use EXTRNs HCPRSMFR/HCPRSMSV/HCPRSMPR to locate them.    |

     RSMANCHR DSECT
    Top of page

    Hex   Dec Type/Val   Lng Label (dup)    Comments
    ---- ---- --------- ---- -------------- --------
    0000    0 Structure      RSMANCHR       RSM common area mapping
    0000    0 Dbl-Word     8 * (0)          HCPRSMFR and HCPRSMSV are list
                                            anchors that contain the address
                                            of the first SXSTE which
                                            represents a free storage page
                                            with available space of the
                                            appropriate type to be examine
                                            when allocating or deallocating
                                            VMDBK (Guestperm), or System
                                            (Sysperm) free storage
                                            respectively. The count of SXSTEs
                                            on the list follows the anchor.
    0000    0 Address      8 RSMFRCHN       Host Logical Address Anchor for
                                            SXSTE chain of free storage
                                            frames with avbl space
    0008    8 Signed       8 RSMFRCNT       Count of FRMTEs on chain
           This section maps the IO Address Table (IOAT) subpool
           work area, located at RSAIOAT.
             +*********************************************----------+
          00 |RSAIOFBQ                                               |
             +*********************************************----------+
          08 |RSAIOLTH                                               |
             +*********************************************----------+
          10 |RSAIOUSD                                               |
             +*********************************************----------+
          18 |RSAIOFRE                                               |
             +*********************************************----------+
          20 |RSAIONFB                                               |
             +*********************************************----------+
          28 |RSAIOMAX                                               |
             +*********************************************----------+
          30 |RSAIOLOW                                               |
             +*********************************************----------+
          38 |RSAIOHIGH                                              |
             +***************------------+***************------------+
          40 |RSAIOSIZE (MB)             |RSAIOWRNP (%)              |
             +***************------------+***************------------+
          48 |RSAIOWARN                                              |
             +***************------------+***************------------+
          50 |RSAIOWRNC                  | RSAIOFALS                 |
             +***************------------+***************------------+
          58 |RSAIOFAIL                  | reserved                  |
             +***************------------+***************------------+
          60 |reserved                                               |
             +*********************************************----------+
          68 |RSAIOLOCK                                              |
             +*********************************************----------+
          70 |RSAIOLOCK continued                                    |
             +*********************************************----------+
          78 |RSAIOLOCK continued                                    |
             +*********************************************----------+

     RSAIOATD DSECT
    Top of page

    Hex   Dec Type/Val   Lng Label (dup)    Comments
    ---- ---- --------- ---- -------------- --------
    0000    0 Structure      RSAIOATD       RSM common area mapping
    0000    0 Address      8 RSAIOFBQ       HAA Address of first FBQE OR ZERO
    0008    8 Signed       8 RSAIOLTH       Anchor FBQE length - always 0
    0010   16 Signed       8 RSAIOUSD       Number of bytes currently used
    0018   24 Signed       8 RSAIOFRE       Number of bytes currently free
    0020   32 Signed       8 RSAIONFB       Current number of free blocks
    0028   40 Signed       8 RSAIOMAX       MAX number of bytes used
    0030   48 Signed       8 RSAIOLOW       Lowest address in subpool
    0038   56 Signed       8 RSAIOHIGH      Highest address in subpool
    0040   64 Signed       4 RSAIOSIZE      MB size of subpool from config
    0044   68 Signed       4 RSAIOWRNP      % warn from config
    0048   72 Signed       8 RSAIOWARN      Warning limit from config
    0050   80 Signed       4 RSAIOWRNC      Subpool warning count
    0054   84 Signed       4 RSAIOFALS      Subpool fail count
    0058   88 Signed       4 RSAIOFAIL      Subpool + avail list fail count
    005C   92 Signed       4 * (3)          reserved
    0068  104 Dbl-Word     8 RSAIOLCK (3)   PCI shadow table storage lock
              00000010       RSAIOATdw      (*-RSAIOATD+7)/8 RSAIOAT DW
                                            length
              00004000       RSAIOSTL       X'4000' Length of each getmain
              00000000       FBQADR         00,08,C'A' Address of next FBQE
                                            or zero
              00000008       FBQLTH         08,08,C'F' Length of current free
                                            area

RSAQHDR Storage Layout | Top of page

    *** RSAQHDR - RSM common area mapping
    *
    *     +-------------------------------------------------------+
    *   0 |                     RSAQHDRFPNT                       |
    *     +-------------------------------------------------------+
    *   8 |                     RSAQHDRBPNT                       |
    *     +---------------------------+---------------------------+
    *  10 |        RSAQHDRCNT         | 14
    *     +---------------------------+
    *
    *** RSAQHDR - RSM common area mapping

    *** RSADefFRQ - RSM common area mapping
    *
    *     +-------------------------------------------------------+
    *   0 |                                                       |
    *     =                       RSADEFSP                        =
    *     |                                                       |
    *     +---------------------------+---------------------------+
    *  30 |         RSADEFPF          |         RSADEFPL          |
    *     +---------------------------+---------------------------+
    *  38 |         RSADEFCT          | 3C
    *     +---------------------------+
    *
    *** RSADefFRQ - RSM common area mapping

    *** RSMANCHR - RSM common area mapping
    *
    *     +-------------------------------------------------------+
    *   0 |                       RSMFRCHN                        |
    *     +-------------------------------------------------------+
    *   8 |                       RSMFRCNT                        |
    *     +-------------------------------------------------------+
    *  10
    *
    *** RSMANCHR - RSM common area mapping

    *** RSAIOATD - RSM common area mapping
    *
    *     +-------------------------------------------------------+
    *   0 |                       RSAIOFBQ                        |
    *     +-------------------------------------------------------+
    *   8 |                       RSAIOLTH                        |
    *     +-------------------------------------------------------+
    *  10 |                       RSAIOUSD                        |
    *     +-------------------------------------------------------+
    *  18 |                       RSAIOFRE                        |
    *     +-------------------------------------------------------+
    *  20 |                       RSAIONFB                        |
    *     +-------------------------------------------------------+
    *  28 |                       RSAIOMAX                        |
    *     +-------------------------------------------------------+
    *  30 |                       RSAIOLOW                        |
    *     +-------------------------------------------------------+
    *  38 |                      RSAIOHIGH                        |
    *     +---------------------------+---------------------------+
    *  40 |        RSAIOSIZE          |        RSAIOWRNP          |
    *     +---------------------------+---------------------------+
    *  48 |                      RSAIOWARN                        |
    *     +---------------------------+---------------------------+
    *  50 |        RSAIOWRNC          |        RSAIOFALS          |
    *     +---------------------------+---------------------------+
    *  58 |        RSAIOFAIL          |///////////////////////////|
    *     +---------------------------+///////////////////////////|
    *     |///////////////////////////////////////////////////////|
    *     +-------------------------------------------------------+
    *  68 |                                                       |
    *     =                       RSAIOLCK                        =
    *     |                                                       |
    *     +-------------------------------------------------------+
    *  80
    *
    *** RSAIOATD - RSM common area mapping

RSAQHDR Cross Reference | Top of page

    Symbol         Dspl Value
    -------------- ---- -----
    FBQADR         0068 00000000
    FBQLTH         0068 00000008
    RSADefCT       0038
    RSADefPF       0030
    RSADefPL       0034
    RSADefSP       0000
    RSAIOATdw      0068 00000010
    RSAIOFAIL      0058
    RSAIOFALS      0054
    RSAIOFBQ       0000
    RSAIOFRE       0018
    RSAIOHIGH      0038
    RSAIOLCK       0068
    RSAIOLOW       0030
    RSAIOLTH       0008
    RSAIOMAX       0028
    RSAIONFB       0020
    RSAIOSIZE      0040
    RSAIOSTL       0068 00004000
    RSAIOUSD       0010
    RSAIOWARN      0048
    RSAIOWRNC      0050
    RSAIOWRNP      0044
    RSAQHDRBPNT    0008
    RSAQHDRCNT     0010
    RSAQHDRFPNT    0000
    RSMFRCHN       0000
    RSMFRCNT       0008

This information is based on z/VM 7.2.0 Last updated on 24 Jun 2020 at 09:30:12 EDT.
Copyright IBM Corporation, 1990, 2020