You are here: CSP API Reference > 1 EXS & SwitchKit API Messages > System Configuration 0x00AF

System Configuration 0x00AF

SwitchKit Name

SystemConfig

Type

EXS API and SwitchKit API message

Description

System Configuration 0x00AF

This message configures system, non-related options.

Those options include:

• Message Resend Logic

• Host Link Failure Detection Logic

• System Busy Warning

• Resource Threshold

Sent by

Host Application

Example Message (Socket Log Output for SwitchKit)

The following socket log output/example message shows the line card in slot 01 configured not to resend unacknowledged messages.

00 07 00 AF 00 00 FF 02 00

SwitchKit Code

Configuration

SystemConfig (

Node = integer,

ConfigType = integer,

Data = byte array);

NOTE: Data must contain the Slot AIB first:

0x00 0x01 0x01 0x01 SlotNumber

then the Data of the message as usual.

Example

This is an example of a SwitchManager message:

SystemConfig(Node=1, ConfigType=9, Data=0x00:0x01:0x01:0x01:0x05: 0x01:0x04:0x00:0x01:0x02:0x03);

In this example, the slot number is: 0x00:0x01:0x01:0x01

in the slot AIB; and the data parameters of the message are: 0x01:0x04:0x00:0x01:0x02:0x03.

C Structure

typedef struct {

UBYTE ConfigType;

UBYTE Data[252];

} XL_SystemConfig;

C++ Class

