FSATE Back to Index page
 
Prolog 
Control Block Contents 
   FSATE 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.


  FSATE Prolog Top of page
 
 NAME       : HCPFSATE
 DESCRIPTION: FIXED STORAGE ASSIGNMENT TABLE ENTRY
 DSECT      : FSATE
 FUNCTION   : The FSATE describes fixed storage
              in the V=F Area 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
 RELOCATION CONSIDERATIONS : None
 NOTES      : The table contains entries which depict how the V=F area
              is divided and assigned to V=F users.
 
 
  FSATE Control Block Content Top of page
 

 FSATE DSECT Top of page
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' FSAALLOC TABLE ENTRY IS ALLOCATED .1.. .... FSARESRV X'40' FSARESRV TABLE ENTRY IS RESERVED ..1. .... FSALFOVR X'20' FSALFOVR TABLE ENTRY WAS USED PRIOR TO LAST SOFTWARE RE-IPL ...1 .... FSAVALID X'10' FSAVALID TABLE ENTRY IS VALID. A valid table entry is one that either is or may be allocated to a 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 FSAMAXZN MAXIMUM NUMBER OF ZONES SUPPORTED 0FSANEXT FSATBLEN FSAMAXZN*FSALENTH FSATBLEN 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 Top of page
 
          
*** 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 Top of page
 
 
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
 
This information is based on z/VM 7.2.0 Last updated on 24 Jun 2020 at 09:28:18 EDT.
Copyright IBM Corporation, 1990, 2020