Known Issues

These issues have been identified in previous releases and are known issues.

Browser issues

The following notes are specific to different web browsers.

Recommended browsers

It is highly recommended that you use Google Chrome or Mozilla Firefox. While Reflection ZFE supports Microsoft Internet Explorer (IE) 11, there are known performance issues with Internet Explorer’s JavaScript engine that may negatively affect the end user experience with Reflection ZFE.

These issues have been identified and have remedies, however the easiest solution is to use a different browser.

Internet Explorer Unable to Play Recorded Reflection ZFE Macros

When using certain older versions of Microsoft Internet Explorer (IE) web browser with Reflection ZFE, attempts to playback macros may fail with an error. The error message reads: Macro Error: Error transpiling macro code: TypeError: unknown: Circular reference in value argument not supported.

This is a problem with this version of Internet Explorer and JavaScript. It may be possible to avoid this error if you delete the createMacro() function and replace it using JavaScript Promises (for example, then() ).

Because this issue is specific to early versions of Internet Explorer, the easiest solution to this problem is to use a different browser (Chrome or Firefox) or a more recent version of Internet Explorer. You can successfully play back macros using Internet Explorer version 11.0.9600.18161, update version 11.0.27. Run Windows Update to update Internet Explorer.

HTTPS connections between Apple iOS mobile devices and the Reflection ZFE session server

Reflection ZFE users cannot connect to a session server over HTTPS from their Apple iPad when using a self-signed certificate. If feasible, the quickest solution is to use HTTP instead of HTTPS.

If HTTPS is needed, you have the following options:

  • Obtain a valid certificate signed by a trusted CA and install it on the session server.

  • Find an alternate browser that will accept the self-signed certificate. See System Requirements for a list of supported browsers.

  • Leverage a custom certificate authority:

    1. Create a custom CA, CA root certificate, and a server certificate signed by that CA’s root certificate.

    2. Install the server certificate on the session server.

    3. Install the custom CA root certificate on the iPad by means of a profile. The iPad should now accept the server certificate as it was signed by a “trusted CA”.

    For a list of CAs trusted by Apple iOS, see Lists of available trusted root certificates in iOS.

Internet Explorer Displays Blank Screens

When using the Microsoft Internet Explorer (IE) web browser with Reflection ZFE (RZFE) or Host Access Management and Security Server (MSS), you may see a blank screen instead of the expected session.

When using Microsoft Internet Explorer to access Reflection ZFE sessions or Host Access Management & Security Server, you may experience issues such as the following:

  • Reflection ZFE renders properly for some URLs and not others (a blank screen is displayed). The behavior varies depending on whether the ZFE session is using an IP address, short hostname, or fully-qualified name.

  • In MSS, you can’t create or open a ZFE session unless that session is on the same server as MSS. A blank screen displays where you expect to see the session.


This issue is specific to the way Internet Explorer toggles various settings depending on its interpretation of website security. The settings in question are Compatibility View and Third-party Cookies. Depending on what “zone” Internet Explorer determines your web site to be in, these settings need to be either enabled or disabled. Internet Explorer bases its determination on the site URL. For example, if the server name in the URL does not contain dots (for example, http://mycorporateserver/mss/AdminStart.html), Internet Explorer assumes the address belongs in the Local Intranet zone. If it does, the site is assigned to the Internet zone.


Internet Explorer Default Settings

Local Internet Zone

Compatibility View enabled (not desired)

Third-party Cookies enabled (desired)

Internet Zone

Compatibility View disabled (desired)

Third-party Cookies disabled (not desired)

While it is possible for a website to override Compatibility View by specifying Document Mode with an X-UA-Compatible meta HTML tag, and Reflection ZFE does use that particular mode, MSS does not. Thus, if a Reflection ZFE server and a Management and Security Server are both in the Local Intranet zone (with default Compatibility View enabled), it is likely that Reflection ZFE would still perform correctly, but MSS would not. See for more information.


To use Internet Explorer 10 or 11 with ZFE and MSS servers, you need:

  • Compatibility View disabled

  • Third-party Cookies enabled

You need to determine what zone your web site is in and then make the necessary adjustments to the Internet Explorer settings. Because Internet Explorer can be configured in so many different ways depending on your situation, it is hard to provide one solution for successfully using Internet Explorer with Reflection ZFE and MSS. These are some possible configurations to follow:

  • If both RZFE and MSS are in the Internet zone, manually add the RZFE server to the Local Intranet or Trusted Sites zone (Internet Options > Security > Local intranet > Sites). Use fully qualified host names or IP addresses.

  • If both servers are in the Internet zone, change the default behavior for that zone and enable Third-party Cookies (Internet Options > Privacy > Advanced > Override automatic cookie handling).

  • If both servers are in the Local Intranet zone, change the default behavior for that zone and disable Compatibility View (Tools > Compatibility View settings).

Key mapping issues with different browsers

Certain keys on a numeric keypad and some browser-specific keys cannot be mapped. For example, in Chrome, Ctrl+n and Ctrl+w cannot be mapped.

Host specific issues

The following are issues that are specific to different host types.

Displaying the Euro character

If the EURO character does not display correctly on the terminal screen, talk to your system administrator to make sure the host character set for the session is setup correctly. By default, Reflection ZFE uses a character set which does not support the Euro character (€). To display the Euro character, change the character set to one that supports the Euro character.

Issues encountered with VT hosts



Performance issues

  • Heavy text output, such as form “Is-IR” may cause slow performance

  • Scrolling regions may appear slow or choppy

  • Cursor movememnt may be slow or choppy

  • Internet Explorer is particularly slow, and performance degrades further when used for rows and columns.

Character sets

  • Graphical characters and some character sets are not supported.

  • Some non-English characters may cause the terminal display to freeze.

Other VT issues

  • Insert/delete column (DECIC, DECDC) may fail.

  • VT400 will not recognize DECSCL.

Field outlines in 3270 sessions

The 3270 attributes for field outlines are not fully supported. Reflection ZFE currently supports underline and overline; however, left vertical line, right vertical line, and combinations of the four line types are not yet supported.