Reflection Desktop 16.1 SP1 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).

The Reflection Desktop 16.1 SP1 Release includes a number of new security improvements, new features, and resolved issues.

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:For X users: Reflection Desktop for X and Reflection Desktop Pro also include Reflection X Advantage. For features and fixes, see the Reflection X Advantage Release Notes.

NOTE:Reflection Desktop for NonStop Add-On is a separately licensed product for connecting to HP NonStop hosts (Tandem 6530). For features and fixes, see the Reflection NonStop Add-on Release Notes.

2.0 What’s New?

Reflection 16.1 SP1 includes several new features.

2.1 Security Improvements

Reflection Desktop includes the following security improvements:

  • Applied code changes to address security vulnerabilities associated with the FreeType library used in Reflection Desktop for X and Reflection Desktop Pro.

  • Updated Reflection Desktop for X and Reflection Desktop Pro HP UX packages with the Java 8u131 critical patch update.

  • Updated Reflection Desktop for X and Reflection Desktop Pro Solaris, Linux and AIX JVM packs to 8u144.

2.2 API and scripting improvements

Added the ability to hide or show the status bar in Classic and Ribbon user interface modes 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 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 the ability to import macros into the Common Project (using VBA) without having a Terminal View open.

Added support for HLLAPI file transfers on IBM terminals to default to ‘A’ if short names are not provided. Modified the HLLAPI send/receive file APIs to default the short name to 'A' if the short name is missing instead of returning an error.

Prior to this enhancement, HLLAPI RECEIVE FILE (91) failed if an optional id (shortname) was not included with the host file name in the HLLAPI Data String

Added the RetainDisplayFormat property to the API

This setting gets or sets a value indicating whether to retain formatting so that copied text is pasted in the same way as it is displayed in the terminal.

2.3 QuickPads and UI

Improved toolbar docking in Classic user interface modes to make this feature easier to use.

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.

Added a setting to enter a sequence for a custom DA response for VT terminals

The terminal sends this string in response to a primary device attributes request.

Added the Retain display format setting to the VT Configure Clipboard Settings dialog box.

When enabled, this setting retains formatting so that copied text is pasted in the same way as it is displayed in the terminal.

2.4 Importing

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

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

2.5 Actions

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.

Previous to this enhancement, actions were always added at the end of the sequence.

Added the ability to map the mouse wheel Up or Down actions to Reflection Desktop 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.

The themeSettingsAction and ManageRibbonSettings actions now allow you to specify which theme or ribbon file to use in a session

Added the setKeyboardMapAction, showQuickPadAction, and setHotSpotFileAction actions

These actions can now be assigned in the Select Actions dialog box. They allow you to select which items (for example, which keyboard map) to use for a session.

Added the "ToggleLogging" Action for VT terminals

2.6 Toolbars

Added an option to remove the image displayed on a menu or toolbar item in the Classic UI Designer

The UI Designer now has a Remove Image button that you can use to remove the image.

Added the ability to display Label text on a toolbar button in Classic user interface modes.

Before this fix, if you tried to add a new button with text in its Label field, the text was not displayed.

Added ability to change the order of toolbars in the Classic UI Designer

Before this fix, there was no way to change the ordering of toolbars after they were added in the UI Designer. Toolbar ordering was based on the order in which each toolbar was added (or imported) at design time.

 Added the ability to right-click on the toolbar area to open a menu that can be used to hide or setup toolbars.

From this menu, you can:

  • Hide the selected toolbar.

  • Open the Toolbar Selection dialog box from which you can:

    Select which toolbars to display


    Open the Classic UI Designer to modify toolbars.

2.7 Other Improvements

Added HTTP Proxy support for RIBM terminals.

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.

Added the ability to use "Windows Credentials" for an AS400 FTP sign-on

3.0 Resolved Issues

Reflection Desktop includes software fixes that resolve several previous issues.

3.1 API and Scripting

A Host HLLAPI application no longer fails when checking data in byte 82 (index 81) of the buffer returned by HLLAPI function 13, CopyOIA

Changed the value that Reflection returns 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.

Layouts which contained Extra! basic macros now send data to the correct sessions

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.

Reflection Desktop no longer 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.

Fixed problems with Reflection VBA that allowed users to run macros or .NET API programs to circumvent the DisableBuiltInFiles setting.

Fixed random crashes that occurred when closing the workspace after running an external legacy RMA macro or macros in an SSH host session.

Fixed problem with the Run Legacy Extra! macro action that occurred when attempting to run a macro with macro data

The WaitForStrings return value for legacy Reflection VBA projects now returns the expected value.

The WaitForStrings2() function now returns the position of the string in the array instead of the index number.

Fixed problems with IBM Personal Communications macros that included text strings with German Umlauts or other, non-ASCII characters.

Those characters were not translated properly when Reflection Desktop was running those macros and this resulted in issues on the Host screens and applications.

Problems that caused recorded macros to fail on Japanese hosts have been fixed

Extra! .ftb files for AS/400 SQL data transfers now work as expected

Using Extra! .ftb files that contained custom SQL commands resulted in errors In Reflection Desktop. This error occurred only when using .ftb configurations that contained custom SQL statements.

Problems with using events in Reflection HP sessions are fixed

Problems with using .ftp or .xto files with uppercase file extensions are fixed.

Fixed problems with saving legacy macros and forms when Reflection Host sessions were saved as session Template files.

Macros and forms under the ProjectLegacy() section are now saved in Template files.

The Legacy RIBM API method GetMacroList() now returns the expected value.

GetMacroList() now works as expected and returns a comma delimited list of all the macro names in a session.

The Legacy VBA Wait method, via global syntax, now waits for seconds rather than milliseconds.

