Options	Description
`-b` *board*	Board number to which the ISUP configuration is downloaded (default = 1)
`-f` *filename*	Name and location of the ISUP configuration file to be downloaded

Options	Description
`-b` *board*	Board number on which to bind (default = 1).
`-i`	Specifies ITU switch type.
`-c` *number*	Circuit ID with which to test (default = 1).

Options	Description
-i	Specifies ITU switch type.
`-b` *board*	TX Board number on which to bind (default = 1).
*called number*	Phone number to which the call is placed.
*circuit index*	Circuit index on which the call is placed.
*calling number*	Phone number from which the call is placed.

Version

Chapter 6

ISUP Sample Applications

6.1 The ISUP Configuration Utility

: 6.1.1 Using the ISUP Configuration Utility

6.2 The ISUP Manager Program

: 6.2.1 Using the ISUP Manager Program

6.3 The ISUP Termination Sample Program

: 6.3.1 Using the ISUP Termination Sample Program

6.4 The ISUP Origination Sample Program

: 6.4.1 Using the ISUP Origination Sample Program

6.1 The ISUP Configuration Utility

The ISUP Configuration (isupcfg) utility scans the ISUP configuration text file and downloads the configuration to the ISUP task on the TX board. Refer to the SS7 Installation and Configuration Manual for more information.

6.1.1 Using the ISUP Configuration Utility

Procedure

To run isupcfg:

From the command line prompt, navigate to the \nms\tx\samples\isup\isupcfg directory under
Windows NT/Windows 2000, or the /usr/bin/ directory under UNIX.

At the command line, enter the following:

isupcfg options
where options include:

Options

Description

-b board

Board number to which the ISUP configuration is downloaded (default = 1)

-f filename

Name and location of the ISUP configuration file to be downloaded

The ISUP Configuration program scans the information in the ASCII file (specified with the -f option) and downloads this information to the task on the TX board.

Notes

The ISUP Configuration utility is available in both source code and executable formats. The source code illustrates the use of the ISUP management API primitives for developers who wish to integrate management of the SS7 ISUP layer into their own configuration management systems.

6.2 The ISUP Manager Program

After downloading the ISUP configuration to the TX board with isupcfg, run the ISUP Manager (isupmgr) program to monitor the status of the ISUP layer. The ISUP Manager provides a command line interface from which alarm levels can be set, buffers can be traced, and ISUP statistics can be viewed and reset.

6.2.1 Using the ISUP Manager Program

Name

isupmgr

Purpose

Monitors and manages the status of the ISUP layer.

Usage

isupmgr -b board

Prerequisites

Requires a single computer with a TX 2000, TX 3000, TX 3220, or TX 3220C board installed, in addition to the following software: Windows NT 4.0, Windows 2000, Intel Solaris 2.6 or 7, SPARC Solaris 2.6 or 7, or UnixWare 7 Natural Access 1999-4 or later

Procedure

From the command line prompt, navigate to the \nms\tx\samples\isup\isupmgr\ directory under
Windows NT/Windows 2000, or the /usr/bin/ directory under UNIX.
At the command prompt, enter the following:
isupmgr -b board
where board is the TX board number to open.

The isupmgr program supports the following commands:


Command	Description
VALIDATE *number*	Validates the specified circuit.
RESET *number*	Resets the specified circuit.
BLOCK *number*	Blocks the specified circuit.
UNBLOCK *number*	Unblocks the specified circuit.
DELETE *number*	Deletes the specified circuit.
STATUS *number*	Displays status of specified circuit.
STATS *entity* *number*	Retrieves statistics for the given *entity* (either NSAP or CIRCUIT).
GET *entity* *number*	Retrieves configuration information for the given *entity* (either GEN, USAP, NSAP, or CIRCUIT).
TRACE ON \| *OFF*	Turns buffer tracing ON or OFF.
BOARD *board*	Switches to a new target board (*board*).
QUIT	Quits the application.

Notes

The ISUP Manager program is available in both source code and executable formats. The source code illustrates the use of the ISUP management API primitives for developers who wish to integrate management of the SS7 ISUP layer into their own configuration management systems.

6.3 The ISUP Termination Sample Program

The ISUP Termination sample program (term) demonstates how the ISUP API can be used to accept incoming phone calls.

6.3.1 Using the ISUP Termination Sample Program

Name

term

Purpose

Accepts incoming an incoming call from the specified TX board.

Usage

term options

Prerequisites

Requires a single computer with a TX 2000, TX 3000, TX 3220, or TX 3220C board installed, in addition to the following software: Windows NT 4.0, Windows 2000, Intel Solaris 2.6 or 7, SPARC Solaris 2.6 or 7, or UnixWare 7 Natural Access 1999-4 or later

Procedure

To run term:

From the command line prompt, navigate to the \nms\ss7\samples\isup\ directory under
Windows NT\Windows 2000, or the /usr/bin/ directory under UNIX.

At the command line, enter the following:

nupterm options
where options include:

Options

Description

-b board

Board number on which to bind (default = 1).

-i

Specifies ITU switch type.

-c number

Circuit ID with which to test (default = 1).

Press any key to exit the program.

Notes

The ISUP Termination sample program prints out all events retrieved by ISUPRetrieveMessage, including blocks, unblocks, and resets received.

6.4 The ISUP Origination Sample Program

The ISUP Origination sample program (orig) demonstrates how the ISUP API can be used to generate an outbound call.

6.4.1 Using the ISUP Origination Sample Program

Name

orig

Purpose

Generates an outbound call to the specified TX board.

Usage

orig options

Prerequisites

Requires a single computer with a TX 2000, TX 3000, TX 3220, or TX 3220C board installed, in addition to the following software: Windows NT 4.0, Windows 2000, Intel Solaris 2.6 or 7, SPARC Solaris 2.6 or 7, or UnixWare 7 Natural Access 1999-4 or later

Procedure

To run orig:

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

At the command line, enter the following:

orig options
where options include:

Options

Description

-i

Specifies ITU switch type.

-b board

TX Board number on which to bind (default = 1).

called number

Phone number to which the call is placed.

circuit index

Circuit index on which the call is placed.

calling number

Phone number from which the call is placed.

Press r to release the call and press q to quit the program.

Notes

The ISUP Origination sample program prints out all events retrieved by ISUPRetrieveMessage, including blocks, unblocks, and resets received.

Version

Want to send us feedback on our documentation? Email: Tech_Pubs@nmss.com