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


TCAPInitSapCfg

Description

Builds a default TCAP user SAP configuration buffer that can be passed to the TCAPSapCfg routine.

Prototype

S16 TCAPInitSapCfg (U8 board,
S16 spId,
S16 swProt,
TcapSapCfg *cfg)

board TX board number to which this request is directed. This parameter also identifies the TCAP layer instance ID.

spId Index number of the TCAP SAP being defined. Valid range is 0 to (TcapGenCfg.maxSaps - 1).

swProt Protocol selector switch.cfg The address of the TCAP SAP configuration parameters buffer.

Return Values

Details

The swProt parameter identifies the TCAP protocol variant employed on the specified SAP. It must be one of the following:

  #define TCAP_SW_ITU88  1  /* ITU 88  */
  #define TCAP_SW_ITU92  2  /* ITU 92  */
  #define TCAP_SW_ANS88  3  /* ANSI 88 */
  #define TCAP_SW_ANS92  4  /* ANSI 92 */
  #define TCAP_SW_ITU97  5  /* ITU 97  */
  #define TCAP_SW_ANS96  6  /* ANSI 96 */
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 TCAPSapCfg to send the configuration block to the TCAP layer.

typedef struct Tcap_Sap_Cfg
{
  S16      swtch;        /* Protocol selector switch       */
  U8       selectorUser; /* selector for TCAP User         */
  U8       spare1;       /* spare for alignment            */
  MemoryId memUser;      /* Memory ID - not used           */
  U8       priorUser;    /* priority - not used            */
  U8       routeUser;    /* route - not used               */
  TmrCfg   t1;           /* default invocation timer       */
  TmrCfg   t2;           /* wait for rejection timer       */
  U8       seqTimer;     /* duration to maintain SLS for
                          * sequential delivery            */
  U8       selectorSP;   /* selector for SCCP              */
  MemoryId memSP;        /* memory ID/SCCP - not used      */
  U16      procIdSP;     /* processor Id -not used         */
  U8       entSP;        /* SCCP entity ID = ENT_SCCP      */
  U8       instSP;       /* SCCP inst. ID = board num.     */
  U8       priorSP;      /* SCCP priority - not used       */
  U8       routeSP;      /* SCCP route - not used          */
  S16      spIdSP;       /* SCCP SAP ID for this TCAP SAP  */
  U8       altParamLen;  /* Alternate Parameter Length 
                          * Calculation                    */
  U8       chkpt;        /* default checkpoint strategy for
                         /* this application               */
  U8       addrOverride; /* application overrides SCCP
                         /* address                        */
  U8       allowInvkEnd; /* allow invoke component in end
                         /* message                        */
  S16      qThresh1;     /* queue size triggering congestion
                         /* level 1                        */
  S16      qThresh2;     /* queue size triggering congestion
                         /* level 2                        */
  S16      qThresh3;     /* queue size triggering congestion
                         /* level 3                        */
} TcapSapCfg;

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

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

Range

Default Value

Description

swtch

1 to 6

swProt

parameter

TCAP protocol variant to be used on this SAP.

t1

1 to 65535

60

Default invocation timer, in seconds.

t2

1 to 65535

60

Time to wait for reject of non-invoke component, where applicable, in seconds

seqTimer

1 to 255

60

Duration to request SCCP to maintain SLS when sequential delivery required.

instSP

1 to 8

board parameter

SCCP task instance id, always equal to the board number

spIdSP

0 to 32766

spId parameter

SCCP SAP ID (from SCCP config.) to map this TCAP SAP onto; by default, set to the same value as the TCAP SAP ID.

altParamLen

0 or 1

0

"0" uses the normal method of deriving a component parameter length from the component length field. "1" uses an alternate method of obtaining the parameter length from the Set or Sequence tag and length. USED FOR ANSI TCAP PROTOCOLS ONLY!

chkpt

CHKPT_NONE,
CHKPT_SEND,
CHKPT_ALL

CHKPT_NONE

Checkpointing option for this SAP when deployed in redundant configuration (see Section 2.7.6).

addrOverride

0 or 1

0

If set to 1, the application provides called party address in transaction response message. By default, TCAP uses calling party address from incoming message that initiated the transaction.

allowInvkEnd

0 or 1

0

If set to 1, application includes an invoke component in end transaction message.

qThresh1

1 to 32766

600

Number of inbound messages queued to application before congestion level 1 is triggered.

qThresh2

1 to 32766

900

Number of inbound messages queued to application before congestion level 2 is triggered.

qThresh3

1 to 32766

1200

Number of inbound messages queued to application before congestion level 3 is triggered.



Table of Contents Index NMS Glossary Previous Page Next Page (Page 9 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.