(Page 21 of 30 in this chapter)


SccpInitRteCfg

Description

Initializes an SCCP route definition that can be passed to the SccpSetRteCfg routine.

Prototype

SCCP_STATUS SccpInitRteCfg (SccpRouteCfg *pCfg, U32 dpc)

pCfg The address of the SCCP route definition buffer.

dpc The destination point code of the route to be added, specified as a hexidecimal number. Hence, point code 1.1.1 would be stored as 0x00010101.

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

typedef struct
{
  S16  swType;                   /* not used                        */
  U8   ssn;                      /* subsystem number                */
  U8   status;                   /* status                          */
  U8   bkupPcInd;                /* backup point code indicator 
                                  * (0=none)                        */
  U8   spare1;                   /* alignment                       */
  U32  bkupPc;                   /* backup point code               */
  U16  numConPc;                 /* number of concerned point codes */
  U32  conPcList[SCCP_MAXCONPC]; /* concerned point codes           */
} SccpSsnCfg;

 

typedef struct
{
  S16        swType;                /* Protocol Switch
                                     * type/version           */
  U32        dpc;                   /* destination point code */
  U8         status;                /* adjacent/translator 
                                     * flags                  */
  U8         bkupPcInd;             /* backup point code 
                                     * indicator (0=none)     */
  U32         bkupPc;                /* backup point code      */
  U8         numSsns;               /* number of subsystems   */
  U8         spare1;                /* alignment              */
  SccpSsnCfg ssnList[SCCP_MAXSSNS]; /*subsystems for this dpc */
} SccpRouteCfg;

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

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

Once a route definition is set by SccpSetRteCfg, it can only be modified by first deleting it with SccpDelRteCfg, and then calling SccpSetRteCfg with the new parameters.
Name

Range

Default Value

Description

swType

SCCP_SW_ANS,
ITU

SCCP_SW_ANS

Protocol variant for this point code.

dpc

Entered as a hex value

None

input parameter.1.1.1 would be entered as 0x00010101.

status

N/A

SCCP_
ONLINE |
TRANS |
ADJACENT

Flags to set initial status of point code. Flags are OR'd together.

SCCP_ONLINE
SCCP_TRANS
SCCP_ADJACENT

bkupPcInd

0..1

0

Set to 1 if backup point code is specified.

bkupPc

Entered as a hex value

None

Point code of backup for this destination. 1.1.1 would be entered as 0x00010101.

numSsns

0..SCCP_
MAXSSNS

0

Number of Subsystem definitions contained in the ssnList array.

ssnList

N/A

None

Array of subsystem definitions for this point code.

ssnList[n]. ssn

0..255

None

Subsystem number.

ssnList[n]. status

N/A

SCCP_SNR |
SCCP_ACC

Flags to set initial status of subsystem. Flags are OR'd together:

SCCP_SNR
SCCP_ACC

ssnList[n]. bkupPcInd

0..1

0

Set to 1 if backup point code is specified.

ssnList[n]. bkupPc

Entered as a hex value

None

Point code of backup for this subsystem. 1.1.1 would be entered as 0x00010101.

ssnList[n]. numConPc

0..SCCP_
MAXCONPC

0

Number of concerned point codes contained in the conPcList array.

ssnList[n]. conPcList

see dpc

None

List of Concerned point codes for this subsystem.



(Page 21 of 30 in this chapter)


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