CTX122536 – Program Neighborhood will no longer be supported.

Description

The Citrix Online Plug-in v11.0 is the last version to use Program Neighborhood and it no longer installs Program Neighborhood by default.

Version 11.1 no longer includes Program Neighborhood at all. While Program Neighborhood will still be supported in both of those versions, customers are encouraged to begin planning to adopt a newer client version or migrate to Citrix Receiver. Since the v11.2 online plug-in release, Program Neighborhood will no longer be supported.

Citrix Quick Launch offers some features of Program Neighborhood for users of the recent Citrix Online Plug-in releases. While it will also work with older releases, its purpose is to be used in conjunction with Citrix Online Plug-in version 11.0 and later.

This tool offers a simplified and easy interface to connect to any XenApp server or its published applications over the ICA protocol.

For more information on Program Neighborhood removal, consult CTX121727 – Citrix Program Neighborhood Feature Removal Announcement FAQ

Prerequisites

• Version 7.0 or later of the Presentation Server Client/XenApp Plugin for 32-bit Windows is required on the system where the tool is launched.
• For application enumeration, make sure the file neHttpN.dll (when using TCP/IP+HTTP as browsing protocol) or the file neTCPn.dll (when using TCP/IP as browsing protocol) are present in the Presentation Server Client/XenApp Plugin folder
• The file TABCTL32.OCX must be registered on the system. This file is included on Microsoft Windows XP but not present on newer Microsoft Windows releases. It is not included in the Citrix Quick Launch ZIP file.

Installing Citrix Quick Launch

1. Extract the contents of the zip file to a folder.
2. If the file TABCTL32.OCX is not registered properly, you receive the following error message:
   “Run-time error ‘339’:
   Component ‘tabctl32.ocx’ or one of its dependencies not
   correctly registered: a file is missing or invalid”
   To register the file on the server, run the following command as administrator
   regsvr32 “path to the filetabctl32.ocx”
3. If the Citrix Online Plug-in is not installed on the computer, you receive the following error message:
   “Component ‘Wfica.ocx’ or one of its dependencies not correctly registered: a file is missing or invalid”

Note: This tool was tested to create ICA sessions against Citrix Presentation Server 4.0, XenApp 4.5, XenApp 5.0 for Windows 2003, XenApp 5.0 for Windows 2008 (32-bit and 64-bit editions), XenApp 6.0 for Windows Server 2008 R2, XenApp 6.5 for Windows Server 2008 R2 and XenDesktop 5.x in HA mode from workstations running Windows 2000, Windows XP, Windows Vista, and Windows 7 (32-bit and 64-bit edition).

While the tool might work with legacy Citrix server releases (such as MetaFrame Presentation Server 3.0, MetaFrame XP, MetaFrame 1.x), it has not been fully tested.

How to Use Citrix Quick Launch

When running the Citrix Quick Launch tool, you can specify the server name or IP address. The tool offers a drop-down list where you can select a previous server.

The following actions are then possible:

1. Click Connect… to initiate an ICA session to this server.
2. Click Write ICA File to create an ICA file for later use.
3. Click Options >> to access additional features.

When the Options button is clicked, the tool offers additional features to configure.

Note: When running on a machine with a Citrix Online Plug-in version 11.2 or later, UDP Browsing has been removed from this release therefore the only browsing protocol available if TCP/IP over HTTP. The XML Service port needs to be specified. More information can be found in CTX123616 – ICA Client Object Changes in the Version 11.2 XenApp Plug-in

s

If the machine has an older version of the Citrix Online Plug-in, the expanded view offers the choice between TCP/IP (UDP Browsing) and TCP/IP+HTTP (XML Browsing) as shown below:

The tool offers the possibility to connect directly to the server’s desktop (default setting when the Options are not displayed) or a published application in the farm.

To browse the published applications, the correct browsing mechanism should be selected (refer to the note above for Citrix Online Plug-in version 11.2 and later).

In the case of XML Browsing, make sure the XML Service port is correct.

Note: The Launch on this server option (when selecting a published application) bypasses the load balancing mechanism by directly connecting to the XenApp server specified in the Server field above.

When a published application is selected, the engine uses seamless mode by default while the ICA session is started in a fixed size window if connecting to a server’s desktop.

Using the tool with XenDesktop 5 High Availability Mode

When selecting the XenDesktop 5 option, the warning below appears:

“The target machine must be in High Availability Mode.
Consult CTX127392 and the XenDesktop 5 section on eDocs.”

More information about this mode can be found in CTX127392 – How to Create ICA Launch Files for High Availability Mode

Features

Several features can be enabled or disabled from the Session Options tab:

The tool uses the same default settings as Program Neighborhood did. The local drives and printers are available inside the session, based on the configuration of the Citrix Policies.

Note: The Citrix Desktop toolbar is On, by default.

Some SpeedScreen Latency Reduction features can be configured in the SpeedScreen tab.

The hotkeys can be configured in a separate window:

