Reflection Desktop 16.1 SP1 Release Notes

October 16, 2017

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.

1.0 What’s New?

The following outline the key features and functions provided by this version, as well as issues resolved in this release:

1.1 Operating System and Platform Support

The following logos and platform support were added in this service pack.

  • Reflection 16-1 SP1 has earned the Compatible with Windows 7 logo.

  • Citrix Certification

  • Reflection 16-1 SP1 has earned the VMware Ready logo certification .

1.2 Security Improvements

Reflection Desktop includes the following security improvements:

  • Applied code changes to address security vulnerabilities associated with the FreeType library used in Reflection X Advantage.

  • Updated Reflection X Advantage with Java u131critical patch update.

1.3 Enhancements

This service pack includes a number of product enhancements.

API and scripting improvements

Removed the requirement for CASL “chain” and “do” statements to use a fully-qualified macro path. These statements now match InfoConnect 9.x functionality.

Added the ability to hide or show the status bar in Classic MDI and Ribbon mode and added the StatusBarVisible property to the VBA and .NET API so visibility can be toggled through automation. Also added support for the legacy ShowStatusBar method.

Added support for the UTS SendKeys method in the InfoConnectCOM API.

Added support for the HotSpotScheme property in the InfoConnectCOM API.

Added the QuickPadShowToolTips API property to toggle the Show ToolTips setting in the Manage QuickPads dialog box on or off.

Added functionality so that Quickpads or custom keyboard maps that reference macros in hard coded directories now look in the default user data directory or the default legacy EXTRA! directory if they can't find the macro.

Added the WheelDirection property to the VBA and .NET API MouseButtonCombination element.

This property can be used to set up mouse wheel mapping. To map wheel up or down events, use the MouseButtonCombination object, but with WheelDirection set instead of the Button (Left or Right).

Added functionality to determine the wait-state of a UTS session.

This reduces errors due to failure to recognize a completed transmit. It also improves performance. (With previous methods, the screen draw state had to be checked multiple times.)

Added support for CopyToBuffer and PasteFromBuffer methods in InfoConnect APIs

The ability to copy to or paste from 4 different buffers was added to InfoConnect Desktop (this is a Legacy InfoConnect feature). The CopyToBuffer and PasteFromBuffer methods were added to the VBA and .NET API to make this functionality available for automation.

NOTE:This feature was not added to Reflection.

Added the ability to import macros into the Common Project (using VBA) without having a Terminal View open.

HLLAPI RECEIVE FILE (91) failed if optional id (shortname) is not included with the host file name in the HLLAPI Data String

US 6643 Added Retain Display Format property for API

Added ablity to import PComm macros

QuickPads and UI

Improved toolbar docking in Classic mode to make this feature easier to use.

Added the capability to reorder the position of toolbars in the Classic UI Designer.

Added an the ability to select more than one QuickPad for a session.

Added the capability to set the foreground and background color of labels and group boxes in the QuickPad Designer.

Added an action to toggle the Show ToolTips setting in the Manage QuickPads dialog box on or off.

Eric - Advanced Options for for Enable Custom DA Response - UI changes need to be documented - rdox


Added the ability to import a toolbar from another Ribbon file when working in the Classic UI Designer.

Added the ability to import legacy UTS color scheme (.euc) files as theme (.themex) files when legacy sessions are loaded.

Added the ability to import legacy (InfoConnect and Extra) toolbar (.ETB) files into the Workspace UI Designer.


RXA fixes and improvements

Added the -delete parameter to the RXA rxmgr.exe command line.

Periodically, exiting definitions become invalid and need to be removed. Now there is an easy way to do this.

Added functionality for RXA to remove duplicate client definitions and session definitions from the user database when definition files are imported.

Two options were added to the RXA command line: -delDupClients and -delDupSessions for use along with the -import option. These options delete existing X Client and Session definitions that have the same names as those contained in the rxd file the user is importing. For example:

-noStart -import someRXDFile.rxd -delDupClients -delDupSessions.

The options are not case sensitive. That is, -delDupClients is the same as -deldupclients.

The Delete duplicate X client definitions and Delete duplicate session definitions settings were added to the Import Definitions dialog. These have the same functionality as the two command line options, mentioned above.

Added the "Disable UTF-8 encoding in CTEXT clipboard pastes" option

When selected, Unicode characters that are not contained in the X Consortium approved standard encoding are replaced with question marks ('?') when converting a selection to a compound text (CTEXT) target.


