CREATELF C-1





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



NAME


createlf - create a logical RMSfile

SYNOPSIS


createlf lname directory #records deffile [ logged ] [ description ]

DESCRIPTION


Createlf is used to create a new logical RMSfile.  This command assumes
that the RMSfile does not exist.  This command adds an entry to the 
RMSfile catalog for the new logical RMSfile and creates an empty file 
in the named directory.  Upon successful completion, the pathname of 
the logical RMSfile is written to standard output.

Lname specifies the name of the logical RMSfile to be created.  This 
must be a new name not already defined in the RMSfile catalog.  Directory
names the directory to contain the new RMS data file.  This directory 
can be an absolute pathname (starting from the root directory) or it 
can be a name relative to the home directory of the database.

The #records argument names the number of records that the RMSfile shall 
contain .  This argument is required, but is only used when creating a
hashed file.

The deffile argument is the RMS definition file to be used in creating
the RMSfile. Logged is an optional parameter indicating if changes to 
the logical RMSfile are to be logged in the database logfile.  If the 
value of this argument is yes, there must be a logfile defined for the
database.

Description is an optional description of the logical RMSfile.  This 
description is printed when using the -v flag of dblist(C-1).

SEE ALSO


dbadmin(C-1), dbcreate(C-1), dblist(C-1), lfedit(C-1), makelf(C-1).

NOTES


Createlf may not be supplied in future releases.

Normally, the logical name is used as the system name of a logical file.
If the logical name is longer than the maximum allowed by the system, 
a valid, unique system name is chosen by createlf.

The C/Base command lfadmin(C-1) performs the operations of addlf(C-1), 
createlf(C-1), dbfile(C-1) and removelf(C-1).  The binary program for 
lfadmin is copied to each of the above programs for backwards compatibility.
In addition, for all programs copied from the lfadmin program, each one
has a corresponding resource file copied from the lfadmin resource file 
(/usr/cbase/lib/cbase/resource/lfadmin.r).