dt_setsearchpath

Daylight v4.9
Release Date: 1 February 2008

Name

dt_setsearchpath - specify the search path used for database lookup

Generic Prototype

dt_setsearchpath(dt_Handle, dt_String, dt_String, dt_Integer) => dt_Boolean

C Prototype

#include "dt_thor.h"

dt_Boolean dt_setsearchpath(dt_Handle server, dt_Integer alen, dt_String auth_pw, dt_Integer plen, dt_String path, dt_Integer replace)

FORTRAN Prototype

include 'dt_f_thor.inc'

logical dt_f_setsearchpath(server, auth_pw, path, replace)

integer*4 server
character*() auth_pw
character*() path
integer*4 replace

Description

Changes the servers search path. The parameter 'auth_pw' must be the current password for user "thor". The parameter 'path' contains one or more directories (multiples are separated by whitespace - space, tab, <cr>, <lf>). The directories must be specified in a format appropriate for the operating system of the server.

If 'replace' is FALSE, appends the directories in 'path' to the existing path. If 'replace' is TRUE, the search path replaces the existing path.

It is legal for 'path' to be an empty string. In this case, if 'replace' is TRUE, the search path is cleared and databases must be referenced by their complete names.

Return Value