(Page 8 of 12 in this chapter)


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 The TX Series board number to which this request is directed. This parameter also identifies the TCAP layer instance ID.

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

swProt The protocol selector switch. This parameter identifies the TCAP protocol variant employed on this TCAP SAP; Valid values are:

  #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  */
 
cfg The address of the TCAP SAP configuration parameters buffer.

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 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       spare2;       /* spare for alignment            */
} 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 the TCAPInitSapCfg primitive and must not be overridden by the application.
Name

Range

Default Value

Description

swtch

1..4

<swProt>

parameter

TCAP protocol variant to be used on this SAP.

t1

1..65535

60

Default invocation timer, in seconds.

t2

1..65535

60

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

seqTimer

1..255

60

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

instSP

1..8

<board> parameter

SCCP task instance id, always equal to the board number

spIdSP

0..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..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!



(Page 8 of 12 in this chapter)


tech_support@nmss.com
Copyright © 1999, Natural MicroSystems, Inc. All rights reserved.