Reflection Desktop 16.1 SP1 Update 2 Release Notes

1.0 Introduction

Reflection Desktop products are full-featured desktop applications that allow you to run host applications, transfer files, and integrate host data into the latest Windows and Office software applications.

  • Reflection Desktop for IBM provides access to applications running on IBM mainframe and AS400 systems.

  • Reflection Desktop for UNIX and OpenVMS provides access to applications running on UNIX and OpenVMS systems.

  • Reflection Desktop provides access to applications running on IBM, UNIX, and OpenVMS systems.

  • Reflection Desktop for X provides access to applications running on UNIX and OpenVMS systems. It also includes Reflection X Advantage, an X server that allows you to view your UNIX desktop and work with X client applications from a remote workstation.

  • Reflection Desktop Pro includes Reflection Desktop along with Reflection X Advantage, and provides access to applications running on IBM, UNIX, and OpenVMS systems, as well as X clients.

  • The Reflection Desktop for NonStop Add-On is a separately licensed product for connecting to HP NonStop hosts (Tandem 6530).

Reflection 16.1 SP1 Update 2 includes a number of security improvements, new features, and software fixes made since the Reflection 16.1 SP1 release.

Many of these improvements were made in direct response to suggestions from our customers. We thank you for your time and valuable input. We hope you continue to help us ensure that our products meet all your needs.

NOTE:These release notes describe only the improvements and features made since Reflection 16.1 SP1 Update 1.

2.0 What’s New?

Reflection Desktop 16.1 SP1 Update 2 includes several security improvements, and a number of resolved issues and enhancements.

2.1 Security Improvements

This update includes the following security improvements:

  • Added support for X.509 certificates on smart cards when using Micro Focus Host Access Management and Security Server (MSS) and Micro Focus Advanced Authentication.

  • Added support to send intermediate CAs along with the user certificate.

2.2 Improvements and New Features in Reflection Desktop

Several improvements were added in this update:

  • Added the ability to capture up to 190 columns of data for VT terminals. This provides the same functionality as the “Capture Incoming Data” utility that is available in the Extra! and InfoConnect products.

  • Added a new Theme Mapper Action.

  • Added the ability to reference remote macros. You can save VBA macros in session document files that reside on a network share or other location and then configure local session documents to reference these shared documents. When the local session documents open, they load the macros from the documents that they reference.

  • Improved the format of documents exported from Screen History. Word documents generated from Screen History are now formatted to display two screens per page.

  • Added menu commands to launch the Context Menu Editor in the Classic and Classic MDI mode interfaces. The View | Context Menu command was added for IBM sessions and the Setup | Context Menu command was added for VT sessions.

2.3 Improvements to Reflection Desktop for NonStop Add-On

The following enhancements to the Reflection Desktop NonStop Add-On product were added in this update:

  • Added an autowrap option for logging so long lines can appear as a single contiguous line.

  • Added modifications to prevent clear text passwords from appearing in memory.

  • Added the ability to map OSS (i.e. VT emulation mode) colors separate from the Guardian mode colors.

  • Removed fast paste as an option and replaced it with a fast paste button.

  • Added the ability to clear the clipboard.

3.0 Significant Changes in Behavior or Usage

Product performance improvements in this release may introduce new side effects during installation.

  • When running an msi to install the Reflection Desktop product, the progress dialog may display for a few minutes without notification. This is expected and the process will most likely require more time to complete than on previous releases.

  • After a patch that includes these performance improvements is removed, Reflection Desktop will display a repair message when it restarts.

4.0 Resolved Issues

This update includes software fixes that resolve previous issues:

4.1 General fixes

  • Intermittent failures occurred when connecting to hosts via TLS 1.2.

  • HTTPS connections to Centralized Management were using TLS 1.0 only.

  • Problems with ribbon control properties occurred when they were added programmatically.

  • When connecting via SSH using terminal authentication, Reflection Desktop temporarily lost focus.

  • Clipboard paste options produced inconsistent results.

  • Certain scenarios that required heavy processing caused IBM 5250 terminals to hang.

  • The ReGIS graphics cursor did not display.

  • In CICS IND$FILE transfers, the Download button was disabled if an asterisk was specified as the host file.

  • The "Could not find file..." error message was displayed when opening .r4w files.

  • Reflection Desktop failed to start when metering was on and a network adapter was disabled.

  • VT Print output did not cover the entire width of the page.

  • Messages sent from the host related to password change were not displayed in the terminal window.

  • Reflection appended "1" to the device name during initial connections of AS/400 Sessions that were migrated from Extra!. This caused connection issues on some hosts.

  • In IBM 3270 sessions, running host side reports caused Reflection Desktop to hang.

  • The performance of Reflection Desktop was slow when opening legacy .rsf files (especially if the files contained numerous macros).

  • If multiple Public Key Cryptography Standards (PKCS)#11 Providers were specified in Reflection's pki config file, Reflection Desktop did not disconnect from the host when a CAC/PIV card was removed.

  • Trying to open older legacy-EXTRA! 5250 session files resulted in a "Could not read file (...).EDP" error.

  • When trying to set the Set Theme File action in the keyboard mapper, Reflection Desktop threw an exception.

  • In IBM 3270 sessions running on double-byte systems, the workspace mishandled 0x41. If the workspace received 0x41 in the data stream, it was interpreted as a language dependent graphic instead of as a forced space character. This caused the wrong characters to be displayed, and caused keyboard entry to fail.

  • In IBM 3270 sessions, copying extended characters with Use table format enabled added incorrect characters to the Clipboard.

  • When using Reflection Desktop with Citrix 7.X running on a Windows 2016 Server, the following message was displayed when opening a Reflection host session: “Unable to launch Reflection. Make sure Reflection is installed and registered correctly.

