draft-ietf-ipp-not-over-snmp-03.txt   draft-ietf-ipp-not-over-snmp-04.txt 
Internet Printing Protocol Working Group Tom Hastings Internet Printing Protocol Working Group Tom Hastings
INTERNET DRAFT Xerox INTERNET DRAFT Xerox
Expires 6 January 2001 Ira McDonald Expires 8 February 2001 Ira McDonald
High North High North
6 July 2000 8 August 2000
Internet Printing Protocol (IPP): Internet Printing Protocol (IPP):
Notifications over SNMP via Job Monitoring MIB Traps Notifications over SNMP via Job Monitoring MIB Traps
<draft-ietf-ipp-not-over-snmp-03.txt> <draft-ietf-ipp-not-over-snmp-04.txt>
Copyright (C) The Internet Society (2000). All Rights Reserved. Copyright (C) The Internet Society (2000). All Rights Reserved.
Status of this Memo Status of this Memo
This document is an Internet-Draft and is in full conformance with This document is an Internet-Draft and is in full conformance with
all provisions of Section 10 of RFC2026. Internet-Drafts are working all provisions of Section 10 of RFC2026. Internet-Drafts are working
documents of the Internet Engineering Task Force (IETF), its areas, documents of the Internet Engineering Task Force (IETF), its areas,
and its working groups. Note that other groups may also distribute and its working groups. Note that other groups may also distribute
working documents as Internet-Drafts. working documents as Internet-Drafts.
skipping to change at page 1, line 36 skipping to change at page 1, line 37
The list of current Internet-Drafts can be accessed at The list of current Internet-Drafts can be accessed at
http://www.ietf.org/ietf/1id-abstracts.txt http://www.ietf.org/ietf/1id-abstracts.txt
The list of Internet-Draft Shadow Directories can be accessed at The list of Internet-Draft Shadow Directories can be accessed at
http://www.ietf.org/shadow.html. http://www.ietf.org/shadow.html.
Abstract Abstract
This document is a submission to the Internet Printing Protocol This document is a submission to the Internet Printing Protocol
Working Group of the Internet Engineering Task Force (IETF). Working Group of the Internet Engineering Task Force (IETF). This
Comments should be submitted to the ipp@pwg.org mailing list. document is intended for eventual publication as an IETF
Informational RFC. Comments should be submitted to the ipp@pwg.org
mailing list.
This document proposes a mapping of IPP notifications over SNMP via This document specifies an OPTIONAL mapping of IPP notifications over
new service and job trap extensions defined for the Job Monitoring SNMP via new service and job trap extensions to the original Job
MIB [RFC-2707]. This mapping may be used to deliver printer Monitoring MIB [RFC-2707]. This mapping may be used to deliver
notifications for any printer (not just IPP-capable ones) and also printer notifications for any printer (not just IPP-capable ones) and
job notifications for any job (not just ones submitted via IPP). also to deliver job notifications for any job (not just ones
submitted via IPP).
This document proposes (4) new object groups and (4) new SNMP traps This document specifies (4) new object groups and (4) new SNMP traps
for addition to the Job Monitoring MIB [RFC 2707]. A working copy of for addition to the Job Monitoring MIB [RFC 2707]. A working copy of
this proposal integrated into the original Job Monitoring MIB ASN.1 these extensions inserted in the original Job Monitoring MIB ASN.1 is
is at: at:
ftp://ftp.pwg.org/pub/pwg/ipp/new_NOT/jmp-trap-000706.mib
ftp://ftp.pwg.org/pub/pwg/ipp/new_NOT/jmp-trap-000808.mib
Table of Contents Table of Contents
1. Introduction ............................................... 3 1. Introduction ............................................... 4
1.1. Terminology for Conformance ............................ 3 2. Terminology ................................................ 4
2. SNMP Network Management Framework .......................... 3 2.1. Terminology for Conformance ............................ 4
3. Managed Object Mapping ..................................... 4 2.2. SNMP Network Management Framework ...................... 4
3.1. SNMP Mapping for IPP Notifications ..................... 4 3. Model and Operation ........................................ 5
3.1.1. SNMP Mapping for IPP Printer Events ................ 4 3.1. SNMP Mapping for IPP Notifications ..................... 5
3.1.2. SNMP Mapping for IPP Job Events .................... 5 3.1.1. SNMP Mapping for IPP Printer Events ................ 5
3.2. Subscription for IPP Notifications ..................... 6 3.1.2. SNMP Mapping for IPP Job Events .................... 6
3.2.1. Subscription via IPP ............................... 6 3.2. Subscription for IPP Notifications ..................... 7
3.2.2. Subscription via SNMP .............................. 6 3.2.1. Subscription via IPP ............................... 7
3.3. Relationship to other MIBs ............................. 7 3.2.2. Subscription via SNMP .............................. 7
3.3.1. MIB-II (RFC 1213) .................................. 7 3.3. Relationship to other MIBs ............................. 8
3.3.2. Host Resources MIB (RFC 2790) ...................... 7 3.3.1. MIB-II (RFC 1213) .................................. 8
3.3.3. Printer MIB (RFC 1759) ............................. 7 3.3.2. Host Resources MIB (RFC 2790) ...................... 8
4. Managed Object Definitions ................................. 8 3.3.3. Printer MIB (RFC 1759) ............................. 8
4.1. Notification Definitions ............................... 8 4. General Information ........................................ 9
4.1.1. Service Basic Event - Trap ......................... 8 4.1. Table 1 - Information about the Delivery Method ........ 9
4.1.2. Job Basic Event - Trap ............................. 9 5. Subscription Template Attributes ........................... 12
4.1.3. Job Completed Event - Trap ......................... 11 5.1. Table 2 - Subscription and Printer Attributes .......... 12
4.1.4. Job Progress Event - Trap .......................... 12 5.2. Additional Subscription Template Attributes ............ 12
4.2. Object Definitions ..................................... 13 5.2.1. notify-snmp-version (type2 keyword) ................ 12
4.2.1. Service Group - Objects ............................ 13 5.2.1.1. notify-snmp-version-default .................... 13
4.2.2. Service Event Group - Objects ...................... 16 5.2.1.2. notify-snmp-version-supported .................. 13
4.2.3. Job Event Group - Objects .......................... 19 5.2.2. notify-snmp-auth-data (octetString(MAX)) ........... 13
4.2.4. Job Progress Group - Objects ....................... 22 5.2.2.1. notify-snmp-auth-data-default .................. 14
5. IANA Considerations ........................................ 24 5.2.2.2. notify-snmp-auth-data-supported ................ 14
6. Internationalization Considerations ........................ 24 5.2.3. notify-snmp-operation (type2 keyword) .............. 14
7. Security Considerations .................................... 24 5.2.3.1. notify-snmp-operation-default .................. 15
8. References ................................................. 25 5.2.3.2. notify-snmp-operation-supported ................ 15
9. Change Log ................................................. 26 5.2.4. notify-snmp-mtu-size (integer(0:MAX)) .............. 15
10. Intellectual Property Notice .............................. 29 5.2.4.1. notify-snmp-mtu-size-default ................... 15
11. Authors' Addresses ........................................ 29 5.2.4.2. notify-snmp-mtu-size-supported ................. 16
12. Full Copyright Statement .................................. 30 5.3. Additional Info about Subscription Template Attributes . 16
5.3.1. notify-recipient-uri (uri) ......................... 16
6. Event Notification Content ................................. 17
6.1. SNMP Message Envelope .................................. 17
6.1.1. SNMPv1 Message Envelope ............................ 17
6.1.1.1. version (INTEGER) .............................. 17
6.1.1.2. community (OCTET STRING) ....................... 17
6.1.2. SNMPv2 Message Envelope ............................ 17
6.1.2.1. version (INTEGER) .............................. 17
6.1.2.2. community (OCTET STRING) ....................... 17
6.1.3. SNMPv3 Message Envelope ............................ 17
6.1.3.1. msgVersion (INTEGER) ........................... 18
6.1.3.2. msgGlobalData (HeaderData) ..................... 18
6.1.3.3. msgSecurityParameters (OCTET STRING) ........... 18
6.1.3.4. msgData (ScopedPduData) ........................ 18
6.2. SNMP Message Header .................................... 18
6.2.1. SNMPv1 Trap Message Header ......................... 18
6.2.1.1. enterprise (OBJECT IDENTIFIER) ................. 19
6.2.1.2. agent-addr (NetworkAddress) .................... 19
6.2.1.3. generic-trap (INTEGER) ......................... 19
6.2.1.4. specific-trap (INTEGER) ........................ 19
6.2.1.5. time-stamp (TimeTicks) ......................... 19
6.2.2. SNMPv2 and SNMPv3 Trap/Inform Message Header ....... 19
6.2.2.1. request-id (Integer32) ......................... 19
6.2.2.2. error-status (INTEGER) ......................... 19
6.2.2.3. error-index (INTEGER) .......................... 20
6.3. SNMP Message Body ...................................... 20
6.3.1. SNMPv1 Trap Message Body ........................... 20
6.3.2. SNMPv2 and SNMPv3 Trap/Inform Message Body ......... 20
6.3.2.1. sysUpTime (TimeTicks) .......................... 20
6.3.2.2. sysTrapOID (OBJECT IDENTIFIER) ................. 20
6.4. SNMP Trap/Inform Examples .............................. 20
7. SNMP ASN.1 for IPP Notifications ........................... 21
7.1. Notification Definitions ............................... 21
7.1.1. Service Event Notify Group - Trap .................. 21
7.1.2. Job Event Notify Group - Trap ...................... 22
7.1.3. Job Completed Notify Group - Trap .................. 23
7.1.4. Job Progress Notify Group - Trap ................... 24
7.2. Object Definitions ..................................... 25
7.2.1. Service Group - Objects ............................ 25
7.2.2. Service Event Group - Objects ...................... 28
7.2.3. Job Event Group - Objects .......................... 32
7.2.4. Job Progress Group - Objects ....................... 35
8. Conformance ................................................ 37
9. IANA Considerations ........................................ 37
10. Internationalization Considerations ....................... 37
11. Security Considerations ................................... 37
12. References ................................................ 38
13. Change Log ................................................ 40
14. Intellectual Property Notice .............................. 43
15. Authors' Addresses ........................................ 43
16. Full Copyright Statement .................................. 44
1. Introduction 1. Introduction
This document is a submission to the Internet Printing Protocol This document is a submission to the Internet Printing Protocol
Working Group of the Internet Engineering Task Force (IETF). Working Group of the Internet Engineering Task Force (IETF).
Comments should be submitted to the ipp@pwg.org mailing list. Comments should be submitted to the ipp@pwg.org mailing list.
This document proposes a mapping of IPP notifications over SNMP via This document specifies an OPTIONAL mapping of IPP notifications over
new service and job trap extensions defined for the Job Monitoring SNMP via new service and job trap extensions to the original Job
MIB [RFC-2707]. This mapping may be used to deliver printer Monitoring MIB [RFC-2707]. This mapping may be used to deliver
notifications for any printer (not just IPP-capable ones) and also printer notifications for any printer (not just IPP-capable ones) and
job notifications for any job (not just ones submitted via IPP). also to deliver job notifications for any job (not just ones
submitted via IPP).
This document proposes (4) new object groups and (4) new SNMP traps This document specifies (4) new object groups and (4) new SNMP traps
for addition to the Job Monitoring MIB [RFC 2707]. A working copy of for addition to the Job Monitoring MIB [RFC 2707]. A working copy of
this proposal integrated into the original Job Monitoring MIB ASN.1 these extensions inserted in the original Job Monitoring MIB ASN.1 is
is at: at:
ftp://ftp.pwg.org/pub/pwg/ipp/new_NOT/jmp-trap-000706.mib
ftp://ftp.pwg.org/pub/pwg/ipp/new_NOT/jmp-trap-000808.mib
The IPP protocol [IPP-PRO] supports passive monitoring of IPP Printer The IPP protocol [IPP-PRO] supports passive monitoring of IPP Printer
and Job objects, via client polling of IPP object attributes using and Job objects, via client polling of IPP object attributes using
the 'Get-Printer-Attributes' and 'Get-Job-Attributes' operations. the 'Get-Printer-Attributes' and 'Get-Job-Attributes' operations.
This document proposes support for dynamic monitoring of IPP Printer This document specifies support for dynamic monitoring of IPP Printer
and Job objects via SNMP traps generated by the service provider and Job objects via SNMP traps generated by the service provider
(server or device). (server or device).
1.1. Terminology for Conformance 2. Terminology
2.1. Terminology for Conformance
The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT",
"SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this
document are to be interpreted per [RFC-2119]. document are to be interpreted per [RFC-2119].
2. SNMP Network Management Framework 2.2. SNMP Network Management Framework
See: Section 1.1 'SNMPv1', section 1.2 'SNMPv2', and section 1.3 See: Section 1.1 'SNMPv1', section 1.2 'SNMPv2', and section 1.3
'SNMPv3' of [RFC-2576]. 'SNMPv3' of [RFC-2576].
3. Managed Object Mapping 3. Model and Operation
3.1. SNMP Mapping for IPP Notifications 3.1. SNMP Mapping for IPP Notifications
3.1.1. SNMP Mapping for IPP Printer Events 3.1.1. SNMP Mapping for IPP Printer Events
IPP Printer event attribute Job Monitoring MIB object mapping IPP Printer event attribute Job Monitoring MIB object mapping
--------------------------- --------------------------------- --------------------------- ---------------------------------
version-number [no mapping - not useful] version-number [no mapping - not useful]
status-code [implicit in each generated trap] status-code [implicit in each generated trap]
notify-sequence-number [request-id in SNMP trap header] notify-sequence-number [request-id in SNMP trap header]
notify-charset [no mapping - strings are UTF-8] notify-charset [no mapping - strings are UTF-8]
notify-natural-language [no mapping - no text bindings] notify-natural-language [no mapping - no text bindings]
subscription-id [no mapping] subscription-id [no mapping]
notify-subscribed-event jmServiceEventNotifyEvent notify-subscribed-event jmServiceEventNotifyTriggerEvent
jmServiceEventNotifyGroupEvent
notify-printer-uri jmServiceURI notify-printer-uri jmServiceURI
printer-up-time [sysUpTime in SNMP trap bindings] printer-up-time [sysUpTime in SNMP trap bindings]
printer-current-time [hrSystemDate in Host Res MIB] printer-current-time [hrSystemDate in Host Res MIB]
notify-user-data [no mapping] notify-user-data [no mapping]
notify-text [no mapping] notify-text [no mapping]
printer-state jmServiceState printer-state jmServiceState
printer-state-reasons jmServiceStateReasons printer-state-reasons jmServiceStateReasons
printer-is-accepting-jobs [jmServiceStateReasons keyword] printer-is-accepting-jobs [jmServiceStateReasons keyword]
3.1.2. SNMP Mapping for IPP Job Events 3.1.2. SNMP Mapping for IPP Job Events
IPP Job event attribute Job Monitoring MIB object mapping IPP Job event attribute Job Monitoring MIB object mapping
----------------------- --------------------------------- ----------------------- ---------------------------------
version-number [no mapping - not useful] version-number [no mapping - not useful]
status-code [implicit in each generated trap] status-code [implicit in each generated trap]
notify-sequence-number [request-id in SNMP trap header] notify-sequence-number [request-id in SNMP trap header]
notify-charset [no mapping - strings are UTF-8] notify-charset [no mapping - strings are UTF-8]
notify-natural-language [no mapping - no text bindings] notify-natural-language [no mapping - no text bindings]
subscription-id [no mapping] subscription-id [no mapping]
notify-subscribed-event jmJobEventNotifyEvent notify-subscribed-event jmJobEventNotifyTriggerEvent
jmJobEventNotifyGroupEvent
notify-printer-uri jmServiceURI notify-printer-uri jmServiceURI
job-id [via jmJobState OID instance] job-id [via jmJobState OID instance]
printer-up-time [sysUpTime in SNMP trap bindings] printer-up-time [sysUpTime in SNMP trap bindings]
printer-current-time [hrSystemDate in Host Res MIB] printer-current-time [hrSystemDate in Host Res MIB]
notify-user-data [no mapping] notify-user-data [no mapping]
notify-text [no mapping] notify-text [no mapping]
job-state jmJobState job-state jmJobState
job-state-reasons jmJobEventJobStateReasons job-state-reasons jmJobEventJobStateReasons
[jmJobStateReasons1 plus zero or] [jmJobStateReasons1 plus zero or]
[more jobStateReasonsN in a strin [more jobStateReasonsN in a strin
skipping to change at page 6, line 13 skipping to change at page 7, line 13
sheet-completed-document-number jmProgressSheetCompletedDocNum sheet-completed-document-number jmProgressSheetCompletedDocNum
3.2. Subscription for IPP Notifications 3.2. Subscription for IPP Notifications
IPP Clients MAY subscribe for IPP Notifications delivered via SNMP by IPP Clients MAY subscribe for IPP Notifications delivered via SNMP by
either of the following two standard methods: either of the following two standard methods:
3.2.1. Subscription via IPP 3.2.1. Subscription via IPP
IPP Job creation (Create-Job, Print-Job, Print-URI) and IPP Job creation (Create-Job, Print-Job, Print-URI) and
Create-Subscription operations MAY be used to create per-Printer or Create-Subscription operations MAY be used to create per-Printer or
per-Job IPP Subscription objects and MAY specify per-Job IPP Subscription objects and MAY specify:
"notify-recipient-uri" = 'snmpnotify://hostname[.port]' "notify-recipient-uri" = 'snmpnotify://hostname[.port]'
"notify-events" = <events of interest, e.g., 'job-completed'> "notify-events" = <events of interest, e.g., 'job-completed'>
"notify-snmp-version" = <SNMP version and security model>
"notify-snmp-auth-data" = <authentication data, e.g., community>
"notify-snmp-operation" = <operation, e.g., SNMP Trap>
"notify-snmp-mtu-size" = <path max transmission unit, e.g., '4084'>
3.2.2. Subscription via SNMP 3.2.2. Subscription via SNMP
The SNMP Notification MIB and SNMP Target MIB (both in [RFC-2573]) The SNMP Notification MIB and SNMP Target MIB (both in [RFC-2573])
MAY be used to create SNMP subscriptions. MAY be used to create SNMP subscriptions.
To create a subscription via SNMP, the IPP Client MAY use an SNMP To create a subscription via SNMP, the IPP Client MAY use an SNMP
Set-Request operation to create an appropriate row in the SNMP Set-Request operation to create an appropriate row in the SNMP
Notification MIB with the following variable-bindings: Notification MIB with the following variable-bindings:
1) 'snmpNotifyTag' 1) 'snmpNotifyTag'
skipping to change at page 7, line 15 skipping to change at page 8, line 24
5) 'snmpTargetAddrStorageType' 5) 'snmpTargetAddrStorageType'
- persistence (volatile, nonVolatile, permanent, readOnly) - persistence (volatile, nonVolatile, permanent, readOnly)
Note: The SNMP Target MIB uses persistence instead of the lease Note: The SNMP Target MIB uses persistence instead of the lease
duration supported in IPP Subscription objects. duration supported in IPP Subscription objects.
3.3. Relationship to other MIBs 3.3. Relationship to other MIBs
3.3.1. MIB-II (RFC 1213) 3.3.1. MIB-II (RFC 1213)
All SNMPv1 trap messages include 'time-stamp' which is the value of All SNMPv1 Trap messages include 'time-stamp' which is the value of
the 'sysUpTime' object from MIB-II [RFC-1213]. the 'sysUpTime' object from MIB-II [RFC-1213].
All SNMPv2 trap bindings include the 'sysUpTime' object from MIB-II All SNMPv2 trap bindings include the 'sysUpTime' object from MIB-II
[RFC-1213]. [RFC-1213].
3.3.2. Host Resources MIB (RFC 2790) 3.3.2. Host Resources MIB (RFC 2790)
The 'jmServiceTable' defined in this document MAY have a sparse The 'jmServiceTable' defined in this document MAY have a sparse
mapping to the 'hrDeviceTable' (same indices) in Host Resources MIB mapping to the 'hrDeviceTable' (same indices) in Host Resources MIB
[RFC-2790]. [RFC-2790].
3.3.3. Printer MIB (RFC 1759) 3.3.3. Printer MIB (RFC 1759)
The 'jmServiceTable' defined in this document MAY have a sparse The 'jmServiceTable' defined in this document MAY have a sparse
mapping to the 'hrDeviceTable' (same indices) in Host Resources MIB mapping to the 'hrDeviceTable' (same indices) in Host Resources MIB
[RFC-2790], thus offering access to the Printer MIB via a [RFC-2790], thus offering access to the Printer MIB via a
'hrDeviceIndex' value. 'hrDeviceIndex' value.
4. Managed Object Definitions 4. General Information
4.1. Notification Definitions 4.1. Table 1 - Information about the Delivery Method
4.1.1. Service Basic Event - Trap Document Method Conformance Delivery Method Realization
Requirement
--------------------------- ---------------------------
1. What is the URL scheme name snmpnotify
for the Delivery Method?
2. Is the Delivery Method OPTIONAL
REQUIRED, RECOMMENDED or OPTIONAL
for an IPP Printer to support?
3. What transport and delivery SNMP application layer
protocols does the Printer use over UDP transport layer
to deliver the Event over IP network layer
Notification Content, i.e., over any datalink layer
what is the entire network (or SNMP over any other
stack? transport stack)
4. Can several Event No, impossible in SNMP
Notifications be combined into (in an interoperable fashion)
a Compound Event Notification?
5. Is the Delivery Method By the Printer (push)
initiated by the Notification
Recipient (pull), or by the
Printer (push)?
6. Is the Event Notification Machine Consumable
content Machine Consumable or
Human Consumable?
7. What section in this document Section 7 'SNMP ASN.1 for
answers the following for IPP Notifications'.
question? For a Machine
Consumable Event Notification,
what is the representation and
encoding of values defined in
section 0 of [ipp-ntfy] and
the conformance requirements
thereof? For a Human
Consumable Event Notification,
what is the representation and
encoding of pieces of
information defined in section
9.2 of [ipp-ntfy] and the
conformance requirements
thereof?
8. What are the latency and The latency is minimal in
reliability of the transport any network topology (all
and delivery protocol? deployed transport mappings
of SNMP are connectionless).
The reliability is medium for
SNMP Trap (unacknowledged)
and high for SNMP Inform
(acknowledged and optionally
retried by the SNMP agent).
9. What are the security aspects SNMPv1 and SNMPv2 support
of the transport and delivery community-based security with
protocol, e.g., how it is very weak authentication.
handled in firewalls? SNMPv3 (RFC 257x series)
supports user-based security
with strong authentication
and MAY traverse firewalls
(but usually does not).
10. What are the content length SNMP messages MUST be encoded
restrictions? within the 'path MTU', i.e.,
the packet is NOT fragmented
by the underlying network.
In some IP networks, this
results in a max payload of
about 480 octets.
See section 5.2.4
'notify-snmp-mtu-size'.
11. What are the additional The 'job-completed' SNMP
values or pieces of notification delivers
information that a Printer 'job-k-octets-processed' as
sends in an Event Notification as well as the base required
content and the conformance 'job-impressions-completed'
requirements thereof? - and both are REQUIRED
(for interoperability)
12. What are the additional See section 5.1
Subscription Template and/or 'Table 2 - Subscription
Subscription Description and Printer Attributes'
attributes and the conformance - all of the additional
requirements thereof? subscription template
attributes are REQUIRED
(for interoperability)
13. What are the additional See section 5.1
Printer Description attributes 'Table 2 - Subscription
and the conformance and Printer Attributes'
requirements thereof? - all of the additional
printer description
attributes are REQUIRED
(for interoperability).
5. Subscription Template Attributes
5.1. Table 2 - Subscription and Printer Attributes
All systems that support this specification MUST implement the
following REQUIRED attributes defined in this specification (on the
Subscription object or the Printer object):
Subscription Attribute Subscription Attribute Type
Printer Attribute Printer Attribute Type
----------------------------------- --------------------------
notify-snmp-version (type2 keyword)
notify-snmp-version-default (type2 keyword)
notify-snmp-version-supported (1setOf type2 keyword)
notify-snmp-auth-data (octetString(MAX))
notify-snmp-auth-data-default (octetString(MAX))
notify-snmp-auth-data-supported (boolean)
notify-snmp-operation (type2 keyword)
notify-snmp-operation-default (type2 keyword)
notify-snmp-operation-supported (1setOf type2 keyword)
notify-snmp-mtu-size (integer(0:MAX))
notify-snmp-mtu-size-default (integer(0:MAX))
notify-snmp-mtu-size-supported (rangeOfInteger(0:MAX))
Note: The Printer attribute 'notify-snmp-auth-data-supported' has
the irregular type 'boolean'.
5.2. Additional Subscription Template Attributes
5.2.1. notify-snmp-version (type2 keyword)
REQUIRED - for IPP Printers to implement.
This attribute specifies the SNMP protocol version and security model
(e.g., community-based security in SNMPv1c IETF Standard [RFC-1157])
to use for delivery of this IPP Notification.
Note: SNMP protocol versions and SNMP security models are NOT
mutually independent - therefore they are combined in this single
attribute.
The following standard keyword values are defined:
'snmpv1-community': The SNMPv1 protocol with community-based
security model defined in IETF Standard [RFC-1157].
'snmpv1-party': The SNMPv1 protocol with party-based security
model defined in IETF Historic [RFC-1352].
'snmpv2-party': The SNMPv2 protocol with party-based security
model defined in IETF Historic [RFC-1446].
'snmpv2-community': The SNMPv2 protocol with community-based
security model defined in IETF Experimental [RFC-1902].
'snmpv2-user': The SNMPv2 protocol with user-based security model
defined in IETF Experimental [RFC-1910].
'snmpv3-user': The SNMPv3 protocol with user-based security model
defined in IETF Draft Standard [RFC-2574].
5.2.1.1. notify-snmp-version-default
REQUIRED - for IPP Printers to implement.
notify-snmp-version-default (type2 keyword)
IPP Printer object attribute for IPP Notifications over SNMP.
5.2.1.2. notify-snmp-version-supported
REQUIRED - for IPP Printers to implement.
notify-snmp-version-supported (1setOf type2 keyword)
IPP Printer object attribute for IPP Notifications over SNMP.
5.2.2. notify-snmp-auth-data (octetString(MAX))
REQUIRED - for IPP Printers to implement.
This attribute specifies the SNMP protocol authentication data (e.g.,
a community name in SNMPv1c IETF Standard [RFC-1157]) to use for
delivery of this IPP Notification. This data MAY be opaque (not
human-readable).
Human-readable authentication data in this attribute (e.g., an
SNMPv1c or SNMPv2c community name) MUST be encoded in the UTF-8
[RFC-2279] transform of [ISO-10646] for interoperability.
5.2.2.1. notify-snmp-auth-data-default
REQUIRED - for IPP Printers to implement.
notify-snmp-auth-data-default (octetString(MAX))
IPP Printer object attribute for IPP Notifications over SNMP.
5.2.2.2. notify-snmp-auth-data-supported
REQUIRED - for IPP Printers to implement.
notify-snmp-auth-data-supported (boolean)
IPP Printer object attribute for IPP Notifications over SNMP.
Note: The Printer attribute 'notify-snmp-auth-data-supported' has
the irregular type 'boolean'.
5.2.3. notify-snmp-operation (type2 keyword)
REQUIRED - for IPP Printers to implement.
This attribute specifies the SNMP operation (e.g, SNMP Trap in
SNMPv1c IETF Standard [RFC-1157]) to use for delivery of this IPP
Notification.
The following standard keyword values are defined:
'trap': An SNMP Trap PDU encoded in the version specified by
"notify-snmp-version" above.
Note: SNMP Trap is an unconfirmed operation (i.e., the
notification recipient MUST NOT reply with an acknowledgement) and
MUST NOT be retried by the notification generator.
'inform': An SNMP Inform PDU encoded in the version specified by
"notify-snmp-version" above.
Note: SNMP Inform is a confirmed operation (i.e., the notification
recipient MUST reply with an acknowledgement Inform-Response) and
MAY be retried by the notification generator.
'report': An SNMP Report PDU encoded in the version specified by
"notify-snmp-version" above
Warning: The use of SNMP Report MAY not be interoperable.
5.2.3.1. notify-snmp-operation-default
REQUIRED - for IPP Printers to implement.
notify-snmp-operation-default (type2 keyword)
IPP Printer object attribute for IPP Notifications over SNMP.
5.2.3.2. notify-snmp-operation-supported
REQUIRED - for IPP Printers to implement.
notify-snmp-operation-supported (1setOf type2 keyword)
IPP Printer object attribute for IPP Notifications over SNMP.
5.2.4. notify-snmp-mtu-size (integer(0:MAX))
REQUIRED - for IPP Printers to implement.
This attribute specifies the SNMP path maximum transmission unit
(MTU) size in octets to use for delivery of this IPP Notification.
The SNMP path MTU is defined as the size of the complete SNMP message
envelope, header, and body - but NOT of the underlying transport,
network, and datalink headers - such that NO fragmentation is
required for the SNMP message at ANY lower layer of the protocol
stack OR on any segment of the bridged or routed delivery path
(optimally).
This attribute enhances the integrity and probability of SNMP
delivery.
This attribute may signal the need for algorithmic truncation of some
string variable bindings in the SNMP notification which MAY not fit
in very small path MTU sizes.
See: 'ifMtu' in the Interfaces group of IETF MIB-II [RFC-1213].
5.2.4.1. notify-snmp-mtu-size-default
REQUIRED - for IPP Printers to implement.
notify-snmp-mtu-size-default (integer(0:MAX))
IPP Printer object attribute for IPP Notifications over SNMP.
5.2.4.2. notify-snmp-mtu-size-supported
REQUIRED - for IPP Printers to implement.
notify-snmp-mtu-size-supported (rangeOfInteger(0:MAX))
IPP Printer object attribute for IPP Notifications over SNMP.
5.3. Additional Info about Subscription Template Attributes
5.3.1. notify-recipient-uri (uri)
This section describes the syntax of the value of this attribute for
the 'snmpnotify' Delivery Method for IPP Notifications. The syntax
for values of this attribute for other Delivery Methods for IPP
Notifications is defined in each method's specification.
In order to support the 'snmpnotify' Delivery Method, the Printer
MUST support the following syntax for the 'snmpnotify' Delivery
Method when the Printer uses SNMP to deliver IPP Notifications. The
lines below use RFC 2396 syntax rules, terms, and ABNF productions:
"snmpnotify://" hostport
hostport = host [ ":" port ]
host = hostname | IPv4address
hostname = *( domainlabel "." ) toplabel [ "." ]
domainlabel = alphanum | alphanum *( alphanum | "-" ) alphanum
toplabel = alpha | alpha *( alphanum | "-" ) alphanum
IPv4address = 1*digit "." 1*digit "." 1*digit "." 1*digit
port = *digit
alphanum = alpha | digit
alpha = lowalpha | upalpha
lowalpha = "a" | "b" | "c" | "d" | "e" | "f" | "g" | "h" | "i" |
"j" | "k" | "l" | "m" | "n" | "o" | "p" | "q" | "r" |
"s" | "t" | "u" | "v" | "w" | "x" | "y" | "z"
upalpha = "A" | "B" | "C" | "D" | "E" | "F" | "G" | "H" | "I" |
"J" | "K" | "L" | "M" | "N" | "O" | "P" | "Q" | "R" |
"S" | "T" | "U" | "V" | "W" | "X" | "Y" | "Z"
digit = "0" | "1" | "2" | "3" | "4" | "5" | "6" | "7" |
"8" | "9"
6. Event Notification Content
6.1. SNMP Message Envelope
6.1.1. SNMPv1 Message Envelope
The SNMPv1 [RFC-1157] message envelope for SNMPv1c (community-based
security) contains the following:
6.1.1.1. version (INTEGER)
The SNMP protocol version (not the IPP version) for this message.
6.1.1.2. community (OCTET STRING)
The SNMP community name (read, write, or notify) for this message.
Used for weak authentication.
6.1.2. SNMPv2 Message Envelope
The SNMPv2 [RFC-1905] message envelope for SNMPv2c (community-based
security) [RFC-1901] contains the following:
6.1.2.1. version (INTEGER)
The SNMP protocol version (not the IPP version) for this message.
6.1.2.2. community (OCTET STRING)
The SNMP community name (read, write, or notify) for this message.
Used for weak authentication.
6.1.3. SNMPv3 Message Envelope
The SNMPv2 [RFC-1905] message envelope for SNMPv3u (user-based
security) [RFC-2574] contains the following:
6.1.3.1. msgVersion (INTEGER)
The SNMP protocol version (not the IPP version) for this message.
6.1.3.2. msgGlobalData (HeaderData)
Administrative parameters. The SNMP ASN.1 definition is as follows:
HeaderData ::= SEQUENCE {
msgID INTEGER (0..2147483647),
msgMaxSize INTEGER (484..2147483647),
msgFlags OCTET STRING (SIZE(1)),
msgSecurityModel INTEGER (1..2147483647)
}
6.1.3.3. msgSecurityParameters (OCTET STRING)
Security model-specific parameters.
See: 'User-based Security Model (USM) for SNMPv3' [RFC-2574].
6.1.3.4. msgData (ScopedPduData)
Scoped message body. The SNMP ASN.1 definition is as follows:
ScopedPduData ::= CHOICE {
plaintext ScopedPDU,
encryptedPDU OCTET STRING -- encrypted scopedPDU value
}
ScopedPDU ::= SEQUENCE {
contextEngineID OCTET STRING,
contextName OCTET STRING,
data ANY -- e.g., PDUs as defined in RFC 1905
}
6.2. SNMP Message Header
6.2.1. SNMPv1 Trap Message Header
Note: The 'request-id' (SNMP sequence number) is NOT encoded in the
SNMPv1 Trap, whereas the SNMPv2 and SNMPv3 Trap/Inform requests DO
have 'request-id' in their message header.
6.2.1.1. enterprise (OBJECT IDENTIFIER)
The value of 'sysObjectID' (system type) in IETF MIB-II [RFC-1213]
for the system that generated this SNMPv1 Trap.
6.2.1.2. agent-addr (NetworkAddress)
The network address of the SNMP agent that generated this SNMPv1
Trap.
6.2.1.3. generic-trap (INTEGER)
The base type of this SNMPv1 Trap: always 'enterpriseSpecific' in
IPP Notifications).
6.2.1.4. specific-trap (INTEGER)
The specific type of this SNMPv1 Trap.
6.2.1.5. time-stamp (TimeTicks)
The value of 'sysUpTime' in IETF MIB-II [RFC-1213] when this SNMPv1
Trap was generated.
6.2.2. SNMPv2 and SNMPv3 Trap/Inform Message Header
Note: The 'request-id' (SNMP sequence number) is NOT encoded in the
SNMPv1 Trap, whereas the SNMPv2 and SNMPv3 Trap/Inform requests DO
have 'request-id' in their message header.
6.2.2.1. request-id (Integer32)
The receiver-specific sequence number for this SNMP message.
See: Section 5.4.2 'notify-sequence-number' in [IPP-NOT].
6.2.2.2. error-status (INTEGER)
The error status associated with this SNMP message.
6.2.2.3. error-index (INTEGER)
Unused in SNMP Trap messages.
6.3. SNMP Message Body
6.3.1. SNMPv1 Trap Message Body
The SNMPv1 Trap message body consists wholly of the specified
parameters
See: Section 7.1 'Notification Definitions'. in the TRAP-TYPE
definition.
6.3.2. SNMPv2 and SNMPv3 Trap/Inform Message Body
The SNMPv2 and SNMPv3 Trap/Inform message body consists of the
specified parameters in the NOTIFICATION-TYPE definition PRECEDED by
'sysUpTime' from IETF MIB-II [RFC-1213] and 'sysTrapOID'.
See: Section 7.1 'Notification Definitions'.
6.3.2.1. sysUpTime (TimeTicks)
The value of 'sysUpTime' in IETF MIB-II [RFC-1213] when this SNMPv2
or SNMPv3 Trap/Inform was generated.
6.3.2.2. sysTrapOID (OBJECT IDENTIFIER)
The specific type of this SNMPv2 or SNMPv3 Trap/Inform. The value of
the assignment statement at the end of the NOTIFICATION-TYPE
definition.
6.4. SNMP Trap/Inform Examples
[To be supplied]
7. SNMP ASN.1 for IPP Notifications
7.1. Notification Definitions
7.1.1. Service Event Notify Group - Trap
-- Service Event Notify Group (CONDITIONALLY MANDATORY)
-- --
-- Implementation of this group is conditionally mandatory; -- Implementation of this group is conditionally mandatory;
-- mandatory for systems which send Service traps via SNMP.
-- The jmServiceEventNotifyGroup consists entirely of the
-- jmServiceEventV2Notify notification.
jmServiceBasicV1Enterprise OBJECT-IDENTITY jmServiceEventV1Enterprise OBJECT-IDENTITY
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The value of the enterprise-specific OID in an SNMPv1 trap "The value of the enterprise-specific OID in an SNMPv1 trap
for a Service basic event sent by this managed system." for a Service basic event sent by this managed system."
::= { jobmonMIBNotifications 1 } ::= { jobmonMIBNotifications 1 }
jmServiceBasicV2EventPrefix jmServiceEventV2NotifyPrefix
OBJECT IDENTIFIER ::= { jmServiceBasicV1Enterprise 0 } OBJECT IDENTIFIER ::= { jmServiceEventV1Enterprise 0 }
jmServiceBasicV2Event NOTIFICATION-TYPE jmServiceEventV2Notify NOTIFICATION-TYPE
OBJECTS { OBJECTS {
jmServiceEventNotifyEvent, jmServiceEventNotifyTriggerEvent,
jmServiceEventNotifyGroupEvent,
jmServiceState, jmServiceState,
jmServiceStateReasons jmServiceStateReasons
} }
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This SMIv2 trap corresponds to an IPP Printer basic event. "This SMIv2 trap corresponds to an IPP Printer basic event.
The value of 'jmServiceIndex' for The value of 'jmServiceIndex' for
use with 'jmServiceTable' for this Service is conveyed in the use with 'jmServiceTable' for this Service is conveyed in the
instance qualifier (OID suffix) of 'jmServiceState'. instance qualifier (OID suffix) of 'jmServiceState'.
This trap is sent when requested by a prior subscription. This trap is sent when requested by a prior subscription.
The subscribed event type is in 'jmServiceEventNotifyEvent'. The specific event is in 'jmServiceEventNotifyTriggerEvent'.
The group event is in 'jmServiceEventNotifyGroupEvent'.
Standard Printer event types defined in [IPP-NOT] are:
- 'printer-state-changed'
- 'printer-restarted'
- 'printer-shutdown'
- 'printer-config-changed'
- 'printer-media-changed'
- 'printer-finishings-changed'
- 'printer-queue-order-changed'
- 'printer-full'
- 'printer-no-longer-full'
- 'printer-almost-idle'
- 'printer-not-almost-idle'
Standard Service event types generalized from [IPP-NOT] are:
- 'service-state-changed'
- 'service-restarted'
- 'service-shutdown'
- 'service-config-changed'
- 'service-media-changed'
- 'service-finishings-changed'
- 'service-queue-order-changed'
- 'service-full'
- 'service-no-longer-full'
- 'service-almost-idle'
- 'service-not-almost-idle'
- and (optionally) vendor extension event types
Additional variable-bindings SHOULD be appended to this trap: Additional variable-bindings SHOULD be appended to this trap:
- Systems with the Host Resources MIB (RFC 2790) SHOULD add - Systems with the Host Resources MIB (RFC 2790) SHOULD add
'hrSystemDate' 'hrSystemDate'
(compare to IPP 'printer-current-time') (compare to IPP 'printer-current-time')
Additional variable-bindings MAY be appended to this trap Additional variable-bindings MAY be appended to this trap
for all printer-specific events: for all printer-specific events:
- Systems with the Host Resources MIB (RFC 2790) MAY add - Systems with the Host Resources MIB (RFC 2790) MAY add
'hrDeviceStatus' 'hrDeviceStatus'
(compare to IPP 'printer-state') (compare to IPP 'printer-state')
'hrPrinterStatus' 'hrPrinterStatus'
(compare to IPP 'printer-state') and (compare to IPP 'printer-state') and
'hrPrinterDetectedErrorState' 'hrPrinterDetectedErrorState'
(compare to IPP 'printer-state-reasons') (compare to IPP 'printer-state-reasons')
Systems MAY add other variable-bindings from any MIB. Systems MAY add other variable-bindings from any MIB.
See: Section 5.3.2 'notify-events' in [IPP-NOT]; See: Standard events in 'jmServiceEventNotifyTriggerEvent';
Section 5.3.2 'notify-events' in [IPP-NOT];
Section 8.1 'notify-subscribed-event' in [IPP-NOT]; Section 8.1 'notify-subscribed-event' in [IPP-NOT];
Section 9 'Event Notification Content' in [IPP-NOT]." Section 9 'Event Notification Content' in [IPP-NOT]."
::= { jmServiceBasicV2EventPrefix 1 } ::= { jmServiceEventV2NotifyPrefix 1 }
4.1.2. Job Basic Event - Trap 7.1.2. Job Event Notify Group - Trap
-- Job Event Notify Group (CONDITIONALLY MANDATORY)
-- --
-- Implementation of this group is conditionally mandatory; -- Implementation of this group is conditionally mandatory;
-- mandatory for systems which send this Job trap via SNMP.
-- The jmJobEventNotifyGroup consists entirely of the
-- jmJobEventV2Notify notification.
jmJobBasicV1Enterprise OBJECT-IDENTITY jmJobEventV1Enterprise OBJECT-IDENTITY
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The value of the enterprise-specific OID in an SNMPv1 trap "The value of the enterprise-specific OID in an SNMPv1 trap
for a Job basic event sent by this managed system." for a Job basic event sent by this managed system."
::= { jobmonMIBNotifications 2 } ::= { jobmonMIBNotifications 2 }
jmJobBasicV2EventPrefix jmJobEventV2NotifyPrefix
OBJECT IDENTIFIER ::= { jmJobBasicV1Enterprise 0 } OBJECT IDENTIFIER ::= { jmJobEventV1Enterprise 0 }
jmJobBasicV2Event NOTIFICATION-TYPE jmJobEventV2Notify NOTIFICATION-TYPE
OBJECTS { OBJECTS {
jmJobEventNotifyEvent, jmJobEventNotifyTriggerEvent,
jmJobEventNotifyGroupEvent,
jmJobState, jmJobState,
jmJobEventJobStateReasons jmJobEventJobStateReasons
} }
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This SMIv2 trap corresponds to an IPP Job basic event. "This SMIv2 trap corresponds to an IPP Job basic event.
The values of 'jmGeneralJobSetIndex' and 'jmJobIndex' for The values of 'jmGeneralJobSetIndex' and 'jmJobIndex' for
use with 'jmJobTable' for this Job are conveyed in the use with 'jmJobTable' for this Job are conveyed in the
instance qualifier (OID suffix) of 'jmJobState'. instance qualifier (OID suffix) of 'jmJobState'.
This trap is sent when requested by a prior subscription. This trap is sent when requested by a prior subscription.
The subscribed event type is in 'jmJobEventNotifyEvent'. The specific event is in 'jmJobEventNotifyTriggerEvent'.
The group event is in 'jmJobEventNotifyGroupEvent'.
Event types reported via 'jmJobBasicV2Event' include:
- 'job-state-changed'
- 'job-created'
- 'job-completed'
- 'job-purged'
- 'job-config-changed'
- and (optionally) vendor extension event types
Additional variable-bindings SHOULD be appended to this trap: Additional variable-bindings SHOULD be appended to this trap:
- Systems with the Host Resources MIB (RFC 2790) SHOULD add - Systems with the Host Resources MIB (RFC 2790) SHOULD add
'hrSystemDate' 'hrSystemDate'
(compare to IPP 'printer-current-time') (compare to IPP 'printer-current-time')
Systems MAY add other variable-bindings from any MIB. Systems MAY add other variable-bindings from any MIB.
See: Section 5.3.2 'notify-events' in [IPP-NOT]; See: Standard events in 'jmJobEventNotifyTriggerEvent';
Section 5.3.2 'notify-events' in [IPP-NOT];
Section 8.1 'notify-subscribed-event' in [IPP-NOT]; Section 8.1 'notify-subscribed-event' in [IPP-NOT];
Section 9 'Event Notification Content' in [IPP-NOT]." Section 9 'Event Notification Content' in [IPP-NOT]."
::= { jmJobBasicV2EventPrefix 1 } ::= { jmJobEventV2NotifyPrefix 1 }
4.1.3. Job Completed Event - Trap 7.1.3. Job Completed Notify Group - Trap
-- Job Completed Notify Group (CONDITIONALLY MANDATORY)
-- --
-- Implementation of this group is conditionally mandatory; -- Implementation of this group is conditionally mandatory;
-- mandatory for systems which send this Job trap via SNMP.
jmJobCompletedV1Enterprise OBJECT-IDENTITY jmJobCompletedV1Enterprise OBJECT-IDENTITY
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The value of the enterprise-specific OID in an SNMPv1 trap "The value of the enterprise-specific OID in an SNMPv1 trap
for a Job completed event sent by this managed system." for a Job completed event sent by this managed system."
::= { jobmonMIBNotifications 3 } ::= { jobmonMIBNotifications 3 }
jmJobCompletedV2EventPrefix jmJobCompletedV2NotifyPrefix
OBJECT IDENTIFIER ::= { jmJobCompletedV1Enterprise 0 } OBJECT IDENTIFIER ::= { jmJobCompletedV1Enterprise 0 }
jmJobCompletedV2Event NOTIFICATION-TYPE jmJobCompletedV2Notify NOTIFICATION-TYPE
OBJECTS { OBJECTS {
jmJobEventNotifyEvent,
jmJobState, jmJobState,
jmJobEventJobStateReasons, jmJobEventJobStateReasons,
jmJobKOctetsProcessed, jmJobKOctetsProcessed,
jmJobImpressionsCompleted jmJobImpressionsCompleted
} }
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This SMIv2 trap corresponds to an IPP 'job-completed' event. "This SMIv2 trap corresponds to an IPP 'job-completed' event.
The values of 'jmGeneralJobSetIndex' and 'jmJobIndex' for The values of 'jmGeneralJobSetIndex' and 'jmJobIndex' for
use with 'jmJobTable' for this Job are conveyed in the use with 'jmJobTable' for this Job are conveyed in the
instance qualifier (OID suffix) of 'jmJobState'. instance qualifier (OID suffix) of 'jmJobState'.
This trap is sent when requested by a prior subscription. This trap is sent when requested by a prior subscription.
The subscribed event type is in 'jmJobEventNotifyEvent'. The event type is 'job-completed'.
Event types reported via 'jmJobCompletedV2Event' include:
- 'job-completed'
- 'job-purged'
- and (optionally) vendor extension event types
Additional variable-bindings SHOULD be appended to this trap: Additional variable-bindings SHOULD be appended to this trap:
- Systems with the Host Resources MIB (RFC 2790) SHOULD add - Systems with the Host Resources MIB (RFC 2790) SHOULD add
'hrSystemDate' 'hrSystemDate'
(compare to IPP 'printer-current-time') (compare to IPP 'printer-current-time')
Systems MAY add other variable-bindings from any MIB. Systems MAY add other variable-bindings from any MIB.
See: Section 5.3.2 'notify-events' in [IPP-NOT]; See: Section 5.3.2 'notify-events' in [IPP-NOT];
Section 8.1 'notify-subscribed-event' in [IPP-NOT]; Section 8.1 'notify-subscribed-event' in [IPP-NOT];
Section 9 'Event Notification Content' in [IPP-NOT]." Section 9 'Event Notification Content' in [IPP-NOT]."
::= { jmJobCompletedV2EventPrefix 1 } ::= { jmJobCompletedV2NotifyPrefix 1 }
4.1.4. Job Progress Event - Trap 7.1.4. Job Progress Notify Group - Trap
-- Job Progress Notify Group (CONDITIONALLY MANDATORY)
-- --
-- Implementation of this group is conditionally mandatory; -- Implementation of this group is conditionally mandatory;
-- mandatory for systems which send this Job trap via SNMP.
jmJobProgressV1Enterprise OBJECT-IDENTITY jmJobProgressV1Enterprise OBJECT-IDENTITY
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The value of the enterprise-specific OID in an SNMPv1 trap "The value of the enterprise-specific OID in an SNMPv1 trap
for a Job progress event sent by this managed system." for a Job progress event sent by this managed system."
::= { jobmonMIBNotifications 4 } ::= { jobmonMIBNotifications 4 }
jmJobProgressV2EventPrefix jmJobProgressV2NotifyPrefix
OBJECT IDENTIFIER ::= { jmJobProgressV1Enterprise 0 } OBJECT IDENTIFIER ::= { jmJobProgressV1Enterprise 0 }
jmJobProgressV2Event NOTIFICATION-TYPE jmJobProgressV2Notify NOTIFICATION-TYPE
OBJECTS { OBJECTS {
jmJobKOctetsPerCopyRequested, jmJobKOctetsPerCopyRequested,
jmJobKOctetsProcessed, jmJobKOctetsProcessed,
jmJobImpressionsPerCopyRequested, jmJobImpressionsPerCopyRequested,
jmJobImpressionsCompleted, jmJobImpressionsCompleted,
jmProgressJobCopiesRequested, jmProgressJobCopiesRequested,
jmProgressJobCollationType, jmProgressJobCollationType,
jmProgressMediaSheetsCompleted, jmProgressMediaSheetsCompleted,
jmProgressSheetCompletedCopyNum, jmProgressSheetCompletedCopyNum,
jmProgressSheetCompletedDocNum jmProgressSheetCompletedDocNum
skipping to change at page 13, line 11 skipping to change at page 25, line 27
Additional variable-bindings SHOULD be appended to this trap: Additional variable-bindings SHOULD be appended to this trap:
- Systems with the Host Resources MIB (RFC 2790) SHOULD add - Systems with the Host Resources MIB (RFC 2790) SHOULD add
'hrSystemDate' 'hrSystemDate'
(compare to IPP 'printer-current-time') (compare to IPP 'printer-current-time')
Systems MAY add other variable-bindings from any MIB. Systems MAY add other variable-bindings from any MIB.
See: Section 5.3.2 'notify-events' in [IPP-NOT]; See: Section 5.3.2 'notify-events' in [IPP-NOT];
Section 8.1 'notify-subscribed-event' in [IPP-NOT]; Section 8.1 'notify-subscribed-event' in [IPP-NOT];
Section 9 'Event Notification Content' in [IPP-NOT]." Section 9 'Event Notification Content' in [IPP-NOT]."
::= { jmJobProgressV2EventPrefix 1 } ::= { jmJobProgressV2NotifyPrefix 1 }
4.2. Object Definitions 7.2. Object Definitions
4.2.1. Service Group - Objects 7.2.1. Service Group - Objects
-- The Service Group (CONDITIONALLY MANDATORY) -- The Service Group (CONDITIONALLY MANDATORY)
-- --
-- Implementation of this group is conditionally mandatory; -- Implementation of this group is conditionally mandatory;
-- mandatory for systems which show Service state via SNMP. -- mandatory for systems which show Service state via SNMP.
-- The jmServiceGroup consists entirely of the jmServiceTable -- The jmServiceGroup consists entirely of the jmServiceTable
jmService OBJECT IDENTIFIER ::= { jobmonMIBObjects 7 } jmService OBJECT IDENTIFIER ::= { jobmonMIBObjects 7 }
skipping to change at page 16, line 32 skipping to change at page 28, line 49
DESCRIPTION DESCRIPTION
"The service state reasons associated with this service state "The service state reasons associated with this service state
(as a comma-separated list) or the empty string (if none). (as a comma-separated list) or the empty string (if none).
See: 'jmServiceEventServiceStateReasons' object in this MIB; See: 'jmServiceEventServiceStateReasons' object in this MIB;
'jmJobStateReasons1' object in this MIB; 'jmJobStateReasons1' object in this MIB;
Section 4.4.12 'printer-state-reasons' in [IPP-MOD]." Section 4.4.12 'printer-state-reasons' in [IPP-MOD]."
DEFVAL { ''H } -- no service state reasons DEFVAL { ''H } -- no service state reasons
::= { jmServiceEntry 8 } ::= { jmServiceEntry 8 }
4.2.2. Service Event Group - Objects 7.2.2. Service Event Group - Objects
-- The Service Event Group (CONDITIONALLY MANDATORY) -- The Service Event Group (CONDITIONALLY MANDATORY)
-- --
-- Implementation of this group is conditionally mandatory; -- Implementation of this group is conditionally mandatory;
-- mandatory for systems which show Service events via SNMP. -- mandatory for systems which show Service events via SNMP.
-- The jmServiceEventGroup consists entirely of the jmServiceEventTable -- The jmServiceEventGroup consists entirely of the jmServiceEventTable
jmServiceEvent OBJECT IDENTIFIER ::= { jobmonMIBObjects 8 } jmServiceEvent OBJECT IDENTIFIER ::= { jobmonMIBObjects 8 }
jmServiceEventTable OBJECT-TYPE jmServiceEventTable OBJECT-TYPE
SYNTAX SEQUENCE OF JmServiceEventEntry SYNTAX SEQUENCE OF JmServiceEventEntry
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
skipping to change at page 17, line 16 skipping to change at page 29, line 32
SYNTAX JmServiceEventEntry SYNTAX JmServiceEventEntry
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"Basic service event information." "Basic service event information."
INDEX { jmServiceEventIndex } INDEX { jmServiceEventIndex }
::= { jmServiceEventTable 1 } ::= { jmServiceEventTable 1 }
JmServiceEventEntry ::= SEQUENCE { JmServiceEventEntry ::= SEQUENCE {
jmServiceEventIndex Integer32 (1..2147483647), jmServiceEventIndex Integer32 (1..2147483647),
jmServiceEventNotifyEvent SnmpAdminString (SIZE (0..63)), jmServiceEventNotifyTriggerEvent SnmpAdminString (SIZE (0..63)),
jmServiceEventNotifyGroupEvent SnmpAdminString (SIZE (0..63)),
jmServiceEventNotifyTime TimeTicks, jmServiceEventNotifyTime TimeTicks,
jmServiceEventServiceIndex Integer32 (1..2147483647), jmServiceEventServiceIndex Integer32 (1..2147483647),
jmServiceEventServiceState JmServiceStateTC, jmServiceEventServiceState JmServiceStateTC,
jmServiceEventServiceStateReasons SnmpAdminString (SIZE (0..255)) jmServiceEventServiceStateReasons SnmpAdminString (SIZE (0..255))
} }
jmServiceEventIndex OBJECT-TYPE jmServiceEventIndex OBJECT-TYPE
SYNTAX Integer32 (1..2147483647) SYNTAX Integer32 (1..2147483647)
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The unique identifier for this event on this managed system." "The unique identifier for this event on this managed system."
::= { jmServiceEventEntry 1 } ::= { jmServiceEventEntry 1 }
jmServiceEventNotifyEvent OBJECT-TYPE jmServiceEventNotifyTriggerEvent OBJECT-TYPE
SYNTAX SnmpAdminString (SIZE (0..63)) -- 255 in [IPP-NOT] SYNTAX SnmpAdminString (SIZE (0..63)) -- 255 in [IPP-NOT]
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The event type that created this row in 'jmServiceEventTable'. "Specific event that created this row in 'jmServiceEventTable'.
For example, 'printer-stopped' here and 'printer-state-changed'
in 'jmServiceEventNotifyGroupEvent'. Whereas a transition of
'jmServiceState' from 'idle' to 'processing' would report
'printer-state-changed' in both 'jmService...Event' objects.
Standard Printer event types defined in [IPP-NOT] are: Standard Printer event types defined in [IPP-NOT] are:
- 'printer-state-changed' - 'printer-state-changed' (group event)
- 'printer-restarted' - 'printer-restarted'
- 'printer-shutdown' - 'printer-shutdown'
- 'printer-config-changed' - 'printer-stopped'
- 'printer-config-changed' (group event)
- 'printer-media-changed' - 'printer-media-changed'
- 'printer-finishings-changed' - 'printer-finishings-changed'
- 'printer-queue-order-changed' - 'printer-queue-order-changed' (group event)
- 'printer-full'
- 'printer-no-longer-full'
- 'printer-almost-idle'
- 'printer-not-almost-idle'
Standard Service event types generalized from [IPP-NOT] are: Standard Service event types generalized from [IPP-NOT] are:
- 'service-state-changed' - 'service-state-changed' (group event)
- 'service-restarted' - 'service-restarted'
- 'service-shutdown' - 'service-shutdown'
- 'service-config-changed' - 'service-stopped'
- 'service-config-changed' (group event)
- 'service-media-changed' - 'service-media-changed'
- 'service-finishings-changed' - 'service-finishings-changed'
- 'service-queue-order-changed' - 'service-queue-order-changed' (group event)
- 'service-full' - and (optionally) vendor extension event types
- 'service-no-longer-full'
- 'service-almost-idle'
- 'service-not-almost-idle'
Conformance: The natural language for keywords Conformance: The natural language for keywords
in subscribed event type SHALL always be US English. in event type SHALL always be US English.
Conformance: This subscribed event type SHALL be valid
and reported in ALL Job Monitoring MIB notifications.
See: Section 8.1 'notify-subscribed-event' in [IPP-NOT]." See: 'jmServiceEventNotifyGroupEvent' in this MIB;
DEFVAL { ''H } -- no notify subscribed event Section 8.1 'notify-subscribed-event' in [IPP-NOT]."
DEFVAL { ''H } -- no notify event
::= { jmServiceEventEntry 2 } ::= { jmServiceEventEntry 2 }
jmServiceEventNotifyGroupEvent OBJECT-TYPE
SYNTAX SnmpAdminString (SIZE (0..63)) -- 255 in [IPP-NOT]
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"Group event that created this row in 'jmServiceEventTable'.
For example, 'printer-state-changed' here and 'printer-stopped'
in 'jmServiceEventNotifyTriggerEvent'. Whereas a transition of
'jmServiceState' from 'idle' to 'processing' would report
'printer-state-changed' in both 'jmService...Event' objects.
Conformance: The natural language for keywords
in event type SHALL always be US English.
See: Standard events in 'jmServiceEventNotifyTriggerEvent';
Section 8.1 'notify-subscribed-event' in [IPP-NOT]."
DEFVAL { ''H } -- no notify event
::= { jmServiceEventEntry 3 }
jmServiceEventNotifyTime OBJECT-TYPE jmServiceEventNotifyTime OBJECT-TYPE
SYNTAX TimeTicks SYNTAX TimeTicks
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The time of this service event. "The time of this service event.
Usage: Conforming management agents, which MUST implement the Usage: Conforming management agents, which MUST implement the
IETF MIB-II (RFC 1213), SHALL set 'jmServiceEventNotifyTime' to IETF MIB-II (RFC 1213), SHALL set 'jmServiceEventNotifyTime' to
'sysUpTime' when a service event row is created. 'sysUpTime' when a service event row is created.
See: 'sysUpTime' in IETF MIB-II (RFC 1213); See: 'sysUpTime' in IETF MIB-II (RFC 1213);
Section 5.4.4 'notify-printer-up-time' in [IPP-NOT]; Section 5.4.4 'notify-printer-up-time' in [IPP-NOT];
Section 4.4.29 'printer-up-time' in [IPP-MOD]." Section 4.4.29 'printer-up-time' in [IPP-MOD]."
::= { jmServiceEventEntry 3 } ::= { jmServiceEventEntry 4 }
jmServiceEventServiceIndex OBJECT-TYPE jmServiceEventServiceIndex OBJECT-TYPE
SYNTAX Integer32 (1..2147483647) SYNTAX Integer32 (1..2147483647)
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The unique identifier for this service on this managed system. "The unique identifier for this service on this managed system.
See: 'jmServiceIndex' object in this MIB." See: 'jmServiceIndex' object in this MIB."
::= { jmServiceEventEntry 4 } ::= { jmServiceEventEntry 5 }
jmServiceEventServiceState OBJECT-TYPE jmServiceEventServiceState OBJECT-TYPE
SYNTAX JmServiceStateTC SYNTAX JmServiceStateTC
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The state of this managed service at the time of this event. "The state of this managed service at the time of this event.
See: 'jmServiceState' object in this MIB; See: 'jmServiceState' object in this MIB;
'jmJobState' object in this MIB; 'jmJobState' object in this MIB;
Section 4.4.11 'printer-state' in [IPP-MOD]." Section 4.4.11 'printer-state' in [IPP-MOD]."
DEFVAL { unknown } -- unknown service state DEFVAL { unknown } -- unknown service state
::= { jmServiceEventEntry 5 } ::= { jmServiceEventEntry 6 }
jmServiceEventServiceStateReasons OBJECT-TYPE jmServiceEventServiceStateReasons OBJECT-TYPE
SYNTAX SnmpAdminString (SIZE (0..255)) -- multi-valued in IPP SYNTAX SnmpAdminString (SIZE (0..255)) -- multi-valued in IPP
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The service state reasons associated with this service state "The service state reasons associated with this service state
(as a comma-separated list) or the empty string (if none). (as a comma-separated list) or the empty string (if none).
See: 'jmServiceStateReasons' object in this MIB; See: 'jmServiceStateReasons' object in this MIB;
'jmJobStateReasons1' object in this MIB; 'jmJobStateReasons1' object in this MIB;
Section 4.4.12 'printer-state-reasons' in [IPP-MOD]." Section 4.4.12 'printer-state-reasons' in [IPP-MOD]."
DEFVAL { ''H } -- no service state reasons DEFVAL { ''H } -- no service state reasons
::= { jmServiceEventEntry 6 } ::= { jmServiceEventEntry 7 }
4.2.3. Job Event Group - Objects 7.2.3. Job Event Group - Objects
-- The Job Event Group (CONDITIONALLY MANDATORY) -- The Job Event Group (CONDITIONALLY MANDATORY)
-- --
-- Implementation of this group is conditionally mandatory; -- Implementation of this group is conditionally mandatory;
-- mandatory for systems which show Job events via SNMP. -- mandatory for systems which show Job events via SNMP.
-- The jmJobEventGroup consists entirely of the jmJobEventTable -- The jmJobEventGroup consists entirely of the jmJobEventTable
jmJobEvent OBJECT IDENTIFIER ::= { jobmonMIBObjects 9 } jmJobEvent OBJECT IDENTIFIER ::= { jobmonMIBObjects 9 }
skipping to change at page 20, line 9 skipping to change at page 32, line 39
SYNTAX JmJobEventEntry SYNTAX JmJobEventEntry
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"Basic job event information." "Basic job event information."
INDEX { jmJobEventIndex } INDEX { jmJobEventIndex }
::= { jmJobEventTable 1 } ::= { jmJobEventTable 1 }
JmJobEventEntry ::= SEQUENCE { JmJobEventEntry ::= SEQUENCE {
jmJobEventIndex Integer32 (1..2147483647), jmJobEventIndex Integer32 (1..2147483647),
jmJobEventNotifyEvent SnmpAdminString (SIZE (0..63)), jmJobEventNotifyTriggerEvent SnmpAdminString (SIZE (0..63)),
jmJobEventNotifyGroupEvent SnmpAdminString (SIZE (0..63)),
jmJobEventNotifyTime TimeTicks, jmJobEventNotifyTime TimeTicks,
jmJobEventJobSetIndex Integer32 (1..32767), jmJobEventJobSetIndex Integer32 (1..32767),
jmJobEventJobIndex Integer32 (1..2147483647), jmJobEventJobIndex Integer32 (1..2147483647),
jmJobEventJobState JmJobStateTC, jmJobEventJobState JmJobStateTC,
jmJobEventJobStateReasons OCTET STRING (SIZE (4..16)) jmJobEventJobStateReasons OCTET STRING (SIZE (4..16))
} }
jmJobEventIndex OBJECT-TYPE jmJobEventIndex OBJECT-TYPE
SYNTAX Integer32 (1..2147483647) SYNTAX Integer32 (1..2147483647)
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The unique identifier for this event on this managed system." "The unique identifier for this event on this managed system."
::= { jmJobEventEntry 1 } ::= { jmJobEventEntry 1 }
jmJobEventNotifyEvent OBJECT-TYPE jmJobEventNotifyTriggerEvent OBJECT-TYPE
SYNTAX SnmpAdminString (SIZE (0..63)) -- 255 in [IPP-NOT] SYNTAX SnmpAdminString (SIZE (0..63)) -- 255 in [IPP-NOT]
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The event type that created this row in 'jmJobEventTable'. "Specific event that created this row in 'jmJobEventTable'.
For example, 'job-stopped' here and 'job-state-changed'
in 'jmJobEventNotifyGroupEvent'. Whereas a transition of
'jmJobState' from 'pending' to 'processing' would report
'job-state-changed' in both 'jmJob...Event' objects.
Standard Job event types defined in [IPP-NOT] are: Standard Job event types defined in [IPP-NOT] are:
- 'job-state-changed' - 'job-state-changed' (group event)
- 'job-created' - 'job-created'
- 'job-completed' - 'job-completed'
- 'job-purged' - 'job-stopped'
- 'job-config-changed' - 'job-config-changed' (group event)
- 'job-progress' - 'job-progress' (group event)
- and (optionally) vendor extension event types
Conformance: The natural language for keywords Conformance: The natural language for keywords
in subscribed event type SHALL always be US English. in event type SHALL always be US English.
Conformance: This subscribed event type SHALL be valid
and reported in ALL Job Monitoring MIB notifications.
See: Section 8.1 'notify-subscribed-event' in [IPP-NOT]." See: 'jmJobEventNotifyGroupEvent' in this MIB;
DEFVAL { ''H } -- no notify subscribed event Section 8.1 'notify-subscribed-event' in [IPP-NOT]."
DEFVAL { ''H } -- no notify event
::= { jmJobEventEntry 2 } ::= { jmJobEventEntry 2 }
jmJobEventNotifyGroupEvent OBJECT-TYPE
SYNTAX SnmpAdminString (SIZE (0..63)) -- 255 in [IPP-NOT]
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"Group event that created this row in 'jmJobEventTable'.
For example, 'job-state-changed' here and 'job-stopped'
in 'jmJobEventNotifyTriggerEvent'. Whereas a transition of
'jmJobState' from 'pending' to 'processing' would report
'job-state-changed' in both 'jmJob...Event' objects.
Conformance: The natural language for keywords
in event type SHALL always be US English.
See: 'jmJobEventNotifyGroupEvent' in this MIB;
Section 8.1 'notify-subscribed-event' in [IPP-NOT]."
DEFVAL { ''H } -- no notify event
::= { jmJobEventEntry 3 }
jmJobEventNotifyTime OBJECT-TYPE jmJobEventNotifyTime OBJECT-TYPE
SYNTAX TimeTicks SYNTAX TimeTicks
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The time of this job event. "The time of this job event.
Usage: Conforming management agents, which MUST implement the Usage: Conforming management agents, which MUST implement the
IETF MIB-II (RFC 1213), SHALL set 'jmJobEventNotifyTime' to IETF MIB-II (RFC 1213), SHALL set 'jmJobEventNotifyTime' to
'sysUpTime' when a job event row is created. 'sysUpTime' when a job event row is created.
See: 'sysUpTime' in IETF MIB-II (RFC 1213); See: 'sysUpTime' in IETF MIB-II (RFC 1213);
Section 5.4.4 'notify-printer-up-time' in [IPP-NOT]; Section 5.4.4 'notify-printer-up-time' in [IPP-NOT];
Section 4.4.29 'printer-up-time' in [IPP-MOD]." Section 4.4.29 'printer-up-time' in [IPP-MOD]."
::= { jmJobEventEntry 3 } ::= { jmJobEventEntry 4 }
jmJobEventJobSetIndex OBJECT-TYPE jmJobEventJobSetIndex OBJECT-TYPE
SYNTAX Integer32 (1..32767) SYNTAX Integer32 (1..32767)
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The unique identifier for this job set on this managed system. "The unique identifier for this job set on this managed system.
See: 'jmGeneralJobSetIndex' object in this MIB." See: 'jmGeneralJobSetIndex' object in this MIB."
::= { jmJobEventEntry 4 } ::= { jmJobEventEntry 5 }
jmJobEventJobIndex OBJECT-TYPE jmJobEventJobIndex OBJECT-TYPE
SYNTAX Integer32 (1..2147483647) SYNTAX Integer32 (1..2147483647)
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The unique identifier for this job on this managed system, "The unique identifier for this job on this managed system,
when prefixed with 'jmJobEventJobSetIndex'. when prefixed with 'jmJobEventJobSetIndex'.
See: 'jmJobIndex' object in this MIB." See: 'jmJobIndex' object in this MIB."
::= { jmJobEventEntry 5 } ::= { jmJobEventEntry 6 }
jmJobEventJobState OBJECT-TYPE jmJobEventJobState OBJECT-TYPE
SYNTAX JmJobStateTC SYNTAX JmJobStateTC
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The state of this managed job at the time of this event. "The state of this managed job at the time of this event.
See: 'jmJobState' in this MIB; See: 'jmJobState' in this MIB;
Section 4.3.7 'job-state' in [IPP-MOD]." Section 4.3.7 'job-state' in [IPP-MOD]."
DEFVAL { unknown } -- unknown job state DEFVAL { unknown } -- unknown job state
::= { jmJobEventEntry 6 } ::= { jmJobEventEntry 7 }
jmJobEventJobStateReasons OBJECT-TYPE jmJobEventJobStateReasons OBJECT-TYPE
SYNTAX OCTET STRING (SIZE (4..16)) -- multi-valued in IPP SYNTAX OCTET STRING (SIZE (4..16)) -- multi-valued in IPP
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The job state reasons associated with this job state "The job state reasons associated with this job state
represented as one to four concatenated 32-bit integers represented as one to four concatenated 32-bit integers
in network byte order (big-endian). in network byte order (big-endian).
Usage: Conforming management stations SHALL always report the Usage: Conforming management stations SHALL always report the
value of the object 'jmJobStateReasons1' in the first four value of the object 'jmJobStateReasons1' in the first four
octets of 'jmJobEventJobStateReasons' and SHOULD report values octets of 'jmJobEventJobStateReasons' and SHOULD report values
of the attributes 'jobStateReasons2', 'jobStateReasons3', and of the attributes 'jobStateReasons2', 'jobStateReasons3', and
'jobStateReasons4' in subsequent octets. 'jobStateReasons4' in subsequent octets.
See: 'jmJobStateReasons1' in this MIB; See: 'jmJobStateReasons1' in this MIB;
Section 4.3.8 'job-state-reasons' in [IPP-MOD]." Section 4.3.8 'job-state-reasons' in [IPP-MOD]."
DEFVAL { '00000000'H } -- no job state reasons DEFVAL { '00000000'H } -- no job state reasons
::= { jmJobEventEntry 7 } ::= { jmJobEventEntry 8 }
4.2.4. Job Progress Group - Objects 7.2.4. Job Progress Group - Objects
-- The Job Progress Group (CONDITIONALLY MANDATORY) -- The Job Progress Group (CONDITIONALLY MANDATORY)
-- --
-- Implementation of this group is conditionally mandatory; -- Implementation of this group is conditionally mandatory;
-- mandatory for systems which send Job progress traps via SNMP. -- mandatory for systems which send Job progress traps via SNMP.
-- The jmProgressGroup consists entirely of leaf objects for traps -- The jmProgressGroup consists entirely of leaf objects for traps
jmProgress OBJECT IDENTIFIER ::= { jobmonMIBObjects 10 } jmProgress OBJECT IDENTIFIER ::= { jobmonMIBObjects 10 }
skipping to change at page 24, line 5 skipping to change at page 37, line 5
DESCRIPTION DESCRIPTION
"The number of the job document currently being stacked for the "The number of the job document currently being stacked for the
current job or zero (if none) or '-2' (unknown). current job or zero (if none) or '-2' (unknown).
See: 'sheetCompletedDocumentNumber' attribute in this MIB; See: 'sheetCompletedDocumentNumber' attribute in this MIB;
'sheet-completed-document-number' in [IPP-PROG]; 'sheet-completed-document-number' in [IPP-PROG];
Section 9 'Event Notification Content' in [IPP-NOT]." Section 9 'Event Notification Content' in [IPP-NOT]."
DEFVAL { -2 } -- unknown sheet complete doc DEFVAL { -2 } -- unknown sheet complete doc
::= { jmProgress 5 } ::= { jmProgress 5 }
5. IANA Considerations 8. Conformance
See DESCRIPTION clauses of objects and notifications defined in section
7 'SNMP ASN.1 for IPP Notifications'.
9. IANA Considerations
None. None.
6. Internationalization Considerations 10. Internationalization Considerations
The 'jmServiceStateReasons', 'jmServiceEventServiceStateReasons', The 'jmServiceStateReasons', 'jmServiceEventServiceStateReasons',
'jmServiceEventNotifyEvent', and 'jmJobEventNotifyEvent', text string 'jmServiceEventNotify[Trigger|Group]Event', and
objects defined in this document are of type 'SnmpAdminString' (UTF-8 'jmJobEventNotify[Trigger|Group]Event' text string objects defined in
this document have a syntax (datatype) of 'SnmpAdminString' (UTF-8
stream-encoded ISO 10646/Unicode text) defined in the SNMPv3 stream-encoded ISO 10646/Unicode text) defined in the SNMPv3
Framework MIB [RFC-2571]. The natural language of these objects is Framework MIB [RFC-2571]. The natural language of these objects is
US English (they contain keywords). US English (they contain keywords which are protocol elements).
7. Security Considerations 11. Security Considerations
This IPP Notifications over SNMP mapping defines only 'read-only' This IPP Notifications over SNMP mapping defines only 'read-only'
objects. It is suitable for use with any version of SNMP, as no objects. It is suitable for use with any version of SNMP, as no
update security is required (because no configuration updates are update security is required (because no configuration updates are
supported). supported).
No sensitive information is available via IPP Notifications over No sensitive information is available via IPP Notifications over
SNMP. SNMP.
8. References 12. References
[IPP-MOD] R. deBry, T. Hastings, R. Herriot, S. Isaacson, P. Powell. [IPP-MOD] R. deBry, T. Hastings, R. Herriot, S. Isaacson, P. Powell.
IPP/1.1 Model and Semantics, <draft-ietf-ipp-model-v11-07.txt> IPP/1.1 Model and Semantics, <draft-ietf-ipp-model-v11-07.txt>
(work-in-progress), May 2000. (work-in-progress), May 2000.
[IPP-NOT] S. Isaacson, J. Martin, R. deBry, T. Hastings, M. Shepherd, [IPP-NOT] S. Isaacson, J. Martin, R. deBry, T. Hastings, M. Shepherd,
R. Bergman. IPP Event Notification Specification, R. Bergman. IPP Event Notification Specification,
<draft-ietf-ipp-not-spec-02.txt> (work-in-progress), March 2000. <draft-ietf-ipp-not-spec-04.txt> (work-in-progress), July 2000.
[IPP-PROG] T. Hastings, R. Bergman, H. Lewis. Proposed Job Progress [IPP-PROG] T. Hastings, R. Bergman, H. Lewis. Proposed Job Progress
Attributes for IPP, <draft-ietf-ipp-job-prog-00.txt> Attributes for IPP, <draft-ietf-ipp-job-prog-00.txt>
(work-in-progress), February 2000. (work-in-progress), July 2000.
[RFC-1157] J.D. Case, M. Fedor, M.L. Schoffstall, C. Davin. Simple
Network Management Protocol, RFC 1157, May 1990.
[RFC-1213] K. McCloghrie, M. Rose. MIB-II, RFC 1213, March 1991. [RFC-1213] K. McCloghrie, M. Rose. MIB-II, RFC 1213, March 1991.
[RFC-1215] M. Rose. Convention for Defining Traps for SNMPv1, RFC
1215, March 1991.
[RFC-1759] R. Smith, F. Wright, T. Hastings, S. Zilles, [RFC-1759] R. Smith, F. Wright, T. Hastings, S. Zilles,
J. Gyllenskog. Printer MIB, RFC 1759, March 1995. J. Gyllenskog. Printer MIB, RFC 1759, March 1995.
[RFC-1901] J. Case, K. McCloghrie, M. Rose, S. Waldbusser.
Introduction to Community-based SNMPv2, RFC 1901, January 1996.
[RFC-1905] J. Case, K. McCloghrie, M. Rose, S. Waldbusser. Protocol
Operations for SNMPv2, RFC 1905, January 1996.
[RFC-2396] T. Berners-Lee, R. Fielding, L. Masinter. Uniform
Resource Identifiers (URI): Generic Syntax, RFC 2396, August 1998.
[RFC-2571] D. Harrington, R. Presuhn, B. Wijnen. Architecture for [RFC-2571] D. Harrington, R. Presuhn, B. Wijnen. Architecture for
SNMP Management Frameworks, RFC 2571, April 1999. SNMP Management Frameworks, RFC 2571, April 1999.
[RFC-2573] D. Levi, P. Meyer, B. Stewart. SNMP Applications, RFC [RFC-2573] D. Levi, P. Meyer, B. Stewart. SNMP Applications, RFC
2573, April 1999. 2573, April 1999.
[RFC-2574] U. Blumenthal, B. Wijnen. User-based Security Model (USM)
for SNMPv3, RFC 2574, April 1999.
[RFC-2575] B. Wijnen, R. Presuhn, K. McCloghrie. View-based Access
Control Model (VACM) for SNMPv3, RFC 2575, April 1999.
[RFC-2576] R. Frye, D. Levi, S. Routhier, B. Wijnen. Coexistence [RFC-2576] R. Frye, D. Levi, S. Routhier, B. Wijnen. Coexistence
between Version 1, Version 2, and Version 3 of the Internet-standard between Version 1, Version 2, and Version 3 of the Internet-standard
Network Management Framework, RFC 2576, March 2000. Network Management Framework, RFC 2576, March 2000.
[RFC-2707] R. Bergman, T. Hastings, S. Isaacson, H. Lewis. Job [RFC-2707] R. Bergman, T. Hastings, S. Isaacson, H. Lewis. Job
Monitoring MIB v1.0, RFC 2707, November 1999 Monitoring MIB v1.0, RFC 2707, November 1999
[RFC-2790] P. Grillo, S. Waldbusser. Host Resources MIB, RFC 2790, [RFC-2790] P. Grillo, S. Waldbusser. Host Resources MIB, RFC 2790,
March 2000. March 2000.
9. Change Log 13. Change Log
[This section will be deleted before publication as an RFC]
Changes in reverse chronological order (most recent first). Changes in reverse chronological order (most recent first).
<draft-ietf-ipp-not-over-snmp-04.txt> - 8 August 2000
1) Deleted 'printer-full', 'printer-no-longer-full',
'printer-almost-idle', and 'printer-not-almost-idle' event types,
and added 'printer-stopped' in 'jmServiceEventNotifyTriggerEvent',
for alignment with revised [IPP-NOT];
2) Deleted 'job-purged' event type and added 'job-stopped' in
'jmJobEventNotifyTriggerEvent', for alignment with revised
[IPP-NOT];
3) Renamed 'jmServiceEventNotifyEvent' object to
'jmServiceEventNotifyTriggerEvent' (most specific event) and added
'jmServiceEventNotifyGroupEvent' (most general event), for higher
fidelity mapping to IPP 'notify-subscribed-event';
4) Renamed 'jmJobEventNotifyEvent' object to
'jmJobEventNotifyTriggerEvent' (most specific event) and added
'jmJobEventNotifyGroupEvent' (most general event), for higher
fidelity mapping to IPP 'notify-subscribed-event';
5) Renamed all NOTIFICATION-TYPEs (traps) for clarity, changing
'jmServiceBasicV2Event' to 'jmServiceEventV2Notify',
'jmJobBasicV2Event' to 'jmJobEventV2Notify',
'jmJobCompletedV2Event' to 'jmJobCompletedV2Notify', and
'jmJobProgressV2Event' to 'jmJobProgressV2Notify'.
<draft-ietf-ipp-not-over-snmp-03.txt> - 6 July 2000 <draft-ietf-ipp-not-over-snmp-03.txt> - 6 July 2000
1) Added 'SnmpAdminString' to IMPORTS clause for new objects. 1) Added 'SnmpAdminString' to IMPORTS clause for new objects.
2) Corrected OID in MODULE-IDENTITY to use forward reference to 2) Corrected OID in MODULE-IDENTITY to use forward reference to
definition of 'pwg' from 'enterprises' and 'mibs' from 'pwg'. definition of 'pwg' from 'enterprises' and 'mibs' from 'pwg'.
3) Added 'JmServiceStateTC' textual convention. 3) Added 'JmServiceStateTC' textual convention.
4) Added 'jmMirrorAttr' and 'jmSystem' object identifiers reserved 4) Added 'jmMirrorAttr' and 'jmSystem' object identifiers reserved
for future extensions. for future extensions.
5) Major rewrite, per email discussion on IETF IPP WG list, to 5) Major rewrite, per email discussion on IETF IPP WG list, to
specify four new small (traditional) SNMP traps for: specify four new small (traditional) SNMP traps for:
'jmServiceBasicV2Event' (generalized from IPP Printer event), 'jmServiceBasicV2Event' (generalized from IPP Printer event),
'jmJobBasicV2Event' (corresponds IPP Job event), 'jmJobBasicV2Event' (corresponds IPP Job event),
'jmJobCompletedV2Event' (corresponds IPP Job completed event), 'jmJobCompletedV2Event' (corresponds IPP Job completed event),
'jmJobProgressV2Event' (corresponds IPP Job progress event). 'jmJobProgressV2Event' (corresponds IPP Job progress event).
6) Major rewrite, per email discussion on IETF IPP WG list, to 6) Major rewrite, per email discussion on IETF IPP WG list, to
specify four new SNMP object groups: 'jmServiceTable' (name, specify four new SNMP object groups: 'jmServiceTable' (name, URI,
URI, state, etc. - from IPP Printer), 'jmServiceEventTable' state, etc. - from IPP Printer), 'jmServiceEventTable' (records
(records IPP Printer events for polling), 'jmJobEventTable' IPP Printer events for polling), 'jmJobEventTable' (records IPP Job
(records IPP Job events for polling), 'jmJobProgressGroup' (leaf events for polling), 'jmJobProgressGroup' (leaf objects for IPP Job
objects for IPP Job progress event). progress event).
7) Revised section 3.1 'SNMP Mapping for IPP Printer Events' and 7) Revised section 3.1 'SNMP Mapping for IPP Printer Events' and
section 3.2 'SNMP Mapping for IPP Job Events', to agree with section 3.2 'SNMP Mapping for IPP Job Events', to agree with above.
above.
8) Deleted obsolete section 3.3 'Rules for Encoding Notifications', 8) Deleted obsolete section 3.3 'Rules for Encoding Notifications',
as event bindings now always fit over all SNMP transport as event bindings now always fit over all SNMP transport protocols.
protocols.
<draft-ietf-ipp-not-over-snmp-02.txt> - 19 March 2000 <draft-ietf-ipp-not-over-snmp-02.txt> - 19 March 2000
1) Renamed Printer Event notification group to Device Basic Event 1) Renamed Printer Event notification group to Device Basic Event
and 'jmPrinterEventV2Event' notification to and 'jmPrinterEventV2Event' notification to 'jmDeviceBasicV2Event',
'jmDeviceBasicV2Event', to better align with IPP and to support to better align with IPP and to support non-printing jobs.
non-printing jobs.
2) Revised 'jmDeviceBasicV2Event' notification to remove 2) Revised 'jmDeviceBasicV2Event' notification to remove
'hrDeviceStatus', 'hrPrinterStatus', 'hrDeviceStatus', 'hrPrinterStatus', 'hrPrinterDetectedErrorState'
'hrPrinterDetectedErrorState' from mandatory trap bindings from mandatory trap bindings because they were redundant, per
because they were redundant, per request of Ron Bergman. request of Ron Bergman.
3) Renamed Job Event notification group to Job Basic Event and 3) Renamed Job Event notification group to Job Basic Event and
'jmJobEventV2Event' notification to 'jmJobBasicV2Event', to 'jmJobEventV2Event' notification to 'jmJobBasicV2Event', to better
better align with IPP and to support variant job events. align with IPP and to support variant job events.
4) Defined new Job Completed Event notification group and defined 4) Defined new Job Completed Event notification group and defined
new Job Progress Event notification group, to better align with new Job Progress Event notification group, to better align with IPP
IPP and to support variant job events. and to support variant job events.
5) Renamed Event object group to Event Binding, 5) Renamed Event object group to Event Binding,
'jmEventPrinterState' to 'jmEventDeviceState', 'jmEventPrinterState' to 'jmEventDeviceState',
'jmEventPrinterStateReasons' to 'jmEventDeviceStateReasons', 'jmEventPrinterStateReasons' to 'jmEventDeviceStateReasons',
'jmEventPrinterIsAcceptingJobs' to 'jmEventPrinterIsAcceptingJobs' to 'jmEventDeviceIsAcceptingJobs',
'jmEventDeviceIsAcceptingJobs', to support non-printing jobs. to support non-printing jobs.
6) Revised Event Binding object group, adding explicit objects 6) Revised Event Binding object group, adding explicit objects
'jmEventDeviceURI', 'jmEventDeviceName', 'jmEventJobSetIndex', 'jmEventDeviceURI', 'jmEventDeviceName', 'jmEventJobSetIndex',
'jmEventJobIndex', 'jmEventJobName', 'jmEventJobState', 'jmEventJobIndex', 'jmEventJobName', 'jmEventJobState',
'jmEventJobStateReasons', 'jmEventJobKOctets', 'jmEventJobStateReasons', 'jmEventJobKOctets',
'jmEventJobKOctetsProcessed', 'jmEventJobImpressions', 'jmEventJobKOctetsProcessed', 'jmEventJobImpressions',
'jmEventJobImpressionsCompleted', 'jmEventJobMediaSheets', 'jmEventJobImpressionsCompleted', 'jmEventJobMediaSheets',
'jmEventJobMediaSheetsCompleted', 'jmEventJobMediaSheetsCompleted',
'jmEventJobImpressionsCompletedCC', 'jmEventJobCollationType', 'jmEventJobImpressionsCompletedCC', 'jmEventJobCollationType',
'jmEventJobSheetCompletedCopyNum', 'jmEventJobSheetCompletedCopyNum',
'jmEventJobSheetCompletedDocNum', per request of Ron Bergman. 'jmEventJobSheetCompletedDocNum', per request of Ron Bergman.
skipping to change at page 27, line 34 skipping to change at page 42, line 4
11) Revised 'Registration via IPP' section, to change scheme name 11) Revised 'Registration via IPP' section, to change scheme name
from 'ipp-snmp:' to 'snmpnotify:', per request of Ron Bergman. from 'ipp-snmp:' to 'snmpnotify:', per request of Ron Bergman.
<draft-ietf-ipp-not-over-snmp-01.txt> - 1 December 1999 <draft-ietf-ipp-not-over-snmp-01.txt> - 1 December 1999
1) Deleted 'JmTriggerEventTC' textual convention (see below). 1) Deleted 'JmTriggerEventTC' textual convention (see below).
2) Revised SYNTAX of 'jmEventTriggerEvent' object from 2) Revised SYNTAX of 'jmEventTriggerEvent' object from
'JmTriggerEventTC' (enumeration) to 'JmUTF8StringTC' (string), to 'JmTriggerEventTC' (enumeration) to 'JmUTF8StringTC' (string), to
support use of IPP standard keywords. support use of IPP standard keywords.
3) Added 'jmEventPrinterState', 'jmEventPrinterStateReasons', and 3) Added 'jmEventPrinterState', 'jmEventPrinterStateReasons', and
'jmEventPrinterIsAcceptingJobs' objects for consistency w/ 'jmEventPrinterIsAcceptingJobs' objects for consistency w/
[IPP-NOT] and to reduce ambiguity about printer states inherent [IPP-NOT] and to reduce ambiguity about printer states inherent in
in RFC 1759. RFC 1759.
4) Revised DESCRIPTION of 'jmPrinterEventV2Event' notification to 4) Revised DESCRIPTION of 'jmPrinterEventV2Event' notification to
add SHOULD (recommendation) for 'jmEventPrinterState', add SHOULD (recommendation) for 'jmEventPrinterState',
'jmEventPrinterStateReasons', and 'jmEventPrinterIsAcceptingJobs' 'jmEventPrinterStateReasons', and 'jmEventPrinterIsAcceptingJobs'
objects. objects.
5) Revised 'SNMP Mapping for IPP Printer Events' section to add 5) Revised 'SNMP Mapping for IPP Printer Events' section to add
direct mapping of IPP notification attributes to direct mapping of IPP notification attributes to
'jmEventPrinterState', 'jmEventPrinterStateReasons', and 'jmEventPrinterState', 'jmEventPrinterStateReasons', and
'jmEventPrinterIsAcceptingJobs' objects. 'jmEventPrinterIsAcceptingJobs' objects.
6) Revised 'Rules for Encoding Notifications' section to add 6) Revised 'Rules for Encoding Notifications' section to add
'jmEventPrinterState' and 'jmEventPrinterStateReasons'. 'jmEventPrinterState' and 'jmEventPrinterStateReasons'.
7) Revised 'IANA Considerations' section to specify there are none - 7) Revised 'IANA Considerations' section to specify there are none -
no enumerated or keyword textual conventions are now defined in no enumerated or keyword textual conventions are now defined in
this document. this document.
8) Revised 'Internationalization Considerations' section to specify 8) Revised 'Internationalization Considerations' section to specify
that US English keywords are used in 'jmEventTriggerEvent', that US English keywords are used in 'jmEventTriggerEvent',
'jmEventPrinterState', and 'jmEventPrinterStateReasons' objects 'jmEventPrinterState', and 'jmEventPrinterStateReasons' objects and
and thus no explicit natural language tagging is required. thus no explicit natural language tagging is required.
<draft-ietf-ipp-not-over-snmp-00.txt> - 10 October 1999 <draft-ietf-ipp-not-over-snmp-00.txt> - 10 October 1999
1) Initial version. 1) Initial version.
10. Intellectual Property Notice 14. Intellectual Property Notice
The IETF takes no position regarding the validity or scope of any The IETF takes no position regarding the validity or scope of any
intellectual property or other rights that might be claimed to intellectual property or other rights that might be claimed to
pertain to the implementation or use of the technology described in pertain to the implementation or use of the technology described in
this document or the extent to which any license under such rights this document or the extent to which any license under such rights
might or might not be available; neither does it represent that it might or might not be available; neither does it represent that it
has made any effort to identify any such rights. Information on the has made any effort to identify any such rights. Information on the
IETF's procedures with respect to rights in standards-track and IETF's procedures with respect to rights in standards-track and
standards-related documentation can be found in BCP-11. Copies of standards-related documentation can be found in BCP-11. Copies of
claims of rights made available for publication and any assurances of claims of rights made available for publication and any assurances of
skipping to change at page 29, line 27 skipping to change at page 43, line 27
obtain a general license or permission for the use of such obtain a general license or permission for the use of such
proprietary rights by implementers or users of this specification can proprietary rights by implementers or users of this specification can
be obtained from the IETF Secretariat. be obtained from the IETF Secretariat.
The IETF invites any interested party to bring to its attention any The IETF invites any interested party to bring to its attention any
copyrights, patents or patent applications, or other proprietary copyrights, patents or patent applications, or other proprietary
rights which may cover technology that may be required to practice rights which may cover technology that may be required to practice
this standard. Please address the information to the IETF Executive this standard. Please address the information to the IETF Executive
Director. Director.
11. Authors' Addresses 15. Authors' Addresses
Tom Hastings Tom Hastings
Xerox Corporation Xerox Corporation
701 S Aviation Blvd, MS 834-03E 701 S Aviation Blvd, MS 834-03E
El Segundo, CA 90245 El Segundo, CA 90245
Phone: +1 310-333-6413 Phone: +1 310-333-6413
Email: hastings@cp10.es.xerox.com Email: hastings@cp10.es.xerox.com
Ira McDonald Ira McDonald
High North Inc High North Inc
221 Ridge Ave 221 Ridge Ave
Grand Marais, MI 49839 Grand Marais, MI 49839
Phone: +1 906-494-2434 or +1 906-494-2697 Phone: +1 906-494-2434 or +1 906-494-2697
Email: imcdonald@sharplabs.com Email: imcdonald@sharplabs.com
Email: imcdonal@sdsp.mc.xerox.com Email: imcdonal@sdsp.mc.xerox.com
12. Full Copyright Statement 16. Full Copyright Statement
Copyright (C) The Internet Society (2000). All Rights Reserved. Copyright (C) The Internet Society (2000). All Rights Reserved.
This document and translations of it may be copied and furnished to This document and translations of it may be copied and furnished to
others, and derivative works that comment on or otherwise explain it others, and derivative works that comment on or otherwise explain it
or assist in its implementation may be prepared, copied, published or assist in its implementation may be prepared, copied, published
and distributed, in whole or in part, without restriction of any and distributed, in whole or in part, without restriction of any
kind, provided that the above copyright notice and this paragraph are kind, provided that the above copyright notice and this paragraph are
included on all such copies and derivative works. However, this included on all such copies and derivative works. However, this
document itself may not be modified in any way, such as by removing document itself may not be modified in any way, such as by removing
 End of changes. 

This html diff was produced by rfcdiff 1.25, available from http://www.levkowetz.com/ietf/tools/rfcdiff/