Hi folks,
Per our brief topic of printer/job event notifications during today's
PSI Telecon, below are references for the related IPP documents:
Cheers,
- Ira McDonald
High North Inc
---------------------------------------------------------------------------
[list of IPP Printer and Job events]
printer-state-changed
printer-restarted
printer-shutdown
printer-stopped
printer-config-changed
printer-media-changed
printer-finishings-changed
printer-queue-order-changed
job-state-changed
job-created
job-completed
job-stopped
job-config-changed
job-progress [page level events]
---------------------------------------------------------------------------
"Internet Printing Protocol (IPP): IPP Event Notifications and
Subscriptions", J. Martin, T. Hastings, R. Herriot, S. Isaacson, R deBry,
R. Bergman, Michael Shepherd, 11/28/2001,
<draft-ietf-ipp-not-spec-08.txt>
[defines the IPP Subscription object and the Subscription Attributes group
for IPP "job creation" operations]
"Internet Printing Protocol (IPP): Job Progress Attributes", T. Hastings,
R Bergman, R. Bergman, 07/23/2001, <draft-ietf-ipp-job-prog-03.txt>
[defines the page-level job events, which should only be delivered
via a low-latency protocol]
"Internet Printing Protocol (IPP): The 'mailto:' Delivery Method for
Event Notifications", T. Hastings, R. Herriot, Carl-Uno Manros, Henrik
Holst, 07/23/2001, <draft-ietf-ipp-notify-mailto-04.txt>
[defines new Subscription attributes for email and the packaging of
IPP email event notifications - in plaintext with optional additional
MIME body parts]
"Internet Printing Protocol (IPP):The 'indp' Delivery Method for Event
Notifications and Protocol/1.0", T. Hastings, Hugo Parra, 07/23/2001,
<draft-ietf-ipp-indp-method-06.txt>
[defines a low-latency event delivery method using 'reverse HTTP'
(client acts as mini-HTTP-server and receives incoming connections
from Printer or Event Notification Server for delivery of events.]
All of the above are available from the IETF server in the directory
ftp://ftp.ietf.org/internet-drafts/
and the PWG Server in the directory
ftp://ftp.pwg.org/pub/pwg/ipp/new_NOT/
ONLY on the PWG server, also see 'ippget' (strangely, only this _one_
IPP I-D was just deleted from the I-D directory last week, although it
is currently under IESG consideration):
"Internet Printing Protocol (IPP): The 'ippget' Delivery Method for Event
Notifications", R. Herriot, T. Hastings, C. Kugler, 11/19/2001,
<draft-ietf-ipp-notify-get-06.txt>
[defines an in-band event delivery method, where client either polls
Printer when directed (with server next-poll hints) OR (optional)
uses "long" operations with multiple HTTP Responses (for a server
to client stream of events)]
---------------------------------------------------------------------------
[excerpt from the IPP Notifications spec table of contents]
5 Subscription Object.............................................16
5.1 Rules for Support of Subscription Template Attributes.........17
5.2 Rules for Processing Subscription Template Attributes.........18
5.3 Subscription Template Attributes..............................22
5.3.1 notify-recipient-uri (uri) OR notify-pull-method (type2
keyword)...............................................25
5.3.1.1 notify-recipient-uri (uri)................................25
5.3.1.2 notify-pull-method (type2 keyword)........................25
5.3.2 notify-events (1setOf type2 keyword)........................26
5.3.2.1 Standard Values for Subscribed Events.....................26
5.3.2.1.1 No Events...............................................27
5.3.2.1.2 Subscribed Printer Events...............................27
5.3.2.1.3 Subscribed Job Events...................................29
5.3.2.2 Rules for Matching of Subscribed Events...................30
5.3.2.2.1 Rules for Matching of Printer Events....................30
5.3.2.2.2 Rules for Matching of Job Events........................31
5.3.2.2.3 Special Cases for Matching Rules........................31
5.3.3 notify-attributes (1setOf type2 keyword)....................32
5.3.4 notify-user-data (octetString(63))..........................34
5.3.5 notify-charset (charset)....................................34
5.3.6 notify-natural-language (naturalLanguage)...................35
5.3.7 notify-lease-duration (integer(0:67108863)).................35
5.3.8 notify-time-interval (integer(0:MAX)).......................36
5.4 Subscription Description Attributes...........................38
5.4.1 notify-subscription-id (integer (1:MAX))...................38
5.4.2 notify-sequence-number (integer (0:MAX))....................39
5.4.3 notify-lease-expiration-time (integer(0:MAX))...............39
5.4.4 notify-printer-up-time (integer(1:MAX)).....................40
5.4.5 notify-printer-uri (uri)....................................41
5.4.6 notify-job-id (integer(1:MAX))..............................41
5.4.7 notify-subscriber-user-name (name(MAX)).....................42
6 Printer Description Attributes Related to Notification..........42
6.1 printer-state-change-time (integer(1:MAX))....................43
6.2 printer-state-change-date-time (dateTime).....................43
7 New Values for Existing Printer Description Attributes..........43
7.1 operations-supported (1setOf type2 enum)......................43
8 Attributes Only in Event Notifications..........................44
8.1 notify-subscribed-event (type2 keyword).......................44
8.2 notify-text (text(MAX)).......................................45
9 Event Notification Content......................................45
9.1 Content of Machine Consumable Event Notifications.............48
9.1.1 Event Notification Content Common to All Events.............48
9.1.2 Additional Event Notification Content for Job Events........50
9.1.3 Additional Event Notification Content for Printer Events....51
9.2 Content of Human Consumable Event Notification................51
9.2.1 Event Notification Content Common to All Events.............52
9.2.2 Additional Event Notification Content for Job Events........54
9.2.3 Additional Event Notification Content for Printer Events....55