FORMADMIN C-1


NAME



formadmin - administer formfile catalog

SYNOPSIS



formadmin -a [-vx] [-C comment] lformfile sysname
formadmin -d [-vx] lformfile
formadmin -f [-v] lformfile
formadmin -l [-v] dbname [printfields]
formadmin -r [-v] lformfile [printfields]
formadmin -u [-vx] [-C comment] [-S sysname] lformfile

DESCRIPTION



Formadmin maintains the formfile catalog. Formadmin either adds, updates
or deletes a logical formfile entry from the formfile catalog, or provides
catalog information on existing entries.

One of the following flags must be specified to indicate the operation
to be performed by formadmin:

-a Adds an entry for lformfile to the formfile catalog. An entry in
the formfile catalog cannot already exist for lformfile. Sysname
names the pathname of the formfile. This can be an absolute pathname
or a pathname relative to the home directory of the database.

The -C flag initializes the description catalog field. If it 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.

-f Displays on standard output the absolute pathname of lformfile.

-l Displays all logical formfiles currently defined for the database
dbname. Including the -v flag, titles for all selected printfields
are displayed. With no printfields selected, the default is the
description of each logical formfile in addition to its' name.
Printfields selects
the catalog field information displayed for each logical formfile.
The printfields available for a logical formfile are dbname,
formname, sysname, and desc.


-r Displays the catalog field information for one logical formfile
entry. Including the -v flag, titles for all selected printfields
are displayed. With no printfields selected, the default is the
description of lformfile and its' name. Printfields selects the
catalog field information displayed for lformfile. The printfields
available for a logical formfile are dbname, formname, sysname,
and desc.

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

-x Displays on standard output the commands run by formadmin.

-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
Names the system pathname of the logical formfile lformfile.
Sysname can be an absolute pathname (e.q. /usr/cbase/demo/scr/mag),
or a name relative to the home directory of the database (e.q. scr/
mag).

SEE ALSO



formedit(C-1), formrm(C-1), form(C-1), formdef(C-1), formupd(C-1).