Pragma PocketVT Online Help
for Windows Mobile / Pocket PC

Welcome to Pragma PocketVT for Windows Mobile / PocketPC Help Site. Developed by Pragma Systems, PocketVT is Pragma's 2-in-1 SSH-Telnet Client which allows you to connect to remote machines running SSH-Telnet server. Pragma PocketVT for has an user-friendly, highly configurable interface that allows you to configure SSH-Telnet sessions according to your needs.

This Help File contains the following topics to help you configure Pragma PocketVT:

• Making a connection
• Color Setup
• ANSI Color Setup
• Set Font
• Set Server's Code Page
• Function Keys
• Configure Terminal Options
• Printer Setup
• Scanner Setup
• Command Bar Setup
• Hardware Button Setup
  To change the number of rows and columns of your telnet session, under the Columns / Rows edit box, enter the desired numbers.
  
  To change CR/LF, under the Send CR/LF / Receive CR/LF edit box, enter your desired value.
  
  To change the emulation type, select your desired emulation type from the Emulation drop down menu.
  
  To change scroll buffer, enter your desired value in the "lines" edit box.
• Auto Save Options
• Preferences
• Auto Login
• Launch at Startup
• Launch via hard button
• Uninstall PocketVT
• Registration

Making a connection

To make a connection to a remote machine (running either SSH or Telnet server), click on the PocketVT shortcut from the Start Menu. A Profile Configuration dialog will pop up. Enter appropriate information in their respective fields.

Profile: Enter a descriptive name for the profile.

Protocol: Select your preferred protocol from the drop down menu.

Host: Enter the name or the IP address of the server you would like to connect to.

Port: When you select your preferred protocol, port number is automatically entered. To connect to a different port, enter the port number in this field.

User Name: Enter a valid username.

Password: Enter a valid password for the username entered in the previous step.

Auth Method: Select your preferred authentication method from the drop down menu.

Cipher: Select your preferred cipher. NOTE: This feature is for SSH connections ONLY.

Key: Specify the location of the public key in your handheld device. This feature is for SSH connections with Key Authentication ONLY.

NOTE: Local user accounts must be used during Certificate/Key authentication. If using "non Pragma Systems generated" public-private key pair, then the public key stored in the authorized_keys file needs to be properly formatted. Contact Pragma Systems technical support for assistance on this issue.

Color Setup

To set or change background and text color of your telnet session, from the menu bar at the bottom of your PocketPC window, select the Options menu and then select the Color Setup option. Color Setup window will appear. Click on the Background Color button and select the desired background color. Click on the Text Color button and select the desired text color. Once you have selected your desired background and text color, click on the OK button. NOTE: For your convenience, the preview box displays the background and text color as you select them.

ANSI Color Setup

To enable ANSI Color Support, from the menu bar at the bottom of your PocketPC window, select the Options menu and then Color Setup option. Color Setup window will appear. Click on the check box labeled Enable ANSI Color Support to enable this feature. ANSI Color Support feature allows your telnet session to use (background and text) color settings set by the Server.

Set Font

To set or change the font type or size of your telnet session, from the menu bar at the bottom of your PocketPC window, select the Options menu and then select the Set Font option. From the drop down menu, select your font type. In the Size edit box, enter your desired font size and click ok.

Set Server's Code Page

To set or change the Server's Code Page setting, from the menu bar at the bottom of your PocketPC window, select the Options menu and then select the Server's Code Page option. From the drop down menu, select your code page and click ok.

NOTE: You need to put the "character-code text file" in the main directory of your PocketPC device. This directory could be either the "  \My Device " directory or the "  \My PocketPC " directory. Supported character-code text files are available for download from the Pragma Systems website at: http://www.pragmasys.com/HandHeld/charcode.html

Function Keys

To view function keys such as F1-F-12 and Shift, Control, Alt keys, select Function Keys option from the options menu.

Configure Terminal Options

Terminal options such changing window title, chnaging number of rows and columns in the window, changing emulation type, scroll buffer and Send & Receive CR/LF can be configured.

To change window title, under the Window Title edit box, enter a new window name.

Printing

For Printer Setup, click on the file menu and select Printer Setup. From the Printer Setup dialog box, click on the drop down menu and select your printer.

Scanner Setup

For more information on Scanner Setup, please contact Pragma Systems via telephone at :512-219-7270 or via email at:
support@pragmasys.com 

Command Bar Setup

To configure the comand bar buttons, select Command Bar Setup from the options menu and select your desired funtion for each of the command bar buttons from the drop down menu. This feature allows to configure each of the buttons visible on the commard bar to perform a different task. For example, you can configure the command bar button C1 to function like pressing ENTER in the INPUT PANEL (keyboard). Similarly, you can configure rest of command bar buttons to do anything from F1 Key entry to bringing up the Terminal Options dialog box.

