Block release of print jobs to printers in error with hardware check enabled

KB Home   |   Block release of print jobs to printers in error with hardware check enabled

Main.PreventJobReleasePrinterError History

Hide minor edits - Show changes to output

July 06, 2018, at 07:25 PM by Aaron Pouliot - Added category Hardware Checks
Changed line 65 from:
''Categories:'' [[Category.Printers|+]], [[Category.ReleaseStations|+]]
to:
''Categories:'' [[Category.Printers|+]], [[Category.ReleaseStations|+]], [[Category.HardwareChecks|+]]
December 05, 2017, at 02:12 AM by peterf - Add mention of SNMP error detection for Windows, added in 17.4.2
Changed lines 13-15 from:
If you have [[https://www.papercut.com/products/ng/manual/applicationserver/topics/printer-hwcheck.html | hardware page count validation enabled]], you cannot prevent the release of jobs to printers with an error that is ignored by the hardware check. This is because errors excluded from the hardware check are not reported to the Windows print queue, which is where PaperCut detects the errors events that prevent the release of a job.
to:
If you have [[https://www.papercut.com/products/ng/manual/applicationserver/topics/printer-hwcheck.html | hardware page count validation enabled]], you cannot prevent the release of jobs to printers with an error that is ignored by the hardware check. This is because errors excluded from the hardware check are not reported to the Windows print queue, which is where PaperCut detects the error events that prevent the release of a job.

'''Note''': As of version 17.4.2 of PaperCut MF and PaperCut NG, the Print Provider on Windows print servers can be reconfigured to use SNMP to check for printer error states, instead of  solely relying on updates from the Windows print queue. Using SNMP based detection, as the Print Provider does by default for macOS and Linux print servers, may result in error states being reported more quickly and responsively. If you're finding that some print jobs are being improperly released before an error state is discovered to have afflicted the relevant print queue at that point in time, you might want to test enabling the [@ErrorPollMethod=snmp@] option found in the [@print-provider.conf@] on your Windows print server.
March 12, 2017, at 11:02 AM by Tim Shimmin -
Changed line 6 from:
* Web-based release stations—enabled with the '''release-station.block-web-release-on-printer-error''' config key <link> (see [[https://www.papercut.com/products/ng/manual/releasestation/topics/rs-block-released-jobs-printer-error.html | Prevent jobs being released from a web-based Release Station when a printer is in error]])
to:
* Web-based release stations—enabled with the '''release-station.block-web-release-on-printer-error''' config key  (see [[https://www.papercut.com/products/ng/manual/releasestation/topics/rs-block-released-jobs-printer-error.html | Prevent jobs being released from a web-based Release Station when a printer is in error]])
March 12, 2017, at 11:00 AM by Tim Shimmin - The Hardware Page Count error configuration strings look all wrong. Fixing them up.
Changed line 30 from:
(:cellnr :) ERROR
to:
(:cellnr :) Low Paper
Changed line 32 from:
(:cellnr :) PAPER_OUT
to:
(:cellnr :) No Paper
Changed line 34 from:
(:cellnr :) ERROR
to:
(:cellnr :) Low Toner
Changed line 36 from:
(:cellnr :) NO_TONER
to:
(:cellnr :) No Toner
Changed line 38 from:
(:cellnr :) DOOR_OPEN
to:
(:cellnr :) Door Open
Changed line 40 from:
(:cellnr :) PAPER_JAM
to:
(:cellnr :) Jammed
Changed line 42 from:
(:cellnr :) OFFLINE
to:
(:cellnr :) Offline
Changed line 44 from:
(:cellnr :) ERROR
to:
(:cellnr :) Service Requested
Changed line 46 from:
(:cellnr :) DOOR_OPEN
to:
(:cellnr :) Input Tray Missing
Changed line 48 from:
(:cellnr :) ERROR
to:
(:cellnr :) Output Tray Missing
Changed line 50 from:
(:cellnr :) ERROR
to:
(:cellnr :) Marker Supply Missing
Changed line 52 from:
(:cellnr :) ERROR
to:
(:cellnr :) Output Near Full
Changed line 54 from:
(:cellnr :) OUTPUT_BIN_FULL
to:
(:cellnr :) Output Full
Changed line 56 from:
(:cellnr :) PAPER_OUT
to:
(:cellnr :) Input Tray Empty
Changed line 58 from:
(:cellnr :) ERROR
to:
(:cellnr :) Overdue Prevent Maintenance
Changed line 1 from:
(:title Block release of print jobs to printers in error with hardware check:)
to:
(:title Block release of print jobs to printers in error with hardware check enabled:)
Changed line 1 from:
(:title Block release of print jobs to printers in error with hardware check Title:)
to:
(:title Block release of print jobs to printers in error with hardware check:)
Added lines 1-65:
(:title Block release of print jobs to printers in error with hardware check Title:)

'''Note''': This functionality is available in PaperCut 16.4+.

PaperCut allows you to prevent the release of jobs to printers that are in error from the following Release Stations:
* Web-based release stations—enabled with the '''release-station.block-web-release-on-printer-error''' config key <link> (see [[https://www.papercut.com/products/ng/manual/releasestation/topics/rs-block-released-jobs-printer-error.html | Prevent jobs being released from a web-based Release Station when a printer is in error]])
* Standard Release Stations—enabled with the '''block-release-on-printer-error''' property in [@config.properties@] (see [[https://www.papercut.com/products/ng/manual/releasestation/topics/rs-block-released-jobs-printer-error-pc-release.html |  Prevent jobs being released from a Standard Release Station when a printer is in error]])

'''Note''': PaperCut MF also allows you to prevent the release of jobs from MFD Release Stations, but this article relates specifically to web-based and Standard Release Stations.

There is, however, one thing you need to check to make sure it will work without a hitch.

If you have [[https://www.papercut.com/products/ng/manual/applicationserver/topics/printer-hwcheck.html | hardware page count validation enabled]], you cannot prevent the release of jobs to printers with an error that is ignored by the hardware check. This is because errors excluded from the hardware check are not reported to the Windows print queue, which is where PaperCut detects the errors events that prevent the release of a job.

If you don't have hardware page count validation enabled, it should work just fine so you don't need to read any further. Even if you do have hardware page count validation enabled, it should be fine if you have NOT modified either the:
* list of errors to ignore in the hardware check (specified in [@print-provider.conf@] under [@HWCheckIgnoreErrors=@])
* list of errors that will prevent the release of jobs (specified in '''ext-device.block-release-on-error.snmp-error-list'' config key)

If you have hardware page count validation enabled and you have modified either of the error lists, grab a coffee as you have a bit more work to do. You need to make sure there are no errors included in both error lists. If there are, you need to:
# Decide whether you want to exclude the error from the hardware check OR prevent jobs being released when the error occurs—you cannot do both.
# Remove the error from one of the two lists.

'''Note:''' The name of the error states excluded in hardware page count validation are not the same as the error names used to block jobs from being released to devices in error. The table below provides a mapping of the hardware page count validation error state  and the equivalent device in error state.

!!Error name mapping

(:table border=1 width=100% cellspacing=5 class=issues :)
(:cellnr class=top :) '''Hardware page count validation error state'''
(:cell class=top :) '''Printer in error state'''
(:cellnr :) ERROR
(:cell :)  lowPaper 
(:cellnr :) PAPER_OUT
(:cell :) noPaper
(:cellnr :) ERROR
(:cell :) lowToner
(:cellnr :) NO_TONER
(:cell :) noToner
(:cellnr :) DOOR_OPEN
(:cell :) doorOpen
(:cellnr :) PAPER_JAM
(:cell :) jammed
(:cellnr :) OFFLINE
(:cell :) offline
(:cellnr :) ERROR
(:cell :) serviceRequested
(:cellnr :) DOOR_OPEN
(:cell :) inputTrayMissing
(:cellnr :) ERROR
(:cell :) outputTrayMissing
(:cellnr :) ERROR
(:cell :) markerSupplyMissing
(:cellnr :) ERROR
(:cell :) outputNearFull
(:cellnr :) OUTPUT_BIN_FULL
(:cell :) outputFull
(:cellnr :) PAPER_OUT
(:cell :) inputTrayEmpty
(:cellnr :) ERROR
(:cell :) overduePreventMaint
(:tableend:)

----
''Categories:'' [[Category.Printers|+]], [[Category.ReleaseStations|+]]
----
[-Keywords: release station, hardware page count validation, printer errors-]

Comments

Share your findings and experience with other PaperCut users. Feel free to add comments and suggestions about this Knowledge Base article. Please don't use this for support requests.

Article last modified on July 06, 2018, at 07:25 PM
Printable View   |   Article History   |   Edit Article