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

#### FSTSECT

Prolog

Control Block Contents
FSTSECT DSECT

Storage Layout

Cross Reference (Contains links to field and bit definitions)

#### FSTSECT Prolog

     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

#### FSTSECT DSECT

    Hex   Dec Type/Val   Lng Label (dup)    Comments
    ---- ---- --------- ---- -------------- --------
    0000    0 Structure      FSTSECT
    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        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       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 maximum valid record number
                                            for CDF files
    001C   28 Signed       2 FSTFCL         FIRST CHAIN LINK
              ...1 1.1.      FSTSCID        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         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       FSTADATI,3 Date
              ..11 1..1      FSTFTIME       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' 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' Read authority for this
                                            file
              .1.. ....      FSTFB1WR       X'40' Write authority for this
                                            file No Authority to this file
                                            when FB1RD and FB1WR are off
              ..1. ....      FSTFB1EX       X'20' ESM-protected file
    004D   77 Bitstring    1 FSTFB2         status flag byte
              1... ....      FSTFB2ER       X'80' Erased Alias indicator
              .1.. ....      FSTFB2RV       X'40' Revoked Alias indicator
              ..1. ....      FSTFB2BF       X'20' Base file indicator
              ...1 ....      FSTFB2AL       X'10' Alias fst indicator
              .... 1...      FSTFB2SD       X'08' Subdirectory fst indicator
              .... .1..      FSTFB2DC       X'04' Dircontrol subdirectory
                                            Note. FB2DC = on implies that
                                            FB2SD = on.
              .... ..1.      FSTFB2MG       X'02' Migrated file
              .... ...1      FSTFB2EO       X'01' External Object
    004E   78 Bitstring    1 FSTFB3         extended attribute flag byte
              1... ....      FSTFB3IP       X'80' file has the INPLACE
                                            attribute
              .1.. ....      FSTFB3MA       X'40' module file with long name
                                            alias
              ..1. ....      FSTFB3IV       X'20' FST invalid (during cache
                                            update -DMSJCM only)
              .... 1...      FSTCDOLR       X'08' 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

    *** FSTSECT - Control Block in FSTSECT
    *
    *     +-------------------------------------------------------+
    *   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 - Control Block in FSTSECT

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

    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 V4R4.0.
Last updated on 28 Jul 2003 at 08:15:12 EDT.
Copyright IBM Corporation, 1990, 2003