You are here: SwitchKit® Development Environment - Installation and Maintenance Guide > 7 Device Connectivity > Connecting LLC to an SS7 card
Description
A user application can connect through the LLC directly to an SS7 card in the node, enabling faster TCAP messaging. See the illustration below:
How to Connect
The configuration steps should be done through a configuration file sent via SwitchManager. Once established, the TCAP connection status can be monitored by an application. This can be done by registering for and utilizing the data contained within GenericLLCReports.
The next table lists the steps for the configuration:
Step |
Action |
---|---|
1 |
Set up the connection between the LLC and CSP Matrix Series 3 card in the node using the SK_AddLLCNode() configuration message. |
2 |
Set up the connection between the LLC and the SS7 card in the node using the SK_AddSS7TCAPCard configuration message. Successive SK_AddSS7TCAPCard messages must be sent for each Stack/SSN pair that you wish to route to the SS7 card. |
3 |
Send down two XL_SS7SCCPTCAPConfig messages. For both messages, set the ConfigType field to SCCP/TCAP host configuration to 0x08. For the second message set the data as follows: |
4 |
Applications that wish to receive PPLEventIndication messages related to the TCAP connection must register by calling sk_pplTCAPMessageRegister(). This function sends the SK_TCAPMessageRegister message. On registering for PPL event indications, the user application must be set up to handle the SK_TCAPMessageRegisterAck message. See the Handler functions in the SwitchKit Programmer’s Guide. |
Supported Messages
The connection from the LLC to the CSP Matrix Series 3 card remains intact. Therefore, an application must still process all messages that it normally processes. The LLC to SS7 card connection can handle only the following messages if registered for them, by calling sk_pplTCAPMessageRegister():
• XL_PPLEventIndication - contains TCAP messaging information from the switch.
• XL_PPLEventRequest - sends TCAP requests into the switch.
• XL_PollMessage - The system type is 0x80. This message can also be used to determine which SS7 card is active and which is in standby.
Return Values
The Status field can contain the following values:
If the return value is |
then... |
---|---|
0x10 |
a node was added successfully. |
SK_DUP_IP_ADDR |
one or both IP addresses are already in use by the LLC. Notes: Only a string comparison is done, so, for example, if "localhost" and "127.0.0.1" were given, no conflict would be detected. |
SK_INTERNAL_LIMIT_REACHED |
no more nodes can be added to LLC. Current limit is 128 nodes. |
SK_BAD_IP_ADDRESS |
no response from that IP address was received after 15 seconds. |
SK_BAD_LICENSE |
no valid license exists for the new node. |
SK_INTERNAL_ERROR |
an unexpected error occurred. Refer to the LLC maintenance.log for more details. |
SK_NODE_DOESNT_EXIST |
a delete command was sent for a non-existing node. |
TC_U_Abort
TC_U_ABORT messages are sent by the LLC when an application drops and has outstanding dialogues from a TCAP transaction. Then the LLC sends one PPLEventRequest (TC_U_ABORT) to the CSP for each of them. Next, the LLC puts the LLC's Dialogue object into the NOT_ALLOCATED state after receiving an ACK, NACK, or timeout from the request.