Rocket wIntegrate User Guide

wIntegrate is a connectivity tool that integrates host-based applications with the desktop. The initial interface is a terminal emulator with data transfer features designed for the multi-valued environments of UniVerse, UniData, D3, and mvBase.

PDF

Document

Rocket wIntegrate
User Guide
Version 6.4.0
February 2016
WIN-640-ALL-UG-01

2
Notices
Edition
Publication date: February 2016
Book number: WIN-640-ALL-UG-01
Product version: Version 6.4.0
Copyright
© Rocket Software, Inc. or its affiliates 1996-2016. All Rights Reserved.
Trademarks
Rocket is a registered trademark of Rocket Software, Inc. For a list of Rocket registered trademarks go
to: www.rocketsoftware.com/about/legal. All other products or services mentioned in this document
may be covered by the trademarks, service marks, or product names of their respective owners.
Examples
This information might contain examples of data and reports. The examples include the names of
individuals, companies, brands, and products. All of these names are fictitious and any similarity to
the names and addresses used by an actual business enterprise is entirely coincidental.
License agreement
This software and the associated documentation are proprietary and confidential to Rocket Software,
Inc. or its affiliates, are furnished under license, and may be used and copied only in accordance with
the terms of such license.
Note: This product may contain encryption technology. Many countries prohibit or restrict the
use, import, or export of encryption technologies, and current use, import, and export regulations
should be followed when exporting this product.

3
Corporate information
Rocket Software, Inc. develops enterprise infrastructure products in four key areas: storage, networks,
and compliance; database servers and tools; business information and analytics; and application
development, integration, and modernization.
Website: www.rocketsoftware.com
Rocket Global Headquarters
77 4th Avenue, Suite 100
Waltham, MA 02451-1468
USA
To contact Rocket Software by telephone for any reason, including obtaining pre-sales information
and technical support, use one of the following telephone numbers.
Country Toll-free telephone number
United States 1-855-577-4323
Australia 1-800-823-405
Belgium 0800-266-65
Canada 1-855-577-4323
China 800-720-1170
France 08-05-08-05-62
Germany 0800-180-0882
Italy 800-878-295
Japan 0800-170-5464
Netherlands 0-800-022-2961
New Zealand 0800-003210
South Africa 0-800-980-818
United Kingdom 0800-520-0439
Contacting Technical Support
The Rocket Customer Portal is the primary method of obtaining support. If you have current
support and maintenance agreements with Rocket Software, you can access the Rocket Customer
Portal and report a problem, download an update, or find answers to in the U2 Knowledgebase.
To log in to the Rocket Customer Portal or to request a Rocket Customer Portal account, go to
www.rocketsoftware.com/support.
In addition to using the Rocket Customer Portal to obtain support, you can send an email to
[email protected] or use one of the following telephone numbers.
Country Telephone number
North America +1 800 729 3553
United Kingdom/France +44 (0) 800 773 771 or +44 (0) 20 8867 3691
Europe/Africa +44 (0) 20 8867 3692
Australia +1 800 707 703 or +61 (0) 29412 5450
New Zealand +0800 505 515

