Reflection Desktop 16.2 Update 4 Release Notes (Includes Updates 1, 2 & 3)


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 client applications.

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

These release notes include new improvements and resolved issues for Reflection Desktop 16.2 Updates 1, 2, 3, and 4.

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.

What’s New?

Reflection Desktop 16.2 Updates 1, 2, 3, and 4 include several improvements.

Update 4 (Version 16.2.831)

Security Features

  • Improved how the Disconnect automatically when token is removed setting functions in Reflection Desktop so the removal of a smart card disconnects the session.

  • Developed a new option for users to select the appropriate certificate during TLS connections. When Prompt for certificate is selected during the connection, the Select Certificate dialog box presents the user with options to select from, based on information from the Server’s Certificate Request message.

Security Updates

Reflection Workspace

  • Added the ability to manage session lists in Host Access Management and Security Server with an HTML-based user interface. These sessions can now be managed without using a Java applet.

Update 3 (Version 16.2.780)

Reflection X Advantage

  • Added support to send a complete certificate chain when the client identity is in the SystemStore. Added support to send intermediate CAs along with the user certificate (RFC6187). This feature allows the client to send a complete Certificate chain (if available) when the client identity is in the SystemStore and the algorithms from RFC6187 are being attempted.

Update 2 (Version 16.2.754)

Reflection Workspace

  • The key combinations Ctrl+Left Arrow and Ctrl+Right Arrow now move the cursor to the previous field or word in 3270 and 5250 sessions to match the behavior of Extra!.

  • The RADIUS protocol is now supported as an authenticator when a user is attempting to access host resources from Host Access Management & Security Server (MSS) 12.6 via Micro Focus Advanced Authentication (MFAA).

Update 1 (Version 16.2.731)

Reflection Workspace

  • For VT terminals, added the Capture Incoming Data action that is available in the Extra! product and in InfoConnect Enterprise editions. You can use the Capture Incoming Data action to capture data received from the host and save it to a file. This allows you to save a report (or other data) on the host screen and distribute it as a text file. It is also useful for logging data received from the host.

Reflection Desktop for NonStop Add-On

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

  • Added the ability to switch the host file display between Guardian API and USS modes when connected to a Non-Stop FTP Server.

  • The Fast Paste option has been removed and replaced with a Fast Paste button in the Reflection for Non-Stop host sessions.

  • The ability to clear the clipboard has been added to Reflection for Non-Stop host sessions.

Resolved Issues

Reflection Desktop 16.2 Updates 1,2, 3, and 4 resolved the following issues.

Update 4 (Version 16.2.831)

Reflection Workspace

  • Connection errors are no longer hidden on SSH sessions when using the default user authentication.

  • Reflection no longer displays an empty window frame while authenticating with single sign-on.

  • Resolved a change of behavior issue when using the SFTP command line -q option. This fix restores the output information for each command.

  • Resolved an issue that caused Reflection Desktop to crash when a request to enter a pin for a smartcard “timed out.” This issue occurred when using a smartcard to connect to a host using client authentication with ActivClient 7.1 middleware.

  • Users are now returned to the AS/400 Sign On screen when "Automatically sign-on using Windows Credentials" fails.

  • Resolved issues with the Terminal User Control (TUC) that could cause the following error when multiple TUC sessions were open:

    Failed to connect to an IPC Port: The system cannot find the file specified.

  • Fixed an issue with the Screen.PutText1 and Screen.PutText2 methods in the Reflection VBA and .Net API. When these methods were used to put text on the screen, characters were dropped if the text spanned across fields.

    Screen.PutText1 and Screen.PutText2 methods put text at a specified screen location. PutText1 and Puttext2 now have two modes: Mask and LinearStream. These modes are set with the PutTextMaskProtectedField Property.

    In Mask mode (the default), text that coincides with protected fields is skipped and is not placed on the screen.

    In LinearStream mode, protected fields are ignored and the text is placed sequentially in unprotected fields until all of the text is placed on the screen or the specified length is exceeded.

  • The "Require Authentication" centralized management setting now works as expected.

  • Resolved a connection failure error when trying to reconnect to a centrally managed Reflection Desktop SSH session to an OpenVMS host.

