rfc2708.txt

著名的RFC文档,其中有一些文档是已经翻译成中文的的.

   jmJobSubmissionID table should not be needed by a management
   application.  See Section 1.0.

4.2  jmJobIndex Mapped to IPP

   The job index (jmJobIndex) assigned by the SNMP job monitoring agent
   is returned to the client by IPP as the job-id job description
   attribute.  (Since IPP does not require consecutively generated job-
   ids, the agent may receive jobs from multiple clients and can assign
   jmJobIndex in an ascending sequence independent of the submitting job
   client.)  The IPP job-id must be restricted to the range of 1 to
   99,999,999 (decimal) to allow the value to be properly represented in
   jmJobSubmissionID.















Bergman                      Informational                      [Page 7]

RFC 2708            Job Submission Protocol Mapping        November 1999


4.3  Other MIB Objects Mapped to IPP

   MIB Object                       | IPP Job attribute
   ---------------------------------+-----------------------------------
   jmJobState                       | job-state
   jmJobStateReasons1               | job-state-reasons (note 1)
   jmNumberOfInterveningJobs        | number-of-intervening-jobs
   jmJobKOctetsPerCopyRequested     | job-k-octets
   jmJobKOctetsProcessed            | job-k-octets-processed
   jmJobImpressionsPerCopyRequested | job-impressions
   jmJobImpressionsCompleted        | job-impressions-completed
   jmJobOwner                       | job-originating-user-name

   Notes:
   ------
   1. jmJobStateReasons1 is a bit map which can describe up to 31 job
      state reasons.  Also the IPP "job-state-reasons" attribute is a
      multi-valued attribute with each value being a keyword.  The IPP
      condition may change multiple bits in this object.  The IPP "job-
      state-reasons" attribute may also change one or more of the
      jobStateReasonsN attributes (see section 4.4).


4.4  The Attribute Group Mapped to IPP

   The following mappings are required if the listed IPP job template
   attribute is provided.
























Bergman                      Informational                      [Page 8]

RFC 2708            Job Submission Protocol Mapping        November 1999


MIB attribute              | IPP job attribute            | Data type
---------------------------+------------------------------+-------------
jobStateReasonsN(N=2, 3, 4)| job-state-reasons (note 3)   | Integer
jobCodedCharSet            | attributes-charset (note 1)  | Octet String
jobNaturalLanguageTag      | attributes-natural-language  | Octet String
jobURI                     | job-uri                      | Octet String
jobName                    | job-name                     | Octet String
physicalDevice             | output-device-assigned       | Octet String
numberOfDocuments          | number-of-documents          | Integer
jobPriority                | job-priority                 | Integer
jobHoldUntil               | job-hold-until               | Octet String
sides                      | sides (note 2)               | Integer
finishing                  | finishings                   | Integer
printQualityRequested      | print-quality                | Integer
printerResolutionRequested | printer-resolution           | Integer
jobCopiesRequested         | copies (note 4)              | Integer
documentCopiesRequested    | copies (note 4)              | Integer
jobCollationType           | multiple-document-handling   | Integer
sheetsRequested            | job-media-sheets             | Integer
sheetsCompleted            | job-media-sheets-completed   | Integer
mediumRequested            | media                        | Octet String
jobSubmissionTime          | time-at-submission           | Integer
jobStartedProcessingTime   | time-at-processing           | Integer
jobCompletionTime          | time-at-completed            | Integer

   Notes:
   ------
   1. jobCodedCharSet is an enum from the IANA registry which is also
      used in the Printer MIB.  The IPP attributes-charset is the name
      (MIME preferred name) of the character set.
   2. The Job MIB sides attribute uses the integer values "1" and "2".
      The IPP sides attribute uses three keywords.
   3. jobStateReasonsN are three attributes (N=2, 3, 4).  Also the IPP
      "job-state-reasons" attribute is a multi-valued attribute with
      each value being a keyword.  The IPP condition may change multiple
      bits in one or more of these Job MIB attributes.  See also
      jmJobStateReasons1 in section 4.3.
   4. The IPP "copies" attribute maps to the Job MIB:
      (1) jobCopiesRequested when the job has only one document OR IPP
          "multiple-document-handling" is 'single-valued'
      (2) documentCopiesRequested, in which case the MIB value is the
          total number of document copies that the job will produce as a
          whole.








