Table of Contents Index NMS Glossary Previous Page Next Page Version


Chapter 5

Demonstration Program


5.1 MSPP Exerciser Program
5.1.1 Using msppxsr

5.1 MSPP Exerciser ProgramTop of Page

After initializing the system hardware with oamsys, run the MSPP Exerciser (msppxsr) program to verify that the system supports creating and enabling MSPP connections. The MSPP Exerciser program is a looping demonstration program that repeatedly creates, connects, and enables MSPP channels, then disables, disconnects, and destroys them. It supports the maximum number of connections the host system can support.

5.1.1 Using msppxsrTop of Page

Name

msppxsr

Purpose

Demonstrates creating, connecting, enabling, disabling, disconnecting, and destroying MSPP endpoints and channels. Also demonstrates sending commands to MSPP endpoint and channel filters.

Usage

msppxsr arguments

Featured Functions

mspCreateEndpoint, mspCreateChannel, mspConnect, mspEnableChannel, mspSendCommand, mspDisconnect, mspDisableChannel, mspDestroyChannel

Description

Verifies that MSPP endpoints and channels can be created, connected, and enabled on CG 6000C board DSPs.

Before running msppxsr:

Procedure

To run msppxsr:

  1. From the command line, navigate to the nms\fusion\samples\general\msppxsr directory.

    
    
  2. Enter the following:

    
    msppxsr ep1 chan ep2 localip remoteip maxconx loopcount
    Where:
    Argument

    Description

    Valid Entries

    ep1

    Type of created for endpoint 1

    DS0 (default)

    RTP

    RTPIN

    RTPOUT

    UDP

    UDPIN

    UDPOUT

    chan

    Type of MSPP channel to connect the endpoints

    Entry Channel Type

    1 G.711 full duplex

    2 G.723 full duplex

    3 G.726 full duplex

    4 G.729 full duplex

    5 Fax full duplex

    6 Fax standby

    7 G.711 enc. simplex

    8 G.711 dec. simplex

    9 G.723 enc. simplex

    10 G.723 dec. simplex

    ep2

    Endpoint type of endpoint 2

    See valid entries for ep2.

    localip

    Local IP address for an RTP or UDP endpoint (if no RTP or UDP endpoint is created, this value is ignored).

    Entering 0 indicates that the data will not be transferred to an IP network (testing purposes).

    IP address in standard xxx.xxx.xxx.xxx format or 0.

    remoteip

    Remote IP address for an RTP or UDP endpoint (if no RTP or UDP endpoint is created, this value is ignored).

    Entering 0 indicates that the data will not be transferred to an IP network (testing purposes).

    IP address in standard xxx.xxx.xxx.xxx format or 0.

    maxconx

    Maximum number of channels msppxsr creates. Valid range is 1 to 120.

    1-120

    loopcount

    Number of times msppxsr creates and destroys connections. Must be greater than or equal to one.

    1 or greater

    For example:
    msppxsr rtp 4 ds0 0 0 1 10
    Commands msppxsr to create set up and tear down one duplex G.729A/B voice connection (made up of a DS0 endpoint, a G.729A/B channel, and an RTP endpoint) ten times. No data is transferred to the IP network (because localip and remoteip = 0).
    msppxsr uses ctaCreateQueue, ctaCreateContext, and ctaOpenService to create CTA queues, contexts, open CTA services for MSPP endpoints and channels. msppxsr then creates, connects and enables MSPP endpoints and channels with mspCreateEndpoint, mspCreateChannel, and mspConnect, and mspEnableChannel.
    
    After the maxconx channels have been enabled, msppxsr disables, disconnects, and destroys the MSPP channels with mspDisableChannel, mspDisconnect, mspDestroyChannel, and mspDestroyEndpoint. msppxsr exercises each MSPP channel the number of times specified by loopcount.
    
    As msppxsr executes, it displays results of MSPP function calls at the command prompt, and displays status information about MSPP connections. 
    Before msppxsr sets up and tears down MSPP connections for the final time (iteration loopcount - 1), it displays a numbered list of commands you may invoke for the connected channels (the list varies according to the kinds of channels created). Execute commands by entering the associated number at the command prompt.
  3. To stop the program after entering commands, enter Q.

Description

msppxsr creates and enables the maximum supported (maxconx) number of MSPP channels for the number of iterations specified by loopcount. The command line interface shows the progress of MSPP commands as they execute.

Note: When msppxsr stops running in the middle of a cycle, this usually means an expected event has not been received. This may occur because of a configuration error or software mismatch. Check configuration files, runtime files, and component file dates (make sure the PATH environment variable does not redirect the system to an older file).



Table of Contents Index NMS Glossary Previous Page Next Page Version


Want to send us feedback on our documentation? Email: Tech_Pubs@nmss.com
Copyright © 2000, Natural MicroSystems, Inc. All rights reserved.