[THIN] KB: CTX086028 - Troubleshooting Client Clipboard Issues
- From: "Jim Kenzig Kenzig.com" <jkenzig@xxxxxxxxx>
- To: thin@xxxxxxxxxxxxx
- Date: Mon, 22 Aug 2005 07:12:44 -0700 (PDT)
CTX086028 - Troubleshooting Client Clipboard Issues
This document was published at:
http://support.citrix.com/kb/entry.jspa?externalID=CTX086028
Document ID: CTX086028, Created on: Apr 12, 2002, Updated: Jul 28, 2005
Products: Citrix MetaFrame XP 1.0 for Microsoft Windows 2000, Citrix MetaFrame
XP 1.0 for Microsoft NT 4.0 Server Terminal Server Edition, Citrix MetaFrame
1.8 for Microsoft Windows 2000, Citrix MetaFrame 1.8 for Microsoft NT 4.0
Server Terminal Server Edition, Citrix MetaFrame XP 1.0 for Microsoft Windows
2003, Citrix MetaFrame Presentation Server 3.0 for Microsoft Windows 2000,
Citrix MetaFrame Presentation Server 3.0 for Microsoft Windows 2003
Follow the troubleshooting steps below.
Overall Limitations
As of MetaFrame XP Service Pack 2 and MetaFrame 1.8 Service Pack 3, features
similar to RDPClip.exe, outlined in Microsoft TechNet article Q309825, support
to drag and drop to/from seamless Windows Explorer in ICA session to/from
Windows Explorer on clients local desktop, and Copy and Paste from two unique
ICA sessions are not available. For the last item, the first session must be
copied to the local workstation and then recopied from the local workstation to
the second unique session.
General Troubleshooting Steps
1. Start Citrix Connection Configuration.
Highlight the ICA-TCP port and go to Connection > Edit.
Click the Client Settings tab.
In the Client Mapping Overrides section on the right, check to see if Disable
Client Clipboard Mapping is checked. If it is and you want the clipboard to
map, uncheck the checkbox. If the checkbox is not checked, go to Step 2.
2. If you look at a user?s session in Citrix Server Administration or Terminal
Server Administration, is Wfshell.exe running? If not, run regedt32.
WARNING! Using Registry Editor 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. For information about how to edit the
registry, view the "Changing Keys and Values" Help topic in Registry Editor
(Regedit.exe) or the "Add and Delete Information in the Registry" and "Edit
Registry Data" Help topics in Regedt32.exe. Make sure you back up the registry
before you edit it. If you are running Windows NT, also update your Emergency
Repair Disk (ERD).
Go to this registry key:
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\WinLogon
In the Value of AppSetup, is Cmstart.exe present? If not add it.
appsetup: REG_SZ: cmstart.exe
Cmstart.exe is a process that runs when you log on to the MetaFrame server. It
is associated with Wfshell.exe. In addition, only for Window NT 4.0 Terminal
Servers, ensure the USERINIT string value contains wfshell.exe.
3. Verify wfshell.exe is running as a process under the session.
See CTX103602 ? Session sharing and cut and paste fails on Windows 2003 Server
and Feature Release 3..
4. Verify that the registry includes a subkey under
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Citrix\Wfshell named
Virtual Clipboard and the subkey has two values: DllName and NotifyEvent, both
of type REG_SZ and respective entries of Vclipbd.dll and WfshellVclipbdNotify.
5. Verify Vclipbd.dll is on the system drive.
6. For Windows 2003, Does 840872 apply?
7. Does CTX104631 ? How to Repair Clipboard Functionality fix the issue?
8. Does CTX106677 ? Userdump.exe May Affect Certain Virtual Channels for
Non-administrator User Accounts fix the issue?
General Clipboard Contention Issues
The open clipboard call failed due to contention with Wfshell, a Citrix utility
that enables cut and paste operations amongst the client and server. This
problem was reproduced using Microsoft Excel 97 but was also present with other
applications.
It is now possible to configure the server in such a way that if an open
clipboard call fails, the system retries to open the clipboard a specified
number of times or until the open is successful. It is also possible to
configure a delay in milliseconds between each clipboard open retry. The
following procedure describes how to enable this feature for a given
application:
1. Create the following registry key:
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\Current Version\Terminal
Server\Compatibility\Applications\{app name}
where {app name} is the name of the application without the extension.
2. Add the following registry values to the above registry key:
OpenClipboardRetries: REG_DWORD: 0x20
OpenClipboardDelayInMilliSecs: REG_DWORD: 0x50
Flags: REG_DWORD: {num}
where {num} is the application type. Possible values are:
DOS application 0x1
OS/2 application 0x2
Windows 16-bit application 0x4
Windows 32-bit application 0x8
Win16 and Win32 applications 0xC
Any version 0xF
When testing Excel 97, the above settings worked well for Excel (32 retries
with a 256 millisecond delay between each). If applications on the ICA Client
device and the MetaFrame server are actively accessing the clipboard
simultaneously, it may be necessary to increase the settings for
"OpenClipboardRetries" and "OpenClipboardDelayInMilliSecs."
3. Restart the application for the new settings to take effect.
CTX101600 - Runtime Error 521: Unable to Open Clipboard
CTX102314 - Pasting into an ICA or RDP session may fail from workstations
running Marimba
How to Disable the Clipboard on a Per-Client Basis
CTX102977 - How to Disable the Clipboard on a Per-Client Basis
How to add a Custom Clipboard Format to a MetaFrame Server
Certain applications introduce custom clipboard formats that cannot be copied
from the local workstation and pasted into an ICA session. Additional testing
showed that the same application will copy and paste properly into an RDP
session. Citrix has added support for these custom clipboard formats.
The hotfix requires the appropriate service pack level to be installed. From
the ME183W011 hotfix readme:
"Provides a way to add custom clipboard formatting from the registry. Add the
following registry value to add a custom clipboard format called
"MyCustomFormat" to a supported ICA clipboard format.
"WARNING! Using Registry Editor 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. Make sure you back up the registry before you
edit it. If you are running Windows NT, also update your Emergency Repair Disk
(ERD).
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Citrix\wfshell\Virtual
Clipboard\Additional Formats\MyFormat1 Name REG_SZ:MyCustomFormat
For example:
To add ETOS_Native as supported format, add the following to the registry:
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Citrix\wfshell\Virtual
Clipboard\Additional Formats\ETOS_Native
ValueName:Name
Data Type:REG_SZ
Value: ETOS_Native
Another example is the ?Paste Special? option within Microsoft Office.
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Citrix\wfshell\Virtual
Clipboard\Additional Formats
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Citrix\wfshell\Virtual
Clipboard\Additional Formats\CF_HTML
"Name"="CF_HTML"
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Citrix\wfshell\Virtual
Clipboard\Additional Formats\HTML Format
"Name"="HTML Format"
You need hotfix MetaFrame 1. 8 for Windows 2000 SP3 and ME183W011; ME183T004
for MetaFrame 1.8 SP3 for TSE4.0 or MetaFrame XP SP2 for Windows 2000 and TSE
4.0.
Pasting Too Much Text from Macintosh Clipboard to Client Session Causes
Macintosh Workstation to Lock Up
To increase the amount of memory allocated to the Citrix ICA Client:
1. Go to the binary file Citrix ICA Client within the finder. Make sure it is
not an alias; an alias has an italicized name instead of normal text.
2. Highlight the icon.
3. Press the Command Key + I. This opens up the Information window for the
binary (the Command Key is the one with the apple icon).
4. Depending on what system software you have loaded, you might have to choose
a Memory sub-window.
5. Find the memory allocation fields, Minimum Size and Maximum Size, and change
both of them to 8000K.
Pasting from Citrix Session to a local Macintosh Application Carries over a
Null Character
REPRODUCTION
1. Launch a published application, MS Word, from the Macintosh workstation.
2. Launch "Simple text" on the Macintosh Workstation
3. From the published application, Highlighted text (the word:"test1"),
selected copy from toolbar.
4. On local Macintosh Workstation, Focus on the "Simple Text" window, From
Toolbar selected paste. Observe, clipboard item is pasted locally(the
word:"test1").
5. From the end of the pasted text, (the word:"test1"), in order to delete last
character("1") you must use the delete key twice. The first to delete the
"Null" character and the second to delete the character "1".
6. If steps 1-5 are used with another type of text engine on the Macintosh,
Quark, the issue is not seen.
7.Customer had a script running on the workstation that strips off the extra
characters.
CAUSE
The server is sending a trailing null character and our clipboard handling code
passes this on to the Macintosh OS. This was introduced when Unicode clipboard
support was added to the Client. Some applications running on the MAC strip the
extra null character, e.g. Word, but others will not, e.g. SimpleText.
RESOLUTION
Contact Citrix Technical Support if the latest Citrix ICA Client for Macintosh
does not resolve this issue.
Other related posts:
- » [THIN] KB: CTX086028 - Troubleshooting Client Clipboard Issues
