This technical note describes introductory information about Attachmate EXTRA! X-treme that will be helpful to users who are migrating from NetManage RUMBA.
Note: EXTRA! X-treme includes a Migration Wizard that you can use to migrate session configuration, macros, and customized keyboard maps from other vendors' formats to EXTRA!. See KB 7021883 for detailed information.
RUMBA Keyboard, Color, Toolbar, and Menu Schemes
Use the Options > Settings dialog box in EXTRA! X-treme to configure settings. On 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 used in RUMBA.
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 that use Kermit file transfer is not supported.
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.
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:
|WP Require Backspace
|WP Required Tab
|WP Required Tab
|WP Required Space
|WP Insert Symbols
||Local Help Cursor
|WP Begin Bold
|WP Next Column
|WP Half Index Down
|WP End Bold/Underline
|WP Next Stop Code
|WP Page End
|WP Required Page End
|WP Stop Code
|WP Begin Underline
|WP Word Underline
|WP Half Index Up
|WP Bottom of Page
|WP Beginning of Line
|WP End of Line
|WP Top of Page
|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 through 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.
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! through 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. If your organizationâs applications depend on one or more of these functions, please contact your Attachmate representative to discuss requirements.