SL_CHANNEL_DISABLE_CNF primitive

Purpose

Confirm a request to disable a channel.

Requirement

Mandatory for common channel signaling processes. The primitive is not used by exchange data link 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_CONFIRM_PARM_ST Parms;
} SL_CONFIRM_ST;
...
typedef union {
...
                struct _channel_disable_confirm_st {
                    size_t sizetLength;
                    SL_REPLY_CODE ReplyCode;
                    int iChannelNo;
                    int iVpackNo;
                } channel_disable_confirm_st;
...
} SL_CONFIRM_PARM_ST;

Description

The SL_CHANNEL_DISABLE_CNF primitive is sent by the signaling process to the system manager to confirm that a channel has been disabled. Any calls on the channel have been cleared. After the signaling process has issued SL_CHANNEL_DISABLE_CNF with a ReplyCode of SL_REPLY_SUCCESS, the channel is in state SL_CHANNEL_STATE_DISABLED and can no longer be used to make or receive calls.

Corresponding state table action

None.

Corresponding user interface action

The Channel Out of Service window shows the channel as blocked.

Parameters

id

Eye-catcher that identifies the structure as containing a confirm primitive. Must be set to SLID_CONFIRM_ST.

iseq_no

The sequence number of the primitive. Must be set to the field iseq_no from the SL_CHANNEL_DISABLE_REQ primitive, to which this is the reply.

pidCHP

The process id of the requesting process. This should be set to the pidCHP field from the corresponding SL_CHANNEL_DISABLE_REQ primitive.

Command.id

The primitive that the structure contains. Must be set to SL_CHANNEL_DISABLE_CNF.

Parms.channel_disable_confirm_st.sizetLength

Must be set to sizeof(struct _channel_disable_confirm_st).

Parms.channel_disable_confirm_st.ReplyCode

Specifies whether the channel was disabled successfully or not.

SL_REPLY_ABORTED: The signaling process has received an SL_ABORT_REQ primitive specifying the sequence number of a SL_CHANNEL_DISABLE_REQ primitive. If the channel is not disabled, but calls may already have been cleared, the signaling process replies with SL_REPLY_ABORTED. If the channel is disabled, the signaling process should reply with SL_REPLY_SUCCESS.
SL_REPLY_INTERNAL_ERROR: The signaling process experienced an internal failure while processing the SL_CHANNEL_DISABLE_REQ primitive. The channel is in an indeterminate state.
SL_REPLY_SUCCESS: The channel has been disabled, and any calls have been cleared.
other values: Not supported.

Parms.channel_disable_confirm_st.iChannelNo

Identifies the channel which was disabled.

Parms.channel_disable_confirm_st.iVpackNo

Identifies the trunk associated with the call.