rfc2707.txt

<VC++网络游戏建摸与实现>源代码

Network Working Group                                          R. Bergman
Request for Comments: 2707                             Dataproducts Corp.
Category: Informational                                  T. Hastings, Ed.
                                                        Xerox Corporation
                                                              S. Isaacson
                                                             Novell, Inc.
                                                                 H. Lewis
                                                                IBM Corp.
                                                            November 1999


                       Job Monitoring MIB - V1.0

Status of this Memo

   This memo provides information for the Internet community.  It does
   not specify an Internet standard of any kind.  Distribution of this
   memo is unlimited.

Copyright Notice

   Copyright (C) The Internet Society (1999).  All Rights Reserved.

IESG Note

   This MIB module uses an unconventional scheme for modeling management
   information (on top of the SNMP model) which is unique to this MIB.
   The IESG recommends against using this document as an example for the
   design of future MIBs.

   The "Printer Working Group" industry consortium is not an IETF
   working group, and the IETF does not recognize the Printer Working
   Group as a standards-setting body.  This document is being published
   solely to provide information to the Internet community regarding a
   MIB that might be deployed in the marketplace. Publication of this
   document as an RFC is not an endorsement of this MIB.

Abstract

   This document provides a printer industry standard SNMP MIB for (1)
   monitoring the status and progress of print jobs (2) obtaining
   resource requirements before a job is processed, (3) monitoring
   resource consumption while a job is being processed and (4)
   collecting resource accounting data after the completion of a job.
   This MIB is intended to be implemented (1) in a printer or (2) in a
   server that supports one or more printers.  Use of the object set is
   not limited to printing.  However, support for services other than
   printing is outside the scope of this Job Monitoring MIB.  Future



Bergman, et al.              Informational                      [Page 1]

RFC 2707               Job Monitoring MIB - V1.0           November 1999


   extensions to this MIB may include, but are not limited to, fax
   machines and scanners.

Table of Contents

   1   INTRODUCTION                                                    4
     1.1 Types of Information in the MIB                               5
     1.2 Types of Job Monitoring Applications                          6
   2   TERMINOLOGY AND JOB MODEL                                       7
     2.1 System Configurations for the Job Monitoring MIB             11
       2.1.1   Configuration 1 - client-printer                       11
       2.1.2   Configuration 2 - client-server-printer - agent in the
               server                                                 12
       2.1.3   Configuration 3 - client-server-printer - client
               monitors printer agent and server                      14
   3   MANAGED OBJECT USAGE                                           15
     3.1 Conformance Considerations                                   15
       3.1.1   Conformance Terminology                                16
       3.1.2   Agent Conformance Requirements                         16
         3.1.2.1   MIB II System Group objects                        17
         3.1.2.2   MIB II Interface Group objects                     17
         3.1.2.3   Printer MIB objects                                17
       3.1.3   Job Monitoring Application Conformance Requirements    17
     3.2 The Job Tables and the Oldest Active and Newest Active
         Indexes                                                      18
     3.3 The Attribute Mechanism and the Attribute Table(s)           20
       3.3.1   Conformance of Attribute Implementation                21
       3.3.2   Useful, 'Unknown', and 'Other' Values for Objects and
               Attributes                                             21
       3.3.3   Index Value Attributes                                 22
       3.3.4   Data Sub-types and Attribute Naming Conventions        22
       3.3.5   Single-Value (Row) Versus Multi-Value (MULTI-ROW)
               Attributes                                             23
       3.3.6   Requested Objects and Attributes                       23
       3.3.7   Consumption Attributes                                 24
       3.3.8   Attribute Specifications                               24
       3.3.9   Job State Reason bit definitions                       43
         3.3.9.1   JmJobStateReasons1TC specification                 44
         3.3.9.2   JmJobStateReasons2TC specification                 47
         3.3.9.3   JmJobStateReasons3TC specification                 51
         3.3.9.4   JmJobStateReasons4TC specification                 51
     3.4 Monitoring Job Progress                                      51
     3.5 Job Identification                                           55
       3.5.1   The Job Submission ID specifications                   56
     3.6 Internationalization Considerations                          60
       3.6.1   Text generated by the server or device                 61
       3.6.2   Text supplied by the job submitter                     61
       3.6.3   'DateAndTime' for representing the date and time       63



Bergman, et al.              Informational                      [Page 2]

RFC 2707               Job Monitoring MIB - V1.0           November 1999


     3.7 IANA and PWG Registration Considerations                     63
       3.7.1   PWG Registration of enums                              63
         3.7.1.1   Type 1 enumerations                                64
         3.7.1.2   Type 2 enumerations                                64
         3.7.1.3   Type 3 enumeration                                 64
       3.7.2   PWG Registration of type 2 bit values                  65
       3.7.3   PWG Registration of Job Submission Id Formats          65
       3.7.4   PWG Registration of MIME types/sub-types for document-
               formats                                                65
     3.8 Security Considerations                                      65
       3.8.1   Read-Write objects                                     65
       3.8.2   Read-Only Objects In Other User's Jobs                 66
     3.9 Notifications                                                66
   4   MIB SPECIFICATION                                              67
     Textual conventions for this MIB module                          68
       JmUTF8StringTC                                                 68
       JmJobStringTC                                                  68
       JmNaturalLanguageTagTC                                         68
       JmTimeStampTC                                                  69
       JmJobSourcePlatformTypeTC                                      69
       JmFinishingTC                                                  70
       JmPrintQualityTC                                               71
       JmPrinterResolutionTC                                          71
       JmTonerEconomyTC                                               72
       JmBooleanTC                                                    72
       JmMediumTypeTC                                                 72
       JmJobCollationTypeTC                                           74
       JmJobSubmissionIDTypeTC                                        74
       JmJobStateTC                                                   75
       JmAttributeTypeTC                                              78
       JmJobServiceTypesTC                                            81
       JmJobStateReasons1TC                                           83
       JmJobStateReasons2TC                                           83
       JmJobStateReasons3TC                                           83
       JmJobStateReasons4TC                                           84
     The General Group (MANDATORY)                                    84
       jmGeneralJobSetIndex   (Int32(1..32767))                       85
       jmGeneralNumberOfActiveJobs   (Int32(0..))                     86
       jmGeneralOldestActiveJobIndex   (Int32(0..))                   86
       jmGeneralNewestActiveJobIndex   (Int32(0..))                   86
       jmGeneralJobPersistence   (Int32(15..))                        87
       jmGeneralAttributePersistence   (Int32(15..))                  87
       jmGeneralJobSetName   (UTF8String63)                           88
     The Job ID Group (MANDATORY)                                     88
       jmJobSubmissionID   (OCTET STRING(SIZE(48)))                   89
       jmJobIDJobSetIndex   (Int32(0..32767))                         90
       jmJobIDJobIndex   (Int32(0..))                                 91
     The Job Group (MANDATORY)                                        91



