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

(Page 1 of 1 in this chapter) 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 (see the SS7 Installation and Configuration Manual) and downloads the configuration to the ISUP task on the TX board.

6.1.1 Using the ISUP Configuration Utility

Procedure

To run isupcfg: From the command line prompt, navigate to the tektx\samples\isup\isupcfg directory under Windows NT, 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

Featured Functions

isupTraceControl, isupValidateCircuit, isupResetCircuit, isupBlockCircuit, isupUnblockCircuit, isupDeleteCircuit, isupCircuitStatus, isupCircuitStats, isupNSapStats, isupGetGenCfg, isupGetUSapCfg, isupGetNSapCfg, isupGetCircCfg, isupInitMgmtAPI, and isupTermMgmtAPI

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, Intel Solaris 2.6 or 7, or SPARC Solaris 2.6 or 7 CT Access 3.0 or later

Procedure

From the command line prompt, navigate to the \tektx\samples\isup\isupmgr directory under Windows NT, 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

Featured Functions

ISUPRetrieveMessage, ISUPBCDtoASCII, ISUPInitACM, ISUPConnectStatusReq, ISUPReleaseResp, ISUPInitANM, ISUPConnectResp, ISUPInitINR, and ISUPStatusReq

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, Intel Solaris 2.6 or 7, or SPARC Solaris 2.6 or 7. CT Access 3.0 or later

Procedure

To run term: From the command line prompt, navigate to the tektx\samples\isup directory under Windows NT, 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

Featured Functions

ISUPRetrieveMessage, ISUPInitREL, ISUPReleaseReq, ISUPReleaseResp, ISUPStatusReq, ISUPInitINF, ISUPASCIItoBCD, ISUPConnectStatusReq, ISUPInitIAM, and ISUPConnectReq

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, Intel Solaris 2.6 or 7, or SPARC Solaris 2.6 or 7. CT Access 3.0 or later

Procedure

To run orig: From the command line prompt, navigate to the tektx\samples\isup directory under Windows NT, 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.

(Page 1 of 1 in this chapter) Version

tech_support@nmss.com