The unit of the global Wait method parameter is now seconds instead of milliseconds.

The VBA ReadLine2() method now honors the Linefeed character and does not concatenate lines that should be separated.

This method now works as expected.

The ThisTerminal.VBProject property now points to the correct VBA project

ThisTerminal.VBProject was not pointing to the active document's VBProject but to the VBProject of the document that was last opened in the workspace. This property now points to the correct project.

Modified how legacy code is imported to address problems with methods called without a reference to a session object

This legacy code is now modified when it is imported so that it works in Reflection Desktop. If a method is called without a reference to a session object, the code is modified to precede the method with ThisSession.

3.2 QuickPads

Docking locations of QuickPads are now saved when QuickPads are closed and re-selected

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

Docking locations of toolbars within the Classic user interface modes are now preserved when a session is saved and reopened.

When using a black background in QuickPad Designer, text and group boxes are now 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 no longer shrink after switching sessions

Fixed problems with QuickPads shrinking after switching sessions.

The Show ToolTips setting in the Manage QuickPads dialog box now works as expected

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

3.3 Toolbars

Imported small toolbar buttons now maintain their original size and image

In the Ribbon UI Designer, when importing an .etb file with Use small buttons selected, some images (like Back, Forward, Live Screen, Send File, Receive File, SendKey, Capture etc) changed to the large size of the image or to a different image when they were clicked.

Only Toolbars which are not hidden in legacy Reflection VT session files were imported into Reflection Desktop

All toolbars are now imported.

Imported toolbar buttons no longer display an image if original buttons did not have one

Docking locations of toolbars in Classic user interface modes are now preserved when a session is closed and reopened

Before this fix, the toolbars were stacked vertically when a session was reopened instead of maintaining the positions that they were previously arranged and saved in.

Imported VT session toolbars are now ordered correctly when they are located in the right and bottom panels in the Classic user interface modes

When legacy Reflection VT sessions were imported, docked toolbars at the bottom of the Host session were not displayed in the same order as they were in legacy Reflection. This problem also occurred if the toolbars were docked on the right side of the session. Toolbars that were located in these locations are now displayed in the same order as in legacy Reflection.

3.4 User Interface

The Classic user interface modes now support icons for menu items

Menus now display icons by default.

Problems with sessions showing the wrong custom menu bars and toolbars when sessions with different terminal types were opened in Classic user interface modes have been fixed

The Preview button in the Classic UI designer now works 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 legacy Reflection toolbars that were mapped to unsupported actions are now imported to the Ribbon.

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

3.5 Settings

After importing a theme file from a Reflection 14 session, the theme file is now available for selection before the session is saved in the Reflection Desktop file format

If a session uses a custom keyboard, mouse, hotspots, or theme file, the currently selected file is now displayed in the selection dialog box

This service pack fixed problems with custom file selection. In previous versions, the selection dialog box always opened with the built-in files displayed.

Now, after selecting a custom file, that file is selected and displayed in the list when the dialog box used to select the file is reopened. If a compound session document file is used, these files are shown as Embedded.

Problems with closing VT terminal sessions that occurred after enabling the "Support graphics" checkbox have been fixed.

3.6 Importing and handling Extra! and legacy Reflection files

Problems that occurred when saving legacy .r2w or .rsf files that contained parenthesis characters are now fixed.

3.7 Other Issues

IBM 5250 External Program commands containing spaces no longer fail 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.

Problems that prevented the Workspace from opening after companion MSIs for all users were installed are fixed

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

Problems that occurred when an IBM 3270 printer session was loaded via the IBM 3270 printer association are fixed.

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.

Problems that caused random crashes that occurred in the Reflection “Send Text" action when sending hundreds of words are fixed.  

Problems with using the File > Save As… menu command that occurred when using redirected MyDocuments on slow network connections are fixed

Before this fix, the File > Save As… menu command failed to save session files when the user’s My Documents folder was redirected to a network share and the network connection was slow.

Problems that occurred when uploading a compound VT session document file to Host Access Management and Security Server that contained a custom Hotspots file are fixed

This error occurred when exiting a Host session that was running within Administrative Web Station (AWS). After selecting Send as a compound session, the following error message was displayed:

An error occurred while saving your document. Please try again or save the document to a different location.

Problems with Copy Append or Copy Input actions that occurred when the NonStop Add-on was installed are fixed

Before this fix, problems occurred if 6530 Copy Append (or Copy Input) actions were added to the desktop QAT, and then clicked in a non-6530 session.

The Enable Centralized Management Server URL field no longer allows invalid URLs to be saved.

Before this fix, if an invalid URL was entered in the Server URL field, the URL was saved, and problems occurred when users tried to create sessions.

Now, if a badly formed URL is entered in the Server URL field, the following message is displayed when the user clicks OK.

The URL you entered is not a valid address...

Fixed problems that occurred when opening a legacy Reflection VT session file that had VBA references to a missing OLB file (a VBA Reference for an object) that was on the original PC but is not on the current PC

3.8 Copy and Paste

Copying a block of text from a spreadsheet into a 5250 terminal session that had numeric-only fields now works as expected

When copying multiple columns of alpha-numeric data from a spreadsheet and pasting them into a 5250 terminal window, errors occurred if the terminal had numeric-only characters. Now, with the Align Text to input fields setting enabled and the Wrap text to next input field disabled, data is pasted across columns and honors the field attributes.(alpha characters are not pasted in numeric only fields).

4.0 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.

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

5.0 Previous Releases

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

6.0 Contacting Micro Focus

For specific product issues, contact Micro Focus Support at

Additional technical information or advice is available from several sources:

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