You are here: SwitchKit® Development Environment - TCAP Interface User’s Guide > 2 SwitchKit Interface Module > Initialize()

Initialize()

Description

SKIM application calls the initialize method to initialize the SKIM API object. This method initializes SKTAL and registers a TCAP subsystem (SSN) with the CSP.

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 Initialize(int localNodeId, int stackId, int connId, int pc, int ssn, SKIM_TransHandler h1,
SKIM_NotificationHandler h2, void *tag, int startRange=0, int endrange=SK_MAX_TCAP_DIALOGS-1)

Parameters

The input parameters are shown in the next table. There are no input/output parameters.

Argument | Description
--- | ---
localNodeId | Local node ID
stackId | stack ID
connId | connection ID
pc | point code
ssn | subsystem number (SSN)
h1 | Default transaction handler callback. The transaction handler is invoked by SKIM after receiving a TCAP transaction message. The prototype for SKIM transactionhandler is: typedef int (*SKIM_TransHandler)(SKIM_Trans &trans, void *tag);
h2 | Notification handler callback. The notification handler is invoked when notification message is received by SKIM. The prototype for notification handler is: typedef int (*SKIM_NotificationHandler)(SKIM_Notify ¬ify, void *tag);
tag value | Tag to be returned with the callbacks
startRange | Starting dialogue ID allocated to this application (For the specific SSN)
endRange | Ending dialogue ID allocated to this application (For the specifc SSN)

Return Values

Possible return values for this API are:

SKIM_SUCCESS | No failure has occurred.
SKIM return code | As defined in Appendix B, SKIM Return Codes.

See Transaction Capability Application Part.