Bergman                      Informational                      [Page 9]

RFC 2708            Job Submission Protocol Mapping        November 1999


5.0  INTELLIGENT PRINTER DATA STREAM (IPDS)

   The IPDS datastream facilitates a close relationship between the
   print supervisor (Print Services Facility - PSF) and the printer.
   There are PSF applications for UNIX, Windows, OS/2, OS/400 and host
   operating systems such as VM, MVS and VSE. Together, PSF and IPDS
   represent a complete, mature and robust job management framework
   which includes font and resource management, page progress tracking,
   job cancellation, complete error recovery and end-user notification.
   Because PSF and the printer correspond via the use of locally
   assigned ID苨, there is a limited amount of clear text information
   provided during submission for use by the Job MIB.

5.1  jmJobSubmissionId Mapped to IPDS

   For IPDS on the MVS or VSE platform:

   octet 1:   'E'

   octets 2-40:  Contains bytes 2-27 of the XOH Define Group Boundary
                 Group ID triplet.  Octet position 2 must carry the
                 value x'01'.  Bytes 28-40 must be filled with spaces.

   octets 41-48:  Contains a decimal (ASCII coded) representation of the
                  jmJobIndex assigned by the agent.  Leading zeros shall
                  be inserted to fill the entire 8 octet field.

   For IPDS on the VM platform:

   octet 1:   'F'

   octets 2-40:  Contains bytes 2-31 of the XOH Define Group Boundary
                 Group ID triplet.  Octet position 2 must carry the
                 value x'02'.  Bytes 32-40 must be filled with spaces.

   octets 41-48:  Contains a decimal (ASCII coded) representation of the
                  jmJobIndex assigned by the agent.  Leading zeros shall
                  be inserted to fill the entire 8 octet field.

   For IPDS on the OS/400 platform:

   octet 1:   'G'

   octets 2-40:  Contains bytes 2-36 of the XOH Define Group Boundary
                 Group ID triplet.  Octet position 2 must carry the
                 value x'03'.  Bytes 37-40 must be filled with spaces.





Bergman                      Informational                     [Page 10]

RFC 2708            Job Submission Protocol Mapping        November 1999


   octets 41-48:  Contains a decimal (ASCII coded) representation of the
                  jmJobIndex assigned by the agent.  Leading zeros shall
                  be inserted to fill the entire 8 octet field.

5.2  The Attribute Group Mapped to IPDS

For MVS/VSE:

MIB attribute                     | IPDS XOH DGB Group ID | Data type
----------------------------------+-----------------------+-------------
jobSourcePlatformType sptMVS(7)   | Byte 2 = x'01'        | Integer
jobName                           | Bytes 4-11            | Octet String


For VM:

MIB attribute                     | IPDS XOH DGB Group ID | Data type
----------------------------------+-----------------------+-------------
jobSourcePlatformType sptVM(8)    | Byte 2 = x'02'        | Integer
fileName                          | Bytes 4-11            | Octet String


For OS/400:

MIB attribute                     | IPDS XOH DGB Group ID | Data type
----------------------------------+-----------------------+-------------
jobSourcePlatformType sptOS400(9) | byte 2 = x'03'        | Integer
fileName                          | Bytes 23-32           | Octet String
jobName                           | Bytes 37-46           | Octet String

6.0  DOCUMENT PRINTING APPLICATION (DPA)

   The ISO 10175 Document Printing Application (DPA) [DPA] supports
   printing using any one of the three possible configurations.  For
   configuration 2, the mapping defined herein is performed on a server.
   Otherwise, the mapping is performed on an agent within the printer.

6.1  jmJobSubmissionID Mapped to DPA

   DPA contains a rich set of parameters which allow several methods of
   creating the jmJobSubmissionID object.  To prevent interoperability
   problems, the preferred method is to use the DPA job-owner attribute
   as follows:








Bergman                      Informational                     [Page 11]

RFC 2708            Job Submission Protocol Mapping        November 1999


   octet 1:   '0'

   octets 2-40:  Contains the DPA job-owner attribute supplied by the
                 submitter.  If the job-owner is less than 40 octets,
                 the left-most character in the string shall appear in
                 octet position 2.  Any unused portion of this field
                 shall be filled with spaces.  Otherwise, only the last
                 39 bytes shall be included.

   octets 41-48:  Contains an 8-digit sequential decimal number.

