MonInitLinkCfg

Builds a link configuration buffer to be passed to MonSetLinkCfg.

Prototype

MON_STATUS MonInitLinkCFg ( U8 board, MonLinkCfg *pLinkCfg, S16 linkNo, U8 linkType )

Argument

Description

board

TX board number on which the desired monitor task resides.

pLinkCfg

Pointer to the MonLinkCfg structure to initialize. For more information, refer to Details.

linkNo

Specifies the link number for which to set this structure.

linkType

CCITT, ITU, or ANSI.


Return values

Return value

Description

MON_BOARD

Board number out of range.

MON_DRIVER

CPI driver returned an error.

MON_HANDLE

Board not previously initialized.

MON_LINKTYPE

Invalid link or switch type.

MON_PARAM

Invalid parameter.

MON_RESPONSE

Wrong response from board.

MON_SUCCESS

 

MON_TIMEOUT

No response from board.


Details

This function initializes a MonLinkCfg structure to all of its default values:

typedef struct 
{
    U16     linkNum;               /* Link Number */
    U16     linkType;              /* ANSI/ITU */
#define MON_LINK_ANSI      0
#define MON_LINK_ITU       1
#define MON_LINK_ANSI_EXT  2
#define MON_LINK_ITU_EXT   3
    U16     portNum;               /* Port number (from tdmcfg or txconfig) */
    U16     portType;              /* Port type (Serial no longer supported) */
#define MON_PTYPE_TDM      4
    U16     dataEnc;               /* Data encoding (NRZ/NRZI) */
#define DAT_NRZ            0       /* data format is NRZ */
#define DAT_NRZI           1       /* data format is NRZI */
    U16     maxFrameLen;           /* Maximum SS7 frame length */
    U16     numBuffers;            /* Number of buffers in limited pool */
    U16     sizeBuffers;           /* Size of each buffer in limited pool */
} MonLinkCfg;

The following table lists the field defaults and possible values:

Field

Default

Range

Description

linkNum

linkNo parameter

0 - 15 (TX 4000/20, TX 4000/20C)

0 - 31 (TX 4000, TX 4000C)

0 - 127 (TX 5000 Series)

Link index number to use to refer to this link.

linkType

linkType parameter

 

Link type can be ANSI or ITU with or without the support for extended sequence numbers. This is used to help the SS7 Monitor task decode parts of the SS7 messages.

portNum

linkNo parameter + 1

1 - 16 (TX 4000/20, TX 4000/20C)

1 - 32 (TX 4000, TX 4000C)

1 - 128 (TX 5000 Series)

Port number from the TDM configuration.

portType

MON_PTYPE_TDM

 

Only allowed port type is TDM for T1 or E1.

dataEnc

DAT_NRZ,
DAT_NRZI|DAT_NRZ

 

Not applicable.

maxFrameLen

272

0 - 500

Maximum frame length for a received SS7 message.

numBuffers

500

50 - 1000

Number of buffers to use on the board for receiving SS7 messages from the network.

sizeBuffers

400

300 - 500

Size of the buffers used for receiving SS7 messages from the network.