IBM: FSTD

z/VM >

Programming Interface Information: This page documents intended Programming
Interfaces that allow the customer to write programs to obtain the services of VM/ESA.

FSTD

Prolog

Control Block Contents

FSTD DSECT

Storage Layout

Cross Reference (Contains links to field and bit definitions)

FSTD Prolog
 Name       : FSTD
 Description: File Status Table DSECT
 DSECT      : FSTD
 Function   : mapping of a CDF and/or EDF File
              Status Table. FSTD describes the fields in a
              40-byte file status table entry as found by
              STATE, STATEW, DMSLFS or DMSLFSW. FSTD is
              functionally equivalent to the FSTSECT DSECT.
              It is called by the FSTD macro. Notes - Module
              Type - Macro Processor - Assembler F

FSTD Control Block Content


FSTD DSECT
Hex   Dec Type/Val   Lng Label (dup)    Comments
---- ---- --------- ---- -------------- --------
0000    0 Structure      FSTD           File Status Table DSECT
0000    0 Character   16 FSTDFNFT (0)   filename and filetype
0000    0 Character    8 FSTFNAME       - filename
0008    8 Character    8 FSTFTYPE       - filetype
0010   16 Signed       2 FSTDATEW       - DATE LAST WRITTEN - MMDD
0012   18 Signed       2 FSTTIMEW       - TIME LAST WRITTEN - HHMM
0014   20 Signed       2 FSTWRPNT       - WRITE POINTER - ITEM NUMBER
0016   22 Signed       2 FSTRDPNT       - READ POINTER - ITEM NUMBER
0018   24 Signed       2 FSTFMODE       - FILE MODE - LETTER AND NUMBER
001A   26 Signed       2 FSTRECCT       - NUMBER OF LOGICAL RECORDS
001C   28 Signed       2 FSTFCLPT       - FIRST CHAIN LINK POINTER
001E   30 Character    1 FSTRECFM       - F*1 - RECORD FORMAT - F OR V
     FSTRECFM flag byte definitions
          000000C6       FSTDFIX        C'F' - Fixed record format
          000000E5       FSTDVAR        C'V' - Variable record format
001F   31 Bitstring    1 FSTFLAGS       - F*2 - FST FLAG BYTE
     FSTFLAGS DESCRIPTION
          1... ....      FSTRWDSK       X'80' - READ/WRITE DISK
          .... ....      FSTRODSK       X'00' - READ/ONLY DISK
          ...1 ....      FSTDSFS        X'10' - Shared File FST
          .1.. ....      FSTXRDSK       X'40' - EXTENSION OF R/O DISK
          11.. ....      FSTXWDSK       X'C0' - EXTENSION OF R/W DISK
          ..1. ....      FSTEPL         X'20' - EXTENDED PLIST
          .1.. ....      FSTDIA         X'40' - ITEM AVAILABLE
          .... ...1      FSTDRA         X'01' - PREVIOUS RECORD NULL
          .... 1...      FSTCNTRY       X'08' - Century for date last
                                        written (0=19, 1=20), corresponds
                                        to FSTYEARW, FSTADATI.
          .... .1..      FSTACTRD       X'04' - ACTIVE FOR READING
          .... ..1.      FSTACTWR       X'02' - ACTIVE FOR WRITING
          .... ...1      FSTACTPT       X'01' - ACTIVE FROM A POINT
          .... .111      FSTFILEA       X'07' - THE FILE IS ACTIVE
0020   32 Signed       4 FSTLRECL       - LOGICAL RECORD LENGTH
0024   36 Signed       2 FSTBLKCT       - NUMBER OF 800 BYTE BLOCKS
0026   38 Signed       2 FSTYEARW       - YEAR LAST WRITTEN
0028   40 Signed       4 FSTFOP         ALT. FILE ORIGIN POINTER
002C   44 Signed       4 FSTADBC        ALT. NUMBER OF DATA BLOCKS
0030   48 Signed       4 FSTAIC         ALT. ITEM COUNT
0034   52 Bitstring    1 FSTNLVL        NUMBER OF POINTER BLOCK LEVELS
0035   53 Bitstring    1 FSTPTRSZ       LENGTH OF A POINTER ELEMENT
0036   54 Character    6 FSTADATI       ALT. DATE/TIME(YY MM DD HH MM SS)
003C   60 Character    1 FSTREALM       Real filemode
003D   61 Bitstring    1 FSTFLAG2       - F*3 - FST FLAG BYTE 2 FSTFLAG2
                                        DESCRIPTION
          ...1 ....      FSTPIPEU       X'10' - Reserved for CMS
                                        PIPELINES usage
003E   62 Character    2 *              - reserved -
          00000040       FSTDSIZE       (*-FSTD) - FST SIZE IN BYTES

FSTD Storage Layout

*** FSTD - File Status Table DSECT
*
*     +-------------------------------------------------------+
*   0 |                       FSTFNAME                        |
*     +-------------------------------------------------------+
*   8 |                       FSTFTYPE                        |
*     +-------------+-------------+-------------+-------------+
*  10 |  FSTDATEW   |  FSTTIMEW   |  FSTWRPNT   |  FSTRDPNT   |
*     +-------------+-------------+-------------+------+------+
*  18 |  FSTFMODE   |  FSTRECCT   |  FSTFCLPT   |:RECFM|:FLAGS|
*     +-------------+-------------+-------------+------+------+
*  20 |         FSTLRECL          |  FSTBLKCT   |  FSTYEARW   |
*     +---------------------------+-------------+-------------+
*  28 |          FSTFOP           |         FSTADBC           |
*     +---------------------------+------+------+-------------+
*  30 |          FSTAIC           |:NLVL |:PTRSZ|   (036)-    |
*     +---------------------------+------+------+-------------+
*  38 |        -FSTADATI          |:REALM|:FLAG2|/////////////|
*     +---------------------------+------+------+-------------+
*  40
*
*** FSTD - File Status Table DSECT