You are here: CSP API Reference > 1 EXS & SwitchKit API Messages > ISDN Interface Configure 0x0060

ISDN Interface Configure 0x0060

SwitchKit Name

ISDNInterfaceConfig

Type

EXS API and SwitchKit API message

Description

ISDN Interface Configure 0x0060

Use this message to configure general options to an ISDN interface. It should be sent immediately following the D Channel Assign message.

NOTE: PCM encoding for channels controlled by the D channel is defaulted based on the network signaling variant. E-1 spans configured for Euro-ISDN default to a-law, while all other variants default to µ-law. For more information, see the message PCM Encoding Format Configure (0x00D9).

Sent by

Host

SwitchKit Code

Configuration

ISNDInterfaceConfig (

Node = integer,

Span = integer,

Channel = integer,

Entity = integer,

Data = byte array);

C Structure

typedef struct {

unsigned short Span;

UBYTE Channel;

UBYTE Entity;

UBYTE Data[222];

} XL_ISDNInterfaceConfig;

C++ Class

class XLC_ISDNInterfaceConfig : public XLC_OutboundMessage {

public:

unsigned short getSpan() const;

void setSpan(unsigned short x);

UBYTE getChannel() const;

void setChannel(UBYTE x);

UBYTE getEntity() const;

void setEntity(UBYTE x);

int getMsgSize() const;

void setMsgSize(UBYTE x);

const UBYTE *getData() const;

UBYTE *getData();

void setData(UBYTE *x);

};

Overview of message

The following table provides an overview of this message. The table following it, provides the detail for each byte.

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 (0x0060) | 3, 4 | Message Type (0x0060)
5 | Reserved (0x00) | 5 | Reserved (0x00)
6 | Sequence Number | 6 | Same Sequence Number
7 | Logical Node ID | 7 | Logical Node ID
: | AIB (starting with byte 0) | 8, 9 | Status (MSB, LSB)
10 | Checksum
: | :
: | Entity
: | Data [0]
: | :
: | Checksum

EXS API Hex Format - Detailed

