Citrix Printing Tool 3.1
Created Date : 10/01/2009
Citrix Printing Tool 3.1 helps configuring and troubleshooting the Citrix Printing subsystem on XenApp, XenApp Online Plugin, and XenDesktop.
Quick list of features :
When run on a XenApp server (4.0,4.5,5.0):
??鷉G Configures the advanced features for the Citrix Print Service (DefaultPrnFlags, Citrix Universal Printer properties, font handling, and so on).
??鷉G Displays information about the important DLLs and EXE files related to Citrix printing subsystem.
??鷉G Displays active policies for the ICA sessions in the farm (Note: on 4.5 and 5.0/2003, it requires fix #218994 currently being validated).
??鷉G Re-installs the Citrix Universal Print Driver (UPD) v3 driver (Win2000 and Win2003 systems only).
??鷉G Event log review: displays the printing related events from the farm servers’ event logs and links to related Citrix Knowledge Base articles when required.
??鷉G With the /passthrough switch, the ICA client tab is available on the server.
??鷉G The server list is listed in alphabetical order.
When run on a Desktop Delivery Controller (XenDesktop 3.0):
??鷉G Configures the DefaultPrnFlags implemented in the Citrix Print Service for the Virtual Desktop Agent (Virtual Desktop Agent) and pushes them to the VDAs.
When run on machine with XenApp Online Plug-in:
??鷉G Clears the retained printer properties.
??鷉G Enables client side debug mode for EMF and XPS printing.
??鷉G Forces the local printer settings into the ICA session.
??鷉G Forces the “old” printing path for 10.x and 11.x clients.
Citrix Presentation Server 4.0 introduces a new printing architecture which allows the following Printing Registry Settings to be used:
Note: The following is taken from Chapter 11 (Printer Management) of the Advanced Concepts Guide for Citrix Presentation Server 4.0:
The values for each setting are given in hexadecimal format – keep this in mind when combining them.
For example, 0x20 + 0x80 = 0xA0 (not 0x100).
Installing Citrix Printing Tool
1. Extract the contents of the zip file to a folder.
2. If the files MSSTDFMT.DLL, MSCOMCTL.OCX and TABCTL32.OCX are not already registered on the computer, follow the steps below:
regsvr32 "path to the file\msstdfmt.dll"
regsvr32 "path to the file\mscomctl.ocx"
regsvr32 "path to the file\tabctl32.ocx"
Note: This tool has been tested on Citrix Presentation Server 4.0, Citrix XenApp 4.5, Citrix XenApp 5.0 for Windows 2003, Citrix XenApp 5.0 for Windows 2008, Windows 2000, Windows XP, Windows Vista, Windows Seven, Windows 2003 and Windows Server 2008. It is not supported on x64 operating systems.
How to use Citrix Printing Tool 3.1
Running on a XenApp server :
The screen shot below shows the default tab of the tool
The tool automatically checks the registry keys and displays the currently enabled features on the local server.
Windows 2008: When running on Windows 2008 with User Access Control feature enabled, the tool prompts the user to confirm the tool was run using the Run As Administrator option (accessible by right clicking on the executable file). If the tool is not run in this mode, it exits.
Information about the date, size, and Rollup Pack level of the main DLL and EXE files related to printing are displayed.
Using the Flag to decode button, it is possible to enter a hexadecimal value (format 0x000000 or 0000000) and the enabled features appear.
If the Citrix Universal Printer feature is enabled, the Options button can be used to display the window below.
On Citrix Presentation Server 4.0 or Citrix XenApp 4.5, those options are only available to the Citrix Universal Printer with a specific Rollup Pack level.
The enabled settings override the default hard coded configuration for the Citrix Universal Printer and apply to all users connecting to the server.
The second tab of the tool lets you enumerate the active ICA sessions on the selected server(s).
The active printing policies for that session appear.
The fourth tab provides a mechanism to re-install the Citrix UPD v3 driver:
This is only available on Windows 2000 Server and Windows 2003 Server.
The fifth tab parses the server(s) event logs for printing related events and provides useful links to the Citrix Knowledge Base whenever possible:
Running on a machine without Citrix Presentation Server or Citrix XenApp:
The screen shot below shows the default tab when running the tool on a machine without Citrix Presentation Server or XenApp installed.
It is strongly recommended to read through the detailed information in the tool before enabling any of those settings.
Save Setting saves the changes to the client registry.
Clean Printer Properties deletes the printer properties retained in the current user’s profile.
Running on a XenDesktop 3.x Desktop Delivery Controller:
When the tool is launched on a Desktop Delivery Controller, it provides an interface to help configuring the advanced printing features for the VDAs.
Security Permissions Required by Citrix Printing Tool 3.1
When running on a server, it requires read and write access to a set of registry keys (specified below) and Citrix Administrator rights.
When running on a workstation, it requires read and write access to a set of registry keys (specified below).
When running on Windows Vista or Windows 2008 with User Access Control enabled, it must be run “As Administrator” otherwise the tool will exit.
Data Modified by Citrix Printing Tool 3.1
On a server with Citrix Presentation Server or Citrix XenApp installed:
??鷉G The value DefaultPrnFlags (from HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\Print) can be created, modified, or deleted with this tool.
??鷉G The key UPDDevMode (from HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\Print) can be created, modified, or deleted with this tool.
??鷉G The value IncludeFonts (from from HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\Print) can be created, modified, or deleted with this tool.
??鷉G The value Driver List (from HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\UniversalPrintDrivers) can be modified with this tool.
??鷉G The value DisablePrintOptimizations (from HKEY_LOCAL_MACHINE\Software\Citrix\UniversalPrintDrivers\PCL5c) can be created, modified, or deleted with this tool.
??鷉G The value CompressionLevel (from HKEY_LOCAL_MACHINE\Software\Citrix\Print) can be created, modified or deleted with this tool.
On a machine without Citrix Presentation Server or Citrix XenApp installed:
??鷉G The value EMF (from HKEY_LOCAL_MACHINE\Software\Citrix\ICA Client\PrintDebugFlags) can be created, modified, or deleted with this tool.
??鷉G The value XPS (from HKEY_LOCAL_MACHINE\Software\Citrix\ICA Client\PrintDebugFlags) can be created, modified, or deleted with this tool.
??鷉G The value ReprocessEMFDriverList (from HKEY_LOCAL_MACHINE\Software\Citrix\ICA Client) can be created, modified, or deleted with this tool.
??鷉G The file APPSRV.INI that is present in “%USERPROFILE%\Application Data\ICA Client” folder can be modified with this tool.
??鷉G The key (and subkeys) from HKEY_CURRENT_USER\Software\Citrix\PrinterProperties\ can be deleted with this tool.
How to Undo the Changes Made by Citrix Printing Tool 3.1
WARNING : this tool modifies several registry keys. Make sure you backup your registry before running the tool.
Uninstalling Citrix Printing Tool
Delete the file from the machine.
Questions? Concerns? Send any feedback for this tool to firstname.lastname@example.org.
If you experience a problem with the tool, make sure to run it with the /debug switch while DebugView (from SysInternals) is launched to capture output before sending an email to email@example.com.
These software applications are 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.