/////////////////////////////
//      /      //    //    //  	 Investment Intelligence Systems Corp.
////  /////  ///  ////  /////
////  /////  ////   //  /////  	 http://www.wingz.com
////  /////  //////  /  /////
//      /      /    ///    //
/////////////////////////////

TelTool Application
-------------------

The TelTool demonstration application allows users to chat, send HyperScript 
and transfer scripts between Wingz/WingzPro users. Because the application
uses socket communication your system administrator must create a new service
'wgztalk' for the system to function correctly. The service can use any
unused socket. The example below shows an entry in the services file
that uses 5001 as the 'wgztalk' socket.

wgztalk		5001/tcp				# wingz comms port

Each user of the application requires this modification to the services
file. However, the environment variable, WGZTALK, can be set to the
appropriate port should the user not wish to edit the services file.

The application works using the client-server model, with one user acting as
the server and all other users acting as clients. Any user can act as the
server, but only a single server can be run at any time.

Application Startup
-------------------
To start the application, run the 'telstart.scz' script in this directory.
When this script is run you can choose either a server connection (Console)
or a client connection (User). 

Console Connection
------------------
If you select a Console Connection, you have selected to act as the as the 
server process. Your connection has to be valid if all other users are to 
use the application correctly. 

User Connection
---------------
If you select the User option, you are required to enter two items of
information. You are prompted to enter a user name, as well as the name
of the machine that will act as the server. You cannot connect unless
you provide a valid server machine that is already running the TelTool
server application.

Application Options
-------------------
The TelTool dialog box provides a number of facilities that allow multiple
users the ability to 'Chat' and Send commands and complete scripts from 
any user to any or all other users on the system.

The application dialog box consists of a 'SEND' field to type messages and
remote commands, a 'RECEIVE' field that displays messages from other users,
and a number of controls that enable other features of the application.
There is a list box that displays all other users who are currently
connected, including the console, and a selection that allows you to
choose 'All' users.  This list box is used to select which users are to
receive your messages and commands. If you select the 'All' option, every
connected user will receive your messages. The system does not allow you
to select yourself. 

In addition to the list box, at the bottom left of the dialog box is the
selector for CHAT mode or COMMAND mode. In chat mode, messages are displayed
to each user in his/her RECEIVE field. In COMMAND mode, any commands that
you type in are executed on the users' local copy of Wingz or WingzPro.
All commands are valid, so caution must be exercised as you can quit remote
copies of Wingz by sending a QUIT NOW. Note that the Console cannot be
terminated if you send this command.

You can also select the 'SEND FILE' push button to send an open script to
one or all of the currently logged on users.  Selection of the button
prompts the user with another dialog box from which to select the file to
transfer. You also have the option of 'executing' the script once it has
been transferred to each user.

Finally, there is the status indicator. For a user, this should normally
show a green light that indicates that the server is available. If this
light is shown as red, the remote server is down. Restart the server and
select the 'RE-CONNECT' menuitem. 

You can choose to accept or not accept remote commands from other users by
selecting the appropriate menu item, as well as Connecting and Disconnecting
at any time.

For further information about the TelTool application,  please view the
IISC web site available at http://www.wingz.com.

