(Page 4 of 4 in this chapter)

6.3 Demonstration Descriptions

The remainder of this chapter documents how to set up your demonstration programs with the AG Connect scripts, and how to run the demos.

6.3.1 Loop Start Switching Demo (ati2mvip)

The code for this demo illustrates how to program the switching of an analog loop start line's voice path to the MVIP bus. In addition to the AG Connect board, the program requires an AG-8 board and ME/2/X. (Use of any other AG resource board requires extensive changes to the demo script and AG configuration file.)

The program involves the following files:

OS/2
File

 Description

\nms\agcx\demos\me\ati2mvip\agxclock.swi

 SW Utility script to configure the AG Connect board to provide the clock signal over the MVIP bus

\nms\agcx\demos\me\ati2mvip\agx2mvip.swi

 SW Utility script configuring the switching

\nms\agcx\demos\me\ati2mvip\read.me

 Readme file for the AG Connect demo

\vbx\swpdemos\ati2mvip\read.me

 The readme file for the original demo

\vbx\swpdemos\ati2mvip\ati2mvip

 Executable demo program

UNIX
File

 Description

/opt/nms/agcx/demos/me/ati2mvip/agxclock.swi

 SW Utility script to configure the AG Connect board to provide the clock signal over the MVIP bus

/opt/nms/agcx/demos/me/ati2mvip/agx2mvip.swi

 SW Utility script configuring the switching

/opt/nms/agcx/demos/me/ati2mvip/read.me

 Readme file for the AG Connect demo

/opt/nms/swp/demos/ati2mvip/read.me

 The readme file for the original demo

/opt/nms/swp/demos/ati2mvip/ati2mvip

 Executable demo program

To run the ati2mvip demonstration program with your AG Connect board, follow this procedure:

  1. Configure the MVIP bus clock by running the agxclock SW Utility script. To do so, enter the following:

       sw agxclock.swi

    

  2. Using a text editor, open the ag.cfg file for agmon. 
    

    

  3. In the "Board x" sections for your AG Connect With Ringing board and the resource board you are using, set EnableMVIP to YES:
    

       EnableMVIP = YES

    

  4. In the "Board x" section for the resource board you are using, add lines like the following: 
    

       ClockRef = MVIP
       MvipSlot = 6:0..7
       MvipSlot = 7:0..7    

    
Note: the values listed above are for an AG-8 board. If you are using another resource board type, the values you list will be different. For details, see the documentation that came with your resource board.
    

  5. Exit the text editor, saving your changes.
    

    

  6. To configure the switching, run the following SW Utility script:
    

       sw agx2mvip.swi

    

  7. Now begin execution of the ati2mvip program, by entering:
    

       ati2mvip line_number

    
...where line_number is the number of a line to dial into.
    

  8. Dial into the line that is connected to line_number. 
    

    
The call is answered and the voice path is connected to the MVIP time slot.
    
The program waits for you to hang up by monitoring for loop current interruption. 
    
Note:  Not all PBXs or central office switches provide loop current interruption. You may need to simulate loop current interruption by briefly unplugging the line.


  9. Hang up the phone.
    

    
When you hang up, the line is placed on-hook and the original connection between the AG Connect board and the AG resource board is restored. ati2mvip then exits to the operating system.






6.3.2	 Automatic Call Delivery Demo (dial2asi)





This program demonstrates automatic call delivery. In addition to the AG Connect board, the program requires an AG resource board and ME/2/X.



This program involves the following files:



OS/2 





 File



 Description




 \nms\agcx\demos\me\dial2asi\agxclock.swi



 SW Utility script to configure the AG Connect board to provide the clock signal over the MVIP bus




 \nms\agcx\demos\me\dial2asi\dial2agx.swi



 SW Utility script configuring the switching




 \nms\agcx\demos\me\dial2asi\read.me



 Readme file for the AG Connect demo




 \vbx\swpdemos\dial2asi\read.me



 The readme file for the original demo




 \vbx\swpdemos\dial2asi\dial2asi



 Executable demo program
















UNIX 





 File



 Description




 /opt/nms/agcx/demos/me/dial2asi/agxclock.swi



 SW Utility script to configure the AG Connect board to provide the clock signal over the MVIP bus




 /opt/nms/agcx/demos/me/dial2asi/dial2agx.swi



 SW Utility script configuring the switching




 /opt/nms/agcx/demos/me/dial2asi/read.me



 Readme file for the AG Connect demo




 /opt/nms/swp/demos/dial2asi/read.me



 The readme file for the original demo




 /opt/nms/swp/demos/dial2asi/dial2asi



 Executable demo program




























