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