Reflection Desktop for NonStop Add-On

  • Resolved issues that caused crashes when closing Non-Stop (RD6) host sessions before connections “timed out.”

Reflection X Advantage

  • Fixed installation problems that occurred when Reflection Desktop Pro was installed without any RXA components, but was later modified to add X Manager. When users logged into the same workstation and tried to run X Manager, the following message was displayed:

    File does not exist: \identity\root

  • Fixed problems that resulted in the following error message when using RXA to run RStudio from an xterm client.

    libGL error: No matching fbConfigs or visuals found
    libGL error: failed to load driver: swrast
    The X11 connection broke: Maximum allowed request length exceeded (code 4)
    XIO: fatal IO error 2 (No such file or directory) on X server "display #" after 36x requests (36x known processed) with 0 events remaining.

    NOTE:In certain scenarios, setting the following environment variable before you run RStudio may provide a performance gain.


  • Fixed problems that sometimes caused windows to be hidden or displayed improperly when they were moved.

  • Fixed various display issues that occurred when running the IDS (Integrated Development System) X client.

Update 3 (Version 16.2.780)

Reflection Workspace

  • Multi-threaded HLLAPI apps can now connect to multiple terminals with each thread connecting to its own terminal and interacting with it. Before this fix, the threads wrote to a single session.

  • The EXTRACOM Screen.WaitForKeys() method now correctly captures key presses from the host session instead of timing out.

  • Problems that occasionally occurred when exiting a Terminal User Control (TUC) WPF application have been fixed.

  • Fixed an unintended UI Preference change; “Look and Feel / Color Scheme” was set to Office 2016, when using workspace update files.

  • Fixed problems that caused crashes when the user’s MyDocument location was mapped to a folder in which the user does not have write access to. 

  • Fixed random crashes that occurred when loading and running VBS macros in 6530 sessions.

  • Copying a continuous Primary Account Number PAN and pasting it into multiple fields now works as expected. 

  • Fixed problems that occurred when using certain barcode scanners.

  • Resolved an intermittent problem with the VBA WaitForHostSettle method. This method occasionally did not return a value or returned a value after exceeding the timeout value.

  • Fixed issues that caused some macros (or parts of macros) to be improperly displayed in the Run Reflection Workspace Macro dialog. This fix allows the display of VBA macros in dialogs when a comment has been added on the sub declaration line.

  • The Padlock tool tip on the Status Bar refreshes correctly when switching between sessions.

Reflection X Advantage

  • Session definitions named with a semicolon now launch properly.

  • The mouse pointer now moves smoothly when running X clients in sessions with Remote session services enabled.

  • A new compatibility mode is available for working with older SGI clients. The new feature can be enabled by adding '-Drx.sgicompatibility.sessions=<session name>' to the rxmgr.alp file. With this feature enabled, the following error is no longer displayed:

    * X Error of failed request: BadLength (poly request too large or internal Xlib length error)

  • Window stacking is now performed correctly when running the EMS X client.

  • The Motif window manager no longer freezes when run in an X terminal desktop session that is minimized by using the combination of the Windows and Down Arrow keys.

  • Fonts with a non-zero max-byte1 value are now rendered correctly. EUC fonts are an example of fonts which can have a non-zero max-byte1 value.

Update 2 (Version 16.2.754)

Reflection Workspace

  • Fixed the FTP command line -q option to display the correct output data when certain commands are executed while the switch is invoked. This fix restores the original behavior for the -q option.

  • In certain situations, SSH sessions would not disconnect when the setting Disconnect automatically when token is removed was enabled.

  • Fixed the decoding of custom extensions in certificates.

  • Fixed problems where legacy VBA code was missing in SharedMacros files.

  • The Enter key and Function keys now work properly after selecting and deleting double-byte characters in a 5250 terminal.

  • Legacy SharedMacros.r2w and SharedMacros.r4w files now open in the Classic user interface mode.

  • When Spell Check replaces a shorter word with a longer word it no longer causes the input inhibited condition that displayed the X Stickman right-arrow in the Operator Information Area (OIA).

  • Fixed an issue where, if the workspace setting Open documents in same workspace was checked, the splash screen didn't appear.

  • The HLLAPI QueryFieldAttribute function now returns the expected value of 24 when the screen is unformatted, instead of 0.

