Internet Printing Protocol (IPP): Job and Printer Set Operations
RFC 3380

Network Working Group                                        T. Hastings
Request for Comments: 3380                             Xerox Corporation
Updates: 2910, 2911                                           R. Herriot
Category: Standards Track                                     Consultant
                                                               C. Kugler
                                                                H. Lewis
                                                         IBM Corporation
                                                          September 2002

                   Internet Printing Protocol (IPP):
                     Job and Printer Set Operations

Status of this Memo

   This document specifies an Internet standards track protocol for the
   Internet community, and requests discussion and suggestions for
   improvements.  Please refer to the current edition of the "Internet
   Official Protocol Standards" (STD 1) for the standardization state
   and status of this protocol.  Distribution of this memo is unlimited.

Copyright Notice

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

Abstract

   This document is an OPTIONAL extension to the Internet Printing
   Protocol (IPP/1.0 and IPP/1.1).  This document specifies 3 additional
   OPTIONAL operations for use with the Internet Printing Protocol/1.0
   (IPP) and IPP/1.1.  The end user, operator, and administrator Set-
   Job-Attributes and Set-Printer-Attributes operations are used to
   modify IPP Job objects and Printer objects, respectively.  The Get-
   Printer-Supported-Values administrative operation returns values that
   the IPP Printer will accept for setting its "xxx-supported"
   attributes.

Hastings, et. al.           Standards Track                     [Page 1]
RFC 3380          IPP: Job and Printer Set Operations     September 2002

Table of Contents

   1 Introduction......................................................4
   2 Terminology.......................................................5
   2.1 Conformance Terminology.........................................5
   2.2 Other terminology...............................................5
   3 Requirements and Use Cases........................................5
   4 Definition of the Set operations..................................6
   4.1 Set-Printer-Attributes Operation................................7
   4.1.1 Settable and READ-ONLY Printer Description attributes.........9
   4.1.2 Set-Printer-Attributes Request...............................10
   4.1.3 Set-Printer-Attributes Response..............................12
   4.2 Set-Job-Attributes Operation...................................13
   4.2.1 Settable and READ-ONLY Job Description attributes............16
   4.2.2 Set-Job-Attributes Request...................................17
   4.2.3 Set-Job-Attributes Response..................................18
   4.3 Get-Printer-Supported-Values Operation.........................19
   4.3.1 Definition of the usage of the 'admin-define' out-of-band
         attribute value..............................................20
   5 New Operation attributes.........................................22
   5.1 printer-message-from-operator (text(127))......................22
   5.2 job-message-from-operator (text(127))..........................23
   6 New Printer Description Attributes...............................24
   6.1 printer-settable-attributes-supported (1setOf type2 keyword)...24
   6.2 job-settable-attributes-supported (1setOf type2 keyword).......25
   6.3 document-format-varying-attributes (1setOf type2 keyword)......25
   6.4 printer-message-time (integer(MIN:MAX))........................25
   6.5 printer-message-date-time (dateTime)...........................26
   6.6 printer-xri-supported (1setOf collection)......................26
   6.7 xri-uri-scheme-supported (1setOf uriScheme)....................28
   6.8 xri-authentication-supported (1setOf type2 keyword)............29
   6.9 xri-security-supported (1setOf type2 keyword)..................29
   7 Additional status codes..........................................29
   7.1 client-error-attributes-not-settable (0x0413)..................29
   8 Additional out-of-band values....................................30
   8.1 'not-settable' out-of-band value...............................30
   8.1.1 Encoding of the 'not-settable' out-of-band attribute value...30
   8.2 'delete-attribute' out-of-band value...........................30
   8.2.1 Encoding of the 'delete-attribute' out-of-band value.........31
   8.3 'admin-define' out-of-band attribute value.....................31
   8.3.1 Encoding of the 'admin-define' out-of-band attribute value...32
   9 New Values for Existing Printer Description Attributes...........33