RPTEDIT

NAME

rptedit - create or maintain logical reportfiles

SYNOPSIS

rptedit [-vx] [lreport]

rptedit -c [ -etvx] [ -C comment ] [ -D directory ] [ -P boolean ]][ lreport ]

Rptedit creates or modifies logical reportfiles used by the report writer program. The -c flag is used to create a newlogical reportfile. If the create (-c) flag is omitted, the existing logical reportfile lreport is modified. After the reportfile has been created or modified, it is compiled into an intermediate code. If errors occur during this compile, the reportfile can be saved as is, discarded, or looped back into the edit reportfile stage. If the precompile status field (-P) for the logical reportfile is set to yes, the intermediate code is saved and written to the reportfile's compiled pathname. This pathname is formed by appending .rw to the pathname of the reportfile. When a report is created, an entry for the logical reportfile is added to the reportfile catalog.

A reportfile can be created and maintained in one (1) of two (2) formats. The reportfile can be created as a visual reportfile maintained by wtrdef(C-1) or a text reportfile maintained by a user selected text editor. The user selects the text editor by setting the environment variable EDITOR to the command name of an appropriate text editor.

The following flags apply to rptedit:

-c Creates the logical reportfile lreport. An entry in the reportfile catalog cannot already exist for lreport. If the -t flag is selected, a text editor is invoked to create a text reportfile. If the -t flag is omitted, wtrdef(C-1) is invoked to create a visual reportfile. After the report has been created, a logical reportfile entry for lreport is added to the reportfile catalog. If a file exist in the named directory that matches the logical reportfile name, or the name is too long for a file entry, a unique name is generated for the reportfile's pathname.

The optional flags -e, -t, -C, D and -P apply only when a reportfile is initially being created.

-e Enters expert mode by displaying a parameter form and allows input of arguments that are available with the rptedit command. The -e flag only applies when the create (-c) flag has been specified with a logical reportfile that does not already exist. The parameter form accepts input in the same manner as .form(C-1)

-v Displays progress information on standard output.

-x Displays on standard output the commands run by rptedit.

Supplies the description of lreport that is stored with the logical reportfile entry. If specified, comment is required and must be quoted if embedded with blanks, tabs or newlines. The -C flag applies only when invoked rpteditis (-c) flag. If the -C flag is omitted, the description is set to null.

-D directory

Names the directory to contain the new reportfile. The reportfile directory must be an absolute pathname or a pathname relative to the database's home directory. If the reportfile directory is not defined, rptedit uses the directory scr relative to the database's home directory.

-P boolean

Specifies the precompile status of lreport. The precompile status indicates whether a compiled version of lreport should be maintained. Boolean indicates the precompile status. The value for boolean is either set to yes, to maintain a compiled version of lreport, or no, do not maintain a compiled version of lreport. If a compiled reportfile is maintained, the pathname of the compiled version of the report is formed by appending .rw to the pathname of the logical reportfile.

If the lreport argument is omitted, a parameter form is displayed requesting for the logical reportfile. This form accepts input in the same manner as form(C-1).

SEE ALSO

rptadmin(C-1), rptupd(C-1), rptrm(C-1), wtr(C-1), wtrdef(C-1).

Chapter 7, Creating Visual Reports.

Chapter 9, Report Writer Programming Guide.

Chapter 10, Report Writer Programming Reference.