You are here: SwitchKit® Development Environment - 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.

See Transaction Capability Application Part.