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

FSCBD

Prolog  

Control Block Contents  
   FSCBD DSECT

Storage Layout  

Cross Reference (Contains links to field and bit definitions)  


FSCBD Prolog

 NAME       : FSCBD
 Description: File System Control Block
 DSECT      : FSCBD
 Function   : Maps a based structure which names
              all fields within an FSCB. FSCBD is a PLIST
              defined for general use by routines that use
              the CMS file system. FSCBD is generated when
              the user issues the FSCBD macro.

 

FSCBD Control Block Content


FSCBD DSECT

Hex   Dec Type/Val   Lng Label (dup)    Comments
---- ---- --------- ---- -------------- --------
0000    0 Structure      FSCBD          File System Control Block
0000    0 Character    8 FSCBCOMM       File system command (e.g. RDBUF)
0008    8 Character   18 FSCBFILE       File ID (name, type, and mode)
0008    8 Character   16 FSCBFNFT       File name and file type
0008    8 Character    8 FSCBFN         File name
0010   16 Character    8 FSCBFT         File type
0018   24 Character    2 FSCBFM         File mode (letter and number)
0018   24 Character    1 FSCBFML        File mode letter
0019   25 Character    1 FSCBFMN        File mode number
001A   26 Signed       2 FSCBITNO       Relative record number to be
                                        accessed on FSREAD and FSWRITE
                                        (applies only to the non-extended
                                        FSCB)
001C   28 Address      4 FSCBBUFF       Address of the input/output
                                        buffer for FSREAD and FSWRITE
                                        (also used on calls to DMSSTT for
                                        the FST address)
0020   32 Signed       4 FSCBSIZE       Length (in bytes) of the
                                        input/output buffer (also used to
                                        return the record length on
                                        FSOPEN)
0024   36 Character    2 FSCBFV         Record format and first flag byte
0024   36 Character    1 FSCBRECF       Record format - F or V
0025   37 Bitstring    1 FSCBFLG        First flag byte
             'FSCBFLG' flag byte definition
          1... ....      FSCBTHEX       X'80' Space threshold exceeded
                                        (SFS only)
          .1.. ....      FSCBITAV       X'40' Item available (CDF only)
          ..1. ....      FSCBEPL        X'20' Extended PLIST (FORM=E)
          ...1 ....      FSCBMSG        X'10' MSG=YES on FSSTATE or
                                        FSOPEN
          .... 1...      FSCBSTW        X'08' STATEW specified on FSSTATE
          .... .1..      FSCBCACY       X'04' CACHE=YES specified
          .... ..1.      FSCBCACN       X'02' CACHE=NO specified
          .... ...1      FSCBRCAV       X'01' Previous record null (CDF
                                        only)
0026   38 Signed       2 FSCBNOIT       Number of records to be accessed
                                        on FSREAD and FSWRITE (applies
                                        only to the non-extended FSCB)
0026   38 Bitstring    1 FSCBFLG2       Second flag byte
             'FSCBFLG2' flag byte definition (FORM=E only)
          1... ....      FSCBNMAC       X'80' NOMSG=ACTIVE specified on
                                        FSOPEN
          .1.. ....      FSCBNMNF       X'40' NOMSG=NOTFOUND specified on
                                        FSOPEN
          ..1. ....      FSCBNMOS       X'20' NOMSG=OSDOS specified on
                                        FSOPEN
0027   39 Character    1 FSCBOTYP       OPENTYP value
             'FSCBOTYP' Values (FORM=E only)
          .... ....      FSCBTNON       X'00' OPENTYP=NONE specified
          000000D9       FSCBTRD        C'R' OPENTYP=READ specified
          000000E6       FSCBTWR        C'W' OPENTYP=WRITE specified
          000000D5       FSCBTNEW       C'N' OPENTYP=NEW specified
          000000E7       FSCBTREP       C'X' OPENTYP=REPLACE specified
0028   40 Signed       4 FSCBNORD       Number of bytes actually read on
                                        FSREAD
       'FSCBFST' is returned on FSOPEN.  Its value is based on
       the OPENTYP specified and whether or not the file exists.
       Note that a non-extended format FSCB (FORM=E not specified)
       implies OPENTYP=NONE.  The values are as follows:
  File doesn't exist  . FSCBFST=A(0)
       File exists:
       Not FORM=E      FSCBFST=A(Copy of 40 byte FST)
       OPENTYP=NONE    . FSCBFST=A(Copy of 64 byte FST)
       OPENTYP=READ    . FSCBFST=A(Copy of 64 byte FST)
       OPENTYP=WRITE     FSCBFST=A(Copy of 64 byte FST)
       OPENTYP=REPLACE   . FSCBFST=A(-1)
       OPENTYP=NEW      Error, FSCBFST is unchanged
0028   40 Address      4 FSCBFST        Address of a copy of the FST
                                        returned on FSOPEN
      The following fields apply only to the extended form FSCB
      (i.e., FORM=E was specified).