Added the capability to map the mouse wheel forward or backward movements to Reflection actions.

Changed the functionality of the Action Sequence dialog box so that new actions are added directly below a selected action in an action sequence instead of just at the end of the sequence.

Added the ability to map the mouse wheel Up or Down actions to Reflection actions.

By mapping the mouse wheel Up or Down actions to send Up or Down keys, you can set up the mouse to page up or down through large tables of data without touching the keyboard.

NOTE:If you create a mouse map for IBM and assign it to VT - some actions like Up or Down will not work.

Added the setKeyboardMapAction, showQuickPadAction and setHotSpotFileAction actions

Added the setKeyboardMapAction, showQuickPadAction and setHotSpotFileAction actions. These actions can now be assigned in the Select Actions dialog box.

Imported legacy keyboard map and hotspot files now handle external file references for the setKeyboardMapAction, showQuickPadAction and setHotSpotFileAction actions -

Other Improvements

Added HTTP Proxy support for RIBM terminals.

Improved performance of Reflection (and InfoConnect) in Citrix environments.

Added support for a "network" or "shared" installation of InfoConnect Desktop.

This allows multiple users to run InfoConnect from one shared installation.

Added the ability to copy to or paste from 4 different buffers to InfoConnect Desktop.

This is a Legacy InfoConnect feature and is now supported when using the Classic MDI user interface. You can access this feature from the Edit menu.

Added supported for the windows %USERPROFILE% to the Open Document action parameter.

This allows you to set up this action to open a document in user data subfolders.

1.4 Software fixes

Reflection Desktop includes software fixes that resolve several previous issues.

API and Scripting

A host HLLAPI application failed when checking data in byte 82 (index 81) of the buffer returned by HLLAPI function 13, CopyOIA

Changed the value that Reflection and InfoConnect return at byte 82 in the CopyOIA buffer so that it is consistent with the value returned by Host Explorer and Extra!. This change corrects problems with a specific application.

CASL Save statement caused error if it didn’t include the file name parameter

Changed the CASL Save statement to make the file name parameter optional. If the statement doesn’t include a file name, the session name is used. OK

Using the busyCursor function caused Error: "15-7 The specified session does not currently exist"

Fixed problems that caused this CASL error when using the BusyCursor function by changing this function to a "no-op."

Layouts which contained EXTRA basic macros sent data to the incorrect session

When layouts that included sessions with Extra! Basic startup macros were opened, the macros sometimes ran against the wrong sessions. When the last session was loaded, that session's macro ran against the session that had focus when the layout completed loading. (If the layout was saved with another session in focus, the macro ran against the wrong session.)

When loading a layout, Extra Basic startup macros now run against the appropriate sessions.

R8win.exe crashes when "IgnoreEUICmdErr" and "CursorProgressIndicator" are enabled

When accessing 5250 terminal popup windows, the following error messages were displayed: CPF5192 “Data sent to device not valid”  and RPG9998 “Internal Failure in compiler or subroutine.”

This service pack supports the "Ignore EUI Command Error" and “CursorProgressIndicator” in Reflection Desktop 16.1 so that Reflection Desktop no longer crashes when accessing IBM 5250 terminal popup windows.

InfoConnect only: When attempting to use VBA to access the COM Object, the following error occurs: System.MissingMemberException: Public member 'Sessions' on type 'MarshalByRefObject' not found.

This service pack fixed problems with using Visual Basic for Applications to access the COM object.

The Stream capture method did not return protected field text

The InfoConnect Desktop COM API Stream method is now returning protected text as expected.


Docking locations of QuickPads were not saved when QuickPads were closed and re-selected

Fixed problems with QuickPads Docking locations. The locations are now saved when QuickPads are closed and re-selected.

Fixed problems with docked toolbar locations so that Docking locations of toolbars within the Classic MDI Ribbon are now preserved when a session is saved and reopened.

When using a black background in QuickPad Designer, text and group boxes were not visible

Fixed problems with text visibility that occurred when using a black background in the QuickPad Designer. When text or group box controls are added into a “Black” background QuickPad, their default foreground color is set to “White.”

Docked QuickPad windows shrunk after switching sessions

Fixed problems with QuickPads shrinking after switching sessions.

The "Show ToolTips" setting in the Manage QuickPads dialog box does not work as expected

