NAME
rptupd - update the logical reportfile catalog
SYNOPSIS
rptupd -a [-v ] [-C comment] [-P boolean] -S sysname lreport
rptupd -d [-v ] lreport
rtupd -u [-v] [-C comment] [-P boolean] [-S sysname] lreport
DESCRIPTION
This command is for internal reportfile catalog maintenance only. It is run only by other C/Base commands. Use the rptadmin(C-1) command for general reportfile catalog manipulation.
Each invocation of rptupd either adds, updates or deletes a reportfile entry from the report catalog. It is the only C/Base command that physically alters the reportfile catalog.
One of the following flags must be specified to indicate the operation to be performed by rptupd:
-a Adds an entry for the named logical reportfile to the reportfile catalog. Lreport names the logical reportfile. The -S flag must be specified when adding a logical reportfile entry to the reportfile catalog. Sysname, supplied with the -S flag, specifies the pathname of the reportfile. This can be an absolute pathname or a pathname relative to the home directory of the database.
The -C flag initializes the description catalog field. If this flag is omitted, the description field is set to null. The -P flag specifies the precompile status of a reportfile. If this flag is omitted, the precompile status is set to no.
-d Deletes the logical reportfile entry for lreport from the reportfile catalog. The physical reportfile is not removed from the system.
-u Updates the catalog entry for the existing logical reportfile lreport. At least one of the optional flags (-C, -P, or -S) must be supplied when updating a logical reportfile entry.
The meanings of the optional flags are:
-v Displays progress information on standard output.
-C comment
Supplies the description of lreport that is stored with logical reportfile entry. If the -C flag is specified, comment is required and must be quoted if embedded with blanks, tabs or newlines. If this flag is omitted when adding a logical reportfile, the description is set to null. If this flag is omitted when the -u flag is specified, the description for the logical reportfile is unchanged.
-P boolean
Specifies the precompile status of lreport. The precompile status indicates whether a compiled version of the report should be maintained for a logical reportfile. Boolean is either set to yes, maintain a compiled version of the report, or no, do not maintain a compiled version for lreport. If a compiled reportfile is maintained, the pathname for the compiled version of the report is formed by appending .rw to the pathname of the logical reportfile.
-S sysname
Names the system pathname for the logical reportfile lreport. Sysname can be an absolute pathname (e.q. \cbase\demo\rpt\mag).
SEE ALSO
rptedit(C-1), grace(C-1), crw(C-1), wtr(C-1), rptadmin(C-1).