DLMAKE C-3


NAME



dlmake - log creation of logical RMSfile

SYNOPSIS



#include
#include

dlmake (lname, nrecs, deffile)
char *lname, deffile;
long nrecs;

DESCRIPTION



Dlmake records a marker in the current log file to create a
logical RMSfile with a given size and format. The new RMS
definition file is also written to the log file. When the restore
program, drestore(C-1), encounters this marker, it creates a new
logical RMSfile.

Lname is the name of the logical RMSfile. It can have any of the
following formats:

dbase~lfile
~lfile
lfile

The first form names an explicit database, the latter two use the
default database. A default database is defined by calling
dbopen(C-3), or setting the environment variable DBASE to a valid
database name.

If a path name (a name containing slashes (\ or /)) is passed to
dlmake, no entry is made in the log file.

Nrecs is the new RMSfile size in records.

Deffile names an RMS definition file to be copied into the log
file.

SEE ALSO



dlclear(C-3) dlconv(C-3), dldelete(C-3), dlexpand(C-3),
makelf(C-1), drestore(C-1)

DIAGNOSTICS


A value of FAILED (0) is returned if the marker cannot be written
in the log file. The RMS error message is set describing the
error.

NOTES



This function is intended for internal use only. Indiscriminate
use of this function can render log files useless.