IPP> NOT - Simpler traps for Job Mon MIB proposal

[McDonald, Ira]

Hi folks,                                        Tuesday (18 April 2000)

Below is an ASN.1 sketch of a set of objects and notifications for the
Job Monitoring MIB (IPP notifications over SNMP).

A shortcoming in past drafts is the lack of persisent tables for device
(printer) and job events.  This proposal has persistent event tables,
plus an extension mechanism for extra trap bindings (for 'job-completed'
and 'job-progress' events).

The tables are:  Device, Device Event, Job Event, and Job Extra (for
additional bindings with the Job Progress Event).

The traps are:  Device Event, Job Event, and Job Progress Event (for
both 'job-progress' and 'job-completed' events).

The '...Notify[Language|Text|TextFormat' objects may be null strings.

Comments?

Cheers,
- Ira McDonald, consulting architect at Xerox and Sharp
  High North Inc

------------------------------------------------------------------------

--  Device Group
--  Systems which implement IETF Host Resources MIB RFC 2790 should
--  set 'jmDeviceIndex' equal to 'hrDeviceIndex' for the same device

--  INDEX   { jmDeviceIndex }
jmDeviceEntry ::= SEQUENCE {
        jmDeviceIndex                   Integer32 (1..2147483647)
        jmDeviceName                    SnmpAdminString,
        jmDeviceURI                     SnmpAdminString,
        jmDeviceServiceTypes            JmJobServiceTypesTC,
        jmDeviceState                   JmDeviceStateTC,
        jmDeviceStateReasons            SnmpAdminString,
        jmDeviceIsAcceptingJobs         TruthValue
    }


--  Device Event Group

--  INDEX   { jmDeviceIndex,
--            jmDeviceEventIndex }
jmDeviceEventEntry ::= SEQUENCE {
        jmDeviceEventIndex              Integer32 (1..2147483647),
        jmDeviceEventState              JmDeviceStateTC,
        jmDeviceEventStateReasons       SnmpAdminString,
        jmDeviceEventIsAcceptingJobs    TruthValue,
        jmDeviceEventTriggerEvent       SnmpAdminString,
        jmDeviceEventNotifyCharset      CodedCharSet,
        jmDeviceEventNotifyLanguage     SnmpAdminString,
        jmDeviceEventNotifyTextFormat   SnmpAdminString,
        jmDeviceEventNotifyText         OCTET STRING (SIZE (0..255)),
        jmDeviceEventUpTime             TimeTicks,
        jmDeviceEventDateTime           DateAndTime
    }

--  Device Event Notify (Trap/Inform)

jmDeviceEventV2Event NOTIFICATION-TYPE
    OBJECTS {
        jmDeviceEventState,
        jmDeviceEventStateReasons,
        jmDeviceEventIsAcceptingJobs,
        jmDeviceEventTriggerEvent,
        jmDeviceEventNotifyCharset,
        jmDeviceEventNotifyLanguage,
        jmDeviceEventNotifyTextFormat,
        jmDeviceEventNotifyText,
        jmDeviceEventUpTime,
        jmDeviceEventDateTime
    }


--  Job Event Group

--  INDEX   { jmJobSetIndex,
--            jmJobIndex,
--            jmJobEventIndex }
jmJobEventEntry ::= SEQUENCE {
        jmJobEventIndex                 Integer32 (1..2147483647),
        jmJobEventState                 JmJobStateTC,
        jmJobEventStateReasons          OCTET STRING (SIZE (4..16)),
        jmJobEventTriggerEvent          SnmpAdminString,
        jmJobEventNotifyCharset         CodedCharSet,
        jmJobEventNotifyLanguage        SnmpAdminString,
        jmJobEventNotifyTextFormat      SnmpAdminString,
        jmJobEventNotifyText            OCTET STRING (SIZE (0..255)),
        jmJobEventUpTime                TimeTicks,
        jmJobEventDateTime              DateAndTime,
        jmJobCountKOctetsProcessed      Integer32 (-2..2147483647),
        jmJobCountImpressionsCompleted  Integer32 (-2..2147483647)
    }

--  Job Event Notify (Trap/Inform)

jmJobEventV2Event NOTIFICATION-TYPE
    OBJECTS {
        jmJobEventState,
        jmJobEventStateReasons,
        jmJobEventTriggerEvent,
        jmJobEventNotifyCharset,
        jmJobEventNotifyLanguage,
        jmJobEventNotifyTextFormat,
        jmJobEventNotifyText,
        jmJobEventUpTime,
        jmJobEventDateTime
    }

--  Job Progress Notify (Trap/Inform)
--  For both job-progress and job-completed events

jmJobProgressV2Event NOTIFICATION-TYPE
    OBJECTS {
        jmJobEventState,
        jmJobEventStateReasons,
        jmJobEventTriggerEvent,
        jmJobEventNotifyCharset,
        jmJobEventNotifyLanguage,
        jmJobEventNotifyTextFormat,
        jmJobEventNotifyText,
        jmJobEventUpTime,
        jmJobEventDateTime,
        jmJobCountKOctetsProcessed,
        jmJobCountImpressionsCompleted
    }


--  Job Extra Group
--  Optional group for extra bindings on job events

--  INDEX   { jmJobSetIndex,
--            jmJobIndex,
--            jmJobEventIndex,
--            jmJobExtraAttributeTypeIndex }
jmJobExtraEntry ::= SEQUENCE {
        jmJobExtraAttributeTypeIndex    JmAttributeTypeTC,
        jmJobExtraAttributeValueInteger Integer32 (-2..2147483647),
        jmJobExtraAttributeValueOctets  OCTET STRING (SIZE (0..63))
    }

------------------------------------------------------------------------