SL_TRUNK_DISABLE_REQ primitive

Purpose

Disable the specified trunk.

Requirement

Mandatory for signaling processes that registered with the capability SL_SIGPROC_CAPABILITY_TRUNK_MGMT. Otherwise this primitive is not used.

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

Description

The SL_TRUNK_DISABLE_REQ primitive is sent by Blueworx Voice Response system management to the signaling process to disable the specified trunk for calls. This primitive can be issued in any trunk state.

On receipt of the SL_TRUNK_DISABLE_REQ primitive, the signaling process disables the specified trunk from making and receiving calls. Once the signaling process replies successfully, by sending SL_TRUNK_DISABLE_CNF with ReplyCode set to SL_REPLY_SUCCESS, then the trunk is in state SL_TRUNK_STATE_DISABLED. All channels on the trunk are also disabled, and any calls in progress on the channels are cleared. The channels are in state SL_CHANNEL_STATE_DISABLED.

Corresponding state table action

None.

Corresponding user interface action

This primitive is issued by the system manager in response to the Disable button of the System Monitor window.

Note: For ISDN NFAS configurations only: the last trunk to be disabled must be a signaling trunk.

If the user requests that the last signaling trunk (primary or backup) is disabled, while any non-signaling trunk is still enabled, the System Monitor displays a dialog box.

When this trunk is carrying primary signaling, there are other enabled non-signaling trunks which will be put into SL_TRUNK_STATE_SIGPROC_ALARM state, and there is no (enabled) trunk carrying backup signaling:

This trunk may be carrying signaling for other trunks.

If you continue and disable this trunk, calls on the other trunks may be lost.

Do you wish to continue: Yes. No. Cancel.
When this trunk is carrying primary signaling, and there is an (enabled) trunk carrying backup signaling:

This trunk may be carrying signaling for other trunks.

If you continue and disable this trunk, calls on the other trunks may be lost.

Do you wish to continue: Yes. No. Cancel.
When this trunk is carrying backup signaling, and there is an (enabled) trunk carrying primary signaling:

This trunk may be carrying signaling for other trunks.

If you continue and disable this trunk, calls on the other trunks may be lost.

Do you wish to continue: Yes. No. Cancel.

If the user then chooses to disable the trunk, the SL_TRUNK_DISABLE_REQ will be sent to the signaling process.

Parameters

id: Eye-catcher that identifies the structure as containing a request primitive. This 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 will be allocated by Blueworx Voice Response, and is available to the sender on return from sl_send_request(). This field will be 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_DISABLE_CNF primitive.
Command.id: The primitive that the structure contains. Must be set to SL_TRUNK_DISABLE_REQ.
Parms.trunk_disable_request_st.sizetLength: Must be set to sizeof(struct _trunk_disable_request_st).
Parms.trunk_disable_request_st.iVpackNo: Identifies the trunk being disabled.