class XLC_SystemConfig : public XLC_OutboundMessage {

public:

UBYTE getConfigType() const;

void setConfigType(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 (0xNNNN) | 1, 2 | Length (0x0007)
3, 4 | Message Type (0x00AF) | 3, 4 | Message Type (0x00AF)
5 | Reserved (0x00) | 5 | Reserved (0x00)
6 | Sequence Number | 6 | Same Sequence Number
7 | Logical Node ID | 7 | Logical Node ID
8 | Configuration Type | 8, 9 | Status MSB, LSB
9 : | AIB Address Method | 10 | Checksum
Number of AEs to follow
AEs
: | Data
: | :
: | 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 Type (0x00AF) | 3, 4 | Message Type (0x00AF)
5 | Reserved (0x00) | 5 | Reserved (0x00)
6 | Sequence Number | 6 | Same Sequence Number
7 | Logical Node ID | 7 | Logical Node ID
8 | Configuration Type | 8, 9 | Status MSB, LSB
|  | 10 | Checksum
| 0x00 Reserved 0x01 Reserved 0x02 Message Resend Logic 0x03 Host Link Failure Detection Logic 0x06 System Busy Warning 0x07 Resource Threshold 0x09 Resource Usage Reporting 0x0B Approaching Busy Threshold for Slots 0x0C Real Busy Threshold for Slots 0x0D Message Grouping 0x11 DSP Resource Threshold Alarm 0x17 Extended Conference Enable
9 : | AIB Address Method Used by the following Configuration Types only: 0x03 Host Link Failure Detection Logic 0x07 Resource Threshold 0x09 Resource Usage Reporting 0x0B Approaching Busy Threshold for Slots 0x0C Real Busy Threshold for Slots
Number of AEs
AEs 0x01 Slot Must be included if Host Link Failure is for line cards.
: | Data[0] ( Data depends on the Configuration Type)
: | 0x02 Message Resend Logic Data[0] Options 0x00 Do Not Resend Does not resend unacknowledged messages. 0x01 Resend Once (Default)* 0x02 Resend Once and Generate Alarm Message 0x03 Resend Until Acknowledged* Resends the message until acknowledged by the host. This applies to the following messages only: Alarm, Alarm Cleared, Request For Service, Request For Service with Data, and Channel Released. 0x04 Disable "Resend Until Acknowledged" Do not resend the messages listed above until acknowledged by the host. This cancels "Resend Until Acknowledged." *To enable "Resend Until Acknowledged" you must also enable "Resend Once"
| 0x03 Host Link Failure Detection Logic Data[0] Feature Enable/Disable 0x00 Disable Host Link Failure Detection (Default) 0x01 Enable Host Link Failure Detection Data[1] Response to Host Link Failure (HLF) Bit 0 Setting for whether spans and channels will be taken out-of-service 0 Set all channels out of service when host link failure detected (Default) 1 Set all spans and channels out of service when host link failure detected Bit 1 Setting for whether a response will be sent when an HLF is detected 0 A response will be sent 1 No response will be sent Bit 2 Setting for taking SCCP/TCAP out-of-service 0 Do not take SCCP/TCAP out-of-service 1 Take SCCP/TCAP out-of-service Data[2,3] Failure Detection Timer Value expressed in 10 ms units NOTE: The span/channels continue in the out-of-service state until the host manually brings them back in-service.
| 0x06 System Busy Warning Data[0] Sensitivity Level 0x00 Least Sensitive 0x01 : 0x02 : 0x03 : 0x04 : 0x05 Most Sensitive Data[1] System Busy Warning 0x00 Disable (Default) 0x01 Enable
| 0x07 Resource Threshold Data[0] Resource Type 0x01 Conferencing Timeslots Data[1,2] Number of Assigned Timeslots to Generate an Alarm Cleared message Data[3,4] Number of Assigned Timeslots to Generate an Alarm message
| 0x09 Resource Usage Reporting Data[0] 0x00 Disable (Default) 0x01 Enable (Default interval is 5 minutes) 0x02 Change the Reporting Interval Data[1] If Data[0] above is 0x00 (Disable) or 0x01 (Enable): Number of Resources If Data[0] above is 0x02 (Change the Reporting Interval): Number of Minutes (Max: 254) Data [2-N] Resource ID 1- Resource ID N: NOTE: If Data[0] above is 0x02, Data[2-N] do not apply. 0x00 Memory 0x01 MCB 0x02 CPU Level 1 0x03 CPU Level 2
| 0x0B Approaching Busy Threshold for Slots Data[0] 0x00 Disable 0x01 Enable Default value are as follows: Memory - 70 percent MCB -70 percent CPU - 80 percent. 0x02 Change Thresholds Data[1] Number of Resources Data [2-N] Resource ID 1- Resource ID N: 0x00 Memory (percentage, expressed in Hex) 0x01 MCB (percentage, expressed in Hex) 0x02 CPU Usage (percentage, expressed in Hex)
| 0x0C Real Busy Threshold for Slots Data[0] 0x00 Disable Alarm (Default) 0x01 Enable Alarm Default value are as follows: Memory - 84 percent MCB -84 percent CPU - 90 percent. Data[1] Number of Resources Data[2-N] Resource ID 1- Resource ID N: 0x00 Memory (percentage, expressed in Hex) 0x01 MCB (percentage, expressed in Hex) 0x02 CPU Usage (percentage, expressed in Hex)
| 0x0D Message Grouping (Supported on ONE-series cards only) Data[0] 0x00 Disable (Default) 0x01 Enable 0x11 DSP Resource Threshold Alarm Data[0] DSP Function Type 0xFF Configure all DSP Function Types (except conferences) with the percentage values in Data[1] and Data[2] below 0x00 No Function Type Tone Reception 0x01 DTMF µ-law (all DSP cards) 0x02 MFR1 µ-law (all DSP cards) 0x03 DTMF A-Law (all DSP cards) 0x04 MFR1 A-Law (all DSP cards) 0x05 MFR2 A-Law (all DSP cards) 0x06 MFR2 µ-Law (all DSP cards) 0x07 CPA A-Law (all DSP cards) 0x08 CPA µ-Law (all DSP cards) 0x09 E1 Dial Pulse (MFDSP and DSP-ONE cards only) 0x0A Energy Detection (all DSP cards) 0x0C DTMF High Pass Filter µ-Law (MFDSP card only) 0x0D DTMF High Pass Filter A-Law (MFDSP card only) 0x0E Coin Detection µ-Law (DSP-ONE card only) 0x0F Coin Detection A-Law (DSP-ONE card only) Tone Generation 0x10 DTMF mu-law 0x11 DTMF A-law 0x12 MFR1 mu-law 0x13 MFR1 A-law 0x14 CPT4 mu-law 0x15 CPT4 A-law 0x16 MFR2 Forward A-law 0x17 MFR2 Forward mu-law 0x18 MFR2 Backward A-law 0x19 MFR2 Backward mu-law 0x1A Bong Tone mu-law 0x1B Bong Tone A-law 0x30 Universal Tone Generation mu-law 0x31 Universal Tone Generation A-law
| Conferencing 0x1E Standard µ-Law (MFDSP and DSP-ONE cards only) 0x1F Standard A-Law (MFDSP and DSP-ONE cards only) 0x20 Mixed (MFDSP and DSP-ONE cards only) 0x21 Monitor (all DSP cards) 0x22 Unified (DSP-ONE and DSP 2 cards only) 0x23 DTMF-Clamped Conference (DSP-ONE and DSP 2 cards only) Announcement Generation 0x1C VRAS (MFDSP and DSP-ONE cards only) File Playback / Record 0x1D File Playback / Record (DSP 2 card only) Data[1] 0-100 Percentage of resources to exceed to produce alarm (default =100). Data[2] 0-100 Percentage of resources to go below to clear alarm (default =0). 0x17 Extended Conference Enable Data[0] 0x00 Disable Extended Conferences 0x01 Enable Extended Conferences
: | Checksum

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.
See Atomic Function.
See Address Information Block.
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.
Most Significant Bit
Least Significant Bit
Digital Signal Processor
RFS. A Status Message indicating that some entity is requesting service from the Excel platform.
See Transaction Capability Application Part.
PCM and companding standard used in Europe to compress and expand the amplitude range of a signal before and after transmission. See µ-Law.
PCM and companding standard used in North America and Japan to compress and expand the amplitude range of a signal before and after transmission. See A-Law
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.
Tone commonly used to indicate additional action is required by the caller, such as dialing more digits (for example, entry of personal ID number).
Voice Recorded Announcement System