Determine host settings converted when migrating legacy Host session Files to Reflection Desktop 16

  • 7022884
  • 24-Apr-2018
  • 02-May-2018


Reflection Desktop (including Pro, or for IBM) 16.1
Reflection Desktop (including Pro, or for IBM) 16.0


This article describes how to determine which existing IBM display session settings were migrated when opening a legacy Host session file in Reflection Desktop 16.  A conversion report can be generated when migrating legacy 3270 and AS/400 host session files from EXTRA! 9.x, Reflection 14.x, and Rumba 9.x.


Reflection will automatically migrate legacy Host session files and a conversion report can be generated which shows the settings that have or have not been converted.  If the legacy display session setting does not have an equivalent in Reflection, it is not converted.

To convert legacy IBM display session files in Reflection, follow these steps:

        1. Locate and launch the display session file in Reflection.

        2. Examine the connection and terminal properties, the converted settings, in Reflection.

        3. Save the settings in Reflection in the new session file format.
           When closing the Host session in Reflection a prompt will apeear that says "Do you want to save changes to <sessionName>.
           Answer Yes and enter the appropriate new file name with extension *.RD3X or *.RD5X .

Follow the steps below to create a conversion report:

        1. Start Reflection from the command line using the –legacyreport option.

                For example:
                        "C:\Program Files (x86)\Micro Focus\Reflection\Attachmate.Emulation.Frame.exe" -f "<sessionName>" –legacyreport

            The other option is to open the Attachmate.Emulation.Frame.exe with the -legacyreport command line option
            and then each time a legacy Host session file is opened from the Reflection Workspace via the File / Open menu
            the conversion report will be generated.

        2. Open the conversion report file, located in the My Documents folder on the workstation, and examine the converted session settings.
            See Additional Information for the conversion report file name, which is different for each product session file converted.
            The report is in a comma-delimited format, so is best viewed in a spreadsheet program, such as Microsoft Excel.

Each time a session file is converted the new output file will overwrite the existing file.  Thus to retain the conversion information for each session, rename the output report file in the My Documents folder between each conversion.

Additional Information

Supported Products for the -legacyreport option
Legacy-ProductLegacy Host session file extension
Conversion Report File
EXTRA! 9.x
Reflection 14.x
Rumba 9.x
Rumba 9.x

Sample of conversion file generated
Legacy Field
Legacy Value Reflection Desktop FieldReflection Desktop ValueConverted