SL_CHANNEL_QUIESCE_CNF primitive

Purpose

Confirm that a specified channel has been quiesced.

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_quiesce_confirm_st{
                    size_t sizetLength;
                    SL_REPLY_CODE ReplyCode;
                    int iChannelNo;
                    int iVpackNo;
                }channel_quiesce_confirm_st;
...
} SL_CONFIRM_PARM_ST;

Description

The SL_CHANNEL_QUIESCE_CNF primitive is sent by the signaling process to the system manager to confirm that a channel has been quiesced. Any calls on the channel have been cleared. When the signaling process has issued SL_CHANNEL_QUIESCE_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_QUIESCE_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_QUIESCE_REQ primitive.

Command.id

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

Parms.channel_quiesce_confirm_st.sizetLength

Must be set to sizeof(struct _channel_quiesce_confirm_st).

Parms.channel_quiesce_confirm_st.ReplyCode

Specifies whether the channel was quiesced successfully or not.

SL_REPLY_ABORTED: If the signaling process receives an SL_ABORT_REQ specifying the sequence number of a SL_CHANNEL_QUIESCE primitive, it may abort the processing, and send SL_CHANNEL_QUIESCE_CNF with a ReplyCode set to SL_REPLY_ABORTED. The channel remains in the state SL_CHANNEL_STATE_ENABLED.
SL_REPLY_INTERNAL_ERROR: The signaling process experienced an internal failure while processing the SL_CHANNEL_QUIESCE_REQ primitive. The channel is in an indeterminate state.
SL_REPLY_SUCCESS: The channel has been quiesced successfully, and may no longer be used to make or receive calls. The channel is now in state SL_CHANNEL_STATE_DISABLED.
other values: Not supported.

Parms.channel_quiesce_confirm_st.iChannelNo

Identifies the channel that was quiesced.

Parms.channel_quiesce_confirm_st.iVpackNo

Identifies the trunk on which the channel is located.