NAME
formcopy - copy logical formfileSYNOPSIS
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
formadmin(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.