To run the dial2asi program with your AG Connect board, follow this procedure:


    


  1. Configure the MVIP bus clock by running the agxclock SW Utility script. To do so, enter the following:
    

       sw agxclock.swi

    

  2. Using a text editor, open the ag.cfg file for agmon. 
    

    

  3. In the "Board x" sections for your AG Connect With Ringing board and the resource board you are using, set EnableMVIP to YES:
    

       EnableMVIP = YES

    

  4. In the "Board x" section for the resource board you are using, add lines like the following: 
    

       ClockRef = MVIP
       MvipSlot = 6:0..7
       MvipSlot = 7:0..7    

    
Note: the values listed above are for an AG-8 board. If you are using another resource board type, the values you list will be different. For details, see the documentation that came with your resource board.
    

  5. Exit the text editor, saving your changes.
    

    

  6. To configure the switching, run the following SW Utility script:
    

       sw dial2agx.swi

    

  7. Begin execution of the dial2asi program, by entering:
    

       dial2asi called_number line_number

    
...where called_number is the number to dial, and line_number is the line to use.
    
The dial2asi program first obtains an analog loop start line. Then the program dials the number entered. The dialed extension should ring. 
    

  8. Pick up the extension and start talking. 
    

    
If a voice is detected, a connection will be made between the AG Connect board and the AG resource board.
    
The program waits for one of the extensions to hang up by monitoring for loop current interruption. 
    
Note:  Not all PBXs or central office switches provide loop current interruption. You may need to simulate loop current interruption by briefly unplugging the line.


  9. Hang up either party.
    

    
When either party has hung up, dial2asi restores the original connection between the AG Connect board and the AG resource board, and disconnects the operator by sending a digital silence pattern.
    

  10. At this point, you can make another call if you wish.
    







6.3.3	 Inbound Call-Control Demo (inadi)





This program demonstrates some inbound call-control functionality:




In addition to an AG Connect board, this program requires an AG resource board and AG Access.



This program involves the following files:



OS/2 





 File



 Description




 \nms\agcx\demos\agaccess\inadi\agxclock.swi



 SW Utility script to configure the AG Connect board to provide the clock signal over the MVIP bus




 \nms\agcx\demos\agaccess\inadi\inadi.swi



 SW Utility script configuring the switching




 \nms\agcx\demos\agaccess\inadi\read.me



 Readme file for the AG Connect demo




 \nms\agaccess\demos\inadi\read.me



 The readme file for the original demo




 \nms\agaccess\demos\inadi\inadi



 Executable demo program
















 





 File



 Description




 /opt/nms/agcx/demos/agaccess/inadi/agxclock.swi



 SW Utility script to configure the AG Connect board to provide the clock signal over the MVIP bus




 /opt/nms/agcx/demos/agaccess/inadi/inadi.swi



 SW Utility script configuring the switching




 /opt/nms/agcx/demos/agaccess/inadi/read.me



 Readme file for the AG Connect demo




 /opt/nms/agaccess/demos/inadi/read.me



 The readme file for the original demo




 /opt/nms/agaccess/demos/inadi/inadi



 Executable demo program












UNIX



Windows NT 





 File



 Description




 \nms\agcx\demos\agaccess\inadi\agxclock.swi



 SW Utility script to configure the AG Connect board to provide the clock signal over the MVIP bus




 \nms\agcx\demos\agaccess\inadi\inadi.swi



 SW Utility script configuring the switching




 \nms\agcx\demos\agaccess\inadi\read.me



 Readme file for the AG Connect demo




 \nms\agaccess\demos\inadi\read.me



 The readme file for the original demo




 \nms\agaccess\demos\inadi\inadi



 Executable demo program
















To run the dial2asi program with your AG Connect board, follow this procedure:


    


  1. Configure the MVIP bus clock by running the agxclock SW Utility script. To do so, enter the following:
    

       sw agxclock.swi

    

  2. Using a text editor, open the ag.cfg file for agmon. 
    

    

  3. In the "Board x" sections for your AG Connect With Ringing board and the resource board you are using, set EnableMVIP to YES:
    

       EnableMVIP = YES

    

  4. In the "Board x" section for the resource board you are using, add lines like the following: 
    

       ClockRef = MVIP
       MvipSlot = 6:0..7
       MvipSlot = 7:0..7    

    
