Table of Contents Index NMS Glossary Previous Page Next Page (Page 7 of 13 in this chapter) Version


TCAPInitGenCfg

Description

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

Prototype

S16 TCAPInitGenCfg (TcapGenCfg *cfg)

cfg Pointer to the TCAP general configuration structure to be initialized.

Return Values

Details

The application may 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.

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;

Default values for the TcapGenCfg structure which may be overridden by the calling application are listed in the following table.

Note: 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 the TCAPInitGenCfg primitive and must not be overridden by the application.
Name

Range

Default Value

Description

maxSaps

1 to 64

4

The maximum number of TCAP user SAPs (subsystem number/protocol variant) that may be defined.

maxDlgs

1 to 32767

256

The maximum number of TCAP transactions (outgoing and incoming) that may be pending at any one time.

maxInvs

1 to 32767

256

The maximum number of TCAP invoke operations (outgoing and incoming) that may be pending at any one time.

alarmLvl

TCAP_ALARMLVL_DIS,
TCAP_ALARMLVL_DFLT,
TCAP_ALARMLVL_DEBUG,
TCAP_ALARMLVL_DETAIL

TCAP_ALARMLVL_DFLT

Level of alarms to be generated by TCAP layer (see the TCAPAlarmControl primitive reference for definition of alarm levels).

minTidLen

1 to 4

1

Minimum transaction ID length (ITU only). If an out of range value is specified, the value is forced to 1 without any error being reported.

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. It is ignored by TCAPGenCfg.

traceData

TCAP_BUFTRACE_OFF,
TCAP_BUFTRACE_ON

TCAP_BUFTRACE_OFF

Enables/Disables tracing of TCAP packets to ss7trace utility.

memThresh1

1 to 99

20

Percentage of memory available to TCAP below which inbound and outbound congestion level 1 is triggered.

memThresh2

1 to 99

15

Percentage of memory available to TCAP below which inbound and outbound congestion level 2 is triggered.

memThresh3

1 to 99

10

Percentage of memory available to TCAP below which inbound and outbound congestion level 3 is triggered.



Table of Contents Index NMS Glossary Previous Page Next Page (Page 7 of 13 in this chapter) Version


Want to send us feedback on our documentation? Email: Tech_Pubs@nmss.com
Copyright © 2002, NMS Communications Corporation. All rights reserved.