RPTCOPY C-1





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



NAME


rptcopy - copy logical reportfile
[ lreport1 lreport2 ]

SYNOPSIS


rptcopy [-cenvxy] [-C comment] [-D directory] [-P boolean]

DESCRIPTION


Rptcopy copies the logical reportfile lreport1 to the logical reportfile
lreport2.  Under no circumstance can lreport1 and lreport2 be the same
logical report name.  If a logical reportfile already exists for lreport2,
the reportfile is removed including the logical reportfile entry.  After
the reportfile for lreport1 is copied over to lreport2, a logical 
reportfile entry is added to the reportfile catalog.

The reportfile for lreport2 is located in a user supplied directory or
if unspecified, in the directory rpt relative to the home directory of
the database.  If a file exists 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.

There are two reportfile formats available, a visual report which is 
maintained with wtrdef(C-1) and a text reportfile maintained with a 
text editor.

The following flags apply to rptcopy:

-c	Convert a visual reportfile to a text reportfile.  Lreport1 must
	already exist as a visual reportfile.  When copying to the 
	reportfile specified by lreport2, the reportfile for lreport1 is
	converted into a text reportfile using preport(C-1).

-e 	Enters expert mode by displaying a parameter form and allows input
	of arguments available with the rptcopy command.  The parameter 
	form accepts input in the same manner as form(C-1).

-n 	Copy to the logical reportfile lreport2 if a logical reportfile 
	entry for lreport2 does not already exist in the reportfile 
	catalog.  This flag prevents an existing logical reportfile from 
	being copied onto.

-v 	Displays progress information on standard output.

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

-y 	Copy to the logical reportfile lreport2 whether or not a logical
	reportfile already exists for lreport2.  This flag allows an 
	existing logical report file to be copied onto without confirming
	the operation using a parameter form.

-C comment
	Supplies the description of lreport2 that is stored with the new
	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, the description is set to null.

-D directory
	Names the directory to contain the new reportfile.  This directory
	must be an absolute pathname or a pathname relative to the 
	database's home directory.  If the reportfile directory is not 
	defined, the directory rpt relative to the database's home 
	directory is used.

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

When copying a logical reportfile, if a file exists that matches the 
logical reportfile name in the named reportfile directory, or the name
is too long for a file entry a unique name is generated for the 
reportfile's pathname.  If both of the logical reportfile names are not
supplied, a parameter form is displayed requiring the names of both 
logical reportfiles.  This form accepts input in the same manner as 
form(C-1).  If the logical formfile report2 already exists and neither
the -y nor -n flag is specified, a parameter form is displayed requesting
whether or not the logical reportfile entry and reportfile for report2
is to be removed.

SEE ALSO


rptadmin(C-1), rptedit(C-1), rptupd(C-1), rptrm(C-1), wtrdef(C-1).
Chapter 7, Creating Visual Reports.

NOTES


A logical name can be defined several ways, yet represent the same 
logical file.  For more information on logical names see Chapter 2, 
Databases.