createlf - create a logical RMSfile
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).
dbadmin(C-1), dbcreate(C-1),
dblist(C-1), lfedit(C-1),
makelf(C-1).
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).