
(Please set word_wrap on, Edit Menu)

SVSSAMP4.EXE Information Sheet 4

	This application may be used to gain an understanding of the basic interaction between a client telephony application and the voice server software.  

	The user is assumed to have an understanding of Visual Basic procedural code as well as the Dialogic 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 svssamp4.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
		- play and\or record (.vox) voice files
		- Select Capture Text To File to capture the DDE linkage to svssamp4.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)  Enter and enable numbers to dial
	7)  Run the application.
	8)  Dial in or enable to dial out Line1 and\or Line2
	9)  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.

	3)  This application utilizes the Diologic convenience functions rather than the ease of use (ez_) functions.  Please note the loading of the DV_TPT structures in the OpenInitialize() procedure.  Here, these structures are loaded, then saved for later retrieval when playing or recording files or gathering digits.  The CloseTerminate() procedure releases the space required for saving these structures.

	4)  The pre-process, command process, and post process procedures are under the same Select statement and within the same case for each step.  Compare to the methodology used in svssamp3.exe.

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)
