Technical Notes

Optimizing Reflection Settings in the Registry for Use in a Windows Terminal Server Environment
Technical Note 1569
Last Reviewed 09-May-2005
Applies To
Reflection for UNIX and OpenVMS version 12.0 through 14.x
Reflection for HP version 12.0 through 14.x
Reflection for ReGIS Graphics version 12.0 through 14.x
Reflection X version 12.0 through 14.x
Microsoft Windows 2000 Server with Terminal Services (with or without Citrix MetaFrame)
Microsoft Windows NT 4.0, Terminal Server Edition (with or without Citrix MetaFrame)
Summary

This technical note provides system administrators with information about changing, both manually and programmatically, the following Reflection settings in the registry: Save Changes on Exit (in Reflection for UNIX and OpenVMS, and Reflection for ReGIS Graphics), Performance Tuner (in Reflection X), and Optimize Ctrl Y (in Reflection for HP). The note also explains how to edit the Reflection registry settings for "all users" in a Windows Terminal Server environment, as opposed to making registry changes for only the current user.

Note: Beginning with Reflection version 13.x, Windows NT is no longer supported.

Warning

Proceed with extreme caution when editing the Windows Registry. It is critical to back up the Registry before you proceed. For full details and warnings regarding editing the Windows Registry, see Microsoft Article 256986:

http://support.microsoft.com/default.aspx?scid=kb;en-us;256986

Saving Reflection Settings

Reflection settings that can be changed are saved in settings files or the registry. Settings saved in the registry are saved per user in HKEY_CURRENT_USER. To make changes for all users in the Windows Terminal Server environment, changes must be made in HKEY_LOCAL_MACHINE. Note: Any changes made to HKEY_LOCAL_MACHINE will not be migrated when Reflection is upgraded.

The following four examples describe how to save specific Reflection settings in the registry for "all users":

Reflection for UNIX and OpenVMS– "Save Changes on Exit"

By default, Reflection users are asked whether or not they want to save changed settings when they exit Reflection. If an administrator does not want changes to be saved, this setting should be set to "Never." This change will be saved in the registry for the current user only.

In the registry, changing "Save Changes on exit" in Reflection for UNIX and OpenVMS from the value of "Ask" to "Never" adds DWORD value "SaveChanges 0x00000000 (0)" to the HKEY_CURRENT_USER\Software\WRQReflection\Rwin\Reflection 2 key. If, however, a different user logs on to the workstation, the HKEY_CURRENT_USER\Software\WRQReflection\Rwin\Reflection 2 key will not have this DWORD value and "Save Changes on exit" will be set to the default of "Ask."

To change this Reflection setting in the Registry and apply it to all users who log on to the Windows Terminal Server, follow the steps below:

1. Open Regedit.exe.
2. In the left panel of the Registry Editor window, navigate to the following location: HKEY_LOCAL_MACHINE\SOFTWARE\WRQReflection\Rwin\Reflection 2.
3. Highlight the Reflection 2 folder.
4. On the Edit menu, select New, and then click DWORD Value.
5. Enter the following values:

Name	SaveChanges
Data	0x00000000 (0)

Reflection for ReGIS Graphics – "Save Changes on exit"

To modify the Reflection for ReGIS Graphics "Save Changes on exit" setting in the registry for all users who log on to the Windows Terminal Server, follow the steps below:

1. Open Regedit.exe.
2. In the left panel of the Registry Editor window, navigate to the following location: HKEY_LOCAL_MACHINE\SOFTWARE\WRQReflection\Rwin\Reflection 4.
3. Highlight the Reflection 4 folder.
4. On the Edit menu, select New, and then click DWORD Value.
5. Enter the following values:

Name	SaveChanges
Data	0x00000000 (0)

Reflection X – "Performance Tuner"

The Performance Tuner offers no value in the Windows Terminal Server environment. To insure that users are never prompted to run the Performance Tuner, follow the steps below for the version of Reflection X you are running.

Note: For a list of technical notes that describe how to install Reflection in Windows Terminal Server environments, see Technical Note 1097.

Version 12.0 or higher:

In version 12.0 or higher, you can choose to:

• not install the Performance Tuner.
• install the Performance Tuner on the console, but disable it for end users.

If you choose to install the Performance Tuner, follow the steps below to edit the Windows registry and disable the Reflection X Performance Tuner.

1. Open Regedit.exe.
2. In the left panel of the Registry Editor window, navigate to the following location: HKEY_LOCAL_MACHINE\SOFTWARE\WRQReflection\Rx\config\Server\.
3. Right-click the Server folder and click New > DWORD Value.
4. Rename the new value to: FirstTimeDialogBehavior
5. Right-click FirstTimeDialogBehavior and click Modify.
6. In the Value data field, enter 1.
7. Exit the Windows Registry Editor.

Note: Further details regarding this topic can be found in the Reflection X online help, under the Index topic Performance Tuner.

Reflection for HP – "Optimize Ctrl Y"

The "Optimize Ctrl Y" setting is used to manage the timing of how Reflection handles an abnormally high number of NS/VT break requests.

To enable the "Optimize Ctrl Y" setting, follow the steps below:

1. Open Regedit.exe.
2. In the left panel of the Registry Editor window, navigate to the following location: HKEY_LOCAL_MACHINE\SOFTWARE\WRQReflection\NSVT.
3. Highlight the Reflection 4 folder.
4. On the Edit menu, select New, and then click DWORD Value.
5. Enter the following values:

Name	OptimizeCtrlY
Data	0x0000001e (30)

Using a Script to Edit the Registry

Attachmate Technical Support created a VBA script, Refregistry.r2w, which can be used to programmatically change the DWORD keys mentioned in the examples above. This script is available in the Support Files section of the Attachmate Download Library: http://support.attachmate.com/downloads/.

Note: You need to do edit the script to point to the specific DWORD key you want to change. For example, if you want to turn off the Performance Tuner prompt in Reflection X 9.x (as described in Example 3), you must modify the script as follows:

To change the rootkey for all users:

Change

rootkey = "HKEY_CURRENT_USER"

To

rootkey = "HKEY_LOCAL_MACHINE"

To select the Reflection product whose registry key you are modifying:

Change

' sSubkey = "Software\WRQReflection\config\Server"

To

sSubkey = "Software\WRQReflection\Rx\config\Server"

Note: Be sure to comment any other Reflection sSubkeys not receiving this registry key change by adding an apostrophe (') at the front of the line.

To choose the specific DWORD values, you must un-comment each affected value by removing the apostrophe (') from in front of the specific keyvalue and ldata values:

Change

'keyvalue = "FirstTimePerf" ' this is for turning off the performance tuner 'ldata = "0" ' set Dword to this value, to have Performance tuner not invoked

To

keyvalue = "FirstTimePerf" ' this is for turning off the performance tuner ldata = "0" ' set Dword to this value, to have Performance tuner not invoked

Related Technical Notes

1097	Index of Windows Terminal Server and Citrix XenApp Topics (Includes Citrix Presentation Server and MetaFrame)