You are here: CSP API Reference > 1 EXS & SwitchKit API Messages > Subrate Connection Management 0x000D

Subrate Connection Management 0x000D

SwitchKit Name

SubrateConnectionManagement

Type

EXS API and SwitchKit API message

Description

Subrate Connection Management 0x000D

This message is used to establish and tear down subrate connections. Both channels should be out of service before the connection is established.

Sent by

Host

SwitchKit Code

C Structure

typedef struct {

BaseFields Base;

unsigned short SubrateSpanA;

unsigned short SubrateChannelA;

UBYTE NumBitsA;

unsigned short SubrateSpanB;

unsigned short SubrateChannelB;

UBYTE NumBitsB;

UBYTE reserved27[20];

UBYTE Action;

UBYTE reserved48[222];

} XL_SubrateConnectionManagement;

C++ Class

class XLC_SubrateConnectionManagement : public XLC_OutboundMessage {

public:

virtual MsgStruct *getStructPtr();

virtual const MsgStruct *getStructPtr() const;

virtual int getTag() const;

unsigned short getSubrateSpanA() const;

void setSubrateSpanA(unsigned short x);

unsigned short getSubrateChannelA() const;

void setSubrateChannelA(unsigned short x);

UBYTE getNumBitsA() const;

void setNumBitsA(UBYTE x);

unsigned short getSubrateSpanB() const;

void setSubrateSpanB(unsigned short x);

unsigned short getSubrateChannelB() const;

void setSubrateChannelB(unsigned short x);

UBYTE getNumBitsB() const;

void setNumBitsB(UBYTE x);

UBYTE getAction() const;

void setAction(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 (0x000D) | 3, 4 | Message Type (0x000D)
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) See Response Status Values.
Number of AEs to follow 0x02 | 10 | Checksum
AEs 0x25 - Subrate Channel |
: | Action 0x01 1-way Subrate Connection 0x02 2-way Subrate Connection 0x03 Disconnect
: | Checksum

Address Element

0x25 - Subrate Channel

Use the Subrate Channel Address Type to address two subrate channels.

For a 1-way connection, enter the source subrate channel in Address Element 1 and the destination subrate channel in Address Element 2.

For a 1-way disconnect, enter the subrate channel to be disconnected in both Address Element 1 and Address Element 2.

Byte | Description | Value
--- | --- | ---
Address Element 1: Subrate Channel A
2 | Address Type | 0x25
3 | Data Length | 0x05
4 | Data[0] - Logical Span ID, MSB |
5 | Data[1] - Logical Span ID, LSB |
6 | Data[2] - Subrate Channel ID, MSB |
7 | Data[3] - Subrate Channel ID, LSB |
8 | Data[4] - Number of Bits in Subrate Channel |
Address Element 2: Subrate Channel B
9 | Address Type | 0x25
10 | Data Length | 0x05
11 | Data[0] - Logical Span ID, MSB |
12 | Data[1] - Logical Span ID, LSB |
13 | Data[2] - Subrate Channel ID, MSB |
14 | Data[3] - Subrate Channel ID, LSB |
15 | Data[4] - Number of Bits in Subrate Channel |

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
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.
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.