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:

Spooler

Supervisor

Queue

Physical printer

Logical printer

Job

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:

aborted — A job was stopped, cancelled, or aborted.

error — An error occurred during job processing

report — One of the many events in the report class of events occurred

state-changed — The state of an object changed

warning — A job or printer warning has been issued.

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:

To create a notification profile for the red_spl server that contains all events in the error and report classes and is delivered as console messages:
```
#pdset -c server \
-x "{notification-profile=event-identifier=error \
report}" red_spl
```

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.