Environment
Reflection Desktop (including Pro, or for IBM) 16.1
Reflection Desktop (including Pro, or for IBM) 16.0
Reflection Desktop (including Pro, or for IBM) 16.0
Situation
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.
Resolution
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.
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-Product | Legacy Host session file extension | Conversion Report File |
| EXTRA! 9.x | EDP | legacy_EDP.txt |
| Reflection 14.x | RSF | legacy_RSF.txt |
| Rumba 9.x | WDM | Rumba.txt |
| Rumba 9.x | WDA | Rumba.txt |
Sample of conversion file generated
| Legacy Field | Legacy Value | Reflection Desktop Field | Reflection Desktop Value | Converted |
| rcHostName | host.microfocus.com | Host | host.microfocus.com | X |
| rcXfrHostCmd | IND$FILE | XfrHostCmd | IND$FILE | X |