-QTSVXERX-RJSVQEXMSR

JSV691&%9WIVW
 May 2004

© 2004 Attachmate Corporation. All Rights Reserved.

If this document is distributed with software that includes an end user agreement, this document, as
well as the software described in it, is furnished under license and may be used or copied only in
accordance with the terms of such license. Except as permitted by any such license, no part of this
document may be reproduced or transmitted in any form or by any means (electronic, mechanical,
recording, or otherwise) without the prior express written permission of Attachmate Corporation.
The content of this document is protected under copyright law even if it is not distributed with
software that includes an end user license agreement.
The content of this document is furnished for informational use only, is subject to change without
notice, and should not be construed as a commitment by Attachmate Corporation. Attachmate
Corporation assumes no responsibility or liability for any errors or inaccuracies that may appear in
the informational content contained in this document.
Attachmate and EXTRA! are registered trademarks and the Attachmate logo and QuickPad are
trademarks of Attachmate Corporation.
All other trademarks or registered trademarks are the property of their respective owners.
Except as may be expressly stated in this document, any use of non-Attachmate Corporation
trademarks in this document is not intended to represent that the owners of such trademarks
sponsor, are affiliated with, or approve products from Attachmate Corporation.
Important Information for RUMBA Users

W elcome to Attachmate® EXTRA!® X-treme. This document provides introductory

information that will be helpful to those familiar with NetManage® RUMBA®.

EXTRA! X-treme Features

Here are some of the features available in EXTRA! X-treme.

Migration Wizard
The Migration Wizard (Start menu) converts NetManage RUMBA profiles, macro files,
and more into EXTRA! X-treme settings files. Settings in a RUMBA profile may be stored
in more than one EXTRA! X-treme file. For example, connection information is stored in a
session file, while display color information is stored in a scheme file. Note that a few
lesser-used settings and connection types are not migrated by the wizard.

Session Files
EXTRA! X-treme stores session settings in session files with the .EDP extension. A session
file is similar to a RUMBA profile.

Multiple Instances of the Same Session

EXTRA! X-treme can run more than one instance of a session file at a time. You can
enable multiple session instances on the General tab of the Global Preferences dialog box
(Options menu).

Toolbars
Several optional toolbars are provided with EXTRA! X-treme. You can create, customize,
and save toolbars as needed. You can browse for external bitmap files while customizing
your toolbars.

QuickPads
QuickPads™ provide a quick, graphical way to organize and execute routine EXTRA!
X-treme tasks. Several QuickPads are provided with the product, and you can create,
customize, and save new QuickPads as needed.

Schemes
EXTRA! X-treme uses Schemes to store custom session configurations associated with
keyboard mapping, color attribute mapping, toolbars, file transfers, QuickPads, Edit
settings, and HotSpots. Schemes are stored in the My Documents hierarchy in a directory
for schemes.

Editable Menus
You can create and customize EXTRA! X-treme menus by selecting Menus in the Settings
(Options menu).

Optional Settings for RUMBA Users

EXTRA! X-treme offers optional menus, color schemes, keyboard maps, and toolbars that
make the product feel more familiar to RUMBA users.

3
 Important Information for RUMBA Users

The EXTRA! Basic Macro Language

EXTRA! X-treme includes robust features for recording and editing macros. The EXTRA!
Basic macro language is a full-featured, script-based language that supports OLE
automation, API calls, and Web Service operations. A macro editor for creating and
editing EXTRA! Basic code is part of EXTRA! X-treme.

Web Services
Web Services support in EXTRA! X-treme allows users to experience Web Services
functionality within the EXTRA! X-treme environment. The EXTRA! Basic macro
language supports the WSDL and SOAP protocols. Users can select operations contained
in remote Web Services for use within EXTRA! Basic macros. A wizard-based user
interface provides easy usage of Web Service operations.

Central Management of Configuration Information and User Data

EXTRA! X-treme is integrated with Attachmate Management and Control Services
(MCS). Using MCS, administrators can centrally store, configure, and deploy products,
upgrades and patches. The ability to manage products using MCS adds value for
administrators and users, and helps reduce total cost of ownership.

Deployment from MCS

