You are here: CSP API Reference > 1 EXS & SwitchKit API Messages > 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
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 : |
Address Method |
8, 9 |
|
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 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 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 |
: |
Query Type |
|
|
Query Type 0x01 Local SSN Table 0x02 SCCP/TCAP Default Parameter 0x03 SSN Default Parameter 0x05 TCAP Active Transactions 0x06 TCAP Active Operations 0x08 SCCP Replicated SSN 0x0A Associated subsystems for a stack 0x0B Number of active dialog and invocations 0x0C TLV Format Configuration Contents
|
: |
Number of TLVs |
|
Number of TLVs |
: |
TLVs |
|
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 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.
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
0x0B Number of active dialogues and invocations No data. 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. |
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 |
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 |
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. 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
0x0B Number of active dialogs and invocations Data[0-3] number of active dialogs
0x0C TLV Format Configuration Contents 0x09D1 Global Title Group Query Response 0x09D2 Global Title Entry Query Response
|