< Universal Terminal Server (UTS) Telnet Server / < Utility Pack

Powerful Utility Pack

GSW Telnet Server for Windows provides POWERFUL  utilities that get things done and make your life easier!


Power Features for the Power User!
UTS/SSH2/FIPS
Change Password Many times a user wishes to change their password. A convenient method is to use the Georgia SoftWorks Change Password command line utility.
  • Command: gs_chpwd
  • Syntax gs_chpwd <\\computer | domain>
Connection Banner A custom banner can be displayed to the client upon connection to the host!. The connection banner is useful for displaying security and legal notices as well as other information that the user should see BEFORE logging on to the host. To enable a connection banner perform the following steps:
  • 1. Create the text of the Banner in an ASCII text file.
  • 2. Save the file and name it banner.txt
  • 3. Place the file in the directory
Execute command on client from within SSH/Telnet An incredibly powerful tool that facilitates client side processing of server side files when using the Georgia SoftWorks Telnet/SSH2 clients. If it is a GUI application then the application will display on the client desktop
  • When coupled with the UTS file Transfer utilities the possibilities are endless!

  • Command: gs_exec

  • Execute an Application on the client desktop
  • Syntax: gs_exec
  • Any valid command that can be run on the client can be specified as an argument to the gs_exec utility.
File transfer - transfer files between the client and the server via telnet/ssh Efficient file transfer capabilities are available when using the GSW UTS (Telnet/SSH Server for Windows) Server and Client. File transfer via Telnet/SSH is convenient as there is no need for a FTP Server to be installed and you are not limited by the file sizes as with many email attachments. If the session is encrypted then the file transfer is also encrypted!
  • Command: gs_put
  • Transfer the file from the server to the client
  • Syntax: gs_put
  • Command: gs_put
  • Transfer the file from the client to the server
  • Syntax: gs_get
  • Note: You must use the GSW Telnet/SSH client with gs_put or gs_get.
Launch a GUI application on the Server Launch a Graphical Interface (GUI) application on the server desktop from a Telnet/SSH session by using the utilities gs_gui and gs_engui. The application will display on the server desktop.
  • Command: gs_gui
  • Launch GUI application on the Windows Server desktop
  • Syntax: gs_gui
  • Setup: gs_engui
  • Run gs_engui (enable gui) on the desktop. Use the run command or the start button or open a command shell. This must be done on the server by the current interactive user.
  • Note: The launched GUI applications do NOT disply on the Telnet/SSH Session.
Remote Reboot of server The system administrator may need to reboot a Windows server. The Georgia SoftWorks Telnet/SSH server provides a command line utility that reboots the Windows Server.
  • Command: gs_rbt
  • Reboots the Windows System (Server, XP, Vista, etc)
  • Syntax: gs_rbt [computer_name]
  • Note: If the computer name is omitted the computer where the command is executed reboots.
  • Note: All sessions will be disconnected. The reboot will occur about 40 seconds afte the command is issued.
  • Note: Administrator privileges are requried to run this command
Remote shutdown of the server The system administrator may need to shut down a Windows server remotely. The Georgia SoftWorks Telnet/SSH server provides a command line utility that will shutdown the Windows Server.
  • Command: gs_shutd
  • Shutdown the Windows System (Server, XP, Vista, etc)
  • Syntax: gs_shutd [computer_name]
  • Note: If the computer name is omitted the computer where the command is executed is shut down.
  • Note: All sessions will be disconnected. The reboot will occur about 40 seconds afte the command is issued.
  • Note: Administrator privileges are requried to run this command
Remote Registration In some instances you may need to apply the serial number from a remote location. The Georgia SoftWorks Remote Registration Utility provides this capability. The can be done when upgrading to a new version of permanently activating a trial version of the software.
  • Command: gs_rr
  • Apply a serial number to a GSW UTS (Telnet/SSH) Server
  • Syntax: gs_rr < serial_number>
  • serial_number is the serial number obtained from Georgia SoftWorks
  • Note: You must have Telnet/SSH connectivity to run this command
Special Bell Processing The Georgia SoftWorks Telnet/SSH Server for Windows can intercept a special character written to the application's screen and send a bell character to the terminal(in the place of the intercepted character). The special character and the location are defined using Registry Values.
  • BellX: Column of the bell character, initialized to 0xffffffff, which makes it inactive
  • BellY: Row of the bell character, initialized to 0xffffffff, which makes it inactive
  • BellChar: Value of the bell character, initialized to 0x87
  • Note: The special character will be automatically replaced with a space character on the screen
Special Bell Processing for SAPConsole The Georgia SoftWorks Telnet/SSH Server for Windows provides special bell processing for SAPConsole users. For expected Bell Operation after Session Saver Reconnects, SAPConsole must be launched via the Gswbell utility. Use the appropriate command for your UTS edition (32-bit or 64-bit)
  • Command: gswbell for x86 (32-bit) UTS edition
  • Command: gswbell_x64 for x64 (64-bit) UTS edition

  • GSWBell is a command line program that is entered in your GSW UTS logon scripts. Please review Logon Scripting. A command line argument is used to specify SAPConsole. Gswbell will launch SAPConsole.

  • Syntax: gswbell sapconsole_exe_path [SAPConsole arguments]
  • Arguments: Optional arguments
  • Any SAPConsole arguments are simply added to the command line in the format required by the SAPConsole
  • Note: Administrative privileges are required to run this command
  • Example -
  • Launch SAPConsole with the GSWBell utility

  • C:\gs_uts\gswbell.exe c:\sap\sapcnsl.exe