If the Prevent closure with active sessions is enabled and ICA sessions are launched from the tool afterward (and still active), the message below appears when closing the tool, prompting for a confirmation.

“Active ICA session(s) are detected.
Do you really want to quit?
Note: the ICA session(s) will be logged off”

If you click the Yes button, all the ICA sessions opened using the tool are logged off.

When the tool is closed, the servers names, XML port, username, domain, selected options, display resolution, modified hotkeys and tool closure behavior are saved in the registry in:
HKEY_CURRENT_USERSoftwareCitrixCitrixQuickLaunch.

Command Line arguments >

The Citrix Quick Launch tool supports command line arguments to connect directly to a server or a published application over an ICA session, without displaying the user interface, using default settings for the ICA session.

To connect to a server without the user interface, run the command below:
citrixquicklaunch.exe /s:<servername>

where:
<servername> is the name or IP address of your XenApp server
The session initializes inside a 1024×768 window, using 24-bit color depth. Printers and drives are autocreated, based on the configuration of Citrix Policies. No specific encryption setting can be used.

To connect to a published application without the user interface, run the command below:
citrixquicklaunch.exe /s:<servername>:<XMLport> /a:<name of published application>

where:
<servername> is the name or IP address of your XenApp server.
<XMLport> is the XML server port number of the XenApp server (not required if the default TCP 80 port is used)
<name of the published application> is the name of the published application you wish to connect to. The name does not need to be enclosed within quotation marks. It is important to write carefully the name of the published application, otherwise the ICA session fails to launch.
The published application starts inside a seamless session, using 24-bit color depth. Printers and drives are autocreated, based on the configuration of Citrix Policies. No specific encryption setting can be used.

Troubleshooting Issues with Citrix Quick Launch

If an error occurs, it is possible to run DebugView (from www.sysinternals.com) beside Citrix Quick Launch to capture traces.

Security Permissions Required by Citrix Quick Launch

No special permissions required for the user.

Data Modified by Citrix Quick Launch

The server name, xml port, tool closure behavior, selected options, display resolution, username and domain are saved in the user’s hive of the machine where the tool is launched at the below location :

HKEY_CURRENT_USERSoftwareCitrixCitrixQuickLaunch

Uninstalling Citrix Citrix Quick Launch

1. Delete the folder where you unzipped the files.
2. Delete the following registry key, added by the tool:
   HKEY_CURRENT_USERSoftwareCitrixCitrixQuickLaunch
3. The file MSTAB32.OCX, required by the tool, can be deleted only if no other applications require it.

Contact Information

Questions? Concerns? Send any feedback for this tool to supporttools@citrix.com.

Disclaimer

This software application is provided to you “as is” with no representations, warranties or conditions of any kind. You may use and distribute it at your own risk. CITRIX DISCLAIMS ALL WARRANTIES WHATSOEVER, EXPRESS, IMPLIED, WRITTEN, ORAL OR STATUTORY, INCLUDING WITHOUT LIMITATION WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, TITLE AND NONINFRINGEMENT. Without limiting the generality of the foregoing, you acknowledge and agree that (a) the software application may exhibit errors, design flaws or other problems, possibly resulting in loss of data or damage to property; (b) it may not be possible to make the software application fully functional; and (c) Citrix may, without notice or liability to you, cease to make available the current version and/or any future versions of the software application. In no event should the code be used to support of ultra-hazardous activities, including but not limited to life support or blasting activities. NEITHER CITRIX NOR ITS AFFILIATES OR AGENTS WILL BE LIABLE, UNDER BREACH OF CONTRACT OR ANY OTHER THEORY OF LIABILITY, FOR ANY DAMAGES WHATSOEVER ARISING FROM USE OF THE SOFTWARE APPLICATION, INCLUDING WITHOUT LIMITATION DIRECT, SPECIAL, INCIDENTAL, PUNITIVE, CONSEQUENTIAL OR OTHER DAMAGES, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. You agree to indemnify and defend Citrix against any and all claims arising from your use, modification or distribution of the code.

v2.5

This document applies to:

• Feature Pack 1 for Presentation Server 4.5
• Presentation Server 4.0 for Microsoft Windows 2000
• Presentation Server 4.0 for Microsoft Windows 2003
• Presentation Server 4.5 for Windows Server 2003
• Presentation Server 4.5 for Windows Server 2003 x64 Edition
• XenApp 5.0 for Windows Server 2003 x64
• XenApp 5.0 for Windows Server 2003 x86
• XenApp 5.0 for Windows Server 2008 x64
• XenApp 5.0 for Windows Server 2008 x86
• XenApp 6.0 for Windows Server 2008 R2
• XenApp 6.5 for Windows Server 2008 R2
• XenApp Plug-in for Windows (32/64 Bit)
• XenDesktop 5 x32
• XenDesktop 5 x64
• XenDesktop 5.5 x32
• XenDesktop 5.5 x64

Source: CTX122536 – Citrix Quick Launch – Citrix Knowledge Center