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

SS7 Signaling Link Configure 0x005E

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

Host

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 : | AIB Address Method 0x00 - Individual AEs) | 8, 9 | Status (MSB, LSB)
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 0xC0 V.35, 48 Kbps
: | 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

Address Element

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

See Signaling System Number Seven.
A computer, attached to the Excel platform through an RS-232 or Ethernet link, from which you run the telecommunications application that controls the Excel platform.
Connection used for the transmission of high-speed data.
Data Terminal Equipment. According to the RS-232-C standard, DTE devices are typically personal computers or data terminals. See DCE.
Range of channels provided by T1 or E1 transmission service. A physical span is a group of channels taking up a single physical wire. A logical span is a group of channels taking up less than a single logical wire, or carried over more than one physical wire.
A group of data bits in a specific format, with a flag at each end to indicate the beginning and the end of the frame.
See Address Information Block.
Most Significant Bit
Least Significant Bit
Data Communications Equipment. According to the RS-232-C standard, DCE devices are typically modems or printers. See DTE.
The information in an AIB that follows the header, down to the data field. An AIB can have one or more Address Elements. AEs correspond to Span, Channel, and SS7 Link.
Link that connects to the same node