LFCOPY

NAME

lfcopy - copy logical RMS data and definition file.

SYNOPSIS

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

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 database'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

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.