TUP layer status: tupmgr

 

Monitors the status of the TUP layer after the TUP configuration is downloaded to the TX board with tupcfg. The TUP manager (tupmgr) provides a command line interface that enables an application to set alarm levels, trace buffers, and view TUP statistics.

Requirements

Procedure

Follow this procedure to run tupmgr:

Step

Action

1

From the command line prompt, navigate to the \nms\tx\samples\tup\tupmgr\ directory under Windows or the /usr/bin/ directory under UNIX.

2

Enter the following command:

tupmgr -b board

where board is the TX board on which the TUP layer is loaded.


The tupmgr program supports the following commands:

Command

Description

VALIDATE circuit

Validates the specified circuit.

BLOCK circuit

Blocks TUP circuit.

UNBLOCK circuit

Unblocks TUP circuit.

RESET entity number

Resets the specified entity (CIRCUIT or GROUP) number.

MBLOCK circuit

Maintenance blocks the specified circuit group.

HBLOCK circuit

Hardware blocks the specified circuit group.

SBLOCK circuit

Software blocks the specified circuit group.

MUNBLOCK circuit

Maintenance unblocks the specified circuit group.

HUNBLOCK circuit

Hardware unblocks the specified circuit group.

SUNBLOCK circuit

Software unblocks the specified circuit group.

DELETE entity number

Deletes the specified entity (CIRCUIT or GROUP) number. If CIRCUIT is selected, the count of circuits to delete must also be specified.

STATUS entity number

Retrieves status of current entity (CIRCUIT or GROUP) number.

STATS entity number

Retrieves statistics for the specified entity (NSAP, GROUP, or CIRCUIT) number.

GET entity number

Retrieves configuration for the specified entity (GEN, USAP, NSAP, GROUP, CIRCUIT) number.

TRACE entity ON | OFF

Turns buffer tracing ON or OFF for the specified entity (EVENT, DATA, ERROR, WARNING, ELEMENT, or TIMER).

BOARD board

Switches to a new target board.

Q

Quits the application.


Details

The TUP manager program is available in both source code and executable formats. The source code demonstrates how to use TUP management to integrate SS7 TUP layer management into custom configuration management systems.