Sample monitoring application: monapp

Partially decodes SS7 messages, but does not support the decoding of MTP2 extended sequence numbers (used for high speed links).

Usage

monapp -b boardnum

Prerequisites

Procedures

Follow this procedure to run monapp:

Step

Action

1

From the command line prompt, navigate to the \Program Files\Dialogic\tx\bin directory under Windows or the /opt/dialogic/tx/bin directory under UNIX.

2

Enter the following command:

monapp -b boardnum

where boardnum is the number of the TX board to open.

At startup, the sample application attempts to bind to the monitor task and starts printing to the screen whenever a data indication is received.


Follow this procedure to enter command mode:

Step

Action

1

Press Enter to display the following prompt:

Command?>

2

Enter one of the following commands from this prompt:

Command

Description

Q

Quit monapp

I

Make tracing to screen invisible

V

Make tracing to screen visible

DATA pattern

set a specific pattern to match on

STATS ISUP|GEN [link_number]

Get statistics for one link or all links

RESET [link_number]

Reset statistics for one link or all links

MTP2 [0|1]

0 = No MTP2 header in the data

1 = MTP2 header in the data

SHOW [0|1]

0 = Do not display data

1 = Display data

ISUP [0|1]

0 = No ISUP messages

1 = Decode ISUP message types

?

Display monapp command help


 


SS7 message header

The monapp application partially decodes SS7 messages. monapp decodes the following information from the SS7 message header:

For each SS7 message, a generic trace is displayed. For example:

=======================================================
Length: --          Link #:--          NumSpare: --
Number seconds: -- msecs: --

The following table describes the SS7 message data:

If the message length is...

Then...

Less than 3 bytes

The trace, Bad message length --, displays.

Equal to 3 bytes

A FISU is decoded and the following trace displays: FISU: BSN BSN:BIB FSN FSN:FIB

Equal to 4 or 5 bytes

A LSSU is decoded. One of the following traces displays, depending on the LSSU type:

  • SIO: BSN BSN:BIB FSN FSN:FIB

  • SIN: BSN BSN:BIB FSN FSN:FIB

  • SIE: BSN BSN:BIB FSN FSN:FIB

  • SIOS: BSN BSN:BIB FSN FSN:FIB

  • SIPO: BSN BSN:BIB FSN FSN:FIB

  • If some other type of LSSU:LSSU: BSN BSN:BIB FSN FSN:FIB

Greater than 5 bytes

MSU and generic trace display.

MSU: BSN BSN:BIB FSN FSN:FIB

Additional traces display:

  • To specify the type of the upper protocol of the MSU (such as MTP3, TCAP, SCCP, and ISUP)
    Protocol: protocol_name

  • In case of ISUP, additional traces are available to specify the ISUP message type (such as ACM, ANM, REL, and RLC)
    Protocol: ISUP
    Message: message_name


The following table describes the mnemonics that the SS7 message data displays:

Mnemonic

Description

ACM

Address complete message

ANM

Answer message

BIB

Backward indicator bit

BSN

Backward sequence number

FIB

Forward indicator bit

FISU

Fill in signal unit

FSN

Forward sequence number

LSSU

Link status signal unit

MSU

Message signal unit

REL

Release

RLC

Release complete

SIE

Status indicator emergency alignment

SIN

Status indicator normal alignment

SIO

Status indicator out of alignment

SIOS

Status indicator out of service

SIPO

Status indicator processor outage