6.2  jmJobIndex Mapped to DPA

   The job index (jmJobIndex) assigned by the SNMP job monitoring agent
   is returned to the client by DPA as a decimal digit string as the
   value of the DPA job-identifier attribute.  (Since DPA does not
   require consecutively generated job-identifiers, the agent may
   receive jobs from multiple clients and can assign the jmJobIndex in
   an ascending sequence independent of the submitting job client.)  The
   DPA job-identifier must be restricted to the range of 1 to 99,999,999
   (decimal) to allow the value to be properly represented in
   jmJobSubmissionID.

   NOTE - Since DPA returns the "job-identifier" attribute with the
   jmJobIndex value for a job when the job is submitted, the use of the
   jmJobSubmissionID table should not be needed by a management
   application.  See Section 1.0.

6.3  Other MIB Objects Mapped to DPA

   MIB Object                       | DPA Job attribute
   ---------------------------------+------------------------------------
   jmJobState                       | job-state
   jmJobStateReasons1               | job-state-reasons (note 2)
   jmNumberOfInterveningJobs        | intervening-jobs
   jmJobKOctetsPerCopyRequested     | total-job-octets (notes 1, 3)
   jmJobKOctetsProcessed            | job-octets-completed (note 1)
   jmJobImpressionsPerCopyRequested | job-impression-count (note 3)
   jmJobImpressionsCompleted        | impressions-completed
   jmJobOwner                       | job-owner

   Notes:
   ------
   1. jmJobKOctetsPerCopyRequested and jmJobKOctetsProcessed is in K
      octets while the DPA job-total-octets and job-octets-completed is
      in octets and is 63-bits of significance.





Bergman                      Informational                     [Page 12]

RFC 2708            Job Submission Protocol Mapping        November 1999


   2. jmJobStateReasons1 is a bit map which can describe up to 31 job
      state reasons.  Also the DPA "job-state-reasons" attribute is a
      multi-valued attribute with each value being an object identifier
      (OID).  The DPA condition may change multiple bits in this object.
      The DPA condition may also change one or more of the
      jobStateReasonsN attributes (see section 4.4)
   3. DPA octets include the multiplication factor due to job and
      document copies, while the MIB values do not.

6.4  The Attribute Group Mapped to DPA

   The following mappings are required if the listed DPA job attribute
   is provided.

MIB attribute              | DPA job attribute            |IPP Data type
---------------------------+------------------------------+-------------
jobStateReasonsN(N=2, 3, 4)| job-state-reasons (note 2)   | Integer
jobCodedCharSet            | (note 1)                     | Octet String
jobAccountName             | accounting-information       | Octet String
jobName                    | job-name                     | Octet String
deviceNameRequested        | printer-name-requested       | Octet String
physicalDevice             | printers-assigned            | Octet String
numberOfDocuments          | number-of-documents          | Integer
fileName                   | file-name                    | Octet String
documentName               | document-name                | Octet String
jobComment                 | job-comment                  | Octet String
documentFormat             | document-format              | Octet String
jobPriority                | job-priority                 | Integer
jobProcessAfterDateAndTime | job-print-after              | Octet String
outputBin                  | results-profile.output-bin   | Octet String
sides                      | sides (note 3)               | Integer
finishing                  | job-finishing, finishing     | Integer
printQualityRequested      | print-quality                | Integer
printerResolutionRequested | default-printer-resolution   | Integer
                           |  (note 4)                    |
jobCopiesRequested         | results-profile.job-copies   | Integer
jobCopiesCompleted         | job-copies-completed         | Integer
documentCopiesRequested    | copy-count (note 5)          | Integer
documentCopiesCompleted    | copies-completed (note 6)    | Integer
sheetsRequested            | job-media-sheet-count        | Integer
sheetsCompleted            | job-media-sheets-completed   | Integer
pagesRequested             | job-page-count               | Integer
pagesCompleted             | pages-completed              | Integer
mediumRequested            | page-media-select,           | Octet String
                           |  default-medium              |
jobSubmissionTime          | submission-time (note 7)     | Octet String
jobStartedProcessingTime   | started-printing-time (note 7) Octet String
jobCompletionTime          | completion-time (note 7)     | Octet String



Bergman                      Informational                     [Page 13]