NAME
formcopy - copy logical formfile
SYNOPSIS
formcopy [-envxy] [-C comment ] [-D directory ] [ lform1 lform2 ]
DESCRIPTION
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.
SEE ALSO
frmadmin(C-1), formupd(C-1), formrm(C-1), form(C-1), formdef(C-1).
Chapter 5, Creating Formfiles.
NOTES
A logical name can be defined several ways, yet represent the same logical file. For more information see Chapter 2, Databases.