Troubleshooting PDL Transforms
PDL transforms is an advanced feature of PaperCut NG/MF, so please read this section in the manual to understand how transforms work and how to write a transform.
PDL Transforms are designed the provide enhanced functionality, supportability and compatibility between two different drivers used in a single print process - E.g. A source print queue with a certain driver, and an output print queue with a different driver. Therefore when the source queue and the output queue have the same driver, any Transforms that have been written will not be used! The process is not called at all. So please ensure that PDL Transforms are only used in environments where the source print queue and the output print queue use different drivers.
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 service.
Once the transform test mode is enabled, a
.after file are created each time a spool file is transformed by print queue 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
Do your print queues have different drivers? If the drivers in your source print queue and output print queue are the same, then PDL Transforms will not work.
Check that transforms are supported.
Check that transform test mode is enabled
print-provider.logfile for the phrase ‘TRANSFORM LOGGING IS ENABLED’. That phrase should appear for every print job when
print-provider.conffile to verify that it has
EnableTransformTestMode=on, and restart the Print Provider service again.
Check that PaperCut is finding and applying your transform
print-provider.logfile for the phrase ‘TRANSFORM LOGGING: WORK TO DO?’
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
has_work=0then either the drivers on your source and output queues are the same, or there was no transform file under the
transforms/customdirectories that matched the printer language / printer type and target printer name / target printer type.
Redirected print job is not printing or is printing incorrectly.
.afterfiles for the print job.
.logfile reports an error then try to fix it in your
.transformfile or contact support if you cannot. Try printing again after you have made your corrections.
.logfile then you are probably transforming the file in the wrong way. Compare the
.afterfiles and try to identify the problem.
.afterfile. Transforms attempt to emulate direct printing so these files should match for printer language syntax and for the options being selected.