7.3.2 Creating Reportfiles with Rptedit

To create a new logical reportfile, enter the command:

c:\> rptedit -ce lrptfile

The -c flag specifies that the reportfile lrptfile is to be created. It must not already exist. The -e flag displays a parameter form to get the values of optional arguments that are available with rptedit. These optional arguments are available on rptedit's command line. For a description of the arguments and flags available with rptedit, see rptedit(C-1) in Chapter 12, C/Base Commands.

The parameter form, invoked with the -e flag, is used to initialize the reportfile name, description, location and compiling status when creating reports. The parameter form is shown below.

gifs/00000001.gif

Descriptions for the fields on this parameter form are as follows:

Logical Report Name

This field specifies the logical reportfile to be created. If the environment variable DBASE is set, the database name and home directory of the database are shown at the top of the parameter form.

Text or Visual Reportfile

The response to this field answers the question Do you wish to create a Text Report Program? Responding yes creates a text reportfile while responding no creates a visual report. If no value is entered, the default is no.

Report Compiling Status

The response to this field answers the question Should the new report have a compiled report file? The default values is yes, meaning that a compiled version of the new logical reportfile should be maintained. No means that no compiled version of the report should be kept.

Report Directory

Entry into this field specifies that an alternative directory is to be used for storing the new logical reportfile. The directory entered may be an absolute path name or a pathname relative to the database's home directory. Entry into this field is optional. If no value is entered, the reportfile will be located in the directory rpt by default.

Comment

Supplies the description of the new logical reportfile that is stored with the logical reportfile entry.

Rptedit requests the logical name of the report if it is not supplied with the command. When creating a report by supplying the -c flag to rptedit, as with the command

rptedit -c

a parameter form is displayed that only allows entry values for the logical reportfile name, the type of reportfile to create (text or visual) and the description for the new logical report. The description of these fields are the same as the corresponding fields described in the preceding paragraph. The parameter form displayed is as follows:

gifs/00000001.gif