SL_CALL_RECONNECT_REQ primitive

Purpose

Request the reconnection of the original caller to Blueworx Voice Response, during or after a call transfer.

Requirement

Optional for all signaling processes. This primitive is one of the primitives used to implement the call transfer capability. signaling processes that implement the call transfer capability should specify SL_SIGPROC_CAPABILITY_TRANSFER on registration.

Library

The signaling interface library (libsl.a).

C syntax

typedef struct {
                SL_ID id;
                int iseq_no;
                pid_t pidCHP;
                SL_PRIMITIVE_TYPE Command;
                SL_REQUEST_PARM_ST Parms;
} SL_REQUEST_ST;
...
typedef union {
...
                struct _call_reconnect_request_st {
                      size_t sizetLength;
                      it monitor_time;
                      int iChannelNo;
                      int iVpackNo;
                      SL_APPL_INFO_ST slApplInfo;
                } call_reconnect_request_st;
...
} SL_REQUEST_PARM_ST;

Description

The SL_CALL_RECONNECT_REQ primitive is sent by the channel process to the signaling process to request to reconnect the original caller to Blueworx Voice Response after an unsuccessful call transfer. After attempting a call transfer which does not succeed, the original caller is assumed to be on hold, and Blueworx Voice Response is assumed to no longer be connected. The channel process reconnects the original caller to Blueworx Voice Response by sending an SL_CALL_RECONNECT_REQ primitive to the signaling process. The signaling process then signals to the network to reconnect the two parties. After the original caller has been reconnected to Blueworx Voice Response the signaling process sends back the SL_CALL_RECONNECT_CNF primitive. If the original caller cannot be reconnected for any reason, the signaling process sends the SL_CALL_RECONNECT_CNF primitive with the ReplyCode set to indicate the error.

Corresponding state table action

The SL_CALL_RECONNECT_REQ primitive and the matching SL_CALL_RECONNECT_CNF correspond to the ReconnectCall state table action. See the Blueworx Voice Response for AIX: Application Development using State Tables information.

Parameters

id: Eye-catcher that identifies the structure as containing a request primitive. Must be set to SLID_REQUEST_ST.
iseq_no: The sequence number of the primitive. This field must be set to 0 when the primitive is sent to Blueworx Voice Response; the actual sequence number is allocated by Blueworx Voice Response, and is available to the sender on return from sl_send_request(). The field is set when the primitive is received from Blueworx Voice Response by the signaling process.
pidCHP: The process id of the channel process. The signaling process should use this value to set the pidCHP field of the corresponding SL_CALL_RECONNECT_CNF primitive.
Command.id: The primitive that the structure contains. Must be set to SL_CALL_RECONNECT_REQ.
Parms.call_reconnect_request_st.sizetLength: Must be set to sizeof(struct _call_reconnect_request_st).
Parms.call_reconnect_request_st.monitor_time: This field contains the value specified in the Monitor Time parameter of the ReconnectCall state table action. The value specified by the state table may be ignored by common channel signaling processes.
Parms.call_reconnect_request_st.iChannelNo: Identifies the channel associated with the call.
Parms.call_reconnect_request_st.iVpackNo: Identifies the trunk associated with the call.
Parms.call_reconnect_request_st.slApplInfo: Contains both the length of the call information tag string (including the null terminator '\0') and the call information tag string array itself. The string is used to pass information between state tables and the signaling process. For more information see SL_APPL_INFO_ST data structure