Connect One-Way Forced 0x0050

SwitchKit Name

ConnectOneWayForced

Type

EXS API and SwitchKit API message

Description

This message establishes a one-way connection between two channels, where Channel A is the source channel (talk only) and Channel B is the destination channel (listen only).

With this connection, the Excel platform does not do any checking on the state of Channel A; it can be in any state. This lessens the degree of call processing required, resulting in a significantly faster call rate. Channel B, however, must be in an acceptable connection state.

The connection will only be torn down if Channel B is released by the host, or as a result of a network-initiated release.

When performing a "Connect One-Way Forced A-to-B" on a multi-node system, you must send this message to the node containing the "B" channel.

NOTE: While this API message can be used during call flow, the one-way connection will not be maintained through a Matrix Controller switchover.

For SwitchKit: If you use the ConnectOneWayForced message in your call control application, you need to specify which node you want the message to be sent to. You can specify the node within the C Structure field BaseFields Base (NodeID) or within in the C++ Class through inheritance from SKC_Message (getNode, setNode).

Sent by

Host

SwitchKit Code

C Structure

typedef struct {

unsigned short SpanA;

UBYTE ChannelA;

unsigned short SpanB;

UBYTE ChannelB;

UBYTE BPad;

} XL_ConnectOneWayForced;

C++ Class

class XLC_ConnectOneWayForced : public XLC_OutboundMessage {

public:

unsigned short getSpanA() const;

void setSpanA(unsigned short x);

UBYTE getChannelA() const;

void setChannelA(UBYTE x);

unsigned short getSpanB() const;

void setSpanB(unsigned short x);

UBYTE getChannelB() const;

void setChannelB(UBYTE x);

UBYTE getBPad() const;

void setBPad(UBYTE x);

};

EXS API Hex Format