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


  FSTSECT Prolog Top of page
  
 NAME       : FSTB
 DESCRIPTION: bilingual FSTB macro
 DSECT      : FSTSECT
 FUNCTION   : Creates a based structure, FSTSECT,
              which names all fields within a File Status
              Table Block. FSTSECT defines the file status
              table (FST) which describes the attributes of a
              file on a CMS virtual disk. FSTSECT is called
              by the macro FSTB.
 
 
  FSTSECT Control Block Content Top of page
  




 FSTSECT DSECT
Top of page


Hex   Dec Type/Val   Lng Label (dup)    Comments
---- ---- --------- ---- -------------- --------
0000    0 Structure      FSTSECT        bilingual FSTB macro
0000    0 Signed       4 * (0)
0000    0 Character   16 FSTNT (0)      Filename and file type
0000    0 Character    8 FSTN           FILE NAME
0008    8 Character    8 FSTT           FILE TYPE
          .... ....      FSTDIRN        00010 FSTN,16 Subdirectory name
0010   16 Signed       4 FSTD           DATE/TIME LAST WRITTEN
0014   20 Signed       2 FSTWP          WRITE POINTER (ITEM #)
0016   22 Signed       2 FSTRP          READ POINTER (ITEM #)
          ...1 ....      FSTBFOWN       00008 FSTD,8 Base file owner
0018   24 Signed       2 FSTM           File mode and mode number. Mode
                                        number will be blank for DIRs.
          00000018       FSTMCHAR       FSTM,1 File mode character
          00000019       FSTMNUM        FSTM+1,1 File mode number
001A   26 Signed       2 FSTIC          ITEM COUNT, zero for directories
          000FSTIC       FSTCDFMR       65533 FSTCDFMR maximum valid
                                        record number for CDF files
001C   28 Signed       2 FSTFCL         FIRST CHAIN LINK
          ...1 1.1.      FSTSCID        00004 FSTIC,4 Something Changed
                                        ID
001E   30 Character    1 FSTFV          Type of FST flag field
             FSTFV flag -byte definitions
          000000C6       FSTFVFIX       C'F' FIXED file FST
          000000E5       FSTFVVAR       C'V' VARIABLE file FST
          000000C4       FSTFVDIR       C'D' DIRECTORY FST
          00000060       FSTFVERS       C'-' Erased or revoked alias FST
001F   31 Bitstring    1 FSTFB          Flag byte (if used)
             "FSTFB" FLAG-BYTE DEFINITIONS
             (APPLICABLE ONLY TO "STATEFST" COPY OF FST-ENTRY
             AFTER SUCCESSFUL "STATE" OR "STATEW" CALL.)
          .... ....      FSTFRO         X'00' READ-ONLY DISK
          .1.. ....      FSTFROX        X'40' READ-ONLY EXTENSION OF
                                        READ-ONLY DISK
          ...1 ....      FSTFBSFS       X'10' Shared File FST
          1... ....      FSTFRW         X'80' READ-WRITE DISK
          11.. ....      FSTFRWX        X'C0' READ-ONLY EXTENSION OF
                                        READ-WRITE DISK
          .... 1...      FSTCNTRY       X'08' CENTURY FOR DATE LAST
                                        WRITTEN (0=19, 1=20), CORRESPONDS
                                        TO FSTYR, FSTADATI.
          .... .111      FSTFACT        X'07' FILE "ACTIVE" - ONE OF THE
                                        FOLLOWING:
          .... .1..      FSTFAR         X'04' FILE ACTIVE FOR READING
          .... ..1.      FSTFAW         X'02' FILE ACTIVE FOR WRITING
          .... ...1      FSTFAP         X'01' FILE ACTIVE FROM A "POINT"
             APPLICABLE TO FSCBFLG IN PLIST
          ..1. ....      FSTEPL         X'20' EXTENDED PLIST
          .1.. ....      FSTITAV        X'40' ITEM AVAILABLE
          .... ...1      FSTRECAV       X'01' PREVIOUS RECORD NULL
0020   32 Signed       4 FSTIL          (MAXIMUM) ITEM LENGTH
0024   36 Signed       2 FSTDBC         NUMBER OF DATA BLOCKS
0026   38 Signed       2 FSTYR          YEAR
          ..1. .1..      FSTTID         00004 FSTDBC,4 Tupple Identifier
          00000028       FSTL           *-FSTN FST EDF EXTENSION
0028   40 Signed       4 FSTFOP         ALT. FILE ORIGIN POINTER, will be
                                        zero for directories
002C   44 Signed       4 FSTADBC        ALT. NUMBER OF DATA BLOCKS, will
                                        be zero for directories
0030   48 Signed       4 FSTAIC         ALT. ITEM COUNT, will be zero for
                                        directories
0034   52 Bitstring    1 FSTNLVL        NUMBER OF POINTER BLOCK LEVELS,
                                        zero for directories
0035   53 Bitstring    1 FSTPTRSZ       LENGTH OF A POINTER ELEMENT, zero
                                        for directories
0036   54 Character    6 FSTADATI       ALT. DATE/TIME(YY MM DD HH MM SS)
          ..11 .11.      FSTFDATE       00003 FSTADATI,3 Date
          ..11 1..1      FSTFTIME       00003 FSTADATI+3,3 Time
003C   60 Signed       4 FSTEDFEN
003C   60 Character    1 FSTREALM       Real filemode
003D   61 Bitstring    1 FSTFLAG2       FST flag byte 2
          ...1 ....      FSTPIPEU       X'10' FSTPIPEU Reserved for CMS
                                        PIPELINES usage
003E   62 Character    2 *              - Reserved -
          00000040       FSTL2          *-FSTN LENGTH OF AN EDF FST.
003C   60 Bitstring    8 FSTOID         Object identifier
0044   68 Bitstring    8 FSTBFOID       Base file identifier
       The bits in the authority flag byte are mutually
       exclusive.
004C   76 Bitstring    1 FSTFB1         authority flag byte
          1... ....      FSTFB1RD       X'80' FSTFB1RD Read authority for
                                        this file
          .1.. ....      FSTFB1WR       X'40' FSTFB1WR Write authority
                                        for this file No Authority to
                                        this file when FB1RD and FB1WR
                                        are off
          ..1. ....      FSTFB1EX       X'20' FSTFB1EX ESM-protected file
004D   77 Bitstring    1 FSTFB2         status flag byte
          1... ....      FSTFB2ER       X'80' FSTFB2ER Erased Alias
                                        indicator
          .1.. ....      FSTFB2RV       X'40' FSTFB2RV Revoked Alias
                                        indicator
          ..1. ....      FSTFB2BF       X'20' FSTFB2BF Base file
                                        indicator
          ...1 ....      FSTFB2AL       X'10' FSTFB2AL Alias fst
                                        indicator
          .... 1...      FSTFB2SD       X'08' FSTFB2SD Subdirectory fst
                                        indicator
          .... .1..      FSTFB2DC       X'04' FSTFB2DC Dircontrol
                                        subdirectory Note. FB2DC = on
                                        implies that FB2SD = on.
          .... ..1.      FSTFB2MG       X'02' FSTFB2MG Migrated file
          .... ...1      FSTFB2EO       X'01' FSTFB2EO External Object
004E   78 Bitstring    1 FSTFB3         extended attribute flag byte
          1... ....      FSTFB3IP       X'80' FSTFB3IP file has the
                                        INPLACE attribute
          .1.. ....      FSTFB3MA       X'40' FSTFB3MA module file with
                                        long name alias
          ..1. ....      FSTFB3IV       X'20' FSTFB3IV FST invalid
                                        (during cache update -DMSJCM
                                        only)
          .... 1...      FSTCDOLR       X'08' FSTCDOLR CENTURY FOR DATE
                                        LAST REFERENCE (0=19, 1=20),
                                        CORRESPONDS TO FSTDOLR.
004F   79 Character    1 *              -RESERVED-
          00000050       FSTL3          *-FSTN Length of a Shared file
                                        FST
0050   80 Signed       4 FSTDSFOP       Data space file origin pointer
0054   84 Character    3 FSTDOLR        Date of last reference
0057   87 Character    1 *              -RESERVED-
          00000058       FSTL4          *-FSTN Length of an SFS data
                                        space FST
 
 
  FSTSECT Storage Layout Top of page
  
          
*** FSTSECT - bilingual FSTB macro
*
*     +-------------------------------------------------------+
*   0 |                         FSTN                          |
*     +-------------------------------------------------------+
*   8 |                         FSTT                          |
*     +---------------------------+-------------+-------------+
*  10 |           FSTD            |   FSTWP     |   FSTRP     |
*     +-------------+-------------+-------------+------+------+
*  18 |    FSTM     |   FSTIC     |   FSTFCL    |FSTFV |FSTFB |
*     +-------------+-------------+-------------+------+------+
*  20 |          FSTIL            |   FSTDBC    |   FSTYR     |
*     +---------------------------+-------------+-------------+
*  28 |          FSTFOP           |         FSTADBC           |
*     +---------------------------+------+------+-------------+
*  30 |          FSTAIC           |:NLVL |:PTRSZ|   (036)-    |
*     +---------------------------+------+------+-------------+
*  38 |        -FSTADATI          |         FSTEDFEN          |
*     +---------------------------+---------------------------+
*  40
*
*** FSTSECT - bilingual FSTB macro
          
*** Overlay for FSTEDFEN in FSTSECT
*
*                                 +------+------+-------------+
*  38 ...                      3C |:REALM|:FLAG2|/////////////|
*                                 +------+------+-------------+
*  40
*
*** Overlay for FSTEDFEN in FSTSECT
          
*** Overlay for FSTEDFEN in FSTSECT
*
*                                 +---------------------------+
*     ...                      3C |         FSTOID-           |
*     +---------------------------+---------------------------+
*  40 |          -(03C)           |        FSTBFOID-          |
*     +---------------------------+------+------+------+------+
*  48 |          -(044)           |FSTFB1|FSTFB2|FSTFB3|//////|
*     +---------------------------+------+------+------+------+
*  50 |         FSTDSFOP          |      FSTDOLR       |//////|
*     +---------------------------+--------------------+------+
*  58
*
*** Overlay for FSTEDFEN in FSTSECT
 
 
  FSTSECT Cross Reference Top of page
  
 
Symbol         Dspl Value
-------------- ---- -----
FSTADATI       0036
FSTADBC        002C
FSTAIC         0030
FSTBFOID       0044
FSTBFOWN       0016 10
FSTCDFMR       001A 000FSTIC
FSTCDOLR       004E 08
FSTCNTRY       001F 08
FSTD           0010
FSTDBC         0024
FSTDIRN        0008 00
FSTDOLR        0054
FSTDSFOP       0050
FSTEDFEN       003C
FSTEPL         001F 20
FSTFACT        001F 07
FSTFAP         001F 01
FSTFAR         001F 04
FSTFAW         001F 02
FSTFB          001F
FSTFBSFS       001F 10
FSTFB1         004C
FSTFB1EX       004C 20
FSTFB1RD       004C 80
FSTFB1WR       004C 40
FSTFB2         004D
FSTFB2AL       004D 10
FSTFB2BF       004D 20
FSTFB2DC       004D 04
FSTFB2EO       004D 01
FSTFB2ER       004D 80
FSTFB2MG       004D 02
FSTFB2RV       004D 40
FSTFB2SD       004D 08
FSTFB3         004E
FSTFB3IP       004E 80
FSTFB3IV       004E 20
FSTFB3MA       004E 40
FSTFCL         001C
FSTFDATE       0036 36
FSTFLAG2       003D
FSTFOP         0028
FSTFRO         001F 00
FSTFROX        001F 40
FSTFRW         001F 80
FSTFRWX        001F C0
FSTFTIME       0036 39
FSTFV          001E
FSTFVDIR       001E 000000C4
FSTFVERS       001E 00000060
FSTFVFIX       001E 000000C6
FSTFVVAR       001E 000000E5
FSTIC          001A
FSTIL          0020
FSTITAV        001F 40
FSTL           0026 00000028
FSTL2          003E 00000040
FSTL3          004F 00000050
FSTL4          0057 00000058
FSTM           0018
FSTMCHAR       0018 00000018
FSTMNUM        0018 00000019
FSTN           0000
FSTNLVL        0034
FSTNT          0000
FSTOID         003C
FSTPIPEU       003D 10
FSTPTRSZ       0035
FSTREALM       003C
FSTRECAV       001F 01
FSTRP          0016
FSTSCID        001C 1A
FSTT           0008
FSTTID         0026 24
FSTWP          0014
FSTYR          0026
 
This information is based on z/VM 7.3.0 Last updated on 22 Jun 2022 at 16:01:18 EDT.
Copyright IBM Corporation, 1990, 2022