NAME
frmadmin - administer formfile catalog
SYNOPSIS
frmadmin -a [-vx] [-C comment] lformfile sysname
frmadmin -d [-vx] lformfile
frmadmin -f [-v] lformfile
frmadmin -l [-v] dbname [printfields]
frmadmin -r [-v] lformfile [printfields]
frmadmin -u [-vx] [-C comment] [-S sysname] lformfile
DESCRIPTION
Frmadmin maintains the formfile catalog. Frmadmin 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 frmadmin:
-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 frmadmin.
-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. \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).