4
Contents
Notices................................................................................................................................................................................... 2
Corporate information......................................................................................................................................................... 3
Chapter 1: wIntegrate overview.......................................................................................................................................... 6
Introduction...............................................................................................................................................................6
wIntegrate features.................................................................................................................................................. 6
Chapter 2: Getting started................................................................................................................................................... 7
Starting a session..................................................................................................................................................... 7
Opening multiple sessions.......................................................................................................................................7
Setting up default startup sessions........................................................................................................................ 8
Setting up terminal emulation................................................................................................................................ 8
Setting up communications...................................................................................................................................12
Setting up serial communications............................................................................................................ 13
Setting up U2 SSH communications......................................................................................................... 15
Setting up U2 SSL communications..........................................................................................................18
Setting up Windows Sockets (Telnet) communications.......................................................................... 21
Installing host programs........................................................................................................................................ 24
Sharing the host programs.................................................................................................................................... 25
Setting up shortcuts on the desktop.................................................................................................................... 26
Setting up the printer.............................................................................................................................................26
Viewing the program settings................................................................................................................................26
Chapter 3: Customizing wIntegrate...................................................................................................................................28
Customizing the splash screen.............................................................................................................................. 28
Disabling the splash screen................................................................................................................................... 28
Adding or removing toolbars.................................................................................................................................29
Navigating through backpages..............................................................................................................................30
Changing the window colors................................................................................................................................. 30
Changing the colors of specific screen attributes................................................................................................ 31
Changing the text style.......................................................................................................................................... 32
Changing the character display.............................................................................................................................33
Resizing the window...............................................................................................................................................35
Changing the session title......................................................................................................................................35
Adding or removing scroll bars and the status bar..............................................................................................36
Changing the session name...................................................................................................................................36
Changing the communications’ port saving options........................................................................................... 37
Closing the session automatically when the port is closed.................................................................................37
Preventing the session from closing if the port is open...................................................................................... 37
Trimming trailing spaces with clipboard operations...........................................................................................38
Using edit keys for local editing............................................................................................................................ 38
Consuming one U2 license for multiple host connections using Device Licensing............................................ 38
Changing application preferences.........................................................................................................................39
Adding custom scripts............................................................................................................................................41
Customizing mouse and keyboard functions....................................................................................................... 41
Assigning functions the mouse..................................................................................................................42
Assigning functions to the keyboard.........................................................................................................43
Creating a macro........................................................................................................................................ 44
Configuring break keys...............................................................................................................................45
Creating a login script............................................................................................................................................ 46
Copying text............................................................................................................................................................ 47
Copying text with Copy Special to........................................................................................................................ 49
Recording and playing back data......................................................................................................................... 50

100

101

102

103

104

105

106

107

108

Key features

Run concurrent sessions
Customize a wIntegrate session
Control any aspect of the application using powerful scripting language
Optionally deploy a thin client on Windows or Java
Run scripts from supplied host-based subroutines
Define terminal emulations
Export files from your PC to a host computer
Import host computer files to your PC
Transfer files from one host computer to another host computer
Simplify deployment through optional thin client and browser interfaces

Frequently asked questions

Click the Windows Start button and select All Programs > wIntegrate > wIntegrate. Follow the steps in the Session Wizard. Click Finish to complete the Session Wizard.

wIntegrate offers the following types of communications: Serial, U2 SSH, U2 SSL, and Windows Sockets (Telnet).

From the wIntegrate toolbar, select Setup > Communications. In the Communications dialog box, select Serial. Click Setup. Select the port, baud rate, parity, data bits, stop bits, and flow control. Click OK. Verify that the Open check box is selected. Click OK. Log in using the credentials for the host computer. Save the communications as part of your current configuration file by selecting from the toolbar File > Save, or select Save As if you want to save the session as a new .wic file.

The wIntegrate sessions are saved as .wic (configuration) files in the My Documents \wIntegrate\Session folder.

You can open multiple sessions to the same host or to different hosts, subject to the hosts’ ability to support multiple connections. If you have a session open, and want to open an additional one, from the wIntegrate toolbar, select File > Another. From the Open Another Session dialog box, select the .wic file for the session that you want to open, and click Open.

User questions

Mary J.

How to change the host in wIntegrate?

To change the host in wIntegrate, follow these steps:

Navigate to Setup > Communications from the wIntegrate toolbar.
In the Communications dialog box, select the appropriate communication method you are using (Serial, U2 SSH, U2 SSL, or Windows Sockets).
Click Setup.
In the setup dialog for your selected communication method, modify the Host field with the new host name or IP address.
Complete the setup by providing credentials for the host computer in the wIntegrate window when prompted.
To save your changes, go to File > Save from the toolbar, or File > Save As to save it as a new .wic file.