formupd - update the logical formfile catalog
formupd -a [-v] [-C comment ] -S sysname lformfile
formupd -d [-v] lformfile
formupd -u [-v] [-C comment ] [-S sysname ] lformfile
This command is for internal formfile catalog maintenance only.
It is
run by other C/Base commands. Use the formadmin(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. /usr/cbase/demo/scr/mag), or a
pathname relative to the home directory of the database
(e.q. scr/mag).
formedit(C-1), form(C-1),
formdef(C-1), formadmin(C-1).