You are here: CSP API Reference > 1 EXS & SwitchKit API Messages > SS7 Signaling Link Configure 0x005E
SS7 Signaling Link Configure 0x005E
SwitchKit Name
SS7SignalingLinkConfig
Type
EXS API and SwitchKit API message
Description
This message defines a signaling link and assigns it to a link set. You can also use this message to subsequently deconfigure a signaling link.
Sent by
Example Message (Socket Log Output for SwitchKit)
The following example message defines signaling link 0x05 on a primary SS7 card. The signaling link is assigned to link set 0x23. The link’s data rate is
64 Kbps rate and the electrical interface is V.35 DTE (Data Terminal Equipment).
00 14 00 5E 00 00 FF 00 02 1F 03 00 23 05 0D 03 00 01 17 01 00 01
SwitchKit Code
Configuration
SS7SignalingLinkConfig (
Node = integer,
StackID = integer,
LinkSetID = integer,
LinkID = integer,
Span = integer,
Channel = integer,
SLC = integer,
DataRate = integer,
ElectricalInterface = integer,
C Structure
typedef struct {
UBYTE AddrInfo[4];
UBYTE StackID;
UBYTE LinkSetID;
UBYTE LinkID;
unsigned short Span;
UBYTE Channel;
UBYTE SLC;
UBYTE DataRate;
UBYTE ElectricalInterface;
UBYTE Reserved;
} XL_SS7SignalingLinkConfig;
C++ Class
class XLC_SS7SignalingLinkConfig : public XLC_OutboundMessage {
public:
const UBYTE *getAddrInfo() const;
UBYTE *getAddrInfo();
void setAddrInfo(UBYTE *x);
UBYTE getStackID() const;
void setStackID(UBYTE x);
UBYTE getLinkSetID() const;
void setLinkSetID(UBYTE x);
UBYTE getLinkID() const;
void setLinkID(UBYTE x);
unsigned short getSpan() const;
void setSpan(unsigned short x);
UBYTE getChannel() const;
void setChannel(UBYTE x);
UBYTE getSLC() const;
void setSLC(UBYTE x);
UBYTE getDataRate() const;
void setDataRate(UBYTE x);
UBYTE getElectricalInterface() const;
void setElectricalInterface(UBYTE x);
UBYTE getReserved() const;
void setReserved(UBYTE x);
};
EXS API Hex Format
MESSAGE (White) |
RESPONSE (Gray) |
||
Byte |
Field Description |
Byte |
Field Description |
0 |
Frame (0xFE) |
0 |
Frame (0xFE) |
1, 2 |
Length (0x00NN) |
1, 2 |
Length (0x0007) |
3, 4 |
Message Type (0x005E) |
3, 4 |
Message Type (0x005E) |
5 |
Reserved (0x00) |
5 |
Reserved (0x00) |
6 |
Sequence Number |
6 |
Same Sequence Number |
7 |
Logical Node ID |
7 |
Logical Node ID |
8 : |
Address Method 0x00 - Individual AEs) |
8, 9 |
|
10 |
Checksum |
||
Number of AEs to follow 0x02 |
|||
AEs See Address Element following this table. |
|||
: |
Signaling Link Code (SLC) The SLC must be the same on both ends of the link (0x00–0x0F). |
||
: |
Data Rate
0x00 64 Kbps 0x01 56 Kbps for non-V.35 applications 0x80 V.35, 56 Kbps 0x81 48 Kbps for non-V.35 applications
|
||
: |
Electrical Interface
0xn0 No timing (Not a Multi-Protocol I/O link) 0xn1 V.35, DTE (Data Terminal Equipment) 0xn2 V.35, DCE (Data Communications Equipment)
The value for n is as follows:
Bit-4 (0x1n) is used to invert the data stream on non-MPIO (normal DS0) configurations. Bit 7 (0x8n) is used to invert the data stream on MPIO configurations. The options are as follows:
Invert data stream on non-MPIO configurations: 0x11 - V.35, DTE (Data Terminal Equipment) 0x12 - V.35, DCE (Data Communications Equipment)
Invert data stream on MPIO configurations: 0x81 - V.35, DTE (Data Terminal Equipment) 0x82 - V.35, DCE (Data Communications Equipment) |
||
: |
Checksum |
To configure and deconfigure a link, use a combination of the Link ID and Channel address type, as follows:
Byte |
AIB Field Description |
---|---|
2 |
Address Element (0x1F) |
3 |
Data Length (0x03) |
4 |
Data[0] Stack ID |
5 |
Data[1] Link Set ID This field indicates the signaling link set to which this link is being assigned. 0x00-0x23 Signaling Link Sets 0–35 0xFF Deconfigure the specified signaling link |
6 |
Data[2] Link ID This field indicates values that are assigned by the host to links on an SS7 card. Values for this field depend on how many links are supported by the card and whether it is a primary or secondary card. With a 16-link card, valid entries for this field are as follows: 0x00-0x0F Primary SS7 Card: 0x10-0x1F Secondary SS7 Card: |
7 |
Address Element (0x0D) |
8 |
Data Length (0x03) |
9 |
Data[0] – Logical Span ID, MSB |
10 |
Data[1] – Logical Span ID, LSB |
11 |
Data[2] – Channel |