You can include the attribute notification-profile=profile in the -x or -X option of the command line to identify the specific job information or events for which you want notification. This attribute is multi-valued and each value can include the following optional elements:
event-identifiers
The type of events you wish notification. You can include a specific event, such as "report-job-completed", in which case you will be notified only when your job has completed; or a class of events, such as "class-aborted", in which case you will be notified if your job is affected by any event within the class of events. To display a list of events available for notification, perform a pdls on the server and include the attribute events-supported. If this field is omitted, all events associated with this object are reported.
delivery-method
The way you want to be notified. The following values are supported:
All pertinent event information is delivered via electronic-mail to the address provided in the delivery-address field.
message
Event information is delivered immediately as a message written to a console window on the workstation associated with the address provided in the delivery-address field. A console window must be open in order to view message.
event-comment
You can include a comment that will become a part of the notification.
delivery-address
The address where the notification is to be sent.
For email, only mail addresses having an RFC-822 syntax, such as Internet mail addresses, are supported. The format for the address is:
<user-name>@<user-address>
For message, the format for the address is,
"X <ip address? 0" or the host name
The local host is the default if you do not specify an address.
locale
The server uses this information to build the message. If you omit this element the CLI provides the information as a default.
System problems or interesting events are reported to users through notifications services. Events are reported to the user by e-mail or an immediate message.
The attribute notification-profile specifies the events to be reported and the delivery method to be used. Users can request notification on specific events or on classes of events. Notification on a class of events will produce messages for each event in the class. Users can specify a notification-profile for the following objects:
Printer
Servers (spoolers and supervisors)
Job
Queue
Table C-1 lists the events, their classes, the print objects to which
they apply, and the associated messages that are supported.
Table C-1: Events
Class/Event | Object | Message |
class-aborted | ||
job-aborted-by-server |
job |
The server aborted the print job. |
job-cancelled-by-operator |
job |
The operator cancelled the print job. |
job-cancelled-by-user |
job |
The user cancelled the print job. |
class-error | ||
error-document-content |
job |
The server detected an error in the document content during printing. |
error-job-submission-not-complete |
job |
The server has not received the final print operation for a job. |
error-no-document |
server |
A document is not accessible or available to the server. |
error-no-resource |
job |
A required resource is not available or has become unavailable. |
error-other |
all |
the server has encountered some unknown error condition. |
error-page-select |
job |
A specified page could not be found in the document. |
error-past-deadline |
job |
The deadline time for the print job has passed. |
error-past-discard-time |
job |
The discard time for the print job has passed. |
error-printer-shutdown |
printer |
The printer was shut down before the job completed. |
error-unrecognized-resource |
server |
A required resource is not known to the server. |
class-report | ||
report-file-transferred |
document |
A file transfer for the job has been completed. |
report-job-completed |
job |
The print job has completed successfully. |
report-job-discarded |
job |
The print job has been discarded. |
report-job-promoted |
job |
The print job was promoted by the user or operator. |
report-job-resumed |
job |
The print job was resumed by the user or operator. |
report-processing-started |
job |
The server has begun processing the job. |
report-resource-message |
job |
A message regarding a required resource should be read. |
class-state-changed | ||
state-changed-job |
job |
The state of the job has changed. |
state-changed-printer |
printer |
The state of the printer has changed. |
state-changed-queue |
queue |
The state of the queue has changed. |
state-changed-server |
server |
The state of the server has changed. |
class-warning | ||
warning-close-to-deadline |
job |
The deadline time for printing the job is nearing. |
warning-close-to-discard-time |
job |
The retention period is nearing. |
warning-criterion-exceeded |
job |
A preciously specified criterion threshold value has been exceeded. |
warning-duplicate-attribute-ignored |
server |
An attribute has been duplicated. |
warning-job-interrupted |
job |
The print job has been interrupted by the user or operator. |
warning-job-modified |
job |
The print job was modified by a user or operator. |
warning-job-paused |
job |
The print job has been paused by the user or operator. |
warning-other |
all |
The server has encountered some unknown warning condition. |
warning-printer-shutdown |
printer |
The printer was shutdown before the job started. |
warning-resource-needs-attention |
printer |
A required resource needs attention. |
warning-resource-needs-operator |
printer |
A required resource needs attention by an operator. |