Print Job Parser Configuration

About

This page contains detailed description of print job parser.
Print job parser is used by YSoft SafeQ to determine number of print job pages and for image preview rendering.
YSoft SafeQ comes with build in parser for PCL and HPGL print jobs. If you want to parse PostScript (PS) jobs, you need to download and install GhostScript parser on your own because due to licensing limitation it can not be included in YSoft SafeQ installation package.

General Parser Configuration

There are two ways how can parser be configured.

Top level

Navigate to the Settings page and choose Spooler category.
You can see panel with basic parser settings. This panel is visible only if your view is set to Basic or Advanced options. For more parser related configuration properties set view mode to Expert options.

images/download/attachments/21955636/parser_enabled.png


Option

Description

Disable all parsers

Print jobs will not be parsed, analyzed and no print preview would be rendered. This option provides the best system performance.

Only analyse jobs

(same parser for PS and PCL jobs)

This option will not render the print jobs. It would just analyze them and will not create job previews. Internal analyzer is highly accurate in number of pages estimations, less accurate in color detection and size detection (therefore suitable for offline accounting where mentioned limitations do not interfere). It consumes only few of system resources. Internal analyzer (YSoft Parser) will be used both for PCL and PS print jobs. Additionally this option enables parser of the XCPT print job headers to detect certain kinds of color jobs.

images/s/-3eliqb/8502/404359a7d2ab19c9c7c58d12013124a386b28257/_/images/icons/emoticons/warning.svg  Not suitable for coverage accounting

images/s/-3eliqb/8502/404359a7d2ab19c9c7c58d12013124a386b28257/_/images/icons/emoticons/warning.svg  Not suitable for price estimation

images/s/-3eliqb/8502/404359a7d2ab19c9c7c58d12013124a386b28257/_/images/icons/emoticons/warning.svg  Internal analyzer is able to analyze PCL, HPGL and PS jobs only

images/s/-3eliqb/8502/404359a7d2ab19c9c7c58d12013124a386b28257/_/images/icons/emoticons/warning.svg PS jobs: all pages are considered as B/W and normal paper size

images/download/attachments/21955370/warning.png PS jobs must contain %%Page: comments. (Note that these comments should be not be confuse with overall %%Pages: comment which is often not filled and therefore not used)

images/s/-3eliqb/8502/404359a7d2ab19c9c7c58d12013124a386b28257/_/images/icons/emoticons/warning.svg  In rare cases analyzer may fail to provide accurate results. For high accuracy use one of the options below

Only analyse jobs

(different parsers for PS and PCL jobs)

This option will not render the print jobs. It would just analyze them and will not create job previews. Internal analyzer is highly accurate in number of pages estimations, less accurate in color detection and size detection (therefore suitable for offline accounting where mentioned limitations do not interfere). It consumes only few of system resources.

images/s/-3eliqb/8502/404359a7d2ab19c9c7c58d12013124a386b28257/_/images/icons/emoticons/warning.svg  Not suitable for coverage accounting

images/s/-3eliqb/8502/404359a7d2ab19c9c7c58d12013124a386b28257/_/images/icons/emoticons/warning.svg  Not suitable for price estimation

images/s/-3eliqb/8502/404359a7d2ab19c9c7c58d12013124a386b28257/_/images/icons/emoticons/warning.svg  Internal analyzer is able to analyze PCL, HPGL and PS jobs only

images/s/-3eliqb/8502/404359a7d2ab19c9c7c58d12013124a386b28257/_/images/icons/emoticons/warning.svg In rare cases analyzer may fail to provide accurate results. For high accuracy use one of the options below

Render low-resolution images from jobs (36 DPI)

This option will render an image from every job, transform it to CMYK, and generate a preview. The image will be low-res (36 DPI) in order to conserve system resources. Suitable for offline accounting, and job preview. This option can worsen system performance.

Render high-resolution images from jobs (150 DPI)

This option will render an image from every job, transform it to CMYK, and generate a preview. The image will be hi-res (150 DPI). Suitable for offline accounting, job preview, and coverage accounting. This option has significant impact on system performance.

 

XCPT header analysis

If job contains Xerox Common Print Ticket (XCPT) header and XPCT header analysis is enabled, print job information present in XCPT header are prioritized over information obtained by Print Job Parser (does not aply for job analysis) and thus information gathered by Print Job Parser are overridden by information present in XCPT header. Also XCPT header analysis can be configured regardless enabled parser to obtain basic job information without affecting system performance, see XCPT Header Analysis Configuration.

Low level

Navigate to the Settings page and choose Spooler category.
You can see panel with basic parser settings. Switch your view to Expert options. Panel with basic parser settings will be replaced with detailed settings.

images/s/-3eliqb/8502/404359a7d2ab19c9c7c58d12013124a386b28257/_/images/icons/emoticons/warning.svg Please consult any modifications of expert options with YSoft Support!

How to download and install GhostScript

If you want to parse PostScript (PS) jobs, you need to download and install GhostScript parser.

 

1

Download GhostScript 8.61 installation package from http://pages.cs.wisc.edu/~ghost/. Do not download 9+ versions because they are currently not supported.

2

Execute downloaded install package (for example gs861w32.exe) and click on Setup button.

 images/download/attachments/21955636/gs1.PNG

3

Set installation directory to SAFEQ_DIRECTORY\bin\parser (for example c:\SafeQ5\bin\parser or c:\SafeQORS\bin\parser ) and click Install button.

images/download/attachments/21955636/gs2.PNG

4

When installation finishes everything is ready. Try to send PostScript print job to YSoft SafeQ server and check number of pages in job info details (page Reports > Job list). Number of pages should not be zero.

images/s/-3eliqb/8502/404359a7d2ab19c9c7c58d12013124a386b28257/_/images/icons/emoticons/warning.svg  If you decide to experiment with newer version of GhostScript, installation workflow can differ and you need to also update all references to GhostScript version in configuration options ParserPS and ParserPSWorkDir (located in Expert options view on Settings > Printing parser page) so location of gswin32.exe file in file system matches value of configuration options mentioned above.