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.
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. |
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. |