Network Working Group R. Bergman
Request for Comments: 2708 Dataproducts Corp.
Category: Informational November 1999
Job Submission Protocol Mapping Recommendations
for the Job Monitoring MIB
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.
Abstract
This document defines the recommended mapping for many currently
popular Job submission protocols to objects and attributes in the Job
Monitoring MIB.
Table of Contents
1.0 INTRODUCTION.................................................2
2.0 LINE PRINTER DAEMON (LPR/LPD) PROTOCOL.......................4
2.1 jmJobSubmissionID Mapped to LPR/LPD..........................4
2.2 jmJobIndex Mapped to LPR/LPD.................................5
2.3 Other MIB Objects Mapped to LPR/LPD..........................5
2.4 The Attribute Group Mapped to LPD............................5
3.0 APPLETALK PROTOCOL...........................................6
3.1 jmJobSubmissionID Mapped to AppleTalk........................6
3.2 Other AppleTalk Mappings.....................................6
4.0 INTERNET PRINTING PROTOCOL (IPP).............................6
4.1 jmJobSubmissionID Mapped to IPP..............................7
4.2 jmJobIndex Mapped to IPP.....................................7
4.3 Other MIB Objects Mapped to IPP..............................8
4.4 The Attribute Group Mapped to IPP............................8
5.0 INTELLIGENT PRINTER DATA STREAM (IPDS)......................10
5.1 jmJobSubmissionId Mapped to IPDS............................10
5.2 The Attribute Group Mapped to IPDS..........................11
6.0 DOCUMENT PRINTING APPLICATION (DPA).........................11
6.1 jmJobSubmissionID Mapped to DPA.............................11
6.2 jmJobIndex Mapped to DPA....................................12
6.3 Other MIB Objects Mapped to DPA.............................12
6.4 The Attribute Group Mapped to DPA...........................13
Bergman Informational [Page 1]
RFC 2708 Job Submission Protocol Mapping November 1999
7.0 NOVELL DISTRIBUTED PRINT SERVICE (NDPS).....................14
7.1 jmJobSubmissionID Mapped to NDPS............................14
7.2 jmJobIndex Mapped to NDPS...................................14
7.3 Other MIB Objects Mapped to NDPS............................15
7.4 The Attribute Group Mapped to NDPS..........................15
8.0 PRINTER JOB LANGUAGE (PJL)..................................17
8.1 jmJobSubmissionID Mapped to PJL.............................17
8.2 jmJobIndex Mapped to PJL....................................18
8.3 Other MIB Objects Mapped to PJL.............................18
8.4 The Attribute Group Mapped to PJL...........................18
9.0 POSTSCRIPT..................................................18
9.1 jmJobSubmissionID Mapped to PostScript......................19
9.2 Other MIB Objects and Attributes Mapped to PostScript.......19
10.0 NETWARE PSERVER............................................19
10.1 jmJobSubmissionID Mapped to PServer........................19
10.2 jmJobIndex Mapped to PServer...............................19
10.3 Other MIB Objects Mapped to PJL............................20
10.4 The Attribute Group Mapped to PServer......................20
11.0 NETWARE NPRINTER or RPRINTER...............................20
12.0 SERVER MESSAGE BLOCK (SMB) PROTOCOL........................21
12.1 jmJobSubmissionID Mapped to SMB............................21
12.2 jmJobIndex Mapped to SMB...................................21
12.3 Other MIB objects Mapped to SMB............................21
13.0 TRANSPORT INDEPENDENT PRINTER/SYSTEM INTERFACE (TIP/SI)....22
13.1 jmJobSubmissionID Mapped to TIP/SI.........................22
13.2 jmJobIndex Mapped to TIP/SI................................22
13.3 Other MIB Objects Mapped to TIP/SI.........................22
13.4 The Attribute Group Mapped to TIP/SI.......................22
14.0 SECURITY CONSIDERATIONS....................................23
15.0 REFERENCES.................................................23
16.0 AUTHORS' ADDRESSES.........................................24
17.0 FULL COPYRIGHT STATEMENT...................................26
1.0 INTRODUCTION
The Job Monitoring MIB [JobMIB] is intended to be implemented in a
device or server that supports any job submission protocol. However,
the information available and the method of presentation varies
significantly by job submission protocol. A common method of mapping
job submission information to the Job Monitoring MIB is essential for
interoperability of Job MIB agents and monitoring applications. This
document defines recommended mappings for most popular job submission
protocols to ensure this compatibility.
Bergman Informational [Page 2]
RFC 2708 Job Submission Protocol Mapping November 1999
All mappings are unidirectional from the job submission protocol to
the MIB. It is assumed that support of the job submission protocol
in the printer implies that the reverse information flow is presently
defined and does not require interaction from the MIB. This mapping
is not defined in this document as it should be obvious.
This document refers to system configurations that are defined in the
Job Monitoring MIB [JobMIB]. For those readers that are familiar
with the configuration descriptions, a short summary appears here.
Please see the Job MIB document for further details.
Configuration 1: This is a simple peer-to-peer system which contains
only a client and a printer. The Job MIB agent is
resident in the printer.
Configuration 2: This system contains a client, server, and a
printer. The Jib MIB agent is resident in the
server.
Configuration 3: This system, as in configuration 2, contains a
client, server, and a printer. In this case the
Job MIB agent is implemented within the printer.
The most important object to be mapped is jmJobSubmissionID, since
this is a method for the user or client to determine the jmJobIndex
for a submitted job. Therefore, jmJobSubmissionID is specified for
all job submission protocols defined in this document. The remaining
objects mapped include only those items that have the equivalent
information presented to the printer by the job submission protocol.
While this document places a strong emphasis on jmJobSubmissionID
mapping to obtain jmJobIndex, the preferred method is through the use
of a bi-directional job submission protocol that returns the
equivalent value of jmJobIndex to the client, such as IPP. When a
bi-directional protocol that returns jmJobIndex is in use, the
jmJobSubmissionID object has no value to the client. When the
jmJobIndex cannot be returned, the use of a client defined
jmJobSubmissionID is preferred over an agent derived value. The
client defined version allows for retrieval of jmJobIndex using a
single SNMP Get operation, since jmJobSubmissionID is the index into
the jmJobIDTable. An agent derived value will require a search
through multiple entries in the jmJobIDTable.
The majority of the protocols mapped in this document are oriented
towards network job submission. However, the Job Monitoring MIB is
also intended to monitor print jobs received from other than network
ports, such as parallel and serial ports. Some of the job submission
protocols included that are used with non-networked ports are PJL,
Bergman Informational [Page 3]
RFC 2708 Job Submission Protocol Mapping November 1999
PostScript, and TIP/SI. In addition, the Job Monitoring MIB can be
used with print jobs that are internally generated, such as self test
pages. In this latter case, no mapping is required since all job
submission protocols are bypassed.
2.0 LINE PRINTER DAEMON (LPR/LPD) PROTOCOL
The LPR/LPD printing protocol [LPD] is used with BSD UNIX systems in
the client-server-printer configuration. Usage of the Job Monitoring
MIB with LPR/LPD will most likely conform to Configuration 3, where
the monitor application or the server uses SNMP to obtain job
information from the printer. The client communicates with the UNIX
server using the existing LPD protocol to obtain job information.
The LPR/LPD protocol is also used in the Windows environment to
implement peer-to-peer printing, as shown in configuration 1. In
this case, SNMP is used by the client and/or the monitor application
to obtain the job information.
One of the major problems of LPR/LPD is the large number of vendor
unique extensions currently used with the protocol and the resulting
compatibility issues between available implementations. To avoid
these issues, this mapping of LPR/LPD is restricted to the protocol
as defined by RFC 1179.
The LPR/LPD protocol transfers print job data and control information
in separate files, known as the Data File and Control File,
respectively. Most of the information concerning the print job is
contained in the Control File. In many LPD implementations, the
Control File is transferred following the Data File. Thus much of
the information concerning the job may not be available until the
completion of the data transmission.
2.1 jmJobSubmissionID Mapped to LPR/LPD
The LPR/LPD Receive Data File command contains a parameter which
defines the name of the data file. This name field is structured as
follows:
dfaXXX<host-name> or daXXXX<host-name>
Where XXX or XXXX is the numeric job number assigned by the network
entity submitting the print job to the printer. The recommended
mapping of this name field to jmJobSubmissionID is:
Bergman Informational [Page 4]
RFC 2708 Job Submission Protocol Mapping November 1999
octet 1: '9'
octets 2-40: Contains the <host-name> portion of the name field. If
the <host-name> portion is less than 40 octets, the
left-most character in the string shall appear in octet
position 2. Any unused portion of this field shall be
filled with spaces. Otherwise, only the last 39 bytes
shall be included.
octets 41-48: '00000XXX' or '0000XXXX', where XXX or XXXX is the
decimal (ASCII coded) representation of the LPR/LPD job
number.
2.2 jmJobIndex Mapped to LPR/LPD
The job index (jmJobIndex) is assigned by the SNMP job monitoring
agent and is independent of the XXX (or XXXX) index assigned by the
LPR/LPD client. This will allow the SNMP agent to track jobs
received from multiple sources.
2.3 Other MIB Objects Mapped to LPR/LPD
MIB Object | LPR/LPD Parameter
------------------------------+----------------------------------------
jmJobKOctetsPerCopyRequested | Number of bytes as defined in the Data
| File
jmJobOwner | Control file command code = P (User Id)
2.4 The Attribute Group Mapped to LPD
Other attributes that are applicable, but not defined in this section
such as attributes that map to a vendor unique extension, may also be
included.
MIB attribute | LPR/LPD information | Data type
----------------------+---------------------------------+--------------
jobName | Job Name (notes 1, 2) | Octet String
queueNameRequested | Queue name from the Data File | Octet String
fileName | Source File Name (notes 1, 3) | Octet String
Notes:
------
1. The information is optional in the Control File. The attribute
should be included if present in the Control File.
2. Control file command code = J. If this optional field is omitted
from the control file, then the agent returns the file name
(command code = N), if present.
3. Control file command code = N.
Bergman Informational [Page 5]
RFC 2708 Job Submission Protocol Mapping November 1999
3.0 APPLETALK PROTOCOL
AppleTalk was originally developed as a peer-to-peer network
protocol, as described in configuration 1, for use with Apple
Macintosh computers. Today, print spoolers are also available for
use with Macintosh computer networks that conform to configurations
2/3. In addition, printing with the AppleTalk protocol is supported
from both Windows NT servers and Novell servers also per
configurations 2/3.
The AppleTalk protocol provides very little information that can be
used with the Job Monitoring MIB. The Macintosh print drivers are
able to provide information concerning the user and document name but
imbed this information in the PDL, which is typically PostScript.
The preferred jmJobSubmissionID is constructed from the information
in the PostScript file, as defined in section 9.0.
3.1 jmJobSubmissionID Mapped to AppleTalk
An alternative jmJobSubmissionID may be constructed from the
Connection Identifier contained in the AppleTalk Printer Access
Protocol (PAP) header. Since the Connection Id is not readily
available in any of the defined AppleTalk implementations, this
approach may be of little utility.
octet 1: 'A'
octets 2-40: Contains the AppleTalk printer name, with the first
character of the name in octet 2. AppleTalk printer
names are a maximum of 31 characters. Any unused
portion of this field shall be filled with spaces.
octets 41-48: '00000XXX', where 'XXX' is the decimal (ASCII coded)
representation of the Connection Id.
3.2 Other AppleTalk Mappings
No other Job MIB objects or parameters can be derived from
information available in the AppleTalk headers
4.0 INTERNET PRINTING PROTOCOL (IPP)
The Internet Printing Protocol [IPP] supports printing using any one
of the three possible configurations. For configuration 2, the
mapping defined herein is performed on an agent within the server.
Otherwise, the mapping is performed on an agent within the printer.
Bergman Informational [Page 6]
RFC 2708 Job Submission Protocol Mapping November 1999
4.1 jmJobSubmissionID Mapped to IPP
IPP 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 IPP job-uri attribute as
follows:
octet 1: '4'
octets 2-40: Contains the IPP job-uri job description attribute
generated by the printer. (The job-uri is returned to
the client by IPP.) If the job-uri 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 the decimal (ASCII coded) representation of
the job-id job description attribute. Leading zeros
shall be inserted to fill the entire 8 octet field.
NOTE - Since IPP 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.
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