(Page 20 of 30 in this chapter)


SccpInitNSapCfg

Description

Initializes an SCCP NSAP configuration buffer to its default values that can be passed to the SccpSetNSapCfg routine.

Prototype

SCCP_STATUS SccpInitNSapCfg (SccpNSapCfg *pCfg,

U16 sapId,

U32 dpc,

S16 swType)

pCfg The address of the SCCP NSAP configuration parameters buffer.

sapId The NSAP ID being defined.

dpc The point code of this NSAP.

swType The switch type that the SCCP NSAP should use:

                                       SCCP_SW_ITU
                                       SCCP_SW_ANS

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

typedef struct
{
  U8           length;             /* length in bytes                 */
  U8           strg[SCCP_LENADDR]; /* address value - hex bcd digits  */
  U8           spare1;             /* alignment                       */
} SccpAddrMask;

typedef struct
{
  S16          swType;             /* Protocol Switch type/version    */
  U8           dpcLen;             /* dpc length(PCLEN_ANSI |
                                    * PCLEN_ITU)                      */
  U8           spare1;             /* alignment                       */
  U32          dpc;                /* point code for this nsap 
                                    * (switch)                        */
  S16          maxMsgLen;          /* max message length for
                                    * MTP3 on this SAP                */
  S16          txQThr;             /* max msgs queued to MTP3
                                    * before discarding               */
  U8           useMsk;             /* use address mask? (0=no, 1=yes) */
  U8           spare2;             /* alignment                       */
  SccpAddrMask addrMsk;            /* address mask for incoming pkts 
                                    * on this SAP                     */
  MemoryId     mem;                /* memory region & pool id         */
  U8           selector;           /* selector                        */
  U8           spare3;             /* alignment                       */
  U16          dstProcId;          /* destination processor id        */
  U8           priority;           /* priority                        */
  U8           route;              /* route                           */
  U8           dstEnt;             /* destination entity              */
  U8           dstInst;            /* detination instance             */
  S16          spId;               /* service provider id             */
  U8           hopCnt;             /* default Hop Count 
                                    * (between 1 and 15)              */
  U8           ssf;                /* subsytem part of SIO to
                                    * be used on NSAP                 */
} SccpNSapCfg;

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

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

All values listed in the following table may be modified on the FIRST call to SccpSetNSapCfg. On subsequent calls to SccpSetNSapCfg, 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_
ANS,
ITU

parameter

Protocol variant to be used for this NSAP.

dpcLen

PCLEN_
ANSI,
ITU

ANSI:PCLEN_ANSI
ITU:PCLEN_ITU

Point code length of this network.

dpc

Entered as a hex value

parameter

Point code of this node. 1.1.1 would be entered as 0x00010101.

maxMsgLen

32..1500

256

Maximum length of a message passed to MTP3 on this NSAP.

txQThr

0..32766

20

Maximum number of messages to queue to MTP3 before discarding.

useMsk

0..1

0

Set to 1 if an addrMsk is defined.

addrMsk

up to SCCP_LENADDR characters

None

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

spId

0..SccpGenCfg maxNSaps-1

parameter

The NSAP ID.

hopCnt

1..15

10

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

ssf

SCCP_SSF_
INTL,
SPARE,
NAT,
RES

ANSI:
SCCP_SSF_NAT
ITU:
SCCP_SSF_INTL

The value to be used in the subservice field for this network.

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.

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 20 of 30 in this chapter)


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