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

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 V4R3.0.
Last updated on 1 May 2002 at 14:19:52 EDT.
Copyright IBM Corporation, 1990, 2002