M3UAGenCfg

Dependent functions: M3uaGetGenCfg, M3uaInitGenCfg, M3uaSetGenCfg

The following M3UAGenCfg structure contains general M3UA configuration parameters. Bold text indicates fields you can set. Unbolded fields are either unused or for internal use only. They are set to correct values by M3uaInitGenCfg and must not be overridden.

typedef struct _M3UAGenCfg          /* M3UA general configuration */
{
    U8              nodeType;       /* type of M3UA - SGP or ASP */

    Bool            dpcLrnFlag;     /* DPC learning mode enable */
    Bool            drkmSupp;       /* DRKM supported */
    Bool            drstSupp;       /* DRST supported */
    U16             maxNmbNSap;     /* number of upper SAPs */

    U16             maxNmbSctSap;   /* number of lower SAPs */
    U16             maxNmbNwk;      /* number of Network Appearances */
    U16             maxNmbRtEnt;    /* number of Routing Entries */
    U16             maxNmbDpcEnt;   /* number of DPC entries */
    U16             maxNmbPs;       /* number of Peer Servers */
 
   U16             maxNmbLps;      /* number of Local PS */
    U16             maxNmbPsp;      /* number of Peer Signalling Processes */
    U16             maxNmbMsg;      /* max MTP3/M3UA messages in transit */
    U16             maxNmbRndRbnLs; /* number of Round Robin Loadshare contexts */
    U16             maxNmbSlsLs;    /* number of SLS based Loadshare contexts */

    U32             maxNmbSls;      /* number of SLS contexts */
    U32             qSize;          /* congestion queue size in M3UA */
    U32             congLevel1;     /* congestion level 1 in the queue */
    U32             congLevel2;     /* congestion level 2 in the queue */
    U32             congLevel3;     /* congestion level 3 in the queue */
    M3UAGenTimerCfg tmr;            /* gen Timer  Config */

    S16             timeRes;        /* timer resolution */
    U16             spare1;         /* alignment */
    U32             debugMask;      /* Debugging mask */
    U32             traceMask;      /* Tracing mask */

    Pst             smPst;          /* Post stack mgr structure */
} M3UAGenCfg;

The following table describes the fields in the M3UAGenCfg structure that you can set:

Field

Type

Default

Re-configurable?

Description

nodeType

U8

ASP

No

Type of node. Valid values are:

M3UA_TYPE_ASP = ASP or IPSP configuration.

M3UA_TYPE_SGP = SGP configuration.

 

Currently only M3UA_TYPE_ASP is supported.

maxNmbNSap

U16

2

No

Maximum number of NSAPs supported simultaneously.

maxNmbNwk

U16

2

No

Maximum number of network contexts supported. There is one network context per variant and network indicator.

maxNmbRtEnt

U16

16

No

Maximum number of route entries supported, including local routes.

maxNmbDpcEnt

U16

32

No

Maximum number of DPCs supported, including configured and dynamically learned DPCs.

maxNmbPs

U16

8

No

Maximum number of peer servers supported, including both local and remote peer servers.

maxNmbPsp

U16

16

No

Maximum number of peer signaling processes supported.

maxNmbMsg

U16

128

No

Number of M3UA messages in transit supported.

maxNmbRndRbnLs

U16

4

No

Maximum number of peer servers that can use round-robin load sharing.

maxNmbSlsLs

U16

4

No

Maximum number of peer servers that can use SLS-based load sharing.

maxNmbSls

U32

128

No

Maximum number of SLS values used by all peer servers.

qSize

U32

256

Yes

Outgoing congestion queue size per association. Messages above this limit are dropped.

congLevel1

U32

64

Yes

Congestion level 1 in the queue; not valid in international networks.

congLevel2

U32

128

Yes

Congestion level 2 in the queue; not valid in international networks.

congLevel3

U32

196

Yes

Congestion level 3 in the queue; not valid in international networks.

tmr

Structure

Refer to structure

Refer to structure

Timer configurations, defined by M3UAGenTimerCfg.

debugMask

U32

0

Yes

Enables debug logging. Valid values are:

0 = No debug logging.

0xFFFFFFFF = Enables debug logging.

 

You can also enable debug logging by using the m3uamgr debug command, as described in m3uamgr commands.

trcMask

U32

0

Yes

Enables data tracing. Values are:

0 = No data logging.

0xFFFFFFFF = Enables data tracing.

 

You can also enable data tracing by using the m3uamgr trace command, as described in m3uamgr commands.