The information on this page applies to QWS3270 PLUS and QWS3270 Secure as well as QWS5250.
 

Table of Contents

How to order QWS3270 PLUS?

How to install QWS3270 PLUS?

Can I just delete the QWS3270 PLUS directory when I want to uninstall the trial version?

Why doesn't my window go full screen when I click the maximize button?

How do I connect to a host using QWS3270 PLUS?

What command line parameters does QWS3270 PLUS accept?

Can I automate some of the things that I use QWS3270 PLUS for? How do I use scripts?

What are the minimum requirements for running QWS3270 PLUS?

Does QWS3270 PLUS run under Windows Vista?

Can I integrate QWS3270 PLUS with my browser?

My printer attempts to print in shades of grey.  Is there a way to turn colour printing off?


How to order QWS3270 PLUS?

There are five different ways to order our software and three different ways to pay:

Ordering via the World Wide Web: Jolly Giant Software provides you with the flexibility of ordering software via our secure website. You can order either in US Dollars using your VISA or Discover credit card, or in Canadian Dollars using your VISA, MasterCard, American Express or Discover credit card. 

Ordering via email: orders can be emailed to us at sales@jollygiant.com

Ordering via fax: You can print out our fax order form, fill it out and fax it to us at (613) 544-2459

Ordering via phone: Telephone orders are accepted at (613) 541-0740 or toll free at (877) 776-4657 (US & Canada only) between 08:30 - 05:00 Eastern Time.
 
 

Accepted forms of payment are:
Credit cards: VISA, MasterCard credit cards are accepted for telephone or fax orders.

Purchase orders: (including government purchase orders) are accepted.  Standard payment terms are net 30 days. The purchase order can be faxed, mailed, emailed or phoned to our attention. See contact information for details on how to contact us.

Cheques: You can mail us a cheque along with your order (see contact information, pricing information)

Back to Top

How to install QWS3270 PLUS?

If the trial version of QWS3270 PLUS is installed, we recommend that this version be uninstalled before installing the full version.

1. Uninstalling the trial version

Press 'Start' button, 'Settings', 'Control Panel'.

In Control Panel, locate the icon for 'Add/Remove Programs', and double-click it.

In the dialog box that comes up, select the Install/Uninstall tab, then find the entry for "QWS3270 PLUS version x.x Demo" in the list box.

Click once on the entry, then click 'Add/Remove...' button.

Select "Automatic" on the Select Uninstall Method dialog, click 'Next'

Click 'Finish', and after the uninstall is complete, press 'OK' in the Add/Remove Programs dialog box.

2. Installing from a floppy diskette:
Select 'Start', 'Run'. Type "a:\QWS3270.exe" (substitute "a" with the drive letter of your floppy drive). Press enter, and follow the on-screen instructions.
3.  Installing from an email attachment:
Many email programs allow you to run the installation program from within the mail reader. In this case, simply double-clicking the attachment in the email will start the installation program. If this does not work on your system, find and highlight the attachment in the email you received from Jolly Giant Software. Select 'File', 'Save as...', and save the attachment as "qws3270.exe". Be sure to record the location of the newly saved program. In your File Manager or Windows explorer, locate the file saved from the email, and double-click on the file to start the installation program. For trouble free installation, accept the default options provided by QWS3270 PLUS.
Back to Top

When uninstalling the trial version, can I just delete the QWS3270 PLUS directory?

Please don't! Deleting the directory may cause some files to be left behind on your hard drive. We strongly recommend that you uninstall the trial version. Press 'Start', 'Settings', 'Control Panel' from the task bar. In Control Panel, locate the 'Add/Remove Programs' icon and double-click it. In the list of programs in the dialog box, locate and highlight 'QWS3270 PLUS version x.x Demo', and click on 'Add/Remove'. Choose 'Automatic' in the uninstall options.  This will remove the trial version of QWS3270 PLUS from your computer.
Back to Top

Why doesn't my window go full screen when I click the maximize button?

Note:  This topic applies only to versions prior to 3.4

To make the window as large as possible, follow these steps:

Locate the 'Window Border' option (under the 'Options', 'Miscellaneous' menu item)

Make sure the 'Window Border' checkbox is selected. If it is NOT already selected, check it, and restart QWS3270 PLUS, since this option is not dynamic.

Connect to the host of your choice.

In the 'Font' dialog box (accessible from the 'Options', 'Font' menu), select a true type font (a font with 'TT' in front of the font name). Courier New is installed on most PC's. Now choose a size for the font, click 'OK'.

