(Page 19 of 30 in this chapter)


SccpInitGenCfg

Description

Initializes an SCCP general configuration buffer to default configuration values that can be passed to the SccpSetGenCfg routine.

Prototype

SCCP_STATUS SccpInitGenCfg (SccpGenCfg *pCfg )

pCfg The pointer to the SCCP general configuration structure to initialize.

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 SccpSetGenCfg to send the configuration to the SCCP layer.

typedef struct
{
  U8       enable;         /* 0 = disabled, 1 = enabled          */
  U8       spare1;         /* alignment                          */
  U16      value;          /* timeout in tenths of seconds       */
}

typedef struct
{
  U8       maxSaps;        /* Max Number of SCCP User Saps       */
  U8       maxNSaps;       /* Max Number of Network Saps(MTP3)   */
  U16      maxScli;        /* Max Number of Sequence 
                            * Connectionless Instances           */
  U16      maxAddrs;       /* Max Number of Addresses            */
  U16      maxRtes;        /* Max Number of Routes               */
  U8       DefRouting;     /* Flag for Default Routing           */
  U8       ConnDrop;       /* Flag prevents Connection Drop on 
                            * link loss                          */
  U16      maxAdjDpc;      /* Max Number of Adjacent Point Codes */
  U16      maxMsgDrn;      /* Max message to drain  (max: 65535) */
  U16      maxXUDTs;       /* Max external. unit data control 
                            * blocks (ITU92)                     */
  U16      maxXUDTref;     /* Max external unit data reference
                            * control blocks (ITU-92)            */
  U8       status;       /* Local Status -- SCCP_ONLINE | SCCP_OFFLINE */
  U8       spare1;       /* alignment                                  */
  S16      sogThresh;    /* Threshold for granting state change        */
  S16      scliTimeRes;  /* Time Resolution                            */
  S16      rteTimeRes;   /* Time Resolution                            */
  S16      sapTimeRes;   /* Time Resolution                            */
  S16      nsapTimeRes;  /* Time resolution                            */
  S16      xrefTimeRes;  /* Time Resolution                            */
  S16      asmbTimeRes;  /* Time Resolution                            */
  TimerCfg scliTimer;    /* default SCLI timer                         */
  TimerCfg sstTimer;     /* default SST timer                          */
  TimerCfg nsapTimer;    /* default network sap timer                  */
  TimerCfg srtTimer;     /* Default Timer for SRT                      */
  TimerCfg ignoreTimer;  /* default ignore SST timer                   */
  TimerCfg coordTimer;   /* default Cord State Change SST timer        */
  TimerCfg xrefFrzTimer; /* default timer for freezing external
                          * unit data reference (ITU-92)               */
  TimerCfg defAsmbTmr;   /* default timer for external unit
                          * data assembly (CCITT92)                    */
  PDesc    stkmgr;       /* Stack Manager - not used                   */
  U16      maxConn;      /* max number of connections                  */
  S16      connThresh;   /* Connection Threshold                       */
  S16      queueThresh;  /* Queue Threshold                            */
  S16      conTimeRes;   /* connection Timer resolution                */
  S16      frzTimeRes;   /* freeze Timer resolution                    */
  TimerCfg freezeTimer;  /* default lcl reference freeze timer         */
  TimerCfg connTimer;    /* default connection timer                   */
  TimerCfg txInactTimer; /* time to allow connection to exist
                          * with no transmit packets                   */
  TimerCfg rxInactTimer; /* time to allow connection to exist
                          * with no receive packets                    */
  TimerCfg relTimer;     /* default release timer                      */
  TimerCfg repRelTimer;  /* default repeat release timer (ITU-92 only) */
  TimerCfg intvalTimer;  /* default report abnormal release timer      */
  TimerCfg guardTimer;   /* default restart timer                      */
  TimerCfg resetTimer;   /* default reset timer                        */
  U8       alarmLevel;   /* alarm level                                */
  U8       traceFlags;   /* trace flags                                */
} SccpGenCfg; 

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

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

