createlf - create a logical RMSfile


createlf lname directory #records deffile [ logged ] [ 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 (\cbase\lib\cbase\resource\lfadmin.r).