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

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=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


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' 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

          
*** 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

This information is based on z/VM V6R2.0. Last updated on 21 Nov 2011 at 11:03:31 EDT.
Copyright IBM Corporation, 1990, 2011