You are here: SwitchKit TCAP Interface User’s Guide > 5 SwitchKit TCAP Abstraction Layer > sktal_registerTCAPSSNHandler()
sktal_registerTCAPSSNHandler()
Description
This function registers the application with a given node/stack/subsystem. A generic handler will be added to the handler stack that will filter messages for the given subsystem. When a new TCAP transaction is seen, or when sk_TCAP_AllocateDialogueID is called, the NewDialogueHandler function argument will be invoked. This function is expected to register a per dialogue handler (via sktal_setTCAPDialogHandler) for the new dialogue. All incoming messages within that dialogue sequence will be passed to that handler.
When using multiple running applications on the same subsystem number, the startRange and endRange arguments should be modified to divide the dialogue IDs between them. For example, when using two applications the values are:
|
Application 1 |
Application 2 |
|---|---|
|
startRange = 0 |
startRange = 4096 |
|
endRange = 4095 |
endRange = 8191 |
Syntax
int sktal_registerTCAPSSNHandler (int localNodeId, int stackId, int pc, int pc, int ssn, SK_TCAP_NewDialogHandler h,int *instanceId int connID, int startRange=0, int endRange=SK_MAX_TCAP_DIALOGS-1);
Input Parameters
|
Argument |
Description |
|---|---|
|
localNodeId |
local node ID |
|
stackId |
stack ID |
|
pc |
point code |
|
ssn |
Subsystem Number |
|
h |
Handler function for new TCAP dialogues. The prototype for new dialogue handler is: typedef int (*SKTAL_NewDialogHandler)(int instanceId, unsigned newDialogId); |
|
|
|
|
connId |
connection ID |
|
startRange |
Starting dialogue ID allocated to this application (For the specific SSN) |
|
endRange |
Ending dialogue ID allocated to this application (For the specifc SSN) |
Input/Output Parameters
None
Output Parameters
|
Argument |
Description |
|---|---|
|
instanceId |
Instance for given node/stack/SNN combination |
.
Return Value
SKTAL_SUCCESS: If method is successful.
SKTAL return code as defined in Appendix C, SKTAL Return Codes.