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