4.2 Mouse and Keyboard Input Fixes

  • Mouse double-clicking and triple-clicking did not select a word and group as they do with other emulation types (and other applications).

  • Ctrl + any key toggled CTRL Mode in T27 Sessions.

  • Pressing and releasing the ALT-key in Classic MDI mode not activate the relevant menu item.

  • Mouse double-clicking used only space as a delimiter. This was fixed so that anything other than a letter or a number is a delimiter.

4.3 Menu and Toolbar Fixes

  • When the window was resized in the Classic UI Mode, the menu bar did not resize. If the edge of the window covered a menu option, that option and its shortcut key were not available.

  • The names of toolbar buttons mapped to run Express macros changed to the default “Run Express” name after they were used.

  • Extra Basic Macros added to the Reflection toolbar failed to execute.

  • When a button mapped to run an Extra! macro was clicked on a legacy Extra! toolbar, Reflection Desktop prompted the user to enter the macro if the macro name did not include the .ebm extension. Reflection Desktop now runs macros in the default legacy user data directory without prompting, whether they have an .ebm extension or not.

4.4 VBA and .Net API Fixes

  • The Screen.Updated VBA property works in EXTRA! but did not work in Reflection Desktop 16.1 SP1.

  • VBA Legacy code was missing after applying SP1 and opening an .r2w file.

  • in the Legacy VBA API, the SetEncryptedString method did not set the password for 5250 file transfer.

  • .NET applications using the Reflection Terminal User Control (TUC) failed to connect because Reflection Desktop did not create the vbaproject.bin file.

  • Reflection Basic macros displayed "Reflection Basic Error: A read from a transport failed" when opening a file without a fully qualified path.

  • .NET API programs threw an exception when attempting to read the bottom two lines of a program screen when ShowOIA was False.

  • Problems occurred with dynamic mapping of RunMacro action sequences.

  • Extra hotspots files that ran macros did not work unless the full file name (e.g., ebmacroName.ebm) was specified.

  • The "Could not read file..." error occurred when the SharedMacros file had the same Project name as the session being opened.

  • Reflection threw the "MissingMemberException" when using EXTRACOM "late bound" VB.Net syntax.

  • if VBA ProjectLegacy was password protected, the "Could not read file…" error message was displayed.

  • WaitForKeyboardEnabled did not wait for the keyboard to become enabled when called immediately after sending an AID key, and it did not wait any additional time specified by the duration argument.

  • The IScreen WaitForHostSettle method in the .NET API disabled input to the VT terminal.

  • .NET API calls to create or close embedded sessions regularly caused IPC exceptions.

  • Extra! macros that included the Set Screen = System.Sessions("Dallas").Screen line of code failed when running in Reflection Desktop. The following error message was displayed:

    '"Runtime error 450. Wrong number of args or invalid property assignment."

4.5 Reflection X Advantage Software Fixes

This update fixed the following Reflection X Advantage (RXA) issues:

  • Running Serena PVCS Version Master caused RXA to hang.

  • On certain custom X clients, after selecting a menu that displayed a sub-menu (a list of associated X clients), the sub-menu did not persist.

  • RXA failed to load the SafeNet smart card PKCS#11 driver.

  • Window Management problems were encountered on some custom X clients.

  • Stacking problems occurred on some custom clients.

  • The same number was being typed twice in the Gnome terminal when entering a number from the Numeric keypad in RXA Local Input Method Editor (IME) mode.

  • Using Microsoft IME incorrectly sent a newline.

4.6 Reflection Desktop for NonStop Add-On Software Fixes and Enhancements

This update fixed the following issues in the Reflection for NonStop Add-On product:

  • Double clicking on a 6530 session document file did not honor the Open Documents in Same Workspace setting.

  • On 6530 sessions running in VT100 mode, Copy&Paste actually copied the area directly beneath the marked area.

  • Print screen failed intermittently in 6530 sessions.

  • After opening and closing a 6530 session a number of times, the "Keyboard hook not installed - too many sessions" error message was displayed and the session could not be opened until the workspace was restarted.

  • The Find function had issues.

5.0 Downloading and Installing

Maintained customers are now eligible to download the latest product releases at You will be prompted to login and accept the Software License Agreement before you can download a file.

NOTE:Update 2 is a cumulative update since 16.1 and, hence, it is not necessary to first install Service Pack 1 (SP1) before installing Update 2.

For information about installing, see the Reflection Help and the Reflection Deployment Guide.

6.0 Previous Releases

For information about Reflection Desktop 16.1 SP1 releases, see the Reflection Desktop 16.1 SP1 Release Notes and the Reflection Desktop 16.1 SP1 Update 1 Release Notes.

7.0 Contacting Micro Focus

For specific product issues, contact Micro Focus Support at

Additional technical information or advice is available from several sources:

8.0 Legal Notice

© Copyright 2019 Micro Focus or one of its affiliates.

The only warranties for products and services of Micro Focus and its affiliates and licensors (Micro Focus) are set forth in the express warranty statements accompanying such products and services. Nothing herein should be construed as constituting an additional warranty. Micro Focus shall not be liable for technical or editorial errors or omissions contained herein. The information contained herein is subject to change without notice.