You are here: CSP API Reference > 1 EXS & SwitchKit API Messages > Outseize Instruction List Configure 0x002A

Outseize Instruction List Configure 0x002A

SwitchKit Name

OuseizeInstrListConfig

Type

EXS API and SwitchKit API message

Description

Outseize Instruction List Configure 0x002A

Use several of these messages to preprogram a list of instructions for outseize control on CAS channels. You must send a separate Outseize Instruction List Configure message for each instruction that you add to the list.

Outseize instructions cannot be preprogrammed for ISDN PRI or SS7 channels. You must include all outseize instructions for ISDN PRI and SS7 in the Outseize Control message.

After configuring a channel with an Outseize Instruction List, the CSP uses the list to initiate an outseizure on a channel. You set this up by sending an Outseize Control message with a "Use Instruction List" ICB.

The last instruction in a list should always be "Wait For Host Control" or "Wait for Host Control with Answer Supervision," where the CSP waits for further instructions from the host to continue processing.

NOTE: A seize instruction cannot be preprogrammed.

Related Messages

• Outseize Control 0x002C (OutseizeControl)

• Call Control Instructions Query 0x0087 (CallControlInstructionQuery)

Sent by

Host

Example Message (Socket Log Output for EXS SwitchKit)

The following socket log output/example message, shows the host sending an Outseize instruction list to the CSP to configure span 0x00, channels 0x00 - 0x17.

00 15 00 2A 00 00 ff 01 02 0d 03 00 00 00 0d 03 00 00 17 ff 00 00 00

Clear Instruction list

00 15 00 2A 00 00 ff 01 02 0d 03 00 00 00 0d 03 00 00 17 01 05 01 00

Outpulse stage 1

00 15 00 2A 00 00 ff 01 02 0d 03 00 00 00 0d 03 00 00 17 02 08 00 00

Send host acknowledgement

00 15 00 2A 00 00 ff 01 02 0d 03 00 00 00 0d 03 00 00 17 03 0f 00 00

Wait for host control w/Answer Supervision

SwitchKit Code

Configuration

OutseizeInstrListConfig (

Node = integer,

Range = StartSpan:StartChan - EndSpan:EndChan,

InstrNum = integer,

InstrType = integer,

InstrData1 = integer,

InstrData2 = integer);

C Structure

typedef struct {

unsigned short StartSpan;

UBYTE StartChannel;

unsigned short EndSpan;

UBYTE EndChannel;

UBYTE InstrNum;

UBYTE InstrType;

UBYTE InstrData1;

UBYTE InstrData2;

} XL_OutseizeInstrListConfig;

C++ Class

class XLC_OutseizeInstrListConfig : public XLC_ChanRangeMessage {

public:

unsigned short getStartSpan() const;

void setStartSpan(unsigned short x);

UBYTE getStartChannel() const;

void setStartChannel(UBYTE x);

unsigned short getEndSpan() const;

void setEndSpan(unsigned short x);

UBYTE getEndChannel() const;

void setEndChannel(UBYTE x);

UBYTE getInstrNum() const;

void setInstrNum(UBYTE x);

UBYTE getInstrType() const;

void setInstrType(UBYTE x);

UBYTE getInstrData1() const;

void setInstrData1(UBYTE x);

UBYTE getInstrData2() const;

void setInstrData2(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 (0x002A) | 3, 4 | Message Type (0x002A)
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 | Checksum
Number of AEs to follow
AE 0x0D Channel (Starting) 0x0D Channel (Ending)
: | Instruction Number You must assign each message an instruction number. The Outseize Control message specifies the first instruction in the list to be used and the CSP executes each message in order, by instruction number until the wait for host control instruction. Valid instruction numbers are 1 - 20. To clear all instructions from a channel, set the Instruction Number to 0xFF and Instruction Type to 0x00 (Null).
: | Instruction Type 0x00 Null 0x01 Scan For Wink N 0x02 Scan for ANI Request Off-hook 0x03 Scan for Dialtone 0x04 Report Call Processing Event 0x05 Outpulse Stage N Address Data 0x06 Wait for Host Address Data 0x07 Wait for Host Control Message 0x08 Send Host Acknowledgment 0x09 Do Call Progress Analysis 0x0D Cancel R2 Receiver 0x0E Scan for Backward R2 Signal 0x0F Wait for Host Control With Answer Supervision 0x10 Do CPA Without Line Signaling 0x11 Delay N Milliseconds
: | Data[0] See Instruction Type Data Table below.
: | Data[1] See Instruction Type Data Table below.
: | Checksum

Instruction Type Data

Instruction Type | Data 0 | Data 1
--- | --- | ---
0x00 Null | 0x00 | 0x00
0x01 Scan for Wink N | Wink Number (0x01-0x08) | 0x00
0x02 Scan for ANI Request Off-Hook | 0x00 | 0x00
0x03 Scan for Dialtone | 0x00 | 0x00
0x04 Report Call Processing Event | 0x01 Off-hook 0x03 Wink 1 0x04 Wink 2 0x05 Wink 3 0x06 Wink 4 0x07 Wink 5 0x08 Wink 6 0x09 Wink 7 0x0A Wink 8 0x0B Dialtone Detected 0x0D Backward R2 Signal 0x0E First Digit Detected | 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00
0x05 Outpulse Stage N Address Data | 0x01 Stage Number 1 0x02 Stage Number 2 0x03 Stage Number 3 0x04 Stage Number 4 | 0x00 0x00 0x00 0x00
0x06 Wait for Host Address Data | 0x00 | 0x00
0x07 Wait for Host Control Message | 0x00 | 0x00
0x08 Send Host Acknowledgment | 0x00 | 0x00
0x09 Do Call Progress Analysis | 0x00 North American Default 0x01 Dialtone 0x02 CPC Detection 0x03 Energy Detection | 0x00 0x00 0x00 0x00
0x0D Cancel R2 Receiver | 0x00 | 0x00
0x0E Scan for Backward R2 Signal | 0x00 | 0x00
0x0F Wait for Host Control with Answer Supervision | 0x00 | 0x00
0x10 Do CPA Without Line Signaling | 0x00 | 0x00
0x11 Delay N Milliseconds | Delay Value, MSB: Values are in units of 10 ms. Max. value is 10 seconds (0x03E8). | Delay Value, LSB:

Default Outseize Instruction Lists

The default instructions for T1 and E1 protocols are as follows:

T1

1. Wait For Host Control Message

E1

1. Outpulse Stage 1 Digits

2. Outpulse Stage 2 Digits

3. Outpulse Stage 3 Digits

4. Outpulse Stage 4 Digits

5. Report Call Processing Event

6. Wait For Host Control Message

Outgoing call setup during real-time call processing on a specific channel.
See Channel Associated Signaling.
See Integrated Services Digital Network.
See Signaling System Number Seven.
See Information Control Block.
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.
Setting up, monitoring, and tearing down calls.
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
Momentary interruption in a single frequency tone indicating the distant switch is ready to receive the digits just dialed.
See Automatic Number Identification.
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.