How to Create a Desktop Shortcut for Your Session Document in Reflection

  • 7021438
  • 14-Jan-2015
  • 04-Jun-2018


Reflection Desktop (including Pro, for X, for IBM, or for UNIX and OpenVMS) 16.0 or higher
Reflection 2014
Reflection Pro 2014
Reflection for IBM 2014
Reflection for UNIX and OpenVMS 2014
Reflection X 2014


Windows shortcuts are typically created on the user's desktop for quick access to Reflection Host sessions. This technical note outlines target options and best practices for creating shortcuts with Reflection Desktop or Reflection 2014.


How to Create a Shortcut in Windows

To create a shortcut for a Reflection Desktop or Reflection 2014 Workspace or Host session, you will complete the following steps:

  1. Choose a final destination directory for your shortcut, and open the directory in Windows Explorer.
  2. Right-click an open area in the directory and click New > Shortcut.
  3. Type the location of your file in the blank field, or select it from Browse, and click Next. See What Do I Want My Shortcut to Open? for more information on shortcut targets.
  4. Type a name for the shortcut, and click Finish.
  5. (Optional) See Shortcut Icons to choose from a list of icon options for your shortcut.

What Do I Want My Shortcut to Open?

The following shortcut target options can be used to quickly access the Reflection Workspace or specific Host sessions.

Reflection Workspace

Create a Windows shortcut with the target of Attachmate.Emulation.Frame.exe in the C:\Program Files (x86)\Micro Focus\Reflection folder (Reflection Desktop) or the C:\Program Files (x86)\Attachmate\Reflection folder (Reflection 2014).

This type of shortcut will load and run the Reflection Workspace, but no specific Host session document will load. Use this option if you want to either create a new session or open a recently used one.

Reflection Workspace with Command Line Options

To open a Reflection Workspace with a session document, create a Windows shortcut with the target of Attachmate.Emulation.Frame.exe using the supported command line options:

Attachmate.Emulation.Frame.exe" -f "<sessionPath><sessionName>

For example:

"C:\Program Files (x86)\Attachmate\Reflection\Attachmate.Emulation.Frame.exe" -f "C:\Users\myUserName\Documents\Attachmate\Reflection\mysession.rd3x"

See for additional information about specifying Reflection startup behavior and appearance from the command line.

Note: Do not create a shortcut using legacy r2win.exe, r4win.exe, or r8win.exe, as it will neither open a Reflection Workspace nor open a new Host session that can be configured.

Reflection Host Session Document

Create a shortcut with the target being a Reflection session document (*.r2w, *.rsf, *.rdox, or *.rd3x) or any other legacy Host session settings file supported by Reflection. (For a full list of supported legacy file types supported by Reflection Desktop and Reflection 2014, see Technical Note

This shortcut will load the specific Host configuration information defined in the session document. The Host session settings file should be saved in a Trusted Location that has previously been defined, otherwise located in the C:\Users\<username>\Documents\Micro Focus\Reflection folder. or C:\Users\<username>\Documents\Attachmate\Reflection folder.

Note: If the session file is moved to the Windows Desktop or another location, set it as a Trusted Location. Otherwise, you will see an error similar to the following:

Figure 1. Reflection Workspace dialog: 'Unable to open ... because it is not in a trusted location'

To learn more about adding trusted locations, see

Multiple Host Session Documents

To open multiple Host sessions in the same Reflection Workspace, go to File > Reflection Workspace Settings > Configure Workspace Defaults, and select "Open documents in the same workspace." To open multiple Host sessions in different Reflection Workspaces, make sure the "Open documents in same workspace" option is deselected.

For more information on configurable actions when the Reflection workspace opens or closes, see

Shortcut Icons

There are numerous Reflection icons that can be used for your shortcuts:

Figure 2. Reflection 2014 shortcut icon options

Default Reflection Terminal Icon

To select the Reflection default Terminal icon for the shortcut:

  1. Right-click on the Shortcut.
  2. Click Properties.
  3. Click the "Change Icon" button.
  4. Clear the "Look for icons in this file" field of all its data. Note: You will have to do this twice: once to remove the existing file name, and a second time to remove the Windows default icon file of shell32.dll. Click OK each time.
  5. Click the OK button until the Change Icon dialog disappears.
  6. Press Apply and/or OK to restore the original Reflection icon for the shortcut based on the Windows file association.

Reflection Workspace or Terminal Icon

To select the Reflection Workspace or terminal icon for the shortcut:

     1. Right-click on the Shortcut.
     2. Click Properties.
     3. Click the "Change Icon" button.
     4. Click the Browse button.
     5. Select C:\Program Files (x86)\Micro Focus\Reflection\Attachmate.Emulation.Frame.exe (or C:\Program Files (x86)\Attachmate\Reflection\Attachmate.Emulation.Frame.exe) for the Reflection Workspace icon
         Select r2win.exe or r8win.exe for terminal icons.
     6. Select an icon and click OK.
     7. Click Apply and/or OK.

Additional Information

Legacy KB ID

This document was originally published as Attachmate Technical Note 2709.