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