Click on the 'Restore' button, then maximize the window, and QWS3270 PLUS will automatically choose the best font size for the largest window possible. Please note that the size may not be quite full screen as the characters must be an even number of pixels high and wide.

Back to Top


How do I connect to a host using QWS3270 PLUS?

There are several ways to connect to a host using the application:

Use the QWS3270 / Connect menu item.
The application will open the connect dialog box to allow you to enter the name or IP address of the host.  This dialog box will allow you to configure and save information on any number of hosts. This method is useful if you connect to many different hosts.

Use the AUTO CONNECT option.
The OPTIONS / MISCELLANEOUS menu allows the application to be customized to your preference. Specify the default host using this menu. If the AUTO CONNECT feature in the Startup Options group box is selected, the application will automatically connect to the host when the application is started.  This is useful if you always connect to the same host and want to bypass the connect dialog box.

Include a host on the command line.
You can include a host on the command line when you create the icon. The command line would be: "c:\directory\qws3270x host port". The port is optional and defaults to the value in the qws3270x.ini file. When a command line host is found, the application will automatically connect to the host when you select the icon from Windows Explorer or your desktop. This method is useful when you have a couple of hosts that you connect to frequently and want to bypass the connect dialog box.  Simply create an icon for each host with the host name or IP address on the command line. Because the application will accept a host and port as command line arguments,  it can be used with ARCHIE clients to connect to 3270 hosts.

Include a script parameter (-s<file.nam>) on the command line.
The script can contain the CONNECT command to automatically connect to a host. It can also contain other commands. See the FEATURES / SCRIPTING SUPPORT section for more details on the scripting syntax. See the COMMAND LINE PARAMETERS section of the help file for details of command line parameters. 

Include a session parameter (-z<session>) on the command line.
The session parameter will use the pre-defined session to automatically connect to the specified host using the parameters defined for this session. Sessions can be defined using the HOST / CONNECT dialog. See the COMMAND LINE PARAMETERS section of the help file for details of command line parameters.

(see also: Getting started with QWS3270 PLUS...)

Back to Top


What command line parameters does QWS3270 PLUS accept?

The command line syntax is:

QWS3270X <host> <port> <-Ddirectory> <-Sfile.nam> <-Tnn> <-w file.nam> <-zsession>

<host>
host to which the connection should be attempted. This can by a host name or an IP address. The application will automatically attempt to make a connection to this host when the application is started.

<port>
port number to which the connection should be attempted. The default is 23.

<-Ddirectory>
fully qualified directory name in which to store the parameter files. These files contain the saved parameter settings and any customized keyboard settings. 

<-Sfile.nam>
fully qualified script file name to execute. The application will attempt to execute this script file when the application is started.

<-Tnn>
Title number to use as Window Title. The application will then use the nn portion of this parameter to look up a TITLEnn= parameter in the [QWS3270X] section of the .ini file. The TITLEnn= parameter can be added to the .ini file with the text editor of your choice. 

<-w file.nam>
fully qualified script file name to execute. The application will attempt to execute this script file when the application is started. This parameter is useful if you are using Netscape to start the application. Please note the space between the w and the file name. 

<-zsession>
the pre-defined session (as defined in the HOST / CONNECT dialog) that you wish to use to connect to the host. All of the parameters as set in this session will be used for this connection.

Special Notes:
If present the host and port parameters must be the first two parameters. The relative order of title and script parameters does not matter.

If the command line includes a host parameter, the script file, if present, should not contain a connect command.

Please note that all parameters are optional. Each parameter should be separated from the previous parameter by one space character.

Back to Top


Can I automate some of the things that I use QWS3270 PLUS for? How do I use scripts?

Scripts are files that contain commands for the program to read and execute. The program must be able to understand these commands, which is why you can only use commands that have been defined by us in your scripts. These instructions should give you a good idea on how to get started with scripts, and what they can or cannot do to automate some of your regular tasks.


Please note: This portion of the FAQ is by no means a complete listing of the scripting report.  For a more detailed explanation of our supported scripting commands, including the latest updates and examples, please look at the QWS3270 PLUS help file under Features/Advanced Features/Scripting Support.


General Command Syntax:

<command> "parameter"

where <command> can be one of the following:

call close connect cursor delimiter exit goto hllapisessionid key label lookfor looklist luname message password port prompt run session terminal title type wait

The syntax is fairly flexible. The command 'lookfor"text"' is the same as 'lookfor "text"' and 'lookfor "text"'. In other words, the blanks between the command and the parameter are ignored.

