You are here: CSP API Reference > 1 EXS & SwitchKit API Messages > J1 Span Configure 0x0019

J1 Span Configure 0x0019

Configuration API Messages

SwitchKit Name

J1SpanConfig

Type

EXS API and SwitchKit API message

Description

J1 Span Configure 0x0019

This message is used by the host to configure the transmitted pattern of certain bits in different frames of a multi-frame over the J-ONE interface.

NOTE: Before changing span configuration, Dialogic ALWAYS RECOMMENDS that you de-assign the spans, assign them again and then send the new span configuration.

Sent by

Host

SwitchKit Code

Configuration

J1SpanConfig (

Node = integer,

StartSpanRange = integer,

EndSpanRange = integer,

ChanData = byte array,

FrameData = byte array);

C Structure

typedef struct {

unsigned short StartSpanRange;

unsigned short EndSpanRange;

UBYTE ChanData[6];

UBYTE FrameData[217];

} XL_J1SpanConfig;

C++ Class

class XLC_J1SpanConfig : public XLC_SpanRangeMessage {

public:

XBYTE getStartSpan() const;

XBYTE getEndSpan() const;

void setStartSpan(XBYTE s);

void setEndSpan(XBYTE s);

unsigned short getStartSpanRange() const;

void setStartSpanRange(unsigned short x);

unsigned short getEndSpanRange() const;

void setEndSpanRange(unsigned short x);

const UBYTE *getChanData() const;

UBYTE *getChanData();

void setChanData(UBYTE *x);

const UBYTE *getFrameData() const ;

UBYTE *getFrameData();

void setFrameData(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 (0x0019) | 3, 4 | Message Type (0x0019)
5 | Reserved (0x00) | 5 | Reserved (0x00)
6 | Sequence Number | 6 | Same Sequence Number
7 | Logical Node ID | 7 | Logical Node ID
: | AIB Address Method 0x01 - Range of AEs | 8, 9 | Status (MSB, LSB)
10 | AIB
: | Checksum
Number of AEs to follow 0x02
AEs 0x0C Logical Span (Starting) 0x0C Logical Span (Ending)
: | Channel Data[0] Bit mask of values for channels 1–5
: | Channel Data[1] Bit mask of values for channels 6–10
: | Channel Data[2] Bit mask of values for channels 11–15
: | Channel Data[3] Bit mask of values for channels 17–21
: | Channel Data[4] Bit mask of values for channels 22–26
: | Channel Data[5] Bit mask of values for channels 27–31
: | Frame Data[0] Bit mask of values for HG1–HG5 of Frame 0
: | Frame Data[1] Bit mask of values for HG1–HG5 of Frame 7
: | Frame Data[2] Bit mask of values for HG1–HG5 of Frame 8
: | Frame Data[3] Channel or Frame data bit mask of values for HG1–HG5 of Frame 15 Bit 7 Does not matter (MSB) Bit 6 Does not matter Bit 5 Does not matter Bit 4 HG1 Bit 3 HG2 Bit 2 HG3 Bit 1 HG4 Bit 0 HG5 (LSB)
: | Checksum

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