Reflection X Advantage

  • When using RXA Local Input Method Editor (IME) mode, the Delete key now works in gnome-terminal sessions.

  • When using the Reflection Window Manager, certain X clients no longer stop responding after windows are maximized or minimized.

  • The X Manager now starts even if it was improperly shut down. The following error message is no longer displayed:

    Database may be in inconsistent state.

  • Running glxinfo no longer results in the following protocol error:

    X Error of failed request: GLXBadContextTag

  • Secure Shell connection issues no longer occur when connecting to OpenVMS hosts.

  • Double Byte True Type Fonts now display properly when using Remote Session Services.

Update 1 (Version 16.2.731)

Reflection Workspace

  • Fixed an issue that caused the Reflection Workspace and host sessions to stop responding (“freeze”) when left idle for a period of time. Host session “freezes” could occur for a number of reasons and could also occur if the Reflection Workspace was resized or the Windows screen resolution was changed while the host sessions were running.

  • The Reflection Desktop host sessions now disconnect when a CAC/PIV card is removed from the card reader.

  • When managed by a Host Access Management and Security Server (MSS), an SSH connection to an OpenVMS system no longer fails to reconnect after the first successful connection.

  • Resolved an issue where referencing an Extra! Session object by a session name with the Sessions.Item method failed and displayed the error message “Runtime error 450. Wrong number of arguments."

  • Using the ALT-key and other key combinations did not properly perform menu activation when running in Classic MDI mode for 3270 connections.

  • Using the CTRL-TAB key to switch back to Reflection Desktop from another Windows application could put focus on the Search box instead of the terminal session window.

  • Resolved some causes of the following two errors: “Reflection SSL/TLS library (RSCAPI.DLL) missing or damaged” and “Unable to launch Reflection. Make sure Reflection is installed and registered correctly." These errors were caused by the incomplete loading of the Reflection security modules for secure TLS connections.

  • IND$FILE file transfer to TSO (uploads) no longer adds unnecessary single quotes (tick marks) around multilevel dataset names. The user is now in control and responsible for adding the appropriate tick marks to the TSO dataset names.

  • Fixed an unhandled exception error which could occur when trying to create a new host session from an encrypted host session template.

  • Resolved an issue where the Copy command failed to copy selected text to the clipboard if the Control key was pressed down before releasing the left mouse button.

  • The ThisTerminal.vbProject and the ThisIbmTerminal.vbProject now correctly point to the vbProject of the session that is open.

Reflection X Advantage

  • Fixed an issue that caused the Reflection X Advantage Manager to stop responding (“freeze”) temporarily when configured for “On my Desktop” while running the Serena PVCS Version Manager application.

Reflection Desktop for Non-Stop

  • Fixed a problem where Reflection Desktop for Non-Stop (RD6) host sessions and the Reflection Workspace could crash when switching to another open host session while opening a new host session or closing an existing session.

  • Resolved issues which could occur with the Find function in a Reflection Desktop for NonStop (RD6) host session.

  • A “Could not read file...” error no longer occurs if the mouse pointer is placed over the Quick Access Toolbar or the Reflection Workspace Ribbon while opening a Reflection for Non-Stop (RD6) host session.

Installing Reflection Desktop

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.

If you have already installed Reflection Desktop 16.2, you can apply the .msp file for this update to your existing installation.

If you use the setup.exe file available with this update to reinstall Reflection Desktop 16.2, you will need to reselect the features you want to install during the installation process. The full installation includes this update.

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

Previous Releases

For information about the Reflection Desktop 16.2 release, see the Reflection Desktop 16.2 Release Notes.

Contacting Micro Focus

For specific product issues, contact Micro Focus Support at

Additional technical information or advice is available from several sources: