(Page 22 of 30 in this chapter)


SccpInitUSapCfg

Description

Initializes an SCCP User SAP configuration buffer to default values that can be passed to the SccpSetUSapCfg routine.

Prototype

SCCP_STATUS SccpInitUSapCfg (SccpUSapCfg *pCfg,

S16 swType)

pCfg The address of the SCCP SAP configuration parameters buffer.

swType The switch type that the SCCP SAP should use:

                                       SCCP_SW_ITU88
                                       SCCP_SW_ITU92
                                       SCCP_SW_ANS88
                                       SCCP_SW_ANS92

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

typedef struct
{
  S16          swType;                   /* Protocol Switch 
                                          * type/version               */
  U8           selector;                 /* selector                   */
  U8           spare1;                   /* alignment                  */
  MemoryId     mem;                      /* memory region & pool id    */
  U8           bkupPcInd;                /* backup point code indicator
                                          * (0==none)                  */
  U8           spare2;                   /* alignment                  */
  U32          bkupPc;                   /* backup point code          */
  U16          numConPc;                 /* number of concerned
                                          * point codes                */
  U32          conPcList[SCCP_MAXCONPC]; /* list of concerned
                                          * point codes                */
  U8           useMsk;                   /* use address mask?
                                          * (0=no, 1=yes)              */
  U8           spare3;                   /* alignment                  */
  SccpAddrMask addrMsk;                  /* address mask for outgoing 
                                          * pkts on this SAP           */
  U8           priority;                 /* priority                   */
  U8           route;                    /* route                      */
  U8           hopCnt;                   /* default Hop Count
                                          * (between 1 and 15)         */
} SccpUSapCfg;

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

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

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

Name

Range

Default Value

Description

swType

SCCP_SW_
ANS88,
ANS92,
ITU88,
ITU92

SCCP_SW_
ANS92

Protocol variant to be used for this SAP.

bkupPcInd

0..1

0

Set to 1 if a Backup Point Code is to be configured.

bkupPc

Entered as a hex value

None

Point code where this subsystem is backed up. 1.1.1 would be entered as 0x00010101

numConPc

0..
SCCP_MAXCONPC

0

Number of Concerned Point Codes in the conPcList.

conPcList

Entered as a hex value

None

Up to SCCP_MAXCONPC point codes, each entered as a hex value. 1.1.1 would be entered as 0x00010101.

useMsk

0..1

0

Set to 1 if an addrMsk is defined.

addrMsk

up to SCCP_LENADDR bytes

None

An address mask describing which digits of a global title to match on when performing a global title translation.

hopCnt

1..15

10

Hop count value to be used on outgoing SCCP messages from this SAP.

The addrMsk can only be composed of 0's and F's. Each byte contains two hexidecimal digits. The utility SccpAsciiMaskToBcd can be used to convert an ASCII string into the correct format. As an example, "FFF" masks off everything but the first three digits of a Global Title. The result is then compared to the various Global Titles configured. The mask "FFFFFFFFFF" does not mask off any digits.

An addrMsk of a single zero (0) matches ALL global titles. Any global title masked with an addrMsk of zero will match an ADDRESS section of zero (0).



(Page 22 of 30 in this chapter)


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