NAME
formupd - update the logical formfile catalog
SYNOPSIS
formupd -a [-v] [-C comment ] -S sysname lformfile
formupd -d [-v] lformfile
formupd -u [-v] [-C comment ] [-S sysname ] lformfile
DESCRIPTION
This command is for internal formfile catalog maintenance only. It is run by other C/Base commands. Use the frmadmin(C-1) command for general formfile catalog manipulation.
Each invocation of formupd either adds, updates or deletes a formfile entry from the formfile catalog. It is the only C/Base command that physically alters the formfile catalog.
One of the following flags must be specified to indicate the operation to be performed by formupd:
-a Adds an entry for the named logical formfile to the formfile catalog. Lformfile specifies the name of the logical formfile. The -S flag must be supplied when adding a logical formfile entry to the formfile catalog. The argument sysname supplied with the -S flag specifies the pathname of the formfile. This can be an absolute pathname or a name relative to the home directory of the database.
The -C flag initializes the description catalog field. If this flag is omitted, the description field is set to null.
-d Deletes the logical formfile entry for lformfile from the formfile catalog. The physical formfile is not removed from the system.
-u Updates the catalog entry for the existing logical formfile lformfile. At least one of the optional flags (-C or -S) must be supplied when updating a logical formfile entry.
The meanings of the optional flags are:
-v Displays progress information on standard output.
-C comment
Supplies the description of lformfile that is stored with the 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 when adding a logical formfile, the description is set to null. If this flag is omitted when the -u flag is specified, the description for the logical formfile is unchanged.
-S sysname
Specifies the system pathname of the logical formfile. Sysname can be an absolute pathname (e.q. \cbase\demo\scr\mag), or a pathname relative to the home directory of the database (e.q. scr\mag).
SEE ALSO
formedit(C-1), form(C-1), formdef(C-1), frmadmin(C-1).