You are here: CSP API Reference > 1 EXS & SwitchKit API Messages > SS7 Signaling Stack Configure 0x005C

SS7 Signaling Stack Configure 0x005C

SwitchKit Name

SS7SignalingStackConfig

Type

EXS API and SwitchKit API message

Description

SS7 Signaling Stack Configure 0x005C

Use this message to define a signaling stack, which includes assigning an OPC and a variant. You can also use this message to deconfigure a signaling stack.

NOTE: PCM encoding for CICs controlled by the signaling stack is defaulted based on the network signaling variant. ANSI stacks default to u-law regardless of the physical link type. ITU stacks default to A-law. To change the encoding format see the PCM Encoding Format message.

Sent by:

Host

SwitchKit Code

Configuration

SS7SignalingStackConfig (

Node = integer,

Slot = integer,

Stack = integer,

OPC = integer,

NumModules = integer,

Data = byte array);

C Structure

typedef struct {

UBYTE Slot;

UBYTE Stack;

int OPC;

UBYTE NumModules;

UBYTE Data[218];

} XL_SS7SignalingStackConfig;

C++ Class

class XLC_SS7SignalingStackConfig : public XLC_OutboundMessage {

public:

UBYTE getSlot() const;

void setSlot(UBYTE x);

UBYTE getStack() const;

void setStack(UBYTE x);

int getOPC() const;

void setOPC(int x);

UBYTE getNumModules() const;

void setNumModules(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 | Length (0x00NN) | 1, 2 | Length (0x0007)
3, 4 | Message Type (0x005C) | 3, 4 | Message Type (0x005C)
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) The meaning of these fields depends upon the value of the Entity field in the message. Product License Data The following value can be received: 0x007F Software module still locked. This value is returned when attempting to configure a locked module for which no product license key has been downloaded.
10 | Checksum
Number of AEs to follow |
AEs 0x21 SS7 Slot
: | OPC (four bytes) The address assigned to the CSP by the network. Every point code in the API messages will always be 4 bytes long, with the first byte (MSB) as zero. See the SS7 section of the API Developer's Guide: CCS for an explanation of how to convert the 4 bytes into ITU and ANSI point codes. 0x00000000–0x00FFFFFF: The OPC must be in this range for signaling stacks using 24-bit point codes, for example ANSI. 0x00000000–0x00003FFF: The OPC must be in this range for signaling stacks using 14-bit point codes, for example ITU. If using the BT IUP protocol, the maximum range for OPC is 14 bits. 0xFFFFFFFF: This value indicates deconfiguration of the specified signaling stack. All link sets, links, destinations, and routes previously configured to this signaling stack must be deconfigured before you deconfigure the signaling stack.
13 | Number of Modules (n)
11 | Module 1: Type 0x01 MTP (Message Transfer Part) Required for any SS7 configuration or for BT IUP 0x02 ISUP (ISDN User Part) Required if you are using the ISUP Call Control User Part 0x03 L3P (Layer 3 Plus) Required for any SS7 configuration 0x04 TUP (Telephone User Part) Required if you are using the TUP Call Control User Part 0x05 L3P TUP/BT IUP (Layer 3 Plus for Telephone User Part/BT IUP) Required if you are using the TUP or BT IUP Call Control User Part 0x06 SCCP 0x07 TCAP 0x08 M3UA When using BT IUP, you must configure MTP. For example, if you are configuring the ISUP Call Control User Part, then you would send this message with three sets of module Type and Variant fields: MTP, L3P, and ISUP. When using the BT IUP variant, the Module Variant is 0x02. You must also configure module types 0x01and 0x03. For example, in an E1 configuration, you would specify Module Type 0x01 with a variant of 0x01, Module 3 with a variant of 0x01, Module 4 with a variant of 0x02, and Module 5 with a variant of 0x02.
: | Module 1: Variant (see information below this table)
: | Module n: Type
: | Module n: Variant
: | Checksum

Module Variant

The following variants are tested and supported.

Value | Description | Modules
--- | --- | ---
0x00 | ANSI ‘97 | All Modules (except TUP or BT IUP)
0x01 | ITU-TS ‘97 | All Modules
0x02 | BT IUP | Module Types 4 and 5 when BT IUP is required
0x03 | SSUTR2 | Module Types 4 and 5 when BT IUP is required
0x08 | JT | Module Types 1, 2, and 3

See Signaling System Number Seven.
See Pulse Code Modulation.
American National Standards Institute. ANSI administers and coordinates the U.S. voluntary standardization and conformity assessment system for the
telecommunications industry. More details on these standards may be
viewed at www.ansi.org.
International Telecommunications Union (UN)
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.
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
See Common Channel Signaling.
See Message Transfer Part.
MTP. Message Transfer Part of the SS7 signaling protocol.
See Integrated Services Digital Network User Part.
See Integrated Services Digital Network.
Setting up, monitoring, and tearing down calls.
Protocol layer of the CSP.
Telephone User Part
See Transaction Capability Application Part.
A digital communications link - voice, data, and video at a 2.048 Mbps rate; 30B/2D or 31B/1D (ISDN); non-North American version of T1.