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

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

-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).