Table of Contents

Introduction

Recently Added Features

Installation procedure

Uninstalling the trial version

Installing the software

Setup

Connecting

Connecting automatically

Customizing the layout

Fonts and colours

Introduction

QWS3270 PLUS® is a fast, easy-to-use 3270E terminal emulation application that allows a PC running Microsoft Windows® to connect to an IBM® mainframe via TCP/IP and TN3270E. The application was designed to take full advantage of the point and click capabilities of the Windows environment.

QWS3270 PLUS contains the following features: support for extended data streams (3279 colours and extended highlighting); a flexible keyboard re-mapping feature; a point and click (hot spots) feature; an entry assist feature that includes things like word wrap, word tab, word delete, margins and typewriter style tab stop; a scripting feature; some limited DDE support; and support for IND$FILE file transfer protocol.

Since the QWS3270 PLUS complies with the TN3270E standard, it can be used with any IBM host running TCP/IP or any IP gateway supporting TN3270 or TN3270E, including Microsoft SNA Server®, NetWare for SAA®, Cisco's TN3270 Server® for CIP or the IBM Communications Server®.

Recently Added Features 

Easy Screen Sizing
Logic has been added to allow QWS3270 PLUS to occupy your entire desktop, and to make window sizing easier than ever.
Changed default screen font to Courier New. This will allow the maximize button to be used by default.
Added a True Type screen font called JollyGiant ANSI. The Jolly Giant ANSI font provides all of the scaling features of other True Type fonts with improved readability over other fonts such as Courier New. 
Added an option to preserve the current window size and adjust the font size if necessary when the host switches between primary and alternate screen sizes. 

Scripting Enhancements
The Getfile script command now includes an "APPEND" option to allow the downloaded file to be appended to an existing file.
The scripting language has been enhanced to allow looping, variables, silent mode, disconnect command, if…then…else statements, 'closeall' command.
A Script Editor has been developed to assist users in writing and editing scripts.
A “Edit Script” menu item has been added to the Tools menu to invoke the Script Editor. 

Enhanced Toolbars
Added buttons that allow the Crosshair Cursor and Line/Block Copy Mode to be toggled. A “Session Properties” and a “Fonts” button to display the respective property sheets have also been added.
Added Customizable toolbar buttons. This will allow you to assign a script or keystroke file action to any one of five toolbar buttons. 

Euro Currency Support
Added support for the Euro symbol. Additional code pages have been added that support the Euro currency symbol.

Keyboard Processing Changes
Added logic to allow hotkey switching between open QWS3270 PLUS sessions.
Expanded the keyboard re-mapping support to allow the Toggle Copy Mode function to be mapped to a key.

User Interface Enhancements
The layout of the Options / Session dialogs that allow you to specify session options have been changed from tabbed property sheets to a scrollable list of options windows. 
Added the ability to rename a previously defined session. The Connect dialog has been modified to include a "Rename" button. This will allow existing sessions to be renamed.. 
Added a Quick Connect menu item to the Host menu. This allows you to establish a session with a host by specifying only a host name, port number and terminal type. 
Added a "Close All Sessions" option to the Host menu item that will close all open QWS3270 PLUS windows. 
Added the ability to convert pre-recorded Keystroke files to Script file format. 
The window size is now remembered. The next time the session is restarted the previous window size will be used.
The “Window Border” option is now a dynamic property. This eliminates the requirement to restart the application for the changes to take effect.
Expanded the Right mouse click options to include a pop-up menu with Cut, Copy, and Paste, just to list a few.
Added the ability to define custom colours to be used for screen displays.

Start Additional Sessions
Added the ability to start another QWS3270 PLUS session from an existing session. 

Enhanced Toolbars
Added buttons that allow the Crosshair Cursor and Line/Block Copy Mode to be toggled. A “Session Properties” and a “Fonts” button to display the respective property sheets have also been added. 

Start up Options
Added the ability to disable the splash screen on start up. 

Customization Options
Added the ability to define custom colours to be used for screen displays. 

Status Bar Enhancements
The Status Bar processing has been enhanced to provide visual notification when an attempt is made to type in protected (xPROT) or numeric (xNUM) fields. 

Optional Crosshair Cursor
Added a Crosshair option to visually assist with text alignment. See View, or the Cursor tab of the Options / Session menu item for details. 

More Options for Setting Up Printers
Added another tab to the setup dialog box to allow the specification of printer setup options for each session. 

Enhanced Script Processing
Added 'Getfile' and 'Putfile' commands to allow IND$FILE file transfers from scripts.
Added 'ScreentoDisk' and 'AppendtoDisk' commands to allow screen contents to be copied directly to disk files. 

Toggle Numeric Field Checking On/Off
Added the ability to disable numeric field checking. See the Options / Session / Miscellaneous dialog for details.

Enhanced 'Field End' key processing
Modified the processing of the ‘Field End’ key to advance to the next field if the cursor is on an attribute byte.

Get more information about your computer
We added a Session Info dialog box that displays information about the connection status and local network.

Re-mapping of the numeric keypad with NUM-LOCK off
Modified keyboard processing routines now allow the re-mapping of the numeric keypad when the NUM-LOCK key is not ’On’.

