reserved in IPP. Implementers are warned that use of such values may
conflict with other implementations. Implementers are encouraged to
request registration of enum values following the procedures in
Section 3.7.1.
NOTE: No attribute name exceeds 31 characters.
The standard attribute types are:
jmAttributeTypeIndex Datatype
-------------------- --------
other(1), Integer32 (-2..2147483647)
AND/OR
OCTET STRING(SIZE(0..63))
INTEGER: and/or OCTETS: An attribute that is not in the
list and/or that has not been approved and registered with
the PWG.
+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
+ Job State attributes (3 - 19 decimal)
+
+ The following attributes specify the state of a job.
+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
jobStateReasons2(3), JmJobStateReasons2TC
INTEGER: Additional information about the job's current state
that augments the jmJobState object. See the description under
the JmJobStateReasons1TC textual-convention.
jobStateReasons3(4), JmJobStateReasons3TC
INTEGER: Additional information about the job's current state
that augments the jmJobState object. See the description under
JmJobStateReasons1TC textual-convention.
jobStateReasons4(5), JmJobStateReasons4TC
INTEGER: Additional information about the job's current state
that augments the jmJobState object. See the description under
JmJobStateReasons1TC textual-convention.
processingMessage(6), JmUTF8StringTC (SIZE(0..63))
OCTETS: MULTI-ROW: A coded character set message that is
generated by the server or device during the processing of the
job as a simple form of processing log to show progress and any
problems. The natural language of each value is specified by
the corresponding processingMessageNaturalLangTag(7) value.
NOTE - This attribute is intended for such conditions as
interpreter messages, rather than being the printable form of
the jmJobState and jmJobStateReasons1 objects and
jobStateReasons2, jobStateReasons3, and jobStateReasons4
attributes. In order to produce a localized printable form of
these job state objects/attribute, a management application
SHOULD produce a message from their enum and bit values.
NOTE - There is no job description attribute in IPP/1.0 that
corresponds to this attribute and this attribute does not
correspond to the IPP/1.0 'job-state-message' job description
attribute, which is just a printable form of the IPP 'job-state'
and 'job-state-reasons' job attributes.
There is no restriction for the same message occurring in
multiple rows.
processingMessageNaturalLangTag(7), OCTET STRING(SIZE(0..63))
OCTETS: MULTI-ROW: The natural language of the corresponding
processingMessage(6) attribute value. See section 3.6.1,
entitled 'Text generated by the server or device'.
If the agent does not know the natural language of the job
processing message, the agent SHALL either (1) return a zero
length string value for the processingMessageNaturalLangTag(7)
attribute or (2) not return the
processingMessageNaturalLangTag(7) attribute for the job.
There is no restriction for the same tag occurring in multiple
rows, since when this attribute is implemented, it SHOULD have a
value row for each corresponding processingMessage(6) attribute
value row.
jobCodedCharSet(8), CodedCharSet
INTEGER: The MIBenum identifier of the coded character set that
the agent is using to represent coded character set objects and
attributes of type 'JmJobStringTC'. These coded character set
objects and attributes are either: (1) supplied by the job
submitting client or (2) defaulted by the server or device when
omitted by the job submitting client. The agent SHALL represent
these objects and attributes in the MIB either (1) in the coded
character set as they were submitted or (2) MAY convert the
coded character set to another coded character set or encoding
scheme as identified by the jobCodedCharSet(8) attribute. See
section 3.6.2, entitled 'Text supplied by the job submitter'.
These MIBenum values are assigned by IANA [IANA-charsets] when
the coded character sets are registered. The coded character
set SHALL be one of the ones registered with IANA [IANA] and the
enum value uses the CodedCharSet textual-convention from the
Printer MIB. See the JmJobStringTC textual-convention.
If the agent does not know what coded character set was used by
the job submitting client, the agent SHALL either (1) return the
'unknown(2)' value for the jobCodedCharSet(8) attribute or (2)
not return the jobCodedCharSet(8) attribute for the job.
jobNaturalLanguageTag(9), OCTET STRING(SIZE(0..63))
OCTETS: The natural language of the job attributes supplied by
the job submitter or defaulted by the server or device for the
job, i.e., all objects and attributes represented by the '
JmJobStringTC' textual-convention, such as jobName,
mediumRequested, etc. See Section 3.6.2, entitled 'Text
supplied by the job submitter'.
If the agent does not know what natural language was used by the
job submitting client, the agent SHALL either (1) return a zero
length string value for the jobNaturalLanguageTag(9) attribute
or (2) not return jobNaturalLanguageTag(9) attribute for the
job.
+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
+ Job Identification attributes (20 - 49 decimal)
+
+ The following attributes help an end user, a system
+ operator, or an accounting program identify a job.
+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
jobURI(20), OCTET STRING(SIZE(0..63))
OCTETS: MULTI-ROW: The job's Universal Resource
Identifier (URI) [RFC1738]. See IPP [ipp-model] for
example usage.
NOTE - The agent may be able to generate this value on each
SNMP Get operation from smaller values, rather than having
to store the entire URI.
If the URI exceeds 63 octets, the agent SHALL use multiple
values, with the next 63 octets coming in the second value,
etc.
NOTE - IPP [ipp-model] has a 1023-octet maximum length for
a URI, though the URI standard itself and HTTP/1.1 specify
no maximum length.
jobAccountName(21), OCTET STRING(SIZE(0..63))
OCTETS: Arbitrary binary information which MAY be coded
character set data or encrypted data supplied by the
submitting user for use by accounting services to allocate
or categorize charges for services provided, such as a
customer account name or number.
NOTE: This attribute NEED NOT be printable characters.
serverAssignedJobName(22), JmJobStringTC (SIZE(0..63))
OCTETS: Configuration 3 only: The human readable string
name, number, or ID of the job as assigned by the server
that submitted the job to the device that the agent is
providing access to with this MIB.
NOTE - This attribute is intended for enabling a user to
find his/her job that a server submitted to a device when
either the client does not support the jmJobSubmissionID or
the server does not pass the jmJobSubmissionID through to
the device.
jobName(23), JmJobStringTC (SIZE(0..63))
OCTETS: The human readable string name of the job as
assigned by the submitting user to help the user
distinguish between his/her various jobs. This name does
not need to be unique.
This attribute is intended for enabling a user or the
user's application to convey a job name that MAY be printed
on a start sheet, returned in a query result, or used in
notification or logging messages.
In order to assist users to find their jobs for job
submission protocols that don't supply a jmJobSubmissionID,
the agent SHOULD maintain the jobName attribute for the
time specified by the jmGeneralJobPersistence object,
rather than the (shorter) jmGeneralAttributePersistence
object.
If this attribute is not specified when the job is
submitted, no job name is assumed, but implementation
specific defaults are allowed, such as the value of the
documentName attribute of the first document in the job or
the fileName attribute of the first document in the job.
The jobName attribute is distinguished from the jobComment
attribute, in that the jobName attribute is intended to
permit the submitting user to distinguish between different
jobs that he/she has submitted. The jobComment attribute
is intended to be free form additional information that a
user might wish to use to communicate with himself/herself,
such as a reminder of what to do with the results or to
indicate a different set of input parameters were tried in
several different job submissions.
jobServiceTypes(24), JmJobServiceTypesTC
INTEGER: Specifies the type(s) of service to which the job
has been submitted (print, fax, scan, etc.). The service
type is bit encoded with each job service type so that more
general and arbitrary services can be created, such as
services with more than one destination type, or ones with
only a source or only a destination. For example, a job
service might scan, faxOut, and print a single job. In
this case, three bits would be set in the jobServiceTypes
attribute, corresponding to the hexadecimal values: 0x8 +
0x20 + 0x4, respectively, yielding: 0x2C.
Whether this attribute is set from a job attribute supplied
by the job submission client or is set by the recipient job
submission server or device depends on the job submission
protocol. This attribute SHALL be implemented if the
server or device has other types in addition to or instead
of printing.
One of the purposes of this attribute is to permit a
requester to filter out jobs that are not of interest. For
example, a printer operator may only be interested in jobs
that include printing.
jobSourceChannelIndex(25), Integer32 (0..2147483647)
INTEGER: The index of the row in the associated Printer
MIB [print-mib] of the channel which is the source of the
print job.
jobSourcePlatformType(26), JmJobSourcePlatformTypeTC
INTEGER: The source platform type of the immediate
upstream submitter that submitted the job to the server
(configuration 2) or device (configuration 1 and 3) to
which the agent is providing access. For configuration 1,
this is the type of the client that submitted the job to
the device; for configuration 2, this is the type of the
client that submitted the job to the server; and for
configuration 3, this is the type of the server that
submitted the job to the device.
submittingServerName(27), JmJobStringTC (SIZE(0..63))
OCTETS: For configuration 3 only: The administrative name
of the server that submitted the job to the device.
submittingApplicationName(28), JmJobStringTC (SIZE(0..63))
OCTETS: The name of the client application (not the server
in configuration 3) that submitted the job to the server or
device.
jobOriginatingHost(29), JmJobStringTC (SIZE(0..63))
OCTETS: The name of the client host (not the server host
name in configuration 3) that submitted the job to the
server or device.
deviceNameRequested(30), JmJobStringTC (SIZE(0..63))
OCTETS: The administratively defined coded character set
name of the target device requested by the submitting user.
For configuration 1, its value corresponds to the Printer
MIB [print-mib]: prtGeneralPrinterName object. For
configuration 2 and 3, its value is the name of the logical
or physical device that the user supplied to indicate to
the server on which device(s) they wanted the job to be
processed.
queueNameRequested(31), JmJobStringTC (SIZE(0..63))
OCTETS: The administratively defined coded character set
name of the target queue requested by the submitting user.
For configuration 1, its value corresponds to the queue in
the device for which the agent is providing access. For
configuration 2 and 3, its value is the name of the queue
that the user supplied to indicate to the server on which
device(s) they wanted the job to be processed.
NOTE - typically an implementation SHOULD support either
the deviceNameRequested or queueNameRequested attribute,
but not both.
physicalDevice(32), hrDeviceIndex
AND/OR
JmUTF8StringTC (SIZE(0..63))
INTEGER: MULTI-ROW: The index of the physical device MIB
instance requested/used, such as the Printer MIB [print-mib].
This value is an hrDeviceIndex value. See the Host
Resources MIB [hr-mib].
AND/OR
OCTETS: MULTI-ROW: The name of the physical device to
which the job is assigned.
numberOfDocuments(33), Integer32 (-2..2147483647)
INTEGER: The number of documents in this job.
The agent SHOULD return this attribute if the job has more
than one document.
fileName(34), JmJobStringTC (SIZE(0..63))
OCTETS: MULTI-ROW: The coded character set file name or
URI [URI-spec] of the document.
There is no restriction on the same file name occurring in
multiple rows.
documentName(35), JmJobStringTC (SIZE(0..63))
OCTETS: MULTI-ROW: The coded character set name of the
document.
There is no restriction on the same document name occurring
in multiple rows.
jobComment(36), JmJobStringTC (SIZE(0..63))
OCTETS: An arbitrary human-readable coded character text
string supplied by the submitting user or the job
submitting application program for any purpose. For
example, a user might indicate what he/she is going to do
with the printed output or the job submitting application
program might indicate how the document was produced.
The jobComment attribute is not intended to be a name; see
the jobName attribute.
documentFormatIndex(37), Integer32 (0..2147483647)
INTEGER: MULTI-ROW: The index in the prtInterpreterTable
in the Printer MIB [print-mib] of the page description
language (PDL) or control language interpreter that this
job requires/uses. A document or a job MAY use more than
one PDL or control language.
NOTE - As with all intensive attributes where multiple rows
are allowed, there SHALL be only one distinct row for each
distinct interpreter; there SHALL be no duplicates.
NOTE - This attribute type is intended to be used with an
agent that implements the Printer MIB and SHALL not be used
if the agent does not implement the Printer MIB. Such an
agent SHALL use the documentFormat attribute instead.
documentFormat(38), PrtInterpreterLangFamilyTC
AND/OR
OCTET STRING(SIZE(0..63))
INTEGER: MULTI-ROW: The interpreter language family
corresponding to the Printer MIB [print-mib]
prtInterpreterLangFamily object, that this job
requires/uses. A document or a job MAY use more than one
PDL or control language.
AND/OR
OCTETS: MULTI-ROW: The document format registered as a
media type [iana-media-types], i.e., the name of the MIME
content-type/subtype. Examples: 'application/postscript',
'application/vnd.hp-PCL', 'application/pdf', 'text/plain'
(US-ASCII SHALL be assumed), 'text/plain; charset=iso-8859-1',
and 'application/octet-stream'. The IPP 'document-format'
job attribute uses these same values with the same semantics.
See the IPP [ipp-model] 'mimeMediaType' attribute syntax and
the document-format attribute for further examples and
explanation.
+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
+ Job Parameter attributes (50 - 67 decimal)
+
+ The following attributes represent input parameters
+ supplied by the submitting client in the job submission
+ protocol.
+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
jobPriority(50), Integer32 (-2..100)
INTEGER: The priority for scheduling the job. It is used by
servers and devices that employ a priority-based scheduling
algorithm.
A higher value specifies a higher priority. The value 1 is
defined to indicate the lowest possible priority (a job which a
priority-based scheduling algorithm SHALL pass over in favor of
higher priority jobs). The value 100 is defined to indicate the
highest possible priority. Priority is expected to be evenly or
'normally' distributed across this range. The mapping of
vendor-defined priority over this range is implementation-
specific. -2 indicates unknown.
jobProcessAfterDateAndTime(51), DateAndTime (SNMPv2-TC)
OCTETS: The calendar date and time of day after which the job
SHALL become a candidate to be scheduled for processing. If the
value of this attribute is in the future, the server SHALL set
the value of the job's jmJobState object to pendingHeld and add
the jobProcessAfterSpecified bit value to the job's
jmJobStateReasons1 object. When the specified date and time
arrives, the server SHALL remove the jobProcessAfterSpecified
bit value from the job's jmJobStateReasons1 object and, if no
other reasons remain, SHALL change the job's jmJobState object
to pending.
jobHold(52), JmBooleanTC
INTEGER: If the value is 'true(4)', a client has explicitly
specified that the job is to be held until explicitly released.
Until the job is explicitly released by a client, the job SHALL
be in the pendingHeld state with the jobHoldSpecified value in
the jmJobStateReasons1 attribute.
jobHoldUntil(53), JmJobStringTC (SIZE(0..63))
OCTETS: The named time period during which the job SHALL become
a candidate for processing, such as 'evening', 'night', '
weekend', 'second-shift', 'third-shift', etc., (supported values
configured by the system administrator). See IPP [ipp-model]
for the standard keyword values. Until that time period
arrives, the job SHALL be in the pendingHeld state with the
jobHoldUntilSpecified value in the jmJobStateReasons1 object.
The value 'no-hold' SHALL indicate explicitly that no time
period has been specified; the absence of this attribute SHALL
indicate implicitly that no time period has been specified.
outputBin(54), Integer32 (0..2147483647)
AND/OR
JmJobStringTC (SIZE(0..63))
INTEGER: MULTI-ROW: The output subunit index in the Printer
MIB [print-mib]
AND/OR
OCTETS: MULTI-ROW: the name or number (represented as ASCII
digits) of the output bin to which all or part of the job is
placed in.
sides(55), Integer32 (-2..2)
INTEGER: MULTI-ROW: The number of sides, '1' or '2', that any
document in this job requires/used.
finishing(56), JmFinishingTC
INTEGER: MULTI-ROW: Type of finishing that any document in
this job requires/used.
+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
+ Image Quality attributes (requested and consumed) (70 - 87)
+
+ For devices that can vary the image quality.
+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
printQualityRequested(70), JmPrintQualityTC
INTEGER: MULTI-ROW: The print quality selection requested for
a document in the job for printers that allow quality
differentiation.
printQualityUsed(71), JmPrintQualityTC
INTEGER: MULTI-ROW: The print quality selection actually used
by a document in the job for printers that allow quality
differentiation.
printerResolutionRequested(72), JmPrinterResolutionTC
OCTETS: MULTI-ROW: The printer resolution requested for a
document in the job for printers that support resolution
selection.
printerResolutionUsed(73), JmPrinterResolutionTC
OCTETS: MULTI-ROW: The printer resolution actually used by a
document in the job for printers that support resolution
selection.
tonerEcomonyRequested(74), JmTonerEconomyTC
INTEGER: MULTI-ROW: The toner economy selection requested for
documents in the job for printers that allow toner economy
differentiation.
tonerEcomonyUsed(75), JmTonerEconomyTC
INTEGER: MULTI-ROW: The toner economy selection actually used
by documents in the job for printers that allow toner economy
differentiation.
tonerDensityRequested(76) Integer32 (-2..100)
INTEGER: MULTI-ROW: The toner density requested for a document
in this job for devices that can vary toner density levels.
Level 1 is the lowest density and level 100 is the highest
density level. Devices with a smaller range, SHALL map the
1-100 range evenly onto the implemented range.
tonerDensityUsed(77), Integer32 (-2..100)
INTEGER: MULTI-ROW: The toner density used by documents in
this job for devices that can vary toner density levels. Level
1 is the lowest density and level 100 is the highest density
level. Devices with a smaller range, SHALL map the 1-100 range
evenly onto the implemented range.
+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
+ Job Progress attributes (requested and consumed) (90-109)
+
+ Pairs of these attributes can be used by monitoring
+ applications to show an indication of relative progress
+ to users. See section 3.4, entitled:
+ 'Monitoring Job Progress'.
+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
jobCopiesRequested(90), Integer32 (-2..2147483647)
INTEGER: The number of copies of the entire job that are to be
produced.
jobCopiesCompleted(91), Integer32 (-2..2147483647)
INTEGER: The number of copies of the entire job that have been
completed so far.
documentCopiesRequested(92), Integer32 (-2..2147483647)
INTEGER: The total count of the number of document copies
requested for the job as a whole. If there are documents A, B,
and C, and document B is specified to produce 4 copies, the
number of document copies requested is 6 for the job.
This attribute SHALL be used only when a job has multiple
documents. The jobCopiesRequested attribute SHALL be used when
the job has only one document.
documentCopiesCompleted(93), Integer32 (-2..2147483647)
INTEGER: The total count of the number of document copies
completed so far for the job as a whole. If there are documents
A, B, and C, and document B is specified to produce 4 copies,
the number of document copies starts a 0 and runs up to 6 for
the job as the job processes.
This attribute SHALL be used only when a job has multiple
documents. The jobCopiesCompleted attribute SHALL be used when
the job has only one document.
jobKOctetsTransferred(94), Integer32 (-2..2147483647)
INTEGER: The number of K (1024) octets transferred to the
server or device to which the agent is providing access. This
count is independent of the number of copies of the job or
documents that will be produced, but it is only a measure of the
number of bytes transferred to the server or device.
The agent SHALL round the actual number of octets transferred up
to the next higher K. Thus 0 octets SHALL be represented as '
0', 1-1024 octets SHALL BE represented as '1', 1025-2048 SHALL
be '2', etc. When the job completes, the values of the
jmJobKOctetsPerCopyRequested object and the
jobKOctetsTransferred attribute SHALL be equal.
NOTE - The jobKOctetsTransferred can be used with the
jmJobKOctetsPerCopyRequested object in order to produce a
relative indication of the progress of the job for agents that
do not implement the jmJobKOctetsProcessed object.
sheetCompletedCopyNumber(95), Integer32 (-2..2147483647)
INTEGER: The number of the copy being stacked for the current
document. This number starts at 0, is set to 1 when the first
sheet of the first copy for each document is being stacked and
is equal to n where n is the nth sheet stacked in the current
document copy. See section 3.4 , entitled 'Monitoring Job
Progress'.
sheetCompletedDocumentNumber(96), Integer32 (-2..2147483647)
INTEGER: The ordinal number of the document in the job that is
currently being stacked. This number starts at 0, increments to
1 when the first sheet of the first document in the job is being
stacked, and is equal to n where n is the nth document in the
job, starting with 1.
Implementations that only support one document jobs SHOULD NOT
implement this attribute.
jobCollationType(97), JmJobCollationTypeTC
INTEGER: The type of job collation. See also Section 3.4,
entitled 'Monitoring Job Progress'.
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
+ Impression attributes (110 - 129 decimal)
+
+ See the definition of the terms 'impression', 'sheet',
+ and 'page' in Section 2.
+
+ See also jmJobImpressionsPerCopyRequested and
+ jmJobImpressionsCompleted objects in the jmJobTable.
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
impressionsSpooled(110), Integer32 (-2..2147483647)
INTEGER: The number of impressions spooled to the server or
device for the job so far.
impressionsSentToDevice(111), Integer32 (-2..2147483647)
INTEGER: The number of impressions sent to the device for the
job so far.
impressionsInterpreted(112), Integer32 (-2..2147483647)
INTEGER: The number of impressions interpreted for the job so
far.
impressionsCompletedCurrentCopy(113),
Integer32 (-2..2147483647)
INTEGER: The number of impressions completed by the device for
the current copy of the current document so far. For printing,
the impressions completed includes interpreting, marking, and
stacking the output. For other types of job services, the
number of impressions completed includes the number of
impressions processed.
This value SHALL be reset to 0 for each document in the job and
for each document copy.
fullColorImpressionsCompleted(114), Integer32 (-2..2147483647)
INTEGER: The number of full color impressions completed by the
device for this job so far. For printing, the impressions
completed includes interpreting, marking, and stacking the
output. For other types of job services, the number of
impressions completed includes the number of impressions
processed. Full color impressions are typically defined as those
requiring 3 or more colorants, but this MAY vary by
implementation. In any case, the value of this attribute counts
by 1 for each side that has full color, not by the number of
colors per side (and the other impression counters are
incremented, except highlightColorImpressionsCompleted(115)).
highlightColorImpressionsCompleted(115),
Integer32 (-2..2147483647)
INTEGER: The number of highlight color impressions
completed by the device for this job so far. For printing,
the impressions completed includes interpreting, marking,
and stacking the output. For other types of job services,
the number of impressions completed includes the number of
impressions processed. Highlight color impressions are
typically defined as those requiring black plus one other
colorant, but this MAY vary by implementation. In any
case, the value of this attribute counts by 1 for each side
that has highlight color (and the other impression counters
are incremented, except
fullColorImpressionsCompleted(114)).
+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
+ Page attributes (130 - 149 decimal)
+
+ See the definition of 'impression', 'sheet', and 'page'
+ in Section 2.
+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
pagesRequested(130), Integer32 (-2..2147483647)
INTEGER: The number of logical pages requested by the job
to be processed.
pagesCompleted(131), Integer32 (-2..2147483647)
INTEGER: The number of logical pages completed for this
job so far.
For implementations where multiple copies are produced by
the interpreter with only a single pass over the data, the
final value SHALL be equal to the value of the
pagesRequested object. For implementations where multiple
copies are produced by the interpreter by processing the
data for each copy, the final value SHALL be a multiple of
the value of the pagesRequested object.
NOTE - See the impressionsCompletedCurrentCopy and
pagesCompletedCurrentCopy attributes for attributes that
are reset on each document copy.
NOTE - The pagesCompleted object can be used with the
pagesRequested object to provide an indication of the
relative progress of the job, provided that the
multiplicative factor is taken into account for some
implementations of multiple copies.
pagesCompletedCurrentCopy(132), Integer32 (-2..2147483647)
INTEGER: The number of logical pages completed for the
current copy of the document so far. This value SHALL be
reset to 0 for each document in the job and for each
document copy.
+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
+ Sheet attributes (150 - 169 decimal)
+
+ See the definition of 'impression', 'sheet', and 'page'
+ in Section 2.
+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
sheetsRequested(150), Integer32 (-2..2147483647)
INTEGER: The total number of medium sheets requested to be
produced for this job.
Unlike the jmJobKOctetsPerCopyRequested and
jmJobImpressionsPerCopyRequested attributes, the
sheetsRequested(150) attribute SHALL include the
multiplicative factor contributed by the number of copies
and so is the total number of sheets to be produced by the
job, as opposed to the size of the document(s) submitted.
sheetsCompleted(151), Integer32 (-2..2147483647)
INTEGER: The total number of medium sheets that have
completed marking and stacking for the entire job so far
whether those sheets have been processed on one side or on
both.
sheetsCompletedCurrentCopy(152), Integer32 (-2..2147483647)
INTEGER: The number of medium sheets that have completed
marking and stacking for the current copy of a document in
the job so far whether those sheets have been processed on
one side or on both.
The value of this attribute SHALL be 0 before the job
starts processing and SHALL be reset to 1 after the first
sheet of each document and document copy in the job is
processed and stacked.
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
+ Resources attributes (requested and consumed) (170 - 189)
+
+ Pairs of these attributes can be used by monitoring
+ applications to show an indication of relative usage to
+ users, i.e., a 'thermometer'.
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
mediumRequested(170), JmMediumTypeTC
AND/OR
JmJobStringTC (SIZE(0..63))
INTEGER: MULTI-ROW: The type
AND/OR
OCTETS: MULTI-ROW: the name of the medium that is
required by the job.
NOTE - The name (JmJobStringTC) values correspond to the
name values of the prtInputMediaName object in the Printer
MIB [print-mib] and the name, size, and input tray values
of the IPP 'media' attribute [ipp-model].
mediumConsumed(171), Integer32 (-2..2147483647)
AND
JmJobStringTC (SIZE(0..63))
INTEGER: MULTI-ROW: The number of sheets
AND
OCTETS: MULTI-ROW: the name of the medium that has been
consumed so far whether those sheets have been processed on
one side or on both.
This attribute SHALL have both Integer32 and OCTET STRING
(represented as JmJobStringTC) values.
NOTE - The name (JmJobStringTC) values correspond to the
name values of the prtInputMediaName object in the Printer
MIB [print-mib] and the name, size, and input tray values
of the IPP 'media' attribute [ipp-model].
colorantRequested(172), Integer32 (-2..2147483647)
AND/OR
JmJobStringTC (SIZE(0..63))
INTEGER: MULTI-ROW: The index (prtMarkerColorantIndex) in
the Printer MIB [print-mib]
AND/OR
OCTETS: MULTI-ROW: the name of the colorant requested.
NOTE - The name (JmJobStringTC) values correspond to the
name values of the prtMarkerColorantValue object in the
Printer MIB. Examples are: red, blue.
colorantConsumed(173), Integer32 (-2..2147483647)
AND/OR
JmJobStringTC (SIZE(0..63))
INTEGER: MULTI-ROW: The index (prtMarkerColorantIndex) in
the Printer MIB [print-mib]
AND/OR
OCTETS: MULTI-ROW: the name of the colorant consumed.
NOTE - The name (JmJobStringTC) values correspond to the
name values of the prtMarkerColorantValue object in the
Printer MIB. Examples are: red, blue
mediumTypeConsumed(174), Integer32 (-2..2147483647)
AND
JmJobStringTC (SIZE(0..63))
INTEGER: MULTI-ROW: The number of sheets of the indicated
medium type that has been consumed so far whether those
sheets have been processed on one side or on both
AND
OCTETS: MULTI-ROW: the name of that medium type.
This attribute SHALL have both Integer32 and OCTET STRING
(represented as JmJobStringTC) values.
NOTE - The type name (JmJobStringTC) values correspond to
the type name values of the prtInputMediaType object in the
Printer MIB [print-mib]. Values are: 'stationery',
'transparency', 'envelope', etc. These medium type names
correspond to the enum values of JmMediumTypeTC used in the
mediumRequested attribute.
mediumSizeConsumed(175), Integer32 (-2..2147483647)
AND
JmJobStringTC (SIZE(0..63))
INTEGER: MULTI-ROW: The number of sheets of the indicated
medium size that has been consumed so far whether those
sheets have been processed on one side or on both
AND
OCTETS: MULTI-ROW: the name of that medium size.
This attribute SHALL have both Integer32 and OCTET STRING
(represented as JmJobStringTC) values.
NOTE - The size name (JmJobStringTC) values correspond to
the size name values in the Printer MIB [print-mib]
Appendix B. These size name values are also a subset of
the keyword values defined by [ipp-model] for the 'media'
Job Template attribute. Values are: 'letter', 'a', 'iso-
a4', 'jis-b4', etc.
+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
+ Time attributes (set by server or device) (190 - 209 decimal)
+
+ This section of attributes are ones that are set by the
+ server or device that accepts jobs. Two forms of time are
+ provided. Each form is represented in a separate attribute.
+ See section 3.1.2 and section 3.1.3 for the
+ conformance requirements for time attribute for agents and
+ monitoring applications, respectively. The two forms are:
+
+ 'DateAndTime' is an 8 or 11 octet binary encoded year,
+ month, day, hour, minute, second, deci-second with
+ optional offset from UTC. See SNMPv2-TC [SMIv2-TC].
+
+ NOTE: 'DateAndTime' is not printable characters; it is
+ binary.
+
+ 'JmTimeStampTC' is the time of day measured in the number of
+ seconds since the system was booted.
+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
jobSubmissionToServerTime(190), JmTimeStampTC
AND/OR
DateAndTime
INTEGER: Configuration 3 only: The time
AND/OR
OCTETS: the date and time that the job was submitted to
the server (as distinguished from the device which uses
jobSubmissionTime).
jobSubmissionTime(191), JmTimeStampTC
AND/OR
DateAndTime
INTEGER: Configurations 1, 2, and 3: The time
AND/OR
OCTETS: the date and time that the job was submitted to
the server or device to which the agent is providing
access.
jobStartedBeingHeldTime(192), JmTimeStampTC
AND/OR
DateAndTime
INTEGER: The time
AND/OR
OCTETS: the date and time that the job last entered the
pendingHeld state. If the job has never entered the
pendingHeld state, then the value SHALL be '0' or the
attribute SHALL not be present in the table.
jobStartedProcessingTime(193), JmTimeStampTC
AND/OR
DateAndTime
INTEGER: The time
AND/OR
OCTETS: the date and time that the job started processing.
jobCompletionTime(194), JmTimeStampTC
AND/OR
DateAndTime
INTEGER: The time
AND/OR
OCTETS: the date and time that the job entered the
completed, canceled, or aborted state.
jobProcessingCPUTime(195) Integer32 (-2..2147483647)
UNITS 'seconds'
INTEGER: The amount of CPU time in seconds that the job
has been in the processing state. If the job enters the
processingStopped state, that elapsed time SHALL not be
included. In other words, the jobProcessingCPUTime value
SHOULD be relatively repeatable when the same job is
processed again on the same device.
3.3.9 Job State Reason bit definitions
The JmJobStateReasonsNTC (N=1..4) textual-conventions are used with
the jmJobStateReasons1 object and jobStateReasonsN (N=2..4),
respectively, to provide additional information regarding the current
jmJobState object value. These values MAY be used with any job state
or states for which the reason makes sense.
NOTE - While values cannot be added to the jmJobState object without
impacting deployed clients that take actions upon receiving
jmJobState values, it is the intent that additional
JmJobStateReasonsNTC enums can be defined and registered without
impacting such deployed clients. In other words, the
jmJobStateReasons1 object and jobStateReasonsN attributes are
intended to be extensible.
NOTE - The Job Monitoring MIB contains a superset of the IPP values
[ipp-model] for the IPP 'job-state-reasons' attribute, since the Job
Monitoring MIB is intended to cover other job submission protocols as
well. Also some of the names of the reasons have been changed from '
printer' to 'device', since the Job Monitoring MIB is intended to
cover additional types of devices, including input devices, such as
scanners.
3.3.9.1 JmJobStateReasons1TC specification
The following standard values are defined (in hexadecimal) as powers
of two, since multiple values MAY be used at the same time. For ease
of understanding, the JmJobStateReasons1TC reasons are presented in
the order in which the reasons are likely to occur (if implemented),
starting with the 'jobIncoming' value and ending with the '
jobCompletedWithErrors' value.
other 0x1
The job state reason is not one of the standardized or
registered reasons.
unknown 0x2
The job state reason is not known to the agent or is
indeterminent.
jobIncoming 0x4
The job has been accepted by the server or device, but the
server or device is expecting (1) additional operations from the
client to finish creating the job and/or (2) is
accessing/accepting document data.
submissionInterrupted 0x8
The job was not completely submitted for some unforeseen reason,
such as: (1) the server has crashed before the job was closed by
the client, (2) the server or the document transfer method has
crashed in some non-recoverable way before the document data was
entirely transferred to the server, (3) the client crashed or
failed to close the job before the time-out period.
jobOutgoing 0x10
Configuration 2 only: The server is transmitting the job to the
device.
jobHoldSpecified 0x20
The value of the job's jobHold(52) attribute is TRUE. The job
SHALL NOT be a candidate for processing until this reason is
removed and there are no other reasons to hold the job.
jobHoldUntilSpecified 0x40
The value of the job's jobHoldUntil(53) attribute specifies a
time period that is still in the future. The job SHALL NOT be a
candidate for processing until this reason is removed and there
are no other reasons to hold the job.
jobProcessAfterSpecified 0x80
The value of the job's jobProcessAfterDateAndTime(51) attribute
specifies a time that is still in the future. The job SHALL NOT
be a candidate for processing until this reason is removed and
there are no other reasons to hold the job.
resourcesAreNotReady 0x100
At least one of the resources needed by the job, such as media,
fonts, resource objects, etc., is not ready on any of the
physical devices for which the job is a candidate. This
condition MAY be detected when the job is accepted, or
subsequently while the job is pending or processing, depending
on implementation.
deviceStoppedPartly 0x200
One or more, but not all, of the devices to which the job is
assigned are stopped. If all of the devices are stopped (or the
only device is stopped), the deviceStopped reason SHALL be used.
deviceStopped 0x400
The device(s) to which the job is assigned is (are all) stopped.
jobInterpreting 0x800
The device to which the job is assigned is interpreting the
document data.
jobPrinting 0x1000
The output device to which the job is assigned is marking media.
This value is useful for servers and output devices which spend
a great deal of time processing (1) when no marking is happening
and then want to show that marking is now happening or (2) when
the job is in the process of being canceled or aborted while the
job remains in the processing state, but the marking has not yet
stopped so that impression or sheet counts are still increasing
for the job.
jobCanceledByUser 0x2000
The job was canceled by the owner of the job, i.e., by a user
whose name is the same as the value of the job's jmJobOwner
object, or by some other authorized end-user, such as a member
of the job owner's security group.
jobCanceledByOperator 0x4000
The job was canceled by the operator, i.e., by a user who has
been authenticated as having operator privileges (whether local
or remote).
jobCanceledAtDevice 0x8000
The job was canceled by an unidentified local user, i.e., a user
at a console at the device.
abortedBySystem 0x10000
The job (1) is in the process of being aborted, (2) has been
aborted by the system and placed in the 'aborted' state, or (3)
has been aborted by the system and placed in the 'pendingHeld'
state, so that a user or operator can manually try the job
again.
processingToStopPoint 0x20000
The requester has issued an operation to cancel or interrupt the
job or the server/device has aborted the job, but the
server/device is still performing some actions on the job until
a specified stop point occurs or job termination/cleanup is
completed.
This reason is recommended to be used in conjunction with the
processing job state to indicate that the server/device is still
performing some actions on the job while the job remains in the
processing state. After all the job's resources consumed
counters have stopped incrementing, the server/device moves the
job from the processing state to the canceled or aborted job
states.
serviceOffLine 0x40000
The service or document transform is off-line and accepting no
jobs. All pending jobs are put into the pendingHeld state.
This situation could be true if the service's or document
transform's input is impaired or broken.
jobCompletedSuccessfully 0x80000
The job completed successfully.
jobCompletedWithWarnings 0x100000
The job completed with warnings.
jobCompletedWithErrors 0x200000
The job completed with errors (and possibly warnings too).
The following additional job state reasons have been added to
represent job states that are in ISO DPA [iso-dpa] and other job
submission protocols:
jobPaused 0x400000
The job has been indefinitely suspended by a client issuing an
operation to suspend the job so that other jobs may proceed
using the same devices. The client MAY issue an operation to
resume the paused job at any time, in which case the agent SHALL
remove the jobPaused values from the job's jmJobStateReasons1
object and the job is eventually resumed at or near the point
where the job was paused.
jobInterrupted 0x800000 The job has been
interrupted while processing by a client
issuing an operation that specifies another job to be run
instead of the current job. The server or device will
automatically resume the interrupted job when the interrupting
job completes.
jobRetained 0x1000000
The job is being retained by the server or device with all of
the job's document data (and submitted resources, such as fonts,
logos, and forms, if any). Thus a client could issue an
operation to the server or device to either (1) re-do the job
(or a copy of the job) on the same server or device or (2)
resubmit the job to another server or device. When a client
could no longer re-do/resubmit the job, such as after the
document data has been discarded, the agent SHALL remove the
jobRetained value from the jmJobStateReasons1 object.
These bit definitions are the equivalent of a type 2 enum except
that combinations of bits may be used together. See section
3.7.1.2. The remaining bits are reserved for future
standardization and/or registration.
3.3.9.2 JmJobStateReasons2TC specification
The following standard values are defined (in hexadecimal) as powers
of two, since multiple values MAY be used at the same time.
cascaded 0x1
An outbound gateway has transmitted all of the job's job and
document attributes and data to another spooling system.
deletedByAdministrator 0x2
The administrator has deleted the job.
discardTimeArrived 0x4
The job has been deleted due to the fact that the time specified
by the job's job-discard-time attribute has arrived.
postProcessingFailed 0x8
The post-processing agent failed while trying to log accounting
attributes for the job; therefore the job has been placed into
the completed state with the jobRetained jmJobStateReasons1
object value for a system-defined period of time, so the
administrator can examine it, resubmit it, etc.
jobTransforming 0x10
The server/device is interpreting document data and producing
another electronic representation.
maxJobFaultCountExceeded 0x20
The job has faulted several times and has exceeded the
administratively defined fault count limit.
devicesNeedAttentionTimeOut 0x40
One or more document transforms that the job is using needs
human intervention in order for the job to make progress, but
the human intervention did not occur within the site-settable
time-out value.
needsKeyOperatorTimeOut 0x80
One or more devices or document transforms that the job is using
need a specially trained operator (who may need a key to unlock
the device and gain access) in order for the job to make
progress, but the key operator intervention did not occur within
the site-settable time-out value.
jobStartWaitTimeOut 0x100
The server/device has stopped the job at the beginning of
processing to await human action, such as installing a special
cartridge or special non-standard media, but the job was not
resumed within the site-settable time-out value and the
server/device has transitioned the job to the pendingHeld state.
jobEndWaitTimeOut 0x200
The server/device has stopped the job at the end of processing
to await human action, such as removing a special cartridge or
restoring standard media, but the job was not resumed within the
site-settable time-out value and the server/device has
transitioned the job to the completed state.
jobPasswordWaitTimeOut 0x400
The server/device has stopped the job at the beginning of
processing to await input of the job's password, but the
password was not received within the site-settable time-out
value.
deviceTimedOut 0x800
A device that the job was using has not responded in a period
specified by the device's site-settable attribute.
connectingToDeviceTimeOut 0x1000
The server is attempting to connect to one or more devices which
may be dial-up, polled, or queued, and so may be busy with
traffic from other systems, but server was unable to connect to
the device within the site-settable time-out value.
transferring 0x2000
The job is being transferred to a down stream server or
downstream device.
queuedInDevice 0x4000
The server/device has queued the job in a down stream server or
downstream device.
jobQueued 0x8000
The server/device has queued the document data.
jobCleanup 0x10000
The server/device is performing cleanup activity as part of
ending normal processing.
jobPasswordWait 0x20000
The server/device has selected the job to be next to process,
but instead of assigning resources and starting the job
processing, the server/device has transitioned the job to the
pendingHeld state to await entry of a password (and dispatched
another job, if there is one).
validating 0x40000
The server/device is validating the job after accepting the job.
queueHeld 0x80000
The operator has held the entire job set or queue.
jobProofWait 0x100000
The job has produced a single proof copy and is in the
pendingHeld state waiting for the requester to issue an
operation to release the job to print normally, obeying any job
and document copy attributes that were originally submitted.
heldForDiagnostics 0x200000
The system is running intrusive diagnostics, so that all jobs
are being held.
noSpaceOnServer 0x800000
There is no room on the server to store all of the job.
pinRequired 0x1000000