Printer Services Mail Archive: PS> IPP Event Notification Su

PS> IPP Event Notification Subscription and Delivery documents

From: McDonald, Ira (imcdonald@sharplabs.com)
Date: Tue Jun 11 2002 - 13:06:19 EDT

  • Next message: BERKEMA,ALAN C (HP-Roseville,ex1): "PS> [PSI]: next 6/18 8:00:am Pacific"

    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



    This archive was generated by hypermail 2b29 : Tue Jun 11 2002 - 13:05:54 EDT