home *** CD-ROM | disk | FTP | other *** search
/ Internet Info 1997 December / Internet_Info_CD-ROM_Walnut_Creek_December_1997.iso / drafts / draft_ietf_j_p / draft-ietf-printmib-job-monitor-03.txt < prev    next >
Text File  |  1997-07-23  |  197KB  |  5,702 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.                  Job Monitoring MIB, V0.83     July 14, 1997
  8.  
  9.  
  10. INTERNET-DRAFT                                               Ron Bergman
  11.                                                       Dataproducts Corp.
  12.                                                             Tom Hastings
  13.                                                        Xerox Corporation
  14.                                                           Scott Isaacson
  15.                                                             Novell, Inc.
  16.                                                              Harry Lewis
  17.                                                                IBM Corp.
  18.                                                                July 1997
  19.  
  20.  
  21.                        Job Monitoring MIB - V0.83
  22.  
  23.                 <draft-ietf-printmib-job-monitor-03.txt>
  24.  
  25.                           Expires Jan 14, 1997
  26.  
  27.  
  28. Status of this Memo
  29.  
  30.      This document is an Internet-Draft.  Internet-Drafts are working
  31.      documents of the Internet Engineering Task Force (IETF), its areas,
  32.      and its working groups.  Note that other groups may also distribute
  33.      working documents as Internet-Drafts.
  34.  
  35.      Internet-Drafts are draft documents valid for a maximum of six
  36.      months and may be updated, replaced, or obsoleted by other
  37.      documents at any time.  It is inappropriate to use Internet-Drafts
  38.      as reference material or to cite them other than as "work in
  39.      progress."
  40.  
  41.      To learn the current status of any Internet-Draft, please check the
  42.      "1id-abstracts.txt" listing contained in the Internet-Drafts Shadow
  43.      Directories on ftp.is.co.za (Africa), nic.nordu.net (Europe),
  44.      munnari.oz.au (Pacific Rim), ds.internic.net (US East Coast), or
  45.      ftp.isi.edu (US West Coast).
  46.  
  47.                                 Abstract
  48.  
  49.      This Internet-Draft specifies a set of 18 SNMP MIB objects for (1)
  50.      monitoring the status and progress of print jobs (2) obtaining
  51.      resource requirements before a job is processed, (3) monitoring
  52.      resource consumption while a job is being processed and (4)
  53.      collecting resource accounting data after the completion of a job.
  54.      This MIB is intended to be implemented (1) in a printer or (2) in a
  55.      server that supports one or more printers.  Use of the object set
  56.      is not limited to printing.  However, support for services other
  57.      than printing is outside the scope of this Job Monitoring MIB.
  58.  
  59.  
  60.  
  61. Bergman, Hastings, Isaacson, Lewis                  [Page 1]
  62.  
  63.  
  64.  
  65.  
  66.  
  67.                  Job Monitoring MIB, V0.83     July 14, 1997
  68.  
  69.  
  70.      Future extensions to this MIB may include, but are not limited to,
  71.      fax machines and scanners.
  72.  
  73.  
  74.  
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121. Bergman, Hastings, Isaacson, Lewis                  [Page 2]
  122.  
  123.  
  124.  
  125.  
  126.  
  127.                  Job Monitoring MIB, V0.83     July 14, 1997
  128.  
  129.  
  130.  
  131.  
  132.                            TABLE OF CONTENTS
  133.  
  134.  
  135. 1. INTRODUCTION............................................8
  136.  
  137.  1.1 Types of Information in the MIB ......................8
  138.  
  139.  1.2 Types of Job Monitoring Applications ................10
  140.  
  141.  
  142. 2. TERMINOLOGY AND JOB MODEL..............................11
  143.  
  144.  2.1 System Configurations for the Job Monitoring MIB ....13
  145.    2.1.1 Configuration 1 - client-printer ................13
  146.    2.1.2 Configuration 2 - client-server-printer - agent in the server
  147.     ......................................................14
  148.    2.1.3 Configuration 3 - client-server-printer - client monitors
  149.    printer agent and server ..............................16
  150.  
  151.  
  152. 3. MANAGED OBJECT USAGE...................................17
  153.  
  154.  3.1 Conformance Considerations ..........................17
  155.    3.1.1 Conformance Terminology .........................18
  156.    3.1.2 Agent Conformance Requirements ..................18
  157.      3.1.2.1 MIB II System Group objects..................18
  158.      3.1.2.2 MIB II Interface Group objects...............19
  159.      3.1.2.3 Printer MIB objects..........................19
  160.    3.1.3 Job Monitoring Application Conformance Requirements  19
  161.  
  162.  3.2 The Job Tables and the Oldest Active and Newest Active Indexes 19
  163.  
  164.  3.3 The Attribute Mechanism .............................21
  165.    3.3.1 Conformance of Attribute Implementation .........22
  166.    3.3.2 Useful, 'Unknown', and 'Other' Values for Objects and
  167.    Attributes ............................................23
  168.    3.3.3 Data Sub-types and Attribute Naming Conventions .23
  169.    3.3.4 Single-Value (Row) Versus Multi-Value (MULTI-ROW) Attributes 23
  170.    3.3.5 Requested Attributes ............................24
  171.    3.3.6 Consumption Attributes ..........................24
  172.    3.3.7 Index Value Attributes ..........................24
  173.  
  174.  3.4 Job Identification ..................................25
  175.  
  176.  3.5 Internationalization Considerations .................25
  177.  
  178.  
  179.  
  180.  
  181. Bergman, Hastings, Isaacson, Lewis                  [Page 3]
  182.  
  183.  
  184.  
  185.  
  186.  
  187.                  Job Monitoring MIB, V0.83     July 14, 1997
  188.  
  189.  
  190.  3.6 IANA Considerations .................................26
  191.    3.6.1 IANA Registration of enums ......................26
  192.      3.6.1.1 Type 1 enumerations..........................26
  193.      3.6.1.2 Type 2 enumerations..........................27
  194.      3.6.1.3 Type 3 enumeration...........................27
  195.    3.6.2 IANA Registration of type 2 bit values ..........27
  196.    3.6.3 IANA Registration of Job Submission Id Formats ..28
  197.    3.6.4 IANA Registration of MIME types/sub-types for document-formats
  198.     ......................................................28
  199.  
  200.  3.7 Security Considerations .............................28
  201.    3.7.1 Read-Write objects ..............................28
  202.    3.7.2 Read-Only Objects In Other User's Jobs ..........28
  203.  
  204.  3.8 Values for Objects ..................................22
  205.  
  206.  3.9 Notification-s ......................................29
  207.  
  208.  
  209. 4. MIB SPECIFICATION......................................29
  210.  
  211.  Textual conventions for this MIB module .................31
  212.    JmTimeStampTC - simple time in seconds ................31
  213.    JmJobSourcePlatformTypeTC - operating system platform definitions  31
  214.    JmFinishingTC - device finishing definitions ..........32
  215.    JmPrintQualityTC - print quality ......................34
  216.    JmPrinterResolutionTC - printer resolution ............34
  217.    JmTonerEconomyTC - toner economy setting ..............36
  218.    JmBooleanTC - Boolean value ...........................36
  219.    JmMediumTypeTC - medium type definitions ..............36
  220.    JmJobSubmissionIDTypeTC - job submission ID type definitions 38
  221.    JmJobStateTC - job state definitions ..................40
  222.    JmAttributeTypeTC - attribute type definitions ........43
  223.       other   (Int32(-2..) and/or Octets63) ..............43
  224.      Job State attributes.................................44
  225.       jobStateReasons2   (JmJobStateReasons2TC) ..........44
  226.       jobStateReasons3   (JmJobStateReasons3TC) ..........44
  227.       jobStateReasons4   (JmJobStateReasons4TC) ..........44
  228.       processingMessage   (Octets63) .....................44
  229.      Job Identification attributes........................44
  230.       jobAccountName   (Octets63) ........................45
  231.       serverAssignedJobName   (Octets63) .................45
  232.       jobName   (Octets63) ...............................45
  233.       jobServiceTypes   (JmJobServiceTypesTC) ............46
  234.       jobSourceChannelIndex   (Int32(0..)) ...............46
  235.       jobSourcePlatformType   (JmJobSourcePlatformTypeTC) 46
  236.       submittingServerName   (Octets63) ..................47
  237.       submittingApplicationName   (Octets63) .............47
  238.  
  239.  
  240.  
  241. Bergman, Hastings, Isaacson, Lewis                  [Page 4]
  242.  
  243.  
  244.  
  245.  
  246.  
  247.                  Job Monitoring MIB, V0.83     July 14, 1997
  248.  
  249.  
  250.       jobOriginatingHost   (Octets63) ....................47
  251.       deviceNameRequested   (Octets63) ...................47
  252.       queueNameRequested   (Octets63) ....................47
  253.       physicalDevice   (hrDeviceIndex and/or Octets63) ...48
  254.       numberOfDocuments   (Int32(-2..)) ..................48
  255.       fileName   (Octets63) ..............................48
  256.       documentName   (Octets63) ..........................48
  257.       jobComment   (Octets63) ............................48
  258.       documentFormatIndex   (Int32(0..)) .................49
  259.       documentFormat   (PrtInterpreterLangFamilyTC and/or Octets63) 49
  260.      Job Parameter attributes.............................49
  261.       jobPriority   (Int32(1..100)) ......................50
  262.       jobProcessAfterDateAndTime   (DateAndTime) .........50
  263.       jobHold   (JmBooleanTC) ............................50
  264.       jobHoldUntil   (Octets63) ..........................50
  265.       outputBin   (Int32(0..) and/or Octets63) ...........51
  266.       sides   (Int32(-2..2)) .............................51
  267.       finishing   (JmFinishingTC) ........................51
  268.      Image Quality attributes (requested and used)........51
  269.       printQualityRequested   (JmPrintQualityTC) .........51
  270.       printQualityUsed   (JmPrintQualityTC) ..............51
  271.       printerResolutionRequested   (JmPrinterResolutionTC)51
  272.       printerResolutionUsed   (JmPrinterResolutionTC) ....52
  273.       tonerEcomonyRequested   (JmTonerEconomyTC) .........52
  274.       tonerEcomonyUsed   (JmTonerEconomyTC) ..............52
  275.       tonerDensityRequested   (Int32(-2..100)) ...........52
  276.       tonerDensityUsed   (Int32(-2..100)) ................52
  277.      Job Progress attributes (requested and consumed).....52
  278.       jobCopiesRequested   (Int32(-2..)) .................53
  279.       jobCopiesCompleted   (Int32(-2..)) .................53
  280.       documentCopiesRequested   (Int32(-2..)) ............53
  281.       documentCopiesCompleted   (Int32(-2..)) ............53
  282.       jobKOctetsTransferred   (Int32(-2..)) ..............53
  283.      Impression attributes (requested and consumed).......54
  284.       impressionsSpooled   (Int32(-2..)) .................54
  285.       impressionsSentToDevice   (Int32(-2..)) ............54
  286.       impressionsInterpreted   (Int32(-2..)) .............54
  287.       impressionsCompletedCurrentCopy   (Int32(-2..)) ....54
  288.       fullColorImpressionsCompleted   (Int32(-2..)) ......55
  289.       highlightColorImpressionsCompleted   (Int32(-2..)) .55
  290.      Page attributes (requested and consumed).............55
  291.       pagesRequested   (Int32(-2..)) .....................55
  292.       pagesCompleted   (Int32(-2..)) .....................55
  293.       pagesCompletedCurrentCopy   (Int32(-2..)) ..........56
  294.      Sheet attributes (requested and consumed)............56
  295.       sheetsRequested   (Int32(-2..)) ....................56
  296.       sheetsCompleted   (Int32(-2..)) ....................56
  297.       sheetsCompletedCurrentCopy   (Int32(-2..)) .........56
  298.  
  299.  
  300.  
  301. Bergman, Hastings, Isaacson, Lewis                  [Page 5]
  302.  
  303.  
  304.  
  305.  
  306.  
  307.                  Job Monitoring MIB, V0.83     July 14, 1997
  308.  
  309.  
  310.      Resource attributes (requested and consumed).........56
  311.       mediumRequested   (JmMediumTypeTC and/or Octets63) .57
  312.       mediumConsumed   (Octets63) ........................57
  313.       colorantRequested   (Int32(-2..) and/or Octets63) ..57
  314.       colorantConsumed   (Int32(-2..) and/or Octets63) ...57
  315.      Time attributes (set by server or device)............57
  316.       jobSubmissionToServerTime   (JmTimeStampTC and/or DateAndTime)  58
  317.       jobSubmissionTime   (JmTimeStampTC and/or DateAndTime)  58
  318.       jobStartedBeingHeldTime   (JmTimeStampTC and/or DateAndTime)  58
  319.       jobStartedProcessingTime   (JmTimeStampTC and/or DateAndTime) 59
  320.       jobCompletedTime   (JmTimeStampTC and/or DateAndTime)59
  321.       jobProcessingCPUTime   (Int32(-2..)) ...............59
  322.    JmJobServiceTypesTC - bit encoded job service type definitions 61
  323.    JmJobStateReasons1TC - additional information about job states 63
  324.    JmJobStateReasons2TC - More additional information about job states
  325.     ......................................................66
  326.    JmJobStateReasons3TC - More additional information about job states
  327.     ......................................................70
  328.    JmJobStateReasons4TC - More additional information about job states
  329.     ......................................................71
  330.  
  331.  The General Group (MANDATORY) ...........................73
  332.    jmGeneralJobSetIndex   (Int32(1..32767)) ..............73
  333.    jmGeneralNumberOfActiveJobs   (Int32(0..)) ............74
  334.    jmGeneralOldestActiveJobIndex   (Int32(0..)) ..........74
  335.    jmGeneralNewestActiveJobIndex   (Int32(0..)) ..........75
  336.    jmGeneralJobPersistence   (Int32(15..)) ...............75
  337.    jmGeneralAttributePersistence   (Int32(15..)) .........76
  338.    jmGeneralJobSetName   (Octets63) ......................76
  339.  
  340.  The Job ID Group (MANDATORY) ............................76
  341.    jmJobSubmissionID   (OCTET STRING(SIZE(48))) ..........77
  342.    jmJobIDJobSetIndex   (Int32(1..32767)) ................78
  343.    jmJobIDJobIndex   (Int32(1..)) ........................79
  344.  
  345.  The Job Group (MANDATORY) ...............................79
  346.    jmJobIndex   (Int32(1..)) .............................80
  347.    jmJobState   (JmJobStateTC) ...........................80
  348.    jmJobStateReasons1   (JmJobStateReasons1TC) ...........81
  349.    jmNumberOfInterveningJobs   (Int32(-2..)) .............81
  350.    jmJobKOctetsRequested   (Int32(-2..)) .................82
  351.    jmJobKOctetsProcessed   (Int32(-2..)) .................82
  352.    jmJobImpressionsRequested   (Int32(-2..)) .............83
  353.    jmJobImpressionsCompleted   (Int32(-2..)) .............83
  354.    jmJobOwner   (Octets63) ...............................83
  355.  
  356.  The Attribute Group (MANDATORY) .........................84
  357.    jmAttributeTypeIndex   (JmAttributeTypeTC) ............85
  358.  
  359.  
  360.  
  361. Bergman, Hastings, Isaacson, Lewis                  [Page 6]
  362.  
  363.  
  364.  
  365.  
  366.  
  367.                  Job Monitoring MIB, V0.83     July 14, 1997
  368.  
  369.  
  370.    jmAttributeInstanceIndex   (Int32(1..32767)) ..........86
  371.    jmAttributeValueAsInteger   (Int32(-2..)) .............86
  372.    jmAttributeValueAsOctets   (Octets63) .................87
  373.  
  374.  
  375. 5. APPENDIX A - IMPLEMENTING THE JOB LIFE CYCLE...........91
  376.  
  377.  
  378. 6. APPENDIX B - SUPPORT OF THE JOB SUBMISSION ID IN JOB SUBMISSION
  379. PROTOCOLS.................................................92
  380.  
  381.  6.1 Hewlett-Packard's Printer Job Language (PJL) ........92
  382.  
  383.  6.2 ISO DPA .............................................92
  384.  
  385.  
  386. 7. REFERENCES.............................................92
  387.  
  388.  
  389. 8. AUTHOR'S ADDRESSES.....................................93
  390.  
  391.  
  392. 9. INDEX..................................................96
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405.  
  406.  
  407.  
  408.  
  409.  
  410.  
  411.  
  412.  
  413.  
  414.  
  415.  
  416.  
  417.  
  418.  
  419.  
  420.  
  421. Bergman, Hastings, Isaacson, Lewis                  [Page 7]
  422.  
  423.  
  424.  
  425.  
  426.  
  427.                  Job Monitoring MIB, V0.83     July 14, 1997
  428.  
  429.  
  430.  
  431.                            Job Monitoring MIB
  432.  
  433. 1. Introduction
  434.  
  435. The Job Monitoring MIB is intended to be implemented by an agent within
  436. a printer or the first server closest to the printer, where the printer
  437. is either directly connected to the server only or the printer does not
  438. contain the job monitoring MIB agent.  It is recommended that
  439. implementations place the SNMP agent as close as possible to the
  440. processing of the print job.  This MIB applies to printers with and
  441. without spooling capabilities.  This MIB is designed to be compatible
  442. with most current commonly-used job submission protocols.  In most
  443. environments that support high function job submission/job control
  444. protocols, like ISO DPA[iso-dpa], those protocols would be used to
  445. monitor and manage print jobs rather than using the Job Monitoring MIB.
  446.  
  447. The Job Monitoring MIB consists of a 7-object General Group, a 2-object
  448. Job Submission ID Group, a 7-object Job Group, and a 2-object Attribute
  449. Group.  Each group is a table.  The General Group contains general
  450. information that applies to all jobs in a job set.  The Job Submission
  451. ID table maps the job submission ID that the client uses to identify a
  452. job to the jmJobIndex that the Job Monitoring Agent uses to identify
  453. jobs in the Job and Attribute tables.  The Job table contains the
  454. MANDATORY integer job state and status objects.  The Attribute table
  455. consists of multiple entries per job that specify (1) job and document
  456. identification and parameters,  (2) requested resources, and (3)
  457. consumed resources during and after job processing/printing.  Sixty five
  458. job attributes are defined as textual conventions that an agent SHALL
  459. return if the server or device implements the functionality so
  460. represented and the agent has access to the information.
  461.  
  462. 1.1 Types of Information in the MIB
  463.  
  464. The job MIB is intended to provide the following information for the
  465. indicated Role Models in the Printer MIB[print-mib] (Appendix D - Roles
  466. of Users).
  467.  
  468.    User:
  469.  
  470.       Provide the ability to identify the least busy printer.  The user
  471.       will be able to determine the number and size of jobs waiting for
  472.       each printer.  No attempt is made to actually predict the length
  473.       of time that jobs will take.
  474.  
  475.       Provide the ability to identify the current status of the user's
  476.       job (user queries).
  477.  
  478.  
  479.  
  480.  
  481. Bergman, Hastings, Isaacson, Lewis                  [Page 8]
  482.  
  483.  
  484.  
  485.  
  486.  
  487.                  Job Monitoring MIB, V0.83     July 14, 1997
  488.  
  489.  
  490.       Provide a timely indication that the job has completed and where
  491.       it can be found.
  492.  
  493.       Provide error and diagnostic information for jobs that did not
  494.       successfully complete.
  495.  
  496.    Operator:
  497.  
  498.       Provide a presentation of the state of all the jobs in the print
  499.       system.
  500.  
  501.       Provide the ability to identify the user that submitted the print
  502.       job.
  503.  
  504.       Provide the ability to identify the resources required by each
  505.       job.
  506.  
  507.       Provide the ability to define which physical printers are
  508.       candidates for the print job.
  509.  
  510.       Provide some idea of how long each job will take.  However, exact
  511.       estimates of time to process a job is not being attempted.
  512.       Instead, objects are included that allow the operator to be able
  513.       to make gross estimates.
  514.  
  515.    Capacity Planner:
  516.  
  517.       Provide the ability to determine printer utilization as a function
  518.       of time.
  519.  
  520.       Provide the ability to determine how long jobs wait before
  521.       starting to print.
  522.  
  523.    Accountant:
  524.  
  525.       Provide information to allow the creation of a record of resources
  526.       consumed and printer usage data for charging users or groups for
  527.       resources consumed.
  528.  
  529.       Provide information to allow the prediction of consumable usage
  530.       and resource need.
  531.  
  532. The MIB supports printers that can contain more than one job at a time,
  533. but still be usable for low end printers that only contain a single job
  534. at a time.  In particular, the MIB supports the needs of Windows and
  535. other PC environments for managing low-end networked devices without
  536. unnecessary overhead or complexity, while also providing for higher end
  537. systems and devices.
  538.  
  539.  
  540.  
  541. Bergman, Hastings, Isaacson, Lewis                  [Page 9]
  542.  
  543.  
  544.  
  545.  
  546.  
  547.                  Job Monitoring MIB, V0.83     July 14, 1997
  548.  
  549.  
  550. 1.2 Types of Job Monitoring Applications
  551.  
  552. The Job Monitoring MIB is designed for the following types of monitoring
  553. applications:
  554.  
  555.   1.Monitor a single job starting when the job is submitted and
  556.     finishing a defined period after the job completes.  The Job
  557.     Submission ID table provides the map to find the specific job to be
  558.     monitored.
  559.  
  560.   2.Monitor all 'active' jobs in a queue, which this specification
  561.     generalizes to a "job set".  End users may use such a program when
  562.     selecting a least busy printer, so the MIB is designed for such a
  563.     program to start up quickly and find the information needed quickly
  564.     without having to read all (completed) jobs in order to find the
  565.     active jobs.  System operators may also use such a program, in
  566.     which case it would be running for a long period of time and may
  567.     also be interested in the jobs that have completed.  Finally such a
  568.     program may be used to provide an enhanced console and logging
  569.     capability.
  570.  
  571.   3.Collect resource usage for accounting or system utilization
  572.     purposes that copy the completed job statistics to an accounting
  573.     system. It is recognized that depending on accounting programs to
  574.     copy MIB data during the job-retention period is somewhat
  575.     unreliable, since the accounting program may not be running (or may
  576.     have crashed).  Such a program is also expected to keep a shadow
  577.     copy of the entire Job Attribute table including completed,
  578.     canceled, and aborted jobs which the program updates on each
  579.     polling cycle.  Such a program polls at the rate of the persistence
  580.     of the Attribute table.  The design is not optimized to help such
  581.     an application determine which jobs are completed, canceled, or
  582.     aborted.  Instead, the application SHALL query each job that the
  583.     application's shadow copy shows was not complete, canceled, or
  584.     aborted at the previous poll cycle to see if it is now complete or
  585.     canceled, plus any new jobs that have been submitted.
  586.  
  587. The MIB provides a set of objects that represent a compatible subset of
  588. job and document attributes of the ISO DPA standard[iso-dpa] and the
  589. Internet Printing Protocol (IPP)[ipp-model], so that coherence is
  590. maintained between these two protocols and the information presented to
  591. end users and system operators by monitoring applications.  However, the
  592. job monitoring MIB is intended to be used with printers that implement
  593. other job submitting and management protocols, such as IEEE 1284.1
  594. (TIPSI)[tipsi], as well as with ones that do implement ISO DPA.  Thus
  595. the job monitoring MIB does not require implementation of either the ISO
  596. DPA or IPP protocols.
  597.  
  598.  
  599.  
  600.  
  601. Bergman, Hastings, Isaacson, Lewis                 [Page 10]
  602.  
  603.  
  604.  
  605.  
  606.  
  607.                  Job Monitoring MIB, V0.83     July 14, 1997
  608.  
  609.  
  610. The MIB is designed so that an additional MIB(s) can be specified in the
  611. future for  monitoring  multi-function  (scan, FAX,  copy)  jobs  as  an
  612. augmentation to this MIB.
  613.  
  614. 2. Terminology and Job Model
  615.  
  616. This section defines the terms that are used in this specification and
  617. the general model for jobs.
  618.  
  619.   NOTE - Existing systems use conflicting terms, so these terms are
  620.   drawn from the ISO 10175 Document Printing Application (DPA)
  621.   standard[iso-dpa].  For example, PostScript systems use the term
  622.   session for what we call a job in this specification and the term job
  623.   to mean what we call a document in this specification.  PJL systems
  624.   use the term job to mean what we call a job in this specification.
  625.   PJL also supports multiple documents per job, but does not support
  626.   specifying per-document attributes independently for each document.
  627.  
  628. Job:  a unit of work whose results are expected together without
  629. interjection of unrelated results.  A job contains one or more
  630. documents.
  631.  
  632. Job set:  a group of jobs that are queued and scheduled together
  633. according to a specified scheduling algorithm for a specified device or
  634. set of devices.  For implementations that embed the SNMP agent in the
  635. device, the MIB job set normally represents all the jobs known to the
  636. device, so that the implementation only implements a single job set.  If
  637. the SNMP agent is implemented in a server that controls one or more
  638. devices, each MIB job set represents a job queue for (1) a specific
  639. device or (2) set of devices, if the server uses a single queue to load
  640. balance between several devices.  Each job set is disjoint; no job SHALL
  641. be represented in more than one MIB job set.
  642.  
  643. Document:  a sub-section within a job that contains print data and
  644. document instructions that apply to just the document.
  645.  
  646. Client:  the network entity that end users use to submit jobs to
  647. spoolers, servers, or printers and other devices, depending on the
  648. configuration, using any job submission protocol.
  649.  
  650. Server:  a network entity that accepts jobs from clients and in turn
  651. submits the jobs to printers and other devices.  A server MAY be a
  652. printer supervisor control program, or a print spooler.
  653.  
  654. Device:  a hardware entity that (1) interfaces to humans in human
  655. perceptible means, such as produces marks on paper, scans marks on paper
  656. to produce an electronic representations, or writes CD-ROMs or (2)
  657. interfaces to a network, such as sends FAX data to another FAX device.
  658.  
  659.  
  660.  
  661. Bergman, Hastings, Isaacson, Lewis                 [Page 11]
  662.  
  663.  
  664.  
  665.  
  666.  
  667.                  Job Monitoring MIB, V0.83     July 14, 1997
  668.  
  669.  
  670. Printer:  a device that puts marks on media.
  671.  
  672. Supervisor:  a server that contains a control program that controls a
  673. printer or other device.  A supervisor is a client to the printer or
  674. other device.
  675.  
  676. Spooler:  a server that accepts jobs, spools the data, and decides when
  677. and on which printer to print the job.  A spooler is a client to a
  678. printer or a printer supervisor, depending on implementation.
  679.  
  680. Spooling:  the act of a device or server of (1) accepting jobs and (2)
  681. writing the job's attributes and document data on to secondary storage.
  682.  
  683. Queuing:  the act of a device or server of ordering (queuing) the jobs
  684. for the purposes of scheduling the jobs to be processed.
  685.  
  686. Monitor or Job Monitoring Application:  the SNMP management application
  687. that End Users, and System Operators use to monitor jobs using SNMP.  A
  688. monitor MAY be either a separate application or MAY be part of the
  689. client that also submits jobs.
  690.  
  691. Accounting Application:  the SNMP management application that copies job
  692. information to some more permanent medium so that another application
  693. can perform accounting on the data for Accountants, Asset Managers, and
  694. Capacity Planners use.
  695.  
  696. Agent:  the network entity that accepts SNMP requests from a monitor or
  697. accounting application and provides access to the instrumentation for
  698. managing jobs modeled by the management objects defined in the Job
  699. Monitoring MIB module for a server or a device.
  700.  
  701. Proxy:  an agent that acts as a concentrator for one or more other
  702. agents by accepting SNMP operations on the behalf of one or more other
  703. agents, forwarding them on to those other agents, gathering responses
  704. from those other agents and returning them to the original requesting
  705. monitor.
  706.  
  707. User:  is a person that uses a client or a monitor.
  708.  
  709. End User:  is a user that uses a client to submit a print job.
  710.  
  711. System Operator:  is a user that uses a monitor to monitor the system
  712. and carries out tasks to keep the system running.
  713.  
  714. System Administrator:  is a user that specifies policy for the system.
  715.  
  716. Job Instruction:  is an instruction specifying how, when, or where the
  717. job is to be processed.  Job instructions MAY be passed in the job
  718.  
  719.  
  720.  
  721. Bergman, Hastings, Isaacson, Lewis                 [Page 12]
  722.  
  723.  
  724.  
  725.  
  726.  
  727.                  Job Monitoring MIB, V0.83     July 14, 1997
  728.  
  729.  
  730. submission protocol or MAY be embedded in the document data or a
  731. combination depending on the job submission protocol and implementation.
  732.  
  733. Document Instruction:  is an instruction specifying how to process the
  734. document.  Document instructions MAY be passed in the job submission
  735. protocol separate from the actual document data, or MAY be embedded in
  736. the document data or a combination, depending on the job submission
  737. protocol and implementation.
  738.  
  739. SNMP Information Object:  is a name, value-pair that specifies an
  740. action, a status, or a condition in an SNMP MIB.  Objects are identified
  741. in SNMP by an OBJECT IDENTIFIER.
  742.  
  743. Attribute:  is a name, value-pair that specifies a job or document
  744. instruction, a status, or a condition of a job or a document that has
  745. been submitted to a server or device.  A particular attribute NEED NOT
  746. be present in each job instance.  In other words, attributes are present
  747. in a job instance only when there is a need to express the value, either
  748. because (1) the client supplied a value in the job submission protocol,
  749. (2) the document data contained an embedded attribute, or (3) the server
  750. or device supplied a default value.  An agent SHALL represent an
  751. attribute as an entry (row) in the Attribute table in this MIB in which
  752. entries are present only when necessary.  Attributes are identified in
  753. this MIB by an enum.
  754.  
  755. Job Monitoring (using SNMP):  is (1) identifying jobs within the serial
  756. streams of data being processed by the server, printer or other devices,
  757. (2) creating "rows" in the job table for each job, and (3) recording
  758. information, known by the agent, about the processing of the job in that
  759. "row".
  760.  
  761. Job Accounting:  is recording what happens to the job during the
  762. processing and printing of the job.
  763.  
  764. 2.1 System Configurations for the Job Monitoring MIB
  765.  
  766. This section enumerates the three configurations in which the Job
  767. Monitoring MIB is intended to be used.  To simplify the pictures, the
  768. devices are shown as printers.  See Goals section.
  769.  
  770. The diagram in the Printer MIB[print-mib] entitled: "One Printer's View
  771. of the Network" is assumed for this MIB as well.  Please refer to that
  772. diagram to aid in understanding the following system configurations.
  773.  
  774. 2.1.1 Configuration 1 - client-printer
  775.  
  776. In the client-printer configuration, the client(s) submit jobs directly
  777. to the printer, either by some direct connect, or by network connection.
  778.  
  779.  
  780.  
  781. Bergman, Hastings, Isaacson, Lewis                 [Page 13]
  782.  
  783.  
  784.  
  785.  
  786.  
  787.                  Job Monitoring MIB, V0.83     July 14, 1997
  788.  
  789.  
  790. The client-printer configuration can accommodate multiple job submitting
  791. clients in either of two ways:
  792.  
  793.      1.if each client relinquishes control of the Print Job Delivery
  794.        Channel after each job (or after a number of jobs)
  795.  
  796.      2.if the printer supports more than one Print Job Delivery Channel
  797.  
  798. The job submitting client and/or monitoring application monitor jobs by
  799. communicating directly with an agent that is part of the printer.  The
  800. agent in the Printer SHALL keep the job in the Job Monitoring MIB as
  801. long as the job is in the Printer, plus a defined time period after the
  802. job enters the completed state in which accounting programs can copy out
  803. the accounting data from the Job Monitoring MIB.
  804.  
  805.  
  806.                all         end-user     ######## SNMP query
  807.             +-------+     +--------+    ---- job submission
  808.             |monitor|     | client |
  809.             +---#---+     +--#--+--+
  810.                 #            #  |
  811.                 # ############  |
  812.                 # #             |
  813.          +==+===#=#=+==+        |
  814.          |  | agent |  |        |
  815.          |  +-------+  |        |
  816.          |   PRINTER   <--------+
  817.          |             | Print Job Delivery Channel
  818.          |             |
  819.          +=============+
  820.  
  821. Figure 2-1 - Configuration 1 - client-printer - agent in the printer
  822.  
  823.  
  824. The Job Monitoring MIB is designed to support the following
  825. relationships (not shown in Figure 2-1):
  826.   1.Multiple clients MAY submit jobs to a printer.
  827.   2.Multiple clients MAY monitor a printer.
  828.   3.Multiple monitors MAY monitor a printer.
  829.   4.A client MAY submit jobs to multiple printers.
  830.   5.A monitor MAY monitor multiple printers.
  831.  
  832. 2.1.2 Configuration 2 - client-server-printer - agent in the server
  833.  
  834. In the client-server-printer configuration 2, the client(s) submit jobs
  835. to an intermediate server by some network connection, not directly to
  836. the printer.  While configuration 2 is included, the design center for
  837. this MIB is configurations 1 and 3,
  838.  
  839.  
  840.  
  841. Bergman, Hastings, Isaacson, Lewis                 [Page 14]
  842.  
  843.  
  844.  
  845.  
  846.  
  847.                  Job Monitoring MIB, V0.83     July 14, 1997
  848.  
  849.  
  850. The job submitting client and/or monitoring application monitor job by
  851. communicating directly with:
  852.  
  853.     A Job Monitoring MIB agent that is part of the server (or a front
  854.     for the server)
  855.  
  856. There is no SNMP Job Monitoring MIB agent in the printer in
  857. configuration 2, at least that the client or monitor are aware.  In this
  858. configuration, the agent SHALL return the current values of the objects
  859. in the Job Monitoring MIB both for jobs the server keeps and jobs that
  860. the server has submitted to the printer.  The Job Monitoring MIB agent
  861. SHALL obtain the required information from the printer by a method that
  862. is beyond the scope of this document.  The agent in the server SHALL
  863. keep the job in the Job Monitoring MIB in the server as long as the job
  864. is in the Printer, plus a defined time period after the job enters the
  865. completed state in which accounting programs can copy out the accounting
  866. data from the Job Monitoring MIB.
  867.  
  868.              all          end-user
  869.           +-------+     +----------+
  870.           |monitor|     |  client  |     ######## SNMP query
  871.           +---+---#     +---#----+-+     **** non-SNMP cntrl
  872.                    #        #    |       ---- job submission
  873.                     #       #    |
  874.                      #      #    |
  875.                       #=====#=+==v==+
  876.                       | agent |     |
  877.                       +-------+     |
  878.                       |    server   |
  879.                       +----+-----+--+
  880.                    control *     |
  881.                   **********     |
  882.                   *              |
  883.          +========v====+         |
  884.          |             |         |
  885.          |             |         |
  886.          |   PRINTER   <---------+
  887.          |             | Print Job Delivery Channel
  888.          |             |
  889.          +=============+
  890.  
  891. Figure 2-2 - Configuration 2 - client-server-printer - agent in the
  892. server
  893.  
  894.  
  895. The Job Monitoring MIB is designed to support the following
  896. relationships (not shown in Figure 2-2):
  897.   1.Multiple clients MAY submit jobs to a server.
  898.  
  899.  
  900.  
  901. Bergman, Hastings, Isaacson, Lewis                 [Page 15]
  902.  
  903.  
  904.  
  905.  
  906.  
  907.                  Job Monitoring MIB, V0.83     July 14, 1997
  908.  
  909.  
  910.   2.Multiple clients MAY monitor a server.
  911.   3.Multiple monitors MAY monitor a server.
  912.   4.A client MAY submit jobs to multiple servers.
  913.   5.A monitor MAY monitor multiple servers.
  914.   6.Multiple servers MAY submit jobs to a printer.
  915.   7.Multiple servers MAY control a printer.
  916.  
  917. 2.1.3 Configuration 3 - client-server-printer - client monitors printer
  918. agent and server
  919.  
  920. In the client-server-printer configuration 3, the client(s) submit jobs
  921. to an intermediate server by some network connection, not directly to
  922. the printer.  That server does not contain a Job Monitoring MIB and
  923. agent.
  924.  
  925. The job submitting client and/or monitoring application monitor jobs by
  926. communicating directly with:
  927.  
  928.      1.The server using some undefined protocol to monitor jobs in the
  929.        server (that does not contain the Job Monitoring MIB) AND
  930.  
  931.      2.A Job Monitoring MIB agent that is part of the printer to
  932.        monitor jobs after the server passes the jobs to the printer.
  933.        In such configurations, the server deletes its copy of the job
  934.        from the server after submitting the job to the printer usually
  935.        almost immediately (before the job does much processing, if
  936.        any).
  937.  
  938. In configuration 3, the agent (in the printer) SHALL keep the values of
  939. the objects in the Job Monitoring MIB that the agent implements updated
  940. for a job that the server has submitted to the printer.  The agent SHALL
  941. obtain information about the jobs submitted to the printer from the
  942. server (either in the job submission protocol, in the document data, or
  943. by direct query of the server), in order to populate some of the objects
  944. the Job Monitoring MIB in the printer.  The agent in the printer SHALL
  945. keep the job in the Job Monitoring MIB as long as the job is in the
  946. Printer, and longer in order to implement the completed state in which
  947. monitoring programs can copy out the accounting data from the Job
  948. Monitoring MIB.
  949.  
  950.  
  951.  
  952.  
  953.  
  954.  
  955.  
  956.  
  957.  
  958.  
  959.  
  960.  
  961. Bergman, Hastings, Isaacson, Lewis                 [Page 16]
  962.  
  963.  
  964.  
  965.  
  966.  
  967.                  Job Monitoring MIB, V0.83     July 14, 1997
  968.  
  969.  
  970.  
  971.              all          end-user
  972.           +-------+     +----------+
  973.           |monitor|     |  client  |     ######## SNMP query
  974.           +---+---*     +---*----+-+     **** non-SNMP query
  975.               #    *        *    |       ---- job submission
  976.               #     *       *    |
  977.               #      *      *    |
  978.               #       *=====v====v==+
  979.               #       |             |
  980.               #       |    server   |
  981.               #       |             |
  982.               #       +----#-----+--+
  983.               #    optional#     |
  984.               #   ##########     |
  985.               #   #              |
  986.          +==+=v===v=+==+         |
  987.          |  | agent |  |         |
  988.          |  +-------+  |         |
  989.          |   PRINTER   <---------+
  990.          |             | Print Job Delivery Channel
  991.          |             |
  992.          +=============+
  993.  
  994. Figure 2-3 - Configuration 3 - client-server-printer - client monitors
  995. printer agent and server
  996.  
  997.  
  998. The Job Monitoring MIB is designed to support the following
  999. relationships (not shown in Figure 2-3):
  1000.   1.Multiple clients MAY submit jobs to a server.
  1001.   2.Multiple clients MAY monitor a server.
  1002.   3.Multiple monitors MAY monitor a server.
  1003.   4.A client MAY submit jobs to multiple servers.
  1004.   5.A monitor MAY monitor multiple servers.
  1005.   6.Multiple servers MAY submit jobs to a printer.
  1006.   7.Multiple servers MAY control a printer.
  1007.  
  1008. 3. Managed Object Usage
  1009.  
  1010. This section describes the usage of the objects in the MIB.
  1011.  
  1012. 3.1 Conformance Considerations
  1013.  
  1014. In order to achieve interoperability between job monitoring applications
  1015. and job monitoring agents, this specification includes the conformance
  1016. requirements for both monitoring applications and agents.
  1017.  
  1018.  
  1019.  
  1020.  
  1021. Bergman, Hastings, Isaacson, Lewis                 [Page 17]
  1022.  
  1023.  
  1024.  
  1025.  
  1026.  
  1027.                  Job Monitoring MIB, V0.83     July 14, 1997
  1028.  
  1029.  
  1030. 3.1.1 Conformance Terminology
  1031.  
  1032. This specification uses the verbs: "SHALL", "SHOULD", "MAY", and "NEED
  1033. NOT" to specify conformance requirements according to RFC 2119 [req-
  1034. words] as follows:
  1035.  
  1036.   . "SHALL":  indicates an action that the subject of the sentence must
  1037.     implement in order to claim conformance to this specification
  1038.  
  1039.   . "MAY":  indicates an action that the subject of the sentence does
  1040.     not have to implement in order to claim conformance to this
  1041.     specification, in other words that action is an implementation
  1042.     option
  1043.  
  1044.   . "NEED NOT":  indicates an action that the subject of the sentence
  1045.     does not have to implement in order to claim conformance to this
  1046.     specification.  The verb "NEED NOT" is used instead of "may not",
  1047.     since "may not" sounds like a prohibition.
  1048.  
  1049.   . "SHOULD":  indicates an action that is recommended for the subject
  1050.     of the sentence to implement, but is not required, in order to
  1051.     claim conformance to this specification.
  1052.  
  1053. 3.1.2 Agent Conformance Requirements
  1054.  
  1055. A conforming agent:
  1056.  
  1057. 1.SHALL implement all MANDATORY groups in this specification.
  1058.  
  1059. 2.SHALL implement any attributes if (1) the server or device supports
  1060.   the functionality represented by the attribute and (2) the
  1061.   information is available to the agent.
  1062.  
  1063. 3.SHOULD implement both forms of an attribute if it implements an
  1064.   attribute that permits a choice of INTEGER and OCTET STRING forms,
  1065.   since implementing both forms may help management applications by
  1066.   giving them a choice of representations, since the representation are
  1067.   equivalent.  See the JmAttributeTypeTC textual-convention.
  1068.  
  1069.   NOTE - This MIB, like the Printer MIB, is written following the
  1070.   subset of SMIv2 that can be supported by SMIv1 and SNMPv1
  1071.   implementations.
  1072.  
  1073. 3.1.2.1 MIB II System Group objects
  1074.  
  1075. The Job Monitoring MIB agent SHALL implement all objects in the System
  1076. Group of MIB-II[mib-II], whether the Printer MIB[print-mib] is
  1077. implemented or not.
  1078.  
  1079.  
  1080.  
  1081. Bergman, Hastings, Isaacson, Lewis                 [Page 18]
  1082.  
  1083.  
  1084.  
  1085.  
  1086.  
  1087.                  Job Monitoring MIB, V0.83     July 14, 1997
  1088.  
  1089.  
  1090. 3.1.2.2 MIB II Interface Group objects
  1091.  
  1092. The Job Monitoring MIB agent SHALL implement all objects in the
  1093. Interfaces Group of MIB-II[mib-II], whether the Printer MIB[print-mib]
  1094. is implemented or not.
  1095.  
  1096. 3.1.2.3 Printer MIB objects
  1097.  
  1098. If the agent is providing access to a device that is a printer, the
  1099. agent SHALL implement all of the MANDATORY objects in the Printer
  1100. MIB[print-mib] and all the objects in other MIBs that conformance to the
  1101. Printer MIB requires, such as the Host Resources MIB[hr-mib].  If the
  1102. agent is providing access to a server that controls one or more
  1103. networked printers, the agent NEED NOT implement the Printer MIB and
  1104. NEED NOT implement the Host Resources MIB.
  1105.  
  1106. 3.1.3 Job Monitoring Application Conformance Requirements
  1107.  
  1108. A conforming job monitoring application:
  1109.  
  1110. 1.SHALL accept the full syntactic range for all objects in all
  1111.   MANDATORY groups and all MANDATORY attributes that are required to be
  1112.   implemented by an agent according to Section 3.1.2 and SHALL either
  1113.   present them to the user or ignore them.
  1114.  
  1115. 2.SHALL accept the full syntactic range for all attributes, including
  1116.   enum and bit values specified in this specification and additional
  1117.   ones that may be registered with IANA and SHALL either present them
  1118.   to the user or ignore them.  In particular, a conforming job
  1119.   monitoring application SHALL not malfunction when receiving any
  1120.   standard or registered enum or bit values.  See Section 3.6 entitled
  1121.   "IANA Considerations".
  1122.  
  1123. 3.SHALL NOT fail when operating with agents that materialize attributes
  1124.   after the job has been submitted, as opposed to when the job is
  1125.   submitted.
  1126.  
  1127. 4.SHALL, if it supports a time attribute, accept either form of the
  1128.   time attribute, since agents are free to implement either time form.
  1129.  
  1130. 3.2 The Job Tables and the Oldest Active and Newest Active Indexes
  1131.  
  1132. The jmJobTable and jmAttributeTable contain objects and attributes,
  1133. respectively, for each job in a job set.  These first two indexes are:
  1134.  
  1135.   1.jmGeneralJobSetIndex - which job set
  1136.  
  1137.   2.jmJobIndex - which job in the job set
  1138.  
  1139.  
  1140.  
  1141. Bergman, Hastings, Isaacson, Lewis                 [Page 19]
  1142.  
  1143.  
  1144.  
  1145.  
  1146.  
  1147.                  Job Monitoring MIB, V0.83     July 14, 1997
  1148.  
  1149.  
  1150. In order for a monitoring application to quickly find that active jobs
  1151. (jobs in the pending, processing, or processingStopped states), the MIB
  1152. contains two indexes:
  1153.  
  1154.   1.jmGeneralOldestActiveJobIndex - the index of the active job that
  1155.     has been in the tables the longest.
  1156.  
  1157.   2.jmGeneralNewestActiveJobIndex - the index of the active job that
  1158.     has been most recently added to the tables.
  1159.  
  1160. When a new job is accepted by the server or device that the agent is
  1161. providing access to , the agent SHALL assign the next available value to
  1162. the job's jmJobIndex that is used for storing job information in the
  1163. jmJobTable and the jmAttributeTable.  If the value would exceed the
  1164. implementation-defined maximum value for jmJobIndex, the agent SHALL set
  1165. the value back to 1, i.e., 'wrap' around to the beginning of the job
  1166. tables.
  1167.  
  1168. It is recommended that the largest value for jmJobIndex be much larger
  1169. than the maximum number of jobs that the implementation can contain at a
  1170. single time, so as to minimize the pre-mature re-use of jmJobIndex value
  1171. for a newer job while clients retain the same 'stale' value for an older
  1172. job.
  1173.  
  1174. Each time a new job is accepted by the server or device that the agent
  1175. is providing access to AND that job is to be 'active' (pending,
  1176. processing, or processingStopped, but not pendingHeld), the agent SHALL
  1177. copy the value of the job's jmJobIndex to the
  1178. jmGeneralNewestActiveJobIndex object.  If the new job is to be
  1179. 'inactive' (pendingHeld state), the agent SHALL not change the value of
  1180. jmGeneralNewestActiveJobIndex object.
  1181.  
  1182. When a job transitions from one of the 'active' states (pending,
  1183. processing, processingStopped) to one of the 'inactive' states
  1184. (pendingHeld, completed, canceled, or aborted), with a jmJobIndex value
  1185. that matches the jmGeneralOldestActiveJobIndex object, the agent SHALL
  1186. advance (or wrap) the value to the next oldest 'active' job, if any.
  1187.  
  1188. Whenever a job changes from 'inactive' to 'active' (from pendingHeld to
  1189. pending or processing), the agent SHALL update the value of either the
  1190. jmGeneralOldestActiveJobIndex or the jmGeneralNewestActiveJobIndex
  1191. objects, or both, if the job's jmJobIndex value is outside the range
  1192. between jmGeneralOldestActiveJobIndex and jmGeneralNewestActiveJobIndex.
  1193.  
  1194. When all jobs become 'inactive', i.e., enter the pendingHeld, completed,
  1195. canceled, or aborted states, the agent SHALL set the value of both the
  1196. jmGeneralOldestActiveJobIndex and jmGeneralNewestActiveJobIndex objects
  1197. to 0.
  1198.  
  1199.  
  1200.  
  1201. Bergman, Hastings, Isaacson, Lewis                 [Page 20]
  1202.  
  1203.  
  1204.  
  1205.  
  1206.  
  1207.                  Job Monitoring MIB, V0.83     July 14, 1997
  1208.  
  1209.  
  1210. NOTE - Applications that wish to efficiently access all of the active
  1211. jobs MAY use jmGeneralOldestActiveJobIndex value to start with the
  1212. oldest active job and continue until they reach the index value equal to
  1213. jmGeneralNewestActiveJobIndex, skipping over any pendingHeld, completed,
  1214. canceled, or aborted jobs that might intervene.
  1215.  
  1216. If an application detects that the jmGeneralNewestActiveJobIndex is
  1217. smaller than jmGeneralOldestActiveJobIndex, the job index has wrapped.
  1218. In this case, when the application detects that the returned OID is in a
  1219. different MIB (Get Next has moved to the next MIB in the agent), the
  1220. application SHALL start over at 1 and continue the GetNext operations to
  1221. find the rest of the active jobs.
  1222.  
  1223. When the server or device is power-cycled, the agent SHALL remember the
  1224. next jmJobIndex value to be assigned, so that new jobs are not assigned
  1225. the same jmJobIndex as recent jobs before the power cycle.
  1226.  
  1227. 3.3 The Attribute Mechanism
  1228.  
  1229. Attributes are similar to information objects, except that attributes
  1230. are identified by an enum, instead of an OID, so that attributes may be
  1231. registered without requiring a new MIB.  Also an implementation that
  1232. does not have the functionality represented by the attribute can omit
  1233. the attribute entirely, rather than having to return a distinguished
  1234. value.  The agent is free to materialize an attribute in the
  1235. jmAttributeTable as soon as the agent is aware of the value of the
  1236. attribute.
  1237.  
  1238. The agent materializes job attributes in a four-indexed
  1239. jmAttributeTable:
  1240.  
  1241.   1.jmGeneralJobSetIndex - which job set
  1242.  
  1243.   2.jmJobIndex - which job in the job set
  1244.  
  1245.   3.jmAttributeTypeIndex - which attribute
  1246.  
  1247.   4.jmAttributeInstanceIndex - which attribute instance for those
  1248.     attributes that can have multiple values per job.
  1249.  
  1250. Some attributes represent information about a job, such as a file-name,
  1251. a document-name, a submission-time or a completion time.  Other
  1252. attributes represent resources required, e.g., a medium or a colorant,
  1253. etc. to process the job before the job starts processing OR to indicate
  1254. the amount of the resource consumed during and after processing, e.g.,
  1255. pages completed or impressions completed.  If both a required and a
  1256. consumed value of a resource is needed, this specification assigns two
  1257. separate attribute enums in the textual convention.
  1258.  
  1259.  
  1260.  
  1261. Bergman, Hastings, Isaacson, Lewis                 [Page 21]
  1262.  
  1263.  
  1264.  
  1265.  
  1266.  
  1267.                  Job Monitoring MIB, V0.83     July 14, 1997
  1268.  
  1269.  
  1270. NOTE - The table of contents lists all the attributes in order.  This
  1271. order is the order of enum assignments which is the order that the SNMP
  1272. GetNext operation returns attributes.  Most attributes apply to all
  1273. three configurations covered by this MIB specification (see section 2.1
  1274. entitled "System Configurations for the Job Monitoring MIB").  Those
  1275. attribute that apply to a particular configuration are indicated as
  1276. 'Configuration n:' and SHALL NOT be used with other configurations.
  1277.  
  1278. 3.3.1 Conformance of Attribute Implementation
  1279.  
  1280. An agent SHALL implement any attribute if (1) the server or device
  1281. supports the functionality represented by the attribute and (2) the
  1282. information is available to the agent.  The agent MAY create the
  1283. attribute row in the jmAttributeTable when the information is available
  1284. or MAY create the row earlier with the designated 'unknown' value
  1285. appropriate for that attribute.  See next section.
  1286.  
  1287. If the server or device does not implement or does not provide access to
  1288. the information about an attribute, the agent SHOULD NOT create the
  1289. corresponding row in the jmAttributeTable.
  1290.  
  1291. 3.3.2 Useful, 'Unknown', and 'Other' Values for Objects and Attributes
  1292.  
  1293. Some attributes have a 'useful' INTEGER32 value, some have a 'useful'
  1294. OCTET STRING value, some MAY have either or both depending on
  1295. implementation, and some MUST have both.  See the JmAttributeTypeTC
  1296. textual convention for the specification of each attribute.
  1297.  
  1298. SNMP requires that if an object cannot be implemented because its values
  1299. cannot be accessed, then a compliant agent SHALL return an SNMP error in
  1300. SNMPv1 or an exception value in SNMPv2.  However, this MIB has been
  1301. designed so that 'all' objects can and SHALL be implemented by an agent,
  1302. so that neither the SNMPv1 error nor the SNMPv2 exception value SHALL be
  1303. generated by the agent.  This MIB has also been designed so that when an
  1304. agent materializes an attribute, the agent SHALL materialize a row
  1305. consisting of both the jmAttributeValueAsInteger and
  1306. jmAttributeValueAsOctets objects.
  1307.  
  1308. In general, values for objects and attributes have been chosen so that a
  1309. management application will be able to determine whether a 'useful',
  1310. 'unknown', or 'other' value is available.  When a useful value is not
  1311. available for an object that agent SHALL return a zero-length string for
  1312. octet strings, the value 'unknown(2)' for enums, a '0' value for an
  1313. object that represents an index in another table, and a value '-2' for
  1314. counting integers.
  1315.  
  1316. Since each attribute is represented by a row consisting of both the
  1317. jmAttributeValueAsInteger and jmAttributeValueAsOctets MANDATORY
  1318.  
  1319.  
  1320.  
  1321. Bergman, Hastings, Isaacson, Lewis                 [Page 22]
  1322.  
  1323.  
  1324.  
  1325.  
  1326.  
  1327.                  Job Monitoring MIB, V0.83     July 14, 1997
  1328.  
  1329.  
  1330. objects, SNMP requires that the agent SHALL always create an attribute
  1331. row with both objects specified.  However, for most attributes the agent
  1332. SHALL return a "useful" value for one of the objects and SHALL return
  1333. the 'other' value for the other object.  For integer only attributes,
  1334. the agent SHALL always return a zero-length string value for the
  1335. jmAttributeValueAsOctets object.  For octet string only attributes, the
  1336. agent SHALL always return a '-1' value for the jmAttributeValueAsInteger
  1337. object.
  1338.  
  1339. 3.3.3 Data Sub-types and Attribute Naming Conventions
  1340.  
  1341. Many attributes are sub-typed to give a more specific data sub-type than
  1342. Integer32 or OCTET STRING.  The data sub-type of each attribute is
  1343. indicated on the first line(s) of the description.  Some attributes have
  1344. several different data sub-type representations.  When an attribute has
  1345. both an Integer32 data sub-type and an OCTET STRING data sub-type, the
  1346. attribute can be represented in a single row in the jmAttributeTable.
  1347. In this case, the data sub-type name is not included as the last part of
  1348. the name of the attribute, e.g., documentFormat(38) which is both an
  1349. enum and/or a name.  When the data sub-types cannot be represented by a
  1350. single row in the jmAttributeTable, each such representation is
  1351. considered a separate attribute and is assigned a separate name and enum
  1352. value.  For these attributes, the name of the data sub-type is the last
  1353. part of the name of the attribute: Name, Index, DateAndTime, TimeStamp,
  1354. etc.  For example, documentFormatIndex(37) in an index.
  1355.  
  1356. NOTE: The Table of Contents also lists the data sub-type and/or data
  1357. sub-types of each attribute, using the textual-convention name when such
  1358. is defined.  The following abbreviations are used in the Table of
  1359. Contents as shown:
  1360.   'Int32(-2..)'     Integer32(-2..2147483647)
  1361.   'Int32(0..)'      Integer32(0..2147483647)
  1362.   'Int32(1..)'      Integer32(1..2147483647)
  1363.   'Int32(m..n)'     For all other Integer ranges, the lower
  1364.                     and upper bound of the range is
  1365.                     indicated.
  1366.   'Octets63'        OCTET STRING(SIZE(0..63))
  1367.   'Octets(m..n)'    For all other OCTET STRING ranges, the
  1368.                     exact range is indicated.
  1369.  
  1370. 3.3.4 Single-Value (Row) Versus Multi-Value (MULTI-ROW) Attributes
  1371.  
  1372. Most attributes SHALL have only one row per job.  However, a few
  1373. attributes can have multiple values per job or even per document, where
  1374. each value is a separate row in the jmAttributeTable.  Unless indicated
  1375. with 'MULTI-ROW:' in JmAttributeTypeTC, an agent SHALL ensure that each
  1376. attribute occurs only once in the jmAttributeTable for a job.
  1377. Attributes that are permitted to appear multiple times in the
  1378.  
  1379.  
  1380.  
  1381. Bergman, Hastings, Isaacson, Lewis                 [Page 23]
  1382.  
  1383.  
  1384.  
  1385.  
  1386.  
  1387.                  Job Monitoring MIB, V0.83     July 14, 1997
  1388.  
  1389.  
  1390. jmAttributeTable for a job are indicated with 'MULTI-ROW:' in their
  1391. specification in the JmAttributeTypeTC.  However, such 'MULTI-ROW'
  1392. attributes SHALL not contain duplicates for 'intensive' (as opposed to
  1393. 'extensive') attributes.
  1394.  
  1395. For example, a job or document(s) may use multiple PDLs.  However, each
  1396. distinct documentFormat attribute value SHALL appear in the
  1397. jmAttributeTable only once for a job since the interpreter language is
  1398. an intensive attribute, even though the job has a number of documents
  1399. that all use the same PDL.
  1400.  
  1401. As another example of an intensive attribute that can have multiple
  1402. entries, if a document or job uses multiple types of media, there SHALL
  1403. be only one row in the jmAttributeTable for each media type, not one row
  1404. for each document that uses that medium type.
  1405.  
  1406. On the other hand, if a job contains two documents of the same name,
  1407. there can be separate rows for the documentName attribute with the same
  1408. name, since a document name is an extensive attribute.  The
  1409. specification indicates that the values NEED NOT be unique for such
  1410. 'MULTI-ROW: attributes'
  1411.  
  1412. 3.3.5 Requested Attributes
  1413.  
  1414. A number of attributes record requirements for the job.  Such attribute
  1415. names end with the word 'Requested'.  In the interests of brevity, the
  1416. phrase 'requested' SHALL mean: (1) requested by the client (or
  1417. intervening server) in the job submission protocol that submitted the
  1418. job and MAY also mean (2) embedded in the submitted document data,
  1419. and/or (3) defaulted by the recipient device or server with the same
  1420. semantics as if the requester had supplied, depending on implementation.
  1421.  
  1422. 3.3.6 Consumption Attributes
  1423.  
  1424. A number of attributes record consumption.  Such attribute names end
  1425. with the word 'Completed' or 'Consumed'.  If the job has not yet
  1426. consumed what that resource is metering, the agent either: (1) SHALL
  1427. return the value 0 or (2) SHALL not add this attribute to the
  1428. jmAttributeTable until the consumption begins.  In the interests of
  1429. brevity, the semantics for 0 is specified once here and is not repeated
  1430. for each consumptive attribute specification.
  1431.  
  1432. 3.3.7 Index Value Attributes
  1433.  
  1434. A number of attributes are indexes in other tables.  Such attribute
  1435. names end with the word 'Index'.  If the agent has not (yet) assigned an
  1436. index value for a particular index attribute for a job, the agent SHALL
  1437. either: (1) return the value 0 or (2) not add this attribute to the
  1438.  
  1439.  
  1440.  
  1441. Bergman, Hastings, Isaacson, Lewis                 [Page 24]
  1442.  
  1443.  
  1444.  
  1445.  
  1446.  
  1447.                  Job Monitoring MIB, V0.83     July 14, 1997
  1448.  
  1449.  
  1450. jmAttributeTable until the index value is assigned.  In the interests of
  1451. brevity, the semantics for 0 is specified once here and is not repeated
  1452. for each index attribute specification.
  1453.  
  1454. 3.4 Job Identification
  1455.  
  1456. There are a number of attributes that permit a user, operator or system
  1457. administrator to identify jobs of interest, such as jobName,
  1458. jobOriginatingHost, etc.  In addition, there is a Job Submission ID
  1459. object that allows a monitoring application to quickly locate and
  1460. identify a particular job of interest that was submitted from a
  1461. particular client by the user invoking the monitoring application.  The
  1462. Job Monitoring MIB needs to provide for identification of the job at
  1463. both sides of the job submission process.  The primary identification
  1464. point is the client side.  The Job Submission ID allows the monitoring
  1465. application to identify the job of interest from all the jobs currently
  1466. "known" by the server or device.  The Job Submission ID can be assigned
  1467. by either the client's local system or a downstream server or device.
  1468. The point of assignment depends on the job submission protocol in use.
  1469.  
  1470. The server/device-side identifier, called the jmJobIndex object, SHALL
  1471. be assigned by the SNMP Job Monitoring MIB agent when the server or
  1472. device accepts the jobs from submitting clients.  The jmJobIndex object
  1473. allows the interested party to obtain all objects desired that relate to
  1474. this job.  The MIB provides a mapping table that maps each Job
  1475. Submission ID (generated by the client) to the corresponding jmJobIndex
  1476. value generated by the agent, so that an application can determine the
  1477. correct value for the jmJobIndex value for the job of interest in a
  1478. single Get operation, given the Job Submission ID.  See the
  1479. jmJobIDGroup.
  1480.  
  1481. The jobName attribute provides a name that the user supplies as a job
  1482. attribute with the job.  The jobName attribute is not necessarily
  1483. unique, even for one user, let alone across users.
  1484.  
  1485. 3.5 Internationalization Considerations
  1486.  
  1487. There are a number of objects in this MIB that are represented as coded
  1488. character sets with a data type of OCTET STRING.  Most of the objects
  1489. are supplied as job attributes by the client that submits the job to the
  1490. server or device and so are represented in the coded character set
  1491. specified by that client.
  1492.  
  1493. For simplicity, this specification assumes that the clients, job
  1494. monitoring applications, servers, and devices are all running in the
  1495. same locale, including locales that use two-octet coded character sets,
  1496. such as ISO 10646 (Unicode).  Job monitoring applications are expected
  1497. to understand the coded character set of the client (and job), server,
  1498.  
  1499.  
  1500.  
  1501. Bergman, Hastings, Isaacson, Lewis                 [Page 25]
  1502.  
  1503.  
  1504.  
  1505.  
  1506.  
  1507.                  Job Monitoring MIB, V0.83     July 14, 1997
  1508.  
  1509.  
  1510. or device.  No special means is provided for the monitor to discover the
  1511. coded character set used by jobs or by the server or device.  This
  1512. specification does not contain an object that indicates what locale the
  1513. server or device is running in, let alone contain an object to control
  1514. what locale the agent is to use to represent coded character set
  1515. objects.
  1516.  
  1517. This MIB also contains objects that are represented using the
  1518. DateAndTime textual convention from SMIv2 [SMIv2].  The job management
  1519. application SHALL display such objects in the locale of the user running
  1520. the monitoring application.
  1521.  
  1522. 3.6 IANA Considerations
  1523.  
  1524. During the development of this standard, the Printer Working Group (PWG)
  1525. working with IANA will register additional enums while the standard is
  1526. in the proposed and draft states according to the procedures described
  1527. in this section.  IANA will handle registration of additional enums
  1528. after this standard is approved in cooperation with an IANA-appointed
  1529. registration editor from the PWG according to the procedures described
  1530. in this section:
  1531.  
  1532. 3.6.1 IANA Registration of enums
  1533.  
  1534. This specification uses textual conventions to define enumerated values
  1535. (enums) and bit values.  Enumerations (enums) and bit values are sets of
  1536. symbolic values defined for use with one or more objects or attributes.
  1537. All enumeration sets and bit value sets are assigned a symbolic data
  1538. type name (textual convention).  As a convention the symbolic name ends
  1539. in "TC" for textual convention.  These enumerations are defined at the
  1540. beginning of the MIB module specification.
  1541.  
  1542. This working group has defined several type of enumerations for use in
  1543. the Job Monitoring MIB and the Printer MIB[print-mib].  These types
  1544. differ in the method employed to control the addition of new
  1545. enumerations.  Throughout this document, references to "type n enum",
  1546. where n can be 1, 2 or 3 can be found in the various tables.  The
  1547. definitions of these types of enumerations are:
  1548.  
  1549. 3.6.1.1 Type 1 enumerations
  1550.  
  1551. Type 1 enumeration:  All the values are defined in the Job Monitoring
  1552. MIB specification (RFC for the Job Monitoring MIB).  Additional
  1553. enumerated values require a new RFC.
  1554.  
  1555. There are no type 1 enums in the current draft.
  1556.  
  1557.  
  1558.  
  1559.  
  1560.  
  1561. Bergman, Hastings, Isaacson, Lewis                 [Page 26]
  1562.  
  1563.  
  1564.  
  1565.  
  1566.  
  1567.                  Job Monitoring MIB, V0.83     July 14, 1997
  1568.  
  1569.  
  1570. 3.6.1.2 Type 2 enumerations
  1571.  
  1572. Type 2 enumeration:  An initial set of values are defined in the Job
  1573. Monitoring MIB specification.  Additional enumerated values are
  1574. registered after review by this working group. The initial versions of
  1575. the MIB will contain the values registered so far. After the MIB is
  1576. approved, additional values will be registered through IANA after
  1577. approval by this working group.
  1578.  
  1579. The following type 2 enums are contained in the current draft :
  1580.   1.JmTimeStampTC
  1581.   2.JmFinishingTC [same enum values as IPP "finishing" attribute]
  1582.   3.JmPrintQualityTC [same enum values as IPP "print-quality"
  1583.     attribute]
  1584.   4.JmTonerEconomyTC
  1585.   5.JmPrinterResolutionTC [same enum values as IPP "printer-resolution"
  1586.     attribute]
  1587.   6.JmMediumTypeTC
  1588.   7.JmJobSubmissionTypeTC
  1589.   8.JmJobStateTC [same enum values as IPP  "job-state" attribute]
  1590.   9.JmAttributeTypeTC
  1591.  
  1592. Those textual conventions that are labeled "[same enum values as IPP]"
  1593. have the same enum values as the indicated IPP Job attribute.  When IPP
  1594. registers additional values, those values shall be simultaneously
  1595. registered by IANA for use with the Job Monitoring MIB textual-
  1596. convention, so that the enum values stay in lock step between the IPP
  1597. protocol and the Job Monitoring MIB.
  1598.  
  1599. 3.6.1.3 Type 3 enumeration
  1600.  
  1601. Type 3 enumeration:  An initial set of values are defined in the Job
  1602. Monitoring MIB specification.  Additional enumerated values are
  1603. registered without working group review.  The initial versions of the
  1604. MIB will contain the values registered so far.  After the MIB is
  1605. approved, additional values will be registered through IANA without
  1606. approval by this working group.
  1607.  
  1608. There are no type 3 enums in the current draft.
  1609.  
  1610. 3.6.2 IANA Registration of type 2 bit values
  1611.  
  1612. This draft contains the following type 2 bit value textual-conventions:
  1613.   1.JmJobServiceTypesTC
  1614.   2.JmJobStateReasons1TC
  1615.   3.JmJobStateReasons2TC
  1616.   4.JmJobStateReasons3TC
  1617.   5.JmJobStateReasons4TC
  1618.  
  1619.  
  1620.  
  1621. Bergman, Hastings, Isaacson, Lewis                 [Page 27]
  1622.  
  1623.  
  1624.  
  1625.  
  1626.  
  1627.                  Job Monitoring MIB, V0.83     July 14, 1997
  1628.  
  1629.  
  1630. These textual-conventions are defined as bits in an Integer so that they
  1631. can be used with SNMPv1 SMI.  The jobStateReasonsN (N=1..4) attributes
  1632. are defined as bit values using the corresponding JmJobStateReasonsNTC
  1633. textual-conventions.
  1634.  
  1635. The registration of JmJobServiceTypesTC and JmJobStateReasonsNTC bit
  1636. values SHALL follow the procedures for a type 2 enum as specified in
  1637. Section 3.6.1.2.
  1638.  
  1639. 3.6.3 IANA Registration of Job Submission Id Formats
  1640.  
  1641. In addition to enums and bit values, this specification assigns a single
  1642. ASCII digit or letter to various job submission ID formats.  See the
  1643. JmJobSubmissionIDTypeTC textual-convention and the  object.  The
  1644. registration of  jmJobSubmissionID format numbers SHALL follow the
  1645. procedures for a type 2 enum as specified in Section 3.6.1.2.
  1646.  
  1647. 3.6.4 IANA Registration of MIME types/sub-types for document-formats
  1648.  
  1649. The documentFormat(38) attribute has MIME type/sub-type values for
  1650. indicating document formats which IANA registers as "media type" names.
  1651. The values of the documentFormat(38) attribute are the same as the
  1652. corresponding Internet Printing Protocol (IPP) "document-format" Job
  1653. attribute values [ipp-model].
  1654.  
  1655. 3.7 Security Considerations
  1656.  
  1657. 3.7.1 Read-Write objects
  1658.  
  1659. All objects are read-only, greatly simplifying the security
  1660. considerations.  If another MIB augments this MIB, that MIB might accept
  1661. SNMP Write operations to objects in that MIB whose effect is to modify
  1662. the values of read-only objects in this MIB.  However, that MIB SHALL
  1663. have to support the required access control in order to achieve
  1664. security, not this MIB.
  1665.  
  1666. 3.7.2 Read-Only Objects In Other User's Jobs
  1667.  
  1668. The security policy of some sites MAY be that unprivileged users can
  1669. only get the objects from jobs that they submitted, plus a few minimal
  1670. objects from other jobs, such as the jmJobKOctetsRequested and
  1671. jmJobKOctetsCompleted objects, so that a user can tell how busy a
  1672. printer is.  Other sites MAY allow all unprivileged users to see all
  1673. objects of all jobs.  This MIB does not require, nor does it specify
  1674. how, such restrictions would be implemented.  A monitoring application
  1675. SHOULD enforce the site security policy with respect to returning
  1676. information to an unprivileged end user that is using the monitoring
  1677.  
  1678.  
  1679.  
  1680.  
  1681. Bergman, Hastings, Isaacson, Lewis                 [Page 28]
  1682.  
  1683.  
  1684.  
  1685.  
  1686.  
  1687.                  Job Monitoring MIB, V0.83     July 14, 1997
  1688.  
  1689.  
  1690. application to monitor jobs that do not belong to that user, i.e., the
  1691. jmJobOwner object in the jmJobTable does not match the user's user name.
  1692.  
  1693. An operator is a privileged user that would be able to see all objects
  1694. of all jobs, independent of the policy for unprivileged users.
  1695.  
  1696. 3.8 Notifications
  1697.  
  1698. This MIB does not specify any notifications.  For simplicity, management
  1699. applications are expected to poll for status.  The
  1700. jmGeneralJobPersistence and jmGeneralAttributePersistence objects assist
  1701. an application to determine the polling rate.  The resulting network
  1702. traffic is not expected to be significant.
  1703.  
  1704. 4. MIB specification
  1705.  
  1706. The following pages constitute the actual Job Monitoring MIB.
  1707.  
  1708.  
  1709.  
  1710.  
  1711.  
  1712.  
  1713.  
  1714.  
  1715.  
  1716.  
  1717.  
  1718.  
  1719.  
  1720.  
  1721.  
  1722.  
  1723.  
  1724.  
  1725.  
  1726.  
  1727.  
  1728.  
  1729.  
  1730.  
  1731.  
  1732.  
  1733.  
  1734.  
  1735.  
  1736.  
  1737.  
  1738.  
  1739.  
  1740.  
  1741. Bergman, Hastings, Isaacson, Lewis                 [Page 29]
  1742.  
  1743.  
  1744.  
  1745.  
  1746.  
  1747.                  Job Monitoring MIB, V0.83     July 14, 1997
  1748.  
  1749.  
  1750. Job-Monitoring-MIB DEFINITIONS ::= BEGIN
  1751.  
  1752. IMPORTS
  1753.     MODULE-IDENTITY, OBJECT-TYPE, experimental,
  1754.     Integer32                                        FROM SNMPv2-SMI
  1755.     TEXTUAL-CONVENTION                               FROM SNMPv2-TC
  1756.     MODULE-COMPLIANCE, OBJECT-GROUP                  FROM SNMPv2-CONF;
  1757.     -- The following textual-conventions are needed
  1758.     -- to implement certain attributes, but are not
  1759.     -- needed to compile this MIB.  They are
  1760.     -- provided here for convenience:
  1761.     -- DateAndTime                                   FROM SNMPv2-TC
  1762.     -- PrtInterpreterLangFamilyTC                    FROM Printer-MIB
  1763.  
  1764. -- Use the experimental (54) OID assigned to the Printer MIB[print-mib]
  1765. -- before it was published as RFC 1759.
  1766. -- Upon publication of the Job Monitoring MIB as an RFC, delete this
  1767. -- comment and the line following this comment and change the
  1768. -- reference of { temp 105 } (below) to { mib-2 X }.
  1769. -- This will result in changing:
  1770. -- 1 3 6 1 3 54 jobmonMIB(105)    to:
  1771. -- 1 3 6 1 2  1 jobmonMIB(X)
  1772. -- This will make it easier to translate prototypes to
  1773. -- the standard namespace because the lengths of the OIDs won't
  1774. -- change.
  1775. temp OBJECT IDENTIFIER ::= { experimental 54 }
  1776.  
  1777. jobmonMIB MODULE-IDENTITY
  1778.     LAST-UPDATED "9707140000Z"
  1779.     ORGANIZATION "IETF Printer MIB Working Group"
  1780.     CONTACT-INFO
  1781.         "Tom Hastings
  1782.         Postal:  Xerox Corp.
  1783.                  Mail stop ESAE-231
  1784.                  701 S. Aviation Blvd.
  1785.                  El Segundo, CA 90245
  1786.  
  1787.         Tel:     (301)333-6413
  1788.         Fax:     (301)333-5514
  1789.         E-mail:  hastings@cp10.es.xerox.com
  1790.  
  1791.         Send comments to the printmib WG using the Job Monitoring
  1792.         Project (JMP) Mailing List:  jmp@pwg.org
  1793.  
  1794.         To learn how to subscribe to the JMP mailing list,
  1795.         send email to:  jmp-request@pwg.org
  1796.  
  1797.         For further information, access the PWG web page under 'JMP':
  1798.  
  1799.  
  1800.  
  1801. Bergman, Hastings, Isaacson, Lewis                 [Page 30]
  1802.  
  1803.  
  1804.  
  1805.  
  1806.  
  1807.                  Job Monitoring MIB, V0.83     July 14, 1997
  1808.  
  1809.  
  1810.         http://www.pwg.org/"
  1811.     DESCRIPTION
  1812.         "The MIB module for monitoring job in servers, printers, and
  1813.         other devices.
  1814.  
  1815.         File: draft-ietf-printmib-job-monitor-02.txt
  1816.         Version: 0.83"
  1817.     ::= { temp 105 }
  1818.  
  1819.  
  1820.  
  1821. -- Textual conventions for this MIB module
  1822.  
  1823.  
  1824.  
  1825. JmTimeStampTC ::= TEXTUAL-CONVENTION
  1826.     STATUS      current
  1827.     DESCRIPTION
  1828.         "The simple time at which an event took place.  The units SHALL
  1829.         be in seconds since the system was booted.
  1830.  
  1831.         NOTE - JmTimeStampTC is defined in units of seconds, rather than
  1832.         100ths of seconds, so as to be simpler for agents to implement
  1833.         (even if they have to implement the 100ths of a second to comply
  1834.         with implementing sysUpTime in MIB-II[mib-II].)
  1835.  
  1836.         NOTE - JmTimeStampTC is defined as an Integer32 so that it can
  1837.         be used as a value of an attribute, i.e., as a value of the
  1838.         jmAttributeValueAsInteger object.  The TimeStamp textual-
  1839.         convention defined in SMNPv2-TC is defined as an APPLICATION 3
  1840.         IMPLICIT INTEGER tag, not an Integer32, so cannot be used in
  1841.         this MIB as one of the values of jmAttributeValueAsInteger."
  1842.     SYNTAX      INTEGER(0..2147483647)
  1843.  
  1844.  
  1845.  
  1846.  
  1847.  
  1848. JmJobSourcePlatformTypeTC ::= TEXTUAL-CONVENTION
  1849.     STATUS      current
  1850.     DESCRIPTION
  1851.         "The source platform type that can submit jobs to servers or
  1852.         devices in any of the 3 configurations."
  1853.     REFERENCE
  1854.         "This is a type 2 enumeration.  See Section 3.6.1.2."
  1855.     SYNTAX      INTEGER {
  1856.         other(1),
  1857.         unknown(2),
  1858.  
  1859.  
  1860.  
  1861. Bergman, Hastings, Isaacson, Lewis                 [Page 31]
  1862.  
  1863.  
  1864.  
  1865.  
  1866.  
  1867.                  Job Monitoring MIB, V0.83     July 14, 1997
  1868.  
  1869.  
  1870.         sptUNIX(3),            -- UNIX(tm)
  1871.         sptOS2(4),             -- OS/2
  1872.         sptPCDOS(5),           -- DOS
  1873.         sptNT(6),              -- NT
  1874.         sptMVS(7),             -- MVS
  1875.         sptVM(8),              -- VM
  1876.         sptOS400(9),           -- OS/400
  1877.         sptVMS(10),            -- VMS
  1878.         sptWindows95(11),      -- Windows95
  1879.         sptNetWare(33)         -- NetWare
  1880.     }
  1881.  
  1882.  
  1883.  
  1884.  
  1885.  
  1886.  
  1887. JmFinishingTC ::= TEXTUAL-CONVENTION
  1888.     STATUS      current
  1889.     DESCRIPTION
  1890.         "The type of finishing operation.
  1891.  
  1892.         These values are the same as the enum values of the IPP
  1893.         'finishings' attribute.  See Section 3.6.1.2.
  1894.  
  1895.         other(1),
  1896.             Some other finishing operation besides one of the specified
  1897.             or registered values.
  1898.  
  1899.         unknown(2),
  1900.             The finishing is unknown.
  1901.  
  1902.         none(3),
  1903.             Perform no finishing.
  1904.  
  1905.         staple(4),
  1906.             Bind the document(s) with one or more staples. The exact
  1907.             number and placement of the staples is site-defined.
  1908.  
  1909.         stapleTopLeft(5),
  1910.             Place one or more staples on the top left corner of the
  1911.             document(s).
  1912.  
  1913.         stapleBottomLeft(6),
  1914.             Place one or more staples on the bottom left corner of the
  1915.             document(s).
  1916.  
  1917.  
  1918.  
  1919.  
  1920.  
  1921. Bergman, Hastings, Isaacson, Lewis                 [Page 32]
  1922.  
  1923.  
  1924.  
  1925.  
  1926.  
  1927.                  Job Monitoring MIB, V0.83     July 14, 1997
  1928.  
  1929.  
  1930.         stapleTopRight(7),
  1931.             Place one or more staples on the top right corner of the
  1932.             document(s).
  1933.  
  1934.         stapleBottomRight(8),
  1935.             Place one or more staples on the bottom right corner of the
  1936.             document(s).
  1937.  
  1938.         saddleStitch(9),
  1939.             Bind the document(s) with one or more staples (wire
  1940.             stitches) along the middle fold.  The exact number and
  1941.             placement of the stitches is site-defined.
  1942.  
  1943.         edgeStitch(10),
  1944.             Bind the document(s) with one or more staples (wire
  1945.             stitches) along one edge.  The exact number and placement of
  1946.             the staples is site-defined.
  1947.  
  1948.         punch(11),
  1949.             This value indicates that holes are required in the finished
  1950.             document. The exact number and placement of the holes is
  1951.             site-defined  The punch specification MAY be satisfied (in a
  1952.             site- and implementation-specific manner) either by
  1953.             drilling/punching, or by substituting pre-drilled media.
  1954.  
  1955.         cover(12),
  1956.             This value is specified when it is desired to select a non-
  1957.             printed (or pre-printed) cover for the document. This does
  1958.             not supplant the specification of a printed cover (on cover
  1959.             stock medium) by the document itself.
  1960.  
  1961.         bind(13)
  1962.             This value indicates that a binding is to be applied to the
  1963.             document; the type and placement of the binding is product-
  1964.             specific."
  1965.     REFERENCE
  1966.         "This is a type 2 enumeration.  See Section 3.6.1.2."
  1967.     SYNTAX      INTEGER {
  1968.         other(1),
  1969.         unknown(2),
  1970.         none(3),
  1971.         staple(4),
  1972.         stapleTopLeft(5),
  1973.         stapleBottomLeft(6),
  1974.         stapleTopRight(7),
  1975.         stapleBottomRight(8),
  1976.         saddleStitch(9),
  1977.         edgeStitch(10),
  1978.  
  1979.  
  1980.  
  1981. Bergman, Hastings, Isaacson, Lewis                 [Page 33]
  1982.  
  1983.  
  1984.  
  1985.  
  1986.  
  1987.                  Job Monitoring MIB, V0.83     July 14, 1997
  1988.  
  1989.  
  1990.         punch(11),
  1991.         cover(12),
  1992.         bind(13)
  1993.     }
  1994.  
  1995.  
  1996.  
  1997.  
  1998.  
  1999.  
  2000. JmPrintQualityTC ::= TEXTUAL-CONVENTION
  2001.     STATUS      current
  2002.     DESCRIPTION
  2003.         "Print quality settings.
  2004.  
  2005.         These values are the same as the enum values of the IPP 'print-
  2006.         quality' attribute.  See Section 3.6.1.2."
  2007.     REFERENCE
  2008.         "This is a type 2 enumeration.  See Section 3.6.1.2."
  2009.     SYNTAX      INTEGER {
  2010.         other(1),     -- Not one of the specified or registered
  2011.                       -- values.
  2012.         unknown(2),   -- The actual value is unknown.
  2013.         draft(3),     -- Lowest quality available on the printer.
  2014.         normal(4),    -- Normal or intermediate quality on the
  2015.                       -- printer.
  2016.         high(5)       -- Highest quality available on the printer.
  2017.     }
  2018.  
  2019.  
  2020.  
  2021.  
  2022.  
  2023. JmPrinterResolutionTC ::= TEXTUAL-CONVENTION
  2024.     STATUS      current
  2025.     DESCRIPTION
  2026.         "Printer resolutions.
  2027.  
  2028.         The values represent single integer resolutions or pairs of
  2029.         integer resolutions.  The latter are to specify the resolution
  2030.         when the x and y dimensions differ.  When two integers are
  2031.         specified, the first is in the x direction, i.e., in the
  2032.         direction of the shortest dimension of the medium, so that the
  2033.         value is independent of whether the printer feeds long edge or
  2034.         short edge first.
  2035.  
  2036.         These values are the same as the enum values of the IPP
  2037.         'printer-resolution' attribute.  See Section 3.6.1.2."
  2038.  
  2039.  
  2040.  
  2041. Bergman, Hastings, Isaacson, Lewis                 [Page 34]
  2042.  
  2043.  
  2044.  
  2045.  
  2046.  
  2047.                  Job Monitoring MIB, V0.83     July 14, 1997
  2048.  
  2049.  
  2050.     REFERENCE
  2051.         "This is a type 2 enumeration.  See Section 3.6.1.2."
  2052.     SYNTAX      INTEGER {
  2053.         other(1),           -- Not one of the specified or registered
  2054.                             -- values.
  2055.         unknown(2),         -- The actual value is unknown.
  2056.         normal(3),          -- Normal resolution.
  2057.         res100(4),          -- 100 x 100 dpi
  2058.         res200(5),          -- 200 x 200 dpi
  2059.         res240(6),          -- 240 x 240 dpi
  2060.         res300(7),          -- 300 x 300 dpi
  2061.         res360(8),          -- 360 x 360 dpi
  2062.         res400(9),          -- 400 x 400 dpi
  2063.         res600(10),         -- 600 x 600 dpi
  2064.         res720(11),         -- 720 x 720 dpi
  2065.         res800(12),         -- 800 x 800 dpi
  2066.         res1200(13),        -- 1200 x 1200 dpi
  2067.         res1440(14),        -- 1440 x 1440 dpi
  2068.         res1600(15),        -- 1600 x 1600 dpi
  2069.         res1800(16),        -- 1800 x 1800 dpi
  2070.  
  2071.                             -- future equal resolutions will be added
  2072.                             -- here, the enum values will not be re-
  2073.                             -- sorted or re-assigned:
  2074.  
  2075.         res100x200(100),    -- 100 x 200 dpi
  2076.         res200x100(101),    -- 200 x 100 dpi
  2077.         res300x600(102),    -- 300 x 600 dpi
  2078.         res600x300(103),    -- 600 x 300 dpi
  2079.         res360x720(104),    -- 360 x 720 dpi
  2080.         res720x360(105),    -- 720 x 360 dpi
  2081.         res400x800(106),    -- 400 x 800 dpi
  2082.         res800x400(107),    -- 800 x 400 dpi
  2083.         res600x1200(108),   -- 600 x 1200 dpi
  2084.         res1200x600(109),   -- 1200 x 600 dpi
  2085.         res720x1440(110),   -- 720 x 1440 dpi
  2086.         res1440x720(111),   -- 1440 x 720 dpi
  2087.         res1800x600(112)    -- 1800 x 600 dpi
  2088.  
  2089.                             -- future unequal resolutions will be
  2090.                             -- added here, the enum values will not
  2091.                             -- be re-sorted or re-assigned:
  2092.     }
  2093.  
  2094.  
  2095.  
  2096.  
  2097.  
  2098.  
  2099.  
  2100.  
  2101. Bergman, Hastings, Isaacson, Lewis                 [Page 35]
  2102.  
  2103.  
  2104.  
  2105.  
  2106.  
  2107.                  Job Monitoring MIB, V0.83     July 14, 1997
  2108.  
  2109.  
  2110.  
  2111. JmTonerEconomyTC ::= TEXTUAL-CONVENTION
  2112.     STATUS      current
  2113.     DESCRIPTION
  2114.         "Toner economy settings."
  2115.     REFERENCE
  2116.         "This is a type 2 enumeration.  See Section 3.6.1.2."
  2117.     SYNTAX      INTEGER {
  2118.         unknown(2),    --  unknown.
  2119.         off(3),        --  Off.  Normal.  Use full toner.
  2120.         on(4)          --  On.  Use less toner than normal.
  2121.     }
  2122.  
  2123.  
  2124.  
  2125.  
  2126.  
  2127.  
  2128. JmBooleanTC ::= TEXTUAL-CONVENTION
  2129.     STATUS      current
  2130.     DESCRIPTION
  2131.         "Boolean true or false value."
  2132.     REFERENCE
  2133.         "This is a type 2 enumeration.  See Section 3.6.1.2."
  2134.     SYNTAX      INTEGER {
  2135.         unknown(2),    --  unknown.
  2136.         false(3),      --  FALSE.
  2137.         true(4)        --  TRUE.
  2138.     }
  2139.  
  2140.  
  2141.  
  2142.  
  2143.  
  2144.  
  2145. JmMediumTypeTC ::= TEXTUAL-CONVENTION
  2146.     STATUS      current
  2147.     DESCRIPTION
  2148.         "Identifies the type of medium.
  2149.  
  2150.         other(1),
  2151.             The type is neither one of the values listed in this
  2152.             specification nor a registered value.
  2153.  
  2154.         unknown(2),
  2155.             The type is not known.
  2156.  
  2157.  
  2158.  
  2159.  
  2160.  
  2161. Bergman, Hastings, Isaacson, Lewis                 [Page 36]
  2162.  
  2163.  
  2164.  
  2165.  
  2166.  
  2167.                  Job Monitoring MIB, V0.83     July 14, 1997
  2168.  
  2169.  
  2170.         stationery(3),
  2171.             Separately cut sheets of an opaque material.
  2172.  
  2173.         transparency(4),
  2174.             Separately cut sheets of a transparent material.
  2175.  
  2176.         envelope(5),
  2177.             Envelopes that can be used for conventional mailing
  2178.             purposes.
  2179.  
  2180.         envelopePlain(6),
  2181.             Envelopes that are not preprinted and have no windows.
  2182.  
  2183.         envelopeWindow(7),
  2184.             Envelopes that have windows for addressing purposes.
  2185.  
  2186.         continuousLong(8),
  2187.             Continuously connected sheets of an opaque material
  2188.             connected along the long edge.
  2189.  
  2190.         continuousShort(9),
  2191.             Continuously connected sheets of an opaque material
  2192.             connected along the short edge.
  2193.  
  2194.         tabStock(10),
  2195.             Media with tabs.
  2196.  
  2197.         multiPartForm(11),
  2198.             Form medium composed of multiple layers not pre-attached to
  2199.             one another;  each sheet MAY be drawn separately from an
  2200.             input source.
  2201.  
  2202.         labels(12),
  2203.             Label-stock.
  2204.  
  2205.         multiLayer(13)
  2206.             Form medium composed of multiple layers which are pre-
  2207.             attached to one another, e.g. for use with impact printers."
  2208.     REFERENCE
  2209.         "This is a type 2 enumeration.  See Section 3.6.1.2."
  2210.     SYNTAX      INTEGER {
  2211.         other(1),
  2212.         unknown(2),
  2213.         stationery(3),
  2214.         transparency(4),
  2215.         envelope(5),
  2216.         envelopePlain(6),
  2217.         envelopeWindow(7),
  2218.  
  2219.  
  2220.  
  2221. Bergman, Hastings, Isaacson, Lewis                 [Page 37]
  2222.  
  2223.  
  2224.  
  2225.  
  2226.  
  2227.                  Job Monitoring MIB, V0.83     July 14, 1997
  2228.  
  2229.  
  2230.         continuousLong(8),
  2231.         continuousShort(9),
  2232.         tabStock(10),
  2233.         multiPartForm(11),
  2234.         labels(12),
  2235.         multiLayer(13)
  2236.     }
  2237.  
  2238.  
  2239.  
  2240.  
  2241.  
  2242.  
  2243. JmJobSubmissionTypeTC ::= TEXTUAL-CONVENTION
  2244.     STATUS      current
  2245.     DESCRIPTION
  2246.         "Identifies the format type of a job submission ID.
  2247.  
  2248.         The ASCII characters '0-9', 'A-Z', and 'a-z' are assigned in
  2249.         order giving 62 possible formats.
  2250.  
  2251.         Each job submission ID is a fixed-length, 48-octet printable
  2252.         ASCII coded character string, consisting of the following
  2253.         fields:
  2254.           octet  1      The format letter.
  2255.           octets 2-40   A 39-character, ASCII trailing SPACE filled
  2256.                         field specified by the format letter, if the
  2257.                         data is less than 39 ASCII characters.
  2258.           octets 41-48  A sequential or random number to make the ID
  2259.                         quasi-unique.
  2260.  
  2261.         If the client does not supply a job submission ID in the job
  2262.         submission protocol, then the server SHALL assign a job
  2263.         submission ID using any of the standard formats and adding the
  2264.         final 8 octets to distinguish the ID from others submitted from
  2265.         the same client.
  2266.  
  2267.         The format values registered so far are:
  2268.  
  2269.           Format
  2270.           Letter    Description
  2271.           ------    ------------
  2272.           '0'       octets 2-40: last 39 bytes of the jmJobOwner
  2273.                     object.
  2274.                     octets 41-48:  8-decimal-digit sequential number
  2275.  
  2276.           '1'       octets 2-40: last 39 bytes of the jobName attribute.
  2277.                     octets 41-48:  8-decimal-digit random number
  2278.  
  2279.  
  2280.  
  2281. Bergman, Hastings, Isaacson, Lewis                 [Page 38]
  2282.  
  2283.  
  2284.  
  2285.  
  2286.  
  2287.                  Job Monitoring MIB, V0.83     July 14, 1997
  2288.  
  2289.  
  2290.  
  2291.           '2'       octets 2-40: Client MAC address: in hexadecimal
  2292.                     with each nibble of the 6 octet address being
  2293.                     '0'-'9' or 'A' - 'F' (uppercase only).
  2294.                     Most significant octet first.
  2295.                     octets 41-48:  8-decimal-digit sequential number
  2296.  
  2297.           '3'       octets 2-40: last 39 bytes of the client URL
  2298.                     [URI-spec].
  2299.                     octets 41-48:  8-decimal-digit sequential number
  2300.  
  2301.           '4'       octets 2-40: last 39 bytes of the URI [URI-spec]
  2302.                     assigned by the server or device to the job when
  2303.                     the job was submitted for processing.
  2304.                     octets 41-48:  8-decimal-digit sequential number
  2305.  
  2306.           '5'       octets 2-40: last 39 bytes of a user number, such
  2307.                     as POSIX user number.
  2308.                     octets 41-48:  8-decimal-digit sequential number
  2309.  
  2310.           '6'       octets 2-40: last 39 bytes of the user account
  2311.                     number.
  2312.                     octets 41-48:  8-decimal-digit sequential number
  2313.  
  2314.           '7'       octets 2-40: last 39 bytes of the DTMF incoming
  2315.                     FAX routing number.
  2316.                     octets 41-48:  8-decimal-digit sequential number
  2317.  
  2318.         NOTE - the job submission id is only intended to be unique
  2319.         between a limited set of clients for a limited duration of time,
  2320.         namely, for the life time of the job in the context of the
  2321.         server or device that is processing the job.  Some of the
  2322.         formats include something that is unique per client and a random
  2323.         number so that the same job submitted by the same client will
  2324.         have a different job submission id.  For other formats, where
  2325.         part of the id is guaranteed to be unique for each client, such
  2326.         as the MAC address or URL, a sequential number SHOULD suffice
  2327.         for each client (and may be easier for each client to manage).
  2328.         Therefore, the length of the job submission id has been selected
  2329.         to reduce the probability of collision to an extremely low
  2330.         number, but is not intended to be an absolute guarantee of
  2331.         uniqueness.  None-the-less, collisions are remotely possible,
  2332.         but without bad consequences, since this MIB is intended to be
  2333.         used only for monitoring jobs, not for controlling and managing
  2334.         them."
  2335.     REFERENCE
  2336.         "This is like a type 2 enumeration.  See section 3.6.3."
  2337.     SYNTAX      OCTET STRING(SIZE(1)) -- ASCII "0"-"9", "A"-"Z", "a"-"z"
  2338.  
  2339.  
  2340.  
  2341. Bergman, Hastings, Isaacson, Lewis                 [Page 39]
  2342.  
  2343.  
  2344.  
  2345.  
  2346.  
  2347.                  Job Monitoring MIB, V0.83     July 14, 1997
  2348.  
  2349.  
  2350.  
  2351.  
  2352.  
  2353.  
  2354.  
  2355.  
  2356. JmJobStateTC ::= TEXTUAL-CONVENTION
  2357.     STATUS      current
  2358.     DESCRIPTION
  2359.         "The current state of the job (pending, processing, completed,
  2360.         etc.).
  2361.  
  2362.         The following figure shows the normal job state transitions:
  2363.  
  2364.                                                      +----> canceled(7)
  2365.                                                     /
  2366.     +---> pending(3) --------> processing(5) ------+------> completed(9)
  2367.     |         ^                       ^             \
  2368. --->+         |                       |              +----> aborted(8)
  2369.     |         v                       v             /
  2370.     +---> pendingHeld(4)   processingStopped(6) ---+
  2371.  
  2372.  
  2373.                 Figure 4 - Normal Job State Transitions
  2374.  
  2375.  
  2376.         Normally a job progresses from left to right.  Other state
  2377.         transitions are unlikely, but are not forbidden.  Not shown are
  2378.         the transitions to the canceled state from the pending,
  2379.         pendingHeld, processing, and processingStopped states.
  2380.  
  2381.         Jobs in the pending, processing, and processingStopped states
  2382.         are called 'active', while jobs in the pendingHeld, canceled,
  2383.         aborted, and completed are called 'inactive'.
  2384.  
  2385.         These values are the same as the enum values of the IPP 'job-
  2386.         state' job attribute.  See Section 3.6.1.2.
  2387.  
  2388.         other(1),
  2389.             The job state is not one of the defined states.
  2390.  
  2391.         unknown(2),
  2392.             The job state is not known, or its state is indeterminate.
  2393.  
  2394.         pending(3),
  2395.             The job is a candidate to start processing, but is not yet
  2396.             processing.
  2397.  
  2398.  
  2399.  
  2400.  
  2401. Bergman, Hastings, Isaacson, Lewis                 [Page 40]
  2402.  
  2403.  
  2404.  
  2405.  
  2406.  
  2407.                  Job Monitoring MIB, V0.83     July 14, 1997
  2408.  
  2409.  
  2410.         pendingHeld(4),
  2411.             The job is not a candidate for processing for any number of
  2412.             reasons but will return to the pending state as soon as the
  2413.             reasons are no longer present.  The job's jmJobStateReasons1
  2414.             object and/or jobStateReasonsN (N=2..4) attributes SHALL
  2415.             indicate why the job is no longer a candidate for
  2416.             processing.  The reasons are represented as bits in the
  2417.             jmJobStateReasons1 object and/or jobStateReasonsN (N=2..4)
  2418.             attributes.  See the JmJobStateReasonsNTC (N=1..4) textual
  2419.             convention for the specification of each reason.
  2420.  
  2421.         processing(5),
  2422.             Either:
  2423.  
  2424.             1.  The job is using, or is attempting to use, one or more
  2425.             document transforms which include (1) purely software
  2426.             processes that are interpreting a PDL, and (2) hardware
  2427.             devices that are interpreting a PDL, making marks on a
  2428.             medium, and/or performing finishing, such as stapling, etc.
  2429.  
  2430.             OR
  2431.  
  2432.             2. (configuration 2) the server has made the job ready for
  2433.             printing, but the output device is not yet printing it,
  2434.             either because the job hasn't reached the output device or
  2435.             because the job is queued in the output device or some other
  2436.             spooler, awaiting the output device to print it.
  2437.  
  2438.             When the job is in the processing state, the entire job
  2439.             state includes the detailed status represented in the device
  2440.             MIB indicated by the hrDeviceIndex value of the job's
  2441.             physicalDevice attribute, if the agent implements such a
  2442.             device MIB.
  2443.  
  2444.             Implementations MAY, though they NEED NOT, include
  2445.             additional values in the job's jmJobStateReasons1 object to
  2446.             indicate the progress of the job, such as adding the
  2447.             jobPrinting value to indicate when the device is actually
  2448.             making marks on a medium.
  2449.  
  2450.         processingStopped(6),
  2451.             The job has stopped while processing for any number of
  2452.             reasons and will return to the processing state as soon as
  2453.             the reasons are no longer present.
  2454.  
  2455.             The job's jmJobStateReasons1 object and/or the job's
  2456.             jobStateReasonsN (N=2..4) attributes MAY indicate why the
  2457.             job has stopped processing.  For example, if the output
  2458.  
  2459.  
  2460.  
  2461. Bergman, Hastings, Isaacson, Lewis                 [Page 41]
  2462.  
  2463.  
  2464.  
  2465.  
  2466.  
  2467.                  Job Monitoring MIB, V0.83     July 14, 1997
  2468.  
  2469.  
  2470.             device is stopped, the deviceStopped value MAY be included
  2471.             in the job's jmJobStateReasons1 object.
  2472.  
  2473.             NOTE - When an output device is stopped, the device usually
  2474.             indicates its condition in human readable form at the
  2475.             device.  The management application can obtain more complete
  2476.             device status remotely by querying the appropriate device
  2477.             MIB using the job's deviceIndex attribute(s), if the agent
  2478.             implements such a device MIB
  2479.  
  2480.         canceled(7),
  2481.             A client has canceled the job and the job is either: (1) in
  2482.             the process of being terminated by the server or device or
  2483.             (2) has completed terminating.  The job's jmJobStateReasons1
  2484.             object SHOULD contain either the canceledByUser or
  2485.             canceledByOperator value.
  2486.  
  2487.         aborted(8),
  2488.             The job has been aborted by the system, usually while the
  2489.             job was in the processing or processingStopped state.
  2490.  
  2491.         completed(9)
  2492.             The job has completed successfully or with warnings or
  2493.             errors after processing and all of the media have been
  2494.             successfully stacked in the appropriate output bin(s).  The
  2495.             job's jmJobStateReasons1 object SHOULD contain one of:
  2496.             completedSuccessfully, completedWithWarnings, or
  2497.             completedWithErrors values."
  2498.     REFERENCE
  2499.         "This is a type 2 enumeration.  See Section 3.6.1.2."
  2500.     SYNTAX      INTEGER {
  2501.         other(1),
  2502.         unknown(2),
  2503.         pending(3),
  2504.         pendingHeld(4),
  2505.         processing(5),
  2506.         processingStopped(6),
  2507.         canceled(7),
  2508.         aborted(8),
  2509.         completed(9)
  2510.     }
  2511.  
  2512.  
  2513.  
  2514. JmAttributeTypeTC ::= TEXTUAL-CONVENTION
  2515.     STATUS      current
  2516.     DESCRIPTION
  2517.         "The type of the attribute which identifies the attribute.
  2518.  
  2519.  
  2520.  
  2521. Bergman, Hastings, Isaacson, Lewis                 [Page 42]
  2522.  
  2523.  
  2524.  
  2525.  
  2526.  
  2527.                  Job Monitoring MIB, V0.83     July 14, 1997
  2528.  
  2529.  
  2530.  
  2531.         In the following definitions of the enums, each description
  2532.         indicates whether the useful value of the attribute SHALL be
  2533.         represented using the jmAttributeValueAsInteger or the
  2534.         jmAttributeValueAsOctets objects by the initial tag: 'INTEGER:'
  2535.         or 'OCTETS:', respectively.
  2536.  
  2537.         Some attributes allow the agent implementer a choice of useful
  2538.         values of either an integer, an octets representation, or both,
  2539.         depending on implementation.  These attributes are indicated
  2540.         with 'INTEGER:' AND/OR 'OCTETS:' tags.
  2541.  
  2542.         A very few attributes require both objects at the same time to
  2543.         represent a pair of useful values (see mediumConsumed(171)).
  2544.         These attributes are indicated with 'INTEGER:' AND 'OCTETS:'
  2545.         tags.  See the jmAttributeGroup for the descriptions of these
  2546.         two MANDATORY objects.
  2547.  
  2548.         NOTE - The enum assignments are grouped logically with values
  2549.         assigned in groups of 20, so that additional values may be
  2550.         registered in the future and assigned a value that is part of
  2551.         their logical grouping.
  2552.  
  2553.         NOTE: No attribute name exceeds 31 characters.
  2554.  
  2555.         In the following descriptions of each attribute, the tags:
  2556.         'INTEGER:' or 'OCTETS:'  specify whether the value SHALL be
  2557.         represented in the jmAttributeValueAsInteger or the
  2558.         jmAttributeValueAsOctets object, or both, respectively.
  2559.  
  2560.         The standard attribute types defined so far are:
  2561.  
  2562.         jmAttributeTypeIndex              Datatype
  2563.         --------------------              --------
  2564.  
  2565.         other(1),                         Integer32(-2..2147483647)
  2566.                                           AND/OR
  2567.                                           OCTET STRING(SIZE(0..63))
  2568.             INTEGER:  and/or  OCTETS:  An attribute that is not in the
  2569.             list and/or that has not been approved and registered with
  2570.             IANA.
  2571.  
  2572.  
  2573.         +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  2574.         + Job State attributes
  2575.         +
  2576.         + The following attributes specify the state of a job.
  2577.         +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  2578.  
  2579.  
  2580.  
  2581. Bergman, Hastings, Isaacson, Lewis                 [Page 43]
  2582.  
  2583.  
  2584.  
  2585.  
  2586.  
  2587.                  Job Monitoring MIB, V0.83     July 14, 1997
  2588.  
  2589.  
  2590.  
  2591.         jobStateReasons2(3),              JmJobStateReasons2TC
  2592.             INTEGER:  Additional information about the job's current
  2593.             state that augments the jmJobState object.  See the
  2594.             description under the JmJobStateReasons1TC textual-
  2595.             convention.
  2596.  
  2597.         jobStateReasons3(4),              JmJobStateReasons3TC
  2598.             INTEGER:  Additional information about the job's current
  2599.             state that augments the jmJobState object.  See the
  2600.             description under JmJobStateReasons1TC textual-convention.
  2601.  
  2602.         jobStateReasons4(5),              JmJobStateReasons4TC
  2603.             INTEGER:  Additional information about the job's current
  2604.             state that augments the jmJobState object.  See the
  2605.             description under JmJobStateReasons1TC textual-convention.
  2606.  
  2607.         processingMessage(6),             OCTET STRING(SIZE(0..63))
  2608.             OCTETS:  MULTI-ROW:  A coded character set message that is
  2609.             generated during the processing of the job as a simple form
  2610.             of processing log to show progress and any problems.
  2611.  
  2612.             There is no restriction for the same message to occur in
  2613.             multiple rows.
  2614.  
  2615.  
  2616.         +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  2617.         + Job Identification attributes
  2618.         +
  2619.         + The following attributes help an end user, a system
  2620.         + operator, or an accounting program identify a job.
  2621.         +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  2622.  
  2623.  
  2624.  
  2625.         jobAccountName(21),               OCTET STRING(SIZE(0..63))
  2626.             OCTETS:  Arbitrary binary information which MAY be coded
  2627.             character set data or encrypted data supplied by the
  2628.             submitting user for use by accounting services to allocate
  2629.             or categorize charges for services provided, such as a
  2630.             customer account name or number.
  2631.  
  2632.             NOTE: This attribute NEED NOT be printable characters.
  2633.  
  2634.         serverAssignedJobName(22),        OCTET STRING(SIZE(0..63))
  2635.             OCTETS:  Configuration 3 only:  The human readable string
  2636.             name, number, or ID of the job as assigned by the server
  2637.  
  2638.  
  2639.  
  2640.  
  2641. Bergman, Hastings, Isaacson, Lewis                 [Page 44]
  2642.  
  2643.  
  2644.  
  2645.  
  2646.  
  2647.                  Job Monitoring MIB, V0.83     July 14, 1997
  2648.  
  2649.  
  2650.             that submitted the job to the device that the agent is
  2651.             providing access to with this MIB.
  2652.  
  2653.             NOTE - This attribute is intended for enabling a user to
  2654.             find his/her job that a server submitted to a device when
  2655.             either the client does not support the jmJobSubmissionID or
  2656.             the server does not pass the jmJobSubmissionID through to
  2657.             the device.
  2658.  
  2659.         jobName(23),                      OCTET STRING(SIZE(0..63))
  2660.             OCTETS:  The human readable string name of the job as
  2661.             assigned by the submitting user to help the user distinguish
  2662.             between his/her various jobs.  This name does not need to be
  2663.             unique.
  2664.  
  2665.             This attribute is intended for enabling a user or the user's
  2666.             application to convey a job name that MAY be printed on a
  2667.             start sheet, returned in a query result, or used in
  2668.             notification or logging messages.
  2669.  
  2670.             In order to assist users to find their jobs for job
  2671.             submission protocols that don't supply a jmJobSubmissionID,
  2672.             the agent SHOULD maintain the jobName attribute for the time
  2673.             specified by the jmGeneralJobPersistence object, rather than
  2674.             the (shorter) jmGeneralAttributePersistence object.
  2675.  
  2676.             If this attribute is not specified when the job is
  2677.             submitted, no job name is assumed, but implementation
  2678.             specific defaults are allowed, such as the value of the
  2679.             documentName attribute of the first document in the job or
  2680.             the fileName attribute of the first document in the job.
  2681.  
  2682.             The jobName attribute is distinguished from the jobComment
  2683.             attribute, in that the jobName attribute is intended to
  2684.             permit the submitting user to distinguish between different
  2685.             jobs that he/she has submitted.  The jobComment attribute is
  2686.             intended to be free form additional information that a user
  2687.             might wish to use to communicate with himself/herself, such
  2688.             as a reminder of what to do with the results or to indicate
  2689.             a different set of input parameters were tried in several
  2690.             different job submissions.
  2691.  
  2692.         jobServiceTypes(24),              JmJobServiceTypesTC
  2693.             INTEGER:  Specifies the type(s) of service to which the job
  2694.             has been submitted (print, fax, scan, etc.).  The service
  2695.             type is bit encoded with each job service type so that more
  2696.             general and arbitrary services can be created, such as
  2697.             services with more than one destination type, or ones with
  2698.  
  2699.  
  2700.  
  2701. Bergman, Hastings, Isaacson, Lewis                 [Page 45]
  2702.  
  2703.  
  2704.  
  2705.  
  2706.  
  2707.                  Job Monitoring MIB, V0.83     July 14, 1997
  2708.  
  2709.  
  2710.             only a source or only a destination.  For example, a job
  2711.             service might scan, faxOut, and print a single job.  In this
  2712.             case, three bits would be set in the jobServiceTypes
  2713.             attribute, corresponding to the hexadecimal values: 0x8 +
  2714.             0x20 + 0x4, respectively, yielding: 0x2C.
  2715.  
  2716.             Whether this attribute is set from a job attribute supplied
  2717.             by the job submission client or is set by the recipient job
  2718.             submission server or device depends on the job submission
  2719.             protocol.  This attribute SHALL be implemented if the server
  2720.             or device has other types in addition to or instead of
  2721.             printing.
  2722.  
  2723.             One of the purposes of this attribute is to permit a
  2724.             requester to filter out jobs that are not of interest.  For
  2725.             example, a printer operator may only be interested in jobs
  2726.             that include printing.
  2727.  
  2728.             jobSourceChannelIndex(25),    Integer32(0..2147483647)
  2729.             INTEGER:  The index of the row in the associated Printer
  2730.             MIB[print-mib] of the channel which is the source of the
  2731.             print job.
  2732.  
  2733.         jobSourcePlatformType(26),        JmJobSourcePlatformTypeTC
  2734.             INTEGER:  The source platform type of the immediate upstream
  2735.             submitter that submitted the job to the server
  2736.             (configuration 2) or device (configuration 1 and 3) to which
  2737.             the agent is providing access.  For configuration 1, this is
  2738.             the type of the client that submitted the job to the device;
  2739.             for configuration 2, this is the type of the client that
  2740.             submitted the job to the server; and for configuration 3,
  2741.             this is the type of the server that submitted the job to the
  2742.             device.
  2743.  
  2744.         submittingServerName(27),         OCTET STRING(SIZE(0..63))
  2745.             OCTETS:  For configuration 3 only:  The administrative name
  2746.             of the server that submitted the job to the device.
  2747.  
  2748.         submittingApplicationName(28),    OCTET STRING(SIZE(0..63))
  2749.             OCTETS:  The name of the client application (not the server
  2750.             in configuration 3) that submitted the job to the server or
  2751.             device.
  2752.  
  2753.         jobOriginatingHost(29),           OCTET STRING(SIZE(0..63))
  2754.             OCTETS:  The name of the client host (not the server host
  2755.             name in configuration 3) that submitted the job to the
  2756.             server or device.
  2757.  
  2758.  
  2759.  
  2760.  
  2761. Bergman, Hastings, Isaacson, Lewis                 [Page 46]
  2762.  
  2763.  
  2764.  
  2765.  
  2766.  
  2767.                  Job Monitoring MIB, V0.83     July 14, 1997
  2768.  
  2769.  
  2770.         deviceNameRequested(30),          OCTET STRING(SIZE(0..63))
  2771.             OCTETS:  The administratively defined coded character set
  2772.             name of the target device requested by the submitting user.
  2773.             For configuration 1, its value corresponds to the Printer
  2774.             MIB[print-mib]: prtGeneralPrinterName object.  For
  2775.             configuration 2 and 3, its value is the name of the logical
  2776.             or physical device that the user supplied to indicate to the
  2777.             server on which device(s) they wanted the job to be
  2778.             processed.
  2779.  
  2780.         queueNameRequested(31),           OCTET STRING(SIZE(0..63))
  2781.             OCTETS:  The administratively defined coded character set
  2782.             name of the target queue requested by the submitting user.
  2783.             For configuration 1, its value corresponds to the queue in
  2784.             the device for which the agent is providing access.  For
  2785.             configuration 2 and 3, its value is the name of the queue
  2786.             that the user supplied to indicate to the server on which
  2787.             device(s) they wanted the job to be processed.
  2788.  
  2789.             NOTE - typically an implementation SHOULD support either the
  2790.             deviceNameRequested or queueNameRequested attribute, but not
  2791.             both.
  2792.  
  2793.         physicalDevice(32),               hrDeviceIndex (see HR MIB)
  2794.                                           AND/OR
  2795.                                           OCTET STRING(SIZE(0..63))
  2796.             INTEGER:  MULTI-ROW:  The index of the physical device MIB
  2797.             instance requested/used, such as the Printer MIB[print-mib].
  2798.             This value is an hrDeviceIndex value.  See the Host
  2799.             Resources MIB[hr-mib].
  2800.  
  2801.             AND/OR
  2802.  
  2803.             OCTETS:  MULTI-ROW:  The name of the physical device to
  2804.             which the job is assigned.
  2805.  
  2806.         numberOfDocuments(33),            Integer32(-2..2147483647)
  2807.             INTEGER:  The number of documents in this job.
  2808.  
  2809.         fileName(34),                     OCTET STRING(SIZE(0..63))
  2810.             OCTETS:  MULTI-ROW:  The coded character set file name or
  2811.             URI[URI-spec] of the document.
  2812.  
  2813.             There is no restriction on the same file name in multiple
  2814.             rows.
  2815.  
  2816.  
  2817.  
  2818.  
  2819.  
  2820.  
  2821. Bergman, Hastings, Isaacson, Lewis                 [Page 47]
  2822.  
  2823.  
  2824.  
  2825.  
  2826.  
  2827.                  Job Monitoring MIB, V0.83     July 14, 1997
  2828.  
  2829.  
  2830.         documentName(35),                 OCTET STRING(SIZE(0..63))
  2831.             OCTETS:  MULTI-ROW:  The coded character set name of the
  2832.             document.
  2833.  
  2834.             There is no restriction on the same document name in
  2835.             multiple rows.
  2836.  
  2837.         jobComment(36),                   OCTET STRING(SIZE(0..63))
  2838.             OCTETS:  An arbitrary human-readable coded character text
  2839.             string supplied by the submitting user or the job submitting
  2840.             application program for any purpose.  For example, a user
  2841.             might indicate what he/she is going to do with the printed
  2842.             output or the job submitting application program might
  2843.             indicate how the document was produced.
  2844.  
  2845.             The jobComment attribute is not intended to be a name; see
  2846.             the jobName attribute.
  2847.  
  2848.         documentFormatIndex(37),          Integer32(0..2147483647)
  2849.             INTEGER:  MULTI-ROW:  The index in the prtInterpreterTable
  2850.             in the Printer MIB[print-mib] of the page description
  2851.             language (PDL) or control language interpreter that this job
  2852.             requires/uses.  A document or a job MAY use more than one
  2853.             PDL or control language.
  2854.  
  2855.             NOTE - As with all intensive attributes where multiple rows
  2856.             are allowed, there SHALL be only one distinct row for each
  2857.             distinct interpreter; there SHALL be no duplicates.
  2858.  
  2859.             NOTE - This attribute type is intended to be used with an
  2860.             agent that implements the Printer MIB and SHALL not be used
  2861.             if the agent does not implement the Printer MIB.  Such an
  2862.             agent SHALL use the documentFormat attribute instead.
  2863.  
  2864.         documentFormat(38),               PrtInterpreterLangFamilyTC
  2865.                                           AND/OR
  2866.                                           OCTET STRING(SIZE(0..63))
  2867.             INTEGER:  MULTI-ROW:  The interpreter language family
  2868.             corresponding to the Printer MIB[print-mib]
  2869.             prtInterpreterLangFamily object, that this job
  2870.             requires/uses.  A document or a job MAY use more than one
  2871.             PDL or control language.
  2872.  
  2873.             AND/OR
  2874.  
  2875.             OCTETS:  MULTI-ROW:  The document format registered as a
  2876.             media type[iana-media-types], i.e., the name of the MIME
  2877.  
  2878.  
  2879.  
  2880.  
  2881. Bergman, Hastings, Isaacson, Lewis                 [Page 48]
  2882.  
  2883.  
  2884.  
  2885.  
  2886.  
  2887.                  Job Monitoring MIB, V0.83     July 14, 1997
  2888.  
  2889.  
  2890.             content-type/subtype.  Examples: 'application/postscript',
  2891.             'application/vnd.hp-PCL', and 'application/pdf'
  2892.  
  2893.  
  2894.         +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  2895.         + Job Parameter attributes
  2896.         +
  2897.         + The following attributes represent input parameters
  2898.         + supplied by the submitting client in the job submission
  2899.         + protocol.
  2900.         +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  2901.  
  2902.         jobPriority(50),                  Integer32(1..100)
  2903.             INTEGER:  The priority for scheduling the job. It is used by
  2904.             servers and devices that employ a priority-based scheduling
  2905.             algorithm.
  2906.  
  2907.             A higher value specifies a higher priority. The value 1 is
  2908.             defined to indicate the lowest possible priority (a job
  2909.             which a priority-based scheduling algorithm SHALL pass over
  2910.             in favor of higher priority jobs). The value 100 is defined
  2911.             to indicate the highest possible priority. Priority is
  2912.             expected to be evenly or 'normally' distributed across this
  2913.             range. The mapping of vendor-defined priority over this
  2914.             range is implementation-specific.
  2915.  
  2916.             jobProcessAfterDateAndTime(51), DateAndTime (SNMPv2-TC)
  2917.             OCTETS:  The calendar date and time of day after which the
  2918.             job SHALL become a candidate to be scheduled for processing.
  2919.             If the value of this attribute is in the future, the server
  2920.             SHALL set the value of the job's jmJobState object to
  2921.             pendingHeld and add the jobProcessAfterSpecified bit value
  2922.             to the job's jmJobStateReasons1 object.  When the specified
  2923.             date and time arrives, the server SHALL remove the
  2924.             jobProcessAfterSpecified bit value from the job's
  2925.             jmJobStateReasons1 object and, if no other reasons remain,
  2926.             SHALL change the job's jmJobState object to pending.
  2927.  
  2928.         jobHold(52),                      JmBooleanTC
  2929.             INTEGER:  If the value is 'true(4)', a client has explicitly
  2930.             specified that the job is to be held until explicitly
  2931.             released.  Until the job is explicitly released by a client,
  2932.             the job SHALL be in the pendingHeld state with the
  2933.             jobHoldSpecified value in the jmJobStateReasons1 attribute.
  2934.  
  2935.         jobHoldUntil(53),                 OCTET STRING(SIZE(0..63))
  2936.             OCTETS:  The named time period during which the job SHALL
  2937.             become a candidate for processing, such as 'no-hold',
  2938.  
  2939.  
  2940.  
  2941. Bergman, Hastings, Isaacson, Lewis                 [Page 49]
  2942.  
  2943.  
  2944.  
  2945.  
  2946.  
  2947.                  Job Monitoring MIB, V0.83     July 14, 1997
  2948.  
  2949.  
  2950.             'evening', 'night', 'weekend', 'second-shift', 'third-
  2951.             shift', etc., as defined by the system administrator.  Until
  2952.             that time period arrives, the job SHALL be in the
  2953.             pendingHeld state with the jobHoldUntilSpecified value in
  2954.             the jmJobStateReasons1 object.
  2955.  
  2956.         outputBin(54),                    Integer32(0..2147483647)
  2957.                                           AND/OR
  2958.                                           OCTET STRING(SIZE(0..63))
  2959.             INTEGER:  MULTI-ROW:  The output subunit index in the
  2960.             Printer MIB[print-mib]
  2961.  
  2962.             AND/OR
  2963.  
  2964.             OCTETS:  the name or number (represented as ASCII digits) of
  2965.             the output bin to which all or part of the job is placed in.
  2966.  
  2967.         sides(55),                        Integer32(-2..2)
  2968.             INTEGER:  MULTI-ROW:  The number of sides, '1' or '2', that
  2969.             any document in this job requires/used.
  2970.  
  2971.         finishing(56),                    JmFinishingTC
  2972.             INTEGER:  MULTI-ROW:  Type of finishing that any document in
  2973.             this job requires/used.
  2974.  
  2975.  
  2976.         +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  2977.         + Image Quality attributes (requested and consumed)
  2978.         +
  2979.         + For devices that can vary the image quality.
  2980.         +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  2981.  
  2982.         printQualityRequested(70),        JmPrintQualityTC
  2983.             INTEGER:  MULTI-ROW:  The print quality selection requested
  2984.             for a document in the job for printers that allow quality
  2985.             differentiation.
  2986.  
  2987.         printQualityUsed(71),             JmPrintQualityTC
  2988.             INTEGER:  MULTI-ROW:  The print quality selection actually
  2989.             used by a document in the job for printers that allow
  2990.             quality differentiation.
  2991.  
  2992.         printerResolutionRequested(72),   JmPrinterResolutionTC
  2993.             INTEGER:  MULTI-ROW:  The printer resolution requested for a
  2994.             document in the job for printers that support resolution
  2995.             selection.
  2996.  
  2997.  
  2998.  
  2999.  
  3000.  
  3001. Bergman, Hastings, Isaacson, Lewis                 [Page 50]
  3002.  
  3003.  
  3004.  
  3005.  
  3006.  
  3007.                  Job Monitoring MIB, V0.83     July 14, 1997
  3008.  
  3009.  
  3010.         printerResolutionUsed(73),        JmPrinterResolutionTC
  3011.             INTEGER:  MULTI-ROW:  The printer resolution actually used
  3012.             by a document in the job for printers that support
  3013.             resolution selection.
  3014.  
  3015.         tonerEcomonyRequested(74),        JmTonerEconomyTC
  3016.             INTEGER:  MULTI-ROW:  The print quality selection requested
  3017.             for documents in the job for printers that allow toner
  3018.             quality differentiation.
  3019.  
  3020.         tonerEcomonyUsed(75),             JmTonerEconomyTC
  3021.             INTEGER:  MULTI-ROW:  The print quality selection actually
  3022.             used by documents in the job for printers that allow toner
  3023.             quality differentiation.
  3024.  
  3025.         tonerDensityRequested(76),        Integer32(-2..100)
  3026.             INTEGER:  MULTI-ROW:  The toner density requested for a
  3027.             document in this job for devices that can vary toner density
  3028.             levels.  Level 1 is the lowest density and level 100 is the
  3029.             highest density level.  Devices with a smaller range, SHALL
  3030.             map the 1-100 range evenly onto the implemented range.
  3031.  
  3032.         tonerDensityUsed(77),             Integer32(-2..100)
  3033.             INTEGER:  MULTI-ROW:  The toner density used by documents in
  3034.             this job for devices that can vary toner density levels.
  3035.             Level 1 is the lowest density and level 100 is the highest
  3036.             density level.  Devices with a smaller range, SHALL map the
  3037.             1-100 range evenly onto the implemented range.
  3038.  
  3039.  
  3040.         +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  3041.         + Job Progress attributes (requested and consumed)
  3042.         +
  3043.         + Pairs of these attributes can be used by monitoring
  3044.         + applications to show an indication of relative progress
  3045.         + to users.
  3046.         +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  3047.  
  3048.         jobCopiesRequested(90),           Integer32(-2..2147483647)
  3049.             INTEGER:  The number of copies of the entire job that are to
  3050.             be produced.
  3051.  
  3052.         jobCopiesCompleted(91),           Integer32(-2..2147483647)
  3053.             INTEGER:  The number of copies of the entire job that have
  3054.             been completed so far.
  3055.  
  3056.         documentCopiesRequested(92),      Integer32(-2..2147483647)
  3057.             INTEGER:  The total count of the number of document copies
  3058.  
  3059.  
  3060.  
  3061. Bergman, Hastings, Isaacson, Lewis                 [Page 51]
  3062.  
  3063.  
  3064.  
  3065.  
  3066.  
  3067.                  Job Monitoring MIB, V0.83     July 14, 1997
  3068.  
  3069.  
  3070.             requested.  If there are documents A, B, and C, and document
  3071.             B is specified to produce 4 copies, the number of document
  3072.             copies requested is 6 for the job.
  3073.  
  3074.             This attribute SHALL be used only when a job has multiple
  3075.             documents.  The jobCopiesRequested attribute SHALL be used
  3076.             when the job has only one document.
  3077.  
  3078.         documentCopiesCompleted(93),      Integer32(-2..2147483647)
  3079.             INTEGER:  The total count of the number of document copies
  3080.             completed so far for the job as a whole.  If there are
  3081.             documents A, B, and C, and document B is specified to
  3082.             produce 4 copies, the number of document copies starts a 0
  3083.             and runs up to 6 for the job as the job processes.
  3084.  
  3085.             This attribute SHALL be used only when a job has multiple
  3086.             documents.  The jobCopiesCompleted attribute SHALL be used
  3087.             when the job has only one document.
  3088.  
  3089.         jobKOctetsTransferred(94),        Integer32(-2..2147483647)
  3090.             INTEGER:  The number of K (1024) octets transferred to the
  3091.             server or device to which the agent is providing access.
  3092.             This count is independent of the number of copies of the job
  3093.             or documents that will be produced, but it is only a measure
  3094.             of the number of bytes transferred to the server or device.
  3095.  
  3096.             The agent SHALL round the actual number of octets
  3097.             transferred up to the next higher K.  Thus 0 octets SHALL be
  3098.             represented as '0', 1-1024 octets SHALL BE represented as
  3099.             '1', 1025-2048 SHALL be '2', etc.  When the job completes,
  3100.             the values of the jmJobKOctetsRequested object and the
  3101.             jobKOctetsTransferred attribute SHALL be equal.
  3102.  
  3103.             NOTE - The jobKOctetsTransferred can be used with the
  3104.             jmJobKOctetsRequested object in order to produce a relative
  3105.             indication of the progress of the job for agents that do not
  3106.             implement the jmJobKOctetsProcessed object.
  3107.  
  3108.  
  3109.         ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  3110.         + Impression attributes
  3111.         +
  3112.         + For a print job, an impression is the marking of the
  3113.         + entire side of a sheet.  Two-sided processing involves two
  3114.         + impressions per sheet.  Two-up is the placement of two
  3115.         + logical pages on one side of a sheet and so is still a
  3116.         + single impression.  See also jmJobImpressionsRequested and
  3117.         + jmJobImpressionsCompleted objects in the jmJobTable.
  3118.  
  3119.  
  3120.  
  3121. Bergman, Hastings, Isaacson, Lewis                 [Page 52]
  3122.  
  3123.  
  3124.  
  3125.  
  3126.  
  3127.                  Job Monitoring MIB, V0.83     July 14, 1997
  3128.  
  3129.  
  3130.         ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  3131.  
  3132.         impressionsSpooled(110),          Integer32(-2..2147483647)
  3133.             INTEGER:  The number of impressions spooled to the server or
  3134.             device for the job so far.
  3135.  
  3136.         impressionsSentToDevice(111),     Integer32(-2..2147483647)
  3137.             INTEGER:  The number of impressions sent to the device for
  3138.             the job so far.
  3139.  
  3140.         impressionsInterpreted(112),      Integer32(-2..2147483647)
  3141.             INTEGER:  The number of impressions interpreted for the job
  3142.             so far.
  3143.  
  3144.         impressionsCompletedCurrentCopy(113), Integer32(-2..2147483647)
  3145.             INTEGER:  The number of impressions completed by the device
  3146.             for the current copy of the current document so far.  For
  3147.             printing, the impressions completed includes interpreting,
  3148.             marking, and stacking the output.  For other types of job
  3149.             services, the number of impressions completed includes the
  3150.             number of impressions processed.
  3151.  
  3152.             This value SHALL be reset to 0 for each document in the job
  3153.             and for each document copy.
  3154.  
  3155.         fullColorImpressionsCompleted(114), Integer32(-2..2147483647)
  3156.             INTEGER:  The number of full color impressions completed by
  3157.             the device for this job so far.  For printing, the
  3158.             impressions completed includes interpreting, marking, and
  3159.             stacking the output.  For other types of job services, the
  3160.             number of impressions completed includes the number of
  3161.             impressions processed. Full color impressions are typically
  3162.             defined as those requiring 3 or more colorants, but this MAY
  3163.             vary by implementation.
  3164.  
  3165.         highlightColorImpressionsCompleted(115),  Integer32(-2..
  3166.                                           2147483647)
  3167.             INTEGER:  The number of highlight color impressions
  3168.             completed by the device for this job so far.  For printing,
  3169.             the impressions completed includes interpreting, marking,
  3170.             and stacking the output.  For other types of job services,
  3171.             the number of impressions completed includes the number of
  3172.             impressions processed.  Highlight color impressions are
  3173.             typically defined as those requiring black plus one other
  3174.             colorant, but this MAY vary by implementation.
  3175.  
  3176.  
  3177.         +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  3178.  
  3179.  
  3180.  
  3181. Bergman, Hastings, Isaacson, Lewis                 [Page 53]
  3182.  
  3183.  
  3184.  
  3185.  
  3186.  
  3187.                  Job Monitoring MIB, V0.83     July 14, 1997
  3188.  
  3189.  
  3190.         + Page attributes
  3191.         +
  3192.         + A page is a logical page.  Number up can impose more than
  3193.         + one page on a single side of a sheet.  Two-up is the
  3194.         + placement of two logical pages on one side of a sheet so
  3195.         + that each side counts as two pages.
  3196.         +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  3197.  
  3198.         pagesRequested(130),              Integer32(-2..2147483647)
  3199.             INTEGER:  The number of logical pages requested by the job
  3200.             to be processed.
  3201.  
  3202.         pagesCompleted(131),              Integer32(-2..2147483647)
  3203.             INTEGER:  The number of logical pages completed for this job
  3204.             so far.
  3205.  
  3206.         pagesCompletedCurrentCopy(132),   Integer32(-2..2147483647)
  3207.             INTEGER:  The number of logical pages completed for the
  3208.             current copy of the document so far.  This value SHALL be
  3209.             reset to 0 for each document in the job and for each
  3210.             document copy.
  3211.  
  3212.  
  3213.         +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  3214.         + Sheet attributes
  3215.         +
  3216.         + The sheet is a single piece of a medium, whether printing
  3217.         + on one or both sides.
  3218.         +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  3219.  
  3220.         sheetsRequested(150),             Integer32(-2..2147483647)
  3221.             INTEGER:  The number of medium sheets requested to be
  3222.             processed for this job.
  3223.  
  3224.         sheetsCompleted(151),             Integer32(-2..2147483647)
  3225.             INTEGER:  The number of medium sheets that have completed
  3226.             marking and stacking for the entire job so far whether those
  3227.             sheets have been processed on one side or on both.
  3228.  
  3229.         sheetsCompletedCurrentCopy(152),  Integer32(-2..2147483647)
  3230.             INTEGER:  The number of medium sheets that have completed
  3231.             marking and stacking for the current copy of a document in
  3232.             the job so far whether those sheets have been processed on
  3233.             one side or on both.
  3234.  
  3235.             The value of this attribute SHALL be reset to 0 as each
  3236.             document in the job starts being processed and for each
  3237.             document copy as it starts being processed.
  3238.  
  3239.  
  3240.  
  3241. Bergman, Hastings, Isaacson, Lewis                 [Page 54]
  3242.  
  3243.  
  3244.  
  3245.  
  3246.  
  3247.                  Job Monitoring MIB, V0.83     July 14, 1997
  3248.  
  3249.  
  3250.  
  3251.  
  3252.         ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  3253.         + Resources attributes (requested and consumed)
  3254.         +
  3255.         + Pairs of these attributes can be used by monitoring
  3256.         + applications to show an indication of relative usage to
  3257.         + users.
  3258.         ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  3259.  
  3260.         mediumRequested(170),             JmMediumTypeTC
  3261.                                           AND/OR
  3262.                                           OCTET STRING(SIZE(0..63))
  3263.             INTEGER:  MULTI-ROW:  The type
  3264.             AND/OR
  3265.             OCTETS:  the name of the medium that is required by the job.
  3266.  
  3267.         mediumConsumed(171),              Integer32(-2..2147483647)
  3268.                                           AND
  3269.                                           OCTET STRING(SIZE(0..63))
  3270.             INTEGER:  The number of sheets
  3271.             AND
  3272.             OCTETS: MULTI-ROW:  the name of the medium that have been
  3273.             consumed so far whether those sheets have been processed on
  3274.             one side or on both.
  3275.  
  3276.             This attribute SHALL have both Integer32 and OCTET STRING
  3277.             values.
  3278.  
  3279.         colorantRequested(172),           Integer32(-2..2147483647)
  3280.                                           AND/OR
  3281.                                           OCTET STRING(SIZE(0..63))
  3282.             INTEGER:  MULTI-ROW:  The index (prtMarkerColorantIndex) in
  3283.             the Printer MIB[print-mib]
  3284.             AND/OR
  3285.             OCTETS:  the name of the colorant requested.
  3286.  
  3287.         colorantConsumed(173),            Integer32(-2..2147483647)
  3288.                                           AND/OR
  3289.                                           OCTET STRING(SIZE(0..63))
  3290.             INTEGER:  MULTI-ROW:  The index (prtMarkerColorantIndex) in
  3291.             the Printer MIB[print-mib]
  3292.             AND/OR
  3293.             OCTETS: the name of the colorant consumed.
  3294.  
  3295.  
  3296.         +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  3297.         + Time attributes (set by server or device)
  3298.  
  3299.  
  3300.  
  3301. Bergman, Hastings, Isaacson, Lewis                 [Page 55]
  3302.  
  3303.  
  3304.  
  3305.  
  3306.  
  3307.                  Job Monitoring MIB, V0.83     July 14, 1997
  3308.  
  3309.  
  3310.         +
  3311.         + This section of attributes are ones that are set by the
  3312.         + server or device that accepts jobs.  Two forms of time are
  3313.         + provided.  Each form is represented in a separate attribute.
  3314.         + See section 3.1.2 and section 3.1.3 for the
  3315.         + conformance requirements for time attribute for agents and
  3316.         + monitoring applications, respectively.  The two forms are:
  3317.         +
  3318.         + 'DateAndTime' is an 8 or 11 octet binary encoded year,
  3319.         + month, day, hour, minute, second, deci-second with
  3320.         + optional offset from UTC.  See SNMPv2-TC.
  3321.         +
  3322.         + NOTE: 'DateAndTime' is not printable characters; it is
  3323.         + binary.
  3324.         +
  3325.         + 'JmTimeStampTC' is the time of day measured in the number of
  3326.         + seconds since the system was booted.
  3327.         +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  3328.  
  3329.         jobSubmissionToServerTime(190),   JmTimeStampTC
  3330.                                           AND/OR
  3331.                                           DateAndTime (SNMPv2-TC)
  3332.             INTEGER:  Configuration 3 only:  The time
  3333.             AND/OR
  3334.             OCTETS:  the date and time that the job was submitted to the
  3335.             server (as distinguished from the device which uses
  3336.             jobSubmissionTime).
  3337.  
  3338.         jobSubmissionTime(191),           JmTimeStampTC
  3339.                                           AND/OR
  3340.                                           DateAndTime (SNMPv2-TC)
  3341.             INTEGER:  Configurations 1, 2, and 3:  The time
  3342.             AND/OR
  3343.             OCTETS:  the date and time that the job was submitted to the
  3344.             server or device to which the agent is providing access.
  3345.  
  3346.  
  3347.  
  3348.         jobStartedBeingHeldTime(192),     JmTimeStampTC
  3349.                                           AND/OR
  3350.                                           DateAndTime (SNMPv2-TC)
  3351.             INTEGER:  The time
  3352.             AND/OR
  3353.             OCTETS:  the date and time that the job last entered the
  3354.             pendingHeld state.  If the job has never entered the
  3355.             pendingHeld state, then the value SHALL be '0' or the
  3356.             attribute SHALL not be present in the table.
  3357.  
  3358.  
  3359.  
  3360.  
  3361. Bergman, Hastings, Isaacson, Lewis                 [Page 56]
  3362.  
  3363.  
  3364.  
  3365.  
  3366.  
  3367.                  Job Monitoring MIB, V0.83     July 14, 1997
  3368.  
  3369.  
  3370.         jobStartedProcessingTime(193),    JmTimeStampTC
  3371.                                           AND/OR
  3372.                                           DateAndTime (SNMPv2-TC)
  3373.             INTEGER:  The time
  3374.             AND/OR
  3375.             OCTETS:  the date and time that the job started processing.
  3376.  
  3377.             jobCompletedTime(194),        JmTimeStampTC
  3378.                                           AND/OR
  3379.                                           DateAndTime (SNMPv2-TC)
  3380.             INTEGER:  The time
  3381.             AND/OR
  3382.             OCTETS:  the date and time that the job entered the
  3383.             completed, canceled, or aborted state.
  3384.  
  3385.             jobProcessingCPUTime(195)     Integer32(-2..2147483647)
  3386.             UNITS     'seconds'
  3387.             INTEGER:  The amount of CPU time in seconds that the job has
  3388.             been in the processing state.  If the job enters the
  3389.             processingStopped state, that elapsed time SHALL not be
  3390.             included.  In other words, the jobProcessingCPUTime value
  3391.             SHOULD be relatively repeatable when the same job is
  3392.             processed again on the same device."
  3393.  
  3394.     REFERENCE
  3395.         "See Section 3.2 entitled 'When the server or device is power-
  3396.         cycled, the agent SHALL remember the next jmJobIndex value to be
  3397.         assigned, so that new jobs are not assigned the same jmJobIndex
  3398.         as recent jobs before the power cycle.
  3399.         The Attribute Mechanism' for a description of this textual-
  3400.         convention and its use in the jmAttributeTable.
  3401.  
  3402.         This is a type 2 enumeration.  See Section 3.6.1.2."
  3403.     SYNTAX      INTEGER {
  3404.         other(1),
  3405.         unknown(2),
  3406.         jobStateReasons2(3),
  3407.         jobStateReasons3(4),
  3408.         jobStateReasons4(5),
  3409.         processingMessage(6),
  3410.  
  3411.         jobAccountName(21),
  3412.         serverAssignedJobName(22),
  3413.         jobName(23),
  3414.         jobServiceTypes(24),
  3415.         jobSourceChannelIndex(25),
  3416.         jobSourcePlatformType(26),
  3417.         submittingServerName(27),
  3418.  
  3419.  
  3420.  
  3421. Bergman, Hastings, Isaacson, Lewis                 [Page 57]
  3422.  
  3423.  
  3424.  
  3425.  
  3426.  
  3427.                  Job Monitoring MIB, V0.83     July 14, 1997
  3428.  
  3429.  
  3430.         submittingApplicationName(28),
  3431.         jobOriginatingHost(29),
  3432.         deviceNameRequested(30),
  3433.         queueNameRequested(31),
  3434.         physicalDevice(32),
  3435.         numberOfDocuments(33),
  3436.         fileName(34),
  3437.         documentName(35),
  3438.         jobComment(36),
  3439.         documentFormatIndex(37),
  3440.         documentFormat(38),
  3441.  
  3442.         jobPriority(50),
  3443.         jobProcessAfterDateAndTime(51),
  3444.         jobHold(52),
  3445.         jobHoldUntil(53),
  3446.         outputBin(54),
  3447.         sides(55),
  3448.         finishing(56),
  3449.  
  3450.         printQualityRequested(70),
  3451.         printQualityUsed(71),
  3452.         printerResolutionRequested(72),
  3453.         printerResolutionUsed(73),
  3454.         tonerEcomonyRequested(74),
  3455.         tonerEcomonyUsed(75),
  3456.         tonerDensityRequested(76),
  3457.         tonerDensityUsed(77),
  3458.  
  3459.         jobCopiesRequested(90),
  3460.         jobCopiesCompleted(91),
  3461.         documentCopiesRequested(92),
  3462.         documentCopiesCompleted(93),
  3463.         jobKOctetsTransferred(94),
  3464.  
  3465.         impressionsSpooled(110),
  3466.         impressionsSentToDevice(111),
  3467.         impressionsInterpreted(112),
  3468.         impressionsCompletedCurrentCopy(113),
  3469.         fullColorImpressionsCompleted(114),
  3470.         highlightColorImpressionsCompleted(115),
  3471.  
  3472.         pagesRequested(130),
  3473.         pagesCompleted(131),
  3474.         pagesCompletedCurrentCopy(132),
  3475.  
  3476.         sheetsRequested(150),
  3477.         sheetsCompleted(151),
  3478.  
  3479.  
  3480.  
  3481. Bergman, Hastings, Isaacson, Lewis                 [Page 58]
  3482.  
  3483.  
  3484.  
  3485.  
  3486.  
  3487.                  Job Monitoring MIB, V0.83     July 14, 1997
  3488.  
  3489.  
  3490.         sheetsCompletedCurrentCopy(152),
  3491.  
  3492.         mediumRequested(170),
  3493.         mediumConsumed(171),
  3494.         colorantRequested(172),
  3495.         colorantConsumed(173),
  3496.  
  3497.         jobSubmissionToServerTime(190),
  3498.         jobSubmissionTime(191),
  3499.         jobStartedBeingHeldTime(192),
  3500.         jobStartedProcessingTime(193),
  3501.         jobCompletedTime(194),
  3502.         jobProcessingCPUTime(195)
  3503.     }
  3504.  
  3505.  
  3506.  
  3507.  
  3508.  
  3509. JmJobServiceTypesTC ::= TEXTUAL-CONVENTION
  3510.     STATUS      current
  3511.     DESCRIPTION
  3512.         "Specifies the type(s) of service to which the job has been
  3513.         submitted (print, fax, scan, etc.).  The service type is
  3514.         represented as an enum that is bit encoded with each job service
  3515.         type so that more general and arbitrary services can be created,
  3516.         such as services with more than one destination type, or ones
  3517.         with only a source or only a destination.  For example, a job
  3518.         service might scan, faxOut, and print a single job.  In this
  3519.         case, three bits would be set in the jobServiceTypes attribute,
  3520.         corresponding to the hexadecimal values: 0x8 + 0x20 + 0x4,
  3521.         respectively, yielding: 0x2C.
  3522.  
  3523.         Whether this attribute is set from a job attribute supplied by
  3524.         the job submission client or is set by the recipient job
  3525.         submission server or device depends on the job submission
  3526.         protocol.  With either implementation, the agent SHALL return a
  3527.         non-zero value for this attribute indicating the type of the
  3528.         job.
  3529.  
  3530.         One of the purposes of this attribute is to permit a requester
  3531.         to filter out jobs that are not of interest.  For example, a
  3532.         printer operator MAY only be interested in jobs that include
  3533.         printing.  That is why the attribute is in the job
  3534.         identification category.
  3535.  
  3536.  
  3537.  
  3538.  
  3539.  
  3540.  
  3541. Bergman, Hastings, Isaacson, Lewis                 [Page 59]
  3542.  
  3543.  
  3544.  
  3545.  
  3546.  
  3547.                  Job Monitoring MIB, V0.83     July 14, 1997
  3548.  
  3549.  
  3550.         The following service component types are defined (in
  3551.         hexadecimal) and are assigned a separate bit value for use with
  3552.         the jobServiceTypes attribute:
  3553.  
  3554.         other                             0x1
  3555.             The job contains some instructions that are not one of the
  3556.             identified types.
  3557.  
  3558.         unknown                           0x2
  3559.             The job contains some instructions whose type is unknown to
  3560.             the agent.
  3561.  
  3562.         print                             0x4
  3563.             The job contains some instructions that specify printing
  3564.  
  3565.         scan                              0x8
  3566.             The job contains some instructions that specify scanning
  3567.  
  3568.         faxIn                             0x10
  3569.             The job contains some instructions that specify receive fax
  3570.  
  3571.         faxOut                            0x20
  3572.             The job contains some instructions that specify sending fax
  3573.  
  3574.         getFile                           0x40
  3575.             The job contains some instructions that specify accessing
  3576.             files or documents
  3577.  
  3578.         putFile                           0x80
  3579.             The job contains some instructions that specify storing
  3580.             files or documents
  3581.  
  3582.         mailList                          0x100
  3583.             The job contains some instructions that specify distribution
  3584.             of documents using an electronic mail system."
  3585.     REFERENCE
  3586.         "These bit definitions are the equivalent of a type 2 enum
  3587.         except that combinations of them MAY be used together.  See
  3588.         section 3.6.1.2."
  3589.     SYNTAX      INTEGER(0..2147483647)   -- 31 bits, all but sign bit
  3590.  
  3591.  
  3592.  
  3593.  
  3594.  
  3595.  
  3596.  
  3597.  
  3598.  
  3599.  
  3600.  
  3601. Bergman, Hastings, Isaacson, Lewis                 [Page 60]
  3602.  
  3603.  
  3604.  
  3605.  
  3606.  
  3607.                  Job Monitoring MIB, V0.83     July 14, 1997
  3608.  
  3609.  
  3610. JmJobStateReasons1TC ::= TEXTUAL-CONVENTION
  3611.     STATUS      current
  3612.     DESCRIPTION
  3613.         "The JmJobStateReasonsNTC (N=1..4) textual-conventions are used
  3614.         with the jmJobStateReasons1 object and jobStateReasonsN
  3615.         (N=2..4), respectively, to provides additional information
  3616.         regarding the current jmJobState object value.  These values MAY
  3617.         be used with any job state or states for which the reason makes
  3618.         sense.
  3619.  
  3620.         NOTE - While values cannot be added to the jmJobState object
  3621.         without impacting deployed clients that take actions upon
  3622.         receiving jmJobState values, it is the intent that additional
  3623.         JmJobStateReasonsNTC enums can be defined and registered without
  3624.         impacting such deployed clients.  In other words, the
  3625.         jmJobStateReasons1 object and jobStateReasonsN attributes are
  3626.         intended to be extensible.
  3627.  
  3628.         NOTE - The Job Monitoring MIB contains a superset of the IPP
  3629.         values[ipp-model] for the IPP 'job-state-reasons' attribute,
  3630.         since the Job Monitoring MIB is intended to cover other job
  3631.         submission protocols as well.  Also some of the names of the
  3632.         reasons have been changed from 'printer' to 'device', since the
  3633.         Job Monitoring MIB is intended to cover additional types of
  3634.         devices, including input devices, such as scanners.
  3635.  
  3636.         The following standard values are defined (in hexadecimal) as
  3637.         powers of two, since multiple values MAY be used at the same
  3638.         time.  For ease of understanding, the JmJobStateReasons1TC
  3639.         reasons are presented in the order in which the reason is most
  3640.         likely to occur, not counting the 'other' and 'unknown' reasons.
  3641.  
  3642.         other                             0x1
  3643.             The job state reason is not one of the standardized or
  3644.             registered reasons.
  3645.  
  3646.         unknown                           0x2
  3647.             The job state reason is not known to the agent or is
  3648.             indeterminent.
  3649.  
  3650.         jobIncoming                       0x4
  3651.             The job has been accepted by the server or device, but the
  3652.             server or device is expecting (1) additional operations from
  3653.             the client to finish creating the job and/or (2) is
  3654.             accessing/accepting document data.
  3655.  
  3656.  
  3657.  
  3658.  
  3659.  
  3660.  
  3661. Bergman, Hastings, Isaacson, Lewis                 [Page 61]
  3662.  
  3663.  
  3664.  
  3665.  
  3666.  
  3667.                  Job Monitoring MIB, V0.83     July 14, 1997
  3668.  
  3669.  
  3670.         jobOutgoing                       0x8
  3671.             Configuration 2 only:  The server is transmitting the job to
  3672.             the device.
  3673.  
  3674.         jobHoldSpecified                  0x10
  3675.             The value of the job's jobHold(52) attribute is TRUE.  The
  3676.             job SHALL NOT be a candidate for processing until this
  3677.             reason is removed and there are no other reasons to hold the
  3678.             job.
  3679.  
  3680.         jobHoldUntilSpecified             0x20
  3681.             The value of the job's jobHoldUntil(53) attribute specifies
  3682.             a time period that is still in the future.  The job SHALL
  3683.             NOT be a candidate for processing until this reason is
  3684.             removed and there are no other reasons to hold the job.
  3685.  
  3686.         jobProcessAfterSpecified          0x40
  3687.             The value of the job's jobProcessAfterDateAndTime(51)
  3688.             attribute specifies a time that is still in the future,
  3689.             either set when the job was created or subsequently by an
  3690.             explicit modify job operation.  The job SHALL NOT be a
  3691.             candidate for processing until this reason is removed and
  3692.             there are no other reasons to hold the job.
  3693.  
  3694.         resourcesAreNotReady              0x80
  3695.             At least one of the resources needed by the job, such as
  3696.             media, fonts, resource objects, etc., is not ready on any of
  3697.             the physical devices for which the job is a candidate.  This
  3698.             condition MAY be detected when the job is accepted, or
  3699.             subsequently while the job is pending or processing,
  3700.             depending on implementation.
  3701.  
  3702.         deviceStoppedPartly               0x100
  3703.             One or more, but not all, of the devices to which the job is
  3704.             assigned are stopped.  If all of the devices are stopped (or
  3705.             the only device is stopped), the deviceStopped reason SHALL
  3706.             be used.
  3707.  
  3708.         deviceStopped                     0x200
  3709.             The device(s) to which the job is assigned is (are all)
  3710.             stopped.
  3711.  
  3712.         jobPrinting                       0x400
  3713.             The output device is marking media. This attribute is useful
  3714.             for servers and output devices which spend a great deal of
  3715.             time processing when no marking is happening and then want
  3716.             to show that marking is now happening or when the job is in
  3717.             the canceled or aborted state, but the marking has not yet
  3718.  
  3719.  
  3720.  
  3721. Bergman, Hastings, Isaacson, Lewis                 [Page 62]
  3722.  
  3723.  
  3724.  
  3725.  
  3726.  
  3727.                  Job Monitoring MIB, V0.83     July 14, 1997
  3728.  
  3729.  
  3730.             stopped so that impression or sheet counts are still
  3731.             increasing for the job.
  3732.  
  3733.         jobCanceledByUser                 0x800
  3734.             The job was canceled by the user, i.e., by an unknown user
  3735.             or by a user whose name is the same as the value of the
  3736.             job's jmJobOwner object.
  3737.  
  3738.         jobCanceledByOperator             0x1000
  3739.             The job was canceled by the operator, i.e., by a user whose
  3740.             name is different than the value of the job's jmJobOwner
  3741.             object.
  3742.  
  3743.         abortedBySystem                   0x2000
  3744.             The job was aborted by the system.
  3745.  
  3746.             NOTE - this reason is needed only when the system aborts a
  3747.             job, but does not put the job in the aborted job state.  For
  3748.             example, if the system aborts the job, but places the job in
  3749.             the pendingHeld state, so that a user or operator can try
  3750.             the job again.
  3751.  
  3752.         jobCompletedSuccessfully          0x4000
  3753.             The job completed successfully.
  3754.  
  3755.         jobCompletedWithWarnings          0x8000
  3756.             The job completed with warnings.
  3757.  
  3758.         jobCompletedWithErrors            0x10000
  3759.             The job completed with errors (and possibly warnings too).
  3760.  
  3761.             The following additional job state reasons have been added
  3762.             to represent job states that are in ISO DPA[iso-dpa] and
  3763.             other job submission protocols:
  3764.  
  3765.         jobPaused                         0x20000
  3766.             The job has been indefinitely suspended by a client issuing
  3767.             an operation to suspend the job so that other jobs may
  3768.             proceed using the same devices.  The client MAY issue an
  3769.             operation to resume the paused job at any time, in which
  3770.             case the agent SHALL remove the jobPaused values from the
  3771.             job's jmJobStateReasons1 object and the job is eventually
  3772.             resumed at or near the point where the job was paused.
  3773.  
  3774.         jobInterrupted                    0x40000
  3775.             The job has been interrupted while processing by a client
  3776.             issuing an operation that specifies another job to be run
  3777.             instead of the current job.  The server or device will
  3778.  
  3779.  
  3780.  
  3781. Bergman, Hastings, Isaacson, Lewis                 [Page 63]
  3782.  
  3783.  
  3784.  
  3785.  
  3786.  
  3787.                  Job Monitoring MIB, V0.83     July 14, 1997
  3788.  
  3789.  
  3790.             automatically resume the interrupted job when the
  3791.             interrupting job completes.
  3792.  
  3793.         jobRetained                       0x80000
  3794.             The job is being retained by the server or device with all
  3795.             of the job's document data (and submitted resources, such as
  3796.             fonts, logos, and forms, if any).  Thus a client could issue
  3797.             an operation to the server or device to either (1) re-do the
  3798.             job (or a copy of the job) on the same server or device or
  3799.             (2) resubmit the job to another server or device.  When a
  3800.             client could no longer re-do/resubmit the job, such as after
  3801.             the document data has been discarded, the agent SHALL remove
  3802.             the jobRetained value from the jmJobStateReasons1 object."
  3803.     REFERENCE
  3804.         "These bit definitions are the equivalent of a type 2 enum
  3805.         except that combinations of bits may be used together.  See
  3806.         section 3.6.1.2.  The remaining bits are reserved for future
  3807.         standardization and/or registration."
  3808.  
  3809.     SYNTAX      INTEGER(0..2147483647)   -- 31 bits, all but sign bit
  3810.  
  3811.  
  3812.  
  3813.  
  3814.  
  3815. JmJobStateReasons2TC ::= TEXTUAL-CONVENTION
  3816.     STATUS      current
  3817.     DESCRIPTION
  3818.         "This textual-convention is used with the jobStateReasons2
  3819.         attribute to provides additional information regarding the
  3820.         jmJobState object.  See the description under
  3821.         JmJobStateReasons1TC for additional information that applies to
  3822.         all reasons.
  3823.  
  3824.         The following standard values are defined (in hexadecimal) as
  3825.         powers of two, since multiple values may be used at the same
  3826.         time:
  3827.  
  3828.         cascaded                          0x1
  3829.             An outbound gateway has transmitted all of the job's job and
  3830.             document attributes and data to another spooling system.
  3831.  
  3832.         deletedByAdministrator            0x2
  3833.             The administrator has deleted the job.
  3834.  
  3835.         discardTimeArrived                0x4
  3836.             The job has been deleted due to the fact that the time
  3837.  
  3838.  
  3839.  
  3840.  
  3841. Bergman, Hastings, Isaacson, Lewis                 [Page 64]
  3842.  
  3843.  
  3844.  
  3845.  
  3846.  
  3847.                  Job Monitoring MIB, V0.83     July 14, 1997
  3848.  
  3849.  
  3850.             specified by the job's job-discard-time attribute has
  3851.             arrived.
  3852.  
  3853.         postProcessingFailed              0x8
  3854.             The post-processing agent failed while trying to log
  3855.             accounting attributes for the job; therefore the job has
  3856.             been placed into the completed state with the jobRetained
  3857.             jmJobStateReasons1 object value for a system-defined period
  3858.             of time, so the administrator can examine it, resubmit it,
  3859.             etc.
  3860.  
  3861.         submissionInterrupted             0x10
  3862.             Indicates that the job was not completely submitted for some
  3863.             unforeseen reason, such as: (1) the server has crashed
  3864.             before the job was closed by the client, (2) the server or
  3865.             the document transfer method has crashed in some non-
  3866.             recoverable way before the document data was entirely
  3867.             transferred to the server, (3) the client crashed or failed
  3868.             to close the job before the time-out period.
  3869.  
  3870.         maxJobFaultCountExceeded          0x20
  3871.             The job has faulted several times and has exceeded the
  3872.             administratively defined fault count limit.
  3873.  
  3874.         devicesNeedAttentionTimeOut       0x40
  3875.             One or more document transforms that the job is using needs
  3876.             human intervention in order for the job to make progress,
  3877.             but the human intervention did not occur within the site-
  3878.             settable time-out value.
  3879.  
  3880.         needsKeyOperatorTimeOut           0x80
  3881.             One or more devices or document transforms that the job is
  3882.             using need a specially trained operator (who may need a key
  3883.             to unlock the device and gain access) in order for the job
  3884.             to make progress, but the key operator intervention did not
  3885.             occur within the site-settable time-out value.
  3886.  
  3887.         jobStartWaitTimeOut               0x100
  3888.             The server/device has stopped the job at the beginning of
  3889.             processing to await human action, such as installing a
  3890.             special cartridge or special non-standard media, but the job
  3891.             was not resumed within the site-settable time-out value and
  3892.             the server/device has transitioned the job to the
  3893.             pendingHeld state.
  3894.  
  3895.         jobEndWaitTimeOut                 0x200
  3896.             The server/device has stopped the job at the end of
  3897.             processing to await human action, such as removing a special
  3898.  
  3899.  
  3900.  
  3901. Bergman, Hastings, Isaacson, Lewis                 [Page 65]
  3902.  
  3903.  
  3904.  
  3905.  
  3906.  
  3907.                  Job Monitoring MIB, V0.83     July 14, 1997
  3908.  
  3909.  
  3910.             cartridge or restoring standard media, but the job was not
  3911.             resumed within the site-settable time-out value and the
  3912.             server/device has transitioned the job to the completed
  3913.             state.
  3914.  
  3915.         jobPasswordWaitTimeOut            0x400
  3916.             The server/device has stopped the job at the beginning of
  3917.             processing to await input of the job's password, but the
  3918.             password was not received within the site-settable time-out
  3919.             value.
  3920.  
  3921.         deviceTimedOut                    0x800
  3922.             A device that the job was using has not responded in a
  3923.             period specified by the device's site-settable attribute.
  3924.  
  3925.         connectingToDeviceTimeOut         0x1000
  3926.             The server is attempting to connect to one or more devices
  3927.             which may be dial-up, polled, or queued, and so may be busy
  3928.             with traffic from other systems, but server was unable to
  3929.             connect to the device within the site-settable time-out
  3930.             value.
  3931.  
  3932.         transferring                      0x2000
  3933.             The job is being transferred to a down stream server or
  3934.             device.
  3935.  
  3936.         queuedInDevice                    0x4000
  3937.             The job has been queued in a down stream server or device.
  3938.  
  3939.         jobCleanup                        0x8000
  3940.             The server/device is performing cleanup activity as part of
  3941.             ending normal processing.
  3942.  
  3943.         processingToStopPoint             0x10000
  3944.             The requester has issued an operation to interrupt the job
  3945.             and the server/device is processing up until the specified
  3946.             stop point occurs.
  3947.  
  3948.         jobPasswordWait                   0x20000
  3949.             The server/device has selected the job to be next to
  3950.             process, but instead of assigning resources and starting the
  3951.             job processing, the server/device has transitioned the job
  3952.             to the pendingHeld state to await entry of a password (and
  3953.             dispatched another job, if there is one).
  3954.  
  3955.         validating                        0x40000
  3956.             The server/device is validating the job after accepting the
  3957.             job.
  3958.  
  3959.  
  3960.  
  3961. Bergman, Hastings, Isaacson, Lewis                 [Page 66]
  3962.  
  3963.  
  3964.  
  3965.  
  3966.  
  3967.                  Job Monitoring MIB, V0.83     July 14, 1997
  3968.  
  3969.  
  3970.  
  3971.         queueHeld                         0x80000
  3972.             The operator has held the entire job set or queue.
  3973.  
  3974.         jobProofWait                      0x100000
  3975.             The job has produced a single proof copy and is in the
  3976.             pendingHeld state waiting for the requester to issue an
  3977.             operation to release the job to print normally, obeying any
  3978.             job and document copy attributes that were originally
  3979.             submitted.
  3980.  
  3981.         heldForDiagnostics                0x200000
  3982.             The system is running intrusive diagnostics, so that all
  3983.             jobs are being held.
  3984.  
  3985.         serviceOffLine                    0x400000
  3986.             The service/document transform is off-line and accepting no
  3987.             jobs.  All pending jobs are put into the pendingHeld state.
  3988.             This could be true if its input is impaired or broken.
  3989.  
  3990.         noSpaceOnServer                   0x800000
  3991.             There is no room on the server to store all of the job.
  3992.  
  3993.         pinRequired                       0x1000000
  3994.             The System Administrator settable device policy is (1) to
  3995.             require PINs, and (2) to hold jobs that do not have a pin
  3996.             supplied as an input parameter when the job was created.
  3997.  
  3998.             exceededAccountLimit          0x2000000
  3999.             The account for which this job is drawn has exceeded its
  4000.             limit.  This condition SHOULD be detected before the job is
  4001.             scheduled so that the user does not wait until his/her job
  4002.             is scheduled only to find that the account is overdrawn.
  4003.             This condition MAY also occur while the job is processing
  4004.             either as processing begins or part way through processing.
  4005.  
  4006.         heldForRetry                      0x4000000
  4007.             The job encountered some errors that the server/device could
  4008.             not recover from with its normal retry procedures, but the
  4009.             error might not be encountered if the job is re-tried in the
  4010.             future, such as phone number busy or remote file system in-
  4011.             accessible.  For such a situation, the server/device SHALL
  4012.             transition the job from the processing to the pendingHeld,
  4013.             rather than to the aborted state.
  4014.  
  4015.         The following values are from the X/Open PSIS draft standard:
  4016.  
  4017.  
  4018.  
  4019.  
  4020.  
  4021. Bergman, Hastings, Isaacson, Lewis                 [Page 67]
  4022.  
  4023.  
  4024.  
  4025.  
  4026.  
  4027.                  Job Monitoring MIB, V0.83     July 14, 1997
  4028.  
  4029.  
  4030.         canceledByShutdown                0x8000000
  4031.             The job was canceled because the server or device was
  4032.             shutdown before completing the job.
  4033.  
  4034.         deviceUnavailable                 0x10000000
  4035.             This job was aborted by the system because the device is
  4036.             currently unable to accept jobs.
  4037.  
  4038.         wrongDevice                       0x20000000
  4039.             This job was aborted by the system because the device is
  4040.             unable to handle this particular job; the spooler SHOULD try
  4041.             another device or the user should submit the job to another
  4042.             device.
  4043.  
  4044.         badJob                            0x40000000
  4045.             This job was aborted by the system because this job has a
  4046.             major problem, such as an ill-formed PDL; the spooler SHOULD
  4047.             not even try another device. "
  4048.     REFERENCE
  4049.         "These bit definitions are the equivalent of a type 2 enum
  4050.         except that combinations of them may be used together.  See
  4051.         section 3.6.1.2.  See the description under JmJobStateReasons1TC
  4052.         and the jobStateReasons2 attribute."
  4053.  
  4054.     SYNTAX      INTEGER(0..2147483647)   -- 31 bits, all but sign bit
  4055.  
  4056.  
  4057.  
  4058.  
  4059.  
  4060.  
  4061. JmJobStateReasons3TC ::= TEXTUAL-CONVENTION
  4062.     STATUS      current
  4063.     DESCRIPTION
  4064.         "This textual-convention is used with the jobStateReasons3
  4065.         attribute to provides additional information regarding the
  4066.         jmJobState object.  See the description under
  4067.         JmJobStateReasons1TC for additional information that applies to
  4068.         all reasons.
  4069.  
  4070.         The following standard values are defined (in hexadecimal) as
  4071.         powers of two, since multiple values may be used at the same
  4072.         time:
  4073.  
  4074.         jobInterruptedByDeviceFailure     0x1
  4075.             A device or the print system software that the job was using
  4076.             has failed while the job was processing.  The server or
  4077.  
  4078.  
  4079.  
  4080.  
  4081. Bergman, Hastings, Isaacson, Lewis                 [Page 68]
  4082.  
  4083.  
  4084.  
  4085.  
  4086.  
  4087.                  Job Monitoring MIB, V0.83     July 14, 1997
  4088.  
  4089.  
  4090.             device is keeping the job in the pendingHeld state until an
  4091.             operator can determine what to do with the job."
  4092.     REFERENCE
  4093.         "These bit definitions are the equivalent of a type 2 enum
  4094.         except that combinations of them may be used together.  See
  4095.         section 3.6.1.2.  The remaining bits are reserved for future
  4096.         standardization and/or registration.  See the description under
  4097.         JmJobStateReasons1TC and the jobStateReasons3 attribute."
  4098.     SYNTAX      INTEGER(0..2147483647)   -- 31 bits, all but sign bit
  4099.  
  4100.  
  4101.  
  4102.  
  4103.  
  4104. JmJobStateReasons4TC ::= TEXTUAL-CONVENTION
  4105.     STATUS      current
  4106.     DESCRIPTION
  4107.         "This textual-convention is used in the jobStateReasons4
  4108.         attribute to provides additional information regarding the
  4109.         jmJobState object.  See the description under
  4110.         JmJobStateReasons1TC for additional information that applies to
  4111.         all reasons.
  4112.  
  4113.         The following standard values are defined (in hexadecimal) as
  4114.         powers of two, since multiple values may be used at the same
  4115.         time:
  4116.  
  4117.         none yet defined.  These bits are reserved for future
  4118.         standardization and/or registration."
  4119.     REFERENCE
  4120.         "These bit definitions are the equivalent of a type 2 enum
  4121.         except that combinations of them may be used together.  See
  4122.         section 3.6.1.2.  See the description under JmJobStateReasons1TC
  4123.         and the jobStateReasons4 attribute."
  4124.  
  4125.     SYNTAX      INTEGER(0..2147483647)   -- 31 bits, all but sign bit
  4126.  
  4127.  
  4128.  
  4129.  
  4130.  
  4131.  
  4132.  
  4133.  
  4134.  
  4135.  
  4136.  
  4137.  
  4138.  
  4139.  
  4140.  
  4141. Bergman, Hastings, Isaacson, Lewis                 [Page 69]
  4142.  
  4143.  
  4144.  
  4145.  
  4146.  
  4147.                  Job Monitoring MIB, V0.83     July 14, 1997
  4148.  
  4149.  
  4150.  
  4151. jobmonMIBObjects  OBJECT IDENTIFIER  ::= { jobmonMIB 1 }
  4152.  
  4153. -- The General Group (MANDATORY)
  4154.  
  4155. -- The jmGeneralGroup consists entirely of the jmGeneralTable.
  4156.  
  4157. jmGeneral  OBJECT IDENTIFIER ::= { jobmonMIBObjects 1 }
  4158.  
  4159. jmGeneralTable  OBJECT-TYPE
  4160.     SYNTAX      SEQUENCE OF JmGeneralEntry
  4161.     MAX-ACCESS  not-accessible
  4162.     STATUS      current
  4163.     DESCRIPTION
  4164.         "The jmGeneralTable consists of information of a general nature
  4165.         that are per-job-set, but are not per-job.  See Section 2
  4166.         entitled 'Terminology and Job Model' for the definition of a job
  4167.         set."
  4168.     REFERENCE
  4169.         "The MANDATORY-GROUP macro specifies that this group is
  4170.         MANDATORY."
  4171.     ::= { jmGeneral 1 }
  4172.  
  4173. jmGeneralEntry  OBJECT-TYPE
  4174.     SYNTAX      JmGeneralEntry
  4175.     MAX-ACCESS  not-accessible
  4176.     STATUS      current
  4177.     DESCRIPTION
  4178.         "Information about a job set (queue).
  4179.  
  4180.         An entry SHALL exist in this table for each job set."
  4181.     INDEX  { jmGeneralJobSetIndex }
  4182.     ::= { jmGeneralTable 1 }
  4183.  
  4184. JmGeneralEntry ::= SEQUENCE {
  4185.     jmGeneralJobSetIndex                  Integer32(1..32767),
  4186.     jmGeneralNumberOfActiveJobs           Integer32(0..2147483647),
  4187.     jmGeneralOldestActiveJobIndex         Integer32(0..2147483647),
  4188.     jmGeneralNewestActiveJobIndex         Integer32(0..2147483647),
  4189.     jmGeneralJobPersistence               Integer32(15..2147483647),
  4190.     jmGeneralAttributePersistence         Integer32(15..2147483647),
  4191.     jmGeneralJobSetName                   OCTET STRING(SIZE(0..63))
  4192. }
  4193.  
  4194. jmGeneralJobSetIndex OBJECT-TYPE
  4195.     SYNTAX      Integer32(1..32767)
  4196.     MAX-ACCESS  not-accessible
  4197.     STATUS      current
  4198.  
  4199.  
  4200.  
  4201. Bergman, Hastings, Isaacson, Lewis                 [Page 70]
  4202.  
  4203.  
  4204.  
  4205.  
  4206.  
  4207.                  Job Monitoring MIB, V0.83     July 14, 1997
  4208.  
  4209.  
  4210.     DESCRIPTION
  4211.         "A unique value for each job set in this MIB.  The jmJobTable
  4212.         and jmAttributeTable tables have this same index as their
  4213.         primary index.
  4214.  
  4215.         The value(s) of the jmGeneralJobSetIndex SHALL be persistent
  4216.         across power cycles, so that clients that have retained
  4217.         jmGeneralJobSetIndex values will access the same job sets upon
  4218.         subsequent power-up.
  4219.  
  4220.         An implementation that has only one job set, such as a printer
  4221.         with a single queue, SHALL hard code this object with the value
  4222.         1."
  4223.     REFERENCE
  4224.         "See Section 2 entitled 'Terminology and Job Model' for the
  4225.         definition of a job set.  Corresponds to the first index in
  4226.         jmJobTable and jmAttributeTable."
  4227.     ::= { jmGeneralEntry 1 }
  4228.  
  4229. jmGeneralNumberOfActiveJobs OBJECT-TYPE
  4230.     SYNTAX      Integer32(0..2147483647)
  4231.     MAX-ACCESS  read-only
  4232.     STATUS      current
  4233.     DESCRIPTION
  4234.         "The current number of 'active' jobs in the jmJobIDTable,
  4235.         jmJobTable, and jmAttributeTable, i.e., the total number of jobs
  4236.         that are in the pending, processing, or processingStopped
  4237.         states.  See the JmJobStateTC textual-convention for the exact
  4238.         specification of the semantics of the job states."
  4239.     ::= { jmGeneralEntry 2 }
  4240.  
  4241. jmGeneralOldestActiveJobIndex  OBJECT-TYPE
  4242.     SYNTAX      Integer32 (0..2147483647)
  4243.     MAX-ACCESS  read-only
  4244.     STATUS      current
  4245.     DESCRIPTION
  4246.         "The jmJobIndex of the oldest job that is still in one of the
  4247.         'active' states (pending, processing, or processingStopped).  In
  4248.         other words, the index of the 'active' job that has been in the
  4249.         job tables the longest.
  4250.  
  4251.         If there are no active jobs, the agent SHALL set the value of
  4252.         this object to 0."
  4253.     REFERENCE
  4254.         "See Section 3.2 entitled 'The Job Tables and the Oldest Active
  4255.         and Newest Active Indexes' for a description of the usage of
  4256.         this object."
  4257.     ::= { jmGeneralEntry 3 }
  4258.  
  4259.  
  4260.  
  4261. Bergman, Hastings, Isaacson, Lewis                 [Page 71]
  4262.  
  4263.  
  4264.  
  4265.  
  4266.  
  4267.                  Job Monitoring MIB, V0.83     July 14, 1997
  4268.  
  4269.  
  4270.  
  4271. jmGeneralNewestActiveJobIndex  OBJECT-TYPE
  4272.     SYNTAX      Integer32 (0..2147483647)
  4273.     MAX-ACCESS  read-only
  4274.     STATUS      current
  4275.     DESCRIPTION
  4276.         "The jmJobIndex of the newest job that is in one of the 'active'
  4277.         states (pending, processing, or processingStopped).  In other
  4278.         words, the index of the 'active' job that has been most recently
  4279.         added to the job tables.
  4280.  
  4281.         When all jobs become 'inactive', i.e., enter the pendingHeld,
  4282.         completed, canceled, or aborted states, the agent SHALL set the
  4283.         value of this object to 0."
  4284.     REFERENCE
  4285.         "See Section 3.2 entitled 'The Job Tables and the Oldest Active
  4286.         and Newest Active Indexes' for a description of the usage of
  4287.         this object."
  4288.     ::= { jmGeneralEntry 4 }
  4289.  
  4290. jmGeneralJobPersistence OBJECT-TYPE
  4291.     SYNTAX      Integer32(15..2147483647)
  4292.     UNITS       "seconds"
  4293.     MAX-ACCESS  read-only
  4294.     STATUS      current
  4295.     DESCRIPTION
  4296.         "The minimum time in seconds for this instance of the Job Set
  4297.         that an entry SHALL remain in the jmJobIDTable and jmJobTable
  4298.         after processing has completed, i.e., the minimum time in
  4299.         seconds starting when the job enters the completed, canceled, or
  4300.         aborted state.
  4301.  
  4302.         Depending on implementation, the value of this object MAY be
  4303.         either: (1) set by the system administrator by means outside
  4304.         this specification or (2) fixed by the implementation.
  4305.  
  4306.         This value SHALL be equal to or greater than the value of
  4307.         jmGeneralAttributePersistence.  This value SHOULD be at least 60
  4308.         which gives a monitoring application one minute in which to poll
  4309.         for job data."
  4310.     DEFVAL      { 60 }          -- one minute
  4311.     ::= { jmGeneralEntry 5 }
  4312.  
  4313. jmGeneralAttributePersistence OBJECT-TYPE
  4314.     SYNTAX      Integer32(15..2147483647)
  4315.     UNITS       "seconds"
  4316.     MAX-ACCESS  read-only
  4317.     STATUS      current
  4318.  
  4319.  
  4320.  
  4321. Bergman, Hastings, Isaacson, Lewis                 [Page 72]
  4322.  
  4323.  
  4324.  
  4325.  
  4326.  
  4327.                  Job Monitoring MIB, V0.83     July 14, 1997
  4328.  
  4329.  
  4330.     DESCRIPTION
  4331.         "The minimum time in seconds for this instance of the Job Set
  4332.         that an entry SHALL remain in the jmAttributeTable after
  4333.         processing has completed , i.e., the time in seconds starting
  4334.         when the job enters the completed, canceled, or aborted state.
  4335.  
  4336.         Depending on implementation, the value of this object MAY be
  4337.         either (1) set by the system administrator by means outside this
  4338.         specification or MAY be (2) fixed by the implementation.
  4339.  
  4340.         This value SHOULD be at least 60 which gives a monitoring
  4341.         application one minute in which to poll for job data."
  4342.     DEFVAL      { 60 }          -- one minute
  4343.     ::= { jmGeneralEntry 6 }
  4344.  
  4345. jmGeneralJobSetName OBJECT-TYPE
  4346.     SYNTAX      OCTET STRING(SIZE(0..63))
  4347.     MAX-ACCESS  read-only
  4348.     STATUS      current
  4349.     DESCRIPTION
  4350.         "The human readable name of this job set assigned by the system
  4351.         administrator (by means outside of this MIB).  Typically, this
  4352.         name SHOULD be the name of the job queue.  If a server or device
  4353.         has only a single job set, this object can be the
  4354.         administratively assigned name of the server or device itself.
  4355.         This name does not need to be unique, though each job set in a
  4356.         single Job Monitoring MIB SHOULD have distinct names.
  4357.  
  4358.         NOTE - The purpose of this object is to help the user of the job
  4359.         monitoring application distinguish between several job sets in
  4360.         implementations that support more than one job set."
  4361.     REFERENCE
  4362.         "See the OBJECT compliance macro for the minimum maximum length
  4363.         required for conformance."
  4364.     ::= { jmGeneralEntry 7 }
  4365.  
  4366.  
  4367.  
  4368.  
  4369.  
  4370. -- The Job ID Group (MANDATORY)
  4371.  
  4372. -- The jmJobIDGroup consists entirely of the jmJobIDTable.
  4373.  
  4374. jmJobID  OBJECT IDENTIFIER ::= { jobmonMIBObjects 2 }
  4375.  
  4376. jmJobIDTable  OBJECT-TYPE
  4377.     SYNTAX      SEQUENCE OF JmJobIDEntry
  4378.  
  4379.  
  4380.  
  4381. Bergman, Hastings, Isaacson, Lewis                 [Page 73]
  4382.  
  4383.  
  4384.  
  4385.  
  4386.  
  4387.                  Job Monitoring MIB, V0.83     July 14, 1997
  4388.  
  4389.  
  4390.     MAX-ACCESS  not-accessible
  4391.     STATUS      current
  4392.     DESCRIPTION
  4393.         "The jmJobIDTable provides a correspondence map (1) between the
  4394.         job submission ID that a client uses to refer to a job and (2)
  4395.         the jmGeneralJobSetIndex and jmJobIndex that the Job Monitoring
  4396.         MIB agent assigned to the job and that are used to access the
  4397.         job in all of the other tables in the MIB.  If a monitoring
  4398.         application already knows the jmGeneralJobSetIndex and the
  4399.         jmJobIndex of the job it is querying, that application NEED NOT
  4400.         use the jmJobIDTable."
  4401.     REFERENCE
  4402.         "The MANDATORY-GROUP macro specifies that this group is
  4403.         MANDATORY."
  4404.     ::= { jmJobID 1 }
  4405.  
  4406. jmJobIDEntry  OBJECT-TYPE
  4407.     SYNTAX      JmJobIDEntry
  4408.     MAX-ACCESS  not-accessible
  4409.     STATUS      current
  4410.     DESCRIPTION
  4411.         "The map from (1) the jmJobSubmissionID to (2) the
  4412.         jmGeneralJobSetIndex and jmJobIndex.
  4413.  
  4414.         An entry SHALL exist in this table for each job currently known
  4415.         to the agent for all job sets and job states.  Each job SHALL
  4416.         appear in one and only one job set."
  4417.     INDEX  { jmJobSubmissionID }
  4418.     ::= { jmJobIDTable 1 }
  4419.  
  4420. JmJobIDEntry ::= SEQUENCE {
  4421.     jmJobSubmissionID                     OCTET STRING(SIZE(48)),
  4422.     jmJobIDJobSetIndex                    Integer32(1..32767),
  4423.     jmJobIDJobIndex                       Integer32(1..2147483647)
  4424. }
  4425.  
  4426. jmJobSubmissionID OBJECT-TYPE
  4427.     SYNTAX      OCTET STRING(SIZE(48))
  4428.     MAX-ACCESS  not-accessible
  4429.     STATUS      current
  4430.     DESCRIPTION
  4431.         "A quasi-unique 48-octet fixed-length string ID which identifies
  4432.         the job within a particular client-server environment.  There
  4433.         are multiple formats for the jmJobSubmissionID.  See the
  4434.         JmJobSubmissionIDTypeTC textual convention.  Each format SHALL
  4435.         be registered using the procedures of a type 2 enum.  See
  4436.         section 3.6.3 entitled: 'IANA Registration of Job Submission Id
  4437.         Formats'.
  4438.  
  4439.  
  4440.  
  4441. Bergman, Hastings, Isaacson, Lewis                 [Page 74]
  4442.  
  4443.  
  4444.  
  4445.  
  4446.  
  4447.                  Job Monitoring MIB, V0.83     July 14, 1997
  4448.  
  4449.  
  4450.  
  4451.         If the requester (client or server) does not supply a job
  4452.         submission ID in the job submission protocol, then the recipient
  4453.         (server or device) SHALL assign a job submission ID using any of
  4454.         the standard formats and adding the final 8 octets to
  4455.         distinguish the ID from others submitted from the same
  4456.         requester.
  4457.  
  4458.         The monitoring application, whether in the client or running
  4459.         separately, MAY use the job submission ID to help identify which
  4460.         jmJobIndex was assigned by the agent, i.e., in which row the job
  4461.         information is in the other tables.
  4462.  
  4463.         NOTE - fixed-length is used so that a management application can
  4464.         use a shortened GetNext varbind (in SNMPv1 and SNMPv2) in order
  4465.         to get the next submission ID, disregarding the remainder of the
  4466.         ID in order to access jobs independent of the trailing
  4467.         identifier part, e.g., to get all jobs submitted by a particular
  4468.         jmJobOwner or from a particular MAC address."
  4469.     ::= { jmJobIDEntry 1 }
  4470.  
  4471. jmJobIDJobSetIndex OBJECT-TYPE
  4472.     SYNTAX      Integer32(1..32767)
  4473.     MAX-ACCESS  read-only
  4474.     STATUS      current
  4475.     DESCRIPTION
  4476.         "This object contains the value of the jmGeneralJobSetIndex for
  4477.         the job with the jmJobSubmissionID value, i.e., the job set
  4478.         index of the job set in which the job was placed when that
  4479.         server or device accepted the job.  This 16-bit value in
  4480.         combination with the jmJobIDJobIndex value permits the
  4481.         management application to access the other tables to obtain the
  4482.         job-specific objects for this job."
  4483.     REFERENCE
  4484.         "See jmGeneralJobSetIndex in the jmGeneralTable."
  4485.     ::= { jmJobIDEntry 2 }
  4486.  
  4487. jmJobIDJobIndex OBJECT-TYPE
  4488.     SYNTAX      Integer32(1..2147483647)
  4489.     MAX-ACCESS  read-only
  4490.     STATUS      current
  4491.     DESCRIPTION
  4492.         "This object contains the value of the jmJobIndex for the job
  4493.         with the jmJobSubmissionID value, i.e., the job index for the
  4494.         job when the server or device accepted the job.  This value, in
  4495.         combination with the jmJobIDJobSetIndex value, permits the
  4496.         management application to access the other tables to obtain the
  4497.         job-specific objects for this job."
  4498.  
  4499.  
  4500.  
  4501. Bergman, Hastings, Isaacson, Lewis                 [Page 75]
  4502.  
  4503.  
  4504.  
  4505.  
  4506.  
  4507.                  Job Monitoring MIB, V0.83     July 14, 1997
  4508.  
  4509.  
  4510.     REFERENCE
  4511.         "See jmJobIndex in the jmJobTable."
  4512.     ::= { jmJobIDEntry 3 }
  4513.  
  4514.  
  4515.  
  4516.  
  4517. -- The Job Group (MANDATORY)
  4518.  
  4519. -- The jmJobGroup consists entirely of the jmJobTable.
  4520.  
  4521. jmJob  OBJECT IDENTIFIER ::= { jobmonMIBObjects 3 }
  4522.  
  4523. jmJobTable  OBJECT-TYPE
  4524.     SYNTAX      SEQUENCE OF JmJobEntry
  4525.     MAX-ACCESS  not-accessible
  4526.     STATUS      current
  4527.     DESCRIPTION
  4528.         "The jmJobTable consists of basic job state and status
  4529.         information for each job in a job set that (1) monitoring
  4530.         applications need to be able to access in a single SNMP Get
  4531.         operation, (2) that have a single value per job, and (3) that
  4532.         SHALL always be implemented."
  4533.     REFERENCE
  4534.         "The MANDATORY-GROUP macro specifies that this group is
  4535.         MANDATORY."
  4536.     ::= { jmJob 1 }
  4537.  
  4538. jmJobEntry  OBJECT-TYPE
  4539.     SYNTAX      JmJobEntry
  4540.     MAX-ACCESS  not-accessible
  4541.     STATUS      current
  4542.     DESCRIPTION
  4543.         "Basic per-job state and status information.
  4544.  
  4545.         An entry SHALL exist in this table for each job, no matter what
  4546.         the state of the job is.  Each job SHALL appear in one and only
  4547.         one job set."
  4548.     REFERENCE
  4549.         "See Section 3.2 entitled 'The Job Tables'."
  4550.     INDEX  { jmGeneralJobSetIndex, jmJobIndex }
  4551.     ::= { jmJobTable 1 }
  4552.  
  4553. JmJobEntry ::= SEQUENCE {
  4554.     jmJobIndex                            Integer32(1..2147483647),
  4555.     jmJobState                            JmJobStateTC,
  4556.     jmJobStateReasons1                    JmJobStateReasons1TC,
  4557.     jmNumberOfInterveningJobs             Integer32(-2..2147483647),
  4558.  
  4559.  
  4560.  
  4561. Bergman, Hastings, Isaacson, Lewis                 [Page 76]
  4562.  
  4563.  
  4564.  
  4565.  
  4566.  
  4567.                  Job Monitoring MIB, V0.83     July 14, 1997
  4568.  
  4569.  
  4570.     jmJobKOctetsRequested                 Integer32(-2..2147483647),
  4571.     jmJobKOctetsProcessed                 Integer32(-2..2147483647),
  4572.     jmJobImpressionsRequested             Integer32(-2..2147483647),
  4573.     jmJobImpressionsCompleted             Integer32(-2..2147483647),
  4574.     jmJobOwner                            OCTET STRING(SIZE(0..63))
  4575. }
  4576.  
  4577. jmJobIndex OBJECT-TYPE
  4578.     SYNTAX      Integer32(1..2147483647)
  4579.     MAX-ACCESS  not-accessible
  4580.     STATUS      current
  4581.     DESCRIPTION
  4582.         "The sequential, monatonically increasing identifier index for
  4583.         the job generated by the server or device when that server or
  4584.         device accepted the job.  This index value permits the
  4585.         management application to access the other tables to obtain the
  4586.         job-specific row entries.
  4587.  
  4588.         Agents providing access to systems that contain jobs with a job
  4589.         identifier of 0 SHALL map the job identifier value 0 to a
  4590.         jmJobIndex value that is one higher than the highest job
  4591.         identifier value that any job can have on that system."
  4592.     REFERENCE
  4593.         "See Section 3.2 entitled 'The Job Tables'.  See also
  4594.         jmGeneralNewestActiveJobIndex for the largest value of
  4595.         jmJobIndex."
  4596.     ::= { jmJobEntry 1 }
  4597.  
  4598. jmJobState OBJECT-TYPE
  4599.     SYNTAX      JmJobStateTC
  4600.     MAX-ACCESS  read-only
  4601.     STATUS      current
  4602.     DESCRIPTION
  4603.         "The current state of the job (pending, processing, completed,
  4604.         etc.).  Agents SHALL implement only those states which are
  4605.         appropriate for the particular implementation.  However,
  4606.         management applications SHALL be prepared to receive all the
  4607.         standard job states.
  4608.  
  4609.         The final value for this object SHALL be one of: completed,
  4610.         canceled, or aborted.  The minimum length of time that the agent
  4611.         SHALL maintain MIB data for a job in the completed, canceled, or
  4612.         aborted state before removing the job data from the jmJobIDTable
  4613.         and jmJobTable is specified by the value of the
  4614.         jmGeneralJobPersistence object."
  4615.     ::= { jmJobEntry 2 }
  4616.  
  4617. jmJobStateReasons1 OBJECT-TYPE
  4618.  
  4619.  
  4620.  
  4621. Bergman, Hastings, Isaacson, Lewis                 [Page 77]
  4622.  
  4623.  
  4624.  
  4625.  
  4626.  
  4627.                  Job Monitoring MIB, V0.83     July 14, 1997
  4628.  
  4629.  
  4630.     SYNTAX      JmJobStateReasons1TC
  4631.     MAX-ACCESS  read-only
  4632.     STATUS      current
  4633.     DESCRIPTION
  4634.         "Additional information about the job's current state, i.e.,
  4635.         information that augments the value of the job's jmJobState
  4636.         object.
  4637.  
  4638.         Implementation of any reason values is OPTIONAL, but an agent
  4639.         SHOULD return any reason information available  These values MAY
  4640.         be used with any job state or states for which the reason makes
  4641.         sense.  Furthermore, when implemented as with any MIB data, the
  4642.         agent SHALL return these values when the reason applies and
  4643.         SHALL NOT return them when the reason no longer applies whether
  4644.         the value of the job's jmJobState object changed or not.  When
  4645.         the job does not have any reasons for being in its current
  4646.         state, the agent SHALL set the value of the jmJobStateReasons1
  4647.         object and jobStateReasonsN attributes to 0."
  4648.     REFERENCE
  4649.         "The jobStateReasonsN (N=2..4) attributes provide further
  4650.         additional information about the job's current state."
  4651.     ::= { jmJobEntry 3 }
  4652.  
  4653. jmNumberOfInterveningJobs OBJECT-TYPE
  4654.     SYNTAX      Integer32(-2..2147483647)
  4655.     MAX-ACCESS  read-only
  4656.     STATUS      current
  4657.     DESCRIPTION
  4658.         "The number of jobs that are expected to be processed before
  4659.         this job is processed according to the implementation's queuing
  4660.         algorithm if no other jobs were to be submitted.  In other
  4661.         words, this value is the job's queue position.  The agent SHALL
  4662.         return a value of 0 for this attribute while the job is
  4663.         processing."
  4664.     ::= { jmJobEntry 4 }
  4665.  
  4666. jmJobKOctetsRequested OBJECT-TYPE
  4667.     SYNTAX      Integer32(-2..2147483647)
  4668.     MAX-ACCESS  read-only
  4669.     STATUS      current
  4670.     DESCRIPTION
  4671.         "The total size in K (1024) octets of the document(s) being
  4672.         requested to be processed in the job.  The agent SHALL round the
  4673.         actual number of octets up to the next highest K.  Thus 0 octets
  4674.         SHALL be represented as '0', 1-1024 octets SHALL be represented
  4675.         as '1', 1025-2048 SHALL be represented as '2', etc.
  4676.  
  4677.  
  4678.  
  4679.  
  4680.  
  4681. Bergman, Hastings, Isaacson, Lewis                 [Page 78]
  4682.  
  4683.  
  4684.  
  4685.  
  4686.  
  4687.                  Job Monitoring MIB, V0.83     July 14, 1997
  4688.  
  4689.  
  4690.         In computing this value, the server/device SHALL not include the
  4691.         multiplicative factors contributed by (1) the number of document
  4692.         copies, and (2) the number of job copies, independent of whether
  4693.         the device can process multiple copies of the job or document
  4694.         without making multiple passes over the job or document data and
  4695.         independent of  whether the output is collated or not.  Thus the
  4696.         server/device computation is independent of the implementation."
  4697.     ::= { jmJobEntry 5 }
  4698.  
  4699. jmJobKOctetsProcessed OBJECT-TYPE
  4700.     SYNTAX      Integer32(-2..2147483647)
  4701.     MAX-ACCESS  read-only
  4702.     STATUS      current
  4703.     DESCRIPTION
  4704.         "The current number of octets processed by the server or device
  4705.         measured in units of K (1024) octets.  The agent SHALL round the
  4706.         actual number of octets processed up to the next higher K.  Thus
  4707.         0 octets SHALL be represented as '0', 1-1024 octets SHALL be
  4708.         represented as '1', 1025-2048 octets SHALL be '2', etc.  For
  4709.         printing devices, this value is the number interpreted by the
  4710.         page description language interpreter rather than what has been
  4711.         marked on media.
  4712.  
  4713.         For implementations where multiple copies are produced by the
  4714.         interpreter with only a single pass over the data, the final
  4715.         value SHALL be equal to the value of the jmJobKOctetsRequested
  4716.         object.  For implementations where multiple copies are produced
  4717.         by the interpreter by processing the data for each copy, the
  4718.         final value SHALL be a multiple of the value of the
  4719.         jmJobKOctetsRequested object.
  4720.  
  4721.         NOTE - See the impressionsCompletedCurrentCopy and
  4722.         pagesCompletedCurrentCopy attributes for attributes that are
  4723.         reset on each document copy.
  4724.  
  4725.         NOTE - The jmJobKOctetsProcessed object can be used with the
  4726.         jmJobKOctetsRequested object to provide an indication of the
  4727.         relative progress of the job, provided that the multiplicative
  4728.         factor is taken into account for some implementations of
  4729.         multiple copies."
  4730.     ::= { jmJobEntry 6 }
  4731.  
  4732. jmJobImpressionsRequested OBJECT-TYPE
  4733.     SYNTAX      Integer32(-2..2147483647)
  4734.     MAX-ACCESS  read-only
  4735.     STATUS      current
  4736.     DESCRIPTION
  4737.         "The number of impressions requested by this job to produce."
  4738.  
  4739.  
  4740.  
  4741. Bergman, Hastings, Isaacson, Lewis                 [Page 79]
  4742.  
  4743.  
  4744.  
  4745.  
  4746.  
  4747.                  Job Monitoring MIB, V0.83     July 14, 1997
  4748.  
  4749.  
  4750.     ::= { jmJobEntry 7 }
  4751.  
  4752. jmJobImpressionsCompleted OBJECT-TYPE
  4753.     SYNTAX      Integer32(-2..2147483647)
  4754.     MAX-ACCESS  read-only
  4755.     STATUS      current
  4756.     DESCRIPTION
  4757.         "The current number of impressions completed for this job so
  4758.         far.  For printing devices, the impressions completed includes
  4759.         interpreting, marking, and stacking the output.  For other types
  4760.         of job services, the number of impressions completed includes
  4761.         the number of impressions processed."
  4762.     ::= { jmJobEntry 8 }
  4763.  
  4764. jmJobOwner OBJECT-TYPE
  4765.     SYNTAX      OCTET STRING(SIZE(0..63))
  4766.     MAX-ACCESS  read-only
  4767.     STATUS      current
  4768.     DESCRIPTION
  4769.         "The coded character set name of the user that submitted the
  4770.         job.  The method of assigning this user name will be system
  4771.         and/or site specific but the method MUST insure that the name is
  4772.         unique to the network that is visible to the client and target
  4773.         device.
  4774.  
  4775.         This value SHOULD be the authenticated name of the user
  4776.         submitting the job."
  4777.     REFERENCE
  4778.         "See the OBJECT compliance macro for the minimum maximum length
  4779.         required for conformance."
  4780.     ::= { jmJobEntry 9 }
  4781.  
  4782.  
  4783.  
  4784.  
  4785. -- The Attribute Group (MANDATORY)
  4786.  
  4787. -- The jmAttributeGroup consists entirely of the jmAttributeTable.
  4788. --
  4789. -- Implementation of the two objects in this group is MANDATORY.
  4790. -- See Section 3.1 entitled 'Conformance Considerations'.
  4791. -- An agent SHALL implement any attribute if (1) the server or device
  4792. -- supports the functionality represented by the attribute and (2) the
  4793. -- information is available to the agent.(
  4794.  
  4795. jmAttribute  OBJECT IDENTIFIER ::= { jobmonMIBObjects 4 }
  4796.  
  4797. jmAttributeTable  OBJECT-TYPE
  4798.  
  4799.  
  4800.  
  4801. Bergman, Hastings, Isaacson, Lewis                 [Page 80]
  4802.  
  4803.  
  4804.  
  4805.  
  4806.  
  4807.                  Job Monitoring MIB, V0.83     July 14, 1997
  4808.  
  4809.  
  4810.     SYNTAX      SEQUENCE OF JmAttributeEntry
  4811.     MAX-ACCESS  not-accessible
  4812.     STATUS      current
  4813.     DESCRIPTION
  4814.         "The jmAttributeTable SHALL contain attributes of the job and
  4815.         document(s) for each job in a job set.  Instead of allocating
  4816.         distinct objects for each attribute, each attribute is
  4817.         represented as a separate row in the jmAttributeTable."
  4818.     REFERENCE
  4819.         "The MANDATORY-GROUP macro specifies that this group is
  4820.         MANDATORY.  An agent SHALL implement any attribute if (1) the
  4821.         server or device supports the functionality represented by the
  4822.         attribute and (2) the information is available to the agent. "
  4823.     ::= { jmAttribute 1 }
  4824.  
  4825. jmAttributeEntry  OBJECT-TYPE
  4826.     SYNTAX      JmAttributeEntry
  4827.     MAX-ACCESS  not-accessible
  4828.     STATUS      current
  4829.     DESCRIPTION
  4830.         "Attributes representing information about the job and
  4831.         document(s) or resources required and/or consumed.
  4832.  
  4833.         Each entry in the jmAttributeTable is a per-job entry with an
  4834.         extra index for each type of attribute (jmAttributeTypeIndex)
  4835.         that a job can have and an additional index
  4836.         (jmAttributeInstanceIndex) for those attributes that can have
  4837.         multiple instances per job.  The jmAttributeTypeIndex object
  4838.         SHALL contain an enum type that indicates the type of attribute
  4839.         (see the JmAttributeTypeTC textual-convention).  The value of
  4840.         the attribute SHALL be represented in either the
  4841.         jmAttributeValueAsInteger or jmAttributeValueAsOctets objects,
  4842.         and/or both, as specified in the JmAttributeTypeTC textual-
  4843.         convention.
  4844.  
  4845.         The agent SHALL create rows in the jmAttributeTable as the
  4846.         server or device is able to discover the attributes either from
  4847.         the job submission protocol itself or from the document PDL.  As
  4848.         the documents are interpreted, the interpreter MAY discover
  4849.         additional attributes and so the agent adds additional rows to
  4850.         this table.  As the attributes that represent resources are
  4851.         actually consumed, the usage counter contained in the
  4852.         jmAttributeValueAsInteger object is incremented according to the
  4853.         units indicated in the description of the JmAttributeTypeTC
  4854.         enum.
  4855.  
  4856.  
  4857.  
  4858.  
  4859.  
  4860.  
  4861. Bergman, Hastings, Isaacson, Lewis                 [Page 81]
  4862.  
  4863.  
  4864.  
  4865.  
  4866.  
  4867.                  Job Monitoring MIB, V0.83     July 14, 1997
  4868.  
  4869.  
  4870.         The agent SHALL maintain each row in the jmJobTable for at least
  4871.         the minimum time after a job completes as specified by the
  4872.         jmGeneralAttributePersistence object.
  4873.  
  4874.         Zero or more entries SHALL exist in this table for each job in a
  4875.         job set."
  4876.     REFERENCE
  4877.         "See Section 3.3 entitled 'The Attribute Mechanism' for a
  4878.         description of the jmAttributeTable."
  4879.     INDEX  { jmGeneralJobSetIndex, jmJobIndex, jmAttributeTypeIndex,
  4880.     jmAttributeInstanceIndex }
  4881.     ::= { jmAttributeTable 1 }
  4882.  
  4883. JmAttributeEntry ::= SEQUENCE {
  4884.     jmAttributeTypeIndex                  JmAttributeTypeTC,
  4885.     jmAttributeInstanceIndex              Integer32(1..32767),
  4886.     jmAttributeValueAsInteger             Integer32(-2..2147483647),
  4887.     jmAttributeValueAsOctets              OCTET STRING(SIZE(0..63))
  4888. }
  4889.  
  4890. jmAttributeTypeIndex OBJECT-TYPE
  4891.     SYNTAX      JmAttributeTypeTC
  4892.     MAX-ACCESS  not-accessible
  4893.     STATUS      current
  4894.     DESCRIPTION
  4895.         "The type of attribute that this row entry represents.
  4896.  
  4897.         The type MAY identify information about the job or document(s)
  4898.         or MAY identify a resource required to process the job before
  4899.         the job start processing and/or consumed by the job as the job
  4900.         is processed.
  4901.  
  4902.         Examples of job and document attributes include:
  4903.         jobCopiesRequested, documentCopiesRequested, jobCopiesCompleted,
  4904.         documentCopiesCompleted, fileName, and documentName.
  4905.  
  4906.         Examples of required and consumed resource attributes include:
  4907.         pagesRequested, pagesCompleted, mediumRequested, and
  4908.         mediumConsumed, respectively."
  4909.     ::= { jmAttributeEntry 1 }
  4910.  
  4911. jmAttributeInstanceIndex OBJECT-TYPE
  4912.     SYNTAX      Integer32(1..32767)
  4913.     MAX-ACCESS  not-accessible
  4914.     STATUS      current
  4915.     DESCRIPTION
  4916.         "A running 16-bit index of the attributes of the same type for
  4917.         each job.  For those attributes with only a single instance per
  4918.  
  4919.  
  4920.  
  4921. Bergman, Hastings, Isaacson, Lewis                 [Page 82]
  4922.  
  4923.  
  4924.  
  4925.  
  4926.  
  4927.                  Job Monitoring MIB, V0.83     July 14, 1997
  4928.  
  4929.  
  4930.         job, this index value SHALL be 1.  For those attributes that are
  4931.         a single value per document, the index value SHALL be the
  4932.         document number, starting with 1 for the first document in the
  4933.         job.  Jobs with only a single document SHALL use the index value
  4934.         of 1.  For those attributes that can have multiple values per
  4935.         job or per document, such as documentFormatIndex(37) or
  4936.         documentFormat(38), the index SHALL be a running index for the
  4937.         job as a whole, starting at 1."
  4938.     ::= { jmAttributeEntry 2 }
  4939.  
  4940. jmAttributeValueAsInteger OBJECT-TYPE
  4941.     SYNTAX      Integer32(-2..2147483647)
  4942.     MAX-ACCESS  read-only
  4943.     STATUS      current
  4944.     DESCRIPTION
  4945.         "The integer value of the attribute.  The value of the attribute
  4946.         SHALL be represented as an integer if the enum description in
  4947.         the JmAttributeTypeTC textual-convention definition has the tag:
  4948.         'INTEGER:'.
  4949.  
  4950.         Depending on the enum definition, this object value MAY be an
  4951.         integer, a counter, an index, or an enum, depending on the
  4952.         jmAttributeTypeIndex value.  The units of this value are
  4953.         specified in the enum description.
  4954.  
  4955.         For those attributes that are accumulating job consumption as
  4956.         the job is processed as specified in the JmAttributeTypeTC
  4957.         textual-convention, SHALL contain the final value after the job
  4958.         completes processing, i.e., this value SHALL indicate the total
  4959.         usage of this resource made by the job.
  4960.  
  4961.         A monitoring application is able to copy this value to a
  4962.         suitable longer term storage for later processing as part of an
  4963.         accounting system.
  4964.  
  4965.         Since the agent MAY add attributes representing resources to
  4966.         this table while the job is waiting to be processed or being
  4967.         processed, which can be a long time before any of the resources
  4968.         are actually used, the agent SHALL set the value of the
  4969.         jmAttributeValueAsInteger object to 0 for resources that the job
  4970.         has not yet consumed.
  4971.  
  4972.         Attributes for which the concept of an integer value is
  4973.         meaningless, such as fileName, interpreter, and physicalDevice,
  4974.         do not have the 'INTEGER:' tag in the JmAttributeTypeTC
  4975.         definition and so an agent SHALL always return a value of '-1'
  4976.         to indicate 'other' for jmAttributeValueAsInteger.
  4977.  
  4978.  
  4979.  
  4980.  
  4981. Bergman, Hastings, Isaacson, Lewis                 [Page 83]
  4982.  
  4983.  
  4984.  
  4985.  
  4986.  
  4987.                  Job Monitoring MIB, V0.83     July 14, 1997
  4988.  
  4989.  
  4990.         For attributes which do have the 'INTEGER:' tag in the
  4991.         JmAttributeTypeTC definition, if the integer value is not (yet)
  4992.         known, the agent either SHALL not materialize the row in the
  4993.         jmAttributeTable until the value is known or SHALL return a '-2'
  4994.         to represent an 'unknown' counting integer value, a '0' to
  4995.         represent an 'unknown' index value, and a '2' to represent an
  4996.         'unknown(2)' enum value."
  4997.     ::= { jmAttributeEntry 3 }
  4998.  
  4999. jmAttributeValueAsOctets OBJECT-TYPE
  5000.     SYNTAX      OCTET STRING(SIZE(0..63))
  5001.     MAX-ACCESS  read-only
  5002.     STATUS      current
  5003.     DESCRIPTION
  5004.         "The octet string value of the attribute.  The value of the
  5005.         attribute SHALL be represented as an OCTET STRING if the enum
  5006.         description in the JmAttributeTypeTC textual-convention
  5007.         definition has the tag: 'OCTETS:'.
  5008.  
  5009.         Depending on the enum definition, this object value MAY be a
  5010.         coded character set string (text) or a binary octet string, such
  5011.         as DateAndTime.
  5012.  
  5013.         Attributes for which the concept of an octet string value is
  5014.         meaningless, such as pagesCompleted, do not have the tag
  5015.         'OCTETS:' in the JmAttributeTypeTC definition and so the agent
  5016.         SHALL always return a zero length string for the value of the
  5017.         jmAttributeValueAsOctets object.
  5018.  
  5019.         For attributes which do have the 'OCTETS:' tag in the
  5020.         JmAttributeTypeTC definition, if the OCTET STRING value is not
  5021.         (yet) known, the agent either SHALL not materialize the row in
  5022.         the jmAttributeTable until the value is known or SHALL return a
  5023.         zero-length string."
  5024.     ::= { jmAttributeEntry 4 }
  5025.  
  5026.  
  5027.  
  5028.  
  5029.  
  5030.  
  5031.  
  5032.  
  5033.  
  5034.  
  5035.  
  5036.  
  5037.  
  5038.  
  5039.  
  5040.  
  5041. Bergman, Hastings, Isaacson, Lewis                 [Page 84]
  5042.  
  5043.  
  5044.  
  5045.  
  5046.  
  5047.                  Job Monitoring MIB, V0.83     July 14, 1997
  5048.  
  5049.  
  5050. -- Notifications and Trapping
  5051. -- Reserved for the future
  5052.  
  5053. jobmonMIBNotifications  OBJECT IDENTIFIER  ::= { jobmonMIB 2}
  5054.  
  5055.  
  5056.  
  5057. -- Conformance Information
  5058.  
  5059. jmMIBConformance OBJECT IDENTIFIER ::= { jobmonMIB 3 }
  5060.  
  5061. -- compliance statements
  5062. jmMIBCompliance MODULE-COMPLIANCE
  5063.     STATUS  current
  5064.     DESCRIPTION
  5065.         "The compliance statement for agents that implement the
  5066.         job monitoring MIB."
  5067.     MODULE -- this module
  5068.     MANDATORY-GROUPS {
  5069.         jmGeneralGroup, jmJobIDGroup, jmJobGroup, jmAttributeGroup }
  5070.  
  5071.     OBJECT   jmGeneralJobSetName
  5072.     SYNTAX   OCTET STRING (SIZE(0..8))
  5073.     DESCRIPTION
  5074.         "Only 8 octets maximum string length NEED be supported by the
  5075.         agent."
  5076.  
  5077.     OBJECT   jmJobOwner
  5078.     SYNTAX   OCTET STRING (SIZE(0..16))
  5079.     DESCRIPTION
  5080.         "Only 16 octets maximum string length NEED be supported by the
  5081.         agent."
  5082.  
  5083. -- There are no CONDITIONALLY MANDATORY or OPTIONAL groups.
  5084.  
  5085.     ::= { jmMIBConformance 1 }
  5086.  
  5087.  
  5088. jmMIBGroups      OBJECT IDENTIFIER ::= { jmMIBConformance 2 }
  5089.  
  5090. jmGeneralGroup OBJECT-GROUP
  5091.     OBJECTS {
  5092.         jmGeneralNumberOfActiveJobs,   jmGeneralOldestActiveJobIndex,
  5093.         jmGeneralNewestActiveJobIndex, jmGeneralJobPersistence,
  5094.         jmGeneralAttributePersistence, jmGeneralJobSetName}
  5095.     STATUS  current
  5096.     DESCRIPTION
  5097.         "The general group."
  5098.  
  5099.  
  5100.  
  5101. Bergman, Hastings, Isaacson, Lewis                 [Page 85]
  5102.  
  5103.  
  5104.  
  5105.  
  5106.  
  5107.                  Job Monitoring MIB, V0.83     July 14, 1997
  5108.  
  5109.  
  5110.     ::= { jmMIBGroups 1 }
  5111.  
  5112. jmJobIDGroup OBJECT-GROUP
  5113.     OBJECTS {
  5114.         jmJobIDJobSetIndex, jmJobIDJobIndex }
  5115.     STATUS  current
  5116.     DESCRIPTION
  5117.         "The job ID group."
  5118.     ::= { jmMIBGroups 2 }
  5119.  
  5120. jmJobGroup OBJECT-GROUP
  5121.     OBJECTS {
  5122.         jmJobState, jmJobStateReasons1, jmNumberOfInterveningJobs,
  5123.         jmJobKOctetsRequested, jmJobKOctetsProcessed,
  5124.         jmJobImpressionsRequested, jmJobImpressionsCompleted, jmJobOwner
  5125.         }
  5126.     STATUS  current
  5127.     DESCRIPTION
  5128.         "The job group."
  5129.     ::= { jmMIBGroups 3 }
  5130.  
  5131. jmAttributeGroup OBJECT-GROUP
  5132.     OBJECTS {
  5133.         jmAttributeValueAsInteger, jmAttributeValueAsOctets }
  5134.     STATUS  current
  5135.     DESCRIPTION
  5136.         "The attribute group."
  5137.     ::= { jmMIBGroups 4 }
  5138.  
  5139.  
  5140. END
  5141.  
  5142.  
  5143.  
  5144.  
  5145.  
  5146.  
  5147.  
  5148.  
  5149.  
  5150.  
  5151.  
  5152.  
  5153.  
  5154.  
  5155.  
  5156.  
  5157.  
  5158.  
  5159.  
  5160.  
  5161. Bergman, Hastings, Isaacson, Lewis                 [Page 86]
  5162.  
  5163.  
  5164.  
  5165.  
  5166.  
  5167.                  Job Monitoring MIB, V0.83     July 14, 1997
  5168.  
  5169.  
  5170.  
  5171. 5. Appendix A - Implementing the Job Life Cycle
  5172.  
  5173. The job object has well-defined states and client operations that affect
  5174. the transition between the job states.  Internal server and device
  5175. actions also affect the transitions of the job between the job states.
  5176. These states and transitions are referred to as the job's life cycle.
  5177.  
  5178. Not all implementations of job submission protocols have all of the
  5179. states of the job model specified here.  The job model specified here is
  5180. intended to be a superset of most implementations.  It is the purpose of
  5181. the agent to map the particular implementation's job life cycle onto the
  5182. one specified here.  The agent MAY omit any states not implemented.
  5183. Only the processing and completed states are required to be implemented
  5184. by an agent.  However, a conforming management application SHALL be
  5185. prepared to accept any of the states in the job life cycle specified
  5186. here, so that the management application can interoperate with any
  5187. conforming agent.
  5188.  
  5189. The job states are intended to be user visible.  The agent SHALL make
  5190. these states visible in the MIB, but only for the subset of job states
  5191. that the implementation has.  Some implementations MAY need to have sub-
  5192. states of these user-visible states.  The jmJobStateReasons1 object and
  5193. the jobStateReasonsN (N=2..4) attributes can be used to represent the
  5194. sub-states of the jobs.
  5195.  
  5196. Job states are intended to last a user-visible length of time in most
  5197. implementations.  However, some jobs may pass through some states in
  5198. zero time in some situations and/or in some implementations.
  5199.  
  5200. The job model does not specify how accounting and auditing is
  5201. implemented, except to assume that accounting and auditing logs are
  5202. separate from the job life cycle and last longer than job entries in the
  5203. MIB.  Jobs in the completed, aborted, or canceled states are not logs,
  5204. since jobs in these states are accessible via SNMP protocol operations
  5205. and SHALL be removed from the Job Monitoring MIB tables after a site-
  5206. settable or implementation-defined period of time.  An accounting
  5207. application MAY copy accounting information incrementally to an
  5208. accounting log as a job processes, or MAY be copied while the job is in
  5209. the canceled, aborted, or completed states, depending on implementation.
  5210. The same is true for auditing logs.
  5211.  
  5212. The jmJobState object specifies the standard job states.  The normal job
  5213. state transitions are shown in the state transition diagram presented in
  5214. Table 1.    
  5215.  
  5216.  
  5217.  
  5218.  
  5219.  
  5220.  
  5221. Bergman, Hastings, Isaacson, Lewis                 [Page 87]
  5222.  
  5223.  
  5224.  
  5225.  
  5226.  
  5227.                  Job Monitoring MIB, V0.83     July 14, 1997
  5228.  
  5229.  
  5230.  
  5231. 6. APPENDIX B - Support of the Job Submission ID in Job Submission
  5232. Protocols
  5233.  
  5234. This appendix lists the job submission protocols that support the
  5235. concept of a job submission ID and indicates the attribute used in that
  5236. job submission protocol.
  5237.  
  5238. 6.1 Hewlett-Packard's Printer Job Language (PJL)
  5239.  
  5240. Hewlett-Packard's Printer Job Language provides job-level printer
  5241. control and printer status information to applications. The PJL JOB
  5242. command is used at the beginning of a print job and can include options
  5243. applying only to that job. A PJL JOB command option has been defined to
  5244. facilitate passing the JobSubmissionID with the print job, as required
  5245. by the Job Monitoring MIB. The option is of the form:
  5246.  
  5247.      SUBMISSIONID = "id string"
  5248.  
  5249.  
  5250. Where the "id string" is a string and SHALL be enclosed in double
  5251. quotes.  The format is as described for the jmJobSubmissionID object.
  5252.  
  5253. The entire PJL JOB command with the optional parameter would be of the
  5254. form:
  5255.  
  5256.      @PJL JOB SUBMISSIONID = "id string"
  5257.  
  5258.  
  5259. See "Printer Job Language Technical Reference Manual", part number 5021-
  5260. 0328, from Hewlett-Packard for complete information on the PJL JOB
  5261. command and the Printer Job Language.
  5262.  
  5263. 6.2 ISO DPA
  5264.  
  5265. The ISO 10175 Document Printing Application (DPA) protocol specifies the
  5266. "job-client-id" attribute that allows the client to supply a text string
  5267. ID for each job.
  5268.  
  5269. 7. References
  5270.  
  5271. [print-mib] The Printer MIB - RFC 1759, proposed IETF standard.  Also an
  5272. Internet-Draft on the standards track as a draft standard: draft-ietf-
  5273. printmib-mib-info-01.txt
  5274.  
  5275. [iso-dpa] ISO/IEC 10175 Document Printing Application (DPA).  See
  5276. ftp://ftp.pwg.org/pub/pwg/dpa/
  5277.  
  5278.  
  5279.  
  5280.  
  5281. Bergman, Hastings, Isaacson, Lewis                 [Page 88]
  5282.  
  5283.  
  5284.  
  5285.  
  5286.  
  5287.                  Job Monitoring MIB, V0.83     July 14, 1997
  5288.  
  5289.  
  5290. [ipp-model] Internet Printing Protocol (IPP), in progress on the IETF
  5291. standards track.  See draft-ietf-ipp-model-01.txt.  See also
  5292. http://www.pwg.org/ipp/index.html
  5293.  
  5294. [tipsi] IEEE 1284.1, Transport-independent Printer System Interface
  5295. (TIPSI).
  5296.  
  5297. [mib-II] MIB-II, RFC 1213.
  5298.  
  5299. [hr-mib] P. Grillo, S. Waldbusser, "Host Resources MIB", RFC 1514,
  5300. September 1993
  5301.  
  5302. [SMIv2] SNMPv2-TC, RFC 1903,
  5303.  
  5304. [req-words] S. Bradner, "Keywords for use in RFCs to Indicate
  5305. Requirement Levels", RFC 2119, March 1997.
  5306.  
  5307. [URI-spec] Berners-Lee, T., Masinter, L., McCahill, M. , "Uniform
  5308. Resource Locators (URL)", RFC 1738, December, 1994.
  5309.  
  5310. [iana-media-types] IANA Registration of MIME media types (MIME content
  5311. types/subtypes).  See ftp://ftp.isi.edu/in-notes/iana/assignments/
  5312.  
  5313. 8. Author's Addresses
  5314.     Ron Bergman
  5315.     Dataproducts Corp.
  5316.     1757 Tapo Canyon Road
  5317.     Simi Valley, CA 93063-3394
  5318.  
  5319.     Phone: 805-578-4421
  5320.     Fax:  805-578-4001
  5321.     Email: rbergman@dpc.com
  5322.  
  5323.  
  5324.     Tom Hastings
  5325.     Xerox Corporation, ESAE-231
  5326.     701 S. Aviation Blvd.
  5327.     El Segundo, CA   90245
  5328.  
  5329.     Phone: 310-333-6413
  5330.     Fax:   310-333-5514
  5331.     EMail: hastings@cp10.es.xerox.com
  5332.  
  5333.  
  5334.     Scott A. Isaacson
  5335.     Novell, Inc.
  5336.     122 E 1700 S
  5337.     Provo, UT   84606
  5338.  
  5339.  
  5340.  
  5341. Bergman, Hastings, Isaacson, Lewis                 [Page 89]
  5342.  
  5343.  
  5344.  
  5345.  
  5346.  
  5347.                  Job Monitoring MIB, V0.83     July 14, 1997
  5348.  
  5349.  
  5350.  
  5351.     Phone: 801-861-7366
  5352.     Fax:   801-861-4025
  5353.     EMail: scott_isaacson@novell.com
  5354.  
  5355.  
  5356.     Harry Lewis
  5357.     IBM Corporation
  5358.     6300 Diagonal Hwy
  5359.     Boulder, CO 80301
  5360.  
  5361.     Phone: (303) 924-5337
  5362.     Fax:
  5363.     Email: harryl@us.ibm.com
  5364.  
  5365.  
  5366.     Send comments to the printmib WG using the Job Monitoring Project
  5367.     (JMP) Mailing List:  jmp@pwg.org
  5368.  
  5369.     To learn how to subscribe, send email to:  jmp-request@pwg.org
  5370.  
  5371.     For further information, access the PWG web page under "JMP":
  5372.     http://www.pwg.org/
  5373.  
  5374.  
  5375.  
  5376. Other Participants:
  5377.     Chuck Adams - Tektronix
  5378.     Jeff Barnett - IBM
  5379.     Keith Carter, IBM Corporation
  5380.     Jeff Copeland - QMS
  5381.     Andy Davidson - Tektronix
  5382.     Roger deBry - IBM
  5383.     Mabry Dozier - QMS
  5384.     Lee Ferrel - Canon
  5385.     Steve Gebert - IBM
  5386.     Robert Herriot - Sun Microsystems Inc.
  5387.     Shige Kanemitsu - Kyocera
  5388.     David Kellerman - Northlake Software
  5389.     Rick Landau - Digital
  5390.     Harry Lewis - IBM
  5391.     Pete Loya - HP
  5392.     Ray Lutz - Cognisys
  5393.     Jay Martin - Underscore
  5394.     Mike MacKay, Novell, Inc.
  5395.     Stan McConnell - Xerox
  5396.     Carl-Uno Manros, Xerox, Corp.
  5397.     Pat Nogay - IBM
  5398.  
  5399.  
  5400.  
  5401. Bergman, Hastings, Isaacson, Lewis                 [Page 90]
  5402.  
  5403.  
  5404.  
  5405.  
  5406.  
  5407.                  Job Monitoring MIB, V0.83     July 14, 1997
  5408.  
  5409.  
  5410.     Bob Pentecost - HP
  5411.     Rob Rhoads - Intel
  5412.     David Roach - Unisys
  5413.     Hiroyuki Sato - Canon
  5414.     Bob Setterbo - Adobe
  5415.     Gail Songer, EFI
  5416.     Mike Timperman - Lexmark
  5417.     Randy Turner - Sharp
  5418.     William Wagner - Digital Products
  5419.     Jim Walker - Dazel
  5420.     Chris Wellens - Interworking Labs
  5421.     Rob Whittle - Novell
  5422.     Don Wright - Lexmark
  5423.     Lloyd Young - Lexmark
  5424.     Atsushi Yuki - Kyocera
  5425.     Peter Zehler, Xerox, Corp.
  5426.  
  5427.  
  5428.  
  5429.  
  5430.  
  5431.  
  5432.  
  5433.  
  5434.  
  5435.  
  5436.  
  5437.  
  5438.  
  5439.  
  5440.  
  5441.  
  5442.  
  5443.  
  5444.  
  5445.  
  5446.  
  5447.  
  5448.  
  5449.  
  5450.  
  5451.  
  5452.  
  5453.  
  5454.  
  5455.  
  5456.  
  5457.  
  5458.  
  5459.  
  5460.  
  5461. Bergman, Hastings, Isaacson, Lewis                 [Page 91]
  5462.  
  5463.  
  5464.  
  5465.  
  5466.  
  5467.                  Job Monitoring MIB, V0.83     July 14, 1997
  5468.  
  5469.  
  5470. 9. INDEX
  5471.  
  5472. This index includes the textual conventions, the objects, and the
  5473. attributes.  Textual conventions all start with the prefix:  "JM" and
  5474. end with the suffix:  "TC".  Objects all starts with the prefix:  "jm"
  5475. followed by the group name.  Attributes are identified with enums, and
  5476. so start with any lower case letter and have no special prefix.
  5477.  
  5478.  
  5479.                                  ------
  5480.  
  5481. colorantConsumed, 51
  5482. colorantRequested, 50
  5483.  
  5484.                                  --D---
  5485.  
  5486. deviceNameRequested, 42
  5487. documentCopiesCompleted, 47
  5488. documentCopiesRequested, 47
  5489. documentFormat, 44
  5490. documentFormatIndex, 44
  5491. documentName, 43
  5492.  
  5493.                                  --F---
  5494.  
  5495. fileName, 43
  5496. finishing, 46
  5497. fullColorImpressionsCompleted, 49
  5498.  
  5499.                                  --H---
  5500.  
  5501. highlightColorImpressionsCompleted, 49
  5502.  
  5503.                                  --I---
  5504.  
  5505. impressionsCompletedCurrentCopy, 48
  5506. impressionsInterpreted, 48
  5507. impressionsSentToDevice, 48
  5508. impressionsSpooled, 48
  5509.  
  5510.                                  --J---
  5511.  
  5512. jmAttributeInstanceIndex, 77
  5513. jmAttributeTypeIndex, 76
  5514. JmAttributeTypeTC, 39
  5515. jmAttributeValueAsInteger, 77
  5516. jmAttributeValueAsOctets, 78
  5517. JmBooleanTC, 32
  5518.  
  5519.  
  5520.  
  5521. Bergman, Hastings, Isaacson, Lewis                 [Page 92]
  5522.  
  5523.  
  5524.  
  5525.  
  5526.  
  5527.                  Job Monitoring MIB, V0.83     July 14, 1997
  5528.  
  5529.  
  5530. JmFinishingTC, 29
  5531. jmGeneralAttributePersistence, 67
  5532. jmGeneralJobPersistence, 67
  5533. jmGeneralJobSetIndex, 65
  5534. jmGeneralJobSetName, 68
  5535. jmGeneralNewestActiveJobIndex, 66
  5536. jmGeneralNumberOfActiveJobs, 66
  5537. jmGeneralOldestActiveJobIndex, 66
  5538. jmJobIDJobIndex, 70
  5539. jmJobIDJobSetIndex, 70
  5540. jmJobImpressionsCompleted, 74
  5541. jmJobImpressionsRequested, 74
  5542. jmJobIndex, 71
  5543. jmJobKOctetsProcessed, 73
  5544. jmJobKOctetsRequested, 73
  5545. jmJobOwner, 74
  5546. JmJobServiceTypesTC, 54
  5547. JmJobSourcePlatformTypeTC, 28
  5548. jmJobState, 72
  5549. jmJobStateReasons1, 72
  5550. JmJobStateReasons1TC, 55
  5551. JmJobStateReasons2TC, 59
  5552. JmJobStateReasons3TC, 63
  5553. JmJobStateReasons4TC, 63
  5554. JmJobStateTC, 36
  5555. jmJobSubmissionID, 69
  5556. JmJobSubmissionTypeTC, 34
  5557. JmMediumTypeTC, 33
  5558. jmNumberOfInterveningJobs, 73
  5559. JmPrinterResolutionTC, 31
  5560. JmPrintQualityTC, 30
  5561. JmTimeStampTC, 28
  5562. JmTonerEconomyTC, 32
  5563. jobAccountName, 40
  5564. jobComment, 43
  5565. jobCompletedTime, 52
  5566. jobCopiesCompleted, 47
  5567. jobCopiesRequested, 47
  5568. jobHold, 45
  5569. jobHoldUntil, 45
  5570. jobKOctetsTransferred, 47
  5571. jobName, 41
  5572. jobOriginatingHost, 42
  5573. jobPriority, 44
  5574. jobProcessAfterDateAndTime, 45
  5575. jobProcessingCPUTime, 52
  5576. jobServiceTypes, 41
  5577. jobSourceChannelIndex, 42
  5578.  
  5579.  
  5580.  
  5581. Bergman, Hastings, Isaacson, Lewis                 [Page 93]
  5582.  
  5583.  
  5584.  
  5585.  
  5586.  
  5587.                  Job Monitoring MIB, V0.83     July 14, 1997
  5588.  
  5589.  
  5590. jobSourcePlatformType, 42
  5591. jobStartedBeingHeldTime, 52
  5592. jobStartedProcessingTime, 52
  5593. jobStateReasons2, 40
  5594. jobStateReasons3, 40
  5595. jobStateReasons4, 40
  5596. jobSubmissionTime, 51
  5597. jobSubmissionToServerTime, 51
  5598.  
  5599.                                  --M---
  5600.  
  5601. mediumConsumed, 50
  5602. mediumRequested, 50
  5603.  
  5604.                                  --N---
  5605.  
  5606. numberOfDocuments, 43
  5607.  
  5608.                                  --O---
  5609.  
  5610. other, 39
  5611. outputBin, 45
  5612.  
  5613.                                  --P---
  5614.  
  5615. pagesCompleted, 49
  5616. pagesCompletedCurrentCopy, 49
  5617. pagesRequested, 49
  5618. physicalDevice, 43
  5619. printerResolutionRequested, 46
  5620. printerResolutionUsed, 46
  5621. printQualityRequested, 46
  5622. printQualityUsed, 46
  5623. processingMessage, 40
  5624.  
  5625.                                  --Q---
  5626.  
  5627. queueNameRequested, 43
  5628.  
  5629.                                  --S---
  5630.  
  5631. serverAssignedJobName, 40
  5632. sheetsCompleted, 50
  5633. sheetsCompletedCurrentCopy, 50
  5634. sheetsRequested, 50
  5635. sides, 46
  5636. submittingApplicationName, 42
  5637. submittingServerName, 42
  5638.  
  5639.  
  5640.  
  5641. Bergman, Hastings, Isaacson, Lewis                 [Page 94]
  5642.  
  5643.  
  5644.  
  5645.  
  5646.  
  5647.                  Job Monitoring MIB, V0.83     July 14, 1997
  5648.  
  5649.  
  5650.                                  ------
  5651.  
  5652. tonerDensityRequested, 46
  5653. tonerDensityUsed, 47
  5654. tonerEcomonyRequested, 46
  5655. tonerEcomonyUsed, 46
  5656.  
  5657.  
  5658.  
  5659.  
  5660.  
  5661.  
  5662.  
  5663.  
  5664.  
  5665.  
  5666.  
  5667.  
  5668.  
  5669.  
  5670.  
  5671.  
  5672.  
  5673.  
  5674.  
  5675.  
  5676.  
  5677.  
  5678.  
  5679.  
  5680.  
  5681.  
  5682.  
  5683.  
  5684.  
  5685.  
  5686.  
  5687.  
  5688.  
  5689.  
  5690.  
  5691.  
  5692.  
  5693.  
  5694.  
  5695.  
  5696.  
  5697.  
  5698.  
  5699.  
  5700.  
  5701. Bergman, Hastings, Isaacson, Lewis                 [Page 95]
  5702.