FORMADMIN C-1





Copyright (C) 1994-95 Conetic Software Systems, Inc. All names, products, and services mentioned are the trademarks of their respective organizations.



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