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