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
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
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,