FORMUPD C-1





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



NAME


formupd - update the logical formfile catalog

SYNOPSIS


formupd -a [-v] [-C comment ] -S sysname lformfile
formupd -d [-v] lformfile
formupd -u [-v] [-C comment ] [-S sysname ] lformfile

DESCRIPTION


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 
	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. /usr/cbase/demo/scr/mag), or a 
	pathname relative to the home directory of the database 
	(e.q. scr/mag). 

SEE ALSO


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