The commands can be strung together like this: type"myname"key"tab"type"mypass"key"enter".   Each of these commands could be on separate lines separated by CR LF characters. Scripts can be created with text the editor of your choice. If you use a word processor like MS Word or WordPerfect, make sure you save the file as a text only file (.txt). 

The meaning of the parameter for each of the commands is:

call "script file"
- Call another script. The parameter is the fully qualified name of the script file that is to be processed. The called script will be processed then the remainder of the current script will be processed. 
EXAMPLE: call c:\<directory>\<file.nam>"

Back to supported commands


close
- Close the window. The remainder of the script is ignored and the window is closed. The user is not prompted as to whether the window should be closed. 
EXAMPLE: close " "   (Note: the double quotes are required for this command)

Back to supported commands


connect "hostname"
- Connect to the host specified by "host". This can be an IP address or an host name.
EXAMPLE: connect "123.456.789.001" or connect "your.host.name"

Back to supported commands


cursor "row/column"
- Move the cursor to the specified row/column location. For example to move the cursor to row 10 column 26 use the command: 
EXAMPLE: cursor "10/26"

Back to supported commands


delimiter
- Change the default delimiter of " (double quote) to the character of your choice. This command can be used at any location in the script. The delimiter can be changed multiple times within the script. For example to change the delimiter from " to ~ use the command: 
EXAMPLE: delimiter "~"

Back to supported commands


exit
- Exit script processing. The remainder of the script is ignored.
EXAMPLE: exit " "   (Note: the double quotes after this command are required)

Back to supported commands


goto "label"
- Branch to a label within the script. Note that the label must appear in the script after the goto command. For example, goto "label99" will bypass all script commands until the label "label99" script command is found. 
EXAMPLE: goto "mylabel"

Back to supported commands


hllapisessionid "sessionid"
- The HLLAPI session short name for this session. This command can only be used before a connection is made to a host. Once the connection has been established, this parameter is ignored. The HLLAPI session id must be a single character from "a" - "z" 
EXAMPLE: hllapisessionid "Y"

Back to supported commands


key "keyname"
- Name of a key to be simulated. For example: key "enter" will simulate an enter key; key "PF1" will simulate a PF1 key; key "tab" will simulate a tab key. The names are the same as those found in the keyboard mapping dialogs
EXAMPLE: key "home"

Back to supported commands


label
- Designates a label location within the script 
EXAMPLE: label "mylabel"

Back to supported commands


lookfor "search string"
- Text that the application will scan for in the current or future screens received from the host. The text is case sensitive.  The command lookfor userid" is not equivalent to lookfor "USERID"
EXAMPLE: lookfor "password"

Back to supported commands


looklist
- Search for one of two strings and branch to the appropriate label depending on which string is found first. The syntax of this command is:
EXAMPLE: looklist "string1[label1]string2[label2]"

If string1 is found, processing will branch to label1. if string2 is found, processing will branch to label2.

Back to supported commands


luname "devname"
- The device name that you wish to use to connect to the host. This will be the VTAM logical unit (LU) name and is limited to a maximum of 8 characters.  This parameter should be used only with hosts or servers that support TN3270 extensions (TN3270E). This command must precede the connect command in the script
EXAMPLE: luname "myterm01"

Back to supported commands


message "message"
- The message that is to appear in the message box. The text will appear in the box. This command can be used to display informational messages. If the OK button is pressed, script processing continues. If the CANCEL button is pressed, script processing is terminated.
EXAMPLE: message "Do you want to continue?"

Back to supported commands


password "message"
- The message that is to appear in the dialog box that will receive the input All characters typed will display as asterisks (*). This is ideal for password prompts
EXAMPLE: password "Please type in your password:"

Back to supported commands


port "port number"
- The telnet port number that the application should use to make the connection.   This command must precede the connect command in the script
EXAMPLE: port "23"

Back to supported commands


prompt "message"
- The message that is to appear in the dialog box that will receive the input.  All characters will appear as typed.
EXAMPLE: prompt "What is your user name?"

Back to supported commands


run "program"
- Run an application. The parameter is the fully qualified name of the program including any command line parameters that are to be executed.
EXAMPLE: run "c:\windows\program.exe".

Back to supported commands


session "session name"
- The pre-defined session (as defined in the HOST / CONNECT dialog) that you wish to use to connect to the host. All of the parameters as set in this session will be used for this connection
EXAMPLE: session "MySession"

