4.25 PrinterHealth

Use this Knowledge Script to monitor the health of printers. This script checks whether any specified printer is paused or if the printer queue length exceeds the threshold you specify, and raises an event if either condition exists. This script also raises an event if it finds general printing errors such as a printer that is out of paper or jammed.

You can set this script to discover printers dynamically each time it runs. If you discover printers dynamically, printers that were not discovered when you ran Discovery_NT are not reflected in the Navigation pane or the TreeView pane.

NOTE:To run this script successfully, avoid using special characters such as, /, -, and # when defining the printer name on the monitored computers. Also, if you run the Discovery_NT Knowledge Script and then delete a local or network printer, run Discovery_NT again.

4.25.1 Resource Objects

Printer folder, if dynamically enumerating printers. If you are not enumerating printers dynamically, you can run this script on the Printer folder or individual printer objects. You can run this script only on a local printer.

4.25.2 Default Schedule

The default schedule for this script is Every 10 minutes.

4.25.3 Setting Parameter Values

Set the following parameters as needed:

Description

How to Set It

Raise event?

Set to y to raise an event if a specified printer is paused, if the printer queue length exceeds the threshold you specify, or if the script finds general printing errors. The default is y.

This script displays the following event messages when it detects a general printer error: Door Open, Paper Jam, Offline, No Paper, Toner Low, or Service Request.

Collect data?

Set to y to collect data for charts and reports. If enabled, data collection returns the number of print jobs at each interval. The default is n.

Dynamically enumerate at each interval?

Set to y to dynamically observe connected printers at each monitoring interval. The default is y.

Maximum printer queue length threshold

Specify the maximum number of print jobs that can be waiting in the queue before an event is raised. The default is 10.

Maximum print job size threshold

Specify the maximum print job size allowed before an event is raised. The default is 200 KB.

Event severity level for printer paused

Set the event severity level, from 1 to 40, to indicate the importance of an event in which the printer is not responding and no jobs are being processed. The printer is off-line, or out of paper or toner, for example. The default is 3 (red event indicator).

Event severity level for printer busy

Set the event severity level, from 1 to 40, to indicate the importance of an event in which the number of jobs in the printer queue exceeds the threshold. The default is 5 (red event indicator).

Event severity level for job size threshold crossed

Set the event severity level, from 1 to 40, to indicate the importance of an event in which the size of the print job exceeds the threshold. The default is 1 (red event indicator).