Query: dtdbload
OS: hpux
Section: 3
Format: Original Unix Latex Style Formatted with HTML and a Horizontal Scroll Bar
DtDbLoad(library call) DtDbLoad(library call)NAMEDtDbLoad -- load actions and data types databaseSYNOPSIS#include <Dt/Action.h> void DtDbLoad(void)DESCRIPTIONThe DtDbLoad function loads the actions and data types database into the application. When the function returns, the database has been loaded. An environment variable determines the set of directories to be searched. The DtDbLoad function loads all actions and data types defined in files with a .dt suffix located in these directories. The directory search path is based on the value of the DTDATABASESEARCHPATH environment variable and internal defaults. DTDATABASESEARCH- PATH contains a comma-separated list of directories in [host:]/path format. The application must call DtDbLoad before calling any of the routines that query either the action or data type databases. If called multiple times, the old databases are freed before the new ones are created.RETURN VALUEThe DtDbLoad function returns no value.APPLICATION USAGEIf this function is used in a long-lived application, the application must dynamically reload the databases when they are modified. To do this, the client must register to receive notification whenever the actions and data types database needs to be modified. It is up to the application to recall DtDbLoad after receiving notification. This is done with a call to DtDbReloadNotify(3). If errors are encountered when reading the database files, error messages are written to the user's errorlog file ($HOME/.dt/errorlog). Records containing errors are not incorporated into the internal database.SEE ALSODt/Action.h - DtAction(5), DtDbReloadNotify(3), dtdtfile(4). DtDbLoad(library call)