SL_TRUNK_RECONFIG_REQ primitive

Purpose

Request a signaling process to reconfigure itself because the configuration for a specified trunk has changed.

Requirement

Mandatory for all signaling processes.

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 _trunk_reconfig_request_st{
                    size_t sizetLength;
                    int iVpackNo;
                } trunk_reconfig_request_st;
...
} SL_REQUEST_PARM_ST;

Description

The SL_TRUNK_RECONFIG_REQ primitive is sent by the Blueworx Voice Response system manager to the signaling process.

The system manager sends the SL_TRUNK_RECONFIG_REQ primitive to all registered signaling processes after system start-up. The signaling process should read its configuration information. The signaling process should also use the sl_query_sigproc() and sl_query_channel_group() subroutines to determine which channels it controls. When the signaling process has read its configuration, it should reply by sending the SL_TRUNK_RECONFIG_CNF primitive.

The system manager also sends the SL_TRUNK_RECONFIG_REQ primitive to all registered signaling processes during normal operation, when the system configuration changes. This signaling process is responsible for re-reading its configuration information. The signaling process should also use the sl_query_sigproc() and sl_query_channel_group() subroutines to determine which channels it now controls. When the signaling process has read its configuration, it should reply by sending the SL_TRUNK_RECONFIG_CNF primitive.

Corresponding state table action

None.

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 sending process. The signaling process should use this value to set the pidCHP field of the corresponding SL_TRUNK_RECONFIG_CNF primitive.
Command.id: The primitive that the structure contains. Must be set to SL_TRUNK_RECONFIG_REQ.
Parms.trunk_reconfig_request_st.sizetLength: Must be set to sizeof(struct _trunk_reconfig_request_st).
Parms.trunk_reconfig_request_st.iVpackNo: The trunk being reconfigured, in the range SL_MIN_TRUNK_ID to SL_MAX_TRUNK_ID (see Pack and channel numbers).