ADSI_Log

Use the ADSI_Log state table to write information to the log file. The log file is named $OAM_LOG_PATH/Appl.appl_name.log, where appl_name is the name of the state table that called the ADSI state tables.

Also, if the ADSI state tables detect an error, they invoke the ADSI_Log state table to put information about that error in the log file.

ASCII syntax

InvokeStateTable ("DIRECT", ADSI_Log, log, LogText, ReturnCode, File,
Function, State);

Entry point

log: You must specify the string log.

Description

LogText: Specify a text description of the error to be logged.
ReturnCode: Specify a state-table edge, or other return code.
File: Specify the name of the ADSI script being loaded.
Function: Specify the name of the ADSI function being loaded.
State: Specify the identity of the state returning the error.
In a default error handler, set this to SV163.

Results

The ADSI_Log state table adds the following to the data you supply:

Date (SV36)
Channel (SV165)
Called-number information (SV185)

The state table concatenates all the information, then writes it as a line in the log file.

Example

In this example, the message Now calling ADSI to connect is added to the log file.

InvokeStateTable("DIRECT", ADSI_Log, log,

                "Now calling ADSI to connect",

1,

                "puthex.sdc",

                "connect",

                SV163)

An example of the information written to the log file is:

ADSI date=199803231429282 channel=1 called number=4085551234 file=getcpe.sdc
function=connect error=SDC file not found state=e2 return code=1