You are here: CSP API Reference > 1 EXS & SwitchKit API Messages > Connect With Data 0x0005
SwitchKit Name
Type
EXS API and SwitchKit API message
Description
This message instructs the Excel platform to connect two channels.
This message also supports canceling digit collection, playing of call progress tones, voice path connect functionality, and dynamic configuration of release modes.
If the terminating channel is not in an idle state, after seizure the alerting and connect indications will get propagated to the incoming side and the data specified in this message will get sent to the incoming ISDN channel.
You can use this message to pass parameter data for the ACM, ANM, or CON (ITU-TS only) in a connection between an incoming SS7 call (A Party) and another channel.
SIP (Call Agent)
The message carries the B side SDP (Session Description Protocol) information to the Excel platform in an NPDI Universal ICB and Generic PPL ICB. In a Generic PPL ICB, the Channel Service TLV indicates whether a bearer-switched or bearer-free connection is requested. For a bearer-free connection, the B side connection information is passed in the NPDI Universal ICB from the host.
Sent by
Example Message for EXS API
The following example message uses the Release Mode Configure ICB in a Connect With Data message to park Channel A (Span 0, Channel 0) and release Channel B (Span 0, Channel 1).
00 0D 00 005 00 00 FF 01 02 0D 03 00 00 00 0D 03 00 00 01 01 01 01 02 02 01 02
SwitchKit Code
C Structure
typedef struct {
unsigned short SpanA;
UBYTE ChannelA;
unsigned short SpanB;
UBYTE ChannelB;
UBYTE ConnectDataType;
UBYTE Data[222];
} XL_ConnectWithData;
C++ Class
class XLC_ConnectWithData : 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 getConnectDataType() const;
void setConnectDataType(UBYTE x);
const UBYTE *getData() const;
UBYTE *getData();
void setData(UBYTE *x);
};
EXS API Hex Format
MESSAGE (White) |
RESPONSE (Gray) |
||
Byte |
Field Description |
Byte |
Field Description |
0 |
Frame (0xFE) |
0 |
Frame (0xFE) |
1, 2 |
1, 2 |
Length (0x0007) |
|
3, 4 |
Message Type (0x0005) |
3, 4 |
Message Type (0x0005) |
5 |
Reserved (0x00) |
5 |
Reserved (0x00) |
6 |
Sequence Number |
6 |
Same Sequence Number |
7 |
Logical Node ID |
7 |
Logical Node ID |
: |
Address Method 0x00 - Individual AEs |
8, 9 |
Status (MSB, LSB) Additional information is provided in the LSB of the Status field to assist Excel Tech Support in explaining application processing scenarios. |
10, 11 |
State (MSB, LSB) If the MSB of the preceding Status field is 0x18 (Invalid Channel B State) or 0x1D (Invalid Channel A State), then this field indicates the component state. If the State value is greater than 0xFF (255), then it is truncated to 0xFF.
If the MSB of the preceding Status field is neither 0x18 nor 0x1D, then the value in this field is 0x0000.
If the preceding Status field is a positive acknowledgement, this field does not apply. |
||
12 |
Checksum |
||
Number of AEs to follow 0x02 |
|||
AEs |
|||
: |
Connect Data Type 0x01 Use ICBs 0x02 Reserved |
||
: |
Number of ICBs to follow (Ignore this field if no ICBs in message.) |
||
: |
Data (presented in an ICB) 0x02 Data ICBs 0x17 ISDN Formatted IEs With Event 0x03 Extended Data |
||
|
|||
: |
Checksum |