
(Please set word_wrap on, Edit Menu)

SVSSAMP3.EXE Information Sheet 3

	This application may be used to gain an understanding of the basic interaction between a client telephony application and the voice server software.  It is an example of how to write a simple multiline, synchronous, client application using a For-Next loop embedded within a Do-Loop.  You may of course create your own mechanism for handling multiple lines with multiple steps.

	The user is assumed to have an understanding of Visual Basic procedural code as well as the Dialogic voice functions.  This program incorporates the (ez_) ease of use voice functions.
The application will not run from Visual Basic.  You must run it from the executes folder.

I. Operation of the application from the "executes" folder

	1)  Start the svssamp3.exe program from the "executes" folder
	2)  Make certain of the correct file paths for:
		- startcfg.exe, The Dialogic Configuration Manager
		- svserver.exe, The Synchronized Voice Server
		- play1, play2, record1 (.vox) voice files
		- Select Capture Text To File to capture the DDE linkage to svssamp3.txt.
	3)  Shell launch the Dialogic Configuration Manager and start the boards.
	4)  Shell launch the Synchronized Voice Server.
	5)  Select options to play, record, or get digits
	6)  Run the application.
	7)  Dial in to one or both of the numbers for Line1 and\or Line2
	8)  Shut down the operation

II. Points of Interest

	1)  For Synchronous operations there must be a one-to-one correspondence between the number of client application text controls used for DDE linkage and the server application lines and threads.  That is to say one text control per line in the client application and one thread per line in the server application.  The number of lines in the server application is controled by the term MaxLines nn which you set in the command line of the shell launch procedure for the SVServer app. The number of threads is controlled by the term "MultiThread". (-See Module1.bas ShellSVServer())

	2)  If you should hang the SVServer by terminating the application without using the normal shutdown procedure you can use the "ALT" "CTRL", "DEL" keys to "End The Task".  If you reach the end of the function limit (48 function executions) you may encounter this problem.  CAUTION - Make sure all lines are on-hook and closed before you "Stop" the boards.

III. Procedures of interest. 

	Please note those procedures with direct application to understanding the client-server operation.  Each procedure has it's own documentation with the code.

	1)  Module1.bas
		- Public Function ShellSVServer(AppFilePath As String) As Integer
	2)  Form1.frm
		- Private Sub Command1_Click(Index As Integer)
		- Private Sub Text2_Change(Index)
		- Private Sub Text2_LinkNotify(Index)
		- Public Sub OpenInitialize()
		- Public Sub CommandProcess()
		- Public Sub CloseTerminate()
		- Public Sub SendCommand(TheLine As Integer)
		- Public Sub TestCompletion(Index As Integer)
		- Public Function CheckReturn(TheLine As Integer) As Long
		- Public Sub UpdateLinkStatus(TheControl As Control)
