TrueGUI Host Server
Telnet Passthru
In the Telnet Passthru section:
| • | A local port number for your current Telnet sessions to use in place of the above Host Server IP and port. This way, your revised Telnet sessions will connect to TrueGUI on your PC, and then open a connection to your regular server. Enter that item into the "Telnet Passthru" section at the bottom. |
TrueGUI passes the Telnet communication thru TrueGUI to and from the server and client.
Enabling TrueGUI mode sequence
While passing the information back and forth, TrueGUI will be looking for a specific byte sequence sent by the Host Server. This sequence will typically be sent by the application when it wants to switch to TrueGUI mode to start using Windows Forms. This is also the sequence that an application may use to test if TrueGUI is available in this session. Any sequence is acceptable, but a little care here would be wise.
Considerations when choosing the "Enable TrueGUI" sequence:
| • | It will normally appear on the user's Telnet screen. |
| • | It should be as unique as practical, something that would not otherwise be sent to the Telnet screen. |
| • | It may also be sent to Telnet screens that are not TrueGUI capable |
| • | Control Characters are not supported in this release, please use a standard printable ASCII sequence, the sample default is: EnterTrueGuiMode |
| • | To Exit TrueGui mode the default ASCII sequence is: LeaveTrueGuiMode |
| • | The GetCurrentMode command sent by the host to the client and the client will respond with 0=Telnet mode, 1=TrueGUI mode. |
| • | The TrueGui Client must have these installed for the application and the client to control the telnet session. |
TrueGUI Screen Details
| • | [Test Connection]: Verifies servers are running with a PING to the IP's defined in the address windows. |
| • | [Connect] or [Trying] or [Disconnect]: Establish connection to the server or disconnect from the server. The Connect button will be green when the connection is not established. When a connection is establish the button will display Disconnect. |
The White data boxes in this program are a fixed length. To see all of the contents, mouse click in the box and use the Right Arrow key to scroll to the right. Use the Left Arrow key to scroll to the left.
Settings groupbox
| • | [Lock]: Lock/Unlock configuration screen |
| • | [Hide]: Minimize to taskbar |
| • | [Load]: Load either the default Settings.set file or select another named *.set file to load using the [...] search box. |
| • | [Save]: Save all tab settings to Settings.set file so the next time the program is executed it will use the Settings.set parameters previously saved. If you do not save the settings they must be manually entered each time you run the program. |
| • | File this input box displays the Current options and settings configuration for TrueGUI.exe. The Down Arrow will pull up the last settings files that have been saved by TrueGUI.exe. |
| • | If you corrupt your Settings.Set file, erase this file in the TrueGUI folder and copy the backup copy from \TrueGUI\Samples folder into the TrueGUI folder. Then reinitialize the TrueGUI program and correct the configuation settings and [Save] your new configuration. |
| • | Settings File. If you change the name of the Settings.set file the Re-Load button changes to LOAD and pressing it will load TrueGUI with new settings. Pressing the [Save] button will save the new settings loaded into the Settings.set file. |
Host tab
Host Server groupbox
| • | Address: the Host IP address of the application server |
| • | Port number the telnet port number of the server. |
| • | User ID: Telnet TrueGUI Client login ID. |
| • | Password: Telnet TrueGUI Client login Password. |
| • | Startup Cmd: This is the login or startup command on the server to start the first application when you select Auto Start TrueGUI mode. This can be a DO file or even an application program. |
| • | Timing: time delay in (milliseconds) between connection and execution of the CMD file on the server. |
|
|
Host Server IP and port: This is the address and port that your current Telnet sessions use. With this information, TrueGUI can connect to your Telnet server just as your current Telnet does. Enter those two items in the "Host Server" section at the top. |
Passthru tab
Telnet Passthru groupbox
| • | Select Telnet : Telnet client software can be AlphaLan, ZTerm, Windows Telnet or others. |
| • | Telnet Parameters: line argument or settings saved from the telnet client program. Consult your Telnet client documentation to see if there is a way to launch a specified host connection. Here are a few example: AlphaLan: Startup AlphaLan as per normal then change the host server to 127.0.0.1 and the port to 8000. Set the autoconnect at startup and then save the configuration as loopback.aln. In TrueGUI.exe your Telnet parameter would now be Loopback.aln. When you click Test Telnet it should launch this loop back connection that you create and saved. ZTerm: ZTerm stores the connection information in the users registry. First you need to create that profile. Start up ZTerm and create a new profile Call the Profile Loopback. The server address is 127.0.0.1 and the port is 8000. Assign your normal Terminal Driver and save the connection. In TrueGUI.exe your Telnet parameter would now be Loopback. When you click Test Telnet it should launch this loop back connection that you create and saved. Windows Telnet: Enter the Telnet parameter of 127.0.0.1 8000. |
| • | GUI Mode On Text: This text string is EnterTrueGuiMode will envoke TrueGUI mode. |
| • | GUI Mode Off Text: This text string is LeaveTrueGuiMode will envoke Telnet mode. |
| • | Get Current GUI Mode: This text string sent by the host GetCurrentMode, the client will send back to the host which mode the telnet client is in. Returns a "0" for telnet mode, returns a "1" for TrueGUI mode. |
| • | Port: the port number for the loop back address 127.0.0.1: 8000 in this example |
| • | Timing: Only to be modified if your having trouble recognizing the Mode commands. Set to 2000 only if requested. |
[Test Telnet]: verifies the telnet client parameters are working. It does not complete the passthru to the server.
Developer tab
Developer Tools groupbox
| • | Forms Directory should be the developers release directory for new forms. This is the override initial Form location. This example is C:\Program Files\Alpha Microsystems\TrueGUI\Forms. |
| • | Scripts Directory should be the developers release directory for new scripts. This is the override initial Script location. This example is C:\Program Files\Alpha Microsystems\TrueGUI\Scripts. |
| • | [Show Debug] This button will bring up the Debug Window. |
About tab
This box shows the latest versions of the DLL's and the programs being used by TrueGUI.exe.
The Build Version should change each time you install TrueGUI with the newest version from TrueGUI.com web site.
Shortcut Properties
The user can create a short cut on the desktop and in the target line at the end add in the setting filename to initialize the TrueGUI.exe program. If there is no initialization command the program uses "Settings.set" to initialize TrueGui.exe.
Here is a sample target line for the short cut.
"C:\Program Files\Alpha Microsystems\TrueGUI\TrueGUI.exe" -ipassthru.cfg
The -i switch followed by the "amtg.set" filename is how you can have different configuration in which to initialize the TrueGui program.
To [Save] a different filename, press the down arrow in the filename box of the Settings groupbox. When the filename is highlighted in blue use the mouse to cursor over the current filename and type over it with a new name and make sure you end the filename with ".cfg" then press the [Save] button.