LFCOPY C-1





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



NAME


lfcopy - copy logical RMS data and definition file.

SYNOPSIS


lfcopy [ -envxy] [-C comment ] [ -D directory ] [ lfname1 lfname2]

DESCRIPTION


Lfcopy copies the logical RMSfile lfname1 to the logical RMSfile lfname2. 
Under no circumstance can lfname1 and lfname2 be the same logical name.  
If a logical RMSfile already exists for lfname2, the RMSfile, the logical 
catalog entry and its RMS definition file is removed. 

When copying to a logical RMSfile, a copy of lfname1's RMS definition file 
and RMSfile is made for the logical RMSfile lfname2.  After the copy is made, 
a logical RMSfile entry is added to the RMSfile catalog.

The RMSfile for lfname2 is located in a user supplied directory or if 
unspecified, in the directory data.  The RMSfile must reside within a 
directory named data.  The directory containing the ./data directory must 
also contain a directory named ./def.  The ./def directory contains the RMS 
definition file for the new RMSfile.  The directory specified must be an 
absolute pathname or a pathname relative to the database's home directory.  
If a file exists in the named directory that matches the logical name for 
lfname2, or the name is too long for a file entry, a unique name is 
generated for the RMSfile's pathname.

The following flags apply to lfcopy:

-e 	Enters expert mode by displaying a parameter form and allows input 
	of arguments available with lfcopy.  The parameter form accepts 
	input in the same manner as form(C-1).

-n 	Do not copy to the logical RMSfile lfname2 if a logical RMSfile 
	entry already exists in the RMSfile catalog.  This flag prevents 
	an existing logical RMSfile from being copied onto.

-v 	Displays progress information on standard output.

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

-y 	Copy to the logical RMSfile lfname2 whether or not a logical 
	RMSfile entry already exists for lfname2. This flag allows an 
	existing logical RMSfile to be copied onto.

-C comment
	Supplies the description of lfname2 that is stored with the new 
	logical RMSfile 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, the description is set to 
	null. 

-D directory
	Names the directory to contain the new RMSfile.  The new RMSfile 
	must reside within a directory named data.  This directory must 
	be an absolute pathname or a pathname relative to the databases's 
	home directory.  If the reportfile directory is not defined, the 
	directory data (relative to the database's home directory) is 
	used.
	
If the neither logical RMSfile name is supplied, a parameter form is 
displayed requesting for both logical RMSfiles.  This form accepts input 
in the same manner as form(C-1).  If lfname2 already exists and neither 
the -y nor -n flag is supplied, a parameter form is displayed requesting 
whether or not the target RMSfile is to be copied over.

FILES

data/datafile
def/deffile

SEE ALSO


form(C-1), filedef(C-1), lfadmin(C-1), lfedit(C-1), lfupd(C-1), 
createlf(C-1), makelf(C-1), expandlf(C-1), convrtlf(C-1).
Chapter 4, Creating RMSfiles.