Bergman, et al.              Informational                      [Page 3]

RFC 2707               Job Monitoring MIB - V1.0           November 1999


       jmJobIndex   (Int32(1..))                                      92
       jmJobState   (JmJobStateTC)                                    92
       jmJobStateReasons1   (JmJobStateReasons1TC)                    93
       jmNumberOfInterveningJobs   (Int32(-2..))                      93
       jmJobKOctetsPerCopyRequested   (Int32(-2..))                   94
       jmJobKOctetsProcessed   (Int32(-2..))                          94
       jmJobImpressionsPerCopyRequested   (Int32(-2..))               95
       jmJobImpressionsCompleted   (Int32(-2..))                      96
       jmJobOwner   (JobString63)                                     96
     The Attribute Group (MANDATORY)                                  97
       jmAttributeTypeIndex   (JmAttributeTypeTC)                     98
       jmAttributeInstanceIndex   (Int32(1..32767))                   99
       jmAttributeValueAsInteger   (Int32(-2..))                      99
       jmAttributeValueAsOctets   (Octets63)                         100
   5   APPENDIX A - IMPLEMENTING THE JOB LIFE CYCLE                  104
   6   APPENDIX B - SUPPORT OF JOB SUBMISSION PROTOCOLS              105
   7   REFERENCES                                                    105
   8   NOTICES                                                       108
   9   AUTHORS' ADDRESSES                                            109
   10  INDEX                                                         111
   11  Full Copyright Statement                                      114

1  Introduction

   This specification defines an official Printer Working Group (PWG)
   [PWG] standard SNMP MIB for the monitoring of jobs on network
   printers.  This specification is being published as an IETF
   Information Document for the convenience of the Internet community.
   In consultation with the IETF Application Area Directors, it was
   concluded that this MIB specification properly belongs as an
   Information document, because this MIB monitors a service node on the
   network, rather than a network node proper.

   The Job Monitoring MIB is intended to be implemented by an agent
   within a printer or the first server closest to the printer, where
   the printer is either directly connected to the server only or the
   printer does not contain the job monitoring MIB agent.  It is
   recommended that implementations place the SNMP agent as close as
   possible to the processing of the print job.  This MIB applies to
   printers with and without spooling capabilities.  This MIB is
   designed to be compatible with most current commonly-used job
   submission protocols.  In most environments that support high
   function job submission/job control protocols, like ISO DPA [iso-
   dpa], those protocols would be used to monitor and manage print jobs
   rather than using the Job Monitoring MIB.






Bergman, et al.              Informational                      [Page 4]

RFC 2707               Job Monitoring MIB - V1.0           November 1999


   The Job Monitoring MIB consists of a General Group, a Job Submission
   ID Group, a Job Group, and an Attribute Group.  Each group is a
   table.  All accessible objects are read-only.  The General Group
   contains general information that applies to all jobs in a job set.
   The Job Submission ID table maps the job submission ID that the
   client uses to identify a job to the jmJobIndex that the Job
   Monitoring Agent uses to identify jobs in the Job and Attribute
   tables.  The Job table contains the MANDATORY integer job state and
   status objects.  The Attribute table consists of multiple entries per
   job that specify (1) job and document identification and parameters,
   (2) requested resources, and (3) consumed resources during and after
   job processing/printing.  A larger number of job attributes are
   defined as textual conventions that an agent SHALL return if the
   server or device implements the functionality so represented and the
   agent has access to the information.

1.1 Types of Information in the MIB

   The job MIB is intended to provide the following information for the
   indicated Role Models in the Printer MIB [print-mib] (Appendix D -
   Roles of Users).

      User:

         Provide the ability to identify the least busy printer.  The
         user will be able to determine the number and size of jobs
         waiting for each printer.  No attempt is made to actually
         predict the length of time that jobs will take.

         Provide the ability to identify the current status of the
         user's job (user queries).

         Provide a timely indication that the job has completed and
         where it can be found.

         Provide error and diagnostic information for jobs that did not
         successfully complete.

      Operator:

         Provide a presentation of the state of all the jobs in the
         print system.

         Provide the ability to identify the user that submitted the
         print job.

         Provide the ability to identify the resources required by each
         job.



Bergman, et al.              Informational                      [Page 5]

RFC 2707               Job Monitoring MIB - V1.0           November 1999


         Provide the ability to define which physical printers are
         candidates for the print job.

         Provide some idea of how long each job will take.  However,
         exact estimates of time to process a job is not being
         attempted.  Instead, objects are included that allow the