All values listed in the following table may be modified on the FIRST call to SccpSetGenCfg. On subsequent calls to SccpSetGenCfg, only parameters listed in BOLD may be modified. Those fields not in bold are ignored on subsequent calls.
Name

Range

Default Value

Description

maxSaps

1..255

2

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

maxNSaps

1..255

1

The maximum number of MTP3 Network SAPs that SCCP uses.

maxScli

0..65535

20

Maximum number of simultaneous sequenced connectionless data transfers.

maxAddrs

0..65535

7

Maximum number of global title translation entries.

maxRtes

1..65535

4

Maximum number of route definition entries.

DefRouting

0..1

0

Set to 1 to enable Default Routing feature.

ConnDrop

0..1

0

Set to 1 to retain connections over a link loss.

maxAdjDpc

0..65535

4

Maximum number of route definitions that may be defined as adjacent(SCCP_ADJACENT). These nodes are notified directly of this nodes status changes.

maxMsgDrn

0..65535

5

Maximum number of messages queued to MTP3 to send in one "time interval" when exiting flow control.

maxXUDTs

0..65535

0

Maximum number of control blocks to allocate for reassembling segmented extended unit data messages.

maxXUDTref

0..65535

0

Maximum number of local references used to segment extended unit data messages.

status

SCCP_OFFLINE,
ONLINE

SCCP_ONLINE

Initial status of SCCP layer.

sogThresh

0..9

1

Minimum percentage of board memory that must be available before granting a Subsystem Out-Of-Service request(SOR) from a backup signaling point.

scliTimer

0..65535

2

Maximum time that a sequenced connectionless transmission may take before control block is deallocated(in secs).

sstTimer

0..65535

30

Wait between SubSystem Test (SST) messages(in secs).

nsapTimer

0..65535

1

Time to wait between "draining" blocks of queued messages to the MTP3 layer after exiting flow control(in secs).

srtTimer

0..65535

30

Wait between Subsystem Routing Test(SRT) messages(in secs).

ignoreTimer

0..65535

30

Time period after local subsystem goes out of service to ignore subsystem test messages(in secs).

coordTimer

0..65535

30

Time to wait for response to coordinated state change request(in secs.)

xrefFrzTimer

0..65535

1

Ttime to freeze an XUDT local reference before reusing it(in secs).

defAsmbTmr

0..65535

20

Maximum time for reassembling all segments of an XUDT message(in secs).

maxConn

0..65535

512

Maximum number of simultaneous connections.

connThresh

0..9

3

Maximum percentage of board memory that must be available before accepting a new connection in either direction.(expressed in units of 10%)

queueThresh

0..32766

3

Maximum number of data messages that may be queued for a connection waiting for a connection window to open.

freezeTimer

0..65535

1

Time to freeze a connection local reference before reusing it(in secs).

connTimer

0..65535

180

Wait for response to connection request(in secs).

txInactTimer

0..65535

600

Wait with no outgoing packets on a connection before sending an Inactivity Test(IT) message(in secs).

rxInactTimer

0..65535

900

Wait with no incoming packets on a connection before clearing connection(should be > txInactTimer)(in secs).

relTimer

0..65535

4

Time to wait for response to release request(in secs.)

repRelTimer

0..65535

4

Time to wait for response to 2nd release request(in secs)

intvalTimer

0..65535

8

Wait to report abnormal release timer.(in secs)

guardTimer

0..65535

1

Time to wait after MTP3 restart before allowing traffic(in secs.)

resetTimer

0..65535

6

Time to wait for response to reset request(in secs.)

traceFlags

0..255

0

Data tracing (see SccpTraceControl primitive for definition of trace flags).

alarmLevel

SCCP_ALARMLVL_DISABLE, DEFAULT, DEBUG, DETAIL

SCCP_ALARMLVL_DEFAULT

Level of alarms to be generated by SCCP layer (see SccpAlarmControl primitive reference for definition of alarm levels).



(Page 19 of 30 in this chapter)


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