Name

bstr_trc_initialize − Initializes the Source Trace Manager environment. 

Syntax

bstr_t_status   bstr_trc_initialize (
                                   char   ∗var_process_selector,
                                   char   ∗database_name);

Description

The bstr_trc_initialize procedure initializes the Source Trace Manager environment. 

It checks the existence of database_name, and then looks for the var_process_selector global variable in order to determine which Process_Selector has to be used. 

Arguments

var_process_selector
access: read
The name of the global variable that contains the  name of the Process_Selector to be used during the trace work session. The variable value must be set using the appropriate platform-dependent  command interpreter commands.

If the specified global variable has not been set or var_process_selector has been set to NULL, a volatile Process_Selector is created. 

A volatile Process_Selector name is in the format TRC_xxxxx, where xxxxx is the Process Identifier of the application that invoked the bstr_trc_initialize procedure. 

database_name
access: read
The name of the Source Trace Manager database containing the configuration data. It must be created using the CREATE DATABASE CLI command.

You can specify a pathname of up to 128 characters. If you specify a relative pathname, the database is searched for using the pathname indicated in the global variable BSTR_TRC_PATH, which can be set with one or more pathnames separated by means of blank characters. 

Return Values