Job-Monitoring-MIB DEFINITIONS ::= BEGIN IMPORTS MODULE-IDENTITY, OBJECT-TYPE, experimental, 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: -- DateAndTime FROM SNMPv2-TC -- PrtAlertCodeTC, PrtInterpreterLangFamilyTC FROM Printer-MIB -- Use the experimental (54) OID assigned to the Printer MIB[1] before -- it was published as RFC 1759. -- Upon publication of the Job Monitoring MIB as an RFC, delete this -- comment and the line following this comment and change the -- reference of { temp 104 } (below) to { mib-2 X }. -- This will result in changing: -- 1 3 6 1 3 54 jobmonMIB(105) to: -- 1 3 6 1 2 1 jobmonMIB(X) -- This will make it easier to translate prototypes to -- the standard namespace because the lengths of the OIDs won't -- change. temp OBJECT IDENTIFIER ::= { experimental 54 } jobmonMIB MODULE-IDENTITY LAST-UPDATED "9705200000Z" ORGANIZATION "IETF Printer MIB Working Group" 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" DESCRIPTION "The MIB module for monitoring job in servers, printers, and other devices. File: jmp-mib.doc, .pdf, .txt, .mib Version: 0.82" ::= { temp 105 } -- Textual conventions for this MIB module 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[5].) 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 (see page 83). The TimeStamp textual-convention defined in SMNPv2-TC is defined as an APPLICATION 3 IMPLICIT INTEGER tag, not an Integer32, 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." -- This is a type 2 enumeration. See Section 7.1 on page 22. SYNTAX INTEGER { other(1), unknown(2), sptUNIX(3), -- UNIX(tm) sptOS2(4), -- OS/2 sptPCDOS(5), -- DOS sptNT(6), -- NT sptMVS(7), -- MVS sptVM(8), -- VM sptOS400(9), -- OS/400 sptVMS(10), -- VMS sptWindows95(11), -- Windows95 sptNetWare(33) -- NetWare } JmFinishingTC ::= TEXTUAL-CONVENTION STATUS current DESCRIPTION "The type of finishing." -- This is a type 2 enumeration. See Section 7.1 on page 22. SYNTAX INTEGER { other(1), -- Some other finishing 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. stapleTopLeft(5), -- Place one or more staples on the top left corner of -- the document(s). stapleBottomLeft(6), -- Place one or more staples on the bottom left corner -- of the document(s). stapleTopRight(7), -- Place one or more staples on the top right corner of -- the document(s). stapleBottomRight(8), -- Place one or more staples on the bottom right corner -- of the document(s). saddleStitch(9), -- Bind the document(s) with one or more staples (wire -- stitches) along the middle fold. The exact number -- and placement of the stitches is site-defined. edgeStitch(10), -- Bind the document(s) with one or more staples (wire -- stitches) along one edge. The exact number and -- placement of the staples is site-defined. punch(11), -- 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(12), -- 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(13) -- This value indicates that a binding is to be applied -- to the document; the type and placement of the -- binding is site-defined. } JmPrintQualityTC ::= TEXTUAL-CONVENTION STATUS current DESCRIPTION "Print quality settings." -- This is a type 2 enumeration. See Section 7.1 on page 22. 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. The values are type2 enums that represent single integers or pairs of integers. The latter are to specify the resolution when the x and y dimensions differ. When two integers are specified, the first is in the x direction, i.e., in the direction of the shortest dimension of the medium, so that the value is independent of whether the printer feeds long edge or short edge first." -- This is a type 2 enumeration. See Section 7.1 on page 22. SYNTAX INTEGER { other(1), -- Not one of the specified or registered -- values. unknown(2), -- The actual value is unknown. normal(3), -- Normal resolution. res100(4), -- 100 x 100 dpi res200(5), -- 200 x 200 dpi res240(6), -- 240 x 240 dpi res300(7), -- 300 x 300 dpi res360(8), -- 360 x 360 dpi res600(9), -- 600 x 600 dpi res720(10), -- 720 x 720 dpi res800(11), -- 800 x 800 dpi res1200(12), -- 1200 x 1200 dpi res1440(13), -- 1440 x 1440 dpi res1800(14), -- 1800 x 1800 dpi res100x200(15), -- 100 x 200 dpi res300x600(16), -- 300 x 600 dpi res600x300(17), -- 600 x 300 dpi res360x720(18), -- 360 x 720 dpi res720x360(19), -- 720 x 360 dpi res400x800(20), -- 400 x 800 dpi res800x400(21), -- 800 x 400 dpi res600x1200(22), -- 600 x 1200 dpi res1200x600(23), -- 1200 x 600 dpi res720x1440(24), -- 720 x 1440 dpi res1440x720(25), -- 1440 x 720 dpi res1800x600(26) -- 1800 x 600 dpi } JmTonerEconomyTC ::= TEXTUAL-CONVENTION STATUS current DESCRIPTION "Toner economy settings." -- This is a type 2 enumeration. See Section 7.1 on page 22. SYNTAX INTEGER { off(0), -- Off. Normal. Use full toner. on(1) -- On. Use less toner than normal. } JmMediumTypeTC ::= TEXTUAL-CONVENTION STATUS current DESCRIPTION "Identifies the type of medium." -- This is a type 2 enumeration. See Section 7.1 on page 22. SYNTAX INTEGER { 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. } 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, processing, and processingStopped states. Jobs in the pending, processing, and processingStopped states are called 'active', while jobs in the pendingHeld, canceled, aborted, and completed are called 'in-active'." -- This is a type 2 enumeration. See Section 7.1 on page 22. SYNTAX INTEGER { other(1), -- The job state is not one of the defined states. 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 -- on page (59) for the specification of each reason. processing(5), -- Either: -- -- 1. The job is using, or is attempting to use, one -- or more document transforms which include (1) -- purely software processes that are interpreting a -- PDL, and (2) hardware devices that are -- interpreting a PDL, making marks on a medium, -- and/or performing finishing, such as stapling, -- etc. -- -- OR -- -- 2. (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. 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 indicate its condition in human -- readable form locally 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 job is -- either: (1) in the process of being terminated by -- the server or device or (2) has completed -- terminating. The job's jmJobStateReasons1 object -- SHOULD contain either the canceledByUser or -- canceledByOperator value. aborted(8), -- The job has been aborted by the system, usually -- while the job was in the processing or -- processingStopped 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). The job's -- jmJobStateReasons1 object SHOULD contain one of: -- completedSuccessfully, completedWithWarnings, or -- completedWithErrors values. } JmAttributeTypeTC ::= TEXTUAL-CONVENTION STATUS current DESCRIPTION "The type of the attribute which identifies the attribute. Some attributes represent information about a job, such as a file-name, or a document-name, or submission-time or completion time. Other attributes represent resources required, e.g., a medium or a colorant, etc. to process the job before the job start processing OR to indicate the amount of the resource that is being consumed while the job is processing, e.g., pages completed or impressions completed. If both a required and a consumed value of a resource is needed, this specification assigns two separate attribute enums in the textual convention. Most attributes apply to all three configurations covered by this MIB specification (see section 3 on page 14). Those attribute that apply to a particular configuration are indicated as 'Configuration n:'. Conformance of Attribute Implementation A very few attributes are MANDATORY for conformance, and the rest are OPTIONAL. An agent SHALL instrument any MANDATORY attribute. If the server or device does not provide access to the information about the MANDATORY attribute, the agent SHALL return the 'unknown' value. For attributes represented by a counting integer, the unknown value is (-2) and for attributes represented by an enum, the unknown value is (2), as in the Printer MIB[1]. For attributes represented by an OCTET STRING, the unknown value is a zero-length string, unless specified otherwise. The MANDATORY attributes are: jobOwner(20) The attributes not labeled as MANDATORY are OPTIONAL. An agent MAY, but NEED NOT, implement any OPTIONAL attributes. NOTE - The table of contents lists all the attributes in order to help see the order of enum assignments which is the order that the GetNext operation can be used to get attributes. The table of contents also indicates the MANDATORY attributes as: (MANDATORY). 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. Datatypes and Attribute Naming Conventions The datatype of each attribute is indicated on the first line(s) of the description. Some attributes have several different data type representations. When the data types can be represented in a single row in the jmAttributeTable, the data type name is not included as the last part of the name of the attribute. When the data types cannot be represented by a single row in the jmAttributeTable, each such representation is considered a separate attribute and is assigned a separate name and enum value. For these attributes, the name of the datatype is the last part of the name of the attribute: Name, Index, DateAndTime, TimeStamp, etc. NOTE: No attribute name exceeds 31 characters. Single-Value (Row) Versus Multi-Value (MULTI-ROW) Attributes Most attributes SHALL have only one row per job. However, a few attributes can have multiple values per job or even per document, where each value is a separate row in the jmAttributeTable. Unless indicated with 'MULTI-ROW:' in JmAttributeTypeTC, an agent SHALL ensure that each attribute item occurs only once in the jmAttributeTable for a job. Attributes that are permitted to appear multiple times in the jmAttributeTable for a job are indicated with 'MULTI-ROW:' in their specification in the JmAttributeTypeTC. However, such 'MULTI-ROW' attribute items SHALL not contain duplicates for 'intensive' (as opposed to 'extensive') attributes. For example, a job or document(s) may use multiple PDLs. However, each distinct documentFormat attribute value SHALL appear in the jmAttributeTable only once for a job since the interpreter language is an intensive attribute item, even though the job has a number of documents that all use the same PDL. As another example of an intensive attribute that can have multiple entries, if a document or job uses multiple types of media, there SHALL be only one row in the jmAttributeTable for each media type, not one row for each document that uses that medium type. On the other hand, if a job contains two documents of the same name, there can be separate rows for the documentName attribute item with the same name, since a document name is an extensive attribute item. The specification indicates that the values NEED NOT be unique for such 'MULTI-ROW: attributes' Value Represented As Integer Or Octets In the following definitions of the enums, each description indicates whether the 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 a choice of either an integer and/or an octets representation, 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 values (see mediumConsumed(171)). These attributes are indicated with 'INTEGER:' and/or 'OCTETS:' tags. See the jmAttributeGroup starting on page 81 for the descriptions of these objects. Consumption Attributes A number of attributes record consumption. Such attribute names end with the word 'Completed' or 'Consumed'. If the job has not yet consumed what that resource is metering, the agent either: (1) SHALL return the value 0 or (2) SHALL not add this attribute to the jmAttributeTable until the consumption begins. In the interests of brevity, the semantics for 0 is specified once here and is not repeated for each xxxxYyyyCompleted and xxxxYyyyConsumed attribute specification. Index Value Attributes A number of attributes are indexes in other tables. Such attribute names end with the word 'Index'. If the agent does not (yet) know the index value for a particular index attribute for a job, the agent either: (1) SHALL return the value 0 or (2) SHALL not add this attribute to the jmAttributeTable until the index value is known. In the interests of brevity, the semantics for 0 is specified once here and is not repeated for each index attribute specification. The standard attribute types defined so far are:" -- This is a type 2 enumeration. See Section 7.1 on page 22. SYNTAX INTEGER { -- jmAttributeTypeIndex Datatype -- Description - including 'OCTETS:' or 'INTEGER:' to -- specify whether the value SHALL be represented in the -- jmAttributeValueAsOctets or the jmAttributeValueAsInteger -- object, or both, respectively. 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 IANA. unknown(2), -- Integer32(-2..2147483647) -- OR -- OCTET STRING(SIZE(0..63)) -- INTEGER: or OCTETS: An attribute whose semantics are -- not known to the agent. -- +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ -- Job State attributes -- -- The following attributes specify the state of a job. -- +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ jobStateReasons2(3), -- JmJobStateReasons2TC (pg 62) -- INTEGER: Additional information about the job's current -- state that augments the jmJobState object. See the -- description under the JmJobStateReasons1TC textual- -- convention on page 59. jobStateReasons3(4), -- JmJobStateReasons3TC (pg 66) -- INTEGER: Additional information about the job's current -- state that augments the jmJobState object. See the -- description under JmJobStateReasons1TC textual-convention -- on page 59. jobStateReasons4(5), -- JmJobStateReasons4TC (pg 67) -- INTEGER: Additional information about the job's current -- state that augments the jmJobState object. See the -- description under JmJobStateReasons1TC textual-convention -- on page 59. deviceAlertCode(6), -- PrtAlertCodeTC (Printer-MIB) -- INTEGER: The device alert code when the job is stopped -- because the device needs attention, i.e., needs human -- intervention. When the device is a printer, this device -- alert code SHALL be the printer alert code defined by the -- Printer MIB[1] using the PrtAlertCodeTC textual -- convention or equivalent. processingMessage(7), -- OCTET STRING(SIZE(0..63)) -- OCTETS: MULTI-ROW: A coded character set message that -- is generated during the processing of the job as a simple -- form of processing log to show progress and any problems. -- -- There is no restriction on the same message in multiple -- rows. -- +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ -- Job Identification attributes -- -- The following attributes help an end user, a system -- operator, or an accounting program identify a job. -- +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ jobOwner(20), -- OCTET STRING(SIZE(0..63)) -- (MANDATORY) -- OCTETS: 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 authenticated name of the user -- submitting the job. -- -- In order to assist users to find their jobs for job -- submission protocols that don't supply a -- jmJobSubmissionID, the agent SHOULD maintain the jobOwner -- attribute for the time specified by the -- jmGeneralJobPersistence object, rather than the (shorter) -- jmGeneralAttributePersistence object. 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. -- -- NOTE: This attribute NEED NOT be printable characters. serverAssignedJobName(22), -- OCTET STRING(SIZE(0..63)) -- OCTETS: Configuration 3 only: The human readable string -- name of the job as assigned by the server that submitted -- the job to the device that the agent in instrumenting -- with this MIB. -- -- NOTE - This attribute is intended for enabling a user to -- find his/her job that a server submitted to a device -- after the user submitted the job to the server when the -- jmJobSubmissionID is not supported by the job submission -- protocol. jobName(23), -- OCTET STRING(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 (pg 57) -- 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. That is why this attribute -- is in the job identification category. jobSourceChannelIndex(25), -- Integer32(0..2147483647) -- INTEGER: The index of the row in the associated Printer -- MIB[1] of the channel which is the source of the print -- job. -- -- NOTE - the Job Monitoring MIB points to the Channel row -- in the Printer MIB[1], so there is no need for a port -- attribute in the Job Monitoring MIB, since the PWG is -- adding a prtChannelInformation object to the Channel -- table of the draft Printer MIB. jobSourcePlatformType(26), -- JmJobSourcePlatformTypeTC -- (pg 27) -- 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) that -- the agent is instrumenting. 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), -- OCTET STRING(SIZE(0..63)) -- OCTETS: For configuration 3 only: The administrative -- name of the server that submitted the job to the device. submittingApplicationName(28), -- OCTET STRING(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), -- OCTET STRING(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), -- OCTET STRING(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[1]: prtGeneralPrinterName object (added to -- the draft Printer MIB) for printers. 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), -- OCTET STRING(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 that the agent is instrumenting. 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 (see HR MIB) -- AND/OR -- OCTET STRING(SIZE(0..63)) -- INTEGER: MULTI-ROW: The index of the physical device -- MIB instance requested/used, such as the Printer MIB[1]. -- This value is an hrDeviceIndex value. See the Host -- Resources MIB[6]. -- AND/OR -- OCTETS: MULTI-ROW: The name of the physical device to -- which the job is assigned. numberOfDocuments(33), -- Integer32(0..2147483647) -- INTEGER: The number of documents in this job. If this -- attribute is not present, the number of documents SHALL -- be 1. fileName(34), -- OCTET STRING(SIZE(0..63)) -- OCTETS: MULTI-ROW: The coded character set file name of -- the document. -- -- There is no restriction on the same file name in multiple -- rows. documentName(35), -- OCTET STRING(SIZE(0..63)) -- OCTETS: MULTI-ROW: The coded character set name of the -- document. -- -- There is no restriction on the same document name in -- multiple rows. jobComment(36), -- OCTET STRING(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[1] 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 attribute items 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[1] -- prtInterpreterLangFamily object, that this job -- requires/uses. A document or a job MAY use more than one -- PDL or control language. -- -- NOTE - This attribute is represented by a type 2 enum -- defined in the draft Printer MIB[1], but is not in RFC -- 1759. -- -- AND/OR -- -- OCTETS: MULTI-ROW: The document format registered as a -- MIME type, i.e., the name of the MIME type. -- -- NOTE - IPP[3] uses MIME type keywords to identify -- document formats. -- +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ -- Job Parameter attributes -- -- The following attributes represent input parameters -- supplied by the submitting client in the job submission -- protocol. -- +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ jobPriority(50), -- Integer32(1..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. jobProcessAfterDateAndTime(51), -- DateAndTime (SNMPv2-TC) -- INTEGER: 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 and SHALL not schedule the job -- for processing until the specified date and time has -- passed. 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 so that the job becomes a candidate for -- being scheduled on devices(s). -- -- The agent SHALL assign an empty value to the -- jobProcessAfterDateAndTime attribute when no process -- after time has been specified, so that the job SHALL be a -- candidate for processing immediately. -- jobHold(52), -- Integer32(0..1) -- INTEGER: If the value is 1, 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), -- OCTET STRING(SIZE(0..63)) -- OCTETS: The named time period during which the job SHALL -- become a candidate for processing, such as 'no-hold', -- 'evening', 'night', 'weekend', 'second-shift', 'third- -- shift', etc., as defined by the system administrator. -- Until that time period arrives, the job SHALL be in the -- pendingHeld state with the jobHoldUntilSpecified value in -- the jmJobStateReasons1 object. outputBin(54), -- Integer32(0..2147483647) -- AND/OR -- OCTET STRING(SIZE(0..63)) -- INTEGER: MULTI-ROW: The output subunit index in the -- Printer MIB[1] -- AND/OR -- OCTETS: the name of the output bin to which all or part -- of the job is placed in. sides(55), -- Integer32(-2..1) -- INTEGER: MULTI-ROW: The number of sides that any -- document in this job requires/used. finishing(56), -- JmFinishingTC (pg 28) -- 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 (pg 29) -- INTEGER: MULTI-ROW: The print quality selection -- requested for document in the job for printers that allow -- quality differentiation. printQualityUsed(71), -- JmPrintQualityTC (pg 29) -- INTEGER: MULTI-ROW: The print quality selection -- actually used by documents in the job for printers that -- allow quality differentiation. printerResolutionRequested(72), -- JmPrinterResolutionTC -- (pg 30) -- INTEGER: MULTI-ROW: The print quality selection -- requested for document in the job for printers that allow -- quality differentiation. printerResolutionUsed(73), -- JmPrinterResolutionTC -- (pg 30) -- INTEGER: MULTI-ROW: The print quality selection -- actually used by documents in the job for printers that -- allow quality differentiation. tonerEcomonyRequested(74), -- JmTonerEconomyTC (pg 31) -- INTEGER: MULTI-ROW: The print quality selection -- requested for documents in the job for printers that -- allow toner quality differentiation. tonerEcomonyUsed(75), -- JmTonerEconomyTC (pg 31) -- INTEGER: MULTI-ROW: The print quality selection -- actually used by documents in the job for printers that -- allow toner quality differentiation. tonerDensityRequested(76), -- Integer32(1..20) -- INTEGER: MULTI-ROW: The toner density requested for -- documents in this job for devices that can vary toner -- density levels. Level 1 is the lowest density and level -- 20 is the highest density level. Devices with a smaller -- range, SHALL map the 1-20 range evenly onto the -- implemented range. tonerDensityUsed(77), -- Integer32(1..20) -- 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 20 is -- the highest density level. Devices with a smaller range, -- SHALL map the 1-20 range evenly onto the implemented -- range. -- +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ -- Job Progress attributes (requested and consumed) -- -- Pairs of these attributes can be used by monitoring -- applications to show 'thermometers' of progress to users. -- +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 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. 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 that the agent is instrumenting. -- This count is independent of the number of copies of the -- job or documents that will be produced, but is just 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 jmJobKOctetsRequested object and the -- jobKOctetsTransferred attribute SHALL be equal. -- -- NOTE - The jobKOctetsTransferred can be used in the -- numerator with the jmJobKOctetsRequested object in the -- denominator in order to produce a "thermometer" that -- indicates the progress of the job for agents that do not -- implement the jmJobKOctetsProcessed object. -- +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ -- Impression attributes -- -- For a print job, an impression is the marking of the -- entire side of a sheet. Two-sided processing involves two -- impressions per sheet. Two-up is the placement of two -- logical pages on one side of a sheet and so is still a -- single impression. See also jmJobImpressionsRequested and -- jmJobImpressionsCompleted objects in the jmJobTable on page -- 80. -- +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 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. -- 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. -- +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ -- Page attributes -- -- A page is a logical page. Number up can impose more than -- one page on a single side of a sheet. Two-up is the -- placement of two logical pages on one side of a sheet so -- that each side counts as two pages. -- +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 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. 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 -- -- The sheet is a single piece of a medium, whether printing -- on one or both sides. -- +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ sheetsRequested(150), -- Integer32(-2..2147483647) -- INTEGER: The number of medium sheets requested to be -- processed for this job. sheetsCompleted(151), -- Integer32(-2..2147483647) -- INTEGER: The 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 reset to 0 as each -- document in the job starts being processed and for each -- document copy as it starts being processed. -- +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ -- Resources attributes (requested and consumed) -- -- Pairs of these attributes can be used by monitoring -- applications to show 'thermometers' of usage to users. -- +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ mediumRequested(170), -- JmMediumTypeTC (pg 31) -- AND/OR -- OCTET STRING(SIZE(0..63)) -- INTEGER: MULTI-ROW: The type -- AND/OR -- OCTETS: the name of the medium that is required by the -- job. mediumConsumed(171), -- OCTET STRING(SIZE(0..63)) -- AND -- Integer32(-2..2147483647) -- OCTETS: MULTI-ROW: The name of the medium -- AND -- INTEGER: the number of sheets that have been consumed so -- far whether those sheets have been processed on one side -- or on both. This attribute SHALL have both values. colorantRequested(172), -- Integer32(0..2147483647) -- AND/OR -- OCTET STRING(SIZE(0..63)) -- INTEGER: MULTI-ROW: The index (prtMarkerColorantIndex) -- in the Printer MIB[1] -- AND/OR -- OCTETS: the name of the colorant requested. colorantConsumed(173), -- Integer32(0..2147483647) -- AND/OR -- OCTET STRING(SIZE(0..63)) -- INTEGER: MULTI-ROW: The index (prtMarkerColorantIndex) -- in the Printer MIB[1] -- AND/OR -- OCTETS: the name of the colorant consumed. -- +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ -- 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 4.2 on page 19 and section 4.3 on page 20 for the -- conformance requirements 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. -- -- 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. See page 27. -- +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ jobSubmissionToServerTime(190), -- JmTimeStampTC (pg 27) -- AND/OR -- DateAndTime (SNMPv2-TC) -- INTEGER: Configuration 2 and 3: The time -- AND/OR -- OCTETS: the date and time that the job was submitted to -- the server. jobSubmissionToDeviceTime(191), -- JmTimeStampTC (pg 27) -- AND/OR -- DateAndTime (SNMPv2-TC) -- INTEGER: Configuration 1 and 3: The time -- AND/OR -- OCTETS: the date and time that the job was submitted to -- the device. timeSinceJobWasSubmittedToDevice(192), -- Integer32(0.. -- 2147483647) -- INTEGER: The time in seconds since the job was submitted -- to the device. jobStartedBeingHeldTimeStamp(193), -- JmTimeStampTC (pg 27) -- INTEGER: The time that the job started being held, i.e., -- the time that the job entered the pendingHeld state most -- recently. 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(194), -- JmTimeStampTC (pg 27) -- AND/OR -- DateAndTime (SNMPv2-TC) -- INTEGER: The time -- AND/OR -- OCTETS: the date and time that the job started -- processing. timeSinceStartedProcessing(195), -- Integer32(-2..2147483647) -- INTEGER: The time in milliseconds since the job started -- processing. jobCompletedTime(196), -- JmTimeStampTC (pg 27) -- AND/OR -- DateAndTime (SNMPv2-TC) -- INTEGER: The time -- AND/OR -- OCTETS: the date and time that the job completed -- processing and the medium is completely stacked in the -- output bin, i.e., when the job entered the completed, -- canceled, or aborted state. timeSinceCompleted(197), -- Integer32(-2..2147483647) -- INTEGER: The time in milliseconds since the job -- completed processing and the medium was completely -- stacked in the output bin, i.e., since the job entered -- the completed, canceled, or aborted state. jobProcessingCPUTime(198) -- Integer32(-2..2147483647) -- INTEGER: The amount of CPU time that the job has been -- processing in seconds, i.e., in the processing job state. -- If the device stops and/or 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 -- submitted again. } 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 document production instructions that are not one of the identified types. unknown 0x2 The job contains some document production instructions whose type is unknown to the agent. print 0x4 The job contains some document production instructions that specify printing scan 0x8 The job contains some document production instructions that specify scanning faxIn 0x10 The job contains some document production instructions that specify receive fax faxOut 0x20 The job contains some document production instructions that specify sending fax getFile 0x40 The job contains some document production instructions that specify accessing files or documents putFile 0x80 The job contains some document production instructions that specify storing files or documents mailList 0x100 The job contains some document production instructions that specify distribution of documents using an electronic mail system. These bit definitions are the equivalent of a type 2 enum except that combinations of them MAY be used together. See section 7.1.2 on page 22." SYNTAX INTEGER(0..2147483647) -- 31 bits, all but sign bit JmJobStateReasons1TC ::= TEXTUAL-CONVENTION STATUS current DESCRIPTION "This textual-convention is used with the jmJobStateReasons1 object to provides additional information regarding the jmJobState object values. The following standard values are defined (in hexadecimal) as powers of two, since multiple values MAY be used at the same time. NOTE - The Job Monitoring MIB contains a superset of the IPP values[3] 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. NOTE - For easy of understanding the order of the reasons is presented in the order in which the reason is most likely to occur. 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 expected (1) additional operations to finish creating the job and/or (2) is accessing/accepting document data. jobOutgoing 0x8 Configuration 2 only: The server is transmitting the job to the device. jobHoldSpecified 0x10 The value of the job's jobHold(52) attribute (see page 47) is TRUE, either set when the job was created or subsequently by an explicit modify job operation. 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 0x20 The value of the job's jobHoldUntil(53) (see page 47) attribute specifies a time period that is still in the future, either set when the job was created or subsequently by an explicit modify job operation. 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 0x40 The value of the job's jobProcessAfterDateAndTime(51) (see page 46) attribute specifies a time that is still in the future, either set when the job was created or subsequently by an explicit modify job operation. 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 0x80 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 0x100 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 0x200 The device(s) to which the job is assigned is (are all) stopped. jobPrinting 0x400 The output device is marking media. This attribute is useful for servers and output devices which spend a great deal of time processing when no marking is happening and then want to show that marking is now happening. jobCanceledByUser 0x800 The job was canceled by the user, i.e., by a user whose name is the same as the value of the job's jobOwner attribute. jobCanceledByOperator 0x1000 The job was canceled by the operator, i.e., by a user whose name is different than the value of the job's jobOwner attribute. abortedBySystem 0x2000 The job was aborted by the system. NOTE - this reason is needed only when the job is not placed in the aborted job state. jobCompletedSuccessfully 0x4000 The job completed successfully. jobCompletedWithWarnings 0x8000 The job completed with warnings. jobCompletedWithErrors 0x10000 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[2] and other job submission protocols: jobPaused 0x20000 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 0x40000 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 0x80000 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 resubmit the job (or a copy of the job). When a client could no longer resubmit the job, such as after the document data has been discarded, the agent SHALL remove the jobRetained value from the jmJobStateReasons1 object. These bit definitions are the equivalent of a type 2 enum except that combinations of bits may be used together. See section 7.1.2 on page 22. 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 on page 59. 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 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. submissionInterrupted 0x10 Indicates that the job was not completely submitted for the following reasons: (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. Whether the server or device puts the job into the pendingHeld or aborted state depends on implementation. 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. Normally, the job is resumed by means outside the job submission protocol, such as some local function on the device. 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. Normally, the job is resumed by means outside the job submission protocol, such as some local function on the device, whereupon the job SHALL transition immediately 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 human intervention did not occur 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 device. queuedInDevice 0x4000 The job has been queued in a down stream server or device. jobCleanup 0x8000 The server/device is performing cleanup activity as part of ending normal processing. processingToStopPoint 0x10000 The requester has issued an operation to interrupt the job and the server/device is processing up until the specified stop point occurs. jobPasswordWait 0x20000 The server/device has selected the job to be next to process, but instead of assigning resources and started 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. serviceOffLine 0x400000 The service/document transform is off-line and accepting no jobs. All pending jobs are put into the pendingHeld state. This could be true if its input is impaired or broken. noSpaceOnServer 0x800000 There is no room on the server to store all of the job. For example, there is no room for the document data. 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. The requester SHALL either (1) enter a pin locally at the device or issue a remote operation supplying the PIN in order for the job to be able to proceed. 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. An overdraft mechanism SHOULD be included to be user-friendly, so as to minimize the chances that the job cannot finish or that media is wasted. For example, the server/device SHOULD finish the current copy for a job with collated document copies, rather than stopping in the middle of the current document copy. heldForRetry 0x4000000 The job encountered some errors that the server/device could not recover from with its normal retry procedures, but the error is worth trying the job later, such as 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. Whether the job is placed in the pendingHeld or aborted state, depends on implementation. deviceUnavailable 0x10000000 This job was aborted by the system because the device is currently unable to accept jobs. Whether the job is placed in the pendingHeld or aborted state, depends on implementation. 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. Whether the job is placed in the pendingHeld or aborted state, depends on implementation. 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. These bit definitions are the equivalent of a type 2 enum except that combinations of them may be used together. See section 7.1.2 on page 22." 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 on page 59. 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. These bit definitions are the equivalent of a type 2 enum except that combinations of them may be used together. See section 7.1.2 on page 22. The remaining bits are reserved for future standardization and/or registration." 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 on page 59. 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 bit definitions are the equivalent of a type 2 enum except that combinations of them may be used together. See section 7.1.2 on page 22. These bits are reserved for future standardization and/or registration." 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. -- Implementation of every object in this group is MANDATORY. -- See Section 4 entitled 'Conformance Considerations' on page 18. 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 Terminology and Job Model on page 12 for the definition of a job set." ::= { 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 { jmJobSetIndex } ::= { jmGeneralTable 1 } JmGeneralEntry ::= SEQUENCE { jmGeneralNumberOfActiveJobs Integer32(0..2147483647), jmGeneralOldestActiveJobIndex Integer32(0..2147483647), jmGeneralNewestActiveJobIndex Integer32(0..2147483647), jmGeneralJobPersistence Integer32(0..2147483647), jmGeneralAttributePersistence Integer32(0..2147483647), jmGeneralJobSetName OCTET STRING(SIZE(0..63)) } 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 JmJobStateTC on page 32 for the exact specification of the semantics of the job states. If there are no active jobs, the value of this object SHALL be 0." ::= { jmGeneralEntry 1 } 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. When a job transitions from one of the 'active' states (pending, processing, processingStopped) to one of the 'in-active' states (pendingHeld, completed, canceled, or aborted), with a jmJobIndex value that matches this object, the agent SHALL advance (or wrap - see jmGeneralNewestActiveJobIndex) the value to the next oldest 'active' job, if any. On the other hand, when a job transitions from one of the 'in- active' states to one of the 'active' state, the agent SHALL reduce (or wrap) the value of this object, if the job's jmJobIndex is smaller than the current value. If there are no active jobs, the agent SHALL set the value of this object to 0." ::= { jmGeneralEntry 2 } 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 a new job is accepted by the server or device that the agent is instrumenting, the agent SHALL assign the next available value to the job's jmJobIndex that is used for storing job information in the jmJobIDTable, the jmJobTable, and the jmAttributeTable. If the value would exceed the implementation- defined maximum value for jmJobIndex, the agent SHALL set the value back to 1, i.e., wrap around to the beginning of the job tables. It is recommended that the largest value for jmJobIndex be much larger than the maximum number of jobs that the implementation can contain at a single time, so as to minimize the pre-mature re-use of jmJobIndex value for a newer job while clients retain the same 'stale' value for an older job. Each time a new job is accepted by the server or device that the agent is instrumenting AND that job is to be 'active' (pending, processing, or processingStopped, but not pendingHeld), the agent SHALL copy the value of the job's jmJobIndex to the jmGeneralNewestActiveJobIndex object. If the new job is 'in- active' (pendingHeld state), the agent SHALL not change the value of jmGeneralNewestActiveJobIndex object. 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. Whenever a job changes from 'in- active' to 'active' (from pendingHeld to pending or processing), the agent SHALL update the value of either the jmGeneralOldestActiveJobIndex or the jmGeneralNewestActiveJobIndex objects, or both, if the job's jmJobIndex value is outside the range between jmGeneralOldestActiveJobIndex and jmGeneralNewestActiveJobIndex. When the server or device is power-cycled, the agent SHALL remember the next jmJobIndex value to be assigned, so that new jobs are not assigned the same jmJobIndex as recent jobs before the power cycle. NOTE - Applications that wish to efficiently access all of the active jobs MAY use jmGeneralOldestActiveJobIndex value to start with the oldest active job and continue until they reach the index value equal to jmGeneralNewestActiveJobIndex, skipping over any pendingHeld, completed, canceled, or aborted jobs that might intervene. If an application detects that the jmGeneralNewestActiveJobIndex is smaller than jmGeneralOldestActiveJobIndex, the job index has wrapped. In this case, when the application exceeds the maximum job index (detected by a no such object status returned from a GetNext operation for the next conceptual row), the application SHALL start over at 1 and continue the GetNext operations to find the rest of the active jobs." ::= { jmGeneralEntry 3 } jmGeneralJobPersistence OBJECT-TYPE SYNTAX Integer32(0..2147483647) MAX-ACCESS read-only STATUS current DESCRIPTION "The minimum time in seconds for this instance of the Job Set that an entry will 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. Depending on implementation, the value of this object MAY be either: (1) set by the system administrator by means outside this specification or (2) fixed by the implementation." ::= { jmGeneralEntry 4 } jmGeneralAttributePersistence OBJECT-TYPE SYNTAX Integer32(0..2147483647) MAX-ACCESS read-only STATUS current DESCRIPTION "The minimum time in seconds for this instance of the Job Set that an entry will 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. The value of this object MAY be either (1) set by the system administrator by means outside this specification or MAY be (2) fixed by the implementation, depending on implementation. This value SHALL be equal to or less than the value of jmGeneralJobPersistence." ::= { jmGeneralEntry 5 } jmGeneralJobSetName OBJECT-TYPE SYNTAX OCTET STRING(SIZE(0..63)) MAX-ACCESS read-only STATUS current DESCRIPTION "The human readable administratively assigned name of this job set (by means outside of this MIB). Typically, this name will 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 - 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." ::= { jmGeneralEntry 6 } -- The Job ID Group (Mandatory) -- The jmJobIDGroup consists entirely of the jmJobIDTable. -- -- The two key indexes that are used in other tables to index jobs: -- jmJobSetIndex and jmJobIndex are materialized in this group. -- -- Implementation of every object in this group is MANDATORY. -- See Section 4 entitled 'Conformance Considerations' on page 18. 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 jmJobSetIndex 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 jmJobIndex of the job it is querying, that application NEED NOT use the jmJobIDTable." ::= { jmJobID 1 } jmJobIDEntry OBJECT-TYPE SYNTAX JmJobIDEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "The map from (1) the jmJobSubmissionID to (2) the jmJobSetIndex and jmJobIndex. An entry SHALL exist in this table for each job, no matter what the state of the job and no matter what job set the job is in. Each job SHALL appear in one and only one job set. NOTE - an IMPLICIT statement is NOT provided in the following INDEX clause, since it was not an SMIv1 feature. Therefore, the extra ASN.1 tag SHALL be included in the varbind in the SNMP request and the response." INDEX { jmJobSubmissionID } ::= { jmJobIDTable 1 } JmJobIDEntry ::= SEQUENCE { jmJobSubmissionID OCTET STRING(SIZE(1..32)), jmJobSetIndex Integer32(1..32767), jmJobIndex Integer32(1..2147483647) } jmJobSubmissionID OBJECT-TYPE SYNTAX OCTET STRING(SIZE(1..32)) MAX-ACCESS not-accessible STATUS current DESCRIPTION "A quasi-unique 32-octet string ID which identifies the job uniquely within a particular client-server environment. Either the client or the server assigns the job submission ID for each job. The monitoring application whether in the client or running separately, uses the job submission ID to help the user identify which jmJobIndex was assigned by the agent. There are multiple formats for the jmJobSubmissionID. Each format SHALL be registered using the procedures of a type 2 enum. See section entitled: 'IANA Registration of enums' on page 22. The value of jmJobSubmissionID SHOULD be one of the registered format types. The first octet of the string SHALL indicate which registered format is being used. The ASCII characters '0- 9', 'A-Z', and 'a-z' will be assigned in order giving 62 possible formats. The agent SHALL assign a string of registered format (0) for any job without a Job Submission ID. The format values registered so far are: Format Number Description ------ ------------ 0 Set by the agent when neither the client nor the server assigned a job submission ID. 1 octets 3-10: 8-decimal-digit random number octets 11-32: last 22 bytes of the jobName attribute 2 octets 3-10: 8-decimal-digit sequential number octets 11-32: Client MAC address 3 octets 3-10: 8-decimal-digit sequential number octets 11-32: last 22 bytes of the client URL .. to be registered according to procedures of a type 2 enum. See section 7.3 on page 23. 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 a very low number, but is not intended to be an absolute guarantee of uniqueness. None-the-less, collisions could occur, but without bad consequences, since this MIB is intended to be used only for monitoring jobs, not for controlling and managing them." ::= { jmJobIDEntry 1 } jmJobSetIndex OBJECT-TYPE SYNTAX Integer32(1..32767) MAX-ACCESS read-only STATUS current DESCRIPTION "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 jmJobIndex value permits the management application to access the other tables to obtain the job- specific objects. This value SHALL be the same for a job in the jmJobIDTable as the corresponding jmJobSetIndex value in the jmJobTable and jmAttributeTable for this job. The value(s) of the jmJobSetIndex SHALL be persistent across power cycles, so that clients that have retained jmJobSetIndex 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. See Terminology and Job Model on page 12 for the definition of a job set." ::= { jmJobIDEntry 2 } jmJobIndex OBJECT-TYPE SYNTAX Integer32(1..2147483647) MAX-ACCESS read-only 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. This value SHALL be the index used in the jmJobTable and jmAttributeTable for this job. See jmGeneralNewestActiveJobIndex on page 70 for a discussion about the largest value of jmJobIndex for an implementation. Agents instrumenting systems that contain jobs with a job identifier of 0 SHALL map the job identifier value 0 to a jmJobIndex value that is one higher than the highest job identifier value that any job can have on that system." ::= { jmJobIDEntry 3 } -- The Job Group (Mandatory) -- The jmJobGroup consists entirely of the jmJobTable. -- -- Implementation of every object in this group is MANDATORY. -- See Section 4 entitled 'Conformance Considerations' on page 18. 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." ::= { 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." INDEX { jmJobSetIndex, jmJobIndex } ::= { jmJobTable 1 } JmJobEntry ::= SEQUENCE { jmJobState JmJobStateTC, -- pg 32 jmJobStateReasons1 JmJobStateReasons1TC, -- pg 59 jmNumberOfInterveningJobs Integer32(-2..2147483647), jmJobKOctetsRequested Integer32(-2..2147483647), jmJobKOctetsProcessed Integer32(-2..2147483647), jmJobImpressionsRequested Integer32(-2..2147483647), jmJobImpressionsCompleted Integer32(-2..2147483647) } jmJobState OBJECT-TYPE SYNTAX JmJobStateTC -- See page 32 MAX-ACCESS read-only STATUS current DESCRIPTION "The current state of the job (pending, processing, completed, etc.). Even though the JmJobStateTC textual-convention defines nine values for job states, agents SHALL only implement those states which are appropriate for the particular implementation. In other words, all possible enums for this object SHALL be reported if implemented by the device and available to the agent. 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 keep a job in the completed, canceled, or aborted state before removing the job from the jmJobIDTable and jmJobTable is specified by the value of the jmGeneralJobPersistence object." ::= { jmJobEntry 1 } jmJobStateReasons1 OBJECT-TYPE SYNTAX JmJobStateReasons1TC -- See page 59 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. NOTE - The jobStateReasonsn (n=2..4) attributes (see page 39) provide further additional information about the job's current state. Implementation of these values is OPTIONAL, i.e., an agent NEED NOT implement them, even if (1) the device supports the functionality represented by the reason and (2) is available to the agent. These values MAY be used with any job state or states for which the reason makes sense. Furthermore, when implemented, the agent SHALL return these values when the reason applies and SHALL NOT return them when the reason no longer applies whether the value of the job's jmJobState object changed or not. When the job does not have any reasons for being in its current state, the agent SHALL set the value of the jmJobStateReasons1 object and jobStateReasonsn attributes to 0. 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." ::= { jmJobEntry 2 } jmNumberOfInterveningJobs OBJECT-TYPE SYNTAX Integer32(-2..2147483647) MAX-ACCESS read-only STATUS current DESCRIPTION "The number of jobs that are expected to be processed before this job is processed 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 this job starts processing (since there are no jobs in front of the job)." ::= { jmJobEntry 3 } jmJobKOctetsRequested 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. The server/device MAY update the value of this attribute after each document has been transferred to the server/device or the server/device MAY provide this value after all documents have been transferred to the server/device, depending on implementation. In other words, while the job is in the pendingHeld state with the jmJobStateReasons1 object containing a jobIncoming value, the value of the jmJobKOctetsRequested object depends on implementation and MAY not correctly reflect the size of the job. 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." ::= { jmJobEntry 4 } jmJobKOctetsProcessed OBJECT-TYPE SYNTAX Integer32(-2..2147483647) MAX-ACCESS read-only STATUS current DESCRIPTION "The current number of octets processed by the server or device measured in units of K (1024) octets. 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 makes only a single pass over the document, the final value SHALL be equal to the value of the jmJobKOctetsRequested object. For implementations where multiple copies are produced by the interpreter making multiple passes over the document, the final value SHALL be a multiple of the value of the jmJobKOctetsRequested object. NOTE - See the impressionsCompletedCurrentCopy and pagesCompletedCurrentCopy attributes for attributes that are reset on each document copy. NOTE - The jmJobKOctetsProcessed object can be used in the numerator with the jmJobKOctetsRequested object in the denominator in order to produce a 'thermometer' that indicates the progress of the job, provided that the multiplicative factor is taken into account for some implementations of multiple copies." ::= { jmJobEntry 5 } jmJobImpressionsRequested OBJECT-TYPE SYNTAX Integer32(-2..2147483647) MAX-ACCESS read-only STATUS current DESCRIPTION "The number of impressions requested by this job to produce." ::= { jmJobEntry 6 } jmJobImpressionsCompleted OBJECT-TYPE SYNTAX Integer32(-2..2147483647) MAX-ACCESS read-only STATUS current DESCRIPTION "The current 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." ::= { jmJobEntry 7 } -- The Attribute Group (Mandatory) -- The jmAttributeGroup consists entirely of the jmAttributeTable. -- -- Implementation of the two objects in this group is MANDATORY. -- See Section 4 entitled 'Conformance Considerations' on page 18. -- -- A few attributes are MANDATORY for agent conformance, and the rest -- are OPTIONAL. See the specification of the JmAttributeTypeTC on -- page 35 for which attributes are MANDATORY for agents to implement. 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." ::= { 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 JmAttributeTypeTC on page 35). 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 (see page 72). Zero or more entries SHALL exist in this table for each job in a job set. Each job SHALL appear in one and only one job set." INDEX { jmJobSetIndex, jmJobIndex, jmAttributeTypeIndex, jmAttributeInstanceIndex } ::= { jmAttributeTable 1 } JmAttributeEntry ::= SEQUENCE { jmAttributeTypeIndex JmAttributeTypeTC, -- pg 35 jmAttributeInstanceIndex Integer32(1..32767), jmAttributeValueAsInteger Integer32(-2..2147483647), jmAttributeValueAsOctets OCTET STRING(SIZE(0..63)) } jmAttributeTypeIndex OBJECT-TYPE SYNTAX JmAttributeTypeTC -- See page 35 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 and document attributes include: jobCopiesRequested, documentCopiesRequested, jobCopiesCompleted, documentCopiesCompleted, fileName, and documentName. Examples of required and consumed resource attributes include: pagesRequested, pagesCompleted, mediumRequested, and mediumConsumed, 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 or documentFormat, 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 definition (see page 35) 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, 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, interpreter, and physicalDevice, do not have the 'INTEGER:' tag in the JmAttributeTypeTC definition and so SHALL return a value of (-1) to indicate other for jmAttributeValueAsInteger. For attributes which do have the 'INTEGER:' tag in the JmAttributeTypeTC definition, if the integer value is not (yet) known, the value SHALL be (-2) to represent unknown counting integers, (2) to represent unknown enum values, or the attribute row SHALL not be present in the table." ::= { 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 definition (see page 35) has the tag: 'OCTETS:'. Depending on the enum definition, this object value MAY be a coded character set string (text) 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 return a zero length string for the value of the jmAttributeValueAsOctets object." ::= { 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 jmAttributeTypeIndex -- SYNTAX INTEGER { -- jobOwner(20) -- } -- DESCRIPTION --"It is conformant for an agent to implement the one mandatory -- attribute. Any additional attributes are OPTIONAL, -- i.e., an agent NEED NOT represent any additional -- attributes that the server or device implements. However, a -- client SHALL accept all of the attributes from an agent and -- either display them to its user or ignore them. -- -- NOTE - SMI does not allow an enum to be declared as mandatory -- if that enum is not a member of a group, but -- jmAttributeTypeIndex cannot be a member of a group and still -- be not-accessible. So this MIB spec comments the MANDATORY -- attributes as if SMI allowed such a declaration in order to -- declare the MANDATORY attributes." -- 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 { jmJobSetIndex, jmJobIndex } STATUS current DESCRIPTION "The job ID group." ::= { jmMIBGroups 2 } jmJobGroup OBJECT-GROUP OBJECTS { jmJobState, jmJobStateReasons1, jmNumberOfInterveningJobs, jmJobKOctetsRequested, jmJobKOctetsProcessed, jmJobImpressionsRequested, jmJobImpressionsCompleted } STATUS current DESCRIPTION "The job group." ::= { jmMIBGroups 3 } jmAttributeGroup OBJECT-GROUP OBJECTS { jmAttributeValueAsInteger, jmAttributeValueAsOctets } STATUS current DESCRIPTION "The attribute group." ::= { jmMIBGroups 4 } END