Note: the values listed above are for an AG-8 board. If you are using another resource board type, the values you list will be different. For details, see the documentation that came with your resource board.
    

  5. Exit the text editor, saving your changes.
    

    

  6. To configure the switching, run the following SW Utility script:
    

       sw inadi.swi

    

  7. Begin execution of the inadi program, by entering:
    

       inadi -s n:m

    
...where n is "6" for AG-24 or "18" for AG-8 or AG-T1, and m is the number of the loop start line interface minus 1.
    
A recording will prompt you through the demo.



Here is a complete list of the inadi program's command line options: 





 Option



 Description




 -b n



 Specifies the AG board number n. Default=0.




 -s n:m



 Specifies the MVIP stream and timeslot for the first channel. Default=0:0




 -p protocol



 Specifies the protocol to run. Default=lps0.



















6.3.4	 Outbound Call Control Demo (outadi)





This program demonstrates some outbound call control functionality:




In addition to an AG Connect board, this program requires an AG resource board and AG Access.



This program involves the following files:



OS/2  





 File



 Description




 \nms\agcx\demos\agaccess\outadi\agxclock.swi



 SW Utility script to configure the AG Connect board to provide the clock signal over the MVIP bus




 \nms\agcx\demos\agaccess\outadi\outadi.swi



 SW Utility script configuring the switching




 \nms\agcx\demos\agaccess\outadi\read.me



 Readme file for the AG Connect demo




 \nms\agaccess\demos\outadi\read.me



 The readme file for the original demo




 \nms\agaccess\demos\outadi\outadi



 Executable demo program
















 





 File



 Description




 /opt/nms/agcx/demos/agaccess/outadi/agxclock.swi



 SW Utility script to configure the AG Connect board to provide the clock signal over the MVIP bus




 /opt/nms/agcx/demos/agaccess/outadi/outadi.swi



 SW Utility script configuring the switching




 /opt/nms/agcx/demos/agaccess/outadi/read.me



 Readme file for the AG Connect demo




 /opt/nms/agaccess/demos/outadi/read.me



 The readme file for the original demo




 /opt/nms/agaccess/demos/outadi/outadi



 Executable demo program












UNIX



 





 File



 Description




 \nms\agcx\demos\agaccess\outadi\agxclock.swi



 SW Utility script to configure the AG Connect board to provide the clock signal over the MVIP bus




 \nms\agcx\demos\agaccess\outadi\outadi.swi



 SW Utility script configuring the switching




 \nms\agcx\demos\agaccess\outadi\read.me



 Readme file for the AG Connect demo




 \nms\agaccess\demos\outadi\read.me



 The readme file for the original demo




 \nms\agaccess\demos\outadi\outadi



 Executable demo program












Windows NT



To run the outadi program with your AG Connect board, follow this procedure:


    


  1. Configure the MVIP bus clock by running the agxclock SW Utility script. To do so, enter the following:
    

       sw agxclock.swi

    

  2. Using a text editor, open the ag.cfg file for agmon. 
    

    

  3. In the "Board x" sections for your AG Connect With Ringing board and the resource board you are using, set EnableMVIP to YES:
    

       EnableMVIP = YES

    

  4. In the "Board x" section for the resource board you are using, add lines like the following: 
    

       ClockRef = MVIP
       MvipSlot = 6:0..7
       MvipSlot = 7:0..7    

    
Note: the values listed above are for an AG-8 board. If you are using another resource board type, the values you list will be different. For details, see the documentation that came with your resource board.
    

  5. Exit the text editor, saving your changes.
    

    

  6. To configure the switching, run the following SW Utility script:
    

       sw outadi.swi

    

  7. Begin execution of the outadi program, by entering:
    

       outadi -s n:m -d number

    
...where n is "6" for AG-24 or "18" for AG-8 or AG-T, m is the number of the loop start interface minus 1, and number is the number to dial.
    
A recording will prompt you through the demo.



Here is a complete list of the outadi program's command line options: 





 Option



 Description




 -b n



 Specifies the AG board number n. Default=0.




 -s n:m



 Specifies the MVIP stream and timeslot for the first channel. Default = 0:0.




 -p protocol



 Specifies the protocol to run. Default = lps0.




 -d number



 Specifies the number to dial. Default = 123.




 -r tries



 Specifies the maximum dial number of dial attempts or retries on failure.




 -l



 Print low-level call control events.



















6.3.5	 Operator Workstation Demo





This program demonstrates the operation of operator workstation line interfaces.



In addition to an AG Connect board, this program requires an AG resource board and AG Access.



This program involves the following files:



OS/2 





 File



 Description




 \nms\agcx\demos\agaccess\outadi\agxclock.swi



 SW Utility script to configure the AG Connect board to provide the clock signal over the MVIP bus




 \nms\agcx\demos\agaccess\outadi\outadi.swi



 SW Utility script configuring the switching




 \nms\agcx\demos\agaccess\aditest\read.me



 Readme file for the AG Connect demo




 \nms\agaccess\demos\aditest\read.me



 The readme file for the original demo




 \nms\agaccess\demos\aditest\aditest



 Executable demo program
















 





 File



 Description




 /opt/nms/agcx/demos/agaccess/outadi/agxclock.swi



 SW Utility script to configure the AG Connect board to provide the clock signal over the MVIP bus




 /opt/nms/agcx/demos/agaccess/outadi/outadi.swi



 SW Utility script configuring the switching




 /opt/nms/agcx/demos/agaccess/aditest/read.me



 Readme file for the AG Connect demo




 /opt/nms/agaccess/demos/aditest/read.me



 The readme file for the original demo




 /opt/nms/agaccess/demos/aditest/aditest



 Executable demo program












UNIX



 





 File



 Description




 \nms\agcx\demos\agaccess\outadi\agxclock.swi



 SW Utility script to configure the AG Connect board to provide the clock signal over the MVIP bus




 \nms\agcx\demos\agaccess\outadi\outadi.swi



 SW Utility script configuring the switching




 \nms\agcx\demos\agaccess\aditest\read.me



 Readme file for the AG Connect demo




 \nms\agaccess\demos\aditest\read.me



 The readme file for the original demo




 \nms\agaccess\demos\aditest\aditest



 Executable demo program












Windows NT



To run the outadi program with your AG Connect board, follow this procedure:


    


  1. Configure the MVIP bus clock by running the agxclock SW Utility script. To do so, enter the following:
    

       sw agxclock.swi

    

  2. Using a text editor, open the ag.cfg file for agmon. 
    

    

  3. In the "Board x" sections for your AG Connect With Ringing board and the resource board you are using, set EnableMVIP to YES:
    

       EnableMVIP = YES

    

  4. In the "Board x" section for the resource board you are using, add lines like the following: 
    

       ClockRef = MVIP
       MvipSlot = 6:0..7
       MvipSlot = 7:0..7    

    
Note: the values listed above are for an AG-8 board. If you are using another resource board type, the values you list will be different. For details, see the documentation that came with your resource board.
    

  5. Exit the text editor, saving your changes.
    

    

  6. To configure the switching, run the following SW Utility script:
    

       sw outadi.swi

    

  7. Begin execution of the aditest program, by entering:
    

       aditest -s n:m -d number

    
...where n is "6" for AG-24 or "18" for AG-8 or AG-T1, m is the number of the OWS line interface minus 1, and number is the number to dial.
    

  8. Enter the following command:
    

       op

    
aditest responds as follows:
       ok
        Event: ADIEVN_OPENPORT_DONE, Finished    

    

  9. Enter this command:
    

       sp

    
aditest responds as follows:
       Enter protocol name [`nocc'] :

    

  10. Press Enter to select "nocc".  
    

    
aditest responds as follows:
       ok
        Event: ADIEVN_STARTPROTOCOL_DONE    

    

  11. Enter this command:
    

       tp

    
aditest responds as follows:
       ok

    

  12. Enter this command:
    

      eb

    
aditest responds as follows:
       ok
        Event: ADIEVN_SIGNALBIT_CHANGED, A ON
        New State A=1, B=0, C=0, D=0, (A---)    




Pressing the switch hook should cause the A bit to toggle between zero and one. This is indicated by the ADIEVN_SIGNALBIT_CHANGED event message.



Here is a complete list of the aditest program's command line options: 





 Option



 Description




 ?



 Help




 -b n



 Specifies the AG board number n. Default=0.




 -s n:m



 Specifies the MVIP stream and timeslot for the first channel. Default = 0:0.




 -p protocol



 Specifies the protocol to run. Default = lps0.




 -l



 Print low-level call control events.
























 
    (Page 4 of 4 in this chapter)









Tech_Support@nmss.com



Copyright © 1996, Natural MicroSystems, Inc.   All rights
reserved.