9    Setting Event Notification

Advanced Printing Software reports system problems and events through notification services. Notification services deliver messages by electronic mail or to the system console.

The notification-profile attribute specifies the events that are reported as well as the delivery method of the reports. You can specify a notification-profile attribute for the following objects:

Only administrators can specify a notification-profile attribute for a server, queue, and printer objects. End users can specify notification profiles for a job when they submit the job to print.

9.1    Event Notification Server

Notification messages are delivered by a notification server. The notification server is a daemon that runs on the host where a spooler resides and on client systems. The notification server, /usr/pd/lib/pdntfs, distributes notification messages issued by the spooler and supervisor. It is responsible for sending e-mail messages and displaying messages in the message areas of the pdprintadmin and pdprintinfo GUIs.

The notification server starts when needed by way of inetd. An entry in the inetd.conf file is added when the print system is installed.

9.2    Notification Method

The print system delivers notification messages as an e-mail message or an immediate message to a GUI or the console.

9.3    Notification Event Classes

You can specify events individually or by a class of events. When a notification-profile attribute specifies a class, the notification server reports all events of that class. The following classes of events are supported:

9.3.1    Server Events

The following table lists the events that are valid attributes for a server notification profile.

Class Event Message
error error-no-document A document is not accessible or available to the server.
  error-other The server has encountered an unknown error condition.
  error-unrecognized-resource The required resource is not known to the server.
report report-server-clean-complete The server has completed a clean operation.
  report-server-clean-aborted The server has aborted a clean operation.
state-changed state-changed-server The state of the server has changed.
warning warning-other The server has encountered an unknown warning condition.

The following example demonstrate the creation of a notification profile for server objects:

9.3.2    Queue Notification Events

Class Event Message
report report-queue-clean-complete The queue has completed a clean operation.
  report-queue-clean-aborted The queue has aborted a clean operation.
  report-queue-resubmit-aborted The queue has aborted a resubmit operation.
  report-queue-not-backlogged The queue is no longer backlogged.
state-changed state-changed-queue The state of the queue has changed.
warning warning-queue-backlogged The queue is backlogged.

9.3.3    Printer Notification Events

Class Event Message
state-changed state-changed-printer The state of the printer has changed.
warning warning-resource-needs-attention The required resource needs attention
  warning-resource-needs-operator The resource needs attention by an operator.

9.3.4    Job Notification Events

Class Event Message
aborted job-aborted-by-server The server aborted the print job.
  job-cancelled-by-operator The operator cancelled the job.
  job-cancelled-by-user The user cancelled the print job.
error error-job-submission-not-complete The server has not received the final print operation for a job.
  error-no-resources The required resource is not ready or has become unavailable.
  error-past-deadline The deadline time for the print job has passed.
  error-past-discard-time The discard time for the print job has passed.
report report-file-transferred The file transfer for the job has been completed.
  report-job-completed The print job has completed successfully.
  report-job-discarded The print job has been discarded.
  report-job-promoted The print job has been promoted.
  report-job-resumed The print job has been resumed
  report-processing-started The server has begun processing the job.
state-changed state-changed-job The state of the job has changed.
warning warning-close-to-discard-time The retention period is nearing.
  warning-job-modified The job has been modified.
  warning-job-paused The job has been paused.