SL_USER_CNF primitive

Purpose

Confirm the processing of an implementation-dependent feature.

Requirement

Optional for all signaling processes. If a signaling process supports SL_USER_REQ, it must also support this primitive.

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 _user_confirm_st{
                    size_t sizetLength;
                    SL_REPLY_CODE ReplyCode;
                    int Command
                    int iChannelNo
                    int iVpackNo
                    unsigned char data [SL_USER_DATA_LEN]	
                } user_confirm_st;
...
} SL_CONFIRM_PARM_ST;

Description

The SL_USER_CNF primitive is sent by the signaling process to a custom server process in response to an SL_USER_REQ primitive.

The interpretation and usage of the SL_USER_REQ primitive is up to the signaling process. If the signaling process does not support the SL_USER_REQ primitive, it should respond by issuing sl_send_confirm(), specifying an SL_USER_CNF primitive with ReplyCode set to SL_REPLY_NOT_IMPLEMENTED.

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_USER_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_USER_REQ primitive.

Command.id

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

Parms.user_confirm_st.sizetLength

Must be set to sizeof(struct _user_confirm_st).

Parms.user_confirm_st.ReplyCode

Specifies the success, or otherwise of the primitive.

SL_NOT_IMPLEMENTED: The signaling process does not support the SL_USER_REQ primitive, or does not support the value of Parms.user_request_st.command specified in the SL_USER_REQ primitive.
SL_REPLY_SUCCESS: Success.
other values: Failure.

Parms.user_confirm_st.command

The value of this field is implementation-dependent. This should be set to the Command field from the corresponding SL_USER_REQ primitive.

Parms.user_confirm_st.iChannelNo

Identifies the channel, in the range SL_MIN_CHANNEL_ID to SL_MAX_CHANNEL_ID (see Pack and channel numbers).

Parms.user_confirm_st.iVpackNo

Identifies the trunk, in the range SL_MIN_TRUNK_ID to SL_MAX_TRUNK_ID (see Pack and channel numbers).

Parms.user_confirm_st.data

Up to SL_USER_DATA_LEN bytes of implementation-dependent data. The interpretation of this field depends on the value of Parms.user_request_st.command, and is defined by the provider of the signaling process.