Run Keystroke files with one key
Modified keyboard processing logic allows keystroke files to be assigned to keys.

QWS3287 Printer enhancements
Enhanced the Command Line parameters to allow an existing session to be specified on the command line.
Added the ability to specify page margins on a printed report. This will enhance the ability to print on pre-printed forms.
Added a printer setup dialog to allow the setting and saving of printer options for each session.
Added the ability to specify the font size and style used for printing.
Added a toolbar to simplify access to commonly used menu commands. 

Fully customizable toolbars
Add, remove and reposition buttons on the toolbar to make QWS3270 PLUS look and work the way you want.

HLLAPI support
QWS3270 PLUS now supports the major HLLAPI functions. This allows QWS3270 PLUS to be controlled from a remote application.

Record / Playback keystroke feature
Repetitive typing tasks can now be automated by using QWS3270 Plus to record and play back any keystroke sequence.  Captured keystrokes can be saved and played back at a future time.

Choose between different cursor shapes and blinking/non-blinking cursor
Many of our users have requested this enhancement!

Tabbed dialog boxes
The use of tabbed dialog boxes makes configuring QWS3270 PLUS even easier.

Back to Top

Installation

If the trial version of QWS3270 PLUS is installed on your computer, we recommend that it be uninstalled before attempting to install the full version. Follow these simple steps to uninstall the trial version. If the trial version is not installed, skip this section and proceed to the INSTALLATION OF THE SOFTWARE section.

Back to Top

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. 

Back to Top

Installing the software
To install the software, follow these steps:

If you received the program by email, save the attached installation program to a location on your hard disk.  If the installation program is on a floppy disk, you can install directly from the disk.

Open windows explorer or file manager.

Locate the installation program.

Double-click on this program. At this point the installation program should start (blue screen with title "QWS3270 PLUS x.x Installation". If it doesn't, contact Jolly Giant Software Inc.

Click "Next" in the dialog box.

Read the EULA (End User License Agreement), and if you agree with the terms, click the "I Agree" button.

Choose an installation directory. Most users accept the default directory. Make a note of the installation directory for future reference. Press "Next".

Select the components to be installed. Note: unselecting BOTH options will not install anything. Make sure that the 'Disk Space Remaining' is a positive number. If not, press 'Cancel', free up some disk space, then try again.

Select a Program Folder. This can be the default folder suggested by the installation program, or a folder name of your choosing. In either case, make a note of the name of the installation folder for future reference. Click "Next".

Select Shortcuts. The installer can create a shortcut to QWS3270 PLUS on the Desktop or Start menu. Select the shortcuts that should be created. Click "Next".

Press "Next" to start the installation process.

After a few seconds, a screen will come up, indicating that the installation has been completed. Press the finish button to complete the installation process.

To start the program, click the 'Start' button, go to 'Programs', 'QWS3270 PLUS', or click on the QWS3270 PLUS icon on your desktop.

Back to Top

Setup
After installing QWS3270 PLUS, no additional setup is required to use the program, provided a working TCP/IP connection is available on your computer.  Please read the following section on 'Connecting' for further information.

Back to Top

Connecting
The first step for connecting to a host is setting up a session.  Follow these simple steps: 

Start QWS3270 PLUS.

Click on the 'QWS3270' menu, choose 'Connect'. 

Click on the 'Add Session' button. 

Enter a name for your session, and click OK.  This name can be anything you like, it is only a means to allow you to distinguish between different sessions. 

In the 'Host' dialog box, enter a name or IP address for the host to which to connect.  If you enter a host name, you must have a valid domain name server specified in your TCP/IP setup screens. 

Be sure the default terminal type and port number are supported by the host to which the connection will be established. If you are not sure about these settings, use the provided defaults, or contact the administrator for the mainframe. 

Click OK, then connect. QWS3270 PLUS will try to establish a connection between your PC and the host. Error messages will be displayed there are any problems with the connection. If there are errors, your mainframe or LAN technical support personnel should be able to help. If not, try contacting Jolly Giant Software at support@jollygiant.com.

Back to Top

Customizing

Connecting automatically
After creating at least one session in QWS3270 PLUS, you have several different options to automatically connect to a host on application startup: 

The command line option <-z'sessionname'>, where 'sessionname is the pre-defined session (as defined in the HOST / CONNECT dialog) that you wish to use to connect to the host. The parameters as defined in this session will be used for this connection.   Please refer to the Frequently Asked Questions for additional details regarding command line options. 

Use 'Auto Connect'
The 'Auto Connect' option can be used to automatically connect to the host specified in the default host section.  Please refer to the online help file included with QWS3270 PLUS.

Use a script file
A script file can be used to automate tasks in QWS3270 PLUS, including connecting to a host. Please refer to the online help files, or our Frequently Asked Questions for additional information about scripting

Back to Top

Fonts, colours and other options
Click the 'Options' menu, choose 'Session'.  The resulting dialog box will allow the customization of most aspects of the application, such as font types and sizes, display colours for foreground, background and text, mouse options, cursor shapes etc.  For additional information on these options, please refer to the online help file included with QWS3270 PLUS.

Back to Top