Fixed the Show ToolTips setting in the Manage QuickPads dialog box so that ToolTips are hidden if this option is unselected.


When open for long periods of time, RXA X client windows sometimes cease to respond and lose their title bars

Fixed problem with RXA windows losing title bars or becoming unresponsive after they are open for long periods of time.

Importing RXA session definitions with the command line resulted in custom keyboard map data being lost

Fixed problems with loss of custom keyboard data that occurred when using the command line to import an RXA definition file that contained a keyboard map.

RXA Windows had display (painting) problems

All windows are now completely and accurately rendered.

User Interface

The Classic MDI and Classic user interfaces now support icons for menu items

Menus now display icons by default.

With Workspace in Classic MDI mode, it was possible to use the wrong custom Menu Bar and Toolbar

This service packs fixed problems with sessions showing the wrong custom Menu Bars and Toolbars when sessions with different terminal types were opened in Classic MDI mode.

The Preview button in the Classic UI designer did not work as expected

The Preview button in the Classic UI designer now displays an image of the toolbars and menus you are designing so you can see how they look before you save them.

Buttons on Reflection 14 (.r2w file) toolbars that were mapped to unsupported actions were not imported to the ribbon.

All imported toolbar buttons are now imported and displayed, even if they map to an unsupported action.

Custom Files and Settings

Global Secure Shell Settings were not Working as Expected

This service pack fixed problems with the location that Reflection and InfoConnect look for the SSH configuration scheme. For Both InfoConnect and Reflection, the “SSH configuration scheme” dropdown is now populated from the following locations in the order shown: %programdata%\Attachmate\Reflection %programdata%\Micro Focus\Reflection UserDir set in WorkSpace Settings (Registry)

After importing a theme file from a Reflection 14 session, the theme file was not available for selection until the session was saved in the Reflection Desktop file format

This service pack fixed problems with selecting theme files.

Permission (.access) settings and Group Policy settings for closing the workspace could be circumvented.

This service pack fixed problems that allowed users to close the workspace or sessions when these actions were restricted.

If a session used a custom keyboard, mouse, hotspots, or theme file, the currently selected file was not displayed in the selection dialog box

This service pack fixed problems with custom file selection. After selecting a custom file, that file is now selected and displayed in the list when the dialog box used to select the file is reopened.

Users were Unable to select converted theme files

This service pack fixed problems with selecting converted theme files.

Fixed problems with closing VT terminal sessions that occurred after enabling the "Support graphics" checkbox.

Other Issues

IBM 5250 External Program commands containing spaces failed because of missing quotation marks

Fixed problems that occurred in IBM5250 sessions when external commands that executed in the Windows environment were sent with file paths that included spaces.

Companion installers created for all users had problems with .access file parsing errors which prevented the Workspace from opening.

This service pack fixed problems that prevented the Workspace from opening after Reflection or InfoConnect companion MSIs for all users were installed.

TLS file transfers to a Unisys Host failed

The RSC - FTP response “426 Data Connection destroyed” occurred when performing a TLS file transfer to a Unisys Host

TLS FTP transfers to Unisys host now work as expected.

Fixed problems that occurred when an IBM 3270 printer session was loaded via the IBM 3270 printer association.

The IP address and Port configured in the printer profile is now used for the connection instead of the IP address of the display session. More details for new setting in printer sesson TN Association Use TerminalCx"

Fixed problems with random crashes that occurred in the Reflection “Send Text" action when sending hundreds of words.  

new story from Brian with special characters if your legacy file contained these characters - you couldn’t save it - now you can.

2.0 Legal Notice

For information about legal notices, trademarks, disclaimers, warranties, export and other use restrictions, U.S. Government rights, patent policy, and FIPS compliance, see

Copyright © 2017 Attachmate Corporation, a Micro Focus company. All rights reserved.

The only warranties for this product and any associated updates or services are those that may be described in express warranty statements accompanying the product or in an applicable license agreement you have entered into. Nothing in this document should be construed as creating any warranty for a product, updates, or services. The information contained in this document is subject to change without notice and is provided “AS IS” without any express or implied warranties or conditions. Micro Focus shall not be liable for any technical or other errors or omissions in this document. Please see the product’s applicable end user license agreement for details regarding the license terms and conditions, warranties, and limitations of liability.Any links to third-party websites take you outside Micro Focus websites, and Micro Focus has no control over and is not responsible for information on third party sites.