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 tby 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.