You can install EXTRA! X-treme from a central MCS server location without having a
physical CD. MCS can deploy virtually any Microsoft® Installer (MSI) application,
including patches, feature packs, upgrades and third-party products. MCS can store
EXTRA! X-treme configuration files and synchronize MCS with a user’s local directory.
This enables administrators to manage their enterprises more efficiently, and also helps
reduce an organization’s total cost of ownership.

Activation
With EXTRA! X-treme, administrators can require that users authenticate through MCS
before they can use EXTRA!. After the user is successfully authenticated, the product is
activated and an entry is made by MCS in a central log, allowing the administrator to
ensure that there is an adequate supply of product licenses for the total number of seats
using the product.

Product Certification

Designed for Windows XP Logo

EXTRA! X-treme bears the “Designed for Windows® XP” logo. You can feel confident
knowing that EXTRA! X-treme operates properly in a Microsoft Windows XP
environment, and that EXTRA! X-treme maximizes the enhancements that the Windows
XP operating system provides.

Windows 2000 Certified

EXTRA! X-treme continues to maintain its Windows 2000 Certification.

RUMBA Keyboard, Color, Toolbar, and Menu Schemes

The Options – Settings dialog box in EXTRA! X-treme allows you to configure the
settings in the product. In each of the settings pages for Toolbars, Menus, Keyboards, and
Colors, you will find configuration schemes that provide a look and feel similar to
NetManage RUMBA. By default, configuration files that you migrate from RUMBA to
EXTRA! X-treme will use settings similar to those they used in RUMBA.
4
 Important Information for RUMBA Users

Migrating RUMBA Files to EXTRA! X-treme with the Migration Wizard

EXTRA! X-treme includes a wizard with which you can convert RUMBA files — such as
profiles and macro files — to EXTRA! X-treme files.

To migrate RUMBA files to EXTRA! X-treme

1. From the Start menu, select Programs, then Attachmate EXTRA! X-treme, then
Migration Wizard.
The Migration Wizard window appears.

2. The wizard displays a list of available translators. To convert RUMBA files, choose
RUMBA 32-Bit and then click Next.
The wizard searches your default RUMBA directories for all files of the types the
RUMBA 32-Bit converter can handle. The next wizard page lists the directories that
contain such files.

5
 Important Information for RUMBA Users

RUMBA files which are not located in default RUMBA directories may not appear in
the list. You will be able to add them later.
3. Click Next to continue. The Migration wizard displays a list of all the files that can be
migrated. The check marks on the left side of the list show which files will be
converted by the wizard.

6
 Important Information for RUMBA Users

4. To add files to the list from other locations, click the Add Files button. The Open
dialog appears. Use this dialog to navigate to directories containing additional files
to convert. Select the files you want to add, then click Open. The files are added to
your list of files to be converted.

Note: With some operating systems, the Open dialog displays only those files with
the RUMBA file extensions .wda, .wdu, and .wdm. To see files with other extensions,
enter *.* in the File Name field and then click Open.

5. Clear the check marks from any files you do not want to convert.
6. When you have finished reviewing the selections, click Next. The Migration wizard
begins converting files. Converted files are placed in the appropriate locations in the
EXTRA! X-treme directory on your computer. The original RUMBA files are left
where they are. A progress bar shows you the status of the conversion task.
When the progress bar is at 100% and the Next button is highlighted, file conversion
is complete.
7. Click Next to continue. The final Migration Wizard window lists the old files and
shows you the location of each corresponding converted file. You can click the View
Report button to see a log of conversion activity. If any errors occurred during
conversion, these are reported in the log.
8. Click Finish to exit the Migration wizard.

Migration Notes
Depending on the files you choose to migrate, the Migration wizard may convert
similarly-named files from different directories, such as a keyboard map from one
directory and a similarly-named macro file from another directory. If a potential file
name conflict arises, the Wizard adds the RUMBA extension .wda, .wdm, or .wdu to the
name of the converted file. This is not an issue when converting a RUMBA profile to an
EXTRA! X-treme session.
If a RUMBA profile has more than one host in its host configuration list, only the first
host from that list gets transferred to the converted EXTRA! session.

RUMBA Macro Conversion Notes

Characters In Macro Labels