Client Scroll Bars You may enable scroll bars on the Windows client window. This is accomplished by changing the buffer size for the DOS window. You must be careful that the application can handle a modified buffer size. Unpredictable display results will occur if this is not the case.For WIndows CE .NET 4.2/5.0 devices.
Set this option to eliminate the use of scroll bars to save screen space. The application should display itself in the top-left corner of the screen. For example, this is the position that SAPConsole assumes. Of course this assumes that the application does not require scroll bars.Normally Scrollbars are enabled.
The No Scrollbars option is enabled by selecting the option No scrollbars.

Session|Settings|Session|No scrollbars

Check the “No scrollbars” box to eliminate scrollbars as shown below.
TTY Name The default port number for telnet is port 23 and NO configuration is required unless you want to change or add telnet ports.

The Georgia SoftWorks UTS creates a tty name on a per session basis. This is available for viewing or use by customer created programs.
  • Environment variable created: gwtn_tty
  • It is set to /dev/ttypmmm, where mmm  represents the socket number(handle) for the user's session
Alternative Telnet Port Number
(Telnet only)		 To use a different telnet port (other than the default) for the GSW Telnet Server you need to create an entry like:

gstnet 55555/tcp

in the Services file on the server and restart the 7/NT/XP/VISTA/2000/2003/2008 Telnet Server. Replace the 55555 with another port number if necessary. You will have to explicitly specify the alternate port number when starting the connection from 3rd party clients and the Georgia SoftWorks Telnet Client.
On Windows the services file is located in the directory:

gstnet 55555/tcp

The file is named Services

Configure Multiple Telnet Ports
(Telnet only)		 The capability exists to configure up to 100 ports for the Georgia SoftWorks Telnet Server to listen on. Use the etc/services file to configure port names gstnet1 through gstnet100.
Edit the file Services file as described above. Add the following entries. Notice that you may use any of the one hundred port names and that they do not have to be in order.
gstnet1 23/tcp
gstnet2 14002/tcp
gstnet5 14005/tcp
gstnet6 14006/tcp
gstnet10 14010/tcp
Telnet will now listen on the above five ports.
To further take advantage of this feature you can use the environment variable:

gwtn_server_port

to access the port number associated with your current session. To view the port number associated with your session at the command prompt enter:

echo %gwtn_server_port%

If you have multiple telnet ports configured you may want ot have a different task process the informaiton that comes in on each port.
Here is an example of a logon_script whcih uses the port information to branch to different tasks based ont he port number.

  • @if %gwtn_server_port%==23 goto label23
  • @if %gwtn_server_port%==14002 goto label14002
  • @if %gwtn_server_port%==14005 goto label14005
  • @if %gwtn_server_port%==14006 goto label14006
  • @echo port not found
  • @pause
  • @goto labele

  • @:label23
  • @echo About to run app23
  • @pause
  • @rem Put your code to run23 app here
  • @goto labelend

  • @:label4002
  • @echo About to run app14002
  • @pause
  • @rem Put your code to run14002 app here
  • @goto labelend

  • @:label4005
  • @echo About to run app14005
  • @pause
  • @rem Put your code to run14005 app here
  • @goto labelend

  • @:label4006
  • @echo About to run app14006
  • @pause
  • @rem Put your code to run14006 app here
  • @goto labelend

  • @:label4010
  • @echo About to run app14010
  • @pause
  • @rem Put your code to run14010 app here
  • @goto labelend
Setting a Default Domain In some instances the system administrator may want to eliminate the prompting for a domain when the user is connecting to the SSH/Telnet server. This can be accomplished by setting the default domain registry variable. This works for 3rd party clients only.

The key is:

HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\GS_Tnet\Parameters\Domain

Enter the new value for the Domain and click OK
The new Domain will take effect for all new sessions. The registry value is initialized to "UNKNOWN" which disables a default domain. The empty string means the default domain. This is equivalent to pressing when prompted. This will eliminate prompting for users of all clients.
Default Domain Override The user may override the default domain when using a 3rd party client when connecting via Telnet or SSH. When a default domain is set the GSW UTS does not prompt for the domain and automatically applies the domain set in the registry.
If the user needs to override the default domain, then the optional syntax described below can be used when logging on to the UTS to select a different domain.
The domain can be specified (along with the username) when the user is prompted for the Windows User Name. The domain override syntax is different depending if you are connecting via Telnet or SSH.
TELNET
When connecting via Telnet the syntax is the domain name followed by the backslash followed by the username

domainname\username

SSH2
When connecting via SSH the syntax is the username followed by the "AT" sign followed by the domain name.

domainname@username




LinkedIn Facebook Twitter