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.