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
          .... 1...      FSAMAXZN       8 MAXIMUM NUMBER OF ZONES
                                        SUPPORTED
          0FSANEXT       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.

FSATE Storage Layout

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

FSATE Cross Reference

Symbol         Dspl Value
-------------- ---- -----
FSAALLOC       0014 80
FSABOFF        0012
FSAENTRY       0000
FSAFOFF        0010
FSAIDXSH       0020 00000005
FSALENTH       0018 00000020
FSALFOVR       0014 20
FSAMAXZN       0020 08
FSAMSL         000E
FSAMSO         000C
FSANEXT        0020
FSARESRV       0014 40
FSASTAT        0014
FSASTB0        0014
FSATBLEN       0020 0FSANEXT
FSATBSIZ       0020 00000020
FSAUSRID       0000
FSAVALID       0014 10
FSAVMD         0008