LFCOPY C-1

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