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 V6R1.0.
Last updated on 23 Oct 2009 at 11:01:24 EDT.
Copyright IBM Corporation, 1990, 2008