rptedit - create or maintain logical reportfiles


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.

-C comment
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

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


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.