SS7 ISUP Message Format Configure 0x006B

SwitchKit Name

SS7ISUPMessageFormatConfig

Type

EXS API and SwitchKit API message

Description

Use this message to add, remove or modify the format of an ISUP message in the ISUP Message Format table.

Each of these configuration messages is used to format outgoing ISUP messages and to interpret incoming ISUP messages.

For each message, there can be a maximum of eight Mandatory Fixed Parameters, eight Mandatory Variable Parameters, and 42 Optional Parameters.

Use the SS7 ISUP Message Query message to retrieve the currently configured format of an ISUP message.

Modifying the format of an ISUP message may also require modification of its PPL Configuration Bytes.

Sent by

Host

SwitchKit Code

Configuration

SS7ISUPMessageFormatConfig (

Node = integer,

StackID = integer,

ISUPMessageIndex = integer,

ISUPMessageID = integer,

ISUPMessagePriority = integer,

NumMFPs = integer,

Data = byte array);

C Structure

typedef struct {

UBYTE StackID;

UBYTE ISUPMessageIndex;

UBYTE ISUPMessageID;

UBYTE ISUPMessagePriority;

UBYTE NumMFPs;

UBYTE Data[219];

} XL_SS7ISUPMessageFormatConfig;

C++ Class

class XLC_SS7ISUPMessageFormatConfig : public XLC_OutboundMessage {

public:

UBYTE getStackID() const;

void setStackID(UBYTE x);

UBYTE getISUPMessageIndex() const;

void setISUPMessageIndex(UBYTE x);

UBYTE getISUPMessageID() const;

void setISUPMessageID(UBYTE x);

UBYTE getISUPMessagePriority() const;

void setISUPMessagePriority(UBYTE x);

UBYTE getNumMFPs() const;

void setNumMFPs(UBYTE x);

const UBYTE *getData() const;

UBYTE *getData();

void setData(UBYTE *x);

};

EXS API Hex Format

Additional AIB

ISUP Message Index

This field specifies an index that is maintained for internal use by the Excel platform into the ISUP Message Format table for the specified ISUP message. The valid entries for this field are in numeric order.

Index values 0x2F-0x4E are user-defined for the ISUP message format table:

ISUP Message ID

This field specifies the ISUP Message ID for the specified ISUP message from the ISUP Message Format table. Valid entries for this field are listed by ISUP message name:

Repeatable Optional Parameters/Optional Parameters Allowed

This field informs ISUP whether or not to look for or insert the optional parameters pointer octet in the ISUP message.

Some messages allow optional parameters, even though optional parameters are not defined (for example, the ITU Q.767 Release Complete (RLC) message).

• Optional parameters are required for the incoming message when you set the value of the Optional Parameters Allowed field to 0x01. This is the default value. When you set this value to 0x01 and optional parameters are included in the message, the Excel platform automatically inserts the End of Optional Parameters octet. If the optional parameter pointer is missing in the incoming message, the CFN (Confusion message) will be returned.

• The maximum number of Optional Parameters is 52.

• For no optional parameters, set the value of the Optional Parameters Allowed field to 0x00 and the value of the Number of Optional Parameters field to 0x00. You must complete this step to support the pre-1995 ANSI format for the Group Reset (GRS) and Group Reset Acknowledgement (GRA) messages.

Example: API message:
00 1f 00 6b 00 00 ff 00 01 08 01 00 10 17 00 00 01 16 01 01 01 00 00 02 4e 21 00 01 01 4e 22 00 01 01

00 1f 00 6b 00 00 ff 00 01 08 01 00 11 29 00 00 01 16 01 04 00 00 02 4e 21 00 01 01 4e 22 00 01 01

Example: SwitchKit API:
SS7ISUPMessageFormatConfig(note=0
StackID=0,
ISUPMessageIndex=10
ISUPmessageid=0x17
ISUPMessagePriority=0
NumMFPs=0,
Data=1:22:1:4:0:0:2:0x4e:0x21:00:01:01:0x4e:0x22:00:01:01);

SS7ISUPMessageFormatConfig(node=0,
StackID=0
ISUPMessageIndex=0x11
ISUPmessageid=0x29
ISUPMessagePriority=0
NumMFPs=0
Data=1:22:1:4:0:0:2:0x4e:0x21:00:00:01:01:0x4e:0x22:00:01:01);

• For Repeatable Optional Parameters, set the value of this field to the number of repeated optional parameters.

Options for Optional Parameters Allowed Indicator

0 Optional Parameters Not Allowed

1 Optional Parameters Allowed

Options for Number of Repeatable Optional Parameters

0 No Repeatable Optional Parameters

1 -127 Indicate the number Repeatable Optional Parameters

Maximum Length

A value of 0x00 for the maximum length fields indicates that no validation is performed for the maximum length of the parameter.