Referencing Files

Syntax: How to Reference Files in FOCUS

 
filename filetype filemode

where:

filename: Is the name of the file.
filetype: Is the type of file. Filetype usually adheres to standard naming conventions.
filemode: Identifies the disk on which the file resides.

Reference: FOCUS Files

The following is a list of the major files that you will use in FOCUS. These will be discussed in detail in subsequent sections. The files are referenced by file name and are divided into categories:

System Files	Description
ERRORS	Contains error messages, help information, National Language error messages, README information, and FOCUS configuration parameters.
SYSPRINT	Specifies the normal destination of the run log, messages, and reports.
SYSIN	Is the source of the FOCUS commands.
OFFLINE	Specifies alternate destination for printed reports.

Application Files	Description
MASTER	Master Files.
ACCESS	Access Files. (Optional except for intelligent partitioning. For information, see the Describing Data manual.)
FOCEXEC	Stored procedures.
FOCUS	FOCUS data sources and external indices.
FOCSTYLE	FOCUS StyleSheet files.
FUSELIB	Library of user-written subroutines.
FOCCOMP	Compiled procedures.
TTEDIT	TableTalk sessions.
FMU	Window files.
TRF	Documentation for window files or window transfer files.
External Files	External data files not in FOCUS format, including transaction files.
HOLDSTAT Files	Documentation and DBA information for extract files.
WINFORMS	Winforms used in a Maintain procedure.

Extract Files	Description
*HOLD	Contains data saved using the HOLD command.
*SAVB	Contains data saved using the SAVB command.
*SAVE	Contains data saved using the SAVE command.

Note: Dialogue Manager output files must be defined by you.

Work Files	Description
FOCSTACK	Used by Dialogue Manager to store FOCUS commands.
FOCSORT	Used during sorting.
FOCSML	A work area used by Financial Modeling Language.
*FOCPOST	Sequential output file saved using the POST or PICKUP commands.
REBUILD	Used by the REBUILD utility.
*EQFILE	Used for equation output by ANALYSE.
TABLTALK	Used by TableTalk as a procedure.

*The AS phrase renames asterisked files to allow more than one file of that type in a single session.

Defining Files

How to:

Define a File and Location

You can explicitly define files and their locations to FOCUS using the CMS FILEDEF command.

Top of page

Syntax: How to Define a File and Location

FILEDEF ddname DISK filename filetype filemode (LRECL lrecl 
RECFM recfm BLKSIZE blksize)

where:

ddname: Is the name used to refer to the file in FOCUS.
filename: Is the name under which the data is stored and is usually the same as ddname.
filetype: Identifies the type of file.
filemode: Identifies the disk.

Additionally, FOCUS will dynamically define most work and permanent files to the operating system during a FOCUS session.

There are other forms of the FILEDEF command. For details, see the IBM manual CMS Command Reference.

Dynamically Defining Files

How to:

You do not have to explicitly define all of your files prior to using to them in a FOCUS session. FOCUS will dynamically define certain files.

FOCUS will define some or all of the following output or work files during a FOCUS session:

HOLD, SAVB and SAVE files.
FOCUS data sources.
FOCUS work files, such as FOCSTACK and FOCSORT.
Financial Modeling Language file FOCSML.
OFFLINE, SYSIN, and SYSPRINT files.
TTEDIT files.
FMU and TRF files (documentation only).
WINFORMS files.

Top of page

Syntax: How to Enter FOCUS

To enter FOCUS from CMS, execute the FOCUS EXEC

[EX] FOCUS [(NOPROF|(PROFILE filename]

where:

NOPROF: Is an optional parameter. Enables you to bypass or ignore an existing PROFILE FOCEXEC procedure when you enter your FOCUS session.
filename: Is an optional parameter. Is the name of an alternative PROFILE FOCEXEC which executes instead of the existing PROFILE FOCEXEC.

Top of page

Syntax: How to Exit FOCUS

To exit FOCUS and return to CMS, enter the FIN command:

FIN