Hardware Button Setup

To configure the four hardware buttons on your PocketPC device, select Hardware Button Setup from the options menu. In the Configure Hardware Keys dialog box, click on Enable Programming check box. Then select your desired funtion for each of the hardware buttons from the drop down menu. When Enable Programming option is checked, this feature allows to configure each of the hardware buttons to perform a different task. For example, you can configure  the right most hardware button on your PocketPC device to function like pressing ENTER in the INPUT PANEL (keyboard). Similarly, you can configure rest of hardware buttons to do anything from F1 Key entry to bringing up the Terminal Options dialog box.

All settings will save automatically when the program exits. The same settings will be loaded when the program is opened again.

Preferences

To set Preferences, from the menu bar at the bottom of your PocketPC window, click on the Options menu and then select the Preferences option. Click on the appropriate check boxes to set "Local Echo", "Line Wrap", and "Show Splash Screen at Setup". Under Locale File Locations field, enter the path for local files such as the bmp file for the splash screen.

Auto Login

To enable Auto Login, from the menu bar at the bottom of your PocketPC window, click on the Options menu and then select the Preferences option. Then, click on the check box labelled Enable Auto Login. Then select your preferred profile from the drop down menu. In the Logon Prompt field, enter the login prompt from you server. In other words, if you are prompted with "username", enter the string "username" in this field. If your server prompts you with "Login", then enter the string "Login" in this field. Similarly, enter the password of your server in the field labelled Logon Pass Prompt. Finally, click on the OK button to enable the Auto Logon feature.

Launch PocketVT at startup

To launch the PocketVT program as soon as your PocketPC handheld device boots up, a shortcut need to be created in the \Windows\Startup directory. Please follow these steps in order to do so: - Navigate to the directory \Program Files\Pragma, and select PocketVT.exe. You can use an ActiveSync connection and use explorer from the desktop to do this, or you can do it in the device itself using its file manager or explorer. - Do edit->copy - Navigate to \Windows\Startup directory, then do edit->Paste Shortcut - Rename the shortcut file, if you will, to something suitable, e.g., PocketVT.lnk. When the device is booted, this shortcut is read by the system, and the corresponding program is executed. Unfortunately, sometimes the programs speicfied by shortcuts in the \Windows\Startup directory are executed before the network drivers, specifically, the 802.11 drivers are fully loaded. So a connect attempt at this time to a remote host will fail. However, once the necessary drivers are fully loaded, a reconnect attempt will succeed. For this reason, two parameters need to be tweaked as appropriate. Some trial and error might be needed in order to get these values correct. They are MaxRetryCount and RetryDelayMS: MaxRetryCount: Maximum number of retry attempts to be made by PocketVT. The default is 0. So if the initial connection attempt fails, PocketVT will stop connect attempts. PocketVT will otherwise retry a maximum of MaxRetryCount before quitting. RetryDelayMS: The delay in between each reconnect attempt, in milliseconds. So, a five seconds delay can be specified as a value of 5000 (five thousand) for this parameter. The default is 0: no delay in between each retry. It is a good idea to specify a delay, since it lets the device complete loading the needed drivers in between retry attempts.

Launch PocketVT via hard button

To launch the PocketVT program by pressing a button on your handheld device, do the following: 1. Go to: \Program Files\Pragma and copy the exe file "PocketVT.exe" 2. then go to: \Windows\Start Menu and do a "Paste Shortcut" of the file copied in step 1. 3. Rename this shortcut file to: PocketVT.lnk 4. Then go to Settings and tap on the "Buttons" icon. 5. Select on a button you would like to "program". 6. From drop down menu labelled "Assign a program", select the "PocketVT.lnk" file and then tap on the OK button.

Uninstall PocketVT

To uninstall Pragma PocketVT, disconnect and exit the program. Then go to: Start Menu > Settings > System > Remove Programs. Select Pragma PocketVT from the list and click on the remove button. If you get an error message that says "Uninstall unsuccessful ...[filename] in use or in memory", then go to: Settings > System > Memory > Running Programs and click on the "Stop All" button. Then using the File Explorer, locate the [file] that was "in use" and rename it. Then perform a soft reset of your device. Refer your device's user manual for soft reset instructions. After performing the soft reset, go to: Start Menu > Settings > System > Remove Programs and run the uninstall program again. You should get an "uninstall complete" message. Now, using the File Explorer, locate the [file] you renamed and delete it. In some cases, you may need to manually delele the "Pragma" folder located under Program Files.

Registration

To register Pragma PocketVT, you need to obtion a registrition key from Pragma Systems, Inc. Once you have the registration key, select Enter Registration Key option from the Help menu and enter your registration key in the New Key edit box.