formcopy - copy logical formfile
formcopy [-envxy] [-C comment ] [-D directory ] [ lform1 lform2
]
Formcopy copies the logical formfile lform1 to the logical formfile
lform2. Under no circumstance can lform1 and lform2 be the same
logical
formfile name. If a logical formfile already exists for lform2,
the
existing formfile is removed along with its' logical formfile entry.
After the formfile for lform1 is copied to lform2, a logical formfile
entry is added to the formfile catalog.
The following flags apply to formcopy:
-e Enters expert mode by displaying a parameter form and allows
input
of arguments available with the formcopy command. The parameter
form accepts input in the same manner as form(C-1).
-n No copying of a formfile is to be performed if the logical formfile
lform2 already exists.
-v Displays progress information on standard output.
-x Displays on standard output the commands run by formcopy.
-y The copying of lform1 is to be performed even if the logical
formfile lform2 already exists.
-C comment
Supplies the description of lform2 that is stored with the new
logical formfile 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 formfile. This directory
must be an absolute pathname or a pathname relative to the
database's home directory. If the formfile directory is not
defined, the directory scr relative to the database's home
directory is used.
When copying a logical formfile, if a file exists that matches the
logical formfile name in the named formfile directory, or the name
is to
long for a file entry a unique name is generated for the formfile's
pathname. If both of the logical formfile names are not supplied,
a
parameter form is displayed requesting the names of both logical
formfiles.
This form accepts input in the same manner as form(C-1).
If the logical
formfile lform2 already exists and neither the -y nor -n flag is
supplied,
a parameter form is displayed requesting whether or not the logical
formfile lform2 and its' formfile is to be removed.
formadmin(C-1), formupd(C-1),
formrm(C-1), form(C-1),
formdef(C-1).
Chapter 5, Creating Formfiles.
A logical name can be defined several ways, yet represent the same
logical file. For more information see Chapter 2, Databases.