Back to supported commands


terminal "terminal type"
- The terminal type that the application should use to make the connection.  The valid values are: IBM-3278-2, IBM-3278-2-E, IBM-3278-3, IBM-3278-3-E, IBM-3278-4, IBM-3278-5, IBM-3278-5-E, IBM-3279-2-E, and IBM-3279-3-E. This command must precede the connect command in the script. 
EXAMPLE: terminal "IBM-3278-5-E"

Back to supported commands


type "text to type"
- The characters that would be typed on the keyboard. This data is case sensitive. For example type "This Text" will result in the characters "This Text" to be typed at the current cursor location 
EXAMPLE: type "This is sample text" 

Back to supported commands


title "window title"
- Text to be used as the Window title instead of the host name 
EXAMPLE: title "My Connection"

Back to supported commands


wait "time"
- The number of seconds to pause script processing. Processing will resume at the next command after the specified number of seconds has elapsed
EXAMPLE: wait "10"

Back to supported commands

Back to Top


Here is a small sample script, that will show you the basics of how to use a script: 

connect "ibm.host"
label "VMLOGO"
lookfor "USERID"
key "enter"
looklist "WELCOME TO THE IBM[VTAMLOGO]Welcome to C.I.C.S.[CICSLOGO]"
label "VTAMLOGO"
key "tab"
type "cicsappl"
key "enter"
lookfor "Welcome to C.I.C.S"
label "CICSLOGO"
prompt "USERID"
key "tab"

Back to supported commands 

Back to Top


What are the minimum requirements for running QWS3270 PLUS?

Operating Systems Supported 

  • Windows Vista
  • Windows XP
  • Windows 2000
  • Windows ME

Minimum System Requirements

  • Windows Sockets version 2.0 or higher
  • TCP/IP connection to an IBM host
  • At least 6MB of disk space
  • IBM compatible, 486 MHz or higher

QWS3270 Secure requires the following in addition to the above list:

  • Internet Explorer 5.01 or higher
Back to Top

Does QWS3270 PLUS run under Windows Vista?

Yes.  QWS3270 PLUS is 32-bit Windows application. The application will run under Windows Vista, as well as Windows XP™, Windows Server 2003™ and Windows 2000™. It has been developed using a combination of Windows Vista and Windows XP workstations. 

Back to Top

Can I integrate QWS3270 PLUS with my browser?

Yes.  To integrate QWS3270 PLUS with your browser, follow these steps: 

  1. Start Windows Explorer.
  2. If using Windows 95 or Windows NT 4.0, select the "View / Options" menu item 

  3.   or
    if using Windows 98, Windows 2000 or Windows XP, select the "Tools / Folder Options" menu item.
  4. Select the "File Types" tab
  5. Select the file type "URL: TN3270 Protocol". You may have to scroll down. Please note that different versions of Windows sort the list in different orders.
  6. If using Windows 95, Windows 98 or Windows NT 4.0, press the "Edit" button

  7.   or
    if using Windows 2000 or Windows XP, press the "Advanced" button.
  8. Select the "open" item in the Action list box and press the "Edit" button.
  9. Select the "Browse" button.
  10. Navigate to the directory where QWS3270 PLUS is installed ("C:\Program Files\QWS3270 PLUS" by default) and select the qws3270p.exe entry and press the OK button.
  11. Click the "Application userd to perform action:" field and move the cursor to the end of the field.
  12. Type " %l %1" at the end of the field (space, per cent sign, lower case l, space, per cent sign, number 1).
  13. Press the OK button twice.
  14. Press the Close button.
Now when you select a "tn3270://...." type address in the browser bar, QWS3270 PLUS will automatically start and attempt to connect to the host.
Back to Top

My printer attempts to print in shades of grey.  Is there a way to turn colour printing off?

Some black and white printers ( for example the HP PCL 6) will make an attempt at rendering colour in shades of grey.  This causes QWS3270 PLUS to detect these printers as colour printers, which causes the screen prints to be printed in these shades of grey.  In version 3.2 colour printing can be disabled from the Options/Printer dialog box. 

In earlier versions, if this effect is not wanted, try using the postscript printer driver for your printer.

Back to Top

Copyrightę 2008 Jolly Giant Software Inc. All rights reserved.
QWS3270 PLUS® and QFTP® are registered trademarks of Jolly Giant Software Inc.
QWS3270 Secure and QWS5250 are trademarks of Jolly Giant Software Inc.
Revised: January 04, 2008