Product Documentation

Configuring Desktop and Program Shortcuts for Local App Access

May 06, 2015

When a user connects to a hosted desktop, XenApp retrieves shortcuts to local applications and user-hosted applications from the local desktop and displays them on the hosted desktop.

You can configure how XenApp retrieves these shortcuts and where they are placed by modifying registry settings on the XenApp server. users modify a registry setting on their computers that specifies where local Desktop shortcuts are stored.
Caution: Editing the registry incorrectly can cause serious problems that may require you to reinstall your operating system. Citrix cannot guarantee that problems resulting from the incorrect use of Registry Editor can be solved. Use Registry Editor at your own risk. Be sure to back up the registry before you edit it.

To enable retrieval of local Desktop shortcuts

Use this procedure to enable XenApp to retrieve local Desktop shortcuts from users' computers.

  1. On the XenApp server, create the following registry key value:
    • Key: HKCU\Software\Citrix\Local Access Apps
    • Name: DesktopCHSEnabled
    • Value type: DWORD (32-bit)
    • Value: 1 (enabled - default)

To specify the folder path for local Desktop shortcuts

Users use this procedure to specify where their computers store local Desktop shortcuts. XenApp uses this location to retrieve the shortcuts and place them on the hosted desktop. If XenApp finds a shortcut with the same name in multiple folders, XenApp retrieves the shortcut found last. If XenApp cannot find the folder path specified, XenApp retrieves standard Windows desktop shortcuts. If no folder path is specified, XenApp does not retrieve any shortcuts.

  1. On the user's computer, create the following registry key value:
    • Key: HKCU\Software\Citrix\ICA Client\CHS
    • Name: DesktopFolders
    • Value type: Multi-string
  2. Double-click the registry value and type the path to the folder containing shortcuts from the local desktop. You can also specify environment variables for the folder path.

To specify the hosted folder name for local Desktop shortcuts

Use this procedure to specify the folder where XenApp places local Desktop shortcuts upon retrieval. If the folder name you specify already exists, no folder is created. If the registry value is blank, no shortcuts are added to the folder.

  1. On the XenApp server, modify the following registry key value:
    • Key: HKCU\Software\Citrix\Local Access Apps
    • Name: DesktopCHSFolderName
    • Value type: String
    • Default Value: Local Desktop
  2. Double-click the registry value and type the folder name you want to use.

To merge local Desktop shortcuts with hosted Desktop shortcuts

Use this procedure to collect all Desktop shortcuts, local and hosted, in the same folder. If XenApp encounters a shortcut with the same name as an existing shortcut, XenApp does not add a new shortcut.

By default, this setting is disabled (0).

  1. On the XenApp server, modify the following registry key value:
    • Key: HKCU\Software\Citrix\Local Access Apps
    • Name: DesktopCHSMerge
    • Value type: DWORD (32-bit)
    • Value: 1 (enabled)

Configuring Programs Shortcuts for Local App Access

When a user connects to a hosted desktop, XenApp retrieves shortcuts to local applications and any user-hosted applications from the local Programs menu and displays them in the Programs menu on the hosted desktop.

You can configure how XenApp retrieves these shortcuts and where they are placed by modifying registry settings on the XenApp server. users modify a registry setting on their computers that specifies where local Programs shortcuts are stored.
Caution: Editing the registry incorrectly can cause serious problems that may require you to reinstall your operating system. Citrix cannot guarantee that problems resulting from the incorrect use of Registry Editor can be solved. Use Registry Editor at your own risk. Be sure to back up the registry before you edit it.

To enable retrieval of local Programs shortcuts

Use this procedure to enable XenApp to retrieve local Programs shortcuts from users' computers.

  1. On the XenApp server, modify the following registry key value:
    • Key: HKCU\Software\Citrix\Local Access Apps
    • Name: ProgramsCHSEnabled
    • Value type: REG_DWORD
    • Value: 1 (enabled - default)

To specify the folder path for local Programs shortcuts

Users use this procedure to specify where local Programs shortcuts are stored on their computers. XenApp uses this location to retrieve the shortcuts and place them in the Programs menu on the hosted desktop. If XenApp finds a shortcut with the same name in multiple folders, XenApp retrieves the shortcut found last. If XenApp cannot find the folder path specified, XenApp retrieves standard Windows Programs shortcuts. If no folder path is specified, XenApp does not retrieve any shortcuts.

  1. On the user's computer, modify the following registry key value:
    • Key: HKCU\Software\Citrix\ICA Client\CHS
    • Name: ProgramsFolders
    • Value type: Multi-string
  2. Double-click the registry value and type the path to the folder containing shortcuts from the local Programs menu. users can also specify environment variables for the folder path.

To specify the hosted folder name for local Programs shortcuts

Use this procedure to specify the folder where XenApp places local Programs shortcuts upon retrieval. If the folder name you specify already exists, no folder is created. If the registry value is blank, no shortcuts are added to the folder.

  1. On the XenApp server, modify the following registry key value:
    • Key: HKCU\Software\Citrix\Local Access Apps
    • Name: ProgramsCHSFolderName
    • Value type: String
    • Default Value: Local Programs
  2. Double-click the registry value and type the folder name you want to use.

To merge local Programs shortcuts with hosted Programs shortcuts

Use this procedure to collect all Programs shortcuts, local and hosted, in the same folder. If XenApp encounters a shortcut with the same name as an existing shortcut, XenApp does not add a new shortcut.

By default, this setting is disabled (0).

  1. On the XenApp server, modify the following registry key value:
    • Key: HKCU\Software\Citrix\Local Access Apps
    • Name: ProgramsCHSMerge
    • Value type: DWORD (32-bit)
    • Value: 1 (enabled)

Controlling Availability of Shortcuts and Applications in Sessions

To help maintain the availability of resources in your XenApp environment, you can limit the number of shortcuts the XenApp server enumerates and the number of self-hosted applications a user can launch in a given session. To do this, you modify registry entries on the XenApp server and on the user's computer.
Caution: Editing the registry incorrectly can cause serious problems that may require you to reinstall your operating system. Citrix cannot guarantee that problems resulting from the incorrect use of Registry Editor can be solved. Use Registry Editor at your own risk. Be sure to back up the registry before you edit it.

To control the number of shortcuts that are available in a session

Use this procedure to specify the number of shortcuts that the XenApp server can enumerate in a session. When users connect to hosted desktops, XenApp enumerates Desktop shortcuts first, then enumerates shortcuts in the Programs menu.

  1. On the XenApp server, modify the following registry key value:
    • Key: HKLM\Software\Wow6432Node\Citrix\Local Access Apps
    • Name: CHSShortcutEnumerationLimit
    • Value type: REG_DWORD
    • Default Value: 250

To control the number of user-hosted applications launched in a session

Use this procedure to specify the number of self-hosted applications that users can launch in a session. If a user attempts to launch applications in excess of the configured limit, the applications do not launch and the user receives no feedback about the failure. However, the XenApp server logs a CDF error trace message.

  1. On the user's computer, modify the following registry key value:
    • Key: HKLM\Software\Citrix\ICA Client\RSM
    • Name: SessionApplicationLimit
    • Value type: REG_DWORD
    • Default Value: 100