DLFIND C-3


NAME



dlfind - get named logical RMSfile description

SYNOPSIS



#include

LF *dlfind (dbname, lfname)
char *dbname, *lfname;

DESCRIPTION



Dlfind searches the C/Base database catalog for the given logical
RMSfile within the named database. If found, a pointer to a
structure describing the logical RMSfile is returned. If the
logical RMSfile is not defined within the named database, a NULL
pointer is returned and the RMS error message is set describing
the reason for not finding the logical RMSfile.

Dbname is the name of the database. If dbname is a NULL pointer
or an empty string, the default database name is used.

Lfname is the name of the logical RMSfile within the database.

The structure returned by dlfind is defined in the include file
.

SEE ALSO



dlfindn(C-3), dlopen(C-3)

DIAGNOSTICS


A value of NULL is returned if the logical RMSfile is not defined
in the C/Base database catalog.

NOTES



The returned value points to static data whose contents are
overwritten with every call.