002C   44 Signed       4 FSCBAITN       Relative record number to be
                                        accessed on FSREAD and FSWRITE
                                        (also referred to as the
                                        "alternate item number")
0030   48 Signed       4 FSCBANIT       Number of records to be accessed
                                        on FSREAD and FSWRITE (also
                                        referred to as the "alternate
                                        number of items")
0034   52 Signed       4 FSCBWPTR       Extended write pointer (input on
                                        FSPOINT FORM=E, output on FSOPEN)
0038   56 Signed       4 FSCBRPTR       Extended read pointer (input on
                                        FSPOINT FORM=E, output on FSOPEN)
          0000003C       FSCBLNBY       *-FSCBD Length (in bytes) of the
                                        extended FSCB

 

FSCBD Storage Layout

          
*** FSCBD - File System Control Block
*
*     +-------------------------------------------------------+
*   0 |                       FSCBCOMM                        |
*     +-------------------------------------------------------+
*   8 |                                                       |
*     =                       FSCBFILE                        =
*     |             +-----------------------------------------+
*     |             | 1A
*     +-------------+
*
*** FSCBD - File System Control Block
          
*** Overlay for FSCBFILE in FSCBD
*
*     +-------------------------------------------------------+
*   8 |                       FSCBFNFT                        |
*     |                                                       |
*     +-------------------------------------------------------+
*  18
*
*** Overlay for FSCBFILE in FSCBD
          
*** Overlay for FSCBFNFT in FSCBD
*
*     +-------------------------------------------------------+
*   8 |                        FSCBFN                         |
*     +-------------------------------------------------------+
*  10 |                        FSCBFT                         |
*     +-------------+-----------------------------------------+
*  18 |   FSCBFM    | 1A
*     +-------------+
*
*** Overlay for FSCBFNFT in FSCBD
          
*** Overlay for FSCBFM in FSCBD
*
*     +------+------+-------------+---------------------------+
*  18 |:BFML |:BFMN |  FSCBITNO   |         FSCBBUFF          |
*     +------+------+-------------+-------------+-------------+
*  20 |         FSCBSIZE          |   FSCBFV    | 26
*     +---------------------------+-------------+
*
*** Overlay for FSCBFM in FSCBD
          
*** Overlay for FSCBFV in FSCBD
*
*                                 +------+------+-------------+
*  20 ...                      24 |:BRECF|:BFLG |  FSCBNOIT   |
*                                 +------+------+-------------+
*  28
*
*** Overlay for FSCBFV in FSCBD
          
*** Overlay for FSCBNOIT in FSCBD
*
*                                               +------+------+
*  20 ...                                    26 |:BFLG2|:BOTYP|
*     +---------------------------+-------------+------+------+
*  28 |         FSCBNORD          | 2C
*     +---------------------------+
*
*** Overlay for FSCBNOIT in FSCBD
          
*** Overlay for FSCBNORD in FSCBD
*
*     +---------------------------+---------------------------+
*  28 |         FSCBFST           |         FSCBAITN          |
*     +---------------------------+---------------------------+
*  30 |         FSCBANIT          |         FSCBWPTR          |
*     +---------------------------+---------------------------+
*  38 |         FSCBRPTR          | 3C
*     +---------------------------+
*
*** Overlay for FSCBNORD in FSCBD

 

FSCBD Cross Reference

Symbol         Dspl Value
-------------- ---- -----
FSCBAITN       002C
FSCBANIT       0030
FSCBBUFF       001C
FSCBCACN       0025 02
FSCBCACY       0025 04
FSCBCOMM       0000
FSCBEPL        0025 20
FSCBFILE       0008
FSCBFLG        0025
FSCBFLG2       0026
FSCBFM         0018
FSCBFML        0018
FSCBFMN        0019
FSCBFN         0008
FSCBFNFT       0008
FSCBFST        0028
FSCBFT         0010
FSCBFV         0024
FSCBITAV       0025 40
FSCBITNO       001A
FSCBLNBY       0038 0000003C
FSCBMSG        0025 10
FSCBNMAC       0026 80
FSCBNMNF       0026 40
FSCBNMOS       0026 20
FSCBNOIT       0026
FSCBNORD       0028
FSCBOTYP       0027
FSCBRCAV       0025 01
FSCBRECF       0024
FSCBRPTR       0038
FSCBSIZE       0020
FSCBSTW        0025 08
FSCBTHEX       0025 80
FSCBTNEW       0027 000000D5
FSCBTNON       0027 00
FSCBTRD        0027 000000D9
FSCBTREP       0027 000000E7
FSCBTWR        0027 000000E6
FSCBWPTR       0034

This information is based on z/VM V6R1.0.
Last updated on 23 Oct 2009 at 11:02:05 EDT.
Copyright IBM Corporation, 1990, 2008