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


formedit(C-1), form(C-1), formdef(C-1), frmadmin(C-1).