IBMTromboneConn

This state table encapsulates some of the code needed to continue a trombone operation that is performed in several parts. It connects the caller with a third party that has already been contacted using the IBMTromboneMake state table. The call to the third party must have completed successfully for this state table to work successfully.

IBMTromboneConn uses the TromboneConnectCall function of the IBM_Trombone_Custom_Server. On successful completion, the caller is connected to the third party using the TDM bus.

This state table is called by the user’s application, along with a number of parameters, using the InvokeStateTable action. See IBMTromboneXmpA and IBMTromboneXmpB for examples of how to use this state table.

The source code is well commented and customization should be easy. The function to log data has been provided in a separate state table that may be invoked (IBMTromboneLog) to prevent this state table becoming too complex and cluttered.

Parameters

String log_filename (64 characters max):

If this is blank, no event logging is performed. If a filename is supplied, event logging of the trombone calls and the results are logged to an event log with the given filename. The logging is performed by the IBMTromboneLog state table.

Number call_status (this value is returned):

The returned status of the trombone operation.

If the value is zero, the trombone operation was successful and was terminated either by the third party hanging up, or by the caller requesting a disconnection by dialling the correct DTMF sequence.

If this value is non-zero, the trombone operation did not complete successfully. Table 1 shows the meanings of the possible call_status values.

This state table returns different edges depending on which range of possible values the call_status lies in (also defined in Table 1). This allows the general area of the problem to be determined immediately by the return edge of the InvokeStateTable action that called IBMTromboneConn.

The IBMTromboneConn state table can return any of the following values: 221, 222 to 206, and 228.