TCAPInitGenCfg

Initializes a TCAP general configuration buffer to default configuration values that can be passed to TCAPGenCfg.

Prototype

S16 TCAPInitGenCfg ( TcapGenCfg *cfg)

Argument

Description

cfg

Pointer to the TCAP general configuration structure to be initialized:

typedef struct Tcap_Gen_Cfg
{
  S16   maxSaps;    /* Max Number of TCAP Saps              */
  S16   maxDlgs;    /* Max number of dialogs; system-wide   */
  S16   maxInvs;    /* Max number of invokes; system-wide   */
  S16   timeRes;    /* Timer Resolution - for internal use  */
  PDesc smPst;      /* not used                             */
  U8    alarmLvl;   /* Alarm level                          */
  U8    minTidLen;  /* Minimum transaction ID length
                     * (ITU only)                           */
  U8    haState;    /* high availability state (ouput only) */
  U8    mcState;    /* mate connection state (output only)  */
  U8    traceData;  /* enables/disables TCAP packet trace   */
  U8    fill;       /* spare for alignment                  */
  U16   memThresh1; /* congestion onset level 1 mem percent */
  U16   memThresh2; /* congestion onset level 2 mem percent */
  U16   MemThresh3; /* congestion onset level 3 mem percent */
} TcapGenCfg;

Refer to the Details section for more information.

Return values

Return value	Description
TCAP_SUCCESS
TCAPM_NULLPTR	Null pointer was specified for cfg.

Details

The application can change the default values within the specified range for any fields other than those denoted as internal or unused prior to calling TCAPGenCfg to send the configuration to the TCAP layer.

TcapGenCfg structure members not listed in the following table are either unused or for internal use only. These fields are set to correct values by TCAPInitGenCfg and must not be overridden by the application.

Default values for the TcapGenCfg structure that can be overridden by the calling application are listed in the following table:

Field	Range	Default value	Description
maxSaps	1 - 64	4	Maximum number of TCAP user SAPs (subsystem number or protocol variant) that can be defined.
maxDlgs	1 - 32767	256	Maximum number of outgoing and incoming TCAP transactions that can be pending at one time.
maxInvs	1 - 32767	256	Maximum number of outgoing and incoming TCAP invoke operations that can be pending at one time.
alarmLvl	TCAP_ALARMLVL_DIS TCAP_ALARMLVL_DFLT TCAP_ALARMLVL_DEBUG TCAP_ALARMLVL_DETAIL	TCAP_ALARMLVL_DFLT	Level of alarms generated by the TCAP layer. TCAPAlarmControl provides information on alarm levels.
minTidLen	1 - 4	1	Minimum transaction ID length (ITU only). If an out of range value is specified, the value is forced to 1 without a reported error.
haState	ST_HAST_STARTING ST_HAST_STANDALONE ST_HAST_PRIMARY ST_HAST_BACKUP	N/A	Current TCAP layer state returned by TCAPGetGenCfg. It is ignored by TCAPGenCfg.
mcState	ST_MCST_ISOLATED ST_MCST_CONNECTED	N/A	Current TCAP layer state of communication with mated TCAP when deployed as a redundant pair. Returned by TCAPGetGenCfg. The layer state is ignored by TCAPGenCfg.
traceData	TCAP_BUFTRACE_OFF TCAP_BUFTRACE_ON	TCAP_BUFTRACE_OFF	Enables and disables tracing of TCAP packets to the ss7trace utility.
memThresh1	1 - 99	20	Percentage of memory available to TCAP below which inbound and outbound congestion level 1 is triggered.
memThresh2	1 - 99	15	Percentage of memory available to TCAP below which inbound and outbound congestion level 2 is triggered.
memThresh3	1 - 99	10	Percentage of memory available to TCAP below which inbound and outbound congestion level 3 is triggered.