RPTUPD C-1





Copyright (C) 1994-95 Conetic Software Systems, Inc. All names, products, and services mentioned are the trademarks of their respective organizations.



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. /usr/cbase/demo/rpt/mag).

SEE ALSO


rptedit(C-1), grace(C-1), crw(C-1), wtr(C-1), rptadmin(C-1).