(Page 18 of 30 in this chapter)


SccpInitAddrCfg

Description

Initializes an SCCP global title translation definition to its default values that can be passed to the SccpSetAddrCfg routine.

Prototype

SCCP_STATUS SccpInitNSapCfg (SccpAddrMapCfg *pCfg,

U8 *pGtIn,

U8 nBytes )

pCfg The address of the SCCP global title translation buffer.

pGtIn The pointer to a buffer containing binary coded decimal digits that define the global title (or partial title) to be translated.

nBytes The number of bytes in BCD encoded Global Title.

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

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

typedef struct
{
  U8  format;              /* format type                */
  U8  spare1;              /* alignment                  */
  union {
  struct {                 /* Format 1:                  */
  U8  oddEven;             /* odd/even indicator         */
  U8  natAddr;             /* nature of address          */
  U8  spare1;              /* alignment                  */
  U8  spare2;              /* alignment                  */
   } f1;
struct {                   /* Format 2:                  */
  U8  tType;               /* translation type           */
  U8  spare1;              /* alignment                  */
  U8  spare2;              /* alignment                  */
  U8  spare3;              /* alignment                  */
   } f2;
struct {                   /* Format 3:                  */
  U8  tType;               /* translation type           */
  U8  numPlan;             /* numbering plan             */
  U8  encSch;              /* encoding scheme            */
  U8  spare1;              /* alignment                  */
   } f3;
struct {                   /* Format 4:                  */
   U8 tType;               /* translation type           */
   U8 numPlan;             /* numbering plan             */
   U8 encSch;              /* encoding scheme            */
   U8 natAddr;             /* nature of address          */
   } f4;
  }
 SccpAddrName addr;
} SccpGlbTitleCfg;

typedef struct
{
  U8              pres;   /* address is present (always 1)    */
  U8              spare1; /* alignment                        */
  S16             swType; /* variant switch                   */
  U8              niInd;  /* national/international indicator */
  U8              rtgInd; /* routing indicator                */
  U8              ssnInd; /* subsystem number indicator       */
  U8              pcInd;  /* point code indicator             */
  U8              ssn;    /* subsystem number                 */
  U8              spare2; /* alignment                        */
  U32             pc;     /* point code                       */
  SccpGlbTitleCfg gt;     /* global title                     */
} SccpAddrCfg;

typedef struct
{
  SccpAddrName  gtI;    /* Global Title (incoming)               */
  U8            replGt; /* replace Gt (0=leave glt,1=replace glt)*/
  U8            spare1; /* alignment                             */
  SccpAddrCfg   addr;   /* outgoing address                      */
} SccpAddrMapCfg;

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

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

Once a global title translation is set by SccpSetAddrCfg, it can only be modified by first deleting it with SccpDelAddrCfg, and then calling SccpSetAddrCfg with the new parameters.
Name

Range

Default Value

Description

gtI

N/A

parameter

Global title or portion of a global title to be matched in outgoing addresses.

replGt

0..1

0

Set to 1 if the Global Title should be replaced on the outgoing message.

addr.swType

SCCP_SW_ANS,
ITU

SCCP_SW_ANS

Format of the address.

addr.rtgInd

ROUTE_PC_SN,
ROUTE_GLT

ROUTE_PC_SN

Set the routing flag on the outgoing message. Either Route by point code and SSN, or route by the global title.

addr.pcInd

0..1

0

Set to 1 if a point code is included in outgoing message.

addr.pc

N/A

None

Translated point code. Entered as a hex number.

addr.ssnInd

0..1

0

Set to 1 if subsystem is included in outgoing message. If a subsystem is included in the Called Address of the message, then that subsystem will be inserted into the message.

addr.ssn

0..255

None

Translated Subsystem number

addr.niInd

ADDRIND_INT,
NAT

ADDRIND_NAT

National/International indicator in the outgoing message.

addr.gt.format

0..4

0

Only used if the global title is to be replaced(replGt is 1). Specifies the format of the global title.

addr.gt.gt. fn.tType

0..255

None

Only used if the global title is to be replaced(replGt is 1), and if required by the global title format.

addr.gt.gt. fn.natAddr

0..4

None

Only used if the global title is to be replaced(replGt is 1) ), and if required by the global title format.

addr.gt.gt. fn.numPlan

0..15

None

Only used if the global title is to be replaced(replGt is 1) ), and if required by the global title format.

addr.gt.addr

N/A

None

Only used if the global title is to be replaced(replGt is 1)

There are several ways to specify the content of outgoing messages for Global Title translations.

The outgoing message will be routed to point code 1.1.2, subsystem 254, with the routing flag set to "Route by PC&SSN". The original global title is included in the outgoing message. Since the replGt field is zero (the global title is NOT replaced), none of the addr.gt fields need to be filled.

The outgoing message will be routed to point code 1.1.2, subsystem 254, with the routing flag set to "Route by Global Title". The original global title is included in the outgoing message. The node at 1.1.2 will then translate the global title. Since the replGt field is zero (the global title is NOT replaced), none of the addr.gt fields need to be filled.



(Page 18 of 30 in this chapter)


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