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