IPP Mail Archive: IPP> NOT - New IPP Event Notifications paper posted

IPP> NOT - New IPP Event Notifications paper posted

Hastings, Tom N (hastings@cp10.es.xerox.com)
Tue, 18 May 1999 18:42:16 -0700

Ron Bergman, Harry Lewis, and I have had some discussions about the
proposal.

We suggest removing the concept of event groups. We also suggest collapsing
the job events into a smaller number, that includes a single
job-state-changed event the covers most of them. The paper is 16 pages
long, not counting Abstract, TOC, and appendices.

We are still working on the Job Independent Subscription paper and the Job
Progress Monitoring with events paper and will have them out tomorrow.

We want to process the documents at the upcoming IPP WG meeting in
Philadelphia, May 26-27.

The files are located at:

ftp://ftp.pwg.org/pub/pwg/ipp/new_NOT/ipp-notification-990518.doc
ftp://ftp.pwg.org/pub/pwg/ipp/new_NOT/ipp-notification-990518.pdf
ftp://ftp.pwg.org/pub/pwg/ipp/new_NOT/ipp-notification-990518-rev.doc
ftp://ftp.pwg.org/pub/pwg/ipp/new_NOT/ipp-notification-990518-rev.pdf

There are 10 issues identified in the body of the document. I'll send out
separate mail messages for the ones that could benefit from DL discussion.

There are so many revisions since the January version, we don't recommend
reading it. There is a change history. Here it is:

Changes are listed in reverse chronological order:
1.1 Changes to the May 17, 1999 to make the May 18, 1999 (T Hastings, R
Bergman)
1. Removed concept of event groups. Subscribe to
individual events. Much simpler. The event determines what data is sent in
the event report. Also allows the client to query the device to see what
events are supported, rather than which groups.
2. Replaced all of the job state transition events with
a single 'job-state-changed' event. The report contains the old job state
and the new job state.
3. Removed the notification-format attribute to keep
the proposal simple.
4. Added the
'client-error-notify-uri-scheme-not-supported' status code.
5. Added REQUIRED "previous-job-state",
"previous-job-state-reasons", previous-printer-state", and
"previous-printer-state-reasons" Job Description attributes.
6. Removed the "job-impressions-completed" from the
Basic Job Event Report Content. Bring it back with the "job-progress"
events.
7. Removed the "printer-is-accepting-jobs" from the
Basic Printer Event Report Content. Its changing is part of the
"config-change" event.
8. Changed the 'job-state-changed' event, so that it
doesn't include 'job-created', 'job-completed', or 'job-purged' events.
9. Made the event names mostly consistent by being in
the past tense to reflect the fact that events reports happen after the
internal event has completed.
10. Combined the 'job-state-reasons-added' and
'job-state-reasons-removed' into a single event:
'job-state-reasons-changed'. Same for 'device-state-reasons-changed'.
11. Changed 'mailto' notification method to REQUIRE
'multipart/report' which all mail agents understand, at least the text part.
12. Deleted the 'job-warning' and 'job-error' events,
since they are covered by the 'job-state-reasons-changed,
'job-state-changed' and/or 'job-completed' events.
1.2 Changes to the January 20, 1999 to make the May 17, 1999 version (M
Shepherd)
1. Changed references to IPP 1.0 to IPP 1.1
2. Implementing the notification specification is optional.
3. Refined the definition of Event
4. Changed 'notification report' to 'event report' for consistent
terminology
5. Changed the terminology of an 'active' job to 'not-complete'.
Included the 'pending-held' state in the 'not-complete' super-state.
6. Introduced notify-event-groups-default.
7. Changed job-trigger-message and job-impressions-completed to be
CONDITIONAL in the event report, job-trigger-date-time to be RECOMMENDED,
and job-state-reasons to be REQUIRED.
8. Changed device-trigger-message to be CONDITIONAL in the event
report, and printer-state-reasons to be REQUIRED.
9. Created a table to map job-trigger-events keywords to event-groups
and required status.
10. Modified job-continued to be job-resumed-processing, and
job-received to be job-created. Added job-purged, job-state-reason-removed,
and job-state-reason-added keywords.
11. Modified job-trigger-time and device-trigger-time to use values less
than zero.
12. Created a table to map device-trigger-events keywords to
event-groups and their required status.
13. Added ready-for-job and device-state-reason-added to
device-trigger-events keywords.
14. Updated References section
15. Added notify-format and notify-format-supported attributes.
16. Added subscription-id to the event report attributes of job and
device.
17. Made job-errors-basic and device-errors-basic REQUIRED to be
supported.
18. Added device-media-changed, device-config-changed, and
ready-for-just-in-time-job to device events.
19. Added Author's Addresses.