FORMCOPY C-1
Copyright (C) 1994-95 Conetic Software Systems, Inc.
All names, products, and services mentioned are the trademarks of their respective organizations.
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
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.