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.