PDL transforms is an advanced feature, so please read this section in the manual to understand how transforms work and how to write a transform.
To troubleshoot any PDL transform problem, please follow the steps listed below:
1. Open the file
[app-path]/providers/print/[platform]/print-provider.conf in a text editor.
3. Restart the Print Provider.
Once the transform test mode is enabled, a .log file and .before and .after spool files are created each time a spool file is transformed by redirection. They are created under
Note: This is an advanced option so remember to turn it off when you are done.
These 3 files will have names based on the spool file name. For example: On Windows
C:\Windows\system32\spool\PRINTERS\00259.SPL would have 3 corresponding files
Check that transforms are supported.
We added support for PDL Transforms
version 14.3. See the release history here
To check your version of the print provider, search backwards from the end of
for “Starting print provider service. Version:” (no quotes). If the print-provider version is less than 14.3 then you will need to upgrade to 14.3 or later.
Another way of finding out whether it is supported in your version of PaperCut or not is by searching
print-provider.log for “
xvp” (case insensitive match, no quotes). If you cannot find this then your version of the print provider either does not support PDL transforms.
Check that transform test mode is enabled
TRANSFORM LOGGING IS ENABLED
” (no quotes). There should be one of these messages for every print job when
If you cannot find one of these messages for your print job then check
print-provider.conf to verify that is has
EnableTransformTestMode=on and restart the print provider again.
Check that PaperCut is finding and applying your transform
Search backward from end of print-provider.log for
TRANSFORM LOGGING: WORK TO DO?
There will be a message like
TRANSFORM LOGGING: WORK TO DO? language=‘PostScript’,printer_name=‘sharedprinter’,printer_type=‘PaperCut Global PostScript’,target_printer_name=‘HP Color LaserJet’,target_printer_type=‘HP Color LaserJet PS’,has_work=1
then there was no transform file under the
directories that matched the printer language / printer type and target printer name / target printer type.
Check Appendix E. PDL Transform Language “Matching rules for running a transform script” to see why your transform is not being selected. If you cannot see why then please contract support.
If you see a log message
TRANSFORM LOGGING: No transform selected which has the same fields as
TRANSFORM LOGGING: WORK TO DO? then do the same as for
Redirected print job is not printing or is printing incorrectly.
file for the print job.
file reports an error then try to fix it in your
file or contact support if you cannot. Try printing again after you have made your corrections.
If no errors are reported in the
file then you are probably transforming the file in the wrong way. Compare the
files and try to identify the problem.
It is usually helpful to print directly to the printer being redirected to, save the spool file and compare it to the
.after file. Transforms attempt to emulate direct printing so these files should match for printer language syntax and for the options being selected.
If you cannot tell why your transform did not work then email the
.after files to us at email@example.com with a description of the problem.
Categories: Debugging, Troubleshooting
keywords: global print driver