MESSAGE (White) | RESPONSE (Gray)
Byte | Field Description | Byte | Field Description
0 | Frame (0xFE) | 0 | Frame (0xFE)
1, 2 | Length (0xNNNN) | 1, 2 | Length (0x0007)
3, 4 | Message (0x0060) | 3, 4 | Message Type (0x0060)
5 | Reserved (0x00) | 5 | Reserved (0x00)
6 | Sequence Number | 6 | Same Sequence Number
7 | Logical Node ID | 7 | Logical Node ID
8, 9 | Status (MSB, LSB) 0x99 - Take D channel out of service before reconfiguring it.
: | AIB 0x00 - Individual AEs | 10 | Checksum
Number of AEs to follow
AE 0x0D Channel
: | Entity 0x01* Connection Type 0x02 Options (bit mask) 0x03 D Channel Physical Medium 0x03 Span/Channel/Subrate Length 0x04 HDLC Bit Polarity 0x05 Network Side Layer 2 0x06 B Channel Selection Mode 0x07 Location 0x08 Layer 4 Channel Release Request on ISDN Disconnect 0x09 Protocol Discriminator for Maintenance Messages 0x0A B Channel Encoding for Transmission 0x0B Load Information Library Entry For ISDN only. DASS 2/DPNSS has a different format and is documented in the DASS 2/DPNSS Data ICB area of this Publication Set. 0x0C Congestion Threshold 0x0D Fill Mask Functionality 0x0F Super Rate D Channel Data[0] Reserved Data[1] Number of D Channels (DSOs) 0x02 - 0x04 *If you use the value 0x01 (Connection Type) in the Entity field, you set all B channel parameters and the parameters below to their respective default values: PCM Encoding Format Release Modes Answer Supervision Mode If you must modify the default PPL Configuration Bytes or PPL Timers, you must first change the Connection Type.
: | Data[0] The meaning of the Data fields depends on the value of the Entity field. Valid entries for this field are listed below by Entity field value. Default values are marked with an asterisk (*). 0x01 Connection Type Data[0] 0x00 (Reserved) Data[1] User-Side Variants 0x01* Lucent 4ESS Q.931 PRI 0x02 Lucent 5ESS Q.931 PRI (Custom) 0x03 Northern Telecom DMS-100 Q.931 PRI (Custom) 0x04 Northern Telecom DMS-250 Q.931 PRI (Custom) 0x05 AUSTEL 0x06 JATE (INS 1500) 0x07 Euro-ISDN PRI (Includes French and German Delta) 0x08 Reserved 0x09 NI 2 User Side Connection endpoint variant 0x0A User Side LAPD variant 0x0B Reserved 0x0C UK DPNSS 0x0D* UK DASS 2 (This is the default, if the card is DASS 2/DPNSS.) Network-Side Variants 0x11-0x16 Reserved 0x17 Euro ISDN PRI 0x19 NI 2 Network Side endpoint variant 0x1A Network Side LAPD variant Changing the connection type modifies the PPL configuration bytes and timers to the default values for the type of CSP indicated. Therefore, change the PPL configuration bytes and timers after sending the PPL Interface Configuration message, which changes the connection type.
| 0x02 Options (Bit Mask) Data[0] 0x00 (Reserved) Data[1] This field is a bit mask, where 0=No and 1=Yes: Bit 0 Send Exact l2 Frames to the Host in a Diagnostic Indication message Bit 1 Reserved Bit 2 DPNSS Virtual Channel DLC Initialization disable. (Disables the initiation of a SABMR on the virtual channels.) 0 = Enabled (default) 1 = Disabled 0x03 D Channel Physical Medium Data[0] 0x00 (Reserved) Data[1] 0x01 64 kbps (T1/E1/J1)
| 0x04 HDLC Bit Polarity Data[0] 0x00 (Reserved) Data[1] 0x00* Normal 0x01 Inverted (typically used with T1 D4 and AMI line coding)
| 0x05 Network-Side Layer 2 Data[0] 0x00 (Reserved) Data[1] 0x00* User Side 0x01 Network Side (C/R Bit Inverted) If the Connection Type is set to a Network Side variant, this option is automatically set to Network Side 0x06 B Channel Selection Mode Data[0] 0x00 (Reserved) Data[1] 0x00 Disabled 0x01* Linear Clockwise 0x02 Linear Counter Clockwise 0x03 Circular Clockwise 0x04 Circular Counter Clockwise 0x07 Location Data[0] 0x00 (Reserved) Data[1] 0x00* User 0x01 Private network serving local user 0x02 Public network serving local user 0x03 Transit network 0x04 Public network serving remote user 0x05 Private network serving remote user 0x07 International network 0x0A Network beyond interworking point
| 0x08 Layer 4 Channel Release Request on ISDN Disconnect Data[0] 0x00 (Reserved) Data[1 ] 0x00* Do not send host Channel Release Request on ISDN Disconnect 0x01 Send host Channel Release Request on ISDN Disconnect. The host must respond to a Channel Release Request with a Release With Data message within 20 seconds. 0x09 Protocol Discriminator Value for Maintenance Messages Data[0] 0x00 (Reserved) Data[1] 0x03 0x0A B Channel Encoding for Transmission Data[0] 0x00 (Reserved) Data[1] 0x00* Channel Number 0x01 Slot Map 0x0B Load Information Library Entry Data[0] Entry Number (0x00-0x1D) Data[1] IE Type 0x01 Q.931 IE Include the following data fields only if Data[1] above is 0x01 (Q.931 IE type): Data[2] Total IE Length (0x00-0x1C) Data[3] IE Data
| 0x0C Congestion Threshold Data [0-3] Level 2 burst threshold. Range 1-10000 messages ( Default = 250 messages) Data [4-7] Level 2 average threshold Range 1-10000 messages ( Default = 1300 messages) Data [8-11] Abatement threshold Range 1-10000 messages ( Default = 300 messages) Data [12-15] Burst time window Range 1-10000 seconds ( Default = 1 second) Data [16-19] Number of samples in average Range 0-19 burst time windows ( Default =10 burst time windows) Data [20-23] Abatement window Range 1-10000 seconds ( Default = 5 seconds) Data [24--27] Level 1 burst threshold Range 1-10000 messages ( Default = 200 messages) Data [28-31] Level 1 average threshold Range 1-10000 messages ( Default = 1100 messages) For the Data Field values above, each value consists of four bytes (one "long word") * default value 0x0D Fill Mask Functionality Data [0] Range
: | Checksum

See Integrated Services Digital Network.
Data channel. One of two fundamental components of an ISDN interface, it provides a path (16Kbps for BRI, 64Kbps for PRI) for carrying control signals and call data in a packet-switched mode.
See Pulse Code Modulation.
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.
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
Bearer channel, 64Kbps (ISDN) The channel that carries the actual payload (as opposed to D-channels, which carry signaling data that helps route the payload).
Call processing layer of the CSP.
See Information Control Block.
See Programmable Protocol Language.
Call signaling protocol for setup and termination of calls.
Japan Approvals Institute for Telecommunications Equipment
Link Access Protocol (Procedure) – D channel (ISDN)
Digital communications link - voice, data, and video at a 1.544 Mbps rate (24 64 Kbps channels)
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.
A bit framing standard for traditional time-division multiplexing, which standard describes user channels multiplexed onto a trunk that has been segmented (framed) into 24 bytes of 8 bits each. Note: The multiplexing function is performed in the D-4 framing structure by interleaving bits of consecutive bytes as they are presented from individual circuits into each D-4 frame.