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

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

#### FSTD Cross Reference

    Symbol         Dspl Value
    -------------- ---- -----
    FSTACTPT       001F 01
    FSTACTRD       001F 04
    FSTACTWR       001F 02
    FSTADATI       0036
    FSTADBC        002C
    FSTAIC         0030
    FSTBLKCT       0024
    FSTCNTRY       001F 08
    FSTDATEW       0010
    FSTDFIX        001E 000000C6
    FSTDFNFT       0000
    FSTDIA         001F 40
    FSTDRA         001F 01
    FSTDSFS        001F 10
    FSTDSIZE       003E 00000040
    FSTDVAR        001E 000000E5
    FSTEPL         001F 20
    FSTFCLPT       001C
    FSTFILEA       001F 07
    FSTFLAGS       001F
    FSTFLAG2       003D
    FSTFMODE       0018
    FSTFNAME       0000
    FSTFOP         0028
    FSTFTYPE       0008
    FSTLRECL       0020
    FSTNLVL        0034
    FSTPIPEU       003D 10
    FSTPTRSZ       0035
    FSTRDPNT       0016
    FSTREALM       003C
    FSTRECCT       001A
    FSTRECFM       001E
    FSTRODSK       001F 00
    FSTRWDSK       001F 80
    FSTTIMEW       0012
    FSTWRPNT       0014
    FSTXRDSK       001F 40
    FSTXWDSK       001F C0
    FSTYEARW       0026

This information is based on z/VM V5R2.0.
Last updated on 6 Dec 2005 at 15:39:45 EDT.
Copyright IBM Corporation, 1990, 2005