isupInitUSapCfg

Builds a user service access point configuration buffer that can be passed to isupUSapCfg.

Prototype

void isupInitUSapCfg ( IsupUSapCfg *cfg, S16 switchType)

Argument

Description

cfg

Pointer to the following IsupUSapCfg structure to initialize:

typedef struct _IsupUSapCfg
{
  S16      switchType;       /* Protocol Switch                       */
  U16      fill1;
  U8       database[(MAX_DB_LEN + 5) & 0xffc];    /* database name    */
  U8       wildCardMask[(ISUPADDRLEN + 4) & 0xffc];/* Wild Card Mask  */
  Bool     wildCardRoute;   /* Wild Card Routing Flag                 */
  Bool     sidInsert;       /* SID insertion Flag                     */
  Bool     sidVerify;       /* SID verification Flag                  */
  U8       fill2;
  IsupAddr sid;           /* SID                                      */
  U8       natAddrInd;    /* SID Nature of Address Indicator          */
  U8       sidNumPlan;    /* SID Numbering Plan                       */
  U8       sidPresInd;    /* Default presentation indicator           */
  U8       maxMsgLength;  /* Max length of user to user messages      */
  Bool     incSidPresRes; /* Presentation Restriction of incoming SID */
  Bool     sidPresRes;    /* Presentation Restriction                 */
  Bool     reqOpt;        /* Request option                           */
  Bool     allowCallMod;  /* Call modification allowed                */
  TimerCfg t1;             /* t1 timer - release sent                 */
  TimerCfg t2;            /* t2 timer - suspend received              */
  TimerCfg t5;            /* t5 timer - initial release sent          */
  TimerCfg t6;            /* t6 timer - suspend received              */
  TimerCfg t7;            /* t7 timer - latest address sent           */
  TimerCfg t8;            /* t8 timer - initial address received      */
  TimerCfg t9;            /* t9 timer - latest address sent after ACM */
  TimerCfg t16;           /* t16 timer - reset sent                   */
  TimerCfg t17;           /* t17 timer - initial reset sent           */
  TimerCfg t31;           /* t31 timer - call reference frozen period */
  TimerCfg t33;           /* t33 timer - INR sent                     */
  TimerCfg tCCR;          /* tCCR timer - continuity recheck timer    */
  TimerCfg t27;           /* t27 timer - waiting for continuity
                          /*   recheck                                */
  TimerCfg t34;           /* t34 timer - waiting for continuity       */
                          /*  or release message after LoopBackAck    */
  TimerCfg tEx;           /* tEx timer - Exit to be sent              */
  TimerCfg tCRM;          /* Circuit reservation message timer        */
  TimerCfg tCRA;          /* Circuit reservation ack. timer           */
  U8       prior;         /* Priority                                */
  U8       route;         /* Route                                    */
  U8       selector;      /* Selector                                 */
  U8       fill3;
  MemoryId memory;        /* Memory region & pool id                  */

} IsupUSapCfg;

Refer to the Details section for more information.

switchType

Type of switch.


Details

After calling isupInitUSapCfg, call isupUSapCfg to set the user service access point configuration. You can optionally override specific field values before calling isupUSapCfg.

The fields of the IsupUSapCfg structure are initialized with the following values:

Field

Description

switchType

One of the following switch type indicators specified in switchType:

ISUP_SW_ITU

ISUP_SW_ANS88

ISUP_SW_ANS92

ISUP_SW_JNTT

sid

Service ID string. BCD string of digits to be inserted into calling party address in outgoing IAM messages.

length = 0

string = zero filled

sidInsert

The stack supplies the calling party address (from the sid field) in the outgoing IAM messages.

Default = TRUE

sidVerify

The stack verifies that the address passed in the calling party address of outgoing connect requests is the same as that supplied in the sid field. If they are equal, then the screening indicator in the calling party parameter is set to User Provided. If they are not equal, then the screening indicator in the calling party parameter is set to Network Provided, and the calling party address is inserted from the sid field.

Default = FALSE

The sidVerify field has no effect if the sidInsert field is set to FALSE.

natAddrInd

Nature of address indicator that the ISUP stack inserts into the calling party parameter of outgoing IAM messages if sidInsert is set to TRUE. Default = 0.

sidNumPlan

Numbering plan that ISUP stack inserts into the calling party parameter of outgoing IAM messages if sidInsert is set to TRUE. Default = 0.

sidPresInd

FALSE

incSidPresRes

FALSE

sidPresRes

FALSE

reqOpt

FALSE

allowCallMod

TRUE

maxMsgLength

Maximum length (bytes) of user-to-user data. Default = 20.

t1

Time to wait for a response to a transmitted release message.

value = 12

enable = TRUE

t2

Time to wait for a resume message after a suspend message is received.

value = 0

enable = FALSE

t5

Time to wait for a response to a transmitted initial release message.

value = 60

enable = TRUE

t6

Time to wait for a resume message after a suspend network message is received.

value = 30

enable = TRUE

t7

Time to wait for a response (for example, ACM, ANS, CON) to the latest transmitted address message.

value = 25

enable = TRUE

t8

Time to wait for a continuity message after receiving an initial address message (IAM) that requires a continuity check.

value = 12

enable = TRUE

t9

Time to wait for an answer of an outgoing call after an address complete message (ACM) is received.

value = 180

enable = TRUE

t16

Time to wait for an acknowledgement of a transmitted reset message.

value = 15

enable = TRUE

t17

Time to wait for an acknowledgement of the initially transmitted reset message.

value = 60

enable = TRUE

t27

Time to wait for a continuity check request after a continuity check failure indication is received.

value = 240

enable = TRUE

t31

Time to wait before reusing a call reference after a connection is cleared.

value = 0

enable = FALSE

t33

Time to wait for a response to a transmitted information request message.

value = 15

enable = TRUE

t34

Time to wait for a continuity message (COT) response or a release (REL) response after transmitting a loopback acknowledgment.

value = 0

enable = FALSE

tCCR

Continuity recheck timer.

value = 0

enable = FALSE

tEx

Time to wait before sending an ANSI exit message.

value = 0

enable = FALSE

tCRM

Circuit reservation acknowledgment timer.

value = 4

enable = TRUE

tCRA

Time to wait for an IAM message after sending a circuit reservation acknowledgment message.

value = 10

enable = TRUE


Structure members not indicated in the previous table are initialized to appropriate values for proper operation of the ISUP stack and must not be modified.

Example

IsupUSapCfg  cfg;
U16          swtchType = ISUP_SW_ANS92;

/* Initialize USAP configuration parameters to default values */

isupInitUSapCfg
(&cfg, switchType);