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.