JOB-MONITORING-TC DEFINITIONS ::= BEGIN IMPORTS MODULE-IDENTITY, experimental FROM SNMPv2-SMI -- rfc 1442 TEXTUAL-CONVENTION FROM SNMPv2-TC; -- rfc 1443 -- Upon publication as RFC, delete this comment and the line following -- this comment and change the reference of { printmib 103 } -- (above) to { mib-2 X }. -- This will result in changing: -- 1 3 6 1 3 54 jmJobMonTC(103) to: -- 1 3 6 1 2 1 jmJobMonTC(X) -- This will make it easier to translate prototypes to -- the standard namespace because the lengths of the OID's won't -- change. printmib OBJECT IDENTIFIER ::= { experimental 54 } jmJobMonTC MODULE-IDENTITY LAST-UPDATED "9510251230Z" ORGANIZATION "IETF/DMTF Printer Working Group (PWG)" CONTACT-INFO " Thomas N. Hastings Xerox Corporation, MS ES-AE 242 701 S. Aviation Blvd. El Segundo, CA 90245 Phone: 1+ (310)333-6413 FAX: 1+ (310)333-6342 E-Mail: hastings@cp10.es.xerox.com" DESCRIPTION "File: jobmontc.doc, .psr, .ps, .txt Version: 0.7 This textual-convention module defines textual- conventions for use with the job monitoring MIB, module: JOB-MONITORING-MIB. Also the explanatory material with this module explains the job monitoring MIB. These textual-conventions and explanations are in a separate module from the job monitoring MIB, so that they may be republished when additional enums are added or more explanatory material is added without needing to republish the job monitoring MIB, thus increasing the stability of the job monitoring MIB." ::= { printmib 103 } -- definitions of textual conventions DPAJobState ::= TEXTUAL-CONVENTION STATUS current DESCRIPTION "A job may be in any of the states defined by this textual- convention. When a job is in the processing or printing state, the state of the assigned printer(s) is needed to fully represent the state of the job. ISO DPA: Job-current-state Standard values are defined for the current-job-state and previous-job-state attributes of the DPA job object, as follows: unknown The job state is not known, or is indeterminate, or is not returned by the operation. (id-val-job-state-unknown) pre-processing The job has been created on the server by the create-job sub-operation of the Print request, but a Print request with a TRUE value for the job-submission-complete component of the PrintArgument has not yet been received and no document has started processing. The job maybe in the process of being checked by the server for attributes, defaults being applied, a printer being selected, etc. (id-val-job- state-pre-processing) held The job is waiting to be released for scheduling for any number of reasons as specified by the value of the job's job- state-reasons attribute. (id-val-job- state-held) pending The job's job-submission-complete attribute is TRUE since the server has received a Print request with the job-submission- complete parameter TRUE and the job is waiting to start processing on a printer. (id-val-job-state-pending) processing The server is processing the job, or 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. (id-val-job-state-processing) printing The server has completed processing the job and the output device is currently printing the job on at least one printer. That is, a print engine is either printing pages of the job, or failing in its attempt to print pages of the job because of some wait state, such as, start-wait, end-wait, needs-attention, etc. The complete job state includes the detailed status represented in the printers' printer-state attribute(s). (id-val-job-state-printing) paused The job has been paused as a result of a PauseJob operation. (id-val-job-state- paused) interrupted The job was interrupted by the InterruptJob request for an intervening job, and shall resume processing automatically once the intervening job has completed. (id-val- job-state-interrupted) terminating The job has been cancelled by a CancelJob request or aborted by the server and is in the process of terminating. The job's job- state-reasons attribute contains the reasons that the job is being terminated. (id-val-job-state-terminating) retained The job is being retained at the server as a result of the job's job-retention-period being non-zero. The job has (1) completed successfully or with warnings or errors, (2) been aborted while printing by the server, or (3) been cancelled by the CancelJob request before or during processing. The job's job-state-reasons attribute contains the reasons that the job has been retained. While in the retained state, all of the job's document data (and resources, if any) shall be retained by the server; thus a job in the retained state could be reprinted, using some means outside the scope of ISO/IEC 10175-Part 1. (id-val-job-state- retained) completed The job has: (1) completed successfully or with warnings or errors, (2) been aborted by the server while printing, or (3) been cancelled by the CancelJob request, AND the job's: (1) job-retention-period was zero or has expired, or (2) job-discard-time has arrived. The job's job-state-reasons attribute contains the reason(s) that the job has been completed. While in the completed state, a job's document data (and resources if any) need not be retained by the server; thus a job in the completed state could not be reprinted. The length of time that a job may be in this state, before transitioning to unknown, is implementation-dependent. However, servers that implement the completed job-state shall retain, as a minimum, the following attributes for any job in the completed state: job-identifier, job-owner, job-name, current-job-state, printers-assigned, and job-state-reasons. (id-val-job-state-completed) This is a type 2 enum." SYNTAX INTEGER { other(1), unknown(2), -- the following enum values are +2 pre-processing(3),-- of the final arc of the ISO DPA pending(6), -- id-val-job-state-xxx OID processing(7), interrupted(8), retained(11), held(12), paused(13), terminating(14), completed(17), printing(18) } DPAJobStateReasons ::= TEXTUAL-CONVENTION STATUS current DESCRIPTION "This representation is bit-encoded, so that multiple reasons can occur at once. Each bit corresponds to an ISO DPA OID for the same reason. ISO DPA: Job-state-reasons This attribute identifies the reason or reasons that the job is in the held, terminating, retained, or completed state. The server shall indicate the particular reason(s) by setting the value of the job-state-reasons attribute. When the job is not in any of these states, the server shall set the value of the job-state-reasons attribute to the empty set. The following standard values are defined: documents- 0x1 The complete job has been accepted by the needed server (the value of the job-submission- complete element was TRUE in the last Print request for the job), but the server is waiting for its files to start and/or finish being transferred before the job can be scheduled to be printed. (id-val-reasons-documents-needed) job-hold-set 0x2 The value of the job's job-hold attribute is TRUE. (id-val-reasons-job-hold-set) job-print- 0x4 The value of the job's job-print-after after- attribute has specified a time specified specification that has not yet occurred. (id-val-reasons-job-print-after-specified) required- 0x8 At least one of the resources needed by resources- the job, such as media, fonts, resource not-ready objects, etc., is not ready on any of the physical printer's for which the job is a candidate. (id-val-reasons-required- resources-not-ready) successful- 0x10 The job completed successfully. (id-val- completion reasons-successful completion) completed- 0x20 The job completed with warnings. (id- with- val-reasons-completed-with-warnings) warnings completed- 0x40 The job completed with errors (and with-errors possibly warnings too). (id-val-reasons- completed-with-errors) cancelled- 0x80 The job was cancelled by the user using by-user the CancelJob request. (id-val-reasons- cancelled-by-user) cancelled- 0x100 The job was cancelled by the operator by-operator using the CancelJob request. (id-val- reasons-cancelled-by-operator) aborted-by- 0x200 The job was aborted by the system. (id- system val-reasons-aborted-by-system) logfile- 0x400 The job's logfile is pending file transfer. pending (id-val-reasons-logfile-pending) logfile- 0x800 The job's logfile is being transferred. transferring (id-val-reasons-logfile-transferring) This is the equivalent of a type 2 enum." SYNTAX INTEGER(0..4095) DPADeviceState ::= TEXTUAL-CONVENTION STATUS current DESCRIPTION "States for other devices will be added to both this textual-convention and to ISO DPA. [NOTE - The name was changed from the ISO DPA printer-state to DPADeviceState, since it is anticipated to add any additional states that scanners, faxes, and other multifunction devices might need.] When a job is in the processing or printing state, the state of the assigned printer(s) is needed to fully represent the state of the job. ISO DPA: Printer-state Standard values are defined for the printer-state printer attribute, as follows: unknown The printer state is not known, or is indeterminate, or is not returned by the operation (id-val-printer-state-unknown) idle The printer is ready to accept jobs, but none have been scheduled on it. (id-val-printer- state-idle) printing The printer is currently printing a job (id- val-printer-state-printing) needs-attention The printer needs human attention (no special skills required). This state typically includes adding paper, clearing a jam, changing the medium, etc. (id-val-printer- state-needs-attention) paused The operator has (temporarily) paused the printer, by means outside the scope of this part of ISO/IEC 10175. (id-val-printer-state- paused) shutdown The printer has been taken out of service, (for a long time), whether for repairs or others reasons. The printer's message generic attribute may be used to record a reason and estimated time for return to service (id-val- printer-state-shutdown) job-start-wait The currently processing job was started with the job-start-wait attribute set, and is awaiting operator intervention or time-out. (id-val-printer-state-job-start-wait) job-end-wait The currently processing job was started with the job-end-wait attribute set, and is awaiting operator intervention or time-out. (id-val-printer-state-job-end-wait) job-password-wait The currently processing job was started with the job-password attribute set, and is awaiting the operator or user to enter the password supplied by the job-password attribute. (id-val-printer-state-job- password-wait) needs-key- The printer needs the attention of a key operator operator. Key operator functions are printer- specific, but typically include adding toner or developer, or attending to a hardware fault. (id-val-printer-state-needs-key- operator) connecting- The server has scheduled a job on the printer to-printer and is in the process of connecting to a shared network printer (and may not be able to actually start printing the job for an arbitrarily long time depending on the usage of the printer by other servers). (id-val- printer-state-connecting-to-printer) timed-out The server was able to connect to the printer (or is always connected), but was unable to get a response from the printer in the time specified by the printer's printer-timeout- period attribute. (id-val-printer-state- timed-out) This is a type 2 enum." SYNTAX INTEGER { other(1), unknown(2), -- the following enum values are +2 idle(3), -- of the final arc of the ISO DPA printing(4), -- id-val-printer-state-xxx OID needs-attention(5), paused(6), shutdown(7), job-start-wait(8), job-end-wait(9), needs-key-operator(10), job-password-wait(11), timed-out(12), connecting-to-printer(13) } DPADocType ::= TEXTUAL-CONVENTION STATUS current DESCRIPTION "Jobs contain documents. Documents may be printable, font, or resource objects. ISO DPA: Document-type The following standard values are defined: printable Specifies that this document is to be printed on the assigned printer. (id-val-document-type- printable) font Specifies that this document is a font resource which may be required by one or more of the printable documents associated with the print- job. See the font object class. (id-val- document-type-font) resource Specifies that this document contains resource data, of some type other than font, which may be required to print one or more of the printable documents associated with the print-job. See the resource object class. (id-val-document- type-resource) This is a type 2 enum." SYNTAX INTEGER { other(1), unknown(2), printable(3), -- the following enum values are +3 font(4), -- of the final arc of the ISO DPA resource(5) -- id-val-document-type-xxx OID } DPADocState ::=TEXTUAL-CONVENTION STATUS current DESCRIPTION "The following standard values are defined: transfer- The server has created the document object, but pending the data transfer of the document data has not started or completed (id-val-document-state- transfer-pending) pending The server has received the document data and the document is waiting for processing to begin. The job may already be in the processing state, if the job's job-scheduling attribute in not after-complete (see the current-job-state and job-scheduling job attributes. (id-val-document-state-pending) processing The server has started processing this document, or has made the document ready for printing, but the output device is not yet printing it, either because the document hasn't reached the output device or because the document is queued in the output device or some other spooler, awaiting the output device to print it. (id-val-document-state-processing) printing The server has completed processing the document and the output device is currently printing the document on at least one printer. That is, a print engine is either printing pages of the document, or failing in its attempt to print pages of the document because of some wait state, such as, start-wait, end- wait, needs-attention, etc. The complete document state includes the detailed status represented in the printers' printer-state attribute(s). (id-val-document-state-printing) completed The server has completed printing this document. The job may still be in the printing state, or may be in the retained state. (id- val-document-state-completed) This is a type 2 enum." SYNTAX INTEGER { other(1), unknown(2), transfer-pending(3), -- the following enum values pending(4), -- are +3 of the final arc of processing(5), -- the ISO DPA completed(6), -- id-val-document-state-xxx OID printing(7) } DPADocOutput ::= TEXTUAL-CONVENTION STATUS current DESCRIPTION "This object is bit coded, so that multiple document output requests may be made for the document. Each bit corresponds to one of the ISO DPA output OIDs. ISO DPA: Output This attribute identifies the output processing for the media on which the document is to be printed. The following standard values are defined: Page-Collate 0x1 This value specifies that the pages of a document are to be in sequence, when multiple copies of the document are specified by the copy-count attribute (possibly up to some implementation- defined maximum number of copies). Whether this effect is achieved by placing copies of the document in multiple output bins or in the same output bin with implementation-defined document separation is implementation- dependent. Also whether it is achieved by making multiple passes over the document or by using an output sorter is implementation-dependent (id-val- output-page-collate) No Page-Collate 0x2 This value specifies that the copies of the pages of a document are to follow one another when multiple copies are specified by the copy-count attribute. That is, if 3 copies are specified, three copies of page 1 are printed then three copies of page 2, etc., and no collating of these pages is desired. This may be useful in some implementations where multiple copies requires re-interpretation of the document format and the document contains some compute intensive pages (such as images) (id-val-output-no page-collate) Decollate 0x4 The parts of a multi-part form are to be separated and sorted into stacks for each part (id-val-output- decollate) No Decollate 0x8 The parts of a multi-part form are to remain intact (id-val-output-no decollate) Burst 0x10 Continuous media is to be separated into individual sheets, generally by bursting along perforations (id-val- output-burst) No Burst 0x20 Continuous media is to remain continuous, no bursting is desired (id-val-output-no burst) Stacking-Default 0x40 A site-defined output-stacking operation is to be applied (id-val- output-stacking-default) This is the equivalent of a type 2 enum." SYNTAX INTEGER(0..255) END