PS> IPP Event Notification Subscription and Delivery documents

PS> IPP Event Notification Subscription and Delivery documents

McDonald, Ira imcdonald at sharplabs.com
Tue Jun 11 13:06:19 EDT 2002


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



More information about the Ps mailing list