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

This information is based on z/VM V5R2.0. Last updated on 12 Apr 2006 at 16:57:07 EDT.
Copyright IBM Corporation, 1990, 2005