IBM: FSATE

Programming Interface Information: This information is NOT intended to be
used as Programming Interfaces of VM/ESA. It is to be used for diagnosis only.

FSATE

Prolog

Control Block Contents

FSATE DSECT

Storage Layout

Cross Reference (Contains links to field and bit definitions)

FSATE Prolog

 NAME       : HCPFSATE
 DESCRIPTION: FIXED STORAGE ASSIGNMENT TABLE ENTRY
 DSECT      : FSATE
 FUNCTION   : THE FSATE DESCRIBES FIXED STORAGE
              IN THE V=R REGION ASSIGNED TO A SINGLE USER.
 LOCATED BY :
         HCPWRKFA  ANCHOR FOR FIXED STORAGE ASSIGNMENT TABLE  *
         RSASA1ST  FIELD OF HCPRSAMP CONTAINS OFFSET          *
                   TO AN FSATE WITH THE LOWEST MAIN           *
                   STORAGE ORIGIN                             *
         RSASALST  FIELD OF HCPRSAMP CONTAINS OFFSET          *
                   TO AN FSATE WITH THE HIGHEST MAIN          *
                   STORAGE ORIGIN                             *
         FSAFOFF   FIELD OF HCPFSATE CONTAINS OFFSET          *
                   TO AN FSATE WITH THE NEXT HIGHER MAIN      *
                   STORAGE ORIGIN                             *
         FSABOFF   FIELD OF HCPFSATE CONTAINS OFFSET          *
                   TO AN FSATE WITH THE NEXT LOWER MAIN       *
                   STORAGE ORIGIN
 CREATED BY :
              THE FIXED STORAGE ASSIGNMENT TABLE IS PERMANENTLY
              ALLOCATED AS PART OF THE RESIDENT NUCLEUS.  IT
              IS LOCATED IN THE HCPWRK MODULE AND IS NOT REFRESHED
              ACROSS A SOFTWARE RE-IPL.
 DELETED BY : NONE
 NOTES      : THE TABLE CONTAINS ENTRIES WHICH DEPICT HOW THE V=R REGION
              IS DIVIDED AND ASSIGNED TO V=R AND V=F USERS.

FSATE Control Block Content


FSATE DSECT
Hex   Dec Type/Val   Lng Label (dup)    Comments
---- ---- --------- ---- -------------- --------
0000    0 Structure      FSATE          FIXED STORAGE ASSIGNMENT TABLE
                                        ENTRY
     ENTRY
0000    0 Dbl-Word     8 FSAENTRY (0)   FSATE ORIGIN
0000    0 Character    8 FSAUSRID       USERID OF THE USER OF THE
                                        ASSIGNED STORAGE
0008    8 Address      4 FSAVMD         ADDRESS OF THE BASE VMDBK OF THE
                                        ASSIGNED STORAGE
000C   12 Signed       2 FSAMSO         MAIN STORAGE ORIGIN OF THE
                                        ASSIGNED STORAGE
000E   14 Signed       2 FSAMSL         MAIN STORAGE LIMIT OF THE
                                        ASSIGNED STORAGE
0010   16 Signed       2 FSAFOFF        OFFSET TO THE FSATE WITH THE NEXT
                                        HIGHER MSO ASSIGNED.
0012   18 Signed       2 FSABOFF        OFFSET TO THE FSATE WITH THE NEXT
                                        LOWER MSO ASSIGNED.
0014   20 Signed       2 FSASTAT (0)    TABLE ENTRY STATUS
0014   20 Bitstring    1 FSASTB0        TABLE ENTRY STATUS BYTE 0
          1... ....      FSAALLOC       X'80' TABLE ENTRY IS ALLOCATED
          .1.. ....      FSARESRV       X'40' TABLE ENTRY IS RESERVED
          ..1. ....      FSALFOVR       X'20' TABLE ENTRY WAS USED PRIOR
                                        TO LAST SOFTWARE RE-IPL
          ...1 ....      FSAVALID       X'10' TABLE ENTRY IS VALID. A
                                        VALID TABLE ENTRY IS ONE THAT
                                        EITHER IS OR MAY BE ALLOCATED TO
                                        A V=R OR V=F GUEST.
0015   21 Bitstring    3 *              RESERVED FOR FUTURE IBM USE
0018   24 Dbl-Word     8 *              RESERVED FOR FUTURE IBM USE
          00000020       FSALENTH       *-FSAENTRY LENGTH OF ONE TABLE
                                        ENTRY
0020   32 Signed       4 FSANEXT (0)    NEXT TABLE ENTRY
          00000008       FSAMAXZN       8 MAXIMUM NUMBER OF ZONES
                                        SUPPORTED
          00000100       FSATBLEN       FSAMAXZN*FSALENTH LENGTH OF FIXED
                                        STORAGE ASSIGNMENT TABLE IN BYTES
          00000020       FSATBSIZ       (FSATBLEN+7)/8 SIZE OF FIXED
                                        STORAGE ASSIGNMENT TABLE IN
                                        DBLWRDS
          00000005       FSAIDXSH       5 SHIFT INDEX FOR OBTAINING FSATE
                                        OFFSETS
     The following macro invocation is to ensure that no CHANGES ARE MADE TO
     THE SIZE OF THIS CONTROL BLOCK WITHOUT PAYING ATTENTION TO THIS BLOCK
     COMMENT.
     THE FSAIDXSH EQUATE IS USED TO FORM FSATE OFFSETS BY SHIFTING ZONE
     NUMBERS. THIS WAY OF FORMING FSATE OFFSETS DEPENDS ON THE SIZE OF THE
     FSATE BLOCK BEING A POWER OF 2.
     IF THIS CONTROL BLOCK SIZE SHOULD CHANGE, THE FSAIDXSH MUST ALSO
     CHANGE, SO LONG AS THE NEW SIZE IS A POWER OF 2. IF NOT, ALL USES OF
     FSAIDXSH MUST BE CHANGED TO FORM FSATE OFFSETS BY MULTIPLYING ZONE
     NUMBER BY THE FSATE CONTROL BLOCK LENGTH.
0020   32 Address      4 * (0)          ) IEV075 will result if FSALENTH
                                        NE 32 @P3714FM

FSATE Storage Layout

*** FSATE - FIXED STORAGE ASSIGNMENT TABLE ENTRY
*
*     +-------------------------------------------------------+
*   0 |                       FSAUSRID                        |
*     +---------------------------+-------------+-------------+
*   8 |          FSAVMD           |   FSAMSO    |   FSAMSL    |
*     +-------------+-------------+------+------+-------------+
*  10 |  FSAFOFF    |  FSABOFF    |:STB0 |////////////////////|
*     +-------------+-------------+------+--------------------+
*  18 |///////////////////////////////////////////////////////|
*     +-------------------------------------------------------+
*  20
*
*** FSATE - FIXED STORAGE ASSIGNMENT TABLE ENTRY