DLCONV C-3
Copyright (C) 1994-95 Conetic Software Systems, Inc.
All names, products, and services mentioned are the trademarks of their respective organizations.
NAME
dlconv - log conversion of logical RMSfile
SYNOPSIS
#include
#include
dlconv (lname, deffile)
char *lname, *deffile;
DESCRIPTION
Dlconv records a marker in the current log file to change the
format of a logical RMSfile. The new file definition is also
written to the log file. When the restore program, drestore,
encounters this marker, it converts the named logical RMSfile to
the new definition.
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
dlconv, no entry is made in the log file.
Deffile names an RMS definition file to be copied into the log
file.
SEE ALSO
dlclear(C-3), dldelete(C-3), dlexpand(C-3), dlmake(C-3),
convertlf(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.