When RUMBA macro labels (used as the targets of “GoTo” commands) are converted to
EXTRA! Basic macros, the characters dot ( . ), backslash ( \ ), forward slash ( / ), single
quote ( ' ), tilde (~), exclamation point ( ! ), at sign ( @ ), and number sign (#) are omitted
from the new labels. These characters are not permitted in EXTRA! Basic labels.

Unix Kermit File Transfer

Conversion of RUMBA Unix macros which employ Kermit file transfer is not supported.

Receive
Like its RUMBA equivalent, the EXTRA! Basic command Receive uses the Find At and
Find Anywhere features. “Find string Starting At” is not supported in EXTRA! Basic.

7
 Important Information for RUMBA Users

RunApplication
The RUMBA RunApplication macro command, which calls a macro from within another
macro, is not supported in EXTRA! Basic.

Unsupported RUMBA Keystrokes

The following RUMBA keystrokes do not have equivalents in EXTRA! X-treme:

5250 Keystrokes 3270 Keystrokes VT Keystrokes

WP Require Backspace Test Answer Back
WP Required Tab ScrR->L User 6
WP Required Tab Screen Forward User 7
WP Required Space Screen Backward User 8
WP Insert Symbols Local Help Cursor User 9
WP Begin Bold Help User 10
WP Center ChangeRev User 11
WP Next Column Field Forward User 12
WP Half Index Down Field Backward User 11
WP End Bold/Underline Close User 12
WP Next Stop Code USM User 13
WP Page End Change Screen User 14
WP Required Page End DOC On/Of User 15
WP Stop Code Change Format User 16
WP Begin Underline PA4 User 17
WP Word Underline PA5 User 18
WP Half Index Up PA6 User 19
WP Bottom of Page PA7 User 20
WP Beginning of Line PA8
WP End of Line PA9
WP Top of Page PA10
WP Carrier Return

Running RUMBA API Applications with EXTRA! X-treme

Connecting With a Session

By using an application program interface (API), an application program can connect
with an EXTRA! X-treme emulator session regardless of whether the session has been
started already. If the target session has not been started when the connection request is
made, the API first starts the session (hidden, with no visible user interface), then sets up
the connection and returns control to the application.
By comparison, a NetManage RUMBA emulator session must be started before an
application program can connect with it. If the target session has not been manually
started previously, the application will call the API function WD_RunProfile to start the
session before requesting logical connection.
To convert an existing RUMBA application to work with EXTRA! X-treme via the WD_
API wrapper, calls to WD_RunProfile must be located and the parameter string modified
to specify an EXTRA! X-treme session file (.EDP file) instead of a RUMBA profile. No
other change should be needed.

8
 Important Information for RUMBA Users

Disconnecting From a Session

With both Attachmate EXTRA! X-treme and NetManage RUMBA, an application
program can connect with no more than one session at a time. To connect to another
session, the application can either explicitly disconnect from the current session, or it can
implicitly disconnect from the current session by requesting connection with a different
session.
When an application logically disconnects from an EXTRA! X-treme session, the EXTRA!
X-treme emulator does not terminate; it remains in memory awaiting another connection
request. An application is expected to call function 21 (Reset System) when it has no
further use for the sessions to which it was connected. When function 21 is called, the
API removes from memory the emulator for any session the application has started.
Manually-started sessions and sessions in use by other applications remain unaffected by
this process. Typically, an application will make a function 21 call as part of its exit
sequence.
By comparison, with the NetManage RUMBA product, an application can call
WD_DeletePS to disconnect from and close a session. Any emulator session started by an
application is automatically removed from memory when that application exits.
To convert an existing RUMBA application to work with EXTRA! via the WD_ API
wrapper, the code should be reviewed to identify any exit sequences, whether normal or
abnormal end. In all cases, WD_ResetSystem should be called to ensure that sessions
programmatically started by the application are released and closed when the application
exits. No other change should be needed.

Other API Functions

Except as noted above, Attachmate EXTRA! and NetManage RUMBA are functionally
equivalent in operation with respect to this proprietary RUMBA API. While the
Attachmate WD_ API wrapper does not implement every entry point defined in the
RUMBA API, testing with real-world applications has demonstrated that functions
omitted in the wrapper are rarely used. Should your organization’s applications depend
on one or more of these functions, please contact your Attachmate representative to
discuss requirements.