rptcopy - copy logical reportfile
[ lreport1 lreport2 ]
rptcopy [-cenvxy] [-C comment] [-D directory] [-P boolean]
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.
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.
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.
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.
rptadmin(C-1), rptedit(C-1), rptupd(C-1), rptrm(C-1), wtrdef(C-1).
Chapter 7, Creating Visual Reports.
A logical name can be defined several ways, yet represent the same logical file. For more information on logical names see Chapter 2, Databases.