(Page 1 of 1 in this chapter) Version
Chapter 9
Demonstration Program
- 9.1 Introduction
- 9.2 Setting up DPNSSCC.EXE
- 9.2.1 Configuring the Hardware
- 9.3 Using DPNSSCC
- 9.3.1 Starting the Program
- 9.3.2 Using the Main Window
- 9.3.3 Configuring Incoming Call Management
- 9.3.4 Establishing an Incoming Call
- 9.3.5 Configuring Outgoing Call Management
- 9.3.6 Establishing an Outgoing Call
- 9.3.7 Sending and Receiving Supplementary Feature Messages
9.1 Introduction
- This chapter presents the dpnsscc.exe sample program shipped with the DPNSS service. dpnsscc presents an easy-to-use graphical user interface allowing you to create CT Access contexts, and receive incoming calls and place outgoing calls using the DPNSS service.
- dpnsscc is delivered with its entire source, resource, and project files, compatible with Microsoft Visual C++ 5.0. It can be used as sample source code to base your application upon. It can also be used as a test program for the CT Access DPNSS service.
- dpnsscc actually invokes the following functions:
- dpnAcceptCall, dpnAnswerCall, dpnPlaceCall, dpnRejectCall,
dpnReleaseBuffer, dpnReleaseCall, dpnStartProtocol,
dpnStopProtocol.
- The routines invoking these functions are located in a unique source code file named CallControl.cpp. The other files are not involved in call control. The DPNSS service programmer looking for CT Access and DPNSS service implementation examples should focus on CallControl.cpp.
9.2 Setting up DPNSSCC.EXE
- Before you start the demonstration programs, ensure that:
- The DPNSS service is properly installed.
- Your BX 3000 hardware is configured properly, as described in Section
9.2.1.
- Refer to the appropriate installation manual for your operating system for details on installation.
9.2.1 Configuring the Hardware
- In order for dpnsscc to work, the system has to be equipped with at least one
BX 3000 board connected to another DPNSS node. Any of the following configurations will work:
Figure 27. DPNSSCC Single-System Configuration (Two One-Port Boards)
- A system containing a single BX 3000-2E board, with its two DPNSS trunk
connectors linked together with a cable (shown in Figure 28):
Figure 28. DPNSSCC Single-System Configuration (One Two-Port Board)
- Two systems, each containing a single BX 3000-2E board, linked together
with a cable (shown in Figure 29):
Figure 29. DPNSSCC Dual-System Configuration
- A system containing a single BX 3000-1E or BX 3000-2E board, connected
to a DPNSS PBX or network (shown in Figure 30):
Figure 30. DPNSSCC PBX/Network Configuration
9.3 Using DPNSSCC
- The following sections describe how to start the sample program, how to use the main window, and how to perform simple call control.
9.3.1 Starting the Program
- To start dpnsscc, click Start. Select Natural MicroSystems DPNSS Service, and then choose Call Control Sample Program.
- When you start dpnsscc, the main window appears (shown in Figure 31).
- If the service starts properly, ctaInitialize is performed and a CT Access queue is created (ctaCreateQueue is called).
- If there is a problem (e.g., the DPNSS Windows NT Service is not started) an error dialog box appears, and the Initialize DPN button is enabled in the main window. Check your installation, or check the Windows NT event logger to understand why the DPNSS server did not start. When you have remedied the problem, restart your computer.
9.3.2 Using the Main Window
- When you start dpnsscc, the following window appears:
Figure 31. DPNSSCC Main Window
- This window contains 3 main areas dedicated to:
- Outgoing call management
- CT Access event and DPNSS SIS tracing.
- Each button in the window performs a call to a DPNSS call control function. Also, the application traces the event received through the CT Access function ctaWaitEvent, and the DPNSS Supplementary Information Strings received with the event (if any). This information appears in the event history area of the window.
9.3.3 Configuring Incoming Call Management
- To configure incoming call control, use the "Incoming Call" section of the main window (shown in Figure 32):
Figure 32. Incoming Call Management Section of Main Window
- To configure incoming call control:
- Enter a Board number (default = 0).
- Enter a Trunk number (default = 0).
- Enter a Timeslot (default = 0).
The default values (board 0, trunk 0 and timeslot 0) allow the application to handle an incoming call on the first real channel.
- Press the Open Context button.
The program opens a context, making calls to ctaOpenServices and dpnStartProtocol. Each of these functions are acknowledged by events that are traced in the event history area of the main window. If the context is opened properly, the event history area should look like Figure 33:
Figure 33. Event History Area after Incoming Call Control Setup
9.3.4 Establishing an Incoming Call
- Once the context has been initialized, the DPNSS service waits for an incoming call.
- When an incoming call is received, a DPNEVN_INCOMING_CALL event appears in the event history area. The Accept Call, Reject Call, and Answer Call buttons become available, as shown in Figure 34:
Figure 34. Call Control Buttons
- You can now answer or reject the call, or accept the call and then answer or reject it:
- To reject the call, press Reject Call. DPNEVN_CALL_DISCONNECTED
appears in the event history area.
- To accept the call, press Accept Call. A DPNEVN_ACCEPTING_CALL
event appears in the event history area. You may now answer the call or
reject the call.
- Before answering, rejecting, or accepting a call, you can set up one or several supplementary feature SIS identifiers to be sent with the function call. For details, see Section 9.3.7.
- When the call is connected, both parties can release the call. To perform the release, press the Release Call button. DPNEVN_CALL_DISCONNECTED appears in the event history area.
- Once a call is released, a new incoming call can be received.
9.3.5 Configuring Outgoing Call Management
- To configure outgoing call control, use the "Outgoing Call" section of the main window (shown in Figure 35):
Figure 35. Outgoing Call Management Section of Main Window
- To configure outgoing call control:
- Enter a Board number (default = 1).
- Enter a Stream number (default = 4 = second trunk on a BX 3000-2E).
- Enter a Timeslot (default = 0).
The default values (board 0, stream 4 and timeslot 0) cause the application to place a call on the second trunk on the first board installed in your system.
- Press the Open Context button.
The program opens a context, making calls to ctaOpenServices and dpnStartProtocol. Each of these functions are acknowledged by events that are traced in the event history area of the main window. If the context is opened properly, the event history area should look like Figure 33:
Figure 36. Event History Area after Outgoing Call Control Setup
9.3.6 Establishing an Outgoing Call
- Once the context has been initialized, the outgoing call can be placed. To place a call:
- Enter a valid extension number in the Dest. Address field.
- Press the Place Call button.
- Before placing a call, you can set up one or several supplementary feature SIS identifiers to be sent with the function call. For details, see Section 9.3.7.
- After the call is placed, the application should receive a DPNEVN_PLACING_CALL event. The application may then receive any of the following events (see Figure 37):
- DPNEVN_CALL_CONNECTED: The remote party answered the call.
- DPNEVN_DISCONNECTED: The remote party rejected the call or the
specified extension was not reached.
Figure 37. Event History Area after Outgoing Call Establishment
- When the call is connected, both parties can release the call. To perform the release, press the Release Call button. DPNEVN_CALL_DISCONNECTED appears in the event history area.
- Once a call is released, a new outgoing call can be established.
9.3.7 Sending and Receiving Supplementary Feature Messages
- Using dpnsscc, you can set up supplementary feature messages to be sent when you perform call control operations.
- To set up and send supplementary feature messages:
- Click Use SIS Dialog Box, so it is checked.
To send a supplementary feature message while accepting, rejecting, or answering an incoming call, check Use SIS Dialog Box under "Incoming Calls". To send the message while placing a call, check Use SIS Dialog Box under "Outgoing Calls".
- Press Accept Call, Reject Call, Answer Call, or Place Call.
To send a supplementary feature message without performing a call control operation, press Send Feature Message.
If Use SIS Dialog Box is checked, the following dialog box appears:
Figure 38. The SIS Messages Dialog Box
- Choose the SIS identifiers you wish to send, in the order in which you wish to send them.
To choose a SIS identifier:
- In the Category field, click on a supplementary feature type.
SIS identifiers associated with the supplementary feature type you choose appear in the Available SISs field.
- In the Available SISs field, choose the identifier you wish to send.
- Press the --> button.
The SIS identifier selected is listed in the Selected SISs field.
- To perform the call control action and send the SIS identifiers, press the button to the left of the Cancel button at the bottom of the dialog box. This button corresponds to the button you pressed in the main window.
(Page 1 of 1 in this chapter) Version
tech_support@nmss.com
Copyright © 1999, Natural MicroSystems, Inc. All rights
reserved.