Programming Interface Information:
This information is NOT intended to be used as Programming Interfaces of z/VM. |
FSATE
Control Block Contents
FSATE DSECT
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
Copyright IBM Corporation, 1990, 2001