SS7 SCCP/TCAP Query 0x0078

SwitchKit Name

SS7SCCPTCAPQuery

Type

EXS API and SwitchKit API message

Description

This message is sent to configure query information about SS7
SCCP/TCAP configuration.

Sent by

Host

SwitchKit Code

C Structure

typedef struct {

UBYTE StackID;

UBYTE reserved18[29];

UBYTE QueryType;

UBYTE Data[222];

} XL_SS7SCCPTCAPQuery;

C Structure Response

typedef struct {

unsigned short Status;

UBYTE StackID;

UBYTE QueryType;

UBYTE Data[220];

} XL_SS7SCCPTCAPQueryAck;

C++ Class

class XLC_SS7SCCPTCAPQuery : public XLC_OutboundMessage {

public:

UBYTE getStackID() const;

void setStackID(UBYTE x);

UBYTE getQueryType() const;

void setQueryType(UBYTE x);

const UBYTE *getData() const;

UBYTE *getData();

void setData(UBYTE *x);

};

C++ Class Response

class XLC_SS7SCCPTCAPQueryAck : public XLC_AcknowledgeMessage {

public:

unsigned short getStatus() const;

void setStatus(unsigned short x);

UBYTE getStackID() const;

void setStackID(UBYTE x);

UBYTE getQueryType() const;

void setQueryType(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 (0xNNNN)

3, 4

Message Type (0x0078)

3, 4

Message Type (0x0078)

5

Reserved (0x00)

5

Reserved (0x00)

6

Sequence Number

6

Same Sequence Number

7

Logical Node ID

7

Logical Node ID

8

:

AIB

Address Method

8, 9

Status MSB, LSB

Number of AEs to follow

10

:

AIB (same as message)

AEs

:

Query Type

:

Query Type

:

Data[0]

:

Number of TLVs

:

Checksum

:

TLVs

 

:

Data[0]

:

:

:

Checksum

 

EXS API Hex Format

MESSAGE (White)

RESPONSE (Gray)

Byte

Field Description

Byte

Field Description

0

Frame (0xFE)

0

Frame (0xFE)

1

Length, MSB

Length, LSB (N)

1

Length, MSB

Length, LSB (N)

2

2

3

Message Type, MSB (0x00)

Message Type, LSB (0x78)

3

Message Type, MSB (0x00)

Message Type, LSB (0x78)

4

4

5

Reserved (0x00)

5

Reserved (0x00)

6

Sequence Number

6

Same Sequence Number

7

Logical Node ID

7

Logical Node ID

8

:

AIB

Address Method

0x00 - (Individual AEs

8, 9

Status

MSB - 0x55

LSB - As follows:

01 - Invalid CFG Type

02 - Subsystem Configured

03 - Subsystem Not Configured

04 - Subsystem Allowed

05 - Subsystem Not Allowed

06 - Invalid Option

07 - Exceed Max SSN Host

08 - Invalid Parameter

09 - Invalid Parameter Length

0A - Parameter Configured

0B - Parameter Not Configured

0C - Invalid SCCP Upper Layer

0D - Exceed Max Active Subsystem

0E - DPC Not Configured

0F - Exceed Max Replicates

10 - Invalid Number of Replicates

11 - Replicate Not Configured

12 - Exceed Max Active SSN

13 - Exceed Max SSN PPC

14 - ESSG Subsystem Not Configured

15 - ESSG SSN PPC Exist

16 - OPR Not Perm for ESSG SSN DPC SSN

17 - Local Host Not Allowed

19 - Invalid Tag Type

1A - SCCP not configured for this stack

1B - GTAI length is out of the range configured for the group

1D - GT Group hasn’t been configured

1E - GT Group ID is already occupied

1F - GT Group with the same stack ID and selector already exists

20 - Group ID exceed maximum group ID

21 - The group parameters is not matched with parameters
stored in the switch.

22 - The minimum/maximum digits number in GT group is illegal.

23 - GT entry already in Pending DEL state

24 - GT already exists in the group.

25 - GT does not exist.

26 - The memory storing translation result with global title has
been used up.

27 - GT entries have been used up.

28 - GT entry is found in standby index table

29 - GT Entry is found in active index table

2A - GT Group is configured but not for this stack.

2B - Configuration is unreasonable.

1. Translation result is "route on GT but DPC is equal to OPC.

2C - CPU load is not suitable to config.

2D - Index table needs to be built.

Number of AEs to follow

10

AIB (same as message)

AE

0x08 SS7 Stack

:

Query Type

 

Query Type

0x01 Local SSN Table

0x02 SCCP/TCAP Default Parameter

0x03 SSN Default Parameter

0x04 TCAP Object Syntax Descriptor (OSD)

0x05 TCAP Active Transactions

0x06 TCAP Active Operations

0x08 SCCP Replicated SSN

0x0A Associated subsystems for a stack

0x0B Number of active dialogues and invocations

0x0C TLV Format Configuration Contents

 

:

Number of TLVs

 

Number of TLVs

:

TLVs

0x09D1 Global Title Group Query Response

0x09D2 Global Title Entry Query Response

 

TLVs

0x09CF Global Title Group Query

0x09D0 Global Title Entry Query

 

Refer to Chapter 4, Tag Length Blocks in the API Reference.

See also, Global Title Translation (GTT) Configuration Samples in the API Developer’s Guide: Common Channel Signaling.

:

Data[0] (See info below this table)

:

Checksum

 

:

Data[0]

The Data is dependent on the Query Type.

0x01 Local SSN Table

Data[0] Subsystem Number

Data[1] Subsystem Status

 

0x00 Prohibited

0x01 Allowed

 

0x02 SCCP/TCAP Default Parameter

Data[0-1] Parameter Type

 

0x03 SSN Default Parameter

Data[0] Subsystem Number

Data[1-2] Parameter Type

Refer to the Developer’s Guide: Common Channel Signaling.
for Parameter Information.

 

0x04 TCAP OSD

Data[0-1] TCAP object parameter ID.
Refer to the Developer’s Guide: Common Channel Signaling.
for TCAP OSD Parameter IDs.

 

0x05 TCAP Active Transactions

Data[0] Subsystem Number

Data[1-4] Dialog ID

 

0x06 TCAP Active Operations

Data[0] Subsystem Number

Data[1-4] Dialog ID

Data[5, 6] Invoke ID

 

0x0C TLV Format Configuration Contents

 

:

Checksum

 

Response Data

 

The Response Data is dependent on the Query Type.

0x01 Local SSN Table

 

Data[0] Subsystem Number

Data[1] Subsystem Status

 

0x00 Prohibited

0x01 Allowed

 

Number of Network DPC/SSNs (1 byte)

DPC 1 (4 bytes)

Network SSN 1 (1 byte)

Network SSN 1 Status (1 byte)

:

DPC n (4 bytes)

Network SSN n

Network SSN n Status (1 byte)

Number of Hosts (1 byte)

Local/Matrix Host (1 byte)

Port ID (1 byte)

 

Data[2] Routing Flag

0x00 SCCP Route network message directly to host

0x01 SCCP Route network message to TCAP

 

Data[3] Number of Adjacent Translators

 

Data[4-7] Adjacent Translator 1 (4 bytes)

:

Adjacent Translator n (4 bytes)

Number of Other Concerned Point Codes (1 byte)

Other Concerned Point Code 1 (4 bytes)

:

Other Concerned Point Code n (4 bytes)

Number of Network DPC/SSNs (1 byte)

DPC 1 (4 bytes)

Network SSN 1 (1 byte)

Network SSN 1 Status (1 byte)

0x00 Prohibited

0x01 Allowed

:

DPC n (4 bytes)

Network SSN n

Network SSN n Status (1 byte)

0x00 Prohibited

0x01 Allowed

Number of Hosts (1 byte)

Local/Matrix Host (1 byte)

Port ID (1 byte)

0x02 SCCP/TCAP Default Parameter Table

Data[0-1] Parameter Type

Data[2-3] Parameter Length

Data[4+] Parameter Value

Refer to the Developer’s Guide: Common Channel Signaling for Parameter Information.

 

0x03 SSN Default Parameter Table

Data[0] Subsystem Number

Data[1-2] Parameter Type

Data[3-4] Parameter Length

Data[5+] Parameter Value

Refer to the Developer’s Guide: Common Channel Signaling for Parameter Information.

 

0x04 TCAP OSD

Data[0-1] TCAP object parameter ID.
(Refer to the Developer’s Guide: Common Channel Signaling for TCAP OSD Parameter IDs.)

Data[2-3] TCAP identifier

Data[4] Object data type (always 0x00)

0x00 Information not available/ other Object data type

Data[5+] Object syntax description follows if Data[4] is not 0x00.

 

0x05 TCAP Active Transactions

Data[0] Subsystem Number

Data[1-4] Dialog ID (4 bytes)

Data[5-8] Transaction Originating Transaction ID (4 bytes)

Data[9-12] Transaction Responding Transaction ID (4 bytes)

Data[13] Transaction State

ANSI

The following Transaction State values apply for ANSI:

0x00 Idle

0x01 Query Without Permission package has been sent

0x02 Query With Permission package has been sent

0x03 Query Without Permission package has been received

0x04 Query With Permission package has been received

0x05 Conversation With Permission package has been received

0x06 Conversation Without Permission package has been received

0x07 Conversation Without Permission package has been sent

0x08 Conversation With Permission package has been sent

ITU

The following Transaction State values apply for ITU:

0x00 Idle

0x01 Initiation Received

0x02 Initiation Sent

0x03 Active

 

The following bytes are the stored CGPA for this transaction:

Data[14-15] CGPA Parameter Type

Data[16–17] Parameter Length

Data[18+] Parameter Value

 

The following bytes are the stored CGPA for this transaction:

Data[:] CDPA Parameter Type

Data[:] Parameter Length

Data[:+] Parameter Value

Data[:] :

 

Refer to the Developer’s Guide: Common Channel Signaling for Parameter Information.

Data[:] Reserved

 

0x06 TCAP Active Operations

Data[0] Subsystem Number

Data[1-5] Dialog ID (4 bytes)

Data[6-7] Operation Invoke ID

Data[8-9] Operation Correlation ID

The MSB is always 0x00 unless the Correlation ID is not available, in which case it is 0xFF)

Data[10] Operation State

 

ANSI

The following Operation State values apply for ANSI:

0x00 Idle The operation is not initiated

0x01 Operation is Pending The state machine is waiting for an incoming component from the network

0x02 Operation is in Progress The state machine is expecting the host to send a responding component

0x03 Operation Local Pending All components required for this operation are stored in TCAP.
A Dialog primitive must be sent to send the components to the network.
In this state, any component received for this operation from the network or the host
will be rejected.

ITU

The following Operation State values apply for ITU:

0x00 Idle

0x01 Operation Sent Class 1

0x02 Wait for Reject

0x03 Operation Sent Class 2

0x04 Operation Sent Class 3

0x05 Operation Sent Class 4

Data[9-12] Reserved

 

0x0C TLV Format Configuration Contents

0x09D1 Global Title Group Query Response

0x09D2 Global Title Entry Query Response