|
Packit |
022b05 |
Job-Monitoring-MIB DEFINITIONS ::= BEGIN
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
IMPORTS
|
|
Packit |
022b05 |
MODULE-IDENTITY, OBJECT-TYPE, enterprises,
|
|
Packit |
022b05 |
Integer32 FROM SNMPv2-SMI
|
|
Packit |
022b05 |
TEXTUAL-CONVENTION FROM SNMPv2-TC
|
|
Packit |
022b05 |
MODULE-COMPLIANCE, OBJECT-GROUP FROM SNMPv2-CONF;
|
|
Packit |
022b05 |
-- The following textual-conventions are needed to implement
|
|
Packit |
022b05 |
-- certain attributes, but are not needed to compile this MIB.
|
|
Packit |
022b05 |
-- They are provided here for convenience:
|
|
Packit |
022b05 |
-- hrDeviceIndex FROM HOST-RESOURCES-MIB
|
|
Packit |
022b05 |
-- DateAndTime FROM SNMPv2-TC
|
|
Packit |
022b05 |
-- PrtInterpreterLangFamilyTC,
|
|
Packit |
022b05 |
-- CodedCharSet FROM Printer-MIB
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
-- Use the enterprises arc assigned to the PWG which is pwg(2699).
|
|
Packit |
022b05 |
-- Group all PWG mibs under mibs(1).
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
jobmonMIB MODULE-IDENTITY
|
|
Packit |
022b05 |
LAST-UPDATED "9902190000Z"
|
|
Packit |
022b05 |
ORGANIZATION "Printer Working Group (PWG)"
|
|
Packit |
022b05 |
CONTACT-INFO
|
|
Packit |
022b05 |
"Tom Hastings
|
|
Packit |
022b05 |
Postal: Xerox Corp.
|
|
Packit |
022b05 |
Mail stop ESAE-231
|
|
Packit |
022b05 |
701 S. Aviation Blvd.
|
|
Packit |
022b05 |
El Segundo, CA 90245
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
Tel: (301)333-6413
|
|
Packit |
022b05 |
Fax: (301)333-5514
|
|
Packit |
022b05 |
E-mail: hastings@cp10.es.xerox.com
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
Send questions and comments to the Printer Working Group (PWG)
|
|
Packit |
022b05 |
using the Job Monitoring Project (JMP) Mailing List:
|
|
Packit |
022b05 |
jmp@pwg.org
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
For further information, including how to subscribe to the
|
|
Packit |
022b05 |
jmp mailing list, access the PWG web page under 'JMP':
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
http://www.pwg.org/
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
Implementers of this specification are encouraged to join the
|
|
Packit |
022b05 |
jmp mailing list in order to participate in discussions on any
|
|
Packit |
022b05 |
clarifications needed and registration proposals being reviewed
|
|
Packit |
022b05 |
in order to achieve consensus."
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"The MIB module for monitoring job in servers, printers, and
|
|
Packit |
022b05 |
other devices.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
Version: 1.0"
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
-- revision history
|
|
Packit |
022b05 |
REVISION "9902190000Z"
|
|
Packit |
022b05 |
DESCRIPTION " This version published as RFC 2707"
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
::= { enterprises pwg(2699) mibs(1) jobmonMIB(1) }
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
-- Textual conventions for this MIB module
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
JmUTF8StringTC ::= TEXTUAL-CONVENTION
|
|
Packit |
022b05 |
DISPLAY-HINT "255a"
|
|
Packit |
022b05 |
STATUS current
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"To facilitate internationalization, this TC represents
|
|
Packit |
022b05 |
information taken from the ISO/IEC IS 10646-1 character set,
|
|
Packit |
022b05 |
encoded as an octet string using the UTF-8 character encoding
|
|
Packit |
022b05 |
scheme.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
See section 3.6.1, entitled: 'Text generated by the server or
|
|
Packit |
022b05 |
device'."
|
|
Packit |
022b05 |
SYNTAX OCTET STRING (SIZE (0..63))
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
JmJobStringTC ::= TEXTUAL-CONVENTION
|
|
Packit |
022b05 |
STATUS current
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"To facilitate internationalization, this TC represents
|
|
Packit |
022b05 |
information using any coded character set registered by IANA as
|
|
Packit |
022b05 |
specified in section 3.7. While it is recommended that the
|
|
Packit |
022b05 |
coded character set be UTF-8 [UTF-8], the actual coded
|
|
Packit |
022b05 |
character set SHALL be indicated by the value of the
|
|
Packit |
022b05 |
jobCodedCharSet(8) attribute for the job.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
See section 3.6.2, entitled: 'Text supplied by the job
|
|
Packit |
022b05 |
submitter'."
|
|
Packit |
022b05 |
SYNTAX OCTET STRING (SIZE (0..63))
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
JmNaturalLanguageTagTC ::= TEXTUAL-CONVENTION
|
|
Packit |
022b05 |
STATUS current
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"An IETF RFC 1766-compliant 'language tag', with zero or more
|
|
Packit |
022b05 |
sub-tags that identify a natural language. While RFC 1766
|
|
Packit |
022b05 |
specifies that the US-ASCII values are case-insensitive, this
|
|
Packit |
022b05 |
MIB specification requires that all characters SHALL be lower
|
|
Packit |
022b05 |
case in order to simplify comparing by management applications.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
See section 3.6.1, entitled: 'Text generated by the server or
|
|
Packit |
022b05 |
device' and section 3.6.2, entitled: 'Text supplied by the job
|
|
Packit |
022b05 |
submitter'."
|
|
Packit |
022b05 |
SYNTAX OCTET STRING (SIZE (0..63))
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
JmTimeStampTC ::= TEXTUAL-CONVENTION
|
|
Packit |
022b05 |
STATUS current
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"The simple time at which an event took place. The units are
|
|
Packit |
022b05 |
in seconds since the system was booted.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
NOTE - JmTimeStampTC is defined in units of seconds, rather
|
|
Packit |
022b05 |
than 100ths of seconds, so as to be simpler for agents to
|
|
Packit |
022b05 |
implement (even if they have to implement the 100ths of a
|
|
Packit |
022b05 |
second to comply with implementing sysUpTime in MIB-II[mib-
|
|
Packit |
022b05 |
II].)
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
NOTE - JmTimeStampTC is defined as an Integer32 so that it can
|
|
Packit |
022b05 |
be used as a value of an attribute, i.e., as a value of the
|
|
Packit |
022b05 |
jmAttributeValueAsInteger object. The TimeStamp textual-
|
|
Packit |
022b05 |
convention defined in SNMPv2-TC [SMIv2-TC] is defined as an
|
|
Packit |
022b05 |
APPLICATION 3 IMPLICIT INTEGER tag, not an Integer32 which is
|
|
Packit |
022b05 |
defined in SNMPv2-SMI [SMIv2-TC] as UNIVERSAL 2 IMPLICIT
|
|
Packit |
022b05 |
INTEGER, so cannot be used in this MIB as one of the values of
|
|
Packit |
022b05 |
jmAttributeValueAsInteger."
|
|
Packit |
022b05 |
SYNTAX INTEGER (0..2147483647)
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
JmJobSourcePlatformTypeTC ::= TEXTUAL-CONVENTION
|
|
Packit |
022b05 |
STATUS current
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"The source platform type that can submit jobs to servers or
|
|
Packit |
022b05 |
devices in any of the 3 configurations.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
This is a type 2 enumeration. See Section 3.7.1.2. See also
|
|
Packit |
022b05 |
IANA operating-system-names registry."
|
|
Packit |
022b05 |
SYNTAX INTEGER {
|
|
Packit |
022b05 |
other(1),
|
|
Packit |
022b05 |
unknown(2),
|
|
Packit |
022b05 |
sptUNIX(3), -- UNIX
|
|
Packit |
022b05 |
sptOS2(4), -- OS/2
|
|
Packit |
022b05 |
sptPCDOS(5), -- DOS
|
|
Packit |
022b05 |
sptNT(6), -- NT
|
|
Packit |
022b05 |
sptMVS(7), -- MVS
|
|
Packit |
022b05 |
sptVM(8), -- VM
|
|
Packit |
022b05 |
sptOS400(9), -- OS/400
|
|
Packit |
022b05 |
sptVMS(10), -- VMS
|
|
Packit |
022b05 |
sptWindows(11), -- Windows
|
|
Packit |
022b05 |
sptNetWare(12) -- NetWare
|
|
Packit |
022b05 |
}
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
JmFinishingTC ::= TEXTUAL-CONVENTION
|
|
Packit |
022b05 |
STATUS current
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"The type of finishing operation.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
These values are the same as the enum values of the IPP
|
|
Packit |
022b05 |
'finishings' attribute. See Section 3.7.1.2.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
other(1),
|
|
Packit |
022b05 |
Some other finishing operation besides one of the specified
|
|
Packit |
022b05 |
or registered values.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
unknown(2),
|
|
Packit |
022b05 |
The finishing is unknown.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
none(3),
|
|
Packit |
022b05 |
Perform no finishing.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
staple(4),
|
|
Packit |
022b05 |
Bind the document(s) with one or more staples. The exact
|
|
Packit |
022b05 |
number and placement of the staples is site-defined.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
punch(5),
|
|
Packit |
022b05 |
Holes are required in the finished document. The exact
|
|
Packit |
022b05 |
number and placement of the holes is site-defined. The
|
|
Packit |
022b05 |
punch specification MAY be satisfied (in a site- and
|
|
Packit |
022b05 |
implementation-specific manner) either by
|
|
Packit |
022b05 |
drilling/punching, or by substituting pre-drilled media.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
cover(6),
|
|
Packit |
022b05 |
Select a non-printed (or pre-printed) cover for the
|
|
Packit |
022b05 |
document. This does not supplant the specification of a
|
|
Packit |
022b05 |
printed cover (on cover stock medium) by the document
|
|
Packit |
022b05 |
itself.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
bind(7)
|
|
Packit |
022b05 |
Binding is to be applied to the document; the type and
|
|
Packit |
022b05 |
placement of the binding is product-specific.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
This is a type 2 enumeration. See Section 3.7.1.2."
|
|
Packit |
022b05 |
SYNTAX INTEGER {
|
|
Packit |
022b05 |
other(1),
|
|
Packit |
022b05 |
unknown(2),
|
|
Packit |
022b05 |
none(3),
|
|
Packit |
022b05 |
staple(4),
|
|
Packit |
022b05 |
punch(5),
|
|
Packit |
022b05 |
cover(6),
|
|
Packit |
022b05 |
bind(7)
|
|
Packit |
022b05 |
}
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
JmPrintQualityTC ::= TEXTUAL-CONVENTION
|
|
Packit |
022b05 |
STATUS current
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"Print quality settings.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
These values are the same as the enum values of the IPP 'print-
|
|
Packit |
022b05 |
quality' attribute. See Section 3.7.1.2.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
This is a type 2 enumeration. See Section 3.7.1.2."
|
|
Packit |
022b05 |
SYNTAX INTEGER {
|
|
Packit |
022b05 |
other(1), -- Not one of the specified or registered
|
|
Packit |
022b05 |
-- values.
|
|
Packit |
022b05 |
unknown(2), -- The actual value is unknown.
|
|
Packit |
022b05 |
draft(3), -- Lowest quality available on the printer.
|
|
Packit |
022b05 |
normal(4), -- Normal or intermediate quality on the
|
|
Packit |
022b05 |
-- printer.
|
|
Packit |
022b05 |
high(5) -- Highest quality available on the printer.
|
|
Packit |
022b05 |
}
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
JmPrinterResolutionTC ::= TEXTUAL-CONVENTION
|
|
Packit |
022b05 |
STATUS current
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"Printer resolutions.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
Nine octets consisting of two 4-octet SIGNED-INTEGERs followed
|
|
Packit |
022b05 |
by a SIGNED-BYTE. The values are the same as those specified
|
|
Packit |
022b05 |
in the Printer MIB [printmib]. The first SIGNED-INTEGER
|
|
Packit |
022b05 |
contains the value of prtMarkerAddressabilityXFeedDir. The
|
|
Packit |
022b05 |
second SIGNED-INTEGER contains the value of
|
|
Packit |
022b05 |
prtMarkerAddressabilityFeedDir. The SIGNED-BYTE contains the
|
|
Packit |
022b05 |
value of prtMarkerAddressabilityUnit.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
Note: the latter value is either 3 (tenThousandsOfInches) or 4
|
|
Packit |
022b05 |
(micrometers) and the addressability is in 10,000 units of
|
|
Packit |
022b05 |
measure. Thus the SIGNED-INTEGERs represent integral values in
|
|
Packit |
022b05 |
either dots-per-inch or dots-per-centimeter.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
The syntax is the same as the IPP 'printer-resolution'
|
|
Packit |
022b05 |
attribute. See Section 3.7.1.2."
|
|
Packit |
022b05 |
SYNTAX OCTET STRING (SIZE(9))
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
JmTonerEconomyTC ::= TEXTUAL-CONVENTION
|
|
Packit |
022b05 |
STATUS current
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"Toner economy settings.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
This is a type 2 enumeration. See Section 3.7.1.2."
|
|
Packit |
022b05 |
SYNTAX INTEGER {
|
|
Packit |
022b05 |
unknown(2), -- unknown.
|
|
Packit |
022b05 |
off(3), -- Off. Normal. Use full toner.
|
|
Packit |
022b05 |
on(4) -- On. Use less toner than normal.
|
|
Packit |
022b05 |
}
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
JmBooleanTC ::= TEXTUAL-CONVENTION
|
|
Packit |
022b05 |
STATUS current
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"Boolean true or false value.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
This is a type 2 enumeration. See Section 3.7.1.2."
|
|
Packit |
022b05 |
SYNTAX INTEGER {
|
|
Packit |
022b05 |
unknown(2), -- unknown.
|
|
Packit |
022b05 |
false(3), -- FALSE.
|
|
Packit |
022b05 |
true(4) -- TRUE.
|
|
Packit |
022b05 |
}
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
JmMediumTypeTC ::= TEXTUAL-CONVENTION
|
|
Packit |
022b05 |
STATUS current
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"Identifies the type of medium.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
other(1),
|
|
Packit |
022b05 |
The type is neither one of the values listed in this
|
|
Packit |
022b05 |
specification nor a registered value.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
unknown(2),
|
|
Packit |
022b05 |
The type is not known.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
stationery(3),
|
|
Packit |
022b05 |
Separately cut sheets of an opaque material.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
transparency(4),
|
|
Packit |
022b05 |
Separately cut sheets of a transparent material.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
envelope(5),
|
|
Packit |
022b05 |
Envelopes that can be used for conventional mailing
|
|
Packit |
022b05 |
purposes.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
envelopePlain(6),
|
|
Packit |
022b05 |
Envelopes that are not preprinted and have no windows.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
envelopeWindow(7),
|
|
Packit |
022b05 |
Envelopes that have windows for addressing purposes.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
continuousLong(8),
|
|
Packit |
022b05 |
Continuously connected sheets of an opaque material
|
|
Packit |
022b05 |
connected along the long edge.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
continuousShort(9),
|
|
Packit |
022b05 |
Continuously connected sheets of an opaque material
|
|
Packit |
022b05 |
connected along the short edge.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
tabStock(10),
|
|
Packit |
022b05 |
Media with tabs.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
multiPartForm(11),
|
|
Packit |
022b05 |
Form medium composed of multiple layers not pre-attached to
|
|
Packit |
022b05 |
one another; each sheet MAY be drawn separately from an
|
|
Packit |
022b05 |
input source.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
labels(12),
|
|
Packit |
022b05 |
Label-stock.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
multiLayer(13)
|
|
Packit |
022b05 |
Form medium composed of multiple layers which are pre-
|
|
Packit |
022b05 |
attached to one another, e.g. for use with impact printers.
|
|
Packit |
022b05 |
This is a type 2 enumeration. See Section 3.7.1.2. These enum
|
|
Packit |
022b05 |
values correspond to the keyword name strings of the
|
|
Packit |
022b05 |
prtInputMediaType object in the Printer MIB [print-mib]. There
|
|
Packit |
022b05 |
is no printer description attribute in IPP/1.0 that represents
|
|
Packit |
022b05 |
these values."
|
|
Packit |
022b05 |
SYNTAX INTEGER {
|
|
Packit |
022b05 |
other(1),
|
|
Packit |
022b05 |
unknown(2),
|
|
Packit |
022b05 |
stationery(3),
|
|
Packit |
022b05 |
transparency(4),
|
|
Packit |
022b05 |
envelope(5),
|
|
Packit |
022b05 |
envelopePlain(6),
|
|
Packit |
022b05 |
envelopeWindow(7),
|
|
Packit |
022b05 |
continuousLong(8),
|
|
Packit |
022b05 |
continuousShort(9),
|
|
Packit |
022b05 |
tabStock(10),
|
|
Packit |
022b05 |
multiPartForm(11),
|
|
Packit |
022b05 |
labels(12),
|
|
Packit |
022b05 |
multiLayer(13)
|
|
Packit |
022b05 |
}
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
JmJobCollationTypeTC ::= TEXTUAL-CONVENTION
|
|
Packit |
022b05 |
STATUS current
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"This value is the type of job collation. Implementations that
|
|
Packit |
022b05 |
don't support multiple documents or don't support multiple
|
|
Packit |
022b05 |
copies SHALL NOT support the uncollatedDocuments(5) value.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
This is a type 2 enumeration. See Section 3.7.1.2. See also
|
|
Packit |
022b05 |
Section 3.4, entitled 'Monitoring Job Progress'."
|
|
Packit |
022b05 |
SYNTAX INTEGER {
|
|
Packit |
022b05 |
other(1),
|
|
Packit |
022b05 |
unknown(2),
|
|
Packit |
022b05 |
uncollatedSheets(3), -- sheets within each document copy
|
|
Packit |
022b05 |
-- are not collated: 1 1 ..., 2 2 ...,
|
|
Packit |
022b05 |
-- No corresponding value of IPP
|
|
Packit |
022b05 |
-- "multiple-document-handling"
|
|
Packit |
022b05 |
collatedDocuments(4), -- internal collated sheets,
|
|
Packit |
022b05 |
-- documents: A, B, A, B, ...
|
|
Packit |
022b05 |
-- Corresponds to IPP "multiple-
|
|
Packit |
022b05 |
-- document-handling"='separate-
|
|
Packit |
022b05 |
-- documents-collated-copies'
|
|
Packit |
022b05 |
uncollatedDocuments(5) -- internal collated sheets,
|
|
Packit |
022b05 |
-- documents: A, A, ..., B, B, ...
|
|
Packit |
022b05 |
-- Corresponds to IPP "multiple-
|
|
Packit |
022b05 |
-- document-handling"='separate-
|
|
Packit |
022b05 |
-- documents-uncollated-copies'
|
|
Packit |
022b05 |
}
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
JmJobSubmissionIDTypeTC ::= TEXTUAL-CONVENTION
|
|
Packit |
022b05 |
STATUS current
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"Identifies the format type of a job submission ID.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
Each job submission ID is a fixed-length, 48-octet printable
|
|
Packit |
022b05 |
US-ASCII [US-ASCII] coded character string containing no
|
|
Packit |
022b05 |
control characters, consisting of the fields defined in section
|
|
Packit |
022b05 |
3.5.1.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
This is like a type 2 enumeration. See section 3.7.3."
|
|
Packit |
022b05 |
SYNTAX OCTET STRING(SIZE(1)) -- ASCII '0'-'9', 'A'-'Z', 'a'-'z'
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
JmJobStateTC ::= TEXTUAL-CONVENTION
|
|
Packit |
022b05 |
STATUS current
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"The current state of the job (pending, processing, completed,
|
|
Packit |
022b05 |
etc.). The following figure shows the normal job state
|
|
Packit |
022b05 |
transitions:
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
+----> canceled(7)
|
|
Packit |
022b05 |
/
|
|
Packit |
022b05 |
+---> pending(3) -------> processing(5) ------+------> completed(9)
|
|
Packit |
022b05 |
| ^ ^ \
|
|
Packit |
022b05 |
--->+ | | +----> aborted(8)
|
|
Packit |
022b05 |
| v v /
|
|
Packit |
022b05 |
+---> pendingHeld(4) processingStopped(6) ---+
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
Figure 4 - Normal Job State Transitions
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
Normally a job progresses from left to right. Other state
|
|
Packit |
022b05 |
transitions are unlikely, but are not forbidden. Not shown are
|
|
Packit |
022b05 |
the transitions to the canceled state from the pending,
|
|
Packit |
022b05 |
pendingHeld, and processingStopped states.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
Jobs in the pending, processing, and processingStopped states
|
|
Packit |
022b05 |
are called 'active', while jobs in the pendingHeld, canceled,
|
|
Packit |
022b05 |
aborted, and completed states are called 'inactive'. Jobs
|
|
Packit |
022b05 |
reach one of the three terminal states: completed, canceled, or
|
|
Packit |
022b05 |
aborted, after the jobs have completed all activity, and all
|
|
Packit |
022b05 |
MIB objects and attributes have reached their final values for
|
|
Packit |
022b05 |
the job.
|
|
Packit |
022b05 |
These values are the same as the enum values of the IPP 'job-
|
|
Packit |
022b05 |
state' job attribute. See Section 3.7.1.2.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
unknown(2),
|
|
Packit |
022b05 |
The job state is not known, or its state is indeterminate.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
pending(3),
|
|
Packit |
022b05 |
The job is a candidate to start processing, but is not yet
|
|
Packit |
022b05 |
processing.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
pendingHeld(4),
|
|
Packit |
022b05 |
The job is not a candidate for processing for any number of
|
|
Packit |
022b05 |
reasons but will return to the pending state as soon as the
|
|
Packit |
022b05 |
reasons are no longer present. The job's
|
|
Packit |
022b05 |
jmJobStateReasons1 object and/or jobStateReasonsN (N=2..4)
|
|
Packit |
022b05 |
attributes SHALL indicate why the job is no longer a
|
|
Packit |
022b05 |
candidate for processing. The reasons are represented as
|
|
Packit |
022b05 |
bits in the jmJobStateReasons1 object and/or
|
|
Packit |
022b05 |
jobStateReasonsN (N=2..4) attributes. See the
|
|
Packit |
022b05 |
JmJobStateReasonsNTC (N=1..4) textual convention for the
|
|
Packit |
022b05 |
specification of each reason.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
processing(5),
|
|
Packit |
022b05 |
One or more of:
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
1. the job is using, or is attempting to use, one or
|
|
Packit |
022b05 |
more purely software processes that are analyzing,
|
|
Packit |
022b05 |
creating, or interpreting a PDL, etc.,
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
2. the job is using, or is attempting to use, one or
|
|
Packit |
022b05 |
more hardware devices that are interpreting a PDL,
|
|
Packit |
022b05 |
making mark on a medium, and/or performing finishing,
|
|
Packit |
022b05 |
such as stapling, etc., OR
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
3. (configuration 2) the server has made the job ready
|
|
Packit |
022b05 |
for printing, but the output device is not yet printing
|
|
Packit |
022b05 |
it, either because the job hasn't reached the output
|
|
Packit |
022b05 |
device or because the job is queued in the output
|
|
Packit |
022b05 |
device or some other spooler, awaiting the output
|
|
Packit |
022b05 |
device to print it.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
When the job is in the processing state, the entire job
|
|
Packit |
022b05 |
state includes the detailed status represented in the
|
|
Packit |
022b05 |
device MIB indicated by the hrDeviceIndex value of the
|
|
Packit |
022b05 |
job's physicalDevice attribute, if the agent implements
|
|
Packit |
022b05 |
such a device MIB.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
Implementations MAY, though they NEED NOT, include
|
|
Packit |
022b05 |
additional values in the job's jmJobStateReasons1 object
|
|
Packit |
022b05 |
to indicate the progress of the job, such as adding the
|
|
Packit |
022b05 |
jobPrinting value to indicate when the device is actually
|
|
Packit |
022b05 |
making marks on a medium and/or the processingToStopPoint
|
|
Packit |
022b05 |
value to indicate that the server or device is in the
|
|
Packit |
022b05 |
process of canceling or aborting the job.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
processingStopped(6),
|
|
Packit |
022b05 |
The job has stopped while processing for any number of
|
|
Packit |
022b05 |
reasons and will return to the processing state as soon
|
|
Packit |
022b05 |
as the reasons are no longer present.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
The job's jmJobStateReasons1 object and/or the job's
|
|
Packit |
022b05 |
jobStateReasonsN (N=2..4) attributes MAY indicate why the
|
|
Packit |
022b05 |
job has stopped processing. For example, if the output
|
|
Packit |
022b05 |
device is stopped, the deviceStopped value MAY be
|
|
Packit |
022b05 |
included in the job's jmJobStateReasons1 object.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
NOTE - When an output device is stopped, the device
|
|
Packit |
022b05 |
usually indicates its condition in human readable form
|
|
Packit |
022b05 |
at the device. The management application can obtain
|
|
Packit |
022b05 |
more complete device status remotely by querying the
|
|
Packit |
022b05 |
appropriate device MIB using the job's deviceIndex
|
|
Packit |
022b05 |
attribute(s), if the agent implements such a device MIB
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
canceled(7),
|
|
Packit |
022b05 |
A client has canceled the job and the server or device
|
|
Packit |
022b05 |
has completed canceling the job AND all MIB objects and
|
|
Packit |
022b05 |
attributes have reached their final values for the job.
|
|
Packit |
022b05 |
While the server or device is canceling the job, the
|
|
Packit |
022b05 |
job's jmJobStateReasons1 object SHOULD contain the
|
|
Packit |
022b05 |
processingToStopPoint value and one of the
|
|
Packit |
022b05 |
canceledByUser, canceledByOperator, or canceledAtDevice
|
|
Packit |
022b05 |
values. The canceledByUser, canceledByOperator, or
|
|
Packit |
022b05 |
canceledAtDevice values remain while the job is in the
|
|
Packit |
022b05 |
canceled state.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
aborted(8),
|
|
Packit |
022b05 |
The job has been aborted by the system, usually while the
|
|
Packit |
022b05 |
job was in the processing or processingStopped state and
|
|
Packit |
022b05 |
the server or device has completed aborting the job AND
|
|
Packit |
022b05 |
all MIB objects and attributes have reached their final
|
|
Packit |
022b05 |
values for the job. While the server or device is
|
|
Packit |
022b05 |
aborting the job, the job's jmJobStateReasons1 object MAY
|
|
Packit |
022b05 |
contain the processingToStopPoint and abortedBySystem
|
|
Packit |
022b05 |
values. If implemented, the abortedBySystem value SHALL
|
|
Packit |
022b05 |
remain while the job is in the aborted state.
|
|
Packit |
022b05 |
completed(9)
|
|
Packit |
022b05 |
The job has completed successfully or with warnings or
|
|
Packit |
022b05 |
errors after processing and all of the media have been
|
|
Packit |
022b05 |
successfully stacked in the appropriate output bin(s) AND
|
|
Packit |
022b05 |
all MIB objects and attributes have reached their final
|
|
Packit |
022b05 |
values for the job. The job's jmJobStateReasons1 object
|
|
Packit |
022b05 |
SHOULD contain one of: completedSuccessfully,
|
|
Packit |
022b05 |
completedWithWarnings, or completedWithErrors values.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
This is a type 2 enumeration. See Section 3.7.1.2."
|
|
Packit |
022b05 |
SYNTAX INTEGER {
|
|
Packit |
022b05 |
unknown(2),
|
|
Packit |
022b05 |
pending(3),
|
|
Packit |
022b05 |
pendingHeld(4),
|
|
Packit |
022b05 |
processing(5),
|
|
Packit |
022b05 |
processingStopped(6),
|
|
Packit |
022b05 |
canceled(7),
|
|
Packit |
022b05 |
aborted(8),
|
|
Packit |
022b05 |
completed(9)
|
|
Packit |
022b05 |
}
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
JmAttributeTypeTC ::= TEXTUAL-CONVENTION
|
|
Packit |
022b05 |
STATUS current
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"The type of the attribute which identifies the attribute.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
NOTE - The enum assignments are grouped logically with values
|
|
Packit |
022b05 |
assigned in groups of 20, so that additional values may be
|
|
Packit |
022b05 |
registered in the future and assigned a value that is part of
|
|
Packit |
022b05 |
their logical grouping.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
Values in the range 2**30 to 2**31-1 are reserved for private
|
|
Packit |
022b05 |
or experimental usage. This range corresponds to the same
|
|
Packit |
022b05 |
range reserved in IPP. Implementers are warned that use of
|
|
Packit |
022b05 |
such values may conflict with other implementations.
|
|
Packit |
022b05 |
Implementers are encouraged to request registration of enum
|
|
Packit |
022b05 |
values following the procedures in Section 3.7.1.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
See Section 3.2 entitled 'The Attribute Mechanism' for a
|
|
Packit |
022b05 |
description of this textual-convention and its use in the
|
|
Packit |
022b05 |
jmAttributeTable. See Section 3.3.8 for the specification of
|
|
Packit |
022b05 |
each attribute. The comment(s) after each enum assignment
|
|
Packit |
022b05 |
specifies the data type(s) of the attribute.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
This is a type 2 enumeration. See Section 3.7.1.2."
|
|
Packit |
022b05 |
SYNTAX INTEGER {
|
|
Packit |
022b05 |
other(1), -- Integer32 (-2..2147483647)
|
|
Packit |
022b05 |
-- AND/OR
|
|
Packit |
022b05 |
-- OCTET STRING(SIZE(0..63))
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
-- Job State attributes:
|
|
Packit |
022b05 |
jobStateReasons2(3), -- JmJobStateReasons2TC
|
|
Packit |
022b05 |
jobStateReasons3(4), -- JmJobStateReasons3TC
|
|
Packit |
022b05 |
jobStateReasons4(5), -- JmJobStateReasons4TC
|
|
Packit |
022b05 |
processingMessage(6), -- JmUTF8StringTC (SIZE(0..63))
|
|
Packit |
022b05 |
processingMessageNaturalLangTag(7),
|
|
Packit |
022b05 |
-- OCTET STRING(SIZE(0..63))
|
|
Packit |
022b05 |
jobCodedCharSet(8), -- CodedCharSet
|
|
Packit |
022b05 |
jobNaturalLanguageTag(9), -- OCTET STRING(SIZE(0..63))
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
-- Job Identification attributes:
|
|
Packit |
022b05 |
jobURI(20), -- OCTET STRING(SIZE(0..63))
|
|
Packit |
022b05 |
jobAccountName(21), -- OCTET STRING(SIZE(0..63))
|
|
Packit |
022b05 |
serverAssignedJobName(22), -- JmJobStringTC (SIZE(0..63))
|
|
Packit |
022b05 |
jobName(23), -- JmJobStringTC (SIZE(0..63))
|
|
Packit |
022b05 |
jobServiceTypes(24), -- JmJobServiceTypesTC
|
|
Packit |
022b05 |
jobSourceChannelIndex(25), -- Integer32 (0..2147483647)
|
|
Packit |
022b05 |
jobSourcePlatformType(26), -- JmJobSourcePlatformTypeTC
|
|
Packit |
022b05 |
submittingServerName(27), -- JmJobStringTC (SIZE(0..63))
|
|
Packit |
022b05 |
submittingApplicationName(28), -- JmJobStringTC (SIZE(0..63))
|
|
Packit |
022b05 |
jobOriginatingHost(29), -- JmJobStringTC (SIZE(0..63))
|
|
Packit |
022b05 |
deviceNameRequested(30), -- JmJobStringTC (SIZE(0..63))
|
|
Packit |
022b05 |
queueNameRequested(31), -- JmJobStringTC (SIZE(0..63))
|
|
Packit |
022b05 |
physicalDevice(32), -- hrDeviceIndex
|
|
Packit |
022b05 |
-- AND/OR
|
|
Packit |
022b05 |
-- JmUTF8StringTC (SIZE(0..63))
|
|
Packit |
022b05 |
numberOfDocuments(33), -- Integer32 (-2..2147483647)
|
|
Packit |
022b05 |
fileName(34), -- JmJobStringTC (SIZE(0..63))
|
|
Packit |
022b05 |
documentName(35), -- JmJobStringTC (SIZE(0..63))
|
|
Packit |
022b05 |
jobComment(36), -- JmJobStringTC (SIZE(0..63))
|
|
Packit |
022b05 |
documentFormatIndex(37), -- Integer32 (0..2147483647)
|
|
Packit |
022b05 |
documentFormat(38), -- PrtInterpreterLangFamilyTC
|
|
Packit |
022b05 |
-- AND/OR
|
|
Packit |
022b05 |
-- OCTET STRING(SIZE(0..63))
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
-- Job Parameter attributes:
|
|
Packit |
022b05 |
jobPriority(50), -- Integer32 (-2..100)
|
|
Packit |
022b05 |
jobProcessAfterDateAndTime(51), -- DateAndTime (SNMPv2-TC)
|
|
Packit |
022b05 |
jobHold(52), -- JmBooleanTC
|
|
Packit |
022b05 |
jobHoldUntil(53), -- JmJobStringTC (SIZE(0..63))
|
|
Packit |
022b05 |
outputBin(54), -- Integer32 (0..2147483647)
|
|
Packit |
022b05 |
-- AND/OR
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
-- JmJobStringTC (SIZE(0..63))
|
|
Packit |
022b05 |
sides(55), -- Integer32 (-2..2)
|
|
Packit |
022b05 |
finishing(56), -- JmFinishingTC
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
-- Image Quality attributes:
|
|
Packit |
022b05 |
printQualityRequested(70), -- JmPrintQualityTC
|
|
Packit |
022b05 |
printQualityUsed(71), -- JmPrintQualityTC
|
|
Packit |
022b05 |
printerResolutionRequested(72), -- JmPrinterResolutionTC
|
|
Packit |
022b05 |
printerResolutionUsed(73), -- JmPrinterResolutionTC
|
|
Packit |
022b05 |
tonerEcomonyRequested(74), -- JmTonerEconomyTC
|
|
Packit |
022b05 |
tonerEcomonyUsed(75), -- JmTonerEconomyTC
|
|
Packit |
022b05 |
tonerDensityRequested(76), -- Integer32 (-2..100)
|
|
Packit |
022b05 |
tonerDensityUsed(77), -- Integer32 (-2..100)
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
-- Job Progress attributes:
|
|
Packit |
022b05 |
jobCopiesRequested(90), -- Integer32 (-2..2147483647)
|
|
Packit |
022b05 |
jobCopiesCompleted(91), -- Integer32 (-2..2147483647)
|
|
Packit |
022b05 |
documentCopiesRequested(92), -- Integer32 (-2..2147483647)
|
|
Packit |
022b05 |
documentCopiesCompleted(93), -- Integer32 (-2..2147483647)
|
|
Packit |
022b05 |
jobKOctetsTransferred(94), -- Integer32 (-2..2147483647)
|
|
Packit |
022b05 |
sheetCompletedCopyNumber(95), -- Integer32 (-2..2147483647)
|
|
Packit |
022b05 |
sheetCompletedDocumentNumber(96),
|
|
Packit |
022b05 |
-- Integer32 (-2..2147483647)
|
|
Packit |
022b05 |
jobCollationType(97), -- JmJobCollationTypeTC
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
-- Impression attributes:
|
|
Packit |
022b05 |
impressionsSpooled(110), -- Integer32 (-2..2147483647)
|
|
Packit |
022b05 |
impressionsSentToDevice(111), -- Integer32 (-2..2147483647)
|
|
Packit |
022b05 |
impressionsInterpreted(112), -- Integer32 (-2..2147483647)
|
|
Packit |
022b05 |
impressionsCompletedCurrentCopy(113),
|
|
Packit |
022b05 |
-- Integer32 (-2..2147483647)
|
|
Packit |
022b05 |
fullColorImpressionsCompleted(114),
|
|
Packit |
022b05 |
-- Integer32 (-2..2147483647)
|
|
Packit |
022b05 |
highlightColorImpressionsCompleted(115),
|
|
Packit |
022b05 |
-- Integer32 (-2..2147483647)
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
-- Page attributes:
|
|
Packit |
022b05 |
pagesRequested(130), -- Integer32 (-2..2147483647)
|
|
Packit |
022b05 |
pagesCompleted(131), -- Integer32 (-2..2147483647)
|
|
Packit |
022b05 |
pagesCompletedCurrentCopy(132), -- Integer32 (-2..2147483647)
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
-- Sheet attributes:
|
|
Packit |
022b05 |
sheetsRequested(150), -- Integer32 (-2..2147483647)
|
|
Packit |
022b05 |
sheetsCompleted(151), -- Integer32 (-2..2147483647)
|
|
Packit |
022b05 |
sheetsCompletedCurrentCopy(152),-- Integer32 (-2..2147483647)
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
-- Resource attributes:
|
|
Packit |
022b05 |
mediumRequested(170), -- JmMediumTypeTC
|
|
Packit |
022b05 |
-- AND/OR
|
|
Packit |
022b05 |
-- JmJobStringTC (SIZE(0..63))
|
|
Packit |
022b05 |
mediumConsumed(171), -- Integer32 (-2..2147483647)
|
|
Packit |
022b05 |
-- AND
|
|
Packit |
022b05 |
-- JmJobStringTC (SIZE(0..63))
|
|
Packit |
022b05 |
colorantRequested(172), -- Integer32 (-2..2147483647)
|
|
Packit |
022b05 |
-- AND/OR
|
|
Packit |
022b05 |
-- JmJobStringTC (SIZE(0..63))
|
|
Packit |
022b05 |
colorantConsumed(173), -- Integer32 (-2..2147483647)
|
|
Packit |
022b05 |
-- AND/OR
|
|
Packit |
022b05 |
-- JmJobStringTC (SIZE(0..63))
|
|
Packit |
022b05 |
mediumTypeConsumed(174), -- Integer32 (-2..2147483647)
|
|
Packit |
022b05 |
-- AND
|
|
Packit |
022b05 |
-- JmJobStringTC (SIZE(0..63))
|
|
Packit |
022b05 |
mediumSizeConsumed(175), -- Integer32 (-2..2147483647)
|
|
Packit |
022b05 |
-- AND
|
|
Packit |
022b05 |
-- JmJobStringTC (SIZE(0..63))
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
-- Time attributes:
|
|
Packit |
022b05 |
jobSubmissionToServerTime(190), -- JmTimeStampTC
|
|
Packit |
022b05 |
-- AND/OR
|
|
Packit |
022b05 |
-- DateAndTime
|
|
Packit |
022b05 |
jobSubmissionTime(191), -- JmTimeStampTC
|
|
Packit |
022b05 |
-- AND/OR
|
|
Packit |
022b05 |
-- DateAndTime
|
|
Packit |
022b05 |
jobStartedBeingHeldTime(192), -- JmTimeStampTC
|
|
Packit |
022b05 |
-- AND/OR
|
|
Packit |
022b05 |
-- DateAndTime
|
|
Packit |
022b05 |
jobStartedProcessingTime(193), -- JmTimeStampTC
|
|
Packit |
022b05 |
-- AND/OR
|
|
Packit |
022b05 |
-- DateAndTime
|
|
Packit |
022b05 |
jobCompletionTime(194), -- JmTimeStampTC
|
|
Packit |
022b05 |
-- AND/OR
|
|
Packit |
022b05 |
-- DateAndTime
|
|
Packit |
022b05 |
jobProcessingCPUTime(195) -- Integer32 (-2..2147483647)
|
|
Packit |
022b05 |
}
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
JmJobServiceTypesTC ::= TEXTUAL-CONVENTION
|
|
Packit |
022b05 |
STATUS current
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"Specifies the type(s) of service to which the job has been
|
|
Packit |
022b05 |
submitted (print, fax, scan, etc.). The service type is
|
|
Packit |
022b05 |
represented as an enum that is bit encoded with each job
|
|
Packit |
022b05 |
service type so that more general and arbitrary services can be
|
|
Packit |
022b05 |
created, such as services with more than one destination type,
|
|
Packit |
022b05 |
or ones with only a source or only a destination. For example,
|
|
Packit |
022b05 |
a job service might scan, faxOut, and print a single job. In
|
|
Packit |
022b05 |
this case, three bits would be set in the jobServiceTypes
|
|
Packit |
022b05 |
attribute, corresponding to the hexadecimal values: 0x8 + 0x20
|
|
Packit |
022b05 |
+ 0x4, respectively, yielding: 0x2C.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
Whether this attribute is set from a job attribute supplied by
|
|
Packit |
022b05 |
the job submission client or is set by the recipient job
|
|
Packit |
022b05 |
submission server or device depends on the job submission
|
|
Packit |
022b05 |
protocol. With either implementation, the agent SHALL return a
|
|
Packit |
022b05 |
non-zero value for this attribute indicating the type of the
|
|
Packit |
022b05 |
job.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
One of the purposes of this attribute is to permit a requester
|
|
Packit |
022b05 |
to filter out jobs that are not of interest. For example, a
|
|
Packit |
022b05 |
printer operator MAY only be interested in jobs that include
|
|
Packit |
022b05 |
printing. That is why the attribute is in the job
|
|
Packit |
022b05 |
identification category.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
The following service component types are defined (in
|
|
Packit |
022b05 |
hexadecimal) and are assigned a separate bit value for use with
|
|
Packit |
022b05 |
the jobServiceTypes attribute:
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
other 0x1
|
|
Packit |
022b05 |
The job contains some instructions that are not one of the
|
|
Packit |
022b05 |
identified types.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
unknown 0x2
|
|
Packit |
022b05 |
The job contains some instructions whose type is unknown to
|
|
Packit |
022b05 |
the agent.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
print 0x4
|
|
Packit |
022b05 |
The job contains some instructions that specify printing
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
scan 0x8
|
|
Packit |
022b05 |
The job contains some instructions that specify scanning
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
faxIn 0x10
|
|
Packit |
022b05 |
The job contains some instructions that specify receive fax
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
faxOut 0x20
|
|
Packit |
022b05 |
The job contains some instructions that specify sending fax
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
getFile 0x40
|
|
Packit |
022b05 |
The job contains some instructions that specify accessing
|
|
Packit |
022b05 |
files or documents
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
putFile 0x80
|
|
Packit |
022b05 |
The job contains some instructions that specify storing
|
|
Packit |
022b05 |
files or documents
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
mailList 0x100
|
|
Packit |
022b05 |
The job contains some instructions that specify
|
|
Packit |
022b05 |
distribution of documents using an electronic mail system.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
These bit definitions are the equivalent of a type 2 enum
|
|
Packit |
022b05 |
except that combinations of them MAY be used together. See
|
|
Packit |
022b05 |
section 3.7.1.2."
|
|
Packit |
022b05 |
SYNTAX INTEGER (0..2147483647) -- 31 bits, all but sign bit
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
JmJobStateReasons1TC ::= TEXTUAL-CONVENTION
|
|
Packit |
022b05 |
STATUS current
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"The JmJobStateReasonsNTC (N=1..4) textual-conventions are used
|
|
Packit |
022b05 |
with the jmJobStateReasons1 object and jobStateReasonsN
|
|
Packit |
022b05 |
(N=2..4), respectively, to provide additional information
|
|
Packit |
022b05 |
regarding the current jmJobState object value. These values
|
|
Packit |
022b05 |
MAY be used with any job state or states for which the reason
|
|
Packit |
022b05 |
makes sense. See section 3.3.9.1 for the specification of each
|
|
Packit |
022b05 |
bit value defined for use with the JmJobStateReasons1TC.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
These bit definitions are the equivalent of a type 2 enum
|
|
Packit |
022b05 |
except that combinations of bits may be used together. See
|
|
Packit |
022b05 |
section 3.7.1.2."
|
|
Packit |
022b05 |
SYNTAX INTEGER (0..2147483647) -- 31 bits, all but sign bit
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
JmJobStateReasons2TC ::= TEXTUAL-CONVENTION
|
|
Packit |
022b05 |
STATUS current
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"This textual-convention is used with the jobStateReasons2
|
|
Packit |
022b05 |
attribute to provides additional information regarding the
|
|
Packit |
022b05 |
jmJobState object. See section 3.3.9.2 for the specification
|
|
Packit |
022b05 |
of JmJobStateReasons2TC. See section 3.3.9.1 for the
|
|
Packit |
022b05 |
description under JmJobStateReasons1TC for additional
|
|
Packit |
022b05 |
information that applies to all reasons.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
These bit definitions are the equivalent of a type 2 enum
|
|
Packit |
022b05 |
except that combinations of them may be used together. See
|
|
Packit |
022b05 |
section 3.7.1.2."
|
|
Packit |
022b05 |
SYNTAX INTEGER (0..2147483647) -- 31 bits, all but sign bit
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
JmJobStateReasons3TC ::= TEXTUAL-CONVENTION
|
|
Packit |
022b05 |
STATUS current
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"This textual-convention is used with the jobStateReasons3
|
|
Packit |
022b05 |
attribute to provides additional information regarding the
|
|
Packit |
022b05 |
jmJobState object. See section 3.3.9.3 for the specification
|
|
Packit |
022b05 |
of JmJobStateReasons3TC. See section 3.3.9.1 for the
|
|
Packit |
022b05 |
description under JmJobStateReasons1TC for additional
|
|
Packit |
022b05 |
information that applies to all reasons.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
These bit definitions are the equivalent of a type 2 enum
|
|
Packit |
022b05 |
except that combinations of them may be used together. See
|
|
Packit |
022b05 |
section 3.7.1.2. "
|
|
Packit |
022b05 |
SYNTAX INTEGER (0..2147483647) -- 31 bits, all but sign bit
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
JmJobStateReasons4TC ::= TEXTUAL-CONVENTION
|
|
Packit |
022b05 |
STATUS current
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"This textual-convention is used in the jobStateReasons4
|
|
Packit |
022b05 |
attribute to provides additional information regarding the
|
|
Packit |
022b05 |
jmJobState object. See section 3.3.9.4 for the specification
|
|
Packit |
022b05 |
of JmJobStateReasons4TC. See section 3.3.9.1 for the
|
|
Packit |
022b05 |
description under JmJobStateReasons1TC for additional
|
|
Packit |
022b05 |
information that applies to all reasons.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
These bit definitions are the equivalent of a type 2 enum
|
|
Packit |
022b05 |
except that combinations of them may be used together. See
|
|
Packit |
022b05 |
section 3.7.1.2."
|
|
Packit |
022b05 |
SYNTAX INTEGER (0..2147483647) -- 31 bits, all but sign bit
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
jobmonMIBObjects OBJECT IDENTIFIER ::= { jobmonMIB 1 }
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
-- The General Group (MANDATORY)
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
-- The jmGeneralGroup consists entirely of the jmGeneralTable.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
jmGeneral OBJECT IDENTIFIER ::= { jobmonMIBObjects 1 }
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
jmGeneralTable OBJECT-TYPE
|
|
Packit |
022b05 |
SYNTAX SEQUENCE OF JmGeneralEntry
|
|
Packit |
022b05 |
MAX-ACCESS not-accessible
|
|
Packit |
022b05 |
STATUS current
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"The jmGeneralTable consists of information of a general nature
|
|
Packit |
022b05 |
that are per-job-set, but are not per-job. See Section 2
|
|
Packit |
022b05 |
entitled 'Terminology and Job Model' for the definition of a
|
|
Packit |
022b05 |
job set.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
The MANDATORY-GROUP macro specifies that this group is
|
|
Packit |
022b05 |
MANDATORY."
|
|
Packit |
022b05 |
::= { jmGeneral 1 }
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
jmGeneralEntry OBJECT-TYPE
|
|
Packit |
022b05 |
SYNTAX JmGeneralEntry
|
|
Packit |
022b05 |
MAX-ACCESS not-accessible
|
|
Packit |
022b05 |
STATUS current
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"Information about a job set (queue).
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
An entry SHALL exist in this table for each job set."
|
|
Packit |
022b05 |
INDEX { jmGeneralJobSetIndex }
|
|
Packit |
022b05 |
::= { jmGeneralTable 1 }
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
JmGeneralEntry ::= SEQUENCE {
|
|
Packit |
022b05 |
jmGeneralJobSetIndex Integer32,
|
|
Packit |
022b05 |
jmGeneralNumberOfActiveJobs Integer32,
|
|
Packit |
022b05 |
jmGeneralOldestActiveJobIndex Integer32,
|
|
Packit |
022b05 |
jmGeneralNewestActiveJobIndex Integer32,
|
|
Packit |
022b05 |
jmGeneralJobPersistence Integer32,
|
|
Packit |
022b05 |
jmGeneralAttributePersistence Integer32,
|
|
Packit |
022b05 |
jmGeneralJobSetName JmUTF8StringTC
|
|
Packit |
022b05 |
}
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
jmGeneralJobSetIndex OBJECT-TYPE
|
|
Packit |
022b05 |
SYNTAX Integer32 (1..32767)
|
|
Packit |
022b05 |
MAX-ACCESS not-accessible
|
|
Packit |
022b05 |
STATUS current
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"A unique value for each job set in this MIB. The jmJobTable
|
|
Packit |
022b05 |
and jmAttributeTable tables have this same index as their
|
|
Packit |
022b05 |
primary index.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
The value(s) of the jmGeneralJobSetIndex SHALL be persistent
|
|
Packit |
022b05 |
across power cycles, so that clients that have retained
|
|
Packit |
022b05 |
jmGeneralJobSetIndex values will access the same job sets upon
|
|
Packit |
022b05 |
subsequent power-up.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
An implementation that has only one job set, such as a printer
|
|
Packit |
022b05 |
with a single queue, SHALL hard code this object with the value
|
|
Packit |
022b05 |
1.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
See Section 2 entitled 'Terminology and Job Model' for the
|
|
Packit |
022b05 |
definition of a job set.
|
|
Packit |
022b05 |
Corresponds to the first index in jmJobTable and
|
|
Packit |
022b05 |
jmAttributeTable."
|
|
Packit |
022b05 |
::= { jmGeneralEntry 1 }
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
jmGeneralNumberOfActiveJobs OBJECT-TYPE
|
|
Packit |
022b05 |
SYNTAX Integer32 (0..2147483647)
|
|
Packit |
022b05 |
MAX-ACCESS read-only
|
|
Packit |
022b05 |
STATUS current
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"The current number of 'active' jobs in the jmJobIDTable,
|
|
Packit |
022b05 |
jmJobTable, and jmAttributeTable, i.e., the total number of
|
|
Packit |
022b05 |
jobs that are in the pending, processing, or processingStopped
|
|
Packit |
022b05 |
states. See the JmJobStateTC textual-convention for the exact
|
|
Packit |
022b05 |
specification of the semantics of the job states."
|
|
Packit |
022b05 |
DEFVAL { 0 } -- no jobs
|
|
Packit |
022b05 |
::= { jmGeneralEntry 2 }
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
jmGeneralOldestActiveJobIndex OBJECT-TYPE
|
|
Packit |
022b05 |
SYNTAX Integer32 (0..2147483647)
|
|
Packit |
022b05 |
MAX-ACCESS read-only
|
|
Packit |
022b05 |
STATUS current
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"The jmJobIndex of the oldest job that is still in one of the
|
|
Packit |
022b05 |
'active' states (pending, processing, or processingStopped).
|
|
Packit |
022b05 |
In other words, the index of the 'active' job that has been in
|
|
Packit |
022b05 |
the job tables the longest.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
If there are no active jobs, the agent SHALL set the value of
|
|
Packit |
022b05 |
this object to 0.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
See Section 3.2 entitled 'The Job Tables and the Oldest Active
|
|
Packit |
022b05 |
and Newest Active Indexes' for a description of the usage of
|
|
Packit |
022b05 |
this object."
|
|
Packit |
022b05 |
DEFVAL { 0 } -- no active jobs
|
|
Packit |
022b05 |
::= { jmGeneralEntry 3 }
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
jmGeneralNewestActiveJobIndex OBJECT-TYPE
|
|
Packit |
022b05 |
SYNTAX Integer32 (0..2147483647)
|
|
Packit |
022b05 |
MAX-ACCESS read-only
|
|
Packit |
022b05 |
STATUS current
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"The jmJobIndex of the newest job that is in one of the
|
|
Packit |
022b05 |
'active' states (pending, processing, or processingStopped).
|
|
Packit |
022b05 |
In other words, the index of the 'active' job that has been
|
|
Packit |
022b05 |
most recently added to the job tables.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
When all jobs become 'inactive', i.e., enter the pendingHeld,
|
|
Packit |
022b05 |
completed, canceled, or aborted states, the agent SHALL set the
|
|
Packit |
022b05 |
value of this object to 0.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
See Section 3.2 entitled 'The Job Tables and the Oldest Active
|
|
Packit |
022b05 |
and Newest Active Indexes' for a description of the usage of
|
|
Packit |
022b05 |
this object."
|
|
Packit |
022b05 |
DEFVAL { 0 } -- no active jobs
|
|
Packit |
022b05 |
::= { jmGeneralEntry 4 }
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
jmGeneralJobPersistence OBJECT-TYPE
|
|
Packit |
022b05 |
SYNTAX Integer32 (15..2147483647)
|
|
Packit |
022b05 |
UNITS "seconds"
|
|
Packit |
022b05 |
MAX-ACCESS read-only
|
|
Packit |
022b05 |
STATUS current
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"The minimum time in seconds for this instance of the Job Set
|
|
Packit |
022b05 |
that an entry SHALL remain in the jmJobIDTable and jmJobTable
|
|
Packit |
022b05 |
after processing has completed, i.e., the minimum time in
|
|
Packit |
022b05 |
seconds starting when the job enters the completed, canceled,
|
|
Packit |
022b05 |
or aborted state.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
Configuring this object is implementation-dependent.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
This value SHALL be equal to or greater than the value of
|
|
Packit |
022b05 |
jmGeneralAttributePersistence. This value SHOULD be at least
|
|
Packit |
022b05 |
60 which gives a monitoring or accounting application one
|
|
Packit |
022b05 |
minute in which to poll for job data."
|
|
Packit |
022b05 |
DEFVAL { 60 } -- one minute
|
|
Packit |
022b05 |
::= { jmGeneralEntry 5 }
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
jmGeneralAttributePersistence OBJECT-TYPE
|
|
Packit |
022b05 |
SYNTAX Integer32 (15..2147483647)
|
|
Packit |
022b05 |
UNITS "seconds"
|
|
Packit |
022b05 |
MAX-ACCESS read-only
|
|
Packit |
022b05 |
STATUS current
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"The minimum time in seconds for this instance of the Job Set
|
|
Packit |
022b05 |
that an entry SHALL remain in the jmAttributeTable after
|
|
Packit |
022b05 |
processing has completed , i.e., the time in seconds starting
|
|
Packit |
022b05 |
when the job enters the completed, canceled, or aborted state.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
Configuring this object is implementation-dependent.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
This value SHOULD be at least 60 which gives a monitoring or
|
|
Packit |
022b05 |
accounting application one minute in which to poll for job
|
|
Packit |
022b05 |
data."
|
|
Packit |
022b05 |
DEFVAL { 60 } -- one minute
|
|
Packit |
022b05 |
::= { jmGeneralEntry 6 }
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
jmGeneralJobSetName OBJECT-TYPE
|
|
Packit |
022b05 |
SYNTAX JmUTF8StringTC (SIZE(0..63))
|
|
Packit |
022b05 |
MAX-ACCESS read-only
|
|
Packit |
022b05 |
STATUS current
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"The human readable name of this job set assigned by the system
|
|
Packit |
022b05 |
administrator (by means outside of this MIB). Typically, this
|
|
Packit |
022b05 |
name SHOULD be the name of the job queue. If a server or
|
|
Packit |
022b05 |
device has only a single job set, this object can be the
|
|
Packit |
022b05 |
administratively assigned name of the server or device itself.
|
|
Packit |
022b05 |
This name does not need to be unique, though each job set in a
|
|
Packit |
022b05 |
single Job Monitoring MIB SHOULD have distinct names.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
NOTE - If the job set corresponds to a single printer and the
|
|
Packit |
022b05 |
Printer MIB is implemented, this value SHOULD be the same as
|
|
Packit |
022b05 |
the prtGeneralPrinterName object in the draft Printer MIB
|
|
Packit |
022b05 |
[print-mib-draft]. If the job set corresponds to an IPP
|
|
Packit |
022b05 |
Printer, this value SHOULD be the same as the IPP 'printer-
|
|
Packit |
022b05 |
name' Printer attribute.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
NOTE - The purpose of this object is to help the user of the
|
|
Packit |
022b05 |
job monitoring application distinguish between several job sets
|
|
Packit |
022b05 |
in implementations that support more than one job set.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
See the OBJECT compliance macro for the minimum maximum length
|
|
Packit |
022b05 |
required for conformance."
|
|
Packit |
022b05 |
DEFVAL { ''H } -- empty string
|
|
Packit |
022b05 |
::= { jmGeneralEntry 7 }
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
-- The Job ID Group (MANDATORY)
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
-- The jmJobIDGroup consists entirely of the jmJobIDTable.
|
|
Packit |
022b05 |
jmJobID OBJECT IDENTIFIER ::= { jobmonMIBObjects 2 }
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
jmJobIDTable OBJECT-TYPE
|
|
Packit |
022b05 |
SYNTAX SEQUENCE OF JmJobIDEntry
|
|
Packit |
022b05 |
MAX-ACCESS not-accessible
|
|
Packit |
022b05 |
STATUS current
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"The jmJobIDTable provides a correspondence map (1) between the
|
|
Packit |
022b05 |
job submission ID that a client uses to refer to a job and (2)
|
|
Packit |
022b05 |
the jmGeneralJobSetIndex and jmJobIndex that the Job Monitoring
|
|
Packit |
022b05 |
MIB agent assigned to the job and that are used to access the
|
|
Packit |
022b05 |
job in all of the other tables in the MIB. If a monitoring
|
|
Packit |
022b05 |
application already knows the jmGeneralJobSetIndex and the
|
|
Packit |
022b05 |
jmJobIndex of the job it is querying, that application NEED NOT
|
|
Packit |
022b05 |
use the jmJobIDTable.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
The MANDATORY-GROUP macro specifies that this group is
|
|
Packit |
022b05 |
MANDATORY."
|
|
Packit |
022b05 |
::= { jmJobID 1 }
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
jmJobIDEntry OBJECT-TYPE
|
|
Packit |
022b05 |
SYNTAX JmJobIDEntry
|
|
Packit |
022b05 |
MAX-ACCESS not-accessible
|
|
Packit |
022b05 |
STATUS current
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"The map from (1) the jmJobSubmissionID to (2) the
|
|
Packit |
022b05 |
jmGeneralJobSetIndex and jmJobIndex.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
An entry SHALL exist in this table for each job currently known
|
|
Packit |
022b05 |
to the agent for all job sets and job states. There MAY be
|
|
Packit |
022b05 |
more than one jmJobIDEntry that maps to a single job. This
|
|
Packit |
022b05 |
many to one mapping can occur when more than one network entity
|
|
Packit |
022b05 |
along the job submission path supplies a job submission ID.
|
|
Packit |
022b05 |
See Section 3.5. However, each job SHALL appear once and in
|
|
Packit |
022b05 |
one and only one job set."
|
|
Packit |
022b05 |
INDEX { jmJobSubmissionID }
|
|
Packit |
022b05 |
::= { jmJobIDTable 1 }
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
JmJobIDEntry ::= SEQUENCE {
|
|
Packit |
022b05 |
jmJobSubmissionID OCTET STRING,
|
|
Packit |
022b05 |
jmJobIDJobSetIndex Integer32,
|
|
Packit |
022b05 |
jmJobIDJobIndex Integer32
|
|
Packit |
022b05 |
}
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
jmJobSubmissionID OBJECT-TYPE
|
|
Packit |
022b05 |
SYNTAX OCTET STRING(SIZE(48))
|
|
Packit |
022b05 |
MAX-ACCESS not-accessible
|
|
Packit |
022b05 |
STATUS current
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"A quasi-unique 48-octet fixed-length string ID which
|
|
Packit |
022b05 |
identifies the job within a particular client-server
|
|
Packit |
022b05 |
environment. There are multiple formats for the
|
|
Packit |
022b05 |
jmJobSubmissionID. Each format SHALL be uniquely identified.
|
|
Packit |
022b05 |
See the JmJobSubmissionIDTypeTC textual convention. Each
|
|
Packit |
022b05 |
format SHALL be registered using the procedures of a type 2
|
|
Packit |
022b05 |
enum. See section 3.7.3 entitled: 'PWG Registration of Job
|
|
Packit |
022b05 |
Submission Id Formats'.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
If the requester (client or server) does not supply a job
|
|
Packit |
022b05 |
submission ID in the job submission protocol, then the
|
|
Packit |
022b05 |
recipient (server or device) SHALL assign a job submission ID
|
|
Packit |
022b05 |
using any of the standard formats that have been reserved for
|
|
Packit |
022b05 |
agents and adding the final 8 octets to distinguish the ID from
|
|
Packit |
022b05 |
others submitted from the same requester.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
The monitoring application, whether in the client or running
|
|
Packit |
022b05 |
separately, MAY use the job submission ID to help identify
|
|
Packit |
022b05 |
which jmJobIndex was assigned by the agent, i.e., in which row
|
|
Packit |
022b05 |
the job information is in the other tables.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
NOTE - fixed-length is used so that a management application
|
|
Packit |
022b05 |
can use a shortened GetNext varbind (in SNMPv1 and SNMPv2) in
|
|
Packit |
022b05 |
order to get the next submission ID, disregarding the remainder
|
|
Packit |
022b05 |
of the ID in order to access jobs independent of the trailing
|
|
Packit |
022b05 |
identifier part, e.g., to get all jobs submitted by a
|
|
Packit |
022b05 |
particular jmJobOwner or submitted from a particular MAC
|
|
Packit |
022b05 |
address.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
See the JmJobSubmissionIDTypeTC textual convention.
|
|
Packit |
022b05 |
See APPENDIX B - Support of Job Submission Protocols."
|
|
Packit |
022b05 |
::= { jmJobIDEntry 1 }
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
jmJobIDJobSetIndex OBJECT-TYPE
|
|
Packit |
022b05 |
SYNTAX Integer32 (0..32767)
|
|
Packit |
022b05 |
MAX-ACCESS read-only
|
|
Packit |
022b05 |
STATUS current
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"This object contains the value of the jmGeneralJobSetIndex for
|
|
Packit |
022b05 |
the job with the jmJobSubmissionID value, i.e., the job set
|
|
Packit |
022b05 |
index of the job set in which the job was placed when that
|
|
Packit |
022b05 |
server or device accepted the job. This 16-bit value in
|
|
Packit |
022b05 |
combination with the jmJobIDJobIndex value permits the
|
|
Packit |
022b05 |
management application to access the other tables to obtain the
|
|
Packit |
022b05 |
job-specific objects for this job.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
See jmGeneralJobSetIndex in the jmGeneralTable."
|
|
Packit |
022b05 |
DEFVAL { 0 } -- 0 indicates no job set index
|
|
Packit |
022b05 |
::= { jmJobIDEntry 2 }
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
jmJobIDJobIndex OBJECT-TYPE
|
|
Packit |
022b05 |
SYNTAX Integer32 (0..2147483647)
|
|
Packit |
022b05 |
MAX-ACCESS read-only
|
|
Packit |
022b05 |
STATUS current
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"This object contains the value of the jmJobIndex for the job
|
|
Packit |
022b05 |
with the jmJobSubmissionID value, i.e., the job index for the
|
|
Packit |
022b05 |
job when the server or device accepted the job. This value, in
|
|
Packit |
022b05 |
combination with the jmJobIDJobSetIndex value, permits the
|
|
Packit |
022b05 |
management application to access the other tables to obtain the
|
|
Packit |
022b05 |
job-specific objects for this job.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
See jmJobIndex in the jmJobTable."
|
|
Packit |
022b05 |
DEFVAL { 0 } -- 0 indicates no jmJobIndex value.
|
|
Packit |
022b05 |
::= { jmJobIDEntry 3 }
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
-- The Job Group (MANDATORY)
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
-- The jmJobGroup consists entirely of the jmJobTable.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
jmJob OBJECT IDENTIFIER ::= { jobmonMIBObjects 3 }
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
jmJobTable OBJECT-TYPE
|
|
Packit |
022b05 |
SYNTAX SEQUENCE OF JmJobEntry
|
|
Packit |
022b05 |
MAX-ACCESS not-accessible
|
|
Packit |
022b05 |
STATUS current
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"The jmJobTable consists of basic job state and status
|
|
Packit |
022b05 |
information for each job in a job set that (1) monitoring
|
|
Packit |
022b05 |
applications need to be able to access in a single SNMP Get
|
|
Packit |
022b05 |
operation, (2) that have a single value per job, and (3) that
|
|
Packit |
022b05 |
SHALL always be implemented.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
The MANDATORY-GROUP macro specifies that this group is
|
|
Packit |
022b05 |
MANDATORY."
|
|
Packit |
022b05 |
::= { jmJob 1 }
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
jmJobEntry OBJECT-TYPE
|
|
Packit |
022b05 |
SYNTAX JmJobEntry
|
|
Packit |
022b05 |
MAX-ACCESS not-accessible
|
|
Packit |
022b05 |
STATUS current
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"Basic per-job state and status information.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
An entry SHALL exist in this table for each job, no matter what
|
|
Packit |
022b05 |
the state of the job is. Each job SHALL appear in one and only
|
|
Packit |
022b05 |
one job set.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
See Section 3.2 entitled 'The Job Tables'."
|
|
Packit |
022b05 |
INDEX { jmGeneralJobSetIndex, jmJobIndex }
|
|
Packit |
022b05 |
::= { jmJobTable 1 }
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
JmJobEntry ::= SEQUENCE {
|
|
Packit |
022b05 |
jmJobIndex Integer32,
|
|
Packit |
022b05 |
jmJobState JmJobStateTC,
|
|
Packit |
022b05 |
jmJobStateReasons1 JmJobStateReasons1TC,
|
|
Packit |
022b05 |
jmNumberOfInterveningJobs Integer32,
|
|
Packit |
022b05 |
jmJobKOctetsPerCopyRequested Integer32,
|
|
Packit |
022b05 |
jmJobKOctetsProcessed Integer32,
|
|
Packit |
022b05 |
jmJobImpressionsPerCopyRequested Integer32,
|
|
Packit |
022b05 |
jmJobImpressionsCompleted Integer32,
|
|
Packit |
022b05 |
jmJobOwner JmJobStringTC
|
|
Packit |
022b05 |
}
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
jmJobIndex OBJECT-TYPE
|
|
Packit |
022b05 |
SYNTAX Integer32 (1..2147483647)
|
|
Packit |
022b05 |
MAX-ACCESS not-accessible
|
|
Packit |
022b05 |
STATUS current
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"The sequential, monatonically increasing identifier index for
|
|
Packit |
022b05 |
the job generated by the server or device when that server or
|
|
Packit |
022b05 |
device accepted the job. This index value permits the
|
|
Packit |
022b05 |
management application to access the other tables to obtain the
|
|
Packit |
022b05 |
job-specific row entries.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
See Section 3.2 entitled 'The Job Tables and the Oldest Active
|
|
Packit |
022b05 |
and Newest Active Indexes'.
|
|
Packit |
022b05 |
See Section 3.5 entitled 'Job Identification'.
|
|
Packit |
022b05 |
See also jmGeneralNewestActiveJobIndex for the largest value of
|
|
Packit |
022b05 |
jmJobIndex.
|
|
Packit |
022b05 |
See JmJobSubmissionIDTypeTC for a limit on the size of this
|
|
Packit |
022b05 |
index if the agent represents it as an 8-digit decimal number."
|
|
Packit |
022b05 |
::= { jmJobEntry 1 }
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
jmJobState OBJECT-TYPE
|
|
Packit |
022b05 |
SYNTAX JmJobStateTC
|
|
Packit |
022b05 |
MAX-ACCESS read-only
|
|
Packit |
022b05 |
STATUS current
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"The current state of the job (pending, processing, completed,
|
|
Packit |
022b05 |
etc.). Agents SHALL implement only those states which are
|
|
Packit |
022b05 |
appropriate for the particular implementation. However,
|
|
Packit |
022b05 |
management applications SHALL be prepared to receive all the
|
|
Packit |
022b05 |
standard job states.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
The final value for this object SHALL be one of: completed,
|
|
Packit |
022b05 |
canceled, or aborted. The minimum length of time that the
|
|
Packit |
022b05 |
agent SHALL maintain MIB data for a job in the completed,
|
|
Packit |
022b05 |
canceled, or aborted state before removing the job data from
|
|
Packit |
022b05 |
the jmJobIDTable and jmJobTable is specified by the value of
|
|
Packit |
022b05 |
the jmGeneralJobPersistence object."
|
|
Packit |
022b05 |
DEFVAL { unknown } -- default is unknown
|
|
Packit |
022b05 |
::= { jmJobEntry 2 }
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
jmJobStateReasons1 OBJECT-TYPE
|
|
Packit |
022b05 |
SYNTAX JmJobStateReasons1TC
|
|
Packit |
022b05 |
MAX-ACCESS read-only
|
|
Packit |
022b05 |
STATUS current
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"Additional information about the job's current state, i.e.,
|
|
Packit |
022b05 |
information that augments the value of the job's jmJobState
|
|
Packit |
022b05 |
object.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
Implementation of any reason values is OPTIONAL, but an agent
|
|
Packit |
022b05 |
SHOULD return any reason information available. These values
|
|
Packit |
022b05 |
MAY be used with any job state or states for which the reason
|
|
Packit |
022b05 |
makes sense. Since the Job State Reasons will be more dynamic
|
|
Packit |
022b05 |
than the Job State, it is recommended that a job monitoring
|
|
Packit |
022b05 |
application read this object every time jmJobState is read.
|
|
Packit |
022b05 |
When the agent cannot provide a reason for the current state of
|
|
Packit |
022b05 |
the job, the value of the jmJobStateReasons1 object and
|
|
Packit |
022b05 |
jobStateReasonsN attributes SHALL be 0.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
The jobStateReasonsN (N=2..4) attributes provide further
|
|
Packit |
022b05 |
additional information about the job's current state."
|
|
Packit |
022b05 |
DEFVAL { 0 } -- no reasons
|
|
Packit |
022b05 |
::= { jmJobEntry 3 }
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
jmNumberOfInterveningJobs OBJECT-TYPE
|
|
Packit |
022b05 |
SYNTAX Integer32 (-2..2147483647)
|
|
Packit |
022b05 |
MAX-ACCESS read-only
|
|
Packit |
022b05 |
STATUS current
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"The number of jobs that are expected to complete processing
|
|
Packit |
022b05 |
before this job has completed processing according to the
|
|
Packit |
022b05 |
implementation's queuing algorithm, if no other jobs were to be
|
|
Packit |
022b05 |
submitted. In other words, this value is the job's queue
|
|
Packit |
022b05 |
position. The agent SHALL return a value of 0 for this
|
|
Packit |
022b05 |
attribute when the job is the next job to complete processing
|
|
Packit |
022b05 |
(or has completed processing)."
|
|
Packit |
022b05 |
DEFVAL { 0 } -- default is no intervening jobs.
|
|
Packit |
022b05 |
::= { jmJobEntry 4 }
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
jmJobKOctetsPerCopyRequested OBJECT-TYPE
|
|
Packit |
022b05 |
SYNTAX Integer32 (-2..2147483647)
|
|
Packit |
022b05 |
MAX-ACCESS read-only
|
|
Packit |
022b05 |
STATUS current
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"The total size in K (1024) octets of the document(s) being
|
|
Packit |
022b05 |
requested to be processed in the job. The agent SHALL round
|
|
Packit |
022b05 |
the actual number of octets up to the next highest K. Thus 0
|
|
Packit |
022b05 |
octets is represented as '0', 1-1024 octets is represented as
|
|
Packit |
022b05 |
'1', 1025-2048 is represented as '2', etc.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
In computing this value, the server/device SHALL NOT include
|
|
Packit |
022b05 |
the multiplicative factors contributed by (1) the number of
|
|
Packit |
022b05 |
document copies, and (2) the number of job copies, independent
|
|
Packit |
022b05 |
of whether the device can process multiple copies of the job or
|
|
Packit |
022b05 |
document without making multiple passes over the job or
|
|
Packit |
022b05 |
document data and independent of whether the output is collated
|
|
Packit |
022b05 |
or not. Thus the server/device computation is independent of
|
|
Packit |
022b05 |
the implementation and indicates the size of the document(s)
|
|
Packit |
022b05 |
measured in K octets independent of the number of copies."
|
|
Packit |
022b05 |
DEFVAL { -2 } -- the default is unknown(-2)
|
|
Packit |
022b05 |
::= { jmJobEntry 5 }
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
jmJobKOctetsProcessed OBJECT-TYPE
|
|
Packit |
022b05 |
SYNTAX Integer32 (-2..2147483647)
|
|
Packit |
022b05 |
MAX-ACCESS read-only
|
|
Packit |
022b05 |
STATUS current
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"The total number of octets processed by the server or device
|
|
Packit |
022b05 |
measured in units of K (1024) octets so far. The agent SHALL
|
|
Packit |
022b05 |
round the actual number of octets processed up to the next
|
|
Packit |
022b05 |
higher K. Thus 0 octets is represented as '0', 1-1024 octets
|
|
Packit |
022b05 |
is represented as '1', 1025-2048 octets is '2', etc. For
|
|
Packit |
022b05 |
printing devices, this value is the number interpreted by the
|
|
Packit |
022b05 |
page description language interpreter rather than what has been
|
|
Packit |
022b05 |
marked on media.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
For implementations where multiple copies are produced by the
|
|
Packit |
022b05 |
interpreter with only a single pass over the data, the final
|
|
Packit |
022b05 |
value SHALL be equal to the value of the
|
|
Packit |
022b05 |
jmJobKOctetsPerCopyRequested object. For implementations where
|
|
Packit |
022b05 |
multiple copies are produced by the interpreter by processing
|
|
Packit |
022b05 |
the data for each copy, the final value SHALL be a multiple of
|
|
Packit |
022b05 |
the value of the jmJobKOctetsPerCopyRequested object.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
NOTE - See the impressionsCompletedCurrentCopy and
|
|
Packit |
022b05 |
pagesCompletedCurrentCopy attributes for attributes that are
|
|
Packit |
022b05 |
reset on each document copy.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
NOTE - The jmJobKOctetsProcessed object can be used with the
|
|
Packit |
022b05 |
jmJobKOctetsPerCopyRequested object to provide an indication of
|
|
Packit |
022b05 |
the relative progress of the job, provided that the
|
|
Packit |
022b05 |
multiplicative factor is taken into account for some
|
|
Packit |
022b05 |
implementations of multiple copies."
|
|
Packit |
022b05 |
DEFVAL { 0 } -- default is no octets processed.
|
|
Packit |
022b05 |
::= { jmJobEntry 6 }
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
jmJobImpressionsPerCopyRequested OBJECT-TYPE
|
|
Packit |
022b05 |
SYNTAX Integer32 (-2..2147483647)
|
|
Packit |
022b05 |
MAX-ACCESS read-only
|
|
Packit |
022b05 |
STATUS current
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"The total size in number of impressions of the document(s)
|
|
Packit |
022b05 |
submitted.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
In computing this value, the server/device SHALL NOT include
|
|
Packit |
022b05 |
the multiplicative factors contributed by (1) the number of
|
|
Packit |
022b05 |
document copies, and (2) the number of job copies, independent
|
|
Packit |
022b05 |
of whether the device can process multiple copies of the job or
|
|
Packit |
022b05 |
document without making multiple passes over the job or
|
|
Packit |
022b05 |
document data and independent of whether the output is collated
|
|
Packit |
022b05 |
or not. Thus the server/device computation is independent of
|
|
Packit |
022b05 |
the implementation and reflects the size of the document(s)
|
|
Packit |
022b05 |
measured in impressions independent of the number of copies.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
See the definition of the term 'impression' in Section 2."
|
|
Packit |
022b05 |
DEFVAL { -2 } -- default is unknown(-2)
|
|
Packit |
022b05 |
::= { jmJobEntry 7 }
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
jmJobImpressionsCompleted OBJECT-TYPE
|
|
Packit |
022b05 |
SYNTAX Integer32 (-2..2147483647)
|
|
Packit |
022b05 |
MAX-ACCESS read-only
|
|
Packit |
022b05 |
STATUS current
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"The total number of impressions completed for this job so far.
|
|
Packit |
022b05 |
For printing devices, the impressions completed includes
|
|
Packit |
022b05 |
interpreting, marking, and stacking the output. For other
|
|
Packit |
022b05 |
types of job services, the number of impressions completed
|
|
Packit |
022b05 |
includes the number of impressions processed.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
NOTE - See the impressionsCompletedCurrentCopy and
|
|
Packit |
022b05 |
pagesCompletedCurrentCopy attributes for attributes that are
|
|
Packit |
022b05 |
reset on each document copy.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
NOTE - The jmJobImpressionsCompleted object can be used with
|
|
Packit |
022b05 |
the jmJobImpressionsPerCopyRequested object to provide an
|
|
Packit |
022b05 |
indication of the relative progress of the job, provided that
|
|
Packit |
022b05 |
the multiplicative factor is taken into account for some
|
|
Packit |
022b05 |
implementations of multiple copies.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
See the definition of the term 'impression' in Section 2 and
|
|
Packit |
022b05 |
the counting example in Section 3.4 entitled 'Monitoring Job
|
|
Packit |
022b05 |
Progress'."
|
|
Packit |
022b05 |
DEFVAL { 0 } -- default is no octets
|
|
Packit |
022b05 |
::= { jmJobEntry 8 }
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
jmJobOwner OBJECT-TYPE
|
|
Packit |
022b05 |
SYNTAX JmJobStringTC (SIZE(0..63))
|
|
Packit |
022b05 |
MAX-ACCESS read-only
|
|
Packit |
022b05 |
STATUS current
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"The coded character set name of the user that submitted the
|
|
Packit |
022b05 |
job. The method of assigning this user name will be system
|
|
Packit |
022b05 |
and/or site specific but the method MUST ensure that the name
|
|
Packit |
022b05 |
is unique to the network that is visible to the client and
|
|
Packit |
022b05 |
target device.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
This value SHOULD be the most authenticated name of the user
|
|
Packit |
022b05 |
submitting the job.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
See the OBJECT compliance macro for the minimum maximum length
|
|
Packit |
022b05 |
required for conformance."
|
|
Packit |
022b05 |
DEFVAL { ''H } -- default is empty string
|
|
Packit |
022b05 |
::= { jmJobEntry 9 }
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
-- The Attribute Group (MANDATORY)
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
-- The jmAttributeGroup consists entirely of the jmAttributeTable.
|
|
Packit |
022b05 |
--
|
|
Packit |
022b05 |
-- Implementation of the objects in this group is MANDATORY.
|
|
Packit |
022b05 |
-- See Section 3.1 entitled 'Conformance Considerations'.
|
|
Packit |
022b05 |
-- An agent SHALL implement any attribute if (1) the server or device
|
|
Packit |
022b05 |
-- supports the functionality represented by the attribute and (2) the
|
|
Packit |
022b05 |
-- information is available to the agent.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
jmAttribute OBJECT IDENTIFIER ::= { jobmonMIBObjects 4 }
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
jmAttributeTable OBJECT-TYPE
|
|
Packit |
022b05 |
SYNTAX SEQUENCE OF JmAttributeEntry
|
|
Packit |
022b05 |
MAX-ACCESS not-accessible
|
|
Packit |
022b05 |
STATUS current
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"The jmAttributeTable SHALL contain attributes of the job and
|
|
Packit |
022b05 |
document(s) for each job in a job set. Instead of allocating
|
|
Packit |
022b05 |
distinct objects for each attribute, each attribute is
|
|
Packit |
022b05 |
represented as a separate row in the jmAttributeTable.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
The MANDATORY-GROUP macro specifies that this group is
|
|
Packit |
022b05 |
MANDATORY. An agent SHALL implement any attribute if (1) the
|
|
Packit |
022b05 |
server or device supports the functionality represented by the
|
|
Packit |
022b05 |
attribute and (2) the information is available to the agent. "
|
|
Packit |
022b05 |
::= { jmAttribute 1 }
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
jmAttributeEntry OBJECT-TYPE
|
|
Packit |
022b05 |
SYNTAX JmAttributeEntry
|
|
Packit |
022b05 |
MAX-ACCESS not-accessible
|
|
Packit |
022b05 |
STATUS current
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"Attributes representing information about the job and
|
|
Packit |
022b05 |
document(s) or resources required and/or consumed.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
Each entry in the jmAttributeTable is a per-job entry with an
|
|
Packit |
022b05 |
extra index for each type of attribute (jmAttributeTypeIndex)
|
|
Packit |
022b05 |
that a job can have and an additional index
|
|
Packit |
022b05 |
(jmAttributeInstanceIndex) for those attributes that can have
|
|
Packit |
022b05 |
multiple instances per job. The jmAttributeTypeIndex object
|
|
Packit |
022b05 |
SHALL contain an enum type that indicates the type of attribute
|
|
Packit |
022b05 |
(see the JmAttributeTypeTC textual-convention). The value of
|
|
Packit |
022b05 |
the attribute SHALL be represented in either the
|
|
Packit |
022b05 |
jmAttributeValueAsInteger or jmAttributeValueAsOctets objects,
|
|
Packit |
022b05 |
and/or both, as specified in the JmAttributeTypeTC textual-
|
|
Packit |
022b05 |
convention.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
The agent SHALL create rows in the jmAttributeTable as the
|
|
Packit |
022b05 |
server or device is able to discover the attributes either from
|
|
Packit |
022b05 |
the job submission protocol itself or from the document PDL.
|
|
Packit |
022b05 |
As the documents are interpreted, the interpreter MAY discover
|
|
Packit |
022b05 |
additional attributes and so the agent adds additional rows to
|
|
Packit |
022b05 |
this table. As the attributes that represent resources are
|
|
Packit |
022b05 |
actually consumed, the usage counter contained in the
|
|
Packit |
022b05 |
jmAttributeValueAsInteger object is incremented according to
|
|
Packit |
022b05 |
the units indicated in the description of the JmAttributeTypeTC
|
|
Packit |
022b05 |
enum.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
The agent SHALL maintain each row in the jmAttributeTable for
|
|
Packit |
022b05 |
at least the minimum time after a job completes as specified by
|
|
Packit |
022b05 |
the jmGeneralAttributePersistence object.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
Zero or more entries SHALL exist in this table for each job in
|
|
Packit |
022b05 |
a job set.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
See Section 3.3 entitled 'The Attribute Mechanism' for a
|
|
Packit |
022b05 |
description of the jmAttributeTable."
|
|
Packit |
022b05 |
INDEX { jmGeneralJobSetIndex, jmJobIndex, jmAttributeTypeIndex,
|
|
Packit |
022b05 |
jmAttributeInstanceIndex }
|
|
Packit |
022b05 |
::= { jmAttributeTable 1 }
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
JmAttributeEntry ::= SEQUENCE {
|
|
Packit |
022b05 |
jmAttributeTypeIndex JmAttributeTypeTC,
|
|
Packit |
022b05 |
jmAttributeInstanceIndex Integer32,
|
|
Packit |
022b05 |
jmAttributeValueAsInteger Integer32,
|
|
Packit |
022b05 |
jmAttributeValueAsOctets OCTET STRING
|
|
Packit |
022b05 |
}
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
jmAttributeTypeIndex OBJECT-TYPE
|
|
Packit |
022b05 |
SYNTAX JmAttributeTypeTC
|
|
Packit |
022b05 |
MAX-ACCESS not-accessible
|
|
Packit |
022b05 |
STATUS current
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"The type of attribute that this row entry represents.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
The type MAY identify information about the job or document(s)
|
|
Packit |
022b05 |
or MAY identify a resource required to process the job before
|
|
Packit |
022b05 |
the job start processing and/or consumed by the job as the job
|
|
Packit |
022b05 |
is processed.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
Examples of job attributes (i.e., apply to the job as a whole)
|
|
Packit |
022b05 |
that have only one instance per job include:
|
|
Packit |
022b05 |
jobCopiesRequested(90), documentCopiesRequested(92),
|
|
Packit |
022b05 |
jobCopiesCompleted(91), documentCopiesCompleted(93), while
|
|
Packit |
022b05 |
examples of job attributes that may have more than one instance
|
|
Packit |
022b05 |
per job include: documentFormatIndex(37), and
|
|
Packit |
022b05 |
documentFormat(38).
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
Examples of document attributes (one instance per document)
|
|
Packit |
022b05 |
include: fileName(34), and documentName(35).
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
Examples of required and consumed resource attributes include:
|
|
Packit |
022b05 |
pagesRequested(130), mediumRequested(170), pagesCompleted(131),
|
|
Packit |
022b05 |
and mediumConsumed(171), respectively."
|
|
Packit |
022b05 |
::= { jmAttributeEntry 1 }
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
jmAttributeInstanceIndex OBJECT-TYPE
|
|
Packit |
022b05 |
SYNTAX Integer32 (1..32767)
|
|
Packit |
022b05 |
MAX-ACCESS not-accessible
|
|
Packit |
022b05 |
STATUS current
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"A running 16-bit index of the attributes of the same type for
|
|
Packit |
022b05 |
each job. For those attributes with only a single instance per
|
|
Packit |
022b05 |
job, this index value SHALL be 1. For those attributes that
|
|
Packit |
022b05 |
are a single value per document, the index value SHALL be the
|
|
Packit |
022b05 |
document number, starting with 1 for the first document in the
|
|
Packit |
022b05 |
job. Jobs with only a single document SHALL use the index
|
|
Packit |
022b05 |
value of 1. For those attributes that can have multiple values
|
|
Packit |
022b05 |
per job or per document, such as documentFormatIndex(37) or
|
|
Packit |
022b05 |
documentFormat(38), the index SHALL be a running index for the
|
|
Packit |
022b05 |
job as a whole, starting at 1."
|
|
Packit |
022b05 |
::= { jmAttributeEntry 2 }
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
jmAttributeValueAsInteger OBJECT-TYPE
|
|
Packit |
022b05 |
SYNTAX Integer32 (-2..2147483647)
|
|
Packit |
022b05 |
MAX-ACCESS read-only
|
|
Packit |
022b05 |
STATUS current
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"The integer value of the attribute. The value of the
|
|
Packit |
022b05 |
attribute SHALL be represented as an integer if the enum
|
|
Packit |
022b05 |
description in the JmAttributeTypeTC textual-convention
|
|
Packit |
022b05 |
definition has the tag: 'INTEGER:'.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
Depending on the enum definition, this object value MAY be an
|
|
Packit |
022b05 |
integer, a counter, an index, or an enum, depending on the
|
|
Packit |
022b05 |
jmAttributeTypeIndex value. The units of this value are
|
|
Packit |
022b05 |
specified in the enum description.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
For those attributes that are accumulating job consumption as
|
|
Packit |
022b05 |
the job is processed as specified in the JmAttributeTypeTC
|
|
Packit |
022b05 |
textual-convention, SHALL contain the final value after the job
|
|
Packit |
022b05 |
completes processing, i.e., this value SHALL indicate the total
|
|
Packit |
022b05 |
usage of this resource made by the job.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
A monitoring application is able to copy this value to a
|
|
Packit |
022b05 |
suitable longer term storage for later processing as part of an
|
|
Packit |
022b05 |
accounting system.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
Since the agent MAY add attributes representing resources to
|
|
Packit |
022b05 |
this table while the job is waiting to be processed or being
|
|
Packit |
022b05 |
processed, which can be a long time before any of the resources
|
|
Packit |
022b05 |
are actually used, the agent SHALL set the value of the
|
|
Packit |
022b05 |
jmAttributeValueAsInteger object to 0 for resources that the
|
|
Packit |
022b05 |
job has not yet consumed.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
Attributes for which the concept of an integer value is
|
|
Packit |
022b05 |
meaningless, such as fileName(34), jobName, and
|
|
Packit |
022b05 |
processingMessage, do not have the 'INTEGER:' tag in the
|
|
Packit |
022b05 |
JmAttributeTypeTC definition and so an agent SHALL always
|
|
Packit |
022b05 |
return a value of '-1' to indicate 'other' for the value of the
|
|
Packit |
022b05 |
jmAttributeValueAsInteger object for these attributes.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
For attributes which do have the 'INTEGER:' tag in the
|
|
Packit |
022b05 |
JmAttributeTypeTC definition, if the integer value is not (yet)
|
|
Packit |
022b05 |
known, the agent either (1) SHALL not materialize the row in
|
|
Packit |
022b05 |
the jmAttributeTable until the value is known or (2) SHALL
|
|
Packit |
022b05 |
return a '-2' to represent an 'unknown' counting integer value,
|
|
Packit |
022b05 |
a '0' to represent an 'unknown' index value, and a '2' to
|
|
Packit |
022b05 |
represent an 'unknown(2)' enum value."
|
|
Packit |
022b05 |
DEFVAL { -2 } -- default value is unknown(-2)
|
|
Packit |
022b05 |
::= { jmAttributeEntry 3 }
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
jmAttributeValueAsOctets OBJECT-TYPE
|
|
Packit |
022b05 |
SYNTAX OCTET STRING(SIZE(0..63))
|
|
Packit |
022b05 |
MAX-ACCESS read-only
|
|
Packit |
022b05 |
STATUS current
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"The octet string value of the attribute. The value of the
|
|
Packit |
022b05 |
attribute SHALL be represented as an OCTET STRING if the enum
|
|
Packit |
022b05 |
description in the JmAttributeTypeTC textual-convention
|
|
Packit |
022b05 |
definition has the tag: 'OCTETS:'.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
Depending on the enum definition, this object value MAY be a
|
|
Packit |
022b05 |
coded character set string (text), such as 'JmUTF8StringTC', or
|
|
Packit |
022b05 |
a binary octet string, such as 'DateAndTime'.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
Attributes for which the concept of an octet string value is
|
|
Packit |
022b05 |
meaningless, such as pagesCompleted, do not have the tag
|
|
Packit |
022b05 |
'OCTETS:' in the JmAttributeTypeTC definition and so the agent
|
|
Packit |
022b05 |
SHALL always return a zero length string for the value of the
|
|
Packit |
022b05 |
jmAttributeValueAsOctets object.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
For attributes which do have the 'OCTETS:' tag in the
|
|
Packit |
022b05 |
JmAttributeTypeTC definition, if the OCTET STRING value is not
|
|
Packit |
022b05 |
(yet) known, the agent either SHALL NOT materialize the row in
|
|
Packit |
022b05 |
the jmAttributeTable until the value is known or SHALL return a
|
|
Packit |
022b05 |
zero-length string."
|
|
Packit |
022b05 |
DEFVAL { ''H } -- empty string
|
|
Packit |
022b05 |
::= { jmAttributeEntry 4 }
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
-- Notifications and Trapping
|
|
Packit |
022b05 |
-- Reserved for the future
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
jobmonMIBNotifications OBJECT IDENTIFIER ::= { jobmonMIB 2 }
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
-- Conformance Information
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
jmMIBConformance OBJECT IDENTIFIER ::= { jobmonMIB 3 }
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
-- compliance statements
|
|
Packit |
022b05 |
jmMIBCompliance MODULE-COMPLIANCE
|
|
Packit |
022b05 |
STATUS current
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"The compliance statement for agents that implement the
|
|
Packit |
022b05 |
job monitoring MIB."
|
|
Packit |
022b05 |
MODULE -- this module
|
|
Packit |
022b05 |
MANDATORY-GROUPS {
|
|
Packit |
022b05 |
jmGeneralGroup, jmJobIDGroup, jmJobGroup, jmAttributeGroup }
|
|
Packit |
022b05 |
OBJECT jmGeneralJobSetName
|
|
Packit |
022b05 |
SYNTAX JmUTF8StringTC (SIZE(0..8))
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"Only 8 octets maximum string length NEED be supported by the
|
|
Packit |
022b05 |
agent."
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
OBJECT jmJobOwner
|
|
Packit |
022b05 |
SYNTAX JmJobStringTC (SIZE(0..16))
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"Only 16 octets maximum string length NEED be supported by the
|
|
Packit |
022b05 |
agent."
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
-- There are no CONDITIONALLY MANDATORY or OPTIONAL groups.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
::= { jmMIBConformance 1 }
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
jmMIBGroups OBJECT IDENTIFIER ::= { jmMIBConformance 2 }
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
jmGeneralGroup OBJECT-GROUP
|
|
Packit |
022b05 |
OBJECTS {
|
|
Packit |
022b05 |
jmGeneralNumberOfActiveJobs, jmGeneralOldestActiveJobIndex,
|
|
Packit |
022b05 |
jmGeneralNewestActiveJobIndex, jmGeneralJobPersistence,
|
|
Packit |
022b05 |
jmGeneralAttributePersistence, jmGeneralJobSetName}
|
|
Packit |
022b05 |
STATUS current
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"The general group."
|
|
Packit |
022b05 |
::= { jmMIBGroups 1 }
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
jmJobIDGroup OBJECT-GROUP
|
|
Packit |
022b05 |
OBJECTS {
|
|
Packit |
022b05 |
jmJobIDJobSetIndex, jmJobIDJobIndex }
|
|
Packit |
022b05 |
STATUS current
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"The job ID group."
|
|
Packit |
022b05 |
::= { jmMIBGroups 2 }
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
jmJobGroup OBJECT-GROUP
|
|
Packit |
022b05 |
OBJECTS {
|
|
Packit |
022b05 |
jmJobState, jmJobStateReasons1, jmNumberOfInterveningJobs,
|
|
Packit |
022b05 |
jmJobKOctetsPerCopyRequested, jmJobKOctetsProcessed,
|
|
Packit |
022b05 |
jmJobImpressionsPerCopyRequested, jmJobImpressionsCompleted,
|
|
Packit |
022b05 |
jmJobOwner }
|
|
Packit |
022b05 |
STATUS current
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"The job group."
|
|
Packit |
022b05 |
::= { jmMIBGroups 3 }
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
jmAttributeGroup OBJECT-GROUP
|
|
Packit |
022b05 |
OBJECTS {
|
|
Packit |
022b05 |
jmAttributeValueAsInteger, jmAttributeValueAsOctets }
|
|
Packit |
022b05 |
STATUS current
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"The attribute group."
|
|
Packit |
022b05 |
::= { jmMIBGroups 4 }
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
END
|