Extract Files Under Windows

In this section:

Reference:

WebFOCUS creates all extract files in a temporary directory on the WebFOCUS Reporting Server, or in a user-defined location on the WebFOCUS Reporting Server.

Reference: Locating Extract Files Under Windows

WebFOCUS creates all extract files in a temporary directory under the directory specified by the EDATEMP environment variable in EDASERVE.CFG.

HOLD Files Under Windows

How to:

A HOLD extract file is a sequential data source that contains the results of a report request. It may have a corresponding HOLD Master File. The extension for an extract file is .ftm unless you specify the FORMAT option. If a Master File is created, it has the same name as the extract file, with the extension .mas.

If you specify the FORMAT FOCUS option with HOLD, WebFOCUS creates an extract file and a Master File, each with the file name FOC$HOLD. These files are then used as input to the procedure that creates the final FOCUS file. The new FOCUS and Master Files are created in the user temporary directory.

Syntax: How to Create a HOLD File Under Windows

ON TABLE HOLD [AS filename]

where:

filename

Is a name for the HOLD file. If you do not specify a file name, HOLD is used as the default name. Since each subsequent HOLD command overwrites the previous HOLD file, it is useful practice to code a distinct file name in each request to direct the extracted data to a separate file, preventing it from being overwritten.

For the complete syntax with all options, see the TIBCO FOCUS® Creating Reports manual.

SAVB Files Under Windows

How to:

A SAVB file is an extract file containing the results of a report request in internal format. That is, all numeric fields are stored in binary, and all character fields are padded with spaces to a multiple of four bytes. The file cannot be printed.

When a SAVB file is created, WebFOCUS does not create a Master File.

Syntax: How to Create a SAVB File Under Windows

ON TABLE SAVB [AS filename]

where:

filename

Is the name of the file. The default is SAVB. The default extension is .ftm.

For the complete syntax with all options, see the TIBCO FOCUS® Creating Reports manual.

SAVE Files Under Windows

How to:

A SAVE file is an extract file that saves the data of a report, but does not save headings or subtotals, or create a Master File. It is a simple sequential character data file that can be used by other programs, or merged into another data file using a data maintenance request. The default format is simple character, although you can specify formats compatible with many other software products. WebFOCUS saves all columns in the report in printable, character format with no spaces between columns.

A SAVE file contains the external character format equivalent to SAVB. The command syntax and allocations are the same as SAVB. However, the numbers are printable Extended Binary Coded Decimal Interchange Code (EBCDIC) characters and no padding takes place.

Syntax: How to Create a SAVE File Under Windows

ON TABLE SAVE [AS filename]

where:

filename

Is the name of the file. The default is SAVE. The default extension is .ftm.

HOLDMAST Files Under Windows

How to:

A HOLDMAST file is a temporary Master File. It is created with the HOLD command. The APP HOLDMETA command specifies its location.

Syntax: How to Specify the Location of a Temporary Master File Under Windows

APP HOLDMETA appname

where:

appname

Is a valid application name.

Example: Specifying the Location of a Temporary Master File Under Windows

The following example specifies a location for a temporary Master File, and assigns a logical name to a physical data source.

1. APP HOLDMETA app1 
2. FILEDEF MKTSALES DISK C:\TMP\MKTSALES.FTM
    TABLE FILE GGSALES
    SUM DOLLARS BY REGION
    ON TABLE HOLD AS MKTSALES FORMAT ALPHA
    END

The numbers listed next to the code correspond with the following notes:

  1. Specifies the location of the Master File in the app1 application directory. WebFOCUS uses the same logical name, MKTSALES, specified in the second line, to name the temporary Master File.
  2. Specifies MKTSALES as the logical name for the physical data source. The HOLD command creates the temporary Master File mktsales.mas and the data source mktsales.ftm.