Upload
others
View
2
Download
0
Embed Size (px)
Citation preview
®The Printer Working Group
6 July 2016Working Draft
IPP System Service v1.0 (SYSTEM)
Status: Interim
Abstract: This document defines an IPP System Service binding of the PWG Semantic Model root System object and associated System Control Service that are defined in (PWG 5108.06) and the PWG Resource Service that is defined in (PWG 5108.03). This document defines IPP objects, operations, and attributes to support management of all configured Services, Subunits, and Resources on an Imaging System and monitoring of the current status of the Imaging System, Services, Subunits, and Resources. This document also defines IPP operations and attributes to support registration of an IPP System, through its IPP Proxy, with one or more Cloud Imaging Systems. This document is technically aligned with the abstract PWG Cloud Imaging Requirements and Model (PWG 5109.1) and concrete PWG IPP Shared Infrastructure Extensions (PWG 5100.18).
This document is a PWG Working Draft. For a definition of a "PWG Working Draft", see:
http://ftp.pwg.org/pub/pwg/general/pwg-process30.pdf
This document is available electronically at:
http://ftp.pwg.org/pub/pwg/ipp/wd/wd-ippsystem10-2016 0706 0623 .pdf
Copyright © 2014-2016 The Printer Working Group. All rights reserved.
12345678910
11
12
13
14151617181920212223
24
25
26
27
Working Draft – IPP System Service v1.0 (SYSTEM) 6 July 2016
Copyright © 2014-2016 The Printer Working Group. All rights reserved.
This document may be copied and furnished to others, and derivative works that comment on, or otherwise explain it or assist in its implementation may be prepared, copied, published and distributed, in whole or in part, without restriction of any kind, provided that the above copyright notice, this paragraph and the title of the Document as referenced below are included on all such copies and derivative works. However, this document itself may not be modified in any way, such as by removing the copyright notice or references to the IEEE-ISTO and the Printer Working Group, a program of the IEEE-ISTO.
Title: IPP System Service v1.0 (SYSTEM)
The IEEE-ISTO and the Printer Working Group DISCLAIM ANY AND ALL WARRANTIES, WHETHER EXPRESS OR IMPLIED INCLUDING (WITHOUT LIMITATION) ANY IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
The Printer Working Group, a program of the IEEE-ISTO, reserves the right to make changes to the document without further notice. The document may be updated, replaced or made obsolete by other documents at any time.
The IEEE-ISTO takes no position regarding the validity or scope of any intellectual property or other rights that might be claimed to pertain to the implementation or use of the technology described in this document or the extent to which any license under such rights might or might not be available; neither does it represent that it has made any effort to identify any such rights.
The IEEE-ISTO invites any interested party to bring to its attention any copyrights, patents, or patent applications, or other proprietary rights which may cover technology that may be required to implement the contents of this document. The IEEE-ISTO and its programs shall not be responsible for identifying patents for which a license may be required by a document and/or IEEE-ISTO Industry Group Standard or for conducting inquiries into the legal validity or scope of those patents that are brought to its attention. Inquiries may be submitted to the IEEE-ISTO by e-mail at: [email protected].
The Printer Working Group acknowledges that the IEEE-ISTO (acting itself or through its designees) is, and shall at all times, be the sole entity that may authorize the use of certification marks, trademarks, or other special designations to indicate compliance with these materials.
Use of this document is wholly voluntary. The existence of this document does not imply that there are no other ways to produce, test, measure, purchase, market, or provide other goods and services related to its scope.
Page 2 of 111 Copyright © 2014-2016 The Printer Working Group. All rights reserved.
12
28
29303132333435
36
373839
404142
4344454647
48495051525354
55565758
59606162
3
Working Draft – IPP System Service v1.0 (SYSTEM) 6 July 2016
About the IEEE-ISTO
The IEEE-ISTO is a not-for-profit corporation offering industry groups an innovative and flexible operational forum and support services. The IEEE-ISTO provides a forum not only to develop standards, but also to facilitate activities that support the implementation and acceptance of standards in the marketplace. The organization is affiliated with the IEEE (http://www.ieee.org/) and the IEEE Standards Association (http://standards.ieee.org/).
For additional information regarding the IEEE-ISTO and its industry programs visit:
http://www.ieee-isto.org
About the IEEE-ISTO PWG
The Printer Working Group (or PWG) is a Program of the IEEE Industry Standards and Technology Organization (ISTO) with member organizations including printer manufacturers, print server developers, operating system providers, network operating system providers, network connectivity vendors, and print management application developers. The group is chartered to make printers and the applications and operating systems supporting them work together better. All references to the PWG in this document implicitly mean “The Printer Working Group, a Program of the IEEE ISTO.” In order to meet this objective, the PWG will document the results of their work as open standards that define print related protocols, interfaces, procedures and conventions. Printer manufacturers and vendors of printer related software will benefit from the interoperability provided by voluntary conformance to these standards.
In general, a PWG standard is a specification that is stable, well understood, and is technically competent, has multiple, independent and interoperable implementations with substantial operational experience, and enjoys significant public support.
For additional information regarding the Printer Working Group visit:
http://www.pwg.org
Contact information:
The Printer Working Groupc/o The IEEE Industry Standards and Technology Organization445 Hoes LanePiscataway, NJ 08854USA
Page 3 of 111 Copyright © 2014-2016 The Printer Working Group. All rights reserved.
45
63
6465666768
69
70
71
7273747576777879808182
838485
86
87
88
899091929394
6
Working Draft – IPP System Service v1.0 (SYSTEM) 6 July 2016
About the Internet Printing Protocol Work Group
The Internet Printing Protocol (IPP) working group has developed a modern, full-featured network printing protocol, which is the industry standard. IPP allows a print client to query a printer for its supported capabilities, features, and parameters to allow the selection of an appropriate printer for each print job. IPP also provides job information prior to, during, and at the end of job processing.
For additional information regarding IPP visit:
http://www.pwg.org/ipp/
Implementers of this specification are encouraged to join the IPP mailing list in order to participate in any discussions of the specification. Suggested additions, changes, or clarification to this specification, should be sent to the IPP mailing list for consideration.
Page 4 of 111 Copyright © 2014-2016 The Printer Working Group. All rights reserved.
78
95
96979899100
101
102
103104105
9
Working Draft – IPP System Service v1.0 (SYSTEM) 6 July 2016
Table of Contents1. Introduction.....................................................................................................................11
1.1 Rationale for two IPP Protocol Endpoints.................................................................112. Terminology....................................................................................................................12
2.1 Conformance Terminology........................................................................................122.2 Protocol Role Terminology........................................................................................122.3 Printing Terminology.................................................................................................132.4 Abbreviations............................................................................................................16
3. Requirements for the IPP System Service.....................................................................163.1 Rationale for the IPP System Service.......................................................................163.2 Use Cases................................................................................................................17
3.2.1 Imaging System Service Enumeration...............................................................173.2.2 Imaging System Monitoring................................................................................173.2.3 Imaging System Management............................................................................183.2.4 Resource Management......................................................................................183.2.5 Bootstrap Client Access to Default Print Service................................................18
3.3 Exceptions................................................................................................................183.4 Out of Scope.............................................................................................................183.5 Design Requirements...............................................................................................18
4. IPP Object Model............................................................................................................204.1 System Object...........................................................................................................204.2 Subunit Object..........................................................................................................204.3 Printer Object............................................................................................................204.4 Job Object.................................................................................................................204.5 Document Object......................................................................................................204.6 Resource Object.......................................................................................................214.7 Subscription Object...................................................................................................21
5. IPP System and Resource Objects and Operations.......................................................225.1 System Attribute Group.............................................................................................225.2 System Description Attributes...................................................................................235.3 System Status Attributes...........................................................................................245.4 System Operations...................................................................................................255.5 Resource Attribute Group.........................................................................................275.6 Resource Description Attributes................................................................................285.7 Resource Status Attributes.......................................................................................285.8 Printer Description Attributes....................................................................................295.9 Printer Status Attributes............................................................................................30
6. IPP Operations...............................................................................................................306.1 Cancel-Resource......................................................................................................306.2 Create-Printer...........................................................................................................30
6.2.1 Create-Printer Request.......................................................................................326.2.2 Create-Printer Response....................................................................................33
6.3 Create-Resource.......................................................................................................346.3.1 Create-Resource Request..................................................................................356.3.2 Create-Resource Response...............................................................................36
6.4 Create-Resource-Subscriptions................................................................................37
Page 5 of 111 Copyright © 2014-2016 The Printer Working Group. All rights reserved.
1011
106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151
12
Working Draft – IPP System Service v1.0 (SYSTEM) 6 July 2016
6.5 Create-System-Subscriptions...................................................................................376.6 Delete-Printer............................................................................................................37
6.6.1 Delete-Printer Request.......................................................................................376.6.2 Delete-Printer Response....................................................................................37
6.7 Disable-All-Printers...................................................................................................386.7.1 Disable-All-Printers Request..............................................................................386.7.2 Disable-All-Printers Response............................................................................38
6.8 Enable-All-Printers....................................................................................................386.8.1 Enable-All-Printers Request...............................................................................396.8.2 Enable-All-Printers Response............................................................................39
6.9 Get-Printers...............................................................................................................396.9.1 Get-Printers Request..........................................................................................396.9.2 Get-Printers Response.......................................................................................41
6.10 Get-Printer-Attributes..............................................................................................416.10.1 Get-Printer-Attributes........................................................................................416.10.2 Get-Printer-Attributes Response......................................................................42
6.11 Get-Resources........................................................................................................426.12 Get-Resource-Attributes.........................................................................................426.13 Get-System-Attributes.............................................................................................426.14 Get-System-Supported-Values...............................................................................426.15 Install-Resource......................................................................................................436.16 Pause-All-Printers...................................................................................................43
6.16.1 Pause-All-Printers Request..............................................................................436.16.2 Pause-All-Printers Response...........................................................................43
6.17 Pause-All-Printers-After-Current-Job......................................................................436.18 Register-Output-Device..........................................................................................436.19 Restart-System.......................................................................................................446.20 Resume-All-Printers................................................................................................44
6.20.1 Resume-All-Printers Request...........................................................................446.20.2 Resume-All-Printers Response........................................................................44
6.21 Send-Resource-Data..............................................................................................456.22 Set-Resource-Attributes..........................................................................................456.23 Set-System-Attributes.............................................................................................456.24 Shutdown-All-Printers.............................................................................................45
6.24.1 Shutdown-All-Printers Request........................................................................456.24.2 Shutdown-All-Printers Response......................................................................46
6.25 Shutdown-One-Printer............................................................................................466.25.1 Shutdown-One-Printer Request.......................................................................466.25.2 Shutdown-One-Printer Response.....................................................................46
6.26 Startup-All-Printers..................................................................................................476.26.1 Startup-All-Printers Request.............................................................................476.26.2 Startup-All-Printers Response..........................................................................47
6.27 Startup-One-Printer.................................................................................................486.27.1 Startup-One-Printer Request............................................................................486.27.2 Startup-One-Printer Response.........................................................................49
7. IPP Attributes..................................................................................................................50
Page 6 of 111 Copyright © 2014-2016 The Printer Working Group. All rights reserved.
1314152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197
15
Working Draft – IPP System Service v1.0 (SYSTEM) 6 July 2016
7.1 System, Printer, and Resource Operation Attributes................................................507.1.1 printer-geo-location (uri).....................................................................................507.1.2 printer-location (text(127))..................................................................................507.1.3 printer-service-type (1setOf (type2 keyword))....................................................507.1.4 requesting-user-vcard (1setOf text(1023)).........................................................507.1.5 resource-category (type2 keyword)....................................................................507.1.6 resource-format (1setOf (mimeMediaType))......................................................507.1.7 resource-id (integer(1:MAX))..............................................................................517.1.8 resource-job-id (integer(1:MAX))........................................................................517.1.9 resource-k-octets (integer(0:MAX))....................................................................517.1.10 resource-printer-uri (uri)....................................................................................517.1.11 resource-state (type1 enum)............................................................................517.1.12 resource-type (type2 keyword).........................................................................517.1.13 system-uri (uri).................................................................................................527.1.14 which-printers (type2 keyword):........................................................................52
7.2 System Description Attributes...................................................................................527.2.1 Power States and Policies..................................................................................527.2.2 charset-configured (charset)...............................................................................567.2.3 charset-supported (1setOf charset)....................................................................577.2.4 ipp-versions-supported (1setOf type2 keyword).................................................577.2.5 natural-language-configured (naturalLanguage)................................................577.2.6 generated-natural-language-supported (1setOf naturalLanguage)....................577.2.7 operations-supported (1setOf type2 enum)........................................................577.2.8 power-calendar-policy-col (1setOf collection).....................................................577.2.9 power-event-policy-col (1setOf collection)..........................................................597.2.10 power-timeout-policy-col (1setOf collection).....................................................607.2.11 resource-settable-attributes-supported.............................................................627.2.12 system-current-time (dateTime).......................................................................627.2.13 system-default-printer-uri (uri | no-value)..........................................................627.2.14 system-device-id (text(1023))...........................................................................627.2.15 system-geo-location (uri | unknown).................................................................627.2.16 system-info (text(127))......................................................................................627.2.17 system-location (text(127))...............................................................................637.2.18 system-make-and-model (text(127))................................................................637.2.19 system-message-from-operator (text(127))......................................................637.2.20 system-name (name(127))...............................................................................637.2.21 system-owner-col (collection)...........................................................................637.2.22 system-settable-attributes-supported (1setOf type2 keyword).........................637.2.23 system-strings-languages-supported (1setOf naturalLanguage)......................647.2.24 system-strings-uri (uri | no-value).....................................................................647.2.25 system-xri-supported (1setOf collection)..........................................................64
7.3 System Status Attributes...........................................................................................657.3.1 power-log-col (1setOf collection)........................................................................657.3.2 power-state-capabilities-col (1setOf collection)..................................................667.3.3 power-state-counters-col (1setOf collection)......................................................667.3.4 power-state-monitor-col (collection)...................................................................67
Page 7 of 111 Copyright © 2014-2016 The Printer Working Group. All rights reserved.
1617198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243
18
Working Draft – IPP System Service v1.0 (SYSTEM) 6 July 2016
7.3.5 power-state-transitions-col (1setOf collection)...................................................697.3.6 system-config-change-date-time (dateTime)......................................................697.3.7 system-config-change-time (integer(0:MAX)).....................................................697.3.8 system-config-changes (integer(0:MAX))...........................................................697.3.9 system-configured-printers (1setOf collection)...................................................707.3.10 system-configured-resources (1setOf collection).............................................717.3.11 system-configured-subunits (1setOf collection)................................................727.3.12 system-serial-number (text(255)).....................................................................757.3.13 system-state (type1 enum)...............................................................................757.3.14 system-state-change-date-time (dateTime)......................................................767.3.15 system-state-change-time (integer(0:MAX)).....................................................767.3.16 system-state-message (1setOf (text(MAX)))....................................................767.3.17 system-state-reasons (1setOf type2 keyword)................................................767.3.18 system-totals (1setOf collection)......................................................................767.3.19 system-up-time (integer(1:MAX)).....................................................................767.3.20 system-uuid (uri(45))........................................................................................76
7.4 Printer Description Attributes....................................................................................767.4.1 printer-owner-col (collection)..............................................................................77
7.5 Printer Status Attributes............................................................................................777.5.1 printer-config-changes (integer(0:MAX))............................................................777.5.2 printer-service-type (type2 keyword)..................................................................77
7.6 Resource Description Attributes................................................................................787.6.1 resource-info (text(127)).....................................................................................787.6.2 resource-name (name(127))...............................................................................787.6.3 resource-owner-col (collection)..........................................................................78
7.7 Resource Status Attributes.......................................................................................797.7.1 date-time-at-canceled (dateTime)......................................................................797.7.2 date-time-at-creation (dateTime)........................................................................797.7.3 date-time-at-installed (dateTime)........................................................................797.7.4 resource-authenticator (1setOf collection)..........................................................797.7.5 resource-category (type2 keyword)....................................................................797.7.6 resource-data-uri (uri | no-value)).......................................................................807.7.7 resource-format (mimeMediaType)....................................................................807.7.8 resource-id (integer(1:MAX))..............................................................................807.7.9 resource-job-id (integer(1:MAX) | no-value).......................................................807.7.10 resource-k-octets (integer(0:MAX))..................................................................807.7.11 resource-printer-uri (uri | no-value)...................................................................807.7.12 resource-state (type1 enum)............................................................................807.7.13 resource-state-message (text(MAX))...............................................................817.7.14 resource-state-reasons (1setOf type2 keyword)..............................................817.7.15 resource-string-version (text(127))...................................................................817.7.16 resource-type (type2 keyword).........................................................................817.7.17 resource-uuid (uri(45))......................................................................................827.7.18 resource-version (octetString(16))....................................................................827.7.19 time-at-canceled (integer(MIN:MAX))...............................................................827.7.20 time-at-creation (integer(MIN:MAX))................................................................82
Page 8 of 111 Copyright © 2014-2016 The Printer Working Group. All rights reserved.
1920244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289
21
Working Draft – IPP System Service v1.0 (SYSTEM) 6 July 2016
7.7.21 time-at-installed (integer(MIN:MAX))................................................................838. Additional Semantics for Existing Operations.................................................................83
8.1 Cancel-Subscription, Get-Notifications, and Renew-Subscription: system-uri (uri) and resource-id (integer(1:MAX))..........................................................................................838.2 Get-Printer-Attributes: printer-resource-ids (1setOf integer(1:MAX))........................838.3 Create-Job, Get-Job-Attributes: job-resource-ids (1setOf integer(1:MAX))..............83
9. Additional Values for Existing Attributes.........................................................................839.1 notify-events (1setOf type2 keyword)........................................................................83
10. Conformance Requirements.........................................................................................8410.1 Conformance Requirements for Clients..................................................................8410.2 Conformance Requirements for Infrastructure Systems.........................................8410.3 Conformance Requirements for Systems...............................................................84
11. Internationalization Considerations...............................................................................8412. Security Considerations................................................................................................8513. IANA and PWG Considerations....................................................................................8514. References...................................................................................................................85
14.1 Normative References............................................................................................8514.2 Informative References...........................................................................................89
15. Authors' Addresses.......................................................................................................9016. Change History.............................................................................................................91
16.1 6 July 2016..............................................................................................................9116.2 23 June 2016..........................................................................................................9216.3 12 June 2016..........................................................................................................9316.4 9 May 2016.............................................................................................................9416.5 8 May 2016.............................................................................................................9416.6 25 April 2016...........................................................................................................9516.7 28 February 2016....................................................................................................9616.8 17 January 2016.....................................................................................................9716.9 6 December 2015...................................................................................................9816.10 2 November 2015.................................................................................................9816.11 18 October 2015...................................................................................................9816.12 20 September 2015..............................................................................................9916.13 31 August 2015.....................................................................................................9916.14 10 August 2015...................................................................................................10116.15 28 April 2015.......................................................................................................10116.16 15 March 2015....................................................................................................10216.17 2 November 2014...............................................................................................10416.18 24 August 2014...................................................................................................10516.19 11 August 2014...................................................................................................105
Page 9 of 111 Copyright © 2014-2016 The Printer Working Group. All rights reserved.
2223290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329
24
Working Draft – IPP System Service v1.0 (SYSTEM) 6 July 2016
List of TablesTable 1 – IPP System Description Attributes......................................................................23Table 2 – IPP System Status Attributes..............................................................................24Table 3 – IPP System Service Operations.........................................................................25Table 4 – IPP Resource Description Attributes..................................................................28Table 5 – IPP Resource Status Attributes..........................................................................28Table 6 – IPP Printer Description Attributes.......................................................................29Table 7 – IPP Printer Status Attributes...............................................................................30
Page 10 of 111 Copyright © 2014-2016 The Printer Working Group. All rights reserved.
2526
330331332333334335336337338
27
Working Draft – IPP System Service v1.0 (SYSTEM) 6 July 2016
1. IntroductionThis document defines an IPP System Service binding of the PWG Semantic Model root System object and associated System Control Service that are defined in [PWG 5108.06] and the PWG Resource Service that is defined in [PWG5108.03]. This document defines IPP objects, operations, and attributes to support management of all configured Services, Subunits, and Resources on an Imaging System and monitoring of the current status of the Imaging System, Services, Subunits, and Resources. This document also defines IPP operations and attributes to support registration of an IPP System, through its IPP Proxy, with one or more Cloud Imaging Systems. This document is technically aligned with the abstract PWG Cloud Imaging Requirements and Model [PWG5109.1] and concrete PWG IPP Shared Infrastructure Extensions [PWG5100.18].
1.1 Rationale for two IPP Protocol Endpoints
This specification defines the IPP System object that represents the IPP System Service. Because the IPP operations on and the IPP attributes defined for this System object and those defined for the Printer object in [RFC2911] are disjoint, an IPP Imaging System that conforms to this specification supports both an IPP System object and (via a response to the Get-Printer-Attributes operation) an IPP Printer object, each with a separate Protocol Endpoint – i.e., separate values of IPP URI [RFC3510] or IPPS URI [RFC7472].
For the convenience of existing IPP Clients, this specification also includes the original Get-Printer-Attributes operation defined in IPP/1.1 Model and Semantics [RFC2911] with an extension to automatically select the implementation-defined or site-defined “default” IPP Printer object.
Page 11 of 111 Copyright © 2014-2016 The Printer Working Group. All rights reserved.
2829
339
340341342343344345346347348349
350
351352353354355356
357358359360
361
30
Working Draft – IPP System Service v1.0 (SYSTEM) 6 July 2016
2. Terminology
2.1 Conformance Terminology
Capitalized terms, such as MUST, MUST NOT, RECOMMENDED, REQUIRED, SHOULD, SHOULD NOT, MAY, and OPTIONAL, have special meaning relating to conformance as defined in Key words for use in RFCs to Indicate Requirement Levels [RFC2119]. The term CONDITIONALLY REQUIRED is additionally defined for a conformance requirement that applies to a particular capability or feature.
2.2 Protocol Role Terminology
This document defines the following protocol roles in order to specify unambiguous conformance requirements:
Client: Initiator of outgoing IPP session requests and sender of outgoing IPP operation requests (Hypertext Transfer Protocol -- HTTP/1.1 [RFC7230] User Agent).
Endpoint: Any computing device that can be connected to a network. Such devices normally are associated with a particular link layer address before joining the network and potentially an IP address once on the network. This includes: laptops, desktops, servers, cell phones, or any device that may have an IP address (or any other network layer address) [RFC5209].
Infrastructure Printer: A Printer that represents a Logical Device associated with both a Client and Proxy [PWG5100.18]. For Cloud-based implementations, the Infrastructure Printer corresponds to a Cloud Imaging Service [PWG5019.1].
Infrastructure System: A System that represents an entire Imaging System and accepts incoming requests and connections from both Clients and Proxies and contains zero or more Infrastructure Printers [PWG5100.18]. For Cloud-based implementations, the Infrastructure System corresponds to a Cloud Imaging System [PWG5019.1].
Printer: Listener for incoming IPP session requests and receiver of incoming IPP operation requests (Hypertext Transfer Protocol -- HTTP/1.1 [RFC7230] Server) that exposes a Printer object and implements an Imaging Service.
Protocol Endpoint: An application interface, typically at the transport layer or session layer, that supports: a) initiating outgoing connection requests and operation requests; b) listening for incoming connection requests and operation requests; or c) both initiating and listening. Every Client, Printer, Proxy, and System supports at least one Protocol Endpoint.
Proxy: A Client that sends configuration and status information to and retrieves and manages Jobs and Documents from an Infrastructure Printer [PWG5100.18] on behalf of
Page 12 of 111 Copyright © 2014-2016 The Printer Working Group. All rights reserved.
3132
362
363
364365366367368
369
370371
372373
374375376377378
379380381
382383384385
386387388
389390391392393
394395
33
Working Draft – IPP System Service v1.0 (SYSTEM) 6 July 2016
one or more Output Devices and also communicates internally with an Infrastructure System to register the local System and get back Infrastructure Printer URIs.
System: Listener for incoming IPP session requests and receiver of incoming IPP operation requests (Hypertext Transfer Protocol -- HTTP/1.1 [RFC7230] Server) that exposes a System object and implements a System Service.
2.3 Printing Terminology
Normative definitions and semantics of printing terms are imported from IETF Design Goals for an Internet Printing Protocol [RFC2567], IETF Printer MIB v2 [RFC3805], IETF Printer Finishering MIB [RFC3806], IETF Internet Printing Protocol: Event Notifications and Subscriptions [RFC3995], PWG IPP FaxOut Service [PWG5100.15], PWG IPP Scan Service [PWG5100.17], PWG IPP Shared Infrastructure Extensions (INFRA) [PWG5100.18], PWG MFD Model and Common Semantics [PWG5108.01], PWG Network Resource Service Semantic Model and Service Interface [PWG5108.03], PWG System Object and System Control Service Semantics [PWG5108.06], and IETF Internet Printing Protocol/1.1: Model and Semantics [RFC2911].
Administrator: An End User who is also authorized to manage all aspects of an Output Device or Printer, including creating the printer instances and controlling the authorization of other End Users and Operators [RFC2567].
Delivery Method: The mechanism by which a System or Printer delivers an Event Notification [RFC3995].
Document: An object created and managed by an Imaging Service that contains the description, processing, and status information. A Document object may have attached data and is bound to a single Job object [RFC2911].
End User: A person or software process that is authorized to perform basic printing functions, including finding/locating a printer, creating a local instance of a printer, viewing printer status, viewing printer capabilities, submitting a print job, viewing print job status, and altering the attributes of a print job [RFC2567].
Event: An occurrence (either expected or unexpected) within a System of a change of state, condition, or configuration of a System, Printer, or Job. An Event occurs only at one instant in time and does not span the time the physical Event takes place [RFC3995].
Event Notification: The information about an Event that the Printer delivers when an Event occurs [RFC3995].
FaxOut Job: An object created and managed by a FaxOut Service that contains description, processing, and status information. The FaxOut Job also contains zero or more Document objects [PWG5100.15].
Page 13 of 111 Copyright © 2014-2016 The Printer Working Group. All rights reserved.
3435396397
398399400
401
402403404405406407408409410
411412413
414415
416417418
419420421422
423424425
426427
428429430
36
Working Draft – IPP System Service v1.0 (SYSTEM) 6 July 2016
FaxOut Service: An Imaging Service that accepts incoming IPP operation requests for creation of FaxOut Jobs and management of FaxOut Jobs and the service itself [PWG5100.15].
IPP Binding: The Internet Printing Protocol implementation of an abstract information model and associated set of abstract operations and data elements [RFC2911].
Imaging Device: A physical hardware entity (stand-alone) or logical software entity (hosted on a network server) that supports one or more Imaging Services (e.g., Print, Scan, FaxOut, etc.) [PWG5108.01].
Imaging Service: A software entity that supports document or image processing (e.g., Print, Scan, FaxOut, etc.) [PWG5108.01].
Imaging System: A logical or physical system supports a System object and a System Service for monitoring and management of one or more Imaging Services (e.g., Print, Scan, FaxOut, etc.) [PWG5108.01].
ith: Referring to a specific IPP ‘1setOf’ value - the first value, the second value, and so forth.
Job: An object created and managed by an Imaging Service that contains the description, processing, and status information. A Job object also contains zero or more Document objects [RFC2911].
Logical Device: a print server, software service, or gateway that processes jobs and either forwards or stores the processed job or uses one or more Physical Devices to render output [RFC2911].
Notification: Synonym for Event Notification [RFC3995].
Operator: An End User that also has special rights on the Output Device or Printer. The Operator typically monitors the status of the Printer and manages and controls the Jobs at the Output Device [RFC2567]. The Operator is allowed to query and control the Printer, Jobs, and Documents based on site policy.
Output Device: a single Logical or Physical Device [PWG5100.18].
Owner: The End User or Administrator who owns and manages (and typically created) a Job, Printer, Resource, Subscription, or System [PWG5108.06].
Physical Device: a hardware implementation of an endpoint device, e.g., a marking engine, a fax modem, etc [RFC2911].
Print Job: An object created and managed by a Print Service that contains description, processing, and status information. The Print Job also contains zero or more Document objects [RFC2911].
Page 14 of 111 Copyright © 2014-2016 The Printer Working Group. All rights reserved.
3738431432433
434435
436437438
439440
441442443
444445
446447448
449450451
452
453454455456
457
458459
460461
462463464
39
Working Draft – IPP System Service v1.0 (SYSTEM) 6 July 2016
Print Service: An Imaging Service that accepts incoming IPP operation requests for creation of Print Jobs and management of Print Jobs and the service itself [PWG5108.01].
Printer: Synonym for Imaging Service – an object that accepts incoming IPP operation requests for creation of Imaging Jobs and management of Imaging Jobs [RFC2911].
Resource: A data object (e.g., firmware, font, logo, etc.) that can be configured on an Imaging System for use by one or more Imaging Services and has a System, Printer, or Job scope [PWG5108.01].
Scan Job: An object created and managed by a Scan Service that contains description, processing, and status information. The Scan Job also contains zero or more Document objects [PWG5100.17].
Scan Service: An Imaging Service that accepts incoming IPP operation requests for creation of Scan Jobs and management of Scan Jobs and the service itself [PWG5100.17].
Spooling Service: An Imaging Service that stores all of a Job's document data so that it can be reprocessed as needed [PWG5100.18].
Streaming Service: An Imaging Service that stores some of a Job's document data as it is processed, output, and/or delivered [PWG5100.18].
Subscription: An object containing a set of attributes that indicate: the Notification Recipient (for Push Delivery Method only), the Delivery Method, the Subscribed Events that cause the Printer to deliver an Event Notification, and the information to include in an Event Notification [RFC3995].
Subunit: A hardware component (e.g., input tray or marker) or software component (e.g., input channel or interpreter) of an Imaging System [RFC3995] [PWG5108.01].
System Service: A software entity that supports management of all hardware and software components of an Imaging System and the System object defined in this specification [PWG5108.06].
Transform Job: An object created and managed by a Transform Service that contains description, processing, and status information. The Transform Job also contains zero or more Document objects [PWG5108.01].
Transform Service: An Imaging Service that accepts incoming IPP operation requests for creation of Transform Jobs and management of Transform Jobs and the service itself [PWG5108.01].
Page 15 of 111 Copyright © 2014-2016 The Printer Working Group. All rights reserved.
4041465466
467468
469470471
472473474
475476477
478479
480481
482483484485
486487
488489490
491492493
494495496
497
42
Working Draft – IPP System Service v1.0 (SYSTEM) 6 July 2016
2.4 Abbreviations
IANA: Internet Assigned Numbers Authority, http://www.iana.org/
IETF: Internet Engineering Task Force, http://www.ietf.org/
ISO: International Organization for Standardization, http://www.iso.org/
PWG: Printer Working Group, http://www.pwg.org/
3. Requirements for the IPP System Service
3.1 Rationale for the IPP System Service
Existing IPP specifications define the following features and functionality:
1) IPP Version 2.0, 2.1, and 2.2 [PWG5100.12] defines:(a) Three profiles that cover all previous IETF and PWG IPP specifications; (b) Existing Printer and Job operations and attributes required for each profile; (c) Standard IPP version numbers for each profile (2.0, 2.1, and 2.2); and (d) Specific interoperability requirements, such as HTTP/1.1 support with chunking and IPP collection attribute support;
2) IPP: Job and Printer Extensions – Set 3 [PWG5100.13] defines operations and attributes required for mobile printing and printing with generic drivers;
3) IPP Everywhere [PWG5100.14] defines an IPP extension to support network printing without vendor-specific driver software, including transport protocols, various discovery protocols, and standard document formats;
4) IPP FaxOut Service [PWG5100.15] defines an IPP extension to support the PWG Semantic Model FaxOut Service [PWG5108.05] over IPP;
5) IPP Scan Service [PWG5100.17] defines an IPP extension to support the PWG Semantic Model Scan Service [PWG5108.02] over IPP; and
6) IPP Shared Infrastructure Extensions [PWG5100.18] defines operations and attributes required to allow IPP Printers to interface with shared services based in the network infrastructure, i.e., software-defined networks, and/or through Cloud-based solutions to remotely obtain and process Jobs and Documents, and provide state and configuration changes to those services.
Existing PWG Semantic Model specifications define the following features and functionality:
Page 16 of 111 Copyright © 2014-2016 The Printer Working Group. All rights reserved.
4344
498
499
500
501
502
503
504
505
506507508509510511
512513
514515516
517518
519520
521522523524525
526
527528
45
Working Draft – IPP System Service v1.0 (SYSTEM) 6 July 2016
1) PWG MFD Model and Common Semantics [PWG5801.01] defines:(a) A PWG System object as the root of the PWG Semantic Model (including the associated XML Schema); and (b) An extension of the original PWG Semantic Model [PWG5105.1] (abstract print service) to support all of the typical multifunction services (Print, Scan, FaxOut, etc.);
2) PWG System object and System Control Service [PWG5108.05] defines the elements of the PWG System object and system operations of the PWG System Control Service;
3) PWG Resource Service [PWG5108.3] defines the elements of the PWG Resource object and resource operations of the PWG Resource Service; and
4) PWG Cloud Imaging Requirements and Model [PWG5109.1] defines an abstract model to support Imaging Services using the Cloud, based on the PWG Semantic Model. The IPP Binding for this abstract model is described in IPP Shared Infrastructure Extensions [PWG5100.18].
Therefore, this IPP System Service specification should define:
1) An IPP binding of the PWG System object;
2) An IPP binding of the PWG System Control Service to support management and monitoring of Imaging Systems and their configured Imaging Services; and
3) An IPP binding of the PWG Resource object and the PWG Resource Service.
3.2 Use Cases
3.2.1 Imaging System Service Enumeration
Jane wants to determine what services are available on an Imaging System and their capabilities. After Jane initiates service enumeration by using the IPP Client on her laptop to send a query to the Imaging System for the list of available services. After receiving the response from the Imaging System, the IPP Client sends further queries to each Imaging Service for its capabilities and configuration. Finally, the IPP Client displays the list of available Imaging Services and their capabilities.
3.2.2 Imaging System Monitoring
Jane wants to monitor the usage and supply levels of an Imaging System. She uses the IPP Client on her laptop to periodically query the input trays and the supply levels of relevant components on the Imaging System and the usage counters for each Imaging Service supported by the Imaging System.
Page 17 of 111 Copyright © 2014-2016 The Printer Working Group. All rights reserved.
4647529530531532533534
535536537
538539
540541542543
544
545
546
547548
549
550
551
552553554555556557
558
559560561562
48
Working Draft – IPP System Service v1.0 (SYSTEM) 6 July 2016
3.2.3 Imaging System Management
Jane needs to periodically pause and resume all of the services supported by an Imaging System in order to perform maintenance. She uses the IPP Client on her laptop to send pause and resume requests to the Imaging System as needed.
3.2.4 Resource Management
Jane wants to install a resource (firmware, font, logo, etc.) on an Imaging System in order to extend the functionality of the Imaging System. She uses the IPP Client on her laptop to create and upload the desired resource to the Imaging System.
3.2.5 Bootstrap Client Access to Default Print Service
Jane sees that there’s a new network printer installed in the hall near her office that has an IPv4 address written on the top (e.g., “10.1.2.3”). She wants to use that network printer, but doesn’t know how to find the specific URI of a running print service on that machine. She uses the IPP Client on her laptop to query the IPP System Service that listens on the standard IPP port (e.g., “ipp://10.1.2.3:631”) on that machine to find the default print service URI on that machine (e.g., “ipp://printer12.example.com/ipp/print”).
3.3 Exceptions
There are no exceptions to the use cases defined in section 3.2.
3.4 Out of Scope
The out-of-scope requirements for this IPP System Service specification are:
1) Configuration of Imaging Services directly through the System Service (e.g., defaults or assigned Subunits).
2) Pause/Resume or Enable/Disable of a sparse list of specific Imaging Services on an Imaging System (because the resulting operation status would be complicated and/or ambiguous).
3) Migration of Imaging Services and/or Jobs to another Imaging System.4) Support for any non-IPP Cloud Imaging System.
3.5 Design Requirements
The design requirements for this IPP System Service specification are:
1) Follow the naming conventions defined in IPP/1.1: Model and Semantics [RFC2911], including keyword value case (lower) and hyphenation requirements.
2) Define objects, attribute groups, attributes, and values to support the System object, Resource object, and System Service.
Page 18 of 111 Copyright © 2014-2016 The Printer Working Group. All rights reserved.
4950563
564565566
567
568569570
571
572573574575576577
578
579
580
581
582583584585586587588
589
590
591592593594
51
Working Draft – IPP System Service v1.0 (SYSTEM) 6 July 2016
3) Define operations to support the System Service and the use cases defined in section 3.2.
Page 19 of 111 Copyright © 2014-2016 The Printer Working Group. All rights reserved.
5253595596
597
54
Working Draft – IPP System Service v1.0 (SYSTEM) 6 July 2016
4. IPP Object ModelThis specification extends the original IPP Model defined in section 2 of IETF IPP/1.1 Model and Semantics [RFC2911] from the original print service scope to include all Imaging Services on a managed Imaging System.
4.1 System Object
This specification defines a root object called a “System” that is an IPP binding of the System object defined in PWG System object and System Control Service [PWG5108.06].
This object contains: (a) description (e.g., name and manufacturer) including summaries of configured services, subunits, and resources; and (b) overall status (e.g., state and counters).
4.2 Subunit Object
This specification defines a component object called a “Subunit” that is an IPP binding of the Subunit object defined in PWG MFD Model and Common Semantics [PWG5801.01] and is based on the Subunit (hardware or software component) defined in IETF Printer MIB v2 [RFC3805].
This object contains: (a) capabilities (e.g., max tray capacity); (b) description (e.g., name); and (c) component status (e.g., state and counters).
4.3 Printer Object
This specification extends the original IPP Printer object defined in IETF IPP/1.1 Model and Semantics [RFC2911] to represent any Imaging Service (print, scan, etc.), in order to reuse existing IPP Printer operations and attributes in the individual Imaging Services, but NOT directly in this specification.
4.4 Job Object
This specification extends the original IPP Job object defined in IETF IPP/1.1 Model and Semantics [RFC2911] to represent a Job on any Imaging Service (Print, Scan, etc.), in order to reuse existing IPP Job operations and attributes in the individual Imaging Services, but NOT directly in this specification.
4.5 Document Object
This specification extends the original IPP Document object defined in IETF IPP/1.1 Model and Semantics [RFC2911] to represent a Document contained in a Job on any Imaging
Page 20 of 111 Copyright © 2014-2016 The Printer Working Group. All rights reserved.
5556
598
599600601
602
603604
605606607
608
609610611612
613614
615
616617618619
620
621622623624
625
626627
57
Working Draft – IPP System Service v1.0 (SYSTEM) 6 July 2016
Service (Print, Scan, etc.), in order to reuse existing IPP Document operations and attributes in the individual Imaging Services, but NOT directly in this specification.
4.6 Resource Object
This specification extends the original Resource object defined in PWG Network Resource Service [PWG5108.03), in order to incorporate Resource operations directly into the IPP System Service. Resources are managed by the System and each Resource has a system-wide unique status attribute “resource-id”. Resource persistence is determined directly by the System: (a) System scope Resources persist for the life of the System; (b) Printer (service) scope Resources persist for the life of the Printer; (c) Job scope Resources persist for the life of the Job document data. Activation (for use) of Resources (e.g., firmware, software, fonts, etc.) is supported via the Install-Resource operation. Resources do not have leases and expiration times (as they formerly did in [PWG5108.03]).
4.7 Subscription Object
This specification extends the original IPP Subscription object defined in IPP Event Notifications and Subscriptions [RFC3995] to allow subscriptions to the IPP System object for event notifications.
Page 21 of 111 Copyright © 2014-2016 The Printer Working Group. All rights reserved.
5859628629
630
631632633634635636637638639640
641
642643644
60
Working Draft – IPP System Service v1.0 (SYSTEM) 6 July 2016
5. IPP System and Resource Objects and OperationsThis specification combines and maps the PWG SM System and PWG System Control Service objects [PWG5801.01] into the IPP System object, which is the target of all IPP system-level and resource-level operations. This is consistent with Print Service operations targeted at original IPP Printer object.
This specification maps the PWG SM Resource object [PWG5108.03] into the IPP Resource object and defines a set of resource-level operations.
This specification maps a summary of PWG SM SystemConfiguration group into the IPP “system-configured-subunits” attribute defined in section 5.4 System Status.
Note: All tables in this section list only top-level attributes. Collection member attributes are not listed here and are described in detail in section 7 IPP Attributes below their enclosing collection attributes.
5.1 System Attribute Group
This document defines the system-attributes-tag (0x0A) for attribute groups.
Page 22 of 111 Copyright © 2014-2016 The Printer Working Group. All rights reserved.
6162
645
646647648649
650651
652653
654655656
657
658659
63
Working Draft – IPP System Service v1.0 (SYSTEM) 6 July 2016
5.2 System Description Attributes
The READ-WRITE attributes in the IPP System Description group are listed in Table 1.
Table 1 – IPP System Description Attributes
Conformance IPP Attribute Name SM Element Name ReferenceREQUIRED charset-configured CharsetConfigured[1] [PWG5108.06]REQUIRED charset-supported CharsetSupported[1] [PWG5108.06]REQUIRED generated-natural-language-
supportedNaturalLanguageSupported[1] [PWG5108.06]
REQUIRED ipp-versions-supported VersionsSupported[1] [PWG5108.06]REQUIRED natural-language-configured NaturalLanguageConfigured[1] [PWG5108.06]REQUIRED operations-supported OperationsSupported[1] [PWG5108.06]OPTIONAL power-calendar-policy-col PowerCalendar [PWG5108.06]OPTIONAL power-event-policy-col PowerEvent [PWG5108.06]RECOMMENDED power-timeout-policy-col PowerTimeout[3] [PWG5108.06]REQUIRED resource-settable-attributes-
supported<none>[7] <none>
REQUIRED system-current-time CurrentTime[2] [PWG5108.06]REQUIRED system-default-printer-uri <none>[5] <none>REQUIRED system-device-id DeviceId[2] [PWG5108.06]REQUIRED system-geo-location SystemGeoLocation[2] [PWG5108.06]REQUIRED system-info SystemInfo[2] [PWG5108.06]REQUIRED system-location SystemLocation[2] [PWG5108.06]REQUIRED system-make-and-model MakeAndModel[2] [PWG5108.06]OPTIONAL system-message-from-operator MessageFromOperator [PWG5108.06]REQUIRED system-name SystemName[2] [PWG5108.06]REQUIRED system-owner-col OwnerUri, OwnerVCard[4] [PWG5108.06]REQUIRED system-settable-attributes-
supported<none>[6] <none>
REQUIRED system-xri-supported XriSupported [PWG5108.06]
Notes:
1) REQUIRED for a Printer per IETF IPP/1.1 Model and Semantics [RFC2911].
2) REQUIRED for a Printer per PWG IPP Everywhere [PWG5100.14].
3) REQUIRED or RECOMMENDED for a System per PWG Power Management Model [PWG5106.4].
4) REQUIRED for all Systems since they MUST support the Set-System-Attributes operation – also “owner-uri” and “owner-vcard” MUST be updated simultaneously if specified in a Set-System-Attributes operation (to preserve consistency).
5) REQUIRED for a System to support the Get-Printer-Attributes operation which uses the implementation-defined or administratively-configured “default” Printer object as a target.
Page 23 of 111 Copyright © 2014-2016 The Printer Working Group. All rights reserved.
6465
660
661
662
663
664
665
666667
668669670
671672673
66
Working Draft – IPP System Service v1.0 (SYSTEM) 6 July 2016
6) REQUIRED for System support of the REQUIRED Set-System-Attributes operation and semantically analogous to the “printer-settable-attributes-supported” Printer Description attribute defined in Internet Printing Protocol (IPP): Job and Printer Set Operations [RFC3380].
7) REQUIRED for System support of the REQUIRED Set-Resource-Attributes operation and semantically analogous to the “printer-settable-attributes-supported” Printer Description attribute defined in Internet Printing Protocol (IPP): Job and Printer Set Operations [RFC3380].
5.3 System Status Attributes
The READ-ONLY attributes in the IPP System Status group are listed in Table 2. These attributes are inherently READ-ONLY and can only be modified indirectly as a side effect of one or more IPP System Service operations, but NOT by a Set-System-Attributes operation.
Table 2 – IPP System Status Attributes
Conformance IPP Attribute Name SM Element Name ReferenceRECOMMENDED power-general-col PowerGeneral[3] [PWG5108.06]RECOMMENDED power-log-col PowerLog[3] [PWG5108.06]OPTIONAL power-meters-col PowerMeters [PWG5108.06]RECOMMENDED power-monitor-col PowerMonitor[3] [PWG5108.06]OPTIONAL power-state-capabilities-col PowerSupport [PWG5108.06]OPTIONAL power-state-counters-col PowerCounters [PWG5108.06]RECOMMENDED power-state-monitor-col PowerMonitor[3] [PWG5108.06]OPTIONAL power-state-transitions-col PowerTransition [PWG5108.06]REQUIRED system-config-change-date-
time<none>[8] <none>
REQUIRED system-config-change-time <none>[8] <none>REQUIRED system-config-changes SystemConfigChangeNumber[5] [PWG5108.06]REQUIRED system-configured-printers ConfiguredServices [PWG5108.06]REQUIRED system-configured-resources ConfiguredResources [PWG5108.06]REQUIRED system-configured-subunits SystemConfiguration[4] [PWG5108.06]OPTIONAL system-serial-number SerialNumber[5] [PWG5108.06]REQUIRED system-state State[1] [PWG5108.06]REQUIRED system-state-change-date-
time<none>[8] <none>
REQUIRED system-state-change-time <none>[8] <none>REQUIRED system-state-message StateMessages[2] [PWG5108.06]REQUIRED system-state-reasons StateReasons[2] [PWG5108.06]RECOMMENDED system-strings-languages-
supported<none>[9] <none>
RECOMMENDED system-strings-uri <none>[9] <none>RECOMMENDED system-totals SystemTotals[6] [PWG5108.06]REQUIRED system-up-time UpTime[2] [PWG5108.06]REQUIRED system-uuid ServiceUuid[2] [7] [PWG5108.01]
Notes:
Page 24 of 111 Copyright © 2014-2016 The Printer Working Group. All rights reserved.
6768674675676677
678679680681
682
683684685686
687
688
69
Working Draft – IPP System Service v1.0 (SYSTEM) 6 July 2016
1) REQUIRED for a Printer per IETF IPP/1.1 Model and Semantics [RFC2911].
2) REQUIRED for a Printer per PWG IPP Everywhere [PWG5100.14].
[3)] REQUIRED or RECOMMENDED for a System per PWG Power Management Model [PWG5106.4]. – Power General, Meters, and Monitor groups have been combined into the “power-state-monitor-col” System attribute.
3)[4)] Summary of SystemConfiguration group (subunits) – similar to ConfiguredServices in [PWG5108.06].
4)[5)] REQUIRED for a Printer per IETF Printer MIB v2 [RFC3805].
5)[6)] REQUIRED for a System per PWG Imaging System Counters [PWG5106.1].
6)[7)] The System object “system-uuid” attribute identifies the System Serviceand is semantically analogous to the Printer object “printer-uuid” defined in IPP Job and Printer Extensions – Set 3 (JPS3) [PWG5100.13] that identifies a specific Imaging Service (e.g., Print, Scan, FaxOut, etc.).
7)[8)] The System object “system-config-change-[date-time|time]” and “system-state-change-[date-time|time] attributes are necessary to support System event notifications per IPP: Events Notifications and Subscriptions [RFC3995] and are semantically analogous to the Printer object “printer-config-change-[date-time|time]” attributes defined in [PWG5100.13] and “printer-state-change-[date-time|time]” attributes defined in [RFC3995].
8)[9)] The System object “system-strings-languages-supported” and “system-strings-uri” attributes are necessary to support Client-side localizations and are semantically analogous to the Printer object “printer-strings-languages-supported” and “printer-strings-uri” attributes defined in IPP Job and Printer Extensions – Set 3 (JPS3) [PWG5100.13].
5.4 System Operations
The operations for an IPP System Service conforming to this specification are listed in Table 3.
Table 3 – IPP System Service Operations
Code IPP Operation Name SM Operation Name Reference0x00nn Cancel-Resource DeleteResource [PWG5108.03]0x00nn Cancel-
Subscription<none>[8] [RFC3995]<none>
0x00nn Create-Printer <none>[5] [ISO10175-3] <none>
0x00nn Create-Resource StoreResource[3] [PWG5108.03]0x00nn Create-Resource-
Subscriptions<none>[8] [RFC3995]<none>
Page 25 of 111 Copyright © 2014-2016 The Printer Working Group. All rights reserved.
7071689
690
691692693
694695
696
697
698699700701
702703704705706707
708709710711712
713
714715
716
72
Working Draft – IPP System Service v1.0 (SYSTEM) 6 July 2016
0x00nn Create-System- Subscriptions
<none>[8] [RFC3995]<none>
0x00nn Delete-Printer DeleteService [PWG5108.06]0x00nn Disable-All-Printers DisableAllServices[2] [PWG5108.06]0x00nn Enable-All-Printers EnableAllServices[2] [PWG5108.06]0x00nn Get-Notifications <none>[8] [RFC3995]<none>0x00nn Get-Printers ListAllServices [PWG5108.06]0x00nn Get-Printer-Attributes GetServiceElements[4] [PWG5108.06]0x00nn Get-Resources ListResources [PWG5108.03]0x00nn Get-Resource-Attributes GetResourceElements [PWG5108.03]0x00nn Get-Subscriptions <none>[8] [RFC3995]<none>0x00nn Get-Subscription-Attributes <none>[8] [RFC3995]<none>0x00nn Get-System-Attributes GetSystemElements [PWG5108.06]0x00nn Get-System-Supported-
Values<none>[7] <none>
0x00nn Install-Resource <none> <none>0x00nn Pause-All-Printers PauseAllServices [PWG5108.06]0x00nn Pause-All-Printers-After-
Current-JobPauseAllServices AfterCurrentJob[1]
[PWG5108.06]
0x00nn Register-Output-Device <none>[6] [PWG5109.1]<none>
0x00nn Renew-Subscription <none>[8] [RFC3995]<none>0x00nn Restart-System <none>[9] <none>0x00nn Resume-All-Printers ResumeAllServices [PWG5108.06]0x00nn Send-Resource-Data StoreResource[3] [PWG5108.03]<none> Set-Resource-Attributes SetResourceElements [PWG5108.03]<none> Set-System-Attributes SetSystemElements [PWG5108.06]0x00nn Shutdown-All-Printers ShutdownAllServices [PWG5108.06]<none> Shutdown-One-Printer ShutdownService [PWG5108.06]0x00nn Startup-All-Printers StartupAllServices [PWG5108.06]<none> Startup-One-Printer StartupService [PWG5108.06]
Notes:
1) Pause-All-Printers-After-Current-Job is a useful operation for graceful stopping of all Printers (Imaging Services) on an Imaging System, but it can be an arbitrarily long duration operation.
2) [Enable/Disable]-Printer and [Pause/Resume]-Printer are intentionally left out of this specification – they should be directed to the specific Imaging Service that is enumerated in the “system-configured-printers” attribute defined in section 5.x above.
3) Create-Resource and Send-Resource-Data are intentionally decomposed from the original ambigously scoped StoreResource operation specified in PWG Resource Service [PWG5108.03]. Create-Resource is semantically equivalent to Create (for a Resource object) defined in ISO Document Printing Application (DPA) Part 3: Management Abstract Service Definition and Procedures [ISO10175-3] where a newly created Resource object has the special initial state of ‘unknown’ (which is NOT defined or used in this specification).
Page 26 of 111 Copyright © 2014-2016 The Printer Working Group. All rights reserved.
7374
717
718719720
721722723724
725726727728729730731
75
Working Draft – IPP System Service v1.0 (SYSTEM) 6 July 2016
4) Install-Resource is to activate (for use) firmware, software, fonts, etc. after Create-Resource and Send-Resource-Data.
5) Create-Printer is semantically equivalent to Create (for a Printer object) defined in ISO Document Printing Application (DPA) Part 3: Management Abstract Service Definition and Procedures [ISO10175-3] (where a newly created Printer object had the special initial state of ‘unknown’, which is NOT defined or used in this specification).
6) Register-Output-Device is semantically equivalent to Register-System defined in PWG Cloud Imaging Model [PWG5109.1] with the difference that the System itself is not registered, but rather the associated Output Devices are registered.
7) Get-System-Supported-Values is semantically equivalent to Get-Printer-Supported-Values in IPP: Job and Printer Set Operations [RFC3380] and is necessary for support of the REQUIRED Set-System-Attributes operation.
8) REQUIRED for a System and/or Resource and analogous to the operations defined in IPP: Event Notifications and Subscriptions [RFC3995].
9) REQUIRED for a System and analogous to the Restart-Printer operation defined in IPP: Job and Printer Administrative Operations [RFC3998].
5.5 Resource Attribute Group
This document defines the resource-attributes-tag (0x08) for attribute groups.
Page 27 of 111 Copyright © 2014-2016 The Printer Working Group. All rights reserved.
7677732733
734735736737738
739740741
742743744
745746
747748
749
750751
78
Working Draft – IPP System Service v1.0 (SYSTEM) 6 July 2016
5.6 Resource Description Attributes
The READ-WRITE attributes in the IPP Resource Description group are listed in Table 4.
Table 4 – IPP Resource Description Attributes
Conformance IPP Attribute Name SM Element Name ReferenceREQUIRED resource-info ResourceInfo [PWG5108.03]REQUIRED resource-name ResourceName [PWG5108.03]REQUIRED resource-owner-col OwnerUri, OwnerVCard[4] [PWG5108.06]REQUIRED resource-string-version FirmwareStringVersion[1] [PWG5110.1]REQUIRED resource-version FirmwareVersion[1] [PWG5110.1]
Notes:
[1)] REQUIRED for a Resource by analogy to PWG Hardcopy Device Health Assessment Attributes [PWG5110.1].
Page 28 of 111 Copyright © 2014-2016 The Printer Working Group. All rights reserved.
7980
752
753
754
755
756757758
81
Working Draft – IPP System Service v1.0 (SYSTEM) 6 July 2016
[5.7] Resource Status Attributes
The READ-ONLY attributes in the IPP Resource Status group are listed in Table 5. These attributes are inherently READ-ONLY and can only be modified indirectly as a side effect of one or more IPP System Service operations, but NOT by a Set-Resource-Attributes operation.
Table 5 – IPP Resource Status Attributes
Conformance IPP Attribute Name SM Element Name ReferenceREQUIRED date-time-at-canceled DateTimeOfExpiration[1] [PWG5108.03]REQUIRED date-time-at-creation DateTimeAtCreation[1] [PWG5108.03]REQUIRED date-time-at-installed <none> <none>REQUIRED resource-authenticator <none>[7] <none>REQUIRED resource-category ResourceCategory [PWG5108.03]REQUIRED resource-data-uri <none> <none>REQUIRED resource-format ResourceFormat [PWG5108.03]REQUIRED resource-id ResourceId[4] [PWG5108.03]REQUIRED resource-job-id <none>[2][5] [RFC2911]
<none>REQUIRED resource-k-octets <none>[2][8] [RFC2911]
<none>REQUIRED resource-owner-col OwnerUri, OwnerVCard[9] [PWG5108.06]REQUIRED resource-printer-uri <none>[2][6] [RFC2911]
<none>REQUIRED resource-state <none>[2] [RFC2911]
<none>REQUIRED resource-state-reasons <none>[2] [RFC2911]
<none>REQUIRED resource-string-version XxxStringVersion[10] [PWG5110.1]REQUIRED resource-type ResourceType [PWG5108.03]REQUIRED resource-uuid <none>[3] [PWG5100.13]REQUIRED resource-version XxxVersion[10] [PWG5110.1]REQUIRED time-at-canceled <none>[2] [RFC2911]
<none>REQUIRED time-at-creation <none>[2] [RFC2911]
<none>REQUIRED time-at-installed <none> <none>
Notes:
1) REQUIRED for a Resource by analogy to PWG Network Resource Service Semantic Model and Service Interface [PWG5108.03].
2) REQUIRED for a Resource by analogy to a Job in IETF IPP/1.1 Model and Semantics [RFC2911].
3) REQUIRED for a Resource by analogy to a Job in PWG IPP: Job and Printer Extensions – Set 3 (JPS3) [PWG5100.13].
Page 29 of 111 Copyright © 2014-2016 The Printer Working Group. All rights reserved.
8283
759
760761762763
764
765
766767
768769
770771
84
Working Draft – IPP System Service v1.0 (SYSTEM) 6 July 2016
4) REQUIRED for a Resource by analogy to a Job in IETF IPP/1.1 Model and Semantics [RFC2911]. See section 7.6 of this specification for details of the “resource-id” attribute which MUST be monotonically increasing (as is “job-id”) to avoid re-use of a “resource-id” values and resulting ambiguity in log files.
5) REQUIRED for a Resource that is Job-scoped.
6) REQUIRED for a Resource that is Printer-scoped.
7) REQUIRED for a Resource to allow for verification of the validity and source of Resource data after a Send-Resource-Data operation. See section 7.6 of this specification for details of the “resource-authenticator” attribute.
8) REQUIRED for a Resource by analogy to a “job-k-octets” in a Job in IETF IPP/1.1 Model and Semantics [RFC2911].
9) REQUIRED for a Resource by analogy to “system-owner” in System.
10)REQUIRED for a Resource by analogy to the functionally equivalent [Firmware|ResidentApplication|UserApplication]StringVersion and [Firmware|ResidentApplication|UserApplication]Version elements defined in PWG Hardcopy Device Health Assessment Attributes [PWG5110.1] and PWG Hardcopy Device Health Assessment Trusted Network Connect Binding [PWG5110.4].
5.7[5.8] Printer Description Attributes
The additional READ-WRITE attributes in the IPP Printer Description group are listed in Table 6.
Table 6 – IPP Printer Description Attributes
Conformance IPP Attribute Name SM Element Name ReferenceREQUIRED printer-owner-col OwnerUri, OwnerVCard[1] [PWG5108.06]
Notes:
1) REQUIRED for all Systems since they MUST support the Set-Printer-Attributes operation – also “owner-uri” and “owner-vcard” MUST be updated simultaneously if specified in a Set-Printer-Attributes operation (to preserve consistency).
5.8 Printer Status Attributes
The additional READ-ONLY attributes in the IPP Printer Status group are listed in Table 7 – IPP Printer Status Attributes.
Page 30 of 111 Copyright © 2014-2016 The Printer Working Group. All rights reserved.
8586772773774775
776
777
778779780
781782
783
784785786787788
789
790791
792
793794
795796797798
799
800801
87
Working Draft – IPP System Service v1.0 (SYSTEM) 6 July 2016
Table 7 – IPP Printer Status Attributes
Conformance IPP Attribute Name SM Element Name ReferenceREQUIRED printer-config-changes <none>[1] <none>REQUIRED printer-service-type <none>[2] <none>
Notes:
1) REQUIRED for all Printers and semantically equivalent to “prtGeneralConfigChanges” in IETF Printer MIB v2 [RFC3805].
2) REQUIRED for all Printers and semantically equivalent to the ServiceType element defined in [PWG5108.01].
6. IPP OperationsNote: All IPP System Service operation requests and responses use standard operation parameters as defined in [RFC2911] and encoded in [RFC2910].
6.1 Cancel-Resource
[rename of DeleteResource – change resource-state (for history) – also delete any associated Resource data?]
6.2 Create-Printer
- Drop printer-state and printer-is-accepting-jobs
Initial state is stopped, "shutdown" reason⁃
Initial printer-is-accepting-jobs is false.⁃
Requires Startup-Printer call to bring the service up, followedby Enable-Printer to set ⁃printer-is-accepting-jobs to true and Resume-Printer to set “printer-state” to ‘idle’ and remove ‘pause’ from “printer-state-reasons”.
How to provide resources?⁃
Create resource in system and reference them (resource-data-uri)⁃
PUT them after creating the service⁃
How to associate with Subunits?⁃
Could use list of Subunit types and IDs⁃
Semantic Model does not go into great detail⁃
Page 31 of 111 Copyright © 2014-2016 The Printer Working Group. All rights reserved.
8889802
803804
805806
807808
809
810811
812
813814
815
816
817
818
819820821
822
823
824
825
826
827
90
Working Draft – IPP System Service v1.0 (SYSTEM) 6 July 2016
One of the envisioned uses is to create "copies" of a service with restricted capabilities, ⁃e.g. a service for guests that only allowed B&W printing
Default (modulo extensions) is to create a Printer that is associated with all of the ⁃subunits applicable to the printer service-type
Extensions for Printers:⁃
system-uri-supported (1setOf uri) Printer Description attribute pointing to System service⁃
Get-Resources, Create-Resource, Send-Resource-Data, Cancel-Resource using printer-⁃uri
Create-Job with resource-attributes-tag group, a la subscriptions⁃
Response includes resource IDs⁃
Upload resource with Send-Resource-Data operation or reference existing resource-id to⁃ do a fast copy whose life is limited to the job
No Cancel-Resource for jobs - just cancel the job to do it⁃
Send-Resource-Data before Send-Document/URI⁃
job-resource-ids (1setOf integer(1:MAX)) Job Status attribute that lists the resource IDs ⁃associated with a Job.
Job resources persist with the Job/Document data⁃
This REQUIRED operation allows a Client to create a new Printer object (i.e., Job processing service) on the target System object. This operation is semantically equivalent to the Create operation for a Printer object defined in ISO “Document Printing Application (DPA) Part 3: Management Abstract Service Definition and Procedures” [ISO10175-3] (where a newly created Printer object had the special initial state of ‘unknown’, which is NOT defined or used in this specification). This operation is semantically analogous to the Create-Job operation defined in [RFC2911]. This operation does not change the “system-state” of the System itself.
A new Printer object will be created and initialized with the “printer-state” set to ‘stopped’ (i.e., no Jobs can be processed and intervention is required), “printer-is-accepting-jobs” set to ‘false’ (i.e., no incoming Jobs accepted), and the ‘paused’ value added to “printer-state-reasons” (i.e., no Job processing output allowed). The Client can then send one or more Set-Printer-Attributes operations to modify the configuration of the Printer, followed by Resume-Printer (i.e., remove ‘paused’ from “printer-state-reasons” and change “printer-state” to ‘idle’ ) and Enable-Printer (i.e., change “printer-is-accepting-jobs” to ‘true’) to change the “printer-state” to ‘idle’ (unless there is another reason for the Printer to stay in the ‘stopped’ state).
Page 32 of 111 Copyright © 2014-2016 The Printer Working Group. All rights reserved.
9192828829
830831
832
833
834835
836
837
838839
840
841
842843
844
845846847848849850851852
853854855856857858859860861
93
Working Draft – IPP System Service v1.0 (SYSTEM) 6 July 2016
Note: When the first Print Service is created on a System, the System MUST set the value of “system-default-printer-uri” to reference that Print Service.
Note: Printer-scope Resource objects MUST be created after the related Create-Printer operation, so that “resource-printer-uri” can be correctly specified. Printer-scope Subscription objects MUST be created after the related Create-Printer operation, so that “notify-printer-uri” can be correctly specified. Note: Appropriate Subunits are automatically associated with a new Printer object based on “printer-service-type”, inherent System capabilities, (out-of-band) System policies. Subunits are also associated by configured service capabilities (e.g., “sides-supported” and duplexer, “finishings-supported” and finishers, “print-color-mode-supported” and colorants, etc. – association by intent and not by explicit identification/listing of Subunits.
6.2.1 Create-Printer Request
The Client submits a Create-Printer operation request to a System object. The following groups of attributes are part of a Create-Printer request.
Group 1: Operation Attributes
"attributes-charset" (charset) and "attributes-natural-language" (naturalLanguage):
The Client MUST supply and the System MUST support both of these attributes.
“system-uri” (uri):
The Client MUST supply and the System MUST support the “system-uri” operation attribute which is the target System for the operation.
“printer-uri” (uri):
The Client MUST supply and the System MUST support the “printer-uri” operation attribute which is the target Printer for the operation.
"requesting-user-name" (name(MAX)) and "requesting-user-uri" (uri) and“requesting-user-vcard” (1setOf text(1023)):
The Client SHOULD supply and the System MUST support all three both of these attributes.
“printer-service-type” (type2 keyword) [PWG5108.06]:
Page 33 of 111 Copyright © 2014-2016 The Printer Working Group. All rights reserved.
9495862863
864865866867868869870871872873
874
875
876877
878
879880
881882
883
884885
886
887888
889890891
892893
894
96
Working Draft – IPP System Service v1.0 (SYSTEM) 6 July 2016
The Client MUST supply and the System MUST support this attribute.
Group 2: Printer Description Attributes
<any Printer Description attribute>
The Client MAY supply and the System MAY support these attributes. See “printer-settable-attributes-supported” defined in [RFC3380].
6.2.2 Create-Printer Response
The System MUST return a Create-Printer operation response to the Client.
Group 1: Operation Attributes
"attributes-charset" (charset) and "attributes-natural-language" (naturalLanguage):
The System MUST return both of these attributes.
"status-message" (text(255)) and/or"detailed-status-message" (text(MAX)):
The System MAY return one or both of these attributes.
Group 2: Unsupported Attributes
See [RFC2911] for details on returning Unsupported Attributes.
Groups 3: Printer Attributes
See [RFC2911] for details on returning Printer Attributes.
“printer-uri” (uri):
The System MUST return this attribute.
“printer-uuid” (uri(45)):
The System MUST return this attribute.
“printer-uri-supported” (1setOf uri) and“uri-authentication-supported” (1setOf type2 keyword)” and“uri-security-supported (1setOf type2 keyword)”:
The System MUST return all three of these attributes.
“printer-state” (type1 enum) and“printer-state-reasons” (1setOf type2 keyword):
Page 34 of 111 Copyright © 2014-2016 The Printer Working Group. All rights reserved.
9798895
896
897
898899
900
901
902
903904
905
906907
908
909
910
911
912
913
914
915
916
917918919
920
921922
99
Working Draft – IPP System Service v1.0 (SYSTEM) 6 July 2016
The System MUST return both of these attributes.
6.3 Create-Resource
[rename of *part* of original StoreResource to create resource metadata but NOT resource data]
Good, add type and category attributes to Resource Description attributes⁃
Resources are managed by the System - IDs are unique across all services of a system⁃
Persistence is decided by System⁃
System-wide resources typically persisted for life of system⁃
Printer/service resources persist for life of printer/service⁃
Job resource persist for life of job⁃
Residence (after restart) depends on use/implementation⁃
Job resources retained for as long as document data⁃
Installation/use of resources through separate operation ("Install-Resource")⁃
Firmware, software, fonts, etc.⁃
No expiration/lease like in PWG Network Resource Service⁃
Too much like DRM, still manual maintenance⁃
Just cancel resource at the right time⁃
Avoids resource race conditions⁃
This REQUIRED operation allows a Client to create a new Resource object on the target System object. This operation is semantically analogous to the StoreResource operation defined in [PWG5108.06] (except that the Resource data is separately transferred with a subsequent Send-Resource-Data operation). This operation does not change the “system-state” of the System itself.
A new Resource object will be created and initialized with the “resource-state” set to ‘pending’ (i.e., no Resource data has been associated yet). The Client can then send one or more Set-Resource-Attributes operations to modify the Resource object, followed by a Send-Resource-Data operation (i.e., upload the associated Resource data) to change the “resource-state” to ‘active’ (unless there is another reason for the Resource to stay in the ‘pending’ state).
Page 35 of 111 Copyright © 2014-2016 The Printer Working Group. All rights reserved.
100101923
924
925926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941942943944945
946947948949950951
102
Working Draft – IPP System Service v1.0 (SYSTEM) 6 July 2016
Note: Printer-scope Resource objects MUST be created after the related Create-Printer operation, so that “resource-printer-uri” can be correctly specified. Resource-scope Subscription objects MUST be created after the related Create-Resource operation, so that “notifiy-printer-uri” can be correctly specified.
6.3.1 Create-Resource Request
The Client submits a Create-Resource operation request to a System object. The following groups of attributes are part of a Create-Resource request.
Group 1: Operation Attributes
"attributes-charset" (charset) and "attributes-natural-language" (naturalLanguage):
The Client MUST supply and the System MUST support both of these attributes.
“system-uri” (uri):
The Client MUST supply and the System MUST support the “system-uri” operation attribute which is the target System for the operation.
"requesting-user-name" (name(MAX)) and "requesting-user-uri" (uri) and“requesting-user-vcard” (1setOf text(1023)):
The Client SHOULD supply and the System MUST support all threeboth of these attributes.
“resource-category” (type2 keyword) and“resource-format” (mimeMediaType) and“resource-type” (type2 keyword):
The Client MUST supply and the System MUST support all three of these attributes.
“resource-job-id” (integer(1:MAX)):
The Client MUST supply this attribute for a Job-scope Resource and the System MUST support this attribute.
“resource-printer-uri” (uri):
The Client MUST supply this attribute for a Job-scope Resource and the System MUST support this attribute.
Group 2: Resource Description Attributes
Page 36 of 111 Copyright © 2014-2016 The Printer Working Group. All rights reserved.
103104952953954955
956
957958
959
960961
962963
964
965966
967968969
970971
972973974
975976
977
978979
980
981982
983
105
Working Draft – IPP System Service v1.0 (SYSTEM) 6 July 2016
<any Resource Description attribute>
The Client MAY supply and the System MAY support these attributes.
6.3.2 Create-Resource Response
The System MUST return a Create-Resource operation response to the Client.
Group 1: Operation Attributes
"attributes-charset" (charset) [RFC2911] and "attributes-natural-language" (naturalLanguage) [RFC2911]:
The System MUST return both of these attributes.
"status-message" (text(255)) and/or"detailed-status-message" (text(MAX)):
The System MAY return one or both of these attributes.
Group 2: Unsupported Attributes
See [RFC2911] for details on returning Unsupported Attributes.
Groups 3: Resource Attributes
See [RFC2911] for details on returning analogous Printer Attributes.
“resource-id” (integer(1:MAX)):
The System MUST return this attribute.
“resource-uuid” (uri(45)):
The System MUST return this attribute.
“resource-state” (type1 enum) and“resource-state-reasons” (1setOf type2 keyword):
The System MUST return both of these attributes.
Page 37 of 111 Copyright © 2014-2016 The Printer Working Group. All rights reserved.
106107984
985
986
987
988
989990
991
992993
994
995
996
997
998
999
1000
1001
1002
1003
10041005
1006
1007
108
Working Draft – IPP System Service v1.0 (SYSTEM) 6 July 2016
6.4 Create-Resource-Subscriptions
6.5 Create-System-Subscriptions
6.6 Delete-Printer
This REQUIRED operation allows a Client to delete entirely one configured Printer object (i.e., Job processing service) on the target System object. If the Printer object is not already shutdown, with ‘shutdown’ in the “printer-state-reasons”, then the System MUST return a “status-code” of ‘client-error-forbidden’. This operation is semantically equivalent to the DeleteService operation defined in [PWG5108.06]. The Printer object and all associated Jobs will be removed entirely. The Printer object cannot be subsequently started up with a Startup-One-Printer operation. This operation MAY change the state of the System itself to ‘stopped’ (if there are no other configured Printers or all other Printers already had a “printer-state” of ‘stopped’).
The specified Printer will be shutdown with the “printer-state” set to ‘stopped’ (i.e., no Jobs can be processed and intervention is required) and the ‘shutdown’ value added to “printer-state-reasons”. The Client can later send a Startup-One-Printer operation to the System (preferred) or a Startup-Printer operation [RFC3998] to the Printer to start up the specified Printer.
6.6.1 Delete-Printer Request
The Client submits a Delete-Printer operation request to a System object. The following groups of attributes are part of a Delete-Printer request.
Group 1: Operation Attributes
The System MUST support the same operation attributes in a Delete-Printer operation request as those defined for the Startup-One-Printer operation.
6.6.2 Delete-Printer Response
The System MUST return a Delete-Printer operation response to the Client.
Group 1: Operation Attributes
The System MUST support the same operation attributes in a Delete-Printer operation response as those defined for the Startup-One-Printer operation.
Page 38 of 111 Copyright © 2014-2016 The Printer Working Group. All rights reserved.
109110
1008
1009
1010
101110121013101410151016101710181019
10201021102210231024
1025
10261027
1028
10291030
1031
1032
1033
10341035
1036
111
Working Draft – IPP System Service v1.0 (SYSTEM) 6 July 2016
6.7 Disable-All-Printers
This REQUIRED operation allows a Client to pause all configured Printer objects (i.e., Job processing services) on the target System object. This operation is semantically equivalent to the DisableAllServices operation defined in [PWG5108.06]. This operation is also semantically equivalent to a sequence of Disable-Printer operations [RFC3398] to each configured Printer object. This operation does not change the “system-state” of the System itself.
Each configured Printer will be disabled with “printer-is-accepting-jobs” set to ‘false’ but the value of “printer-state” or “printer-state-reasons” is not affected by the Disable-All-Printers operation.
6.7.1 Disable-All-Printers Request
The Client submits a Disable-All-Printers operation request to a System object. The following groups of attributes are part of a Disable-All-Printers request.
Group 1: Operation Attributes
The System MUST support the same operation attributes in a Disable-All-Printers operation request as those defined for the Startup-All-Printers operation.
6.7.2 Disable-All-Printers Response
The System MUST return a Disable-All-Printers operation response to the Client. If no Printers are configured on the System, then the System MUST return a “status-code” of 'successful-ok'.
Group 1: Operation Attributes
The System MUST support the same operation attributes in a Disable-All-Printers operation response as those defined for the Startup-All-Printers operation.
6.8 Enable-All-Printers
This REQUIRED operation allows a Client to enable all configured Printer objects (i.e., Job processing services) on the target System object. This operation is semantically equivalent to the EnableAllServices operation defined in [PWG5108.06]. This operation is also semantically equivalent to a sequence of Enable-Printer operations [RFC3398] to each configured Printer object. This operation does not change the “system-state” of the System itself.
Each configured Printer will be enabled with “printer-is-accepting-jobs” set to ‘true’ but the value of “printer-state” or “printer-state-reasons” is not affected by the Enable-All-Printers operation.
Page 39 of 111 Copyright © 2014-2016 The Printer Working Group. All rights reserved.
112113
1037
103810391040104110421043
104410451046
1047
10481049
1050
10511052
1053
105410551056
1057
10581059
1060
106110621063106410651066
106710681069
114
Working Draft – IPP System Service v1.0 (SYSTEM) 6 July 2016
6.8.1 Enable-All-Printers Request
The Client submits a Enable-All-Printers operation request to a System object. The following groups of attributes are part of a Enable-All-Printers request.
Group 1: Operation Attributes
The System MUST support the same operation attributes in a Enable-All-Printers operation request as those defined for the Startup-All-Printers operation.
6.8.2 Enable-All-Printers Response
The System MUST return a Enable-All-Printers operation response to the Client. If no Printers are configured on the System, then the System MUST return a “status-code” of 'successful-ok'.
Group 1: Operation Attributes
The System MUST support the same operation attributes in a Enable-All-Printers operation response as those defined for the Startup-All-Printers operation.
6.9 Get-Printers
This REQUIRED operation allows a Client to retrieve a filtered list of the Printer objects (i.e., Job processing services) on the target System object. This operation is semantically equivalent to the ListAllServices operation defined in [PWG5108.06]. This operation is also semantically equivalent to a sequence of Get-Printer-Attributes [RFC2911] operations to each Printer object except that the target is a System object (rather than a Printer object). A Printer URI will be returned for each matching Printer object.
Note: This End User operation does NOT require Client authentication, but MAY be encrypted just as any other IPP System Service operation.
6.9.1 Get-Printers Request
The Client submits a Get-Printers operation request to a System object. The following groups of attributes are part of a Get-Printers request.
Group 1: Operation Attributes
"attributes-charset" (charset) and "attributes-natural-language" (naturalLanguage):
The Client MUST supply and the System MUST support both of these attributes.
“system-uri” (uri):
Page 40 of 111 Copyright © 2014-2016 The Printer Working Group. All rights reserved.
1151161070
10711072
1073
10741075
1076
107710781079
1080
10811082
1083
108410851086108710881089
10901091
1092
10931094
1095
10961097
10981099
1100
117
Working Draft – IPP System Service v1.0 (SYSTEM) 6 July 2016
The Client MUST supply and the System MUST support the “system-uri” operation attribute which is the target System for the operation.
"requesting-user-name" (name(MAX)) and "requesting-user-uri" (uri):
The Client SHOULD supply and the System MUST support both of these attributes.
“first-index” (integer(1:MAX)):
The Client MAY supply and the System MUST support this attribute.
"limit" (integer(1:MAX)):
The Client MAY supply and the System MUST support this attribute.
“printer-geo-location” (uri):
The Client MAY supply and the System MUST support this attribute.
“printer-location” (text(127)):
The Client MAY supply and the System MUST support this attribute.
“printer-service-type” (1setOf (type2 keyword)):
The Client MAY supply and the System MUST support this attribute.
“requested-attributes” (1setOf type2 keyword):
The Client MAY supply and the System MUST support this attribute. If this operation attribute is NOT supplied, then the System MUST only return printer-uri-supported, uri-authentication-supported, and uri-security-supported.
Note: The Printer attributes listed in the IETF LDAP Schema for Printer Services [RFC7612] describe all of the valid Printer attributes that MAY be specified in this “requested-attributes” operation attribute.
“which-printers” (type2 keyword):
The Client MAY supply and the System MUST support this attribute.
6.9.2 Get-Printers Response
The System MUST return a Get-Printers operation response to the Client up to the number specified by the “limit” operation attribute that match the filter criteria as specified by the
Page 41 of 111 Copyright © 2014-2016 The Printer Working Group. All rights reserved.
11811911011102
11031104
11051106
1107
1108
1109
1110
1111
1112
1113
1114
1115
1116
1117
1118111911201121
112211231124
1125
1126
1127
11281129
120
Working Draft – IPP System Service v1.0 (SYSTEM) 6 July 2016
attribute values supplied by the Client in the request. If no Printers match the specified filter criteria, then the System MUST return a “status-code” of 'successful-ok'.
Group 1: Operation Attributes
"attributes-charset" (charset) and "attributes-natural-language" (naturalLanguage):
The System MUST return both of these attributes, unless no Printers match the filter criteria specified by the Client.
"status-message" (text(255)) and/or"detailed-status-message" (text(MAX)):
The System MAY return one or both of these attributes.
Group 2: Unsupported Attributes
See [RFC2911] for details on returning Unsupported Attributes.
Groups 3 to N: Printer Attributes
See [RFC2911] for details on returning Printer Attributes.
6.10 Get-Printer-Attributes
This REQUIRED operation allows a Client to retrieve a filtered list of the Printer attributes for the default Printer specified by the “system-default-printer-uri” on the target System object. This operation is semantically equivalent to the Get-Printer-Attributes operation defined in [RFC2911], except that the target is a System object (rather than a Printer object). A Printer URI will be returned for the default Printer specified by the “system-default-printer-uri” on the target System object.
6.10.1 Get-Printer-Attributes
The Client submits a Get-Printer-Attributes operation request to a System object. The following groups of attributes are part of a Get-Printer-Attributes request.
Group 1: Operation Attributes
The System MUST support the same operation attributes in a Get-Printer-Attributes operation request as those defined for the Get-Printers operation.
6.10.2 Get-Printer-Attributes Response
The System MUST return a Get-Printer-Attributes operation response to the Client up to the number specified by the “limit” operation attribute that match the filter criteria as
Page 42 of 111 Copyright © 2014-2016 The Printer Working Group. All rights reserved.
12112211301131
1132
11331134
11351136
11371138
1139
1140
1141
1142
1143
1144
114511461147114811491150
1151
11521153
1154
11551156
1157
11581159
123
Working Draft – IPP System Service v1.0 (SYSTEM) 6 July 2016
specified by the attribute values supplied by the Client in the request. If there is no configured default Printer, then the System MUST return a “status-code” of 'successful-ok'.
Group 1: Operation Attributes
The System MUST support the same operation attributes in a Get-Printer-Attributes operation response as those defined for the Get-Printers operation.
Group 2: Unsupported Attributes
See [RFC2911] for details on returning Unsupported Attributes.
Groups 3 to N: Printer Attributes
See [RFC2911] for details on returning Printer Attributes.
6.11 Get-Resources
[rename of ListResources]
- modeled on Get-Jobs with “requested-attributes” for which attributes to return – default is “resource-id” and “resource-state”
Note: This Administrator operation requires Client authentication.
6.12 Get-Resource-Attributes
[rename of GetResourceElements]
- modeled on Get-Job-Attributes with “requested-attributes” for which attributes to return – default is “resource-id” and “resource-state”
6.13 Get-System-Attributes
- modeled on 2911 Get-Printer-Attributes with “requested-attributes” for which attributes to return – default is all
6.14 Get-System-Supported-Values
- modeled on Get-Printer-Supported-Values in [RFC3380] – REQUIRED in this specification
Page 43 of 111 Copyright © 2014-2016 The Printer Working Group. All rights reserved.
12412511601161
1162
11631164
1165
1166
1167
1168
1169
1170
11711172
1173
1174
1175
11761177
1178
11791180
1181
11821183
126
Working Draft – IPP System Service v1.0 (SYSTEM) 6 July 2016
6.15 Install-Resource
[To activate (for use) firmware, software, font, etc. after Create-Resource and Send-Resource-Data]
6.16 Pause-All-Printers
This REQUIRED operation allows a Client to pause all configured Printer objects (i.e., Job processing services) on the target System object. This operation is semantically equivalent to the PauseAllServices operation defined in [PWG5108.06]. This operation is also semantically equivalent to a sequence of Pause-Printer operations [RFC2911] to each configured Printer object. The System will be paused with the “system-state” set to ‘stopped’.
Each configured Printer will be paused with the “printer-state” set to ‘stopped’ (although incoming Jobs can be accepted if the Printer is not disabled) and the ‘paused’ value added to “printer-state-reasons” (i.e., no Job processing output allowed).
6.16.1 Pause-All-Printers Request
The Client submits a Pause-All-Printers operation request to a System object. The following groups of attributes are part of a Pause-All-Printers request.
Group 1: Operation Attributes
The System MUST support the same operation attributes in a Pause-All-Printers operation request as those defined for the Startup-All-Printers operation.
6.16.2 Pause-All-Printers Response
The System MUST return a Pause-All-Printers operation response to the Client. If no Printers are configured on the System, then the System MUST return a “status-code” of 'successful-ok'.
Group 1: Operation Attributes
The System MUST support the same operation attributes in a Pause-All-Printers operation response as those defined for the Startup-All-Printers operation.
6.17 Pause-All-Printers-After-Current-Job
6.18 Register-Output-Device
[for IPP Infra/Cloud Model]
Drop system attributes in request? Continue discussion later (from PWG F2F 4/29/15)⁃
Page 44 of 111 Copyright © 2014-2016 The Printer Working Group. All rights reserved.
127128
1184
11851186
1187
118811891190119111921193
119411951196
1197
11981199
1200
12011202
1203
120412051206
1207
12081209
1210
1211
1212
1213
129
Working Draft – IPP System Service v1.0 (SYSTEM) 6 July 2016
Put static resource attributes in the printer groups of the response⁃
6.19 Restart-System
[operation to restart an entire System with existing firmware or different firmware (from Install-Resource after Create-Resource and Send-Resource-Data) – added for normal System maintenance and also System remediation based on health monitoring]
6.20 Resume-All-Printers
This REQUIRED operation allows a Client to resume all configured Printer objects (i.e., Job processing services) on the target System object. This operation is semantically equivalent to the ResumeAllServices operation defined in [PWG5108.06]. This operation is also semantically equivalent to a sequence of Resume-Printer operations [RFC2911] to each configured Printer object. This operation changes the “system-state” of the System itself to ‘idle’ (unless there is another reason for one or more Printers to stay in the ‘stopped’ state).
Each configured Printer will be resumed with the “printer-state” set to ‘idle’ (unless there is another reason for the Printer to stay in the ‘stopped’ state) and the ‘paused’ value removed from “printer-state-reasons” (i.e., Job processing output allowed).
6.20.1 Resume-All-Printers Request
The Client submits a Resume-All-Printers operation request to a System object. The following groups of attributes are part of a Resume-All-Printers request.
Group 1: Operation Attributes
The System MUST support the same operation attributes in a Resume-All-Printers operation request as those defined for the Startup-All-Printers operation.
6.20.2 Resume-All-Printers Response
The System MUST return a Resume-All-Printers operation response to the Client. If no Printers are configured on the System, then the System MUST return a “status-code” of 'successful-ok'.
Group 1: Operation Attributes
The System MUST support the same operation attributes in a Resume-All-Printers operation response as those defined for the Startup-All-Printers operation.
Page 45 of 111 Copyright © 2014-2016 The Printer Working Group. All rights reserved.
1301311214
1215
1216
121712181219
1220
1221122212231224122512261227
122812291230
1231
12321233
1234
12351236
1237
123812391240
1241
12421243
132
Working Draft – IPP System Service v1.0 (SYSTEM) 6 July 2016
6.21 Send-Resource-Data
[rename of *part* of original StoreResource]
⁃ Agreement on not supporting replacement of resource data
6.22 Set-Resource-Attributes
[rename of SetResourceElements for Resource description attributes – MUST NOT change Resource status attributes or Resource data]
6.23 Set-System-Attributes
This REQUIRED operation allows an Operator or Administrator to set the values of System Description attributes listed in “system-settable-attributes-supported” (see section 7.2).
For Client support for localization see “system-strings-languages-supported” and “system-strings-uri” in section 7.2
6.24 Shutdown-All-Printers
This REQUIRED operation allows a Client to shutdown all configured Printer objects (i.e., Job processing services) on the target System object. This operation is semantically equivalent to the ShutdownAllServices operation defined in [PWG5108.06]. This operation is also semantically equivalent to a sequence of Shutdown-Printer operations [RFC3998] to each configured Printer object (except for the resulting “printer-state” of ‘stopped’ rather than ‘idle’). The System will be paused with the “system-state” set to ‘stopped’.
Each configured Printer will be shutdown with the “printer-state” set to ‘stopped’ (i.e., no Jobs can be processed and intervention is required) and the ‘shutdown’ value added to “printer-state-reasons”. The Client can later send a Startup-All-Printers operation (preferred) or a sequence of Startup-One-Printer operations (preferred) or Startup-Printer operations [RFC3998] to each Printer to start up all of the configured Printers.
6.24.1 Shutdown-All-Printers Request
The Client submits a Shutdown-All-Printers operation request to a System object. The following groups of attributes are part of a Shutdown-All-Printers request.
Group 1: Operation Attributes
The System MUST support the same operation attributes in a Shutdown-All-Printers operation request as those defined for the Startup-All-Printers operation.
Page 46 of 111 Copyright © 2014-2016 The Printer Working Group. All rights reserved.
133134
1244
1245
1246
1247
12481249
1250
12511252
12531254
1255
125612571258125912601261
12621263126412651266
1267
12681269
1270
12711272
135
Working Draft – IPP System Service v1.0 (SYSTEM) 6 July 2016
6.24.2 Shutdown-All-Printers Response
The System MUST return a Shutdown-All-Printers operation response to the Client. If no Printers are configured on the System, then the System MUST return a “status-code” of 'successful-ok'.
Group 1: Operation Attributes
The System MUST support the same operation attributes in a Shutdown-All-Printers operation response as those defined for the Startup-All-Printers operation.
6.25 Shutdown-One-Printer
This REQUIRED operation allows a Client to shutdown one configured Printer object (i.e., Job processing service) on the target System object. This operation is semantically equivalent to the ShutdownService operation defined in [PWG5108.06]. This operation is also semantically equivalent to a Shutdown-Printer operation [RFC3998] to the configured Printer object (except for the resulting “printer-state” of ‘stopped’ rather than ‘idle’). This operation MAY cause the System to pause with “system-state” set to ‘stopped’ (if all other Printers already had a “printer-state” of ‘stopped’).
The specified Printer will be shutdown with the “printer-state” set to ‘stopped’ (i.e., no Jobs can be processed and intervention is required) and the ‘shutdown’ value added to “printer-state-reasons”. The Client can later send a Startup-One-Printer operation to the System (preferred) or a Startup-Printer operation [RFC3998] to the Printer to start up the specified Printer.
6.25.1 Shutdown-One-Printer Request
The Client submits a Shutdown-One-Printer operation request to a System object. The following groups of attributes are part of a Shutdown-One-Printer request.
Group 1: Operation Attributes
The System MUST support the same operation attributes in a Shutdown-One-Printer operation request as those defined for the Startup-One-Printer operation.
6.25.2 Shutdown-One-Printer Response
The System MUST return a Shutdown-One-Printer operation response to the Client.
Group 1: Operation Attributes
The System MUST support the same operation attributes in a Shutdown-One-Printer operation response as those defined for the Startup-One-Printer operation.
Page 47 of 111 Copyright © 2014-2016 The Printer Working Group. All rights reserved.
1361371273
127412751276
1277
12781279
1280
1281128212831284128512861287
12881289129012911292
1293
12941295
1296
12971298
1299
1300
1301
13021303
138
Working Draft – IPP System Service v1.0 (SYSTEM) 6 July 2016
6.26 Startup-All-Printers
This REQUIRED operation allows a Client to startup all configured Printer objects (i.e., Job processing services) on the target System object. This operation is semantically equivalent to the StartupAllServices operation defined in [PWG5108.06]. This operation is also semantically equivalent to a sequence of Startup-One-Printer operations for each configured Printer object. The System will be paused with the “system-state” set to ‘stopped’.
Each configured Printer will be started up with the “printer-state” set to ‘stopped’ (i.e., no Jobs can be processed and intervention is required), “printer-is-accepting-jobs” set to ‘false’ (i.e., no incoming Jobs accepted), and the ‘paused’ value added to “printer-state-reasons” (i.e., no Job processing output allowed). The Client can then send one or more Set-Printer-Attributes operations to modify the configuration of each Printer, followed by Resume-Printer (i.e., remove ‘paused’ from “printer-state-reasons”) and Enable-Printer (i.e., change “printer-is-accepting-jobs” to ‘true’).
6.26.1 Startup-All-Printers Request
The Client submits a Startup-All-Printers operation request to a System object. The following groups of attributes are part of a Startup-All-Printers request.
Group 1: Operation Attributes
"attributes-charset" (charset) and "attributes-natural-language" (naturalLanguage):
The Client MUST supply and the System MUST support both of these attributes.
“system-uri” (uri):
The Client MUST supply and the System MUST support the “system-uri” operation attribute which is the target System for the operation.
"requesting-user-name" (name(MAX)) and "requesting-user-uri" (uri):
The Client SHOULD supply and the System MUST support both of these attributes.
6.26.2 Startup-All-Printers Response
The System MUST return a Startup-All-Printers operation response to the Client. If no Printers are configured on the System, then the System MUST return a “status-code” of 'successful-ok'.
Group 1: Operation Attributes
Page 48 of 111 Copyright © 2014-2016 The Printer Working Group. All rights reserved.
139140
1304
130513061307130813091310
1311131213131314131513161317
1318
13191320
1321
13221323
13241325
1326
13271328
13291330
13311332
1333
133413351336
1337
141
Working Draft – IPP System Service v1.0 (SYSTEM) 6 July 2016
"attributes-charset" (charset) and "attributes-natural-language" (naturalLanguage):
The System MUST return both of these attributes.
"status-message" (text(255)) and/or"detailed-status-message" (text(MAX)):
The System MAY return one or both of these attributes.
6.27 Startup-One-Printer
This REQUIRED operation allows a Client to startup one configured Printer object (i.e., Job processing service) on the target System object. This operation is semantically equivalent to the StartupService operation defined in [PWG5108.06]. This operation MAY cause the System to pause with “system-state” set to ‘stopped’ (if all other Printers already had a “printer-state” of ‘stopped’).
The specified Printer will be started up with the “printer-state” set to ‘stopped’ (i.e., no Jobs can be processed and intervention is required), “printer-is-accepting-jobs” set to ‘false’ (i.e., no incoming Jobs accepted), and the ‘paused’ value added to “printer-state-reasons” (i.e., no Job processing output allowed). The Client can then send one or more Set-Printer-Attributes operations to modify the configuration of the Printer, followed by Resume-Printer (i.e., remove ‘paused’ from “printer-state-reasons”) and Enable-Printer (i.e., change “printer-is-accepting-jobs” to ‘true’) to change the “printer-state” to ‘idle’ (unless there is another reason for the Printer to stay in the ‘stopped’ state).
6.27.1 Startup-One-Printer Request
The Client submits a Startup-One-Printer operation request to a System object. The following groups of attributes are part of a Startup-One-Printer request.
Group 1: Operation Attributes
"attributes-charset" (charset) and "attributes-natural-language" (naturalLanguage):
The Client MUST supply and the System MUST support both of these attributes.
“system-uri” (uri):
The Client MUST supply and the System MUST support the “system-uri” operation attribute which is the target System for the operation.
“printer-uri” (uri):
Page 49 of 111 Copyright © 2014-2016 The Printer Working Group. All rights reserved.
14214313381339
1340
13411342
1343
1344
13451346134713481349
13501351135213531354135513561357
1358
13591360
1361
13621363
13641365
1366
13671368
1369
144
Working Draft – IPP System Service v1.0 (SYSTEM) 6 July 2016
The Client MUST supply and the System MUST support the “printer-uri” operation attribute which is the target Printer for the operation.
"requesting-user-name" (name(MAX)) and "requesting-user-uri" (uri):
The Client SHOULD supply and the System MUST support both of these attributes.
6.27.2 Startup-One-Printer Response
The System MUST return a Startup-One-Printer operation response to the Client.
Group 1: Operation Attributes
"attributes-charset" (charset) and "attributes-natural-language" (naturalLanguage):
The System MUST return both of these attributes.
"status-message" (text(255)) and/or"detailed-status-message" (text(MAX)):
The System MAY return one or both of these attributes.
Page 50 of 111 Copyright © 2014-2016 The Printer Working Group. All rights reserved.
14514613701371
13721373
13741375
1376
1377
1378
13791380
1381
13821383
1384
1385
147
Working Draft – IPP System Service v1.0 (SYSTEM) 6 July 2016
7. IPP Attributes
7.1 System, Printer, and Resource Operation Attributes
7.1.1 printer-geo-location (uri)
This operation attribute specifies a filter for the applicable Printers as used in Get-Printers defined in section 6 and is semantically analogous to the “printer-geo-location” attribute defined in [PWG5100.13].
7.1.2 printer-location (text(127))
This operation attribute specifies a filter for the applicable Printers as used in Get-Printers defined in section 6 and is semantically analogous to the “printer-location” attribute defined in [RFC2911].
7.1.3 printer-service-type (1setOf (type2 keyword))
This operation attribute specifies the service type for a Printer as used in Create-Printer or a filter for the applicable Printers as used in Get-Printers defined in section 6 and is semantically analogous to the ServiceType element defined in [PWG5108.06]. See “printer-service-type” in section 7.5 Printer Status Attributes.
7.1.4 requesting-user-vcard (1setOf text(1023))
This operation attribute contains the Resource or Printer Owner vCard [RFC6350] for a Create-Resource or Create-Printer operation and is semantically analogous to the Service object’s OwnerVCard defined in [PWG5108.01]. See “resource-owner-col” (section 7.6) and “printer-owner-col” (section 7.4) description attributes for updates in subsequent Set-Resource-Attributes or Set-Printer-Attributes operations.
7.1.5 resource-category (type2 keyword)
This operation attribute specifies the category for a Resource as used in Create-Resource or a filter for the applicable Resources as used in Get-Resources defined in section 6 and is semantically equivalent to the ResourceCategory element defined in [PWG5108.03]. See “resource-category” in section 7.7 Resource Status Attributes.
7.1.6[7.1.5] resource-format (1setOf (mimeMediaType))
This operation attribute specifies the format for a Resource as used in Create-Resource/Send-Resource-Data or a filter for the applicable Resources as used in Get-Resources defined in section 6 and is semantically equivalent to the ResourceFormat element defined in [PWG5108.03] and semantically analogous to the “document-format”
Page 51 of 111 Copyright © 2014-2016 The Printer Working Group. All rights reserved.
148149
1386
1387
1388
138913901391
1392
139313941395
1396
1397139813991400
1401
14021403140414051406
1407
1408
1409141014111412
1413
1414141514161417
150
Working Draft – IPP System Service v1.0 (SYSTEM) 6 July 2016
attribute defined in [RFC2911]. See “resource-format” in section 7.7 Resource Status Attributes.
7.1.7[7.1.6] resource-id (integer(1:MAX))
This operation attribute specifies the target Resource object as used in Get-Resource-Attributes and other Resource operations defined in section 6 and is semantically equivalent to the ResourceId element defined in [PWG5108.03] and semantically analogous to the “job-id” attribute defined in [RFC2911]. See “resource-id” in section 7.7 Resource Status Attributes.
7.1.8[7.1.7] resource-job-id (integer(1:MAX))
This operation attribute specifies the Job scope for a Resource as used in Create-Resource or a filter for the applicable Job scope Resources as used in Get-Resources defined in section 6 and is semantically analogous to the “job-id” attribute defined in [RFC2911]. See “resource-job-id” in section 7.7 Resource Status Attributes.
7.1.9[7.1.8] resource-k-octets (integer(0:MAX))
This operation attribute specifies the size of the data for a Resource as used in Create-Resource/Send-Resource-Data defined in section 6 and is semantically analogous to the “job-k-octets” attribute defined in [RFC2911]. See “resource-k-octets” in section 7.7 Resource Status Attributes.
7.1.10[7.1.9] resource-printer-uri (uri)
This operation attribute specifies the Printer scope for a Resource as used in Create-Resource or a filter for the applicable Printer scope Resources as used in Get-Resources defined in section 6 and is semantically analogous to the “job-printer-uri” attribute defined in [RFC2911]. See “resource-printer-uri” in section 7.7 Resource Status Attributes.
7.1.11[7.1.10] resource-state (type1 enum)
This operation attribute specifies a filter for the applicable Resources as used in Get-Resources defined in section 6 and is semantically analogous to the “job-state” attribute defined in [RFC2911] and replaces the semantically analogous DateTimeAtExpiration (Resource lease time) and ResourceIsExpired elements defined in [PWG5108.03]. See “resource-state” in section 7.7 Resource Status Attributes.
7.1.12[7.1.11] resource-type (type2 keyword)
This operation attribute specifies a filter for the applicable Resources as used in Get-Resources defined in section 6 and replaces the semantically analogous DateTimeAtExpiration (Resource lease time) element defined in [PWG5108.03]. See “resource-type” in section 7.7 Resource Status Attributes.
Page 52 of 111 Copyright © 2014-2016 The Printer Working Group. All rights reserved.
15115214181419
1420
14211422142314241425
1426
1427142814291430
1431
1432143314341435
1436
1437143814391440
1441
14421443144414451446
1447
1448144914501451
153
Working Draft – IPP System Service v1.0 (SYSTEM) 6 July 2016
7.1.13[7.1.12] system-uri (uri)
This operation attribute specifies the target System object as used in Get-Printers and all other operations defined in section 6 and is semantically analogous to the “printer-uri” attribute defined in [RFC2911] and semantically equivalent to the “SystemURI” attribute defined in [PWG5108.06].
7.1.14[7.1.13] which-printers (type2 keyword):
This operation attribute specifies a filter for the applicable Printers as used in Get-Printers defined in section 6 and is semantically analogous to the “which-jobs” attribute defined in [RFC2911].
StandardThekeyword values for this attribute include:
‘accepting’: All Printers with “printer-state” of ‘idle’ or ‘processing’ and “printer-is-accepting-jobs” of ‘true’.
‘all’: All Printers configured on this System object, regardless of their state.
‘idle’: All Printers with “printer-state” of ‘idle’.
‘not-accepting: All Printers with “printer-is-accepting-jobs” of ‘false’.
‘processing’: All Printers with “printer-state” of ‘processing’.
‘shutdown’: All Printers with “printer-state” of ‘stopped’ and “printer-state-reasons” of ‘shutdown’.
‘stopped’: All Printers with “printer-state” of ‘stopped’, but do not have “printer-state-reasons” of ‘shutdown’ or ‘testing’.
‘testing’: All Printers with “printer-state” of ‘stopped’ and “printer-state-reasons” of testing’.
7.2 System Description Attributes
System Description attributes are typically READ-WRITE and can potentially be set by an Operator or Administrator using the Set-System-Attributes operation (see section 6). WriteableWritable System Description attributes are listed in the value of “system-settable-attributes-supported” (see section 7.2).
7.2.1 Power States and Policies
This specification imports (and renames for clarity and common usage) the normative definitions and semantics of System power states from the PWG Power Management
Page 53 of 111 Copyright © 2014-2016 The Printer Working Group. All rights reserved.
1541551452
1453145414551456
1457
145814591460
1461
14621463
1464
1465
1466
1467
14681469
14701471
14721473
1474
1475147614771478
1479
14801481
156
Working Draft – IPP System Service v1.0 (SYSTEM) 6 July 2016
Model for Imaging Systems 1.0 [PWG5106.4], which is aligned with DMTF CIM and ACPI power state definitions and semantics.
7.2.1.1 IEEE 1621 Power Modes
[IEEE1621] (which is primarily concerned with a simple user interface) defines 3 basic power modes: Off Mode, Sleep Mode, and On Mode. These power modes in turn can be qualified with “soft / hard”, “light / deep”, and “graceful” to describe specific power states (see the following sections on DMTF stable and ephemeral power states).
Off Mode – the set of power states where incoming jobs cannot be accepted immediately and existing jobs cannot be processed immediately (i.e., without a long delay for a power state transition to On Mode).
On Mode – the set of power states where incoming jobs can be accepted immediately and existing jobs can be processed immediately (i.e., with no delay for a power state transition).
Sleep Mode – the set of power states where incoming jobs MAY be accepted immediately, but existing jobs cannot be processed immediately (i.e., without a short delay for a power state transition to On Mode).
7.2.1.2 DMTF Stable Power States
This specification imports (and renames for clarity and common usage) the normative definitions and semantics of the following DMTF CIM [DSP1027] stable power states. All other DMTF CIM power states are ephemeral (orderly shutdowns and power resets) and will eventually result in one of the stable power states defined below.
‘hibernate’: DMTF “Hibernate (Off-Soft)” (7) and ACPI S4. The stable “Off Mode” power state where all kernel and application programs and data have been saved (e.g., to a hard disk) such that a transition to On allows recovery and continued processing without any loss of jobs or data. Limited auxiliary power is consumed (e.g., console lights), no network interfaces are operational, and human intervention is required to power up the system.
‘off-hard’: DMTF “Off-Hard” (6) and ACPI G3. The stable “Off Mode” power state where System power is mechanically or electrically turned off. No power is consumed, no network interfaces are operational, and human intervention is required to power up the System.
‘off-soft’: DMTF “Off-Soft” (8) and ACPI G2 or S5. The stable “Off Mode” power state where only limited auxiliary power is consumed (e.g., console lights), no network interfaces are operational, and human intervention is required to power up the system.
Page 54 of 111 Copyright © 2014-2016 The Printer Working Group. All rights reserved.
157158148214831484
1485
1486148714881489
1490
149114921493
149414951496
149714981499
1500
1501150215031504
15051506150715081509
1510151115121513
151415151516
159
Working Draft – IPP System Service v1.0 (SYSTEM) 6 July 2016
‘on’: DMTF “On” (2) – ACPI G0 or S0 – the stable “On Mode” power state where the System is in ‘idle’, ‘processing’, or ‘stopped’ operational states, with no delay required for a power state transition before processing incoming jobs.
‘standby’: DMTF “Sleep-Light” (3) and ACPI S1 or S2. The stable “Sleep Mode” power state with the shortest wake-up transition to the ‘on’ power state. Typically, mechanical elements (motors, lamps, heaters, etc.) are turned off or turned down, but processors and network interfaces are fully active (e.g., normal clock rate).
‘suspend’: DMTF “Sleep-Deep” (4) and ACPI S3. The stable “Sleep Mode” power state with the lowest power consumption of any “Sleep Mode” power state. Typically, mechanical elements (motors, lamps, heaters, etc.) are turned off, but processors and network interfaces are partially active (e.g., lower clock rate). Kernel and application programs and data are preserved (i.e., periodically refreshed) in main memory and at least one network interface is operational.
Additional vendor-specific power sub-states are defined as qualifiers of the stable power states ‘hibernate’, ‘off-soft’, ‘on’, ‘standby’, and ‘suspend’ (but not ‘off-hard’). These additional power sub-state keywords are all of the form ‘<base>-vendorN’ where ‘N’ is from ‘1’ to ‘5’ and the semantics MUST be exactly the same as those defined for these power sub-states as defined in [PWG5106.4]. Vendor-specific power sub-states MUST be used in strict order according to their nominal power consumption, e.g., ‘standby-vendor2’ MUST consume power equal to or higher than ‘standby-vendor1’ and ‘standby-vendor1’ MUST consume power equal to or higher than ‘standby’ (the base state).
7.2.1.3 DMTF Ephemeral Power States
This specification imports (and renames for clarity and common usage) the normative definitions and semantics of the following DMTF CIM [DSP1027] ephemeral (transitional) power states that initiate orderly shutdowns (e.g., ‘off-soft-graceful’) and power resets (e.g., ‘reset-hard’). All DMTF CIM ephemeral power state transitions will eventually result in one of the stable power states defined in section 7.2.1.2 above.
‘off-hard-graceful’: DMTF “Off-Hard Graceful” (13) and ACPI G3. The ephemeral power state that performs a graceful hard power off (orderly shutdown, followed by a hard power off cycle) and completes in the ‘off-hard’ power state.
‘off-soft-graceful’: DMTF “Off-Soft Graceful” (12) and ACPI G2 or S5. The ephemeral power state that performs a graceful soft power off (orderly shutdown, followed by a soft power off cycle) and completes in the ‘off-soft’ power state.
‘reset-hard’: DMTF “Power Cycle (Off-Hard)” (9) and ACPI G0 to G3, then S0. The ephemeral power state that performs a hard power reset (hard power off cycle, followed by normal power on cycle) and completes in the ‘on’ power state.
Page 55 of 111 Copyright © 2014-2016 The Printer Working Group. All rights reserved.
160161151715181519
1520152115221523
152415251526152715281529
15301531153215331534153515361537
1538
15391540154115421543
154415451546
154715481549
155015511552
162
Working Draft – IPP System Service v1.0 (SYSTEM) 6 July 2016
‘reset-hard-graceful’: DMTF “Power Cycle Off-Soft Graceful” (16) and ACPI G3, then S0. The ephemeral power state that performs a graceful hard power reset (orderly shutdown, followed by a hard power reset) and completes in the ‘on’ power state.
‘reset-init’: DMTF “Diagnostic Interrupt (INIT)” (17) and ACPI S5, then S0. The ephemeral power state (based on a diagnostic interrupt) that performs a hard power reset (hard power off cycle, followed by normal power on cycle) and completes in the ‘on’ power state.
‘reset-mbr’: DMTF “Master Bus Reset” (10) and ACPI S5, then S0. The ephemeral power state (based on a master bus reset) that performs a hard power reset (hard power off cycle, followed by normal power on cycle) and completes in the ‘on’ power state.
‘reset-mbr-graceful’: DMTF “Master Bus Reset Graceful” (14) and ACPI S5, then S0. The ephemeral power state that performs an orderly shutdown, followed by an MBR reset, and completes in the ‘on’ power state.
‘reset-nmi’: DMTF “Diagnostic Interrupt (NMI)” (11) and ACPI S5, then S0. The ephemeral power state (based on a non-maskable interrupt) that performs a hard power reset (hard power off cycle, followed by normal power on cycle) and completes in the ‘on’ power state.
‘reset-soft’: DMTF “Power Cycle (Off-Soft)” (5) and ACPI G2 or S5, then S0 w/ lost context. The ephemeral power state that performs a soft power reset (soft power off, followed by normal power on cycle) and completes in the ‘on’ power state.
‘reset-soft-graceful’: DMTF “Power Cycle Off-Soft Graceful” (16) and ACPI G2 or S5, then S0 w/ lost context. The ephemeral power state that performs a graceful soft power reset (orderly shutdown, followed by a soft power reset) and completes in the ‘on’ power state.
7.2.1.4 Power Policies
Power state transition policies can be scheduled by an Operator or Administrator in “power-calendar-policy-col”, “power-event-policy-col”, and “power-timeout-policy-col” System attributes. These policies can use triggers based on calendar times (e.g., 1st day of month), named events (e.g., ‘jam’), or elapsed time (e.g., 5 minutes of inactivity after entering ‘standby’ power state resulting in a further transition to ‘suspend’ power state).
System administrative operations can also invoke System power state transitions (e.g., Restart-System can invoke a ‘reset-soft-graceful’ transition). Job creation operations can be delayed in some System power states (e.g., during the warm up transition from ‘suspend’ to ‘on’). Job creation operations can also be prohibited in some System power states (e.g., in ‘hibernate’ and ‘off-soft’).
Note: This specification intentionally does not define any explicit operations for changing System power states. System power policies can be used instead to schedule power state transitions.
Page 56 of 111 Copyright © 2014-2016 The Printer Working Group. All rights reserved.
163164155315541555
155615571558
155915601561
156215631564
1565156615671568
156915701571
157215731574
1575
15761577157815791580
15811582158315841585
158615871588
165
Working Draft – IPP System Service v1.0 (SYSTEM) 6 July 2016
An example of an automated System power state transition to ‘hibernate’ at 6pm every Friday evening could be scheduled in “power-calendar-policy-col” as follows:
calendar-id=32 # arbitrary unique value for calendar policy
day-of-week=6 # Friday is 6th day counting from Sunday
hour=18 # 6pm is 18:00 on a 24-hour clock
request-power-state=’hibernate’ # target power state
In the above example, the irrelevant “day-of-month”, “minute”, “month”, and “run-once” member attributes have been omitted.
An example of a Restart-System operation implementation could be as follows:
1) ‘ stopping’ is added to “system-state-reasons” for the System.
2) ‘stopping’ is added to “printer-state-reasons” for each configured Printer.
3) ‘processing-to-stop-point’ is added to “job-state-reasons” for each active Job.
4) All active Jobs complete normally (because the stop point is a Job boundary) and ‘processing-to-stop-point’ is removed from “job-state-reasons” for each completed Job.
5) ‘stopping’ is removed from “printer-state-reasons” and “printer-state” is changed to ‘stopped’ for each configured Printer.
6) ‘stopping’ is removed from “system-state-reasons” and “system-state” is changed to ‘stopped’ for the System.
7) The System executes a ‘reset-soft-graceful’ transition, resulting in “power-state” in “power-state-monitor-col” values: on standby off-soft standby on.
8) “system-state” is changed to ‘idle’ for the System and “printer-state” is changed to ‘idle’ for each configured Printer.
9) Job processing resumes normally on all Printers.
7.2.2 charset-configured (charset)
This REQUIRED System attribute identifies the charset that is used to represent attributes with 'text' and 'name' attribute syntaxes and is semantically analogous to the "charset-configured" Printer attribute defined in [RFC2911]. The value of the "charset-configured" attribute MUST be one of the values of the "charset-supported" attribute defined in section 7.2.2.
Page 57 of 111 Copyright © 2014-2016 The Printer Working Group. All rights reserved.
16616715891590
1591
1592
1593
1594
15951596
1597
1598
1599
1600
160116021603
16041605
16061607
16081609
16101611
1612
1613
16141615161616171618
168
Working Draft – IPP System Service v1.0 (SYSTEM) 6 July 2016
7.2.3[7.2.2] charset-supported (1setOf charset)
This REQUIRED System attribute lists the charsets that are supported for values of attributes with 'text' and 'name' attribute syntaxes and is semantically analogous to the "charset-supported" Printer attribute defined in [RFC2911]. The value 'utf-8' MUST be present, since IPP objects MUST support the UTF-8 [RFC3629] charset.
7.2.4[7.2.3] ipp-versions-supported (1setOf type2 keyword)
This REQUIRED attribute identifies the supported IPP protocol version(s) and is semantically analogous to the "ipp-versions-supported" Printer attribute defined in [RFC2911].
7.2.5[7.2.4] natural-language-configured (naturalLanguage)
This REQUIRED System attribute identifies the natural language that is used for System-generated attribute values with 'text' and 'name' attribute syntaxes and is semantically analogous to the "natural-language-configured" Printer attribute defined in [RFC2911].
7.2.6[7.2.5] generated-natural-language-supported (1setOf naturalLanguage)
This REQUIRED System attribute lists the natural language(s) that are supported for System-generated attribute values with 'text' and 'name' attribute syntaxes and is semantically analogous to the "generated-natural-language-supported" Printer attribute defined in [RFC2911].
Note: The natural language(s) supported for System-generated values depends on implementation and/or configuration. However, unlike charsets, System objects MUST accept requests with any natural language or any Natural Language Override whether or not the natural language is supported for System-generated attribute values.
Note: A System that supports multiple natural languages, often has separate catalogs of messages, one for each natural language supported.
7.2.7[7.2.6] operations-supported (1setOf type2 enum)
This REQUIRED System attribute lists the supported System operations and is semantically analogous to the “operations-supported" Printer attribute defined in [RFC2911].
7.2.8[7.2.7] power-calendar-policy-col (1setOf collection)
This OPTIONAL System attribute lists the configured System calendar-based power state change policies and is semantically equivalent to the Power Calendar group defined in [PWG5106.4]. If “power-calendar-policy-col” is supported, then all member attributes in this collection are REQUIRED for the System but are OPTIONAL for the Client to supply.
Page 58 of 111 Copyright © 2014-2016 The Printer Working Group. All rights reserved.
1691701619
1620162116221623
1624
162516261627
1628
162916301631
1632
1633163416351636
1637163816391640
16411642
1643
164416451646
1647
1648164916501651
171
Working Draft – IPP System Service v1.0 (SYSTEM) 6 July 2016
For example, an automated System power state transition to ‘hibernate’ at 6pm every Friday evening could be scheduled in “power-calendar-policy-col” as follows:
calendar-id=32 # arbitrary unique value for calendar policy
day-of-week=6 # Friday is 6th day counting from Sunday
hour=18 # 6pm is 18:00 on a 24-hour clock
request-power-state=’hibernate’ # target power state
In the above example, the irrelevant “day-of-month”, “minute”, “month”, and “run-once” member attributes have been omitted.
7.2.8.1[7.2.7.1] calendar-id (integer(1:MAX))
This REQUIRED member attribute contains the unique key of this calendar policy and is semantically equivalent to the CalendarID element in the Power Calendar group defined in [PWG5106.4].
7.2.8.2[7.2.7.2] day-of-month (integer(1:31))
This REQUIRED member attribute specifies the trigger day of the month for this calendar policy and is semantically equivalent to the CalendarDay element in the Power Calendar group defined in [PWG5106.4]. The value ‘1’ represents the first day of the month.
See “system-current-time” defined above for the relevant System date, time, and time zone values.
7.2.8.3[7.2.7.3] day-of-week (integer(1:7))
This REQUIRED member attribute specifies the trigger day of the week for this calendar policy and is semantically equivalent to the CalendarDayOfWeek element in the Power Calendar group defined in [PWG5106.4]. The value ‘1’ represents Sunday.
See “system-current-time” defined above for the relevant System date, time, and time zone values.
7.2.8.4[7.2.7.4] hour (integer(0:23))
This REQUIRED member attribute specifies the trigger hour for this calendar policy and is semantically equivalent to the CalendarHour element in the Power Calendar group defined in [PWG5106.4]. The value ‘0’ represents the first hour of the day (i.e., 12:00-12:59am). Midnight (i.e., 12:00am) is specified by a value of zero for “hour” and a value of zero for “minute”.
See “system-current-time” defined above for the relevant System date, time, and time zone values.
Page 59 of 111 Copyright © 2014-2016 The Printer Working Group. All rights reserved.
17217316521653
1654
1655
1656
1657
16581659
1660
166116621663
1664
166516661667
16681669
1670
167116721673
16741675
1676
16771678167916801681
16821683
174
Working Draft – IPP System Service v1.0 (SYSTEM) 6 July 2016
Note: Due to local time zone changes (summer time to standard time or vice versa), it’s possible that a given hour will not occur in a given month.
7.2.8.5[7.2.7.5] minute (integer(0:59))
This REQUIRED member attribute specifies the trigger minute for this calendar policy and is semantically equivalent to the CalendarMinute element in the Power Calendar group defined in [PWG5106.4]. The value ‘0’ represents the first minute of the hour (e.g., 7:00am).
See “system-current-time” defined above for the relevant System date, time, and time zone values.
7.2.8.6[7.2.7.6] month (integer(1:12))
This REQUIRED member attribute specifies the trigger month for this calendar policy and is semantically equivalent to the CalendarMonth element in the Power Calendar group defined in [PWG5106.4]. The value of ‘1’ represents January.
See “system-current-time” defined above for the relevant System date, time, and time zone values.
[7.2.7.7] request-power-state (type12 keyword)
This REQUIRED member attribute specifies the requested stable or ephemeral (transitional) power state for this calendar policy and is semantically equivalent to the RequestPowerState element in the Power Calendar group defined in [PWG5106.4].
Standard values and constraints on vendor extension values are defined in section 7.2.1 Power States and Policies.
Note: Vendors MAY register additional keyword values as sub-state qualifiers of the stable power states ‘on’, ‘standby’, ‘suspend’, ‘hibernate’, or ‘off-soft’ (but not ‘off-hard’), but these additional keywords can only be of the form ‘<base>-vendorN’ where ‘N’ is from ‘1’ to ‘5’ and the semantics MUST be exactly the same as those defined for these power sub-states as defined in [PWG5106.4].
The standard keyword values for stable power states for this attribute include:
‘hibernate’
‘off-hard’
‘off-soft’
‘on’
‘standby’
Page 60 of 111 Copyright © 2014-2016 The Printer Working Group. All rights reserved.
17517616841685
1686
1687168816891690
16911692
1693
169416951696
16971698
1699
170017011702
17031704
17051706170717081709
1710
1711
1712
1713
1714
1715
177
Working Draft – IPP System Service v1.0 (SYSTEM) 6 July 2016
‘suspend’
The standard keyword values for ephemeral (transitional) power states for this attribute include:
‘no-change’ (i.e., a no-op)
‘not-applicable’
‘off-hard-graceful’
‘off-soft-graceful’
‘reset-hard’
‘reset-init’
‘reset-mbr’ (i.e., master boot record)
‘reset-mbr-graceful’
‘reset-nmi’ (i.e., non-maskable interrupt)
‘reset-soft’
‘reset-soft-graceful’
[7.2.7.8] run-once (boolean)
This REQUIRED member attribute specifies whether this calendar policy should be run once (single execution) or repeatedly (multiple executions) and is semantically equivalent to the CalendarRunOnce element in the Power Calendar group defined in [PWG5106.4].
7.2.9[7.2.8] power-event-policy-col (1setOf collection)
This OPTIONAL System attribute lists the configured System event-based power state change policies and is semantically equivalent to the Power Event group defined in [PWG5106.4].
For example, an automated System power state transition to ‘standby’ upon every ‘jam’ condition could be scheduled in “power-event-policy-col” as follows:
event-id=11 # arbitrary unique value for event policy
event-name=’jam’ # name of event
request-power-state=’standby’ # target power state
Page 61 of 111 Copyright © 2014-2016 The Printer Working Group. All rights reserved.
1781791716
17171718
1719
1720
1721
1722
1723
1724
1725
1726
1727
1728
1729
1730
173117321733
1734
173517361737
17381739
1740
1741
1742
180
Working Draft – IPP System Service v1.0 (SYSTEM) 6 July 2016
7.2.9.1 event-id (integer(1:MAX))
This REQUIRED member attribute contains the unique key of this event policy and is semantically equivalent to the EventID element in the Power Event group defined in [PWG5106.4].
7.2.9.2[7.2.8.1] event-name (name(127))
This REQUIRED member attribute specifies the trigger event name of this event policy and is semantically equivalent to the EventName element in the Power Event group defined in [PWG5106.4].
Event names MUST be either: (a) the exact case-sensitive label (starting with a lowercase character) of an enumerated value in the PrtAlertCodeTC textual convention in the IANA Printer MIB [IANAPRT] (e.g., ‘jam’); or (b) a case-sensitive vendor event name (starting with an uppercase character, e.g., ‘ExamplePowerEventAcmeCrackedCrock’). Event names MUST be specified in US-ASCII [ISO646] (for interoperability).
[7.2.8.2] request-power-state (type12 keyword)
This REQUIRED member attribute specifies the requested stable or ephemeral (transitional) power state for this event policy and is semantically equivalent to the RequestPowerState element in the Power Event group defined in [PWG5106.4].
Standard values and constraints on vendor extension values are defined in section 7.2.1 Power States and Policies7.2.7.7 request-power-state above.
7.2.10[7.2.9] power-timeout-policy-col (1setOf collection)
This RECOMMENDED System attribute lists the configured System timeout-based power state change policies and is semantically equivalent to the Power Timeout group defined in [PWG5106.4].
For example, an automated System power state transition to ‘standby’ upon 5 minutes of inactivity in ‘on’ power state could be scheduled in “power-timeout-policy-col” as follows:
request-power-state=’standby’ # target power state
start-power-state=’on’ # starting power state
timeout-id=23 # arbitrary unique value for timeout policy
timeout-predicate=’inactivity’ # predicate of system inactivity
timeout-seconds=300 # duration before transition to target power state
Page 62 of 111 Copyright © 2014-2016 The Printer Working Group. All rights reserved.
1811821743
174417451746
1747
174817491750
17511752175317541755
1756
175717581759
17601761
1762
176317641765
17661767
1768
1769
1770
1771
1772
183
Working Draft – IPP System Service v1.0 (SYSTEM) 6 July 2016
7.2.10.1 request-power-state (type12 keyword)
This REQUIRED member attribute specifies the requested stable or ephemeral (transitional) power state for this timeout policy and is semantically equivalent to the RequestPowerState element in the Power Timeout group defined in [PWG5106.4].
Standard values and constraints on vendor extension values are defined in section 7.2.1 Power States and Policies7.2.7.7 request-power-state above.
[7.2.9.1] start-power-state (type12 keyword)
This REQUIRED member attribute specifies the trigger starting stable power state for this timeout policy and is semantically equivalent to the StartPowerState element in the Power Timeout group defined in [PWG5106.4].
Note: Ephemeral (transitional) power states cannot be specified as triggers for timeout policies.
Standard values and constraints on vendor extension values for stable power states are defined in section 7.2.1 Power States and Policies.
The standard keyword values for this attribute include:
‘hibernate’
‘off-hard’
‘off-soft’
‘on’
‘standby’
‘suspend’
[7.2.9.2] timeout-id (integer(1:MAX))
This REQUIRED member attribute contains the unique key of this timeout policy and is semantically equivalent to the TimeoutID element in the Power Timeout group defined in [PWG5106.4].
7.2.10.2[7.2.9.3] timeout-predicate (type1 keyword)
This REQUIRED member attribute specifies the trigger predicate (i.e., pre-condition) for this timeout policy and is semantically equivalent to the TimeoutPredicate element in the Power Timeout group defined in [PWG5106.4].
The standard keyword values for this attribute are:
Page 63 of 111 Copyright © 2014-2016 The Printer Working Group. All rights reserved.
1841851773
177417751776
17771778
1779
178017811782
17831784
17851786
1787
1788
1789
1790
1791
1792
1793
1794
179517961797
1798
179918001801
1802
186
Working Draft – IPP System Service v1.0 (SYSTEM) 6 July 2016
‘activity’ (i.e., incoming Job, console input, etc.)
‘inactivity’ (i.e., no incoming, queued, or processing Jobs, console input, etc.)
‘none’
7.2.10.3[7.2.9.4] timeout-seconds (integer(0:MAX))
This REQUIRED member attribute specifies the trigger timeout interval in seconds (or zero for an immediate trigger controlled by the other trigger member attributes) for this timeout policy and is semantically equivalent to the TimeoutSeconds element in the Power Timeout group defined in [PWG5106.4].
7.2.11[7.2.10] resource-settable-attributes-supported
This REQUIRED System attribute lists Resource Description attributes supported for READ-WRITE access and can be configured by an Operator or Administrator. See “system-strings-languages-supported” and “system-strings-uri” below for Client localization support.
7.2.12[7.2.11] system-current-time (dateTime)
This REQUIRED System attribute specifies the current date and time for the System and is semantically equivalent to the CurrentTime element defined in [PWG5108.06].
7.2.13[7.2.12] system-default-printer-uri (uri | no-value)
This REQUIRED System attribute identifies the URI of the default Print Service configured by the Operator, Administrator, or manufacturer (used by the End User operation Get-Printer-Attributes defined in this specification) and is semantically analogous to the “printer-uri-supported” and “job-printer-uri” attributes defined in [RFC2911]. When a System has no configured Print Services, that System MUST return the ‘no-value’ out-of-band value defined in [RFC2911] for “system-default-printer-uri”. For a related use case, see section 3.2.5 Bootstrap Client Access to Default Print Service.
Note: When the first Print Service is created on a System, the System MUST set the value of “system-default-printer-uri” to reference that Print Service.
7.2.14[7.2.13] system-device-id (text(1023))
This REQUIRED System attribute specifies the IEEE 1284 Device ID of the overall System as defined in [IEEE1284] and further refined in [PWG5107.2] and is semantically analogous to the "printer-device-id" Printer attribute defined in [PWG5107.2.
7.2.15[7.2.14] system-geo-location (uri | unknown)
This REQUIRED System attribute specifies the System geographic location using the “geo:” URI scheme [RFC5870] and is semantically analogous to the "printer-geo-location"
Page 64 of 111 Copyright © 2014-2016 The Printer Working Group. All rights reserved.
1871881803
1804
1805
1806
1807180818091810
1811
1812181318141815
1816
18171818
1819
1820182118221823182418251826
18271828
1829
183018311832
1833
18341835
189
Working Draft – IPP System Service v1.0 (SYSTEM) 6 July 2016
Printer attribute defined in [PWG5100.13]. When the location is unknown, Systems MUST return the ‘unknown’ out-of-band value defined in [RFC2911]. Systems MUST allow the Operator or Administrator to set the geographic location manually.
7.2.16[7.2.15] system-info (text(127))
This REQUIRED System attribute specifies System descriptive information, e.g., "This System can be used for printing color transparencies for HR presentations,” and is semantically analogous to the "printer-info" Printer attribute defined in [RFC2911].
7.2.17[7.2.16] system-location (text(127))
This REQUIRED System attribute identifies the System location, e.g., "This System is in Room 123A, second floor of building XYZ," and is semantically analogous to the "printer-location" Printer attribute defined in [RFC2911].
7.2.18[7.2.17] system-make-and-model (text(127))
This REQUIRED System attribute identifies the System make and model and is semantically analogous to the "printer-make-and-model" Printer attribute defined in [RFC2911]. The manufacturer can initially populate this attribute.
7.2.19[7.2.18] system-message-from-operator (text(127))
This OPTIONAL System attribute provides a message from an Operator, Administrator, or "intelligent" process to indicate the reasons for modification or other System management action and is semantically analogous to the "printer-message-from-operator" Printer attribute defined in [RFC2911].
7.2.20[7.2.19] system-name (name(127))
This REQUIRED System attribute contains the System name and is semantically analogous to the "printer-name" Printer attribute defined in [RFC2911].
7.2.21[7.2.20] system-owner-col (collection)
This REQUIRED System attribute identifies the System Owner.
7.2.21.1[7.2.20.1] owner-uri (uri)
This REQUIRED member attribute contains a System Owner URI, e.g., “mailto:[email protected],” and is semantically analogous to the Service object’s OwnerURI defined in [PWG5108.01]. If specified in a Set-System-Attributes operation, then the “owner-vcard” member attribute MUST also be specified (to preserve consistency).
Page 65 of 111 Copyright © 2014-2016 The Printer Working Group. All rights reserved.
190191183618371838
1839
184018411842
1843
184418451846
1847
184818491850
1851
1852185318541855
1856
18571858
1859
1860
1861
18621863186418651866
192
Working Draft – IPP System Service v1.0 (SYSTEM) 6 July 2016
7.2.21.2[7.2.20.2] owner-vcard (1setOf text(1023))
This REQUIRED member attribute contains a System Owner vCard [RFC6350] and is semantically analogous to the Service object’s OwnerVCard defined in [PWG5108.01]. If specified in a Set-System-Attributes operation, then the “owner-uri” member attribute MUST also be specified (to preserve consistency).
7.2.22[7.2.21] system-settable-attributes-supported (1setOf type2 keyword)
This REQUIRED System attribute lists System Description attributes supported for READ-WRITE access and can be configured by an Operator or Administrator. See “system-strings-languages-supported” and “system-strings-uri” below for Client localization support.
7.2.23[7.2.22] system-strings-languages-supported (1setOf naturalLanguage)
This RECOMMENDED System attribute lists natural languages supported for the “system-strings-uri” System attribute and is semantically analogous to the “printer-strings-languages-supported” Printer attribute defined in [PWG5100.13].
This attribute MUST be supported if the "system-strings-uri" attribute is supported.
7.2.24[7.2.23] system-strings-uri (uri | no-value)
This RECOMMENDED System attribute provides a "text/strings" message catalog file using "http:" or "https:" URIs that SHOULD be System-resident so that Client interaction with the System does not require access to external networks and is semantically analogous to the “printer-strings-uri” Printer attribute defined in [PWG5100.13]. Systems SHOULD provide localizations for all supported System attributes, keywords, and enums, so that a Client may present a consistent user interface to the User.
This attribute MUST be supported if the "system-strings-uri" attribute is supported.
7.2.25[7.2.24] system-xri-supported (1setOf collection)
This REQUIRED System attribute lists supported XRI (URI, authentication, and security tuples) for the System and is semantically analogous to the "printer-xri-supported" Printer attribute defined in [RFC3380] and semantically analogous to Service object’s XriSupported defined in [PWG5108.01].
[7.2.24.1] systemxri-uri (uri)
This REQUIRED member attribute specifies an “ipp:” [RFC3510] or “ipps:” [RFC7472] URI for this System and is semantically analogous to a value of the “xriprinter-uri-supported” Printermember attribute defined in [RFC33802911].
Page 66 of 111 Copyright © 2014-2016 The Printer Working Group. All rights reserved.
1931941867
1868186918701871
1872
187318741875
1876
187718781879
18801881
1882
1883188418851886188718881889
1890
1891
1892189318941895
1896
189718981899
195
Working Draft – IPP System Service v1.0 (SYSTEM) 6 July 2016
[7.2.24.2] urixri-authentication (type2 keyword)
This REQUIRED member attribute specifies the IPP Client Authentication mechanism associated with the corresponding value of “systemxri-uri” above and is semantically analogous to a value of the “urixri-authentication-supported” Printermember attribute defined in [RFC33802911]. The original standard values for this attribute are defined in [RFC2911] and extension values are registered in the IANA IPP Registry [IANAIPP].
[7.2.24.3] urixri-security (type2 keyword)
This REQUIRED member attribute specifies the IPP security mechanism associated with the corresponding value of “systemxri-uri” above and is semantically analogous to a value of the “urixri-security-supported” Printermember attribute defined in [RFC33802911]. The original standard values for this attribute are defined in [RFC2911] and extension values are registered in the IANA IPP Registry [IANAIPP].
Page 67 of 111 Copyright © 2014-2016 The Printer Working Group. All rights reserved.
1961971900
19011902190319041905
1906
19071908190919101911
198
Working Draft – IPP System Service v1.0 (SYSTEM) 6 July 2016
7.3 System Status Attributes
All of the System Status attributes are READ-ONLY and cannot be changed directly by the Set-System-Attributes operation.
[7.3.1] power-general-col (collection)
This RECOMMENDED System attribute specifies the System power general capabilities and is semantically equivalent to the Power General group defined in [PWG5106.4].
[7.3.1.1] power-usage-is-rms-watts (boolean)
This REQUIRED member attribute specifies whether or not the power consumption properties for this System use units of Root Mean Square (RMS) watts (true) or unnormalized so-called peak watts (false) and is semantically equivalent to the PowerUsageIsRMSWatts element in the Power General group defined in [PWG5106.4].
[7.3.1.2] can-request-power-states (1setOf (type 2 keyword))
This REQUIRED member attribute specifies all of the stable and ephemeral power states that can be requested (in policies) on this System and is semantically equivalent to the CanRequestPowerStates element in the Power General group defined in [PWG5106.4].
Standard values and constraints on vendor extension values are defined in section 7.2.7.7 request-power-state above.
[7.3.2] power-log-col (1setOf collection)
This RECOMMENDED System attribute lists System power log entries (for events) and is semantically equivalent to the Power Log group defined in [PWG5106.4].
7.3.1.1[7.3.2.1] log-id (integer(1:MAX))
This REQUIRED member attribute contains the unique key of this power log entry and is semantically equivalent to the LogID element in the Power Log group defined in [PWG5106.4].
[7.3.2.2] power-state (type1 2 keyword)
This REQUIRED member attribute identifiesspecifies the recorded stable or ephemeral (transitional) power state for this power log entry and is semantically equivalent to the PowerState element in the Power Log group defined in [PWG5106.4].
Standard values and constraints on vendor extension values are defined in section 7.2.1 Power States and Policies7.2.7.7 request-power-state above.
Page 68 of 111 Copyright © 2014-2016 The Printer Working Group. All rights reserved.
199200
1912
19131914
1915
19161917
1918
1919192019211922
1923
192419251926
19271928
1929
19301931
1932
193319341935
1936
193719381939
19401941
201
Working Draft – IPP System Service v1.0 (SYSTEM) 6 July 2016
7.3.1.2[7.3.2.3] power-state-date-time (dateTime)
This REQUIRED member attribute identifiesspecifies the date and time of transition into the recorded power state for this power log entry and is semantically equivalent to the PowerStateDateAndTime element in the Power Log group defined in [PWG5106.4].
7.3.1.3[7.3.2.4] power-state-message (text (255))
This OPTIONAL member attribute containsspecifies a human-readable string in UTF-8 [RFC3629] that describes, explains, or qualifies the logged power state and is semantically equivalent to the PowerStateMessage element in the Power Log group defined in [PWG5106.4]. For example, "standby - System is shutting down by user request (2W)" when transitioning to final 'off-soft' power state.
Usage: This attribute: (a) MUST identify the power state; (b) SHOULD identify the method of entry to the power state, e.g., “from timeout trigger” or “from user request”; (c) SHOULD identify the nominal power 959 consumption, e.g., “(34 watts)”; and (d) MAY include any other power-related information, e.g., “can accept 960 jobs” or “can process jobs”.
[7.3.3] power-meters-col (1setOf collection)
This OPTIONAL System attribute lists System power meters (electrical current usage) and is semantically equivalent to the Power Meter group defined in [PWG5106.4].
[7.3.3.1] current-month-kwh (integer(0:MAX))
This REQUIRED member attribute specifies the current month's System power consumption in kilowatt hours and is semantically equivalent to the PowerCurrentMonthKWH element in the Power Meter group defined in [PWG5106.4].
Usage: Because it specifies the current month's power consumption, the value of this attribute will change rapidly.
[7.3.3.2] current-watts (integer(0:MAX))
This REQUIRED member attribute specifies the current System power consumption in watts and is semantically equivalent to the PowerCurrentWatts element in the Power Meter group defined in [PWG5106.4].
[7.3.3.3] lifetime-kwh (integer(0:MAX))
This REQUIRED member attribute specifies the lifetime System power consumption in kilowatt hours and is semantically equivalent to the PowerLifetimeKWH element in the Power Meter group defined in [PWG5106.4].
Page 69 of 111 Copyright © 2014-2016 The Printer Working Group. All rights reserved.
2022031942
194319441945
1946
19471948194919501951
1952195319541955
1956
19571958
1959
196019611962
19631964
1965
196619671968
1969
197019711972
204
Working Draft – IPP System Service v1.0 (SYSTEM) 6 July 2016
[7.3.3.4] meters-are-actual (boolean)
This REQUIRED member attribute specifies whether or not System power meter attributes are based on actual measurement (true) or software estimation (false) and is semantically equivalent to the PowerMetersAreActual element in the Power Meter group defined in [PWG5106.4].
[7.3.3.5] peak-watts (integer(0:MAX))
This REQUIRED member attribute specifies the peak System power consumption in watts and is semantically equivalent to the PowerPeakWatts element in the Power Meter group defined in [PWG5106.4].
[7.3.3.6] previous-month-kwh (integer(0:MAX))
This REQUIRED member attribute specifies the previous month's System power consumption in kilowatt hours and is semantically equivalent to the PowerPreviousMonthKWH element in the Power Meter group defined in [PWG5106.4].
Usage: Because it specifies the previous month's power consumption, the value of this attribute will be stable and can be read on any day of the current month (for reliable accounting).
[7.3.4] power-state-capabilities-col (1setOf collection)
This OPTIONAL System attribute lists System supported power capabilities perfor each stable power state entries for the System and is semantically equivalent to the Power Support group defined in [PWG5106.4].
7.3.1.4[7.3.4.1] can-accept-jobs (boolean)
This REQUIRED member identifies whether the System can accept new incoming Jobs in this stable power state, unless the System or has been disabled by an Operator or Administrator, and is semantically equivalent to the CanAcceptJobs element in the Power Support group defined in [PWG5106.4].
7.3.1.5 can-process-jobs (boolean)
This REQUIRED member identifies whether the System can process new incoming Jobs or existing queued Jobs in this stable power state and is semantically equivalent to the CanProcessJobs element in the Power Support group defined in [PWG5106.4].
7.3.1.6 power-active-watts (integer(0:MAX))
This REQUIRED member attribute identifies the nominal power consumption in watts for this stable power state when the System is in an active operational state (i.e., ‘processing’) and is semantically equivalent to the PowerActiveWatts element in the Power Support group defined in [PWG5106.4].
Page 70 of 111 Copyright © 2014-2016 The Printer Working Group. All rights reserved.
2052061973
1974197519761977
1978
197919801981
1982
198319841985
198619871988
1989
199019911992
1993
1994199519961997
1998
199920002001
2002
2003200420052006
207
Working Draft – IPP System Service v1.0 (SYSTEM) 6 July 2016
7.3.1.7 power-inactive-watts (integer(0:MAX))
This REQUIRED member attribute identifies the nominal power consumption in watts for this stable power state when the System is in an inactive operational state (i.e., ‘idle’ or ‘stopped’) and is semantically equivalent to the PowerInactiveWatts element in the Power Support group defined in [PWG5106.4].
7.3.1.8 power-state (type1 keyword)
This REQUIRED member attribute identifies a System supported stable power state that is the unique key of this power state capability entry and is semantically equivalent to the PowerState element in the Power Support group defined in [PWG5106.4].
Standard values and constraints on vendor extension values are defined in section 7.2.1 Power States and Policies.
7.3.2 power-state-counters-col (1setOf collection)
This OPTIONAL System attribute lists System power state transition counters (total usage) for the System and is semantically equivalent to the Power Counter group defined in [PWG5106.4].
7.3.2.1 hibernate-transitions (integer(0:MAX))
This REQUIRED member attribute contains the System lifetime number of transitions into the ‘hibernate’ power state and is semantically equivalent to the HibernateTransitions element in the Power Counter group defined in [PWG5106.4].
7.3.2.2[7.3.4.2] on-transitions (integer(0:MAX))
This REQUIRED member attribute contains the System lifetime number of transitions into the ‘on’ power state and is semantically equivalent to the OnTransitions element in the Power Counter group defined in [PWG5106.4].
7.3.2.3 standby-transitions (integer(0:MAX))
This REQUIRED member attribute contains the System lifetime number of transitions into the ‘standby’ power state and is semantically equivalent to the StandbyTransitions element in the Power Counter group defined in [PWG5106.4].
7.3.2.4 suspend-transitions (integer(0:MAX))
This REQUIRED member attribute contains the System lifetime number of transitions into the ‘suspend’ power state and is semantically equivalent to the SuspendTransitions element in the Power Counter group defined in [PWG5106.4].
Page 71 of 111 Copyright © 2014-2016 The Printer Working Group. All rights reserved.
2082092007
2008200920102011
2012
201320142015
20162017
2018
201920202021
2022
202320242025
2026
202720282029
2030
203120322033
2034
203520362037
210
Working Draft – IPP System Service v1.0 (SYSTEM) 6 July 2016
7.3.3 power-state-monitor-col (collection)
This RECOMMENDED System attribute contains the System power state and is semantically equivalent to the Power General, Power Meters, and Power Monitor groups defined in [PWG5106.4].
Note: Power consumption attribute values are volatile and typically change regularly at implementation-defined intervals.
7.3.3.1 current-month-kwh (integer(0:MAX))
This REQUIRED member attribute contains the current month's System power consumption in kilowatt hours and is semantically equivalent to the PowerCurrentMonthKWH element in the Power Meter group defined in [PWG5106.4]. The System MUST reset the value of this attribute to zero at the beginning of every month.
7.3.3.2 current-watts (integer(0:MAX))
This REQUIRED member attribute containsspecifies the current System instantaneous power consumption in watts and is semantically equivalent to the PowerCurrentWatts element in the Power Meter group defined in [PWG5106.4].
Note: The value of this attribute is typically determined by software estimation instead of actual current measurement.
7.3.3.3[7.3.4.3] lifetime-kwh (integer(0:MAX))
This REQUIRED member attribute containsspecifies the lifetime System power consumption in kilowatt hours and is semantically equivalent to the PowerLifetimeKWH element in the Power Meter group defined in [PWG5106.4].
7.3.3.4[7.3.4.4] meters-are-actual (boolean)
This REQUIRED member attribute identifiesspecifies whether or not System power meter attributes are based on actual measurement (true) or software estimation (false) and is semantically equivalent to the PowerMetersAreActual element in the Power Meter group defined in [PWG5106.4].
7.3.3.5[7.3.4.5] power-state (type1 keyword)
This REQUIRED member attribute identifies the current stable or ephemeral (transitional) System power state and is semantically equivalent to the PowerState element in the Power Monitor group defined in [PWG5106.4].
Standard values and constraints on vendor extension values are defined in section 7.2.1 Power States and Policies.
Page 72 of 111 Copyright © 2014-2016 The Printer Working Group. All rights reserved.
2112122038
203920402041
20422043
2044
2045204620472048
2049
205020512052
20532054
2055
205620572058
2059
2060206120622063
2064
206520662067
20682069
213
Working Draft – IPP System Service v1.0 (SYSTEM) 6 July 2016
7.3.3.6 power-state-message (text (255))
This OPTIONAL member attribute contains a human-readable string in UTF-8 [RFC3629] that describes, explains, or qualifies the current System power state (e.g.,) and is semantically equivalent to the PowerStateMessage element in the Power Monitor group defined in [PWG5106.4]. For example, "standby - System is shutting down by user request (2W)" when transitioning to final 'off-soft' power state.
Usage: This attribute: (a) MUST identify the power state; (b) SHOULD identify the method of entry to the power state, e.g., “from timeout trigger” or “from user request”; (c) SHOULD identify the nominal power consumption, e.g., “(34 watts)”; and (d) MAY include any other power-related information, e.g., “can accept jobs” or “can process jobs”.
7.3.3.7 power-usage-is-rms-watts (boolean)
This REQUIRED member attribute identifiesspecifies whether or not the power consumption properties for this System use units of Root Mean Square (RMS) watts (true) or unnormalized so-called peak watts (false) and is semantically equivalent to the PowerUsageIsRMSWatts element in the Power General group defined in [PWG5106.4].
[7.3.4.6] validcan-request-power-states (1setOf (type1 2 keyword))
This REQUIRED member attribute identifiesspecifies all of the stable and ephemeral power states that can be requested (in policies) on this System and is semantically equivalent to the CanRequestPowerStates element in the Power General group defined in [PWG5106.4].
Standard values and constraints on vendor extension values are defined in section 7.2.7.7 request-power-state 7.2.1 Power States and Policies above.
[7.3.5] power-state-transitions-col (1setOf collection)
This OPTIONAL System attribute lists valid System power state transitions entries (capabilities for state transitions) for the System and is semantically equivalent to the Power Transition group defined in [PWG5106.4].
7.3.3.8[7.3.5.1] end-power-state (type1 keyword)
This REQUIRED member attribute identifies the ending stable System power state for this valid power state transition and is semantically equivalent to the EndPowerState element in the Power Transition group defined in [PWG5106.4].
Standard values and constraints on vendor extension values are defined in section 7.2.1 Power States and Policies.
Page 73 of 111 Copyright © 2014-2016 The Printer Working Group. All rights reserved.
2142152070
20712072207320742075
2076207720782079
2080
2081208220832084
2085
2086208720882089
20902091
2092
209320942095
2096
209720982099
21002101
216
Working Draft – IPP System Service v1.0 (SYSTEM) 6 July 2016
7.3.3.9 start-power-state (type1 keyword)
This REQUIRED member attribute identifies the starting stable System power state for this valid power state transition and is semantically equivalent to the EndPowerState element in the Power Transition group defined in [PWG5106.4].
Standard values and constraints on vendor extension values are defined in section 7.2.1 Power States and Policies.
7.3.3.10 state-transition-seconds (integer(0:MAX))
This REQUIRED member attribute contains the nominal duration in seconds for this valid power state transition and is semantically equivalent to the StateChangeSeconds element in the Power Transition group defined in [PWG5106.4].
7.3.4 system-config-change-date-time (dateTime)
This REQUIRED System attribute containsspecifies the value of “system-current-time” (date and time) for the most recent System configuration change.
7.3.5[7.3.6] system-config-change-time (integer(0:MAX))
This REQUIRED System attribute containsspecifies the value of “system-up-time” (seconds since System startup) for the most recent System configuration change or zero if no System configuration change has occurred.
7.3.6[7.3.7] system-config-changes (integer(0:MAX))
This REQUIRED System attribute containsspecifies the count of configuration changes for the System and is semantically equivalent to the SystemConfigChangeNumber element defined in [PWG5108.06] and semantically analogous to the prtGeneralConfigChanges object defined in [RFC3805]. Each time a Set-System-Attributes operation is performed that changes the value of any attribute and each time the System changes the value of any attribute, the System MUST increment value of the “system-config-changes” attribute by exactly one. Each time that the System performs a power cycle (from ‘off’ to ‘on’), the System MUST reset the value of this attribute to zero.
7.3.7[7.3.8] system-configured-printers (1setOf collection)
This REQUIRED System attribute containsspecifies the summary of all configured Printers for the System and is semantically equivalent to the ConfiguredServices element defined in [PWG5108.06].
7.3.7.1 printer-info (text(127))
This REQUIRED member attribute contains the description of the Printer and is semantically equivalent to the "printer-info" Printer attribute defined in [RFC2911] but is not included in the ServiceSummary element defined in [PWG5108.06].
Page 74 of 111 Copyright © 2014-2016 The Printer Working Group. All rights reserved.
2172182102
210321042105
21062107
2108
210921102111
2112
21132114
2115
211621172118
2119
21202121212221232124212521262127
2128
212921302131
2132
213321342135
219
Working Draft – IPP System Service v1.0 (SYSTEM) 6 July 2016
7.3.7.2 printer-is-accepting-jobs (boolean)
This REQUIRED member attribute identifies whether the Printer is currently able to accept incoming Jobs and is semantically equivalent to the "printer-is-accepting-jobs" Printer attribute defined in [RFC2911] and semantically equivalent to the ServiceSummary element IsAcceptingJobs defined in [PWG5108.06].
7.3.7.3 printer-name (name(127))
This REQUIRED member attribute identifies the name of the Printer and is semantically equivalent to the "printer-name" Printer attribute defined in [RFC2911] and semantically equivalent to the ServiceSummary element ServiceName defined in [PWG5108.06].
7.3.7.4 printer-service-type (type2 keyword)
This REQUIRED member attribute identifies the service type of the Printer and is semantically equivalent to the "printer-service-type" Printer attribute defined in section 7.5.2 and semantically equivalent to the ServiceSummary element ServiceType defined in [PWG5108.06].
7.3.7.5 printer-state (type1 enum)
This REQUIRED member attribute contains the current state of the Printer and is semantically equivalent to the "printer-state" Printer attribute defined in [RFC2911] and semantically equivalent to the ServiceSummary element State defined in [PWG5108.06].
7.3.7.6 printer-state-reasons (1setOf type2 keyword)
This REQUIRED member attribute contains additional detail about the current state of the Printer and is semantically equivalent to the "printer-state-reasons" Printer attribute defined in [RFC2911] and semantically equivalent to the ServiceSummary element StateReasons defined in [PWG5108.06].
7.3.7.7 printer-xri-supported (1setOf collection)
This REQUIRED member attribute lists supported XRI (URI, authentication, and security tuples) for the Printer and is semantically equivalent to the "printer-xri-supported" Printer attribute defined in [RFC3380] and semantically equivalent to the ServiceSummary element ServiceXriSupported defined in [PWG5108.06].
7.3.7.8 queued-job-count (integer (0:MAX))
This REQUIRED member attribute identifies whether the Printer is currently able to accept incoming Jobs and is semantically equivalent to the "queued-job-count" Printer attribute defined in [RFC2911] and semantically equivalent to the ServiceSummary element QueuedJobCount defined in [PWG5108.06].
Page 75 of 111 Copyright © 2014-2016 The Printer Working Group. All rights reserved.
2202212136
2137213821392140
2141
214221432144
2145
2146214721482149
2150
215121522153
2154
2155215621572158
2159
2160216121622163
2164
2165216621672168
222
Working Draft – IPP System Service v1.0 (SYSTEM) 6 July 2016
7.3.8[7.3.9] system-configured-resources (1setOf collection)
This REQUIRED System attribute containsspecifies the summary of all configured Resources for the System and is semantically equivalent to the ConfiguredResources element defined in [PWG5108.06].
7.3.8.1 resource-category (type2 keyword)
This REQUIRED member attribute identifies the category of the Resource and is semantically equivalent to the "resource-category" Resource attribute defined in section 7.x and semantically equivalent to the ResourceSummary element ResourceCategory defined in [PWG5108.06].
7.3.8.2 resource-format (mimeMediaType)
This REQUIRED member attribute identifies the format of the Resource and is semantically equivalent to the "resource-format" Resource attribute defined in section 7.x and semantically equivalent to the ResourceSummary element ResourceFormat defined in [PWG5108.06].
7.3.8.3 resource-id (integer (1:max))
This REQUIRED member attribute contains the unique identier of the Resource and is semantically equivalent to the "resource-id" Resource attribute defined in section 7.x and semantically equivalent to the ResourceSummary element ResourceId defined in [PWG5108.06].
7.3.8.4 resource-info (text(127))
This REQUIRED member attribute contains the description of the Resource and is semantically equivalent to the "resource-info" Resource attribute defined in section 7.x but is not included in the ResourceSummary element defined in [PWG5108.06].
7.3.8.5 resource-name (name(127))
This REQUIRED member attribute identifies the name of the Resource and is semantically equivalent to the "resource-name" Resource attribute defined in section 7.x and semantically equivalent to the ResourceSummary element ResourceName defined in [PWG5108.06].
7.3.8.6 resource-state (type1 enum)
This REQUIRED member attribute contains the current state of the Resource and is semantically equivalent to the "resource-state" Resource attribute defined in section 7.x but is not included in the ResourceSummary element defined in [PWG5108.06].
Page 76 of 111 Copyright © 2014-2016 The Printer Working Group. All rights reserved.
2232242169
217021712172
2173
2174217521762177
2178
2179218021812182
2183
2184218521862187
2188
218921902191
2192
2193219421952196
2197
219821992200
225
Working Draft – IPP System Service v1.0 (SYSTEM) 6 July 2016
7.3.8.7 resource-type (type2 keyword)
This REQUIRED member attribute identifies the type of the Resource and is semantically equivalent to the "resource-type" Resource attribute defined in section 7.x and semantically equivalent to the ResourceSummary element ResourceType defined in [PWG5108.06].
7.3.9 system-configured-subunits (1setOf collection)
This REQUIRED System attribute containsspecifies the summary of all configured Subunits for the System and is semantically analogous to the SystemConfiguration element defined in [PWG5108.06].
7.3.9.1 subunit-index (integer (1:max))
This REQUIRED member attribute, when combined with the value of “subunit-type”, contains the unique identifier of the Subunit and is semantically equivalent to the icSubunitIndex element defined in PWG Imaging System State and Counter MIB v2 [PWG5106.3] and is semantically analogous to the prt<Group>Index elements (e.g., prtInputIndex) defined in IETF Printer MIB v2 [RFC3805].
See “printer-input-tray” defined in IPP Job and Printer Extensions – Set 3 (JPS3) [PWG5100.13]
7.3.9.2 subunit-info ((text(127))
This REQUIRED member attribute contains the description of the Subunit and is semantically equivalent to the icSubunitInfo element defined in PWG Imaging System State and Counter MIB v2 [PWG5106.3] and is semantically analogous to the prt<Group>Description elements (e.g., prtInputDescription) defined in IETF Printer MIB v2 [RFC3805].
7.3.9.3 subunit-states (1setOf (type2 keyword))
This REQUIRED member attribute contains the current state(s) of the Subunit and is semantically equivalent to the icSubunitStatus element defined in PWG Imaging System State and Counter MIB v2 [PWG5106.3] and is semantically analogous to the prt<Group>Status elements (e.g., prtInputStatus) defined in IETF Printer MIB v2 [RFC3805], which are bit-masks defined in the PrtSubunitStatusTC textual convention.
Standard keyword values for this attribute include:
*** Availability ***
‘available-and-idle’
‘available-and-standby’
Page 77 of 111 Copyright © 2014-2016 The Printer Working Group. All rights reserved.
2262272201
22022203220422052206
2207
220822092210
2211
22122213221422152216
22172218
2219
22202221222222232224
2225
22262227222822292230
2231
2232
2233
2234
228
Working Draft – IPP System Service v1.0 (SYSTEM) 6 July 2016
‘available-and-active’
‘available-and-busy’
‘unavailable-and-on-request’
‘unavailable-because-broken’
‘unknown’
*** Non-Critical ***
‘non-critical-alerts’
*** Critical ***
‘critical-alerts’
*** Online ***
‘online’
‘offline’
*** Transitioning ***
‘intended-state’
‘transitioning-state’
7.3.9.4 subunit-type (type2 keyword)
This REQUIRED member attribute identifies the type of the Subunit and is semantically equivalent to the icSubunitType element defined in PWG Imaging System State and Counter MIB v2 [PWG5106.3] and is semantically analogous to the prtAlertGroup element defined in IETF Printer MIB v2 [RFC3805], which is an enumeration defined in the PrtAlertGroupTC textual convention.
See “printer-finisher” defined in IPP Finishings 2.0 [PWG5100.1] and FinDeviceTypeTC in IETF Printer Finishing MIB [RFC3806].
Standard keyword values for this attribute include:
‘other’
‘unknown’
‘channel’
Page 78 of 111 Copyright © 2014-2016 The Printer Working Group. All rights reserved.
2292302235
2236
2237
2238
2239
2240
2241
2242
2243
2244
2245
2246
2247
2248
22492250
2251
22522253225422552256
22572258
2259
2260
2261
2262
231
Working Draft – IPP System Service v1.0 (SYSTEM) 6 July 2016
‘console’
‘cover’
‘fax-modem’
‘finisher’
‘interface’
‘interpreter’
‘input-tray’
‘marker’
‘media-path’
‘output-tray’
‘scanner’
‘scan-media-path’
‘storage’
*** Finisher Types ***
‘bander’
‘binder’
‘die-cutter’
‘envelope-maker’
‘folder’
‘imprinter’
‘inserter’
‘perforater’
‘puncher’
‘separation-cutter’
‘sheet-rotator’
Page 79 of 111 Copyright © 2014-2016 The Printer Working Group. All rights reserved.
2322332263
2264
2265
2266
2267
2268
2269
2270
2271
2272
2273
2274
2275
2276
2277
2278
2279
2280
2281
2282
2283
2284
2285
2286
2287
234
Working Draft – IPP System Service v1.0 (SYSTEM) 6 July 2016
‘slitter’
‘stacker’
‘stapler’
‘stitcher’
‘trimmer’
‘wrapper’
[7.3.10] system-serial-number (text(255))
This OPTIONAL System attribute identifiesspecifies the serial number for the System and is semantically equivalent to the SerialNumber element defined in [PWG5108.06] and semantically analogous to the prtGeneralSerialNumber element defined in [RFC3805].
7.3.10[7.3.11] system-state (type1 enum)
This REQUIRED System attribute containsspecifies the current state for the System and is semantically equivalent to the State element defined in [PWG5108.06] and semantically analogous to the “printer-state” attribute defined in [RFC2911].
Standard The values for this attribute are:
'3' 'idle': Indicates that all Printers are in the ‘idle’ state.
'4' 'processing': Indicates that one or more Printers are processing Jobs.
'5' 'stopped': Indicates that all Printers are in the ‘stopped’ state.
7.3.11[7.3.12] system-state-change-date-time (dateTime)
This REQUIRED System attribute containsspecifies the value of “system-current-time” (date and time) for the most recent System state change and is semantically analogous to the “printer-state-change-date-time” attribute defined in [RFC3995].
7.3.12[7.3.13] system-state-change-time (integer(0:MAX))
This REQUIRED System attribute containsspecifies the value of “system-up-time” (seconds since System startup) for the most recent System state change or zero if no System state change has occurred and is semantically analogous to the “printer-state-change-time” attribute defined in [RFC3995].
Page 80 of 111 Copyright © 2014-2016 The Printer Working Group. All rights reserved.
2352362288
2289
2290
2291
2292
2293
2294
229522962297
2298
229923002301
2302
2303
2304
2305
2306
230723082309
2310
2311231223132314
237
Working Draft – IPP System Service v1.0 (SYSTEM) 6 July 2016
7.3.13[7.3.14] system-state-message (1setOf (text(MAX)))
This REQUIRED System attribute contains a lists of state messages for the System and is semantically equivalent to the StateMessages element defined in [PWG5108.06] and semantically analogous to the “printer-state-message” attribute defined in [RFC2911].
7.3.14[7.3.15] system-state-reasons (1setOf type2 keyword)
This REQUIRED System attribute contains a lists of state reasons for the System and is semantically equivalent to the StateReasons element defined in [PWG5108.06] and semantically analogous to the “printer-state-reasons” attribute defined in [RFC2911].
7.3.15[7.3.16] system-totals (1setOf collection)
This RECOMMENDED System attribute contains a lists of aggregate counters for all Printers configured on the System and is semantically equivalent to the SystemTotals element defined in [PWG5108.06].
7.3.16[7.3.17] system-up-time (integer(1:MAX))
This REQUIRED System attribute containsspecifies the time in seconds since last boot for the System and is semantically equivalent to the UpTime element defined in [PWG5108.06].
7.3.17[7.3.18] system-uuid (uri(45))
This REQUIRED System attribute identifiesspecifies the UUID as a URI [RFC4122] for the System and is semantically equivalent to the ServiceUuid element defined in [PWG5108.01].
7.4 Printer Description Attributes
All of the Printer Description attributes are typically READ-WRITE and can potentially be set by an Operator or Administrator using the Set-Printer-Attributes operation [RFC3380]. Supported Writable Printer Description attributes for READ-WRITE access are listed in the value of “printer-settable-attributes-supported” [RFC3380].
7.4.1 printer-owner-col (collection)
This REQUIRED Printer attribute identifies the Printer Owner.
7.4.1.1 owner-uri (uri)
This REQUIRED member attribute contains a Printer Owner URI, e.g., “mailto:[email protected],” and is semantically analogous to the Service object’s OwnerURI defined in [PWG5108.01]. If specified in a Set-Printer-Attributes operation, then the “owner-vcard” member attribute MUST also be specified (to preserve consistency).
Page 81 of 111 Copyright © 2014-2016 The Printer Working Group. All rights reserved.
2382392315
231623172318
2319
232023212322
2323
232423252326
2327
232823292330
2331
233223332334
2335
2336233723382339
2340
2341
2342
2343234423452346
240
Working Draft – IPP System Service v1.0 (SYSTEM) 6 July 2016
7.4.1.2 owner-vcard (1setOf text(1023))
This REQUIRED member attribute contains a Printer Owner vCard [RFC6350] and is semantically analogous to the Service object’s OwnerVCard defined in [PWG5108.01]. If specified in a Set-Printer-Attributes operation, then the “owner-uri” member attribute MUST also be specified (to preserve consistency).
7.5 Printer Status Attributes
All of the Printer Status attributes are READ-ONLY and cannot be set directly by the Set-Printer-Attributes operation.
7.5.1 printer-config-changes (integer(0:MAX))
This REQUIRED Printer attribute identifies the number of configuration changes (in Printer Description attributes) for a Printer and is semantically equivalent to the “prtGeneralConfigChanges” element defined in [RFC3805]. The value of this attribute MUST be incremented by one for each operation that changes the Printer configuration (rather than incrementing by one for each configuration attribute that was changed by the single operation).
7.5.2 printer-service-type (type2 keyword)
This REQUIRED Printer attribute identifiesspecifies the service type for a Printer as used in Create-Printer defined in section 6 and is semantically analogous to the ServiceType element defined in [PWG5108.06].
Standard keywordThe values for this attribute include:
‘copy’: A Copy service defined in [PWG5108.04].
‘emailin’: An EmailIn service defined in [PWG5108.01].
‘emailout’: An EmailOut service defined in [PWG5108.01].
‘faxin’: A FaxIn service defined in [RFC2707] and [PWG5108.01].
‘faxout’: A FaxOut service defined in [PWG5100.15].
‘print’: A Print service defined in [RFC2911].
‘scan’: A Scan service defined in [PWG5100.17].
‘transform’: A Transform service defined in [PWG5108.01].
‘vendor’: A vendor-specific service
Page 82 of 111 Copyright © 2014-2016 The Printer Working Group. All rights reserved.
2412422347
2348234923502351
2352
23532354
2355
235623572358235923602361
2362
236323642365
2366
2367
2368
2369
2370
2371
2372
2373
2374
2375
243
Working Draft – IPP System Service v1.0 (SYSTEM) 6 July 2016
7.6 Resource Description Attributes
All of the Resource Description attributes are typically READ-WRITE and can potentially be set by an Operator, or Administrator, or manufacturer using the Set-Resource-Attributes operation (see section 6). Writable Resource Description attributes are listed in the value of “resource-settable-attributes-supported” defined below in section 7.6.
7.6.1 resource-info (text(127))
This REQUIRED Resource attribute contains the description of the Resource and is semantically equivalent to the ResourceInfo element defined in [PWG5108.03] and semantically analogous to the "printer-info" Printer attribute defined in [RFC2911].
7.6.2 resource-name (name(127))
This REQUIRED Resource attribute contains the name of the Resource and is semantically equivalent to the ResourceName element defined in [PWG5108.03] and semantically analogous to the "printer-name" Printer attribute defined in [RFC2911].
7.6.3 resource-owner-col (collection)
This REQUIRED Resource attribute identifies the Resource Owner.
7.6.3.1 owner-uri (uri)
This REQUIRED member attribute contains a Resource Owner URI, e.g., “mailto:[email protected],” and is semantically analogous to the Resource element ResourceCreatorUserName defined in [PWG5108.03] and semantically analogous to the “owner-uri” attribute defined in section 7.2.x. If specified in a Set-Resource-Attributes operation, then the “owner-vcard” member attribute MUST also be specified (to preserve consistency).
7.6.3.2 owner-vcard (1setOf text(1023))
This REQUIRED member attribute contains a Resource Owner vCard [RFC6350] but is not included in the Resource object defined in [PWG5108.03]. If specified in a Set-Resource-Attributes operation, then the “owner-uri” member attribute MUST also be specified (to preserve consistency).
7.6.4 resource-string-version (text(127))
[follow HCD-TNC]
[7.6.4] resource-version (octetString(16))
[follow HCD-TNC – but no infixed periods allowed as separators]
Page 83 of 111 Copyright © 2014-2016 The Printer Working Group. All rights reserved.
244245
2376
2377237823792380
2381
238223832384
2385
238623872388
2389
2390
2391
239223932394239523962397
2398
2399240024012402
2403
2404
2405
2406
246
Working Draft – IPP System Service v1.0 (SYSTEM) 6 July 2016
7.7 Resource Status Attributes
All of the Resource Status attributes are READ-ONLY and cannot be directly updatedby the Set-Resource-Attributes operation.
7.7.1 date-time-at-canceled (dateTime)
This REQUIRED Resource attribute contains the date and time of Resource cancelation and is semantically analogous to the DateTimeAtExpiration element defined in [PWG5108.03] and semantically analogous to the “date-time-at-completed” attribute defined in [RFC2911].
7.7.2 date-time-at-creation (dateTime)
This REQUIRED Resource attribute contains the date and time of Resource creation and is semantically equivalent to the DateTimeAtCreation element defined in [PWG5108.03] and semantically analogous to the “date-time-at-creation” attribute defined in [RFC2911].
7.7.3 date-time-at-installed (dateTime)
This REQUIRED Resource attribute contains the date and time of Resource installation.
7.7.4 resource-authenticator (1setOf collection)
- hash, signature, etc. of Resource data for verification after a Send-Resource-Data operation.
[[[ ISSUE: Define this collection to allow broad choices for Resource data verification methods ]]]
7.7.5[7.7.4] resource-category (type2 keyword)
Static resources already supported in INFRA⁃
Executable resources: focus on firmware and applications,⁃
but not code that runs as part of a job (ew!)
Template resources: define what an IPP Job Ticket resource⁃
looks like, need to have a way to differentiate between Print
and FaxOut and Scan job tickets
IPP Job Ticket has a few select operation attributes⁃
(destination-uri, etc.) + Job Template attributes
Page 84 of 111 Copyright © 2014-2016 The Printer Working Group. All rights reserved.
247248
2407
24082409
2410
2411241224132414
2415
241624172418
2419
2420
2421
24222423
24242425
2426
2427
2428
2429
2430
2431
2432
2433
2434
249
Working Draft – IPP System Service v1.0 (SYSTEM) 6 July 2016
Looks like a Create-Job request?⁃
No document template attributes - those can be⁃
inferred from Job Template as needed.
This REQUIRED Resource attribute identifies the category of the Resource and is semantically equivalent to the ResourceCategory element defined in [PWG5108.03].
The standard keyword values for this attribute include:
‘executable’: Executable Resource, e.g., firmware.
‘static’: Static Resource, e.g., logos, forms, etc.
‘template’: Job Template Resource as defined in [PWG5108.07].
7.7.6[7.7.5] resource-data-uri (uri | no-value))
This REQUIRED Resource attribute identifies the URI of the Resource data (if any) and is semantically equivalent to the ResourceFormat element defined in [PWG5108.03] and semantically analogous to the “document-format” attribute defined in [RFC2911]. When a Resource has no associated data, the System MUST return the ‘no-value’ out-of-band value defined in [RFC2911] for “resource-data-uri”.
7.7.7[7.7.6] resource-format (mimeMediaType)
This REQUIRED Resource attribute identifies the format of the Resource data and is semantically equivalent to the ResourceFormat element defined in [PWG5108.03] and semantically analogous to the “document-format” attribute defined in [RFC2911].
7.7.8[7.7.7] resource-id (integer(1:MAX))
This REQUIRED Resource attribute uniquely identifies the Resource within the System and is semantically equivalent to the ResourceId element defined in [PWG5108.03] and semantically analogous to the “job-id” attribute defined in [RFC2911].
7.7.9[7.7.8] resource-job-id (integer(1:MAX) | no-value)
This REQUIRED Resource attribute identifies the Job associated with the Resource (if any) but is not included in the Resource defined in [PWG5108.03] and semantically analogous to the “job-id” attribute defined in [RFC2911]. When a Resource has no associated Job, the System MUST return the ‘no-value’ out-of-band value defined in [RFC2911] for “resource-job-id”.
Page 85 of 111 Copyright © 2014-2016 The Printer Working Group. All rights reserved.
2502512435
2436
2437
2438243924402441
2442
2443
2444
2445
2446
24472448244924502451
2452
245324542455
2456
245724582459
2460
24612462246324642465
252
Working Draft – IPP System Service v1.0 (SYSTEM) 6 July 2016
7.7.10[7.7.9] resource-k-octets (integer(0:MAX))
This REQUIRED Resource attribute contains the size of the data associated with the Resource (if any) but is not included in the Resource defined in [PWG5108.03] and semantically analogous to the “job-k-octets” attribute defined in [RFC2911].
[7.7.10] resource-originating-user-name (name(MAX))
[7.7.11] resource-originating-user-uri (uri)
[7.7.12] resource-printer-uri (uri | no-value)
This REQUIRED Resource attribute identifies the Printer associated with the Resource (if any) but is not included in the Resource object defined in [PWG5108.03] and semantically analogous to the “printer-uri” attribute defined in [RFC2911]. When a Resource has no associated Printer, the System MUST return the ‘no-value’ out-of-band value defined in [RFC2911] for “resource-printer-uri”.
7.7.11[7.7.13] resource-state (type1 enum)
This REQUIRED Resource attribute containsidentifies the current state of the Resource and is semantically analogous to the DateTimeOfExpiration and ResourceHasExpired elements defined in [PWG5108.03] and semantically analogous to the “job-state” attribute defined in [RFC2911].
Standard The values for this attribute are:
‘3’ ‘pending’: The Resource has been created but not yet activated.
‘4’ ‘active’: The Resource has been activated and is available for use.
‘5’ ‘canceled’: The Resource has been canceled and can no longer be used.
7.7.12[7.7.14] resource-state-message (text(MAX))
This REQUIRED Resource attribute contains a state message for the Resource but is not included in the Resource object defined in [PWG5108.03] and semantically analogous to the “printer-state-message” attribute defined in [RFC2911].
7.7.13[7.7.15] resource-state-reasons (1setOf type2 keyword)
This REQUIRED Resource attribute contains a list of state reasons for the Resource but is not included in the Resource object defined in [PWG5108.03] and semantically analogous to the “printer-state-reasons” attribute defined in [RFC2911].
Standard values for this attribute are:
‘installed’: The Resouce has been installed and is now available for execution.
Page 86 of 111 Copyright © 2014-2016 The Printer Working Group. All rights reserved.
2532542466
246724682469
2470
2471
2472
24732474247524762477
2478
2479248024812482
2483
2484
2485
2486
2487
248824892490
2491
249224932494
2495
2496
255
Working Draft – IPP System Service v1.0 (SYSTEM) 6 July 2016
7.7.14 resource-string-version (text(127))
This REQUIRED Resource attribute contains the string version of the Resource, which SHOULD conform to section 4.2.4 “String Version” of IETF PA-TNC [RFC5792] which defines the internal string fields Product Version Number, Internal Build Number, and Configuration Version Number. This attribute is semantically analogous to the FirmwareStringVersion attribute defined in [PWG5110.4].
7.7.15 resource-type (type2 keyword)
This REQUIRED Resource attribute identifies the type of the Resource and is semantically equivalent to the ResourceType element defined in [PWG5108.03].
Standard values for this attribute (with their “resource-category” prefix) include:
‘document’: Template for creating Document object [PWG5100.5].
‘firmware’: Executable firmware.
‘font’: Static font.
‘form’: Static form.
‘iccprofile’ Static ICC profile.
‘image’: Static image.
‘job’ Template for creating Job object [PWG5108.07].
‘logo’: Static logo.
‘software’: Executable software.
7.7.16 resource-uuid (uri(45))
This REQUIRED Resource attribute identifies the UUID as a URI [RFC4122] for the Resource but is not included in the Resource object defined in [PWG5108.03] and is semantically analogous to the “system-uuid” attribute defined in section 7.3.
7.7.17[7.7.16] resource-version (octetString(16))
This REQUIRED Resource attribute contains the numeric version of the Resource, which SHOULD conform to section 4.2.3 “Numeric Version” of IETF PA-TNC [RFC5792] which defines the internal integer fields Major Version Number, Minor Version Number, Build Number, Service Pack Major, and Service Pack Minor. This attribute is semantically analogous to the FirmwareVersion attribute defined in [PWG5110.4].
Page 87 of 111 Copyright © 2014-2016 The Printer Working Group. All rights reserved.
2562572497
24982499250025012502
2503
25042505
2506
2507
2508
2509
2510
2511
2512
2513
2514
2515
2516
251725182519
2520
25212522252325242525
258
Working Draft – IPP System Service v1.0 (SYSTEM) 6 July 2016
7.7.18 time-at-canceled (integer(MIN:MAX))
This REQUIRED Resource attribute contains the time of Resource cancelation but is not included in the Resource object defined in [PWG5108.03] and is semantically analogous to the “time-at-completed” attribute defined in [RFC2911].
7.7.19[7.7.17] time-at-creation (integer(MIN:MAX))
This REQUIRED Resource attribute contains the time of Resource creation but is not included in the Resource object defined in [PWG5108.03] and is semantically analogous to the “time-at-creation” attribute defined in [RFC2911].
7.7.20 time-at-installed (integer(MIN:MAX))
This REQUIRED Resource attribute contains the time of Resource installation but is not included in the Resource object defined in [PWG5108.03].
Page 88 of 111 Copyright © 2014-2016 The Printer Working Group. All rights reserved.
2592602526
252725282529
2530
253125322533
2534
25352536
261
Working Draft – IPP System Service v1.0 (SYSTEM) 6 July 2016
[8.] Additional Semantics for Existing Operations
7.8[8.1] Cancel-Subscription, Get-Notifications, and Renew-Subscription: system-uri (uri) and resource-id (integer(1:MAX))
7.9[8.2] Get-Printer-Attributes: printer-resource-ids (1setOf integer(1:MAX))
[for compatibility with legacy IPP Clients – choose implementation-dependent “default” Printer object, “redirect” operation to that Printer object, and relay response to Client]
7.10[8.3] Create-Job, Get-Job-Attributes: job-resource-ids (1setOf integer(1:MAX))
8.[9.] Additional Values for Existing Attributes
8.1[9.1] notify-events (1setOf type2 keyword)
Page 89 of 111 Copyright © 2014-2016 The Printer Working Group. All rights reserved.
262263
2537
2538
2539
2540
2541
25422543
2544
2545
2546
2547
2548
2549
264
Working Draft – IPP System Service v1.0 (SYSTEM) 6 July 2016
9.[10.] Conformance RequirementsProvide numbered lists of conformance requirements for the document.
9.1[10.1] Conformance Requirements for Clients
9.2[10.2] Conformance Requirements for Infrastructure Systems
9.3[10.3] Conformance Requirements for Systems
10.[11.] Internationalization ConsiderationsFor interoperability and basic support for multiple languages, conforming implementations MUST support the Universal Character Set (UCS) Transformation Format -- 8 bit (UTF-8) [RFC3629] encoding of Unicode [UNICODE] [ISO10646] and the Unicode Format for Network Interchange [RFC5198].
Implementations of this specification SHOULD conform to the following standards on processing of human-readable Unicode text strings, see:
Unicode Bidirectional Algorithm [UAX9] – left-to-right, right-to-left, and vertical
Unicode Line Breaking Algorithm [UAX14] – character classes and wrapping
Unicode Normalization Forms [UAX15] – especially NFC for [RFC 5198]
Unicode Text Segmentation [UAX29] – grapheme clusters, words, sentences
Unicode Identifier and Pattern Syntax [UAX31] – identifier use and normalization
Unicode Collation Algorithm [UTS10] – sorting
Unicode Locale Data Markup Language [UTS35] – locale databases
Implementations of this specification are advised to also review the following informational documents on processing of human-readable Unicode text strings:
Unicode Character Encoding Model [UTR17] – multi-layer character model
Unicode in XML and other Markup Languages [UTR20] – XML usage
Unicode Character Property Model [UTR23] – character properties
Page 90 of 111 Copyright © 2014-2016 The Printer Working Group. All rights reserved.
265266
2550
2551
2552
2553
2554
2555
2556
2557255825592560
25612562
2563
2564
2565
2566
2567
2568
2569
25702571
2572
2573
2574
267
Working Draft – IPP System Service v1.0 (SYSTEM) 6 July 2016
Unicode Conformance Model [UTR33] – Unicode conformance basis
11.[12.] Security ConsiderationsThe IPP extensions defined in this document require the same security considerations as defined in the IPP/1.1: Model and Semantics [RFC2911] and PWG System Object and System Control Service Semantics [PWG5108.06].
Implementations of this specification SHOULD conform to the following standard on processing of human-readable Unicode text strings, see:
Unicode Security Mechanisms [UTS39] – detecting and avoiding security attacks
Implementations of this specification are advised to also review the following informational document on processing of human-readable Unicode text strings:
Unicode Security FAQ [UNISECFAQ] – common Unicode security issues
12.[13.] IANA and PWG ConsiderationsTBD
13.[14.] References
13.1[14.1] Normative References
[ACPI] Advanced Configuration and Power Interface Specification Revision 5.0 Errata A, November 2013.http://www.acpi.info/DOWNLOADS/ACPI_5_Errata%20A.pdf
[DSP1027] DMTF Power State Management Profile, DSP1027, December 2009. http://www.dmtf.org/standards/published_documents/DSP1027_2.0.0.pdf
[IANAIPP] IANA IPP Registry, http://www.iana.org/assignments/ipp-registrations/ipp-registrations.xhtml
[IEEE1284] Standard Signaling Method for a Bi-directional Parallel Peripheral Interface for Personal Computers, IEEE 1284, January 2000.
Page 91 of 111 Copyright © 2014-2016 The Printer Working Group. All rights reserved.
2682692575
2576
257725782579
25802581
2582
25832584
2585
2586
2587
2588
2589
2590
259125922593
259425952596
259725982599
26002601
270
Working Draft – IPP System Service v1.0 (SYSTEM) 6 July 2016
[IEEE1621] “Standard for User Interface Elements in Power Control of Electronic Devices Employed in Office/Consumer Environments”, IEEE 1621, December 2004.
[ISO10175-1] T. Hastings et al, “ISO Document Printing Application (DPA) Part 1: Abstract Service Definition and Procedures”, ISO 10175-1, 1996
[ISO10175-3] T. Hastings et al, “ISO Document Printing Application (DPA) Part 3: Management Abstract Service Definition and Procedures”, ISO 10175-1, 1996
[PWG5100.1] M. Sweet, “IPP Finishings 2.0 (FIN)”, PWG5100.1-2014, December 2014,http://ftp.pwg.org/pub/pwg/candidates/cs-ippfinishings20-20141219-5100.1.pdf
[PWG5100.12] R. Bergman, H. Lewis, I. McDonald, M. Sweet, “IPP Version 2.0, 2.1, and 2.2”, PWG 5100.12-2015, work-in-progressOctober 2015,http://ftp.pwg.org/pub/pwg/standards/std-ipp20-20151030-5100.12.pdf
[PWG5100.13] M.Sweet, I. McDonald, P. Zehler, “IPP Job and Printer Extensions – Set 3”, PWG 5100.13-2012, July 2012,http://ftp.pwg.org/pub/pwg/candidates/cs-ippjobprinterext3v10-20120727-5100.13.pdf
[PWG5100.14] M. Sweet, I. McDonald, A. Mitchell, J. Hutchings, “IPP Everywhere”, PWG 5100.14-2013, January 2013,http://ftp.pwg.org/pub/pwg/candidates/cs-ippeve10-20130128-5100.14.pdf
[PWG5100.15] M. Sweet, “IPP FaxOut Service”, PWG 5100.15-2014, June 2014,http://ftp.pwg.org/pub/pwg/candidates/cs-ippfaxout10-20140618-5100.15.pdf
[PWG5100.17] P. Zehler, M. Sweet, “IPP Scan Service”, PWG 5100.17-2014, October 2014, http://ftp.pwg.org/pub/pwg/candidates/cs-ippscan10-20140918-5100.17.pdf
[PWG5100.18] M. Sweet, I. McDonald, “IPP Shared Infrastructure Extensions (INFRA)”, PWG 5100.18-2015, June 2015,http://ftp.pwg.org/pub/pwg/candidates/cs-ippinfra10-20150619-5100.18.pdf
[PWG5105.1] P. Zehler, T. Hastings, S. Albright, “Semantic Model v1.0”, PWG 5105.1-2004, January 2004,http://ftp.pwg.org/pub/pwg/candidates/cs-sm10-20040120-5105.1.pdf
Page 92 of 111 Copyright © 2014-2016 The Printer Working Group. All rights reserved.
271272260226032604
26052606
260726082609
2610261126122613
261426152616
2617261826192620
2621262226232624
262526262627
2628262926302631
2632263326342635
263626372638
273
Working Draft – IPP System Service v1.0 (SYSTEM) 6 July 2016
[PWG5106.1] P. Zehler, H. Lewis, I. McDonald, J. Thrasher, W. Wagner, “Standardized Imaging Counters 1.1”, PWG 5106.1-2007, April 2007,http://ftp.pwg.org/pub/pwg/candidates/cs-wimscount11-20070427-5106.1.pdf
[PWG5106.3] I. McDonald, “Imaging System State and Counter MIB v2”, PWG5106.3-2008, March 2008,ftp://ftp.pwg.org/pub/pwg/candidates/cs-wimscountmib20-20080318-5106.3.pdfftp://ftp.pwg.org/pub/pwg/candidates/cs-wimscountmib20-20080318-5106.3.mib
[PWG5106.4] I. McDonald, “Power Management Model for Imaging Systems 1.0”, PWG 5106.4-2011, February 2011,http://ftp.pwg.org/pub/pwg/general/pwg-process-30.pdf
[PWG5107.2] I. McDonald, “PWG Command Set Format for IEEE 1284 Device ID v1.0”, PWG 5107.2-2010, May 2010,http://ftp.pwg.org/pub/pwg/candidates/cs-pmp1284cmdset10-20100531-5107.2.pdf
[PWG5108.01] W. Wagner, P. Zehler, “MFD Model and Common Semantics”, PWG 5801.01-2011, April 2011,http://ftp.pwg.org/pub/pwg/candidates/cs-sm20-mfdmodel10-20110415-5801.1.pdf
[PWG5108.02] N. Chen, P. Zehler, “Network Scan Service Semantic Model and Service Interface”, PWG 5108.02, April 2009,http://ftp.pwg.org/pub/pwg/candidates/cs-sm20-scan10-20090410-5108.02.pdf
[PWG5108.03] N. Chen, I. McDonald, P. Zehler, “Network Resource Service Semantic Model and Service Interface”, PWG 5108.03, July 2009,http://ftp.pwg.org/pub/pwg/candidates/cs-sm20-resource10-20090703-5108.03.pdf
[PWG5108.05] P. Zehler, “FaxOut Service Semantic Model and Service Interface”, PWG 5108.05-2011, August 2011,http://ftp.pwg.org/pub/pwg/candidates/cs-sm20-faxout10-20110809-5108.05.pdf
[PWG5108.06] P. Zehler, "System Object and System Control Service Semantics", PWG 5108.06-2012, February 2012, http://ftp.pwg.org/pub/pwg/candidates/cs-sm20-system10-20120217-5108.06.pdf
Page 93 of 111 Copyright © 2014-2016 The Printer Working Group. All rights reserved.
2742752639264026412642
264326442645264626472648
264926502651
2652265326542655
2656265726582659
2660266126622663
2664266526662667
2668266926702671
2672267326742675
276
Working Draft – IPP System Service v1.0 (SYSTEM) 6 July 2016
[PWG5109.1] R. Nevo, W. Wagner, “Cloud Imaging Requirements and Model (IMAGINGMODEL)”, PWG 5109.1-2015, June 2015,http://ftp.pwg.org/pub/pwg/candidates/cs-cloudimagingmodel10-20150619-5109.1.pdf
[RFC2119] S. Bradner, "Key words for use in RFCs to Indicate Requirement Levels", RFC 2119/BCP 14, March 1997, http://www.ietf.org/rfc/rfc2119.txt
[RFC2707] R. Bergman, T. Hastings, S. Isaacson, H. Lewis, “Job Monitoring MIB - V1.0, RFC 2707, November 1999,http://www.ietf.org/rfc/rfc2707.txt
[RFC2911] T. Hastings, R. Herriot, R. deBry, S. Isaacson, P. Powell, "Internet Printing Protocol/1.1: Model and Semantics", RFC 2911, September 2000, http://www.ietf.org/rfc/rfc2911.txt
[RFC3380] T. Hastings, R. Herriot, C. Kugler, H. Lewis, “Internet Printing Protocol (IPP): Job and Printer Set Operations”, RFC 3380, September 2002, http://www.ietf.org/rfc/rfc3380.txt
[RFC3382] R. deBry, R. Herriot, T. Hastings, K. Ocke, P. Zehler, "Internet Printing Protocol (IPP): The ‘collection’ Attribute Syntax", RFC 3382, September 2002, http://www.ietf.org/rfc/rfc3382.txt
[RFC3510] R. Herriot, I. McDonald, “Internet Printing Protocol/1.1: IPP URL Scheme”, RFC 3510, April 2003, http://www.ietf.org/rfc/rfc3510.txt
[RFC3805] R. Bergman, H. Lewis, I. McDonald, "Printer MIB v2", RFC 3805, June 2004, http://www.ietf.org/rfc/rfc3805.txt
[RFC3806] R. Bergman, H. Lewis, I. McDonald, "Printer Finishing MIB", RFC 3806, June 2004, http://www.ietf.org/rfc/rfc3806.txt
[RFC3995] R. Herriot, T. Hastings, “Internet Printing Protocol (IPP): Event Notifications and Subscriptions”, RFC 3995, March 2005, http://www.ietf.org/rfc/rfc3995.txt
[RFC3996] R. Herriot, T. Hastings, H. Lewis, “Internet Printing Protocol (IPP): The 'ippget' Delivery Method for Event Notifications”, RFC 3996, March 2005, http://www.ietf.org/rfc/rfc3996.txt
[RFC6350] S. Perreault, “vCard Format Specification”, RFC 6350, August 2011, http://www.ietf.org/rfc/rfc6350.txt
Page 94 of 111 Copyright © 2014-2016 The Printer Working Group. All rights reserved.
2772782676267726782679
268026812682
268326842685
268626872688
268926902691
269226932694
26952696
269726982699
270027012702
270327042705
270627072708
27092710
279
Working Draft – IPP System Service v1.0 (SYSTEM) 6 July 2016
[RFC7472] I. McDonald, M. Sweet, “Internet Printing Protocol (IPP) over HTTPS Transport Binding and the 'ipps' URI Scheme”, RFC 7472, March 2015, http://www.ietf.org/rfc/rfc7472.txt
[UAX9] Unicode Consortium, “Unicode Bidirectional Algorithm”, UAX#9, June 2014,http://www.unicode.org/reports/tr9/tr9-31.html
[UAX14] Unicode Consortium, “Unicode Line Breaking Algorithm”, UAX#14, June 2014,http://www.unicode.org/reports/tr14/tr14-33.html
[UAX15] Unicode Consortium, “Normalization Forms”, UAX#15, June 2014, http://www.unicode.org/reports/tr15/tr15-41.html
[UAX29] Unicode Consortium, “Unicode Text Segmentation”, UAX#29, June 2014, http://www.unicode.org/reports/tr29/tr29-25.html
[UAX31] Unicode Consortium, “Unicode Identifier and Pattern Syntax”, UAX#31, June 2014,http://www.unicode.org/reports/tr31/tr31-21.html
[UNICODE] Unicode Consortium, "Unicode Standard", Version 8.0.0, June 2015, http://unicode.org/versions/Unicode8.0.0/
[UTS10] Unicode Consortium, “Unicode Collation Algorithm”, UTS#10, June 2014,http://www.unicode.org/reports/tr10/tr10-30.html
[UTS35] Unicode Consortium, “Unicode Locale Data Markup Language”, UTS#35, September 2014,http://www.unicode.org/reports/tr35/tr35-37/tr35.html
[UTS39] Unicode Consortium, “Unicode Security Mechanisms”, UTS#39, September 2014,http://www.unicode.org/reports/tr39/tr39-9.html
13.2[14.2] Informative References
[RFC2567] F.D. Wright, “Design Goals for an Internet Printing Protocol”, RFC 2567, April 1999, http://www.ietf.org/rfc/rfc2567.txt
Page 95 of 111 Copyright © 2014-2016 The Printer Working Group. All rights reserved.
280281271127122713
271427152716
271727182719
27202721
272227232724
272527262727
27282729
273027312732
273327342735
273627372738
2739
2740
27412742
282
Working Draft – IPP System Service v1.0 (SYSTEM) 6 July 2016
[RFC5209] P. Sangster, H. Khosravi, M. Mani, K. Narayan, J. Tardo, “Network Endpoint Assessment (NEA): Overview and Requirements”, RFC 5209, June 2008, http://www.ietf.org/rfc/rfc5209.txt
[UTR17] Unicode Consortium “Unicode Character Encoding Model”, UTR#17, November 2008,http://www.unicode.org/reports/tr17/tr17-7.html
[UTR20] Unicode Consortium “Unicode in XML and other Markup Languages”, UTR#20, January 2013,http://www.unicode.org/reports/tr20/tr20-9.html
[UTR23] Unicode Consortium “Unicode Character Property Model”, UTR#23, November 2008,http://www.unicode.org/reports/tr23/tr23-9.html
[UTR33] Unicode Consortium “Unicode Conformance Model”, UTR#33, November 2008,http://www.unicode.org/reports/tr33/tr33-5.html
[UNISECFAQ] Unicode Consortium “Unicode Security FAQ”, November 2013,http://www.unicode.org/faq/security.html
14.[15.] Authors' AddressesPrimary authors:
Ira McDonaldHigh NorthPO Box 221Grand Marais, MI [email protected]
Michael SweetApple Inc.1 Infinite LoopCupertino, CA [email protected]
The authors would also like to thank the following individuals for their contributions to this standards-track document:
Smith Kennedy (HP Inc)William Wagner (TIC)Peter Zehler (Xerox)
Page 96 of 111 Copyright © 2014-2016 The Printer Working Group. All rights reserved.
283284274327442745
274627472748
274927502751
275227532754
275527562757
27582759
2760
2761
27622763276427652766276727682769277027712772
27732774
277527762777
285
Working Draft – IPP System Service v1.0 (SYSTEM) 6 July 2016
15.[16.] Change History
15.1[16.1] 6 July 2016
- Interim draft – changes per IPP WG review on 27 June 2016- global – accepted all changes before section section 7.3.4 power-state-capabilities-col- global – added many comments with design choice notes- global – replaced “*word*” with “word” in BOLD for consistency- global – revised all System, Printer, and Resource status attribute definitions to use “identifies” or “contains” instead of “specifies” (since status attributes always report values rather than allowing them to be set)- global – changes all power state attributes to be (type1 keyword) in order to disallow any vendor unique extension keywords- global – corrected references to former section 7.2.7.7 power state definitions to section 7.2.1 Power States and Policies- revised section 5.3 System State Attributes and Table 2 to rename “power-monitor-col” to “power-state-monitor-col” and combine with former “power-general-col” and “power-meters-col”- revised section 5.4 System Operations and Table 3 to remove document references on “<none>” operation columns and add appropriate footnotes- revised section 5.6 Resource Description Attributes and Table 4 to delete “resource-string-version” and “resource-version”- revised section 5.7 Resource Status Attributes and Table 5 to add “date-time-at-installed” “time-at-installed”, “resource-string-version”, and “resource-version”- revised section 5.7 Resource Status Attributes and Table 5 to add “resource-owner-col”, “resource-string-version”, and “resource-version” and appropriate footnotes- revised section 5.7 Resource Status Attributes and Table 5 to remove document references on “<none>” operation columns and add appropriate footnotes- added section 5.9 Printer Status Attributes and Table 7 for “printer-config-changes” and “printer-service-type”- revised section 6.2 Create-Printer, section 6.3 Create-Resource, and section 7.1 System, Printer, and Resource Operation Attributes to add “requesting-user-vcard” attribute for use in setting “printer-owner-col” and “resource-owner-col” description attributes- added section 7.2.1 Power States and Policies to define all power states (including examples of their typical effect on System activities), their relationships to DMTF CIM and ACPI, their order of power consumption based on DMTF CIM, and examples of their usage (in power policies and in operations such as Restart-System)- revised section 7.2.8.2 event-name to replace vendor name ‘AcmeCrackedCrock’ with ‘ExampleEventName’- revised section 7.2.24 xri-supported member attributes to reference [RFC3380] and use corresponding member attribute names- revised sections 7.2.x power-calendar-policy-col, power-event-policy-col, and power-timeout-policy-col to add commented examples- revised section 7.3.2.4 power-state-message to remove ‘959’, ‘960’, etc. from cut-and-
Page 97 of 111 Copyright © 2014-2016 The Printer Working Group. All rights reserved.
286287
2778
2779
2780278127822783278427852786278727882789279027912792279327942795279627972798279928002801280228032804280528062807280828092810281128122813281428152816281728182819
288
Working Draft – IPP System Service v1.0 (SYSTEM) 6 July 2016
paste from PDF source and add complete example for system shutdown- revised section 7.3.5 power-state-monitor-col to include all attributes from former “power-general-col” and “power-meters-col” collections except for “power-peak-watts” and “previous-month-kwh” and to rename “can-request-power-states” to “valid-request-power-states” (for clarity)- revised section 7.3.5.6 power-state-message to add complete example for system shutdown- revised section 7.3.11 system-configured-subunits to add all member attributes per PWG MFD Model and PWG Imaging System State and Counter MIB v2- revised section 7.6 Resource Description Attributes to add “resource-owner-col” and delete “resource-string-version” and “resource-version”- revised section 7.7 Resource Status Attributes to add “date-time-at-installed”, “time-at-installed”, “resource-string-version”, and “resource-version”- revised section 7.7.14 resource-state-reasons to add ‘installed’ (others are still TBD)- revised section 14.1 Normative References to add [ACPI], DMTF [DSP1027], and [IEEE1621] for power state definitions and semantics and various RFCs and PWG specs for other references- TODO: Design and define “system-totals” as a subset of [PWG5108.06] - TODO: Design and define “resource-authenticator”- ISSUE: Indices for "system-configured-subunits" for multiple output devices?
15.2 23 June 2016
- Interim draft – further updates for collection attributes- completed all System, Printer, and Resource attribute definitions, except for “resource-authenticator” and “system-totals” (both need design work)- kept all redlines from 12 June 2016 version (not yet reviewed)- revised section 5.3 System Status Attributes and Table 2 to to rename “power-counters-col” (obscure) to “power-state-counters-col” (counts of state transitions), rename “power-monitor-col” (obscure) to “power-state-monitor-col” (current System power state), rename “power-state-capability-col” (obscure) to “power-state-capabilities-col” (set of booleans and gauges), and rename “power-state-transition-col” (obscure) to “power-state-transitions-col” (set of valid stable/ephemeral state transitions) - revised section 5.6 Resource Description Attributes and Table 4 to add “resource-owner-col” (for consistency w/ System and Printer objects)- revised section 5.7 Resource Status Attributes and Table 5 to delete “resource-originating-user-name” and “resource-originating-user-uri” (redundant with “resource-owner-col”)- revised section 7.3 System Status Attributes to add “-col” suffix to all power collection attributes and add all member attributes- revised section 7.3 System Status Attributes to rename “power-counters-col” (obscure) to “power-state-counters-col” (counts of state transitions), rename “power-monitor-col” (obscure) to “power-state-monitor-col” (current System power state), and rename “power-state-capability-col” (obscure) to “power-state-capabilities-col” (set of booleans and gauges)- revised section 7.3.1 power-general-col to add all member attributes
Page 98 of 111 Copyright © 2014-2016 The Printer Working Group. All rights reserved.
28929028202821282228232824282528262827282828292830283128322833283428352836283728382839
2840
28412842284328442845284628472848284928502851285228532854285528562857285828592860286128622863
291
Working Draft – IPP System Service v1.0 (SYSTEM) 6 July 2016
- revised section 7.3.2 power-log-col to add all member attributes, except for PowerComponentType and PowerComponentReferenceId (used for Subunits in power model)- revised section 7.3.3 power-meters-col to add all member attributes- revised section 7.3.4 power-state-capabilities-col to add all member attributes, except for CanUseInterfaces (used for Interface subunits in power model)- revised section 7.3.5 power-state-counters-col to add all member attributes- revised section 7.3.6 power-state-monitor-col to add all member attributes- revised section 7.3.7 power-state-transitions-col to add all member attributes- revised section 7.3.11 system-configured-printers to add all member attributes- revised section 7.3.12 system-configured-resources to add all member attributes- revised section 7.6 Resource Description Attributes to define all group attributes- revised section 7.6 Resource Description Attributes to add “resource-owner-col” (for consistency w/ System and Printer objects- revised section 7.7 Resource Status Attributes to define all group attributes, except for “resource-authenticator” (hash/signature for verification of Resource data) as this needs some design discussion- revised section 7.7 Resource Status Attributes to delete “resource-originating-user-name” and “resource-originating-user-uri” (redundant with “resource-owner-col”)- TODO: Design and define “system-totals” as a subset of [PWG5108.06] - TODO: Design and define “resource-authenticator”
15.3[16.2] 12 June 2016
- Interim draft – changes per IPP WG review on 9 May 2016- accepted all previous changes through end of section 7.3 System Status Attributes- revised section 5.2 System Description Attributes and Table 1 to clarify note 4 about Set-System-Attributes- revised section 5.2 System Description Attributes and Table 1 to clarify note 6 about Set-System-Attributes and change “equivalent” to “analogous” and add full title of [RFC3380].- revised section 5.2 System Description Attributes and Table 1 to add “resource-settable-attributes-supported” and corresponding new note 7 (for consistency w/ System and Printer objects)- revised section 5.3 System Status Attributes and Table 2 to change to “<none>[8]” for system-state-change-[date-time|time]- revised section 5.3 System Status Attributes and Table 2 to clarify note 8 about configuration and state changes- revised section 5.3 System Status Attributes and Table 2 to clarify notes 7 and 9 and add full title of [PWG5100.13]- revised section 5.4 System Operations and Table 3 to move note [7] reference to correct column- revised section 5.8 Printer Description Attributes and Table 6 to change “printer-owner” to “printer-owner-col” and add note 1 about Set-Printer-Attributes coherence of “owner-uri” and “owner-vcard” member attributes.- revised section 6.2 Create-Printer to delete redundant “and”, missing hyphen in “print-color-mode-supported”, and add quotes around attribute names in final note
Page 99 of 111 Copyright © 2014-2016 The Printer Working Group. All rights reserved.
292293286428652866286728682869287028712872287328742875287628772878287928802881288228832884
2885
2886288728882889289028912892289328942895289628972898289929002901290229032904290529062907
294
Working Draft – IPP System Service v1.0 (SYSTEM) 6 July 2016
- revised section 6.14 Get-System-Supported-Values to correct name from “Settable” to “Supported” and to correct reference to Get-Printer-Supported-Values in [RFC3380].- revised section 7.2 System Description Attributes first paragraph to remove redundancy- revised section 7.2 System Description Attributes to add “resource-settable-attributes-supported” (for consistency w/ System and Printer objects)- accepted all changes in section 7.2.7 power-calendar-policy-col and put all member attributes in alphabetical order, clarified first values (zero or one), and removed redundancy in descriptions- renamed section 7.2.7.1 policy-id to calendar-id for consistency with [PWG5106.4]- revised section 7.2.7.3 day-of-week (now integer) to delete previous keyword values- revised section 7.2.7.7 request-power-state to separate stable states and ephemeral (transitional) states into two lists of standard keywords for clarity- revised section 7.2.8 power-event-policy-col to add all member attributes- revised section 7.2.9 power-event-policy-col to add all member attributes- revised section 7.2.24 system-xri-supported to add all member attributes- revised section 7.4 Printer Description Attributes first paragraph to remove redundancy- revised section 7.4 Printer Description Attributes to add “printer-owner-col”, “owner-uri”, and “owner-vcard” attributes- revised section 7.5 Printer Status Attributes to add “printer-config-changes” attribute per PWG F2F review on 26 April 2016- revised section 7.6 Resource Description Attributes first paragraph to remove redundancy- revised section 14.1 Normative References to correct reference to PWG 5100.12 per PWG F2F review on 26 April 2016
15.4[16.3] 9 May 2016
- Interim draft – changes per PWG F2F review on 26 April 2016- revised section 7.2.7.1 to rename “power-calendar-policy-id” to “policy-id”- revised section 7.2.7.2 request-power-state to delete ‘other’ (invalid) and ‘unknown’ (out-of-band value)- revised section 7.2.7.4 day-of-week to change syntax to “integer(1:7)”- revised section 7.2.7.5 month to change syntax to “integer(1:12)”- revised section 7.2.7.6 to rename “day” to “day-of-month” and correct integer syntax- revised section 7.2.7.7 hour and section 7.2.6.8 minute to correct integer syntax- revised section 7.2.7.7 hour to add note about local time zone changes (summer time to standard time or vice versa) and the possibility that a given hour will not occur.
15.5[16.4] 8 May 2016
- Interim draft – changes per PWG F2F review on 26 April 2016- revised section 3.2.5 Bootstrap Client Access to Default Print Service to use “ipp://printer12.example.com/ipp/print” for discovered default Print Service- revised section 5 IPP System and Resource Objects and Operations to add note about tables listing only top-level attributes and forward reference collection member attributes in section 7
Page 100 of 111 Copyright © 2014-2016 The Printer Working Group. All rights reserved.
295296290829092910291129122913291429152916291729182919292029212922292329242925292629272928292929302931
2932
2933293429352936293729382939294029412942
2943
29442945294629472948
297
Working Draft – IPP System Service v1.0 (SYSTEM) 6 July 2016
- revised section 5.2 System Description Attibutes Table 1 to add “system-settable-attributes-supported”, “system-strings-languages-supported”, and “system-strings-uri” and delete “system-health”- revised section 5.2 System Description Attibutes Table 1 to rename “system-owner-uri” to “system-owner-col” (collection) and make it REQUIRED and delete “system-owner-vcard” - revised section 5.2 System Description Attibutes Table 1 to add “-col” suffix to all power model collection attributes for consistency- revised section 5.3 System Status Attributes Table 2 to also add “-col” suffix to all power model collection attributes for consistency- revised section 5.4 System Operations Table 3 to add Get-System-Supported-Values- revised section 6.2 Create-Printer to note that Subunits are also associated by configured service capabilities – intent and not explicit listing- revised section 6 IPP Operations to add REQUIRED Get-System-Supported-Values for newly REQUIRED Set-System-Attributes operation- revised section 6 IPP Operations definition of Set-System-Attributes to include forward reference to “system-strings-languages-supported” and “system-strings-uri” for Client localization.- revised section 7.2 System Description Attributes to add “system-settable-attributes-supported”, “system-strings-languages-supported”, and “system-strings-uri”and add “-col” suffix to all power model collection attributes for consistency and delete “system-health”- revised section 7.2.7 power-calendar-policy-col to change all enums to keywords- revised section 7.2.19 system-owner-col to changed to REQUIRED- revised section 7.3.10 system-config-changes to clarify semantics and state a System MUST reset to zero when a power cycle occurs (from ‘off’ to ‘on’).
15.6[16.5] 25 April 2016
- Interim draft – changes per IPP WG review on 29 February 2016- global – accepted all redlines from previous versions up to end of section 7.3- global – changed “out-of-band value defined in [RFC2910]” to “out-of-band value defined in [RFC2911]”- revised section 2.3 Printing Terminology to add references for every definition- revised section 3.2.5 Bootstrap Client Access to Default Print Service to use explicit IPv4 address to query the System Service listening to port 631 for the default print service URI- revised section 5.2 System Description Attibutes Table 1 to rename “natural-language-supported” to “generated-natural-language-supported” for consistency with RFC 2911- revised section 5.2 System Description Attibutes Table 1 to add “system-current-time”- revised section 5.3 System Status Attributes Table 2 to add system-config-change-date-time, system-config-change-time, system-state-change-date-time, and system-state-change-time- revised section 5.3 System Status Attributes Table 2 to delete “system-current-time”- revised section 5.3 System Status Attributes Table 2 to to rename “power-support” to “power-state-capability” and “power-transition” to “power-state-transition” for clarity- revised section 7.2 System Description Attribues to explicitly mention Set-System-Attributes operation and “system-settable-attributes-supported”
Page 101 of 111 Copyright © 2014-2016 The Printer Working Group. All rights reserved.
2982992949295029512952295329542955295629572958295929602961296229632964296529662967296829692970297129722973
2974
297529762977297829792980298129822983298429852986298729882989299029912992
300
Working Draft – IPP System Service v1.0 (SYSTEM) 6 July 2016
- revised section 7.2.4 natural-language-configured to restrict scope to only System-generated attribute values.- revised section 7.2.5 to rename “natural-language-supported” to “generated-natural-language-supported” for consistency with RFC 2911 and restored text about a System accepting any natural language value.- revised section 7.2.7 power-calendar-policy to define power-calendar-policy-col and all member attributes- revised section 7.2.10 system-default-printer-uri and section 6.2 Create-Printer to clarify that when the first Print Service is created on a System, the System MUST set the value of “system-default-printer-uri”- revised section 7.2.12 system-geo-location to delete trailing fragment- revised section- added section 7.2.18 system-owner (collection) to include “system-owner-uri” and “system-owner-vcard” and provide extensibility for additional System Owner metadata- revised section 7.3 System Status Attributes to add “system-config-change-date-time”, “system-config-change-time”, “system-state-change-date-time”, and “system-state-change-time”- revised section 7.3.6 to rename “power-support” to “power-state-capability” for clarity- revised section 7.3.7 to rename “power-transition” to “power-state-transition” for clarity- revised section 7.3.8 system-config-changes to clarify that the System MUST increment the value each time an attribute value is changed with a Set-System-Attributes operation.- moved section 7.3.12 system-current-time to section 7.2 System Description Attributes
15.7[16.6] 28 February 2016
- Interim draft – changes per PWG F2F review on 10 February 2016- global – kept some redlines from previous versions for review by IPP WG- global – changed “as described in [xxx]” to “defined in [xxx]” for clarity- global – manually changed lowercase “ system Administrator” to titlecase “ Administrator”, lowercase “ operator” to titlecase “ Operator”, and standalone “ user” or “ User” to titlecase “ End User” - global – changed “specifies [a/the] list of” to simply “lists”- global – accepted all redlines in section 7.1 System, Printer, and Resource Operation Attributes, section 7.2 System Description Attributes, and section 7.3 System Status Attributes up through section 7.3.13 system-health before making current changes for readability- revised section 2.3 Printing Terminology to add definitions of Administrator, End User, and Operator from RFC 2911bis (taken from RFC 2567) and Delivery Method, Event Notification, Notification, Owner, Resource, and Subscription (taken from PWG 5108.01, PWG 5108.03, or RFC 3995)- added section 3.2.5 Bootstrapping Client Access to Default Print Service and added cross-reference to section 7.2.10 system-default-printer-uri- revised section 7.1 System, Printer, and Resource Operation Attributes, section 7.2 System Description Attributes, and section 7.3 System Status Attributes to attach second sentence (semantic equivalence or analogy) to first sentence for clarity
Page 102 of 111 Copyright © 2014-2016 The Printer Working Group. All rights reserved.
3013022993299429952996299729982999300030013002300330043005300630073008300930103011301230133014
3016
30173018301930203021302230233024302530263027302830293030303130323033303430353036
303
Working Draft – IPP System Service v1.0 (SYSTEM) 6 July 2016
- revised sections 7.2.7, 7.2.8, and 7.2.9 to add “-policy” suffix to “power-calendar”, “power-event”, and “power-timeout” collection System Description attributes - revised section 7.2.10 system-default-printer-uri to change syntax to “(uri | no-value”)- revised section 7.2.11 system-geo-location to change syntax to “(uri | unknown)”- revised section 14.2 Informative References to add RFC 2567
15.8[16.7] 17 January 2016
- Interim draft – changes per IPP WG reviews on 7 December 2015 and 4 January 2016- global – kept most redlines from previous versions for review by IPP WG- global – revised section 6 IPP Operations to delete trailing document references after every operation request and operation response attribute for clarity- global – revised section 7.1 System, Printer, and Resource Operation Attributes to further simplify and clarify filter text- revised section 5.4 System Operations and section 6 IPP Operations to delete redundant and ambiguous Restart-All-Printers and Restart-One-Printer operations (use Shutdown and Startup instead)- revised section 6 IPP Operations to add note that all operation requests and responses use standard operation parameters defined in [RFC2911] and encoded in [RFC2910]- revised section 6 IPP Operations definition of Get-Printers to add note that it is an End User operation and does NOT require Client authentication, but MAY be encrypted and another note that requested-attributes is limited to the LDAP Printer Schema [RFC7612] and if request-attributes is missing, then the System MUST only return printer-uri-supported, uri-authentication-supported, and uri-security-supported.- revised section 6 IPP Operations definition of Get-Resources to add note that it is an Administrator operation and requires Client authentication.- revised section 6 IPP Operations definition of Get-Printers to change operation attribute printer-service-type to ‘1setOf’ (for Get-Printers)- revised section 6 IPP Operations definition of Startup-All-Printers and Startup-One-Printer to remove reference to RFC 3998 Startup-Printer- revised section 6 IPP Operations definition of Create-Printer, Create-Resources, Get-Printers, Startup-All-Printers responses to delete status-code (parameter, not an attribute) and move attributes-charset/attributes-natural-language before status-message- revised section 7.1 System, Printer, and Resource Operation Attributes to delete redundant printer-service-types, to change operation attribute printer-service-type to ‘1setOf’ (for Get-Printers), and to move values to section 7.7 System Status Attributes printer-service-type- revised section 7.1 System, Printer, and Resource Operation Attributes to references to Create-Resource/Send-Resource-Data when appropriate- revised section 7.1 System, Printer, and Resource Operation Attributes resource-k-octets to correct forward reference to section 7.7- - revised section 7.1 System, Printer, and Resource Operation Attributes which-printers to clarify ‘all’ and ‘stopped’ and add ‘shutdown’ and ‘testing’ to harmonize with MFD Model and IETF Host Resources MIB [RFC2790]
Page 103 of 111 Copyright © 2014-2016 The Printer Working Group. All rights reserved.
30430530373038303930403041
3042
304330443045304630473048304930503051305230533054305530563057305830593060306130623063306430653066306730683069307030713072307330743075307630773078
306
Working Draft – IPP System Service v1.0 (SYSTEM) 6 July 2016
15.9[16.8] 6 December 2015
- Interim draft – new content after IPP WG review on 5 October 2015- global – kept all redlines from previous versions for review by IPP WG - revised section 6 IPP Operations to define Startup-All-Printers (prototype for all other Xxx-All-Printers operation attributes), Startup-One-Printer (prototype for all other Xxx-One-Printer operation attributes), Create-Printer, Create-Resource, Delete-Printer, Disable-All-Printers, Enable-All-Printers, Get-Printer-Attributes, Pause-All-Printers, Restart-All-Printers, Restart-One-Printer, Resume-All-Printers, Shutdown-All-Printers, Shutdown-One-Printer- revised section 7.7 Resource Status Attributes to define resource-state (to be reviewed by IPP WG since the Resource object has unique states)
15.10[16.9] 2 November 2015
- Interim draft – new content after IPP WG review on 5 October 2015- global – kept all redlines from previous version for review at PWG November F2F- revised section 7.1 System, Printer, and Resource Operation Attributes to add Resource operation attributes resource-category, resource-format, resource-id, resource-job-id, resource-k-octets, resource-printer-uri, resource-state, and resource-type- revised section 7.3 System Status Attributes to add power-counters, power-general, power-log, power-meters, power-monitor, power-support, power-transition, system-config-changes, system-configured-printers, system-configured-resources, system-configured-subunits, system-current-time, system-health, system-serial-number, system-state, system-state-messages, system-state-reasons, system-totals, system-up-time, and system-uuid
15.11[16.10] 18 October 2015
- Interim draft – changes per IPP WG review on 5 October 2015- global - accepted all changes up to and through section 6.9 (from previous review)- revised section 7.1 title to “System, Printer, and Resource Operation Attributes” to allow for Printer operation attributes in future such as “printer-service-type” for Create-Printer- revised sections 7.1.x to change “filters the set of Printers” to “specifies a filter for the applicable Printers”- added section 7.1.3 printer-service-type for Create-Printer operation- revised section 7.1.4 printer-service-types to change “Service Type attribute” to “Service Type element”, add forward reference to “printer-service-type” in section 7.5 Printer Status Attributes, and add emailin, emailout, and faxin (references to PWG 5108.01 and RFC 2707)- revised section 7.1.5 resource-id to add forward reference to “resource-id” in section 7.7 Resource Status Attributes- revised section 7.1.11 system-uri to change “attribute the target” to “attribute specifies the target”- revised section 7.1.12 which-printers to change "This attribute and is" to “This attribute is”
Page 104 of 111 Copyright © 2014-2016 The Printer Working Group. All rights reserved.
307308
3079
3080308130823083308430853086308730883089
3090
30913092309330943095309630973098309931003101
3102
3103310431053106310731083109311031113112311331143115311631173118
309
Working Draft – IPP System Service v1.0 (SYSTEM) 6 July 2016
(drop “and”)- revised section 14 References to accept all changes and add PWG Job Monitoring MIB (RFC 2707)
15.12[16.11] 20 September 2015
- Interim draft - changes per PWG F2F review on 31 August 2015- global - accepted all changes up to and through section 6.9 (from previous review)- revised Abstract and section 1 Introduction to add explicit references to Cloud & Infra- deleted section 5.2 System Operation Attributes and section 5.7 Resource Operation Attributes- added section 5.8 Printer Description Attributes and table for “printer-owner-[uri|vcard]”- revised section 6.9.1 Get-Printers Request to make “attributes-charset” and “attributes-natural-language” REQUIRED for Client (per RFC 2911)- revised section 6.9.1 Get-Printers Request to add note to “requested-attributes” about the primary Printer attributes in the IETF LDAP Printer Schema (RFC 7612)- revised section 7,2 System Description Attributes to add new attribute definitions- revised section 14.1 Normative References to add references for new attribute definitions
15.13[16.12] 31 August 2015
- Interim draft – changes per PWG F2F review on 10 August 2015- global – deleted redundant “new” and “now” and “below” in several dozen places- revised Table of Contents to delete List of Figures (all now deleted in this version)- revised section 2.2 Protocol Role Terminology to correct “Infrastructure System” from “PWG5109.CLOUD” to “PWG5109.1”, add “Printer”, and correct typos in “Protocol Endpoint”- revised section 2.2 Protocol Role Terminology to add references to IPP INFRA (PWG 5100.18) to “Infrastructure Printer”, “Infrastructure System”, and “Proxy”- revised section 2.3 Printing Terminology to add “Printer” (synonym for “Imaging Service”) with RFC 2911 reference- revised section 3.1 Rationale for the IPP System Service to correct title of IPP/2.0- revised section 3.1 Rationale for the IPP System Service to add paragraphs for IPP INFRA [PWG5100.18] and Cloud Imaging Model [PWG5109.1]- revised section 5 IPP System and Resource Objects and Operations for clarity and deleted redundant Figure 1 through Figure 4 (PWG SM abstract objects) and text- revised section 5.1 System Attribute Groups and section 5.6 Resource Attribute Groups titles to be singular (only one of each)- revised section 5.2 System Operation Attributes and section 5.7 Resource Operation Attributes to be just forward references to section 7.1 System and Resource Operation Attributes- revised section 5.3 System Description Attributes Table 1 and section 7.2 System Description Attributes to add “system-default-printer-uri” to support the enhanced “Get-Printer-Attributes” operation- revised and reordered (alphabetized) section 5.3 System Description Attributes Table 1
Page 105 of 111 Copyright © 2014-2016 The Printer Working Group. All rights reserved.
310311311931203121
3122
312331243125312631273128312931303131313231333134
3135
313631373138313931403141314231433144314531463147314831493150315131523153315431553156315731583159
312
Working Draft – IPP System Service v1.0 (SYSTEM) 6 July 2016
and section 7.2 System Description Attributes to insert “system” prefix on several attributes for consistency with Printer object in RFC 2911- revised and reordered (alphabetized) section 5.4 System Status Attributes Table 2 and section 7.3 System Status Attributes to insert “system” prefix on several attributes and add “system-up-time”for consistency with Printer object in RFC 2911- revised section 5.5 System Operations Table 3 to add missing references and change “Cancel-Subscriptions” and “Renew-Subscriptions” to singular per RFC 3995- revised section 5.5 System Operations Table 3 to update note for Create-Resource and add note for Create-Printer referring to the semantically equivalent Create operation in ISO 10175-3- revised section 5.5 System Operations Table 3 to add note that Register-Output-Device is semantically equivalent to Register-System in PWG 5109.1 (with differences explained)- revised section 5.9 Resource Status Attributes Table 5 to add note for “resource-id” analogous to “job-id” in RFC 2911.- revised section 5.9 Resource Status Attributes Table 5 to add note for “resource-k-octets” analogous to “job-k-octets” in RFC 2911.- revised section 5.9 Resource Status Attributes Table 5 to add notes for “resource-job-id” and “resource-printer-uri” which are requried for Job and Printer scoped Resource objects, respectively- revised section 5.9 Resource Status Attributes Table 5 to add “resource-authenticator” for verification of Resource data after a Send-Resource-Data operation- deleted redundant sections 6.x Cancel-Subscription, Get-Notifications, Get-Printer-Attributes, and Renew-Subscription and moved to sections 8.x for existing operations with new semantics- revised section 6.x Get-Printers to change “selected” to “matching” and make sure that each attribute has a colon (:) at the end and put the reference(s) at the end of each attribute name - revised section 6.x Get-Printers to use “the Client [MUST|SHOULD|MAY] supply and the System MUST support” for clarity – “OPTIONALLY” is NOT a defined conformance keyword- revised section 6.x Get-Printers and section 7.1.x “printer-geo-location” to remove ‘unknown’ value (never appropriate in this specification)- revised section 6.x Get-Printers and section 7.1.x “printer-service-types” to change singular to plural (i.e., multiple printers can be chosen by the filter)- revised sections 6.x Get-Resources and Get-Resource-Attributes to note that they are modeled on Get-Jobs and Get-Job-Attributes with default returns of “resource-id” and “resource-state”- revised section 6.x Get-System-Attributes to note that it is modeled on Get-Printer-Attributes with default return of all System attributes- revised section 7.1 title to be “System and Resource Operation Attributes” (since some apply to operations on both objects)- revised section 7.1.x to change “selects” to “filters” and “selected” to “matching” for clarity- added sections 7.1.x for “resource-category”, “resource-id”, “resource-job-id”, “resource-printer-uri”, “resource-state”, and “resource-type” operation attributes- revised section 14.1 Normative References to update IPP/2.0 title and reference (work-in-progress) and add IPP INFRA (PWG 5100.18-2015) and Cloud Imaging Model (PWG
Page 106 of 111 Copyright © 2014-2016 The Printer Working Group. All rights reserved.
3133143160316131623163316431653166316731683169317031713172317331743175317631773178317931803181318231833184318531863187318831893190319131923193319431953196319731983199320032013202320332043205
315
Working Draft – IPP System Service v1.0 (SYSTEM) 6 July 2016
5109.1-2015)
15.14[16.13] 10 August 2015
- Interim draft – changes per PWG F2F review on 29 April 2015- global – added working notes from PWG F2F at appropriate operations and attributes to capture discussion and agreements- revised Abstract and section 1 Introduction to say “support registration of an IPP System, through its IPP Proxy, with one or more Cloud Imaging Systems”- revised section 1.1 Rationale for two IPP Protocol Endpoints to titlecase “Protocol Endpoint” in first paragraph- revised section 2.2 Protocol Role Terminology, to add “Endpoint” (whole computing device) from IETF NEA Overview [RFC5209], clarify “Infrastructure System”, and rewrite “Protocol Endpoint” (an application interface) based on standard IETF usage.- revised section 3.4 Out-of-Scope to add support for any non-IPP Cloud Imaging System.- revised section 5.3 System Description Attributes to delete issue about cardinality of “owner-uri” and “owner-vcard” (they are single-valued) and to remove Register-System operation from Table 1 Note 4- revised section 5.5 System Operations Table 3 to replace “Cancel-Xxx-Subscriptions” with “Cancel-Subscriptions” and “Renew-Xxx-Subscriptions” with “Renew-Subscriptions” and reference RFC 3995- revised section 5.5 System Operations Table 3 to delete “Renew-Resource”, add “Get-Subscriptions” and “Get-Subscription-Attributes, and replace “Get-Xxx-Notifications” with “Get-Notifications” and reference RFC 3996- revised section 5.5 System Operations Table 3 to add new “Install-Resource” operation to activate (for use) firmware, software, fonts, etc. after Create-Resource and Send-Resource-Data have completed- added section 5.6 Resource Attribute Groups- added section 5.7 Resource Operation Attributes- added section 5.8 Resource Description Attributes and Table 4- added section 5.9 Resource Status Attributes and Table 5- revised sections 6.x to align with current set of operations- added section 6.x Get-Printers in complete detail for review- added section 7 New IPP Attributes and sections 7.x for all System and Resource operation, description, and status attributes- revised sections 14.x to add or update several references
15.15[16.14] 28 April 2015
- Interim draft – changes per IPP WG review on 30 March 2015- global – replaced “IPP System Control Service” with “IPP System Service” (but NOT in the abstract PWG equivalent), per IPP WG review- global – replaced titlecase “Object” with lowercase “object” (except in section title or PWG SM spec titles), per IPP WG review
Page 107 of 111 Copyright © 2014-2016 The Printer Working Group. All rights reserved.
3163173206
3208
32093210321132123213321432153216321732183219322032213222322332243225322632273228322932303231323232333234323532363237323832393240
3241
32423243324432453246
318
Working Draft – IPP System Service v1.0 (SYSTEM) 6 July 2016
- revised Abstract to change “[PWG510x.y]” document references to “(PWG 510x.y)”, consistent with IETF RFC styles and change “Cloud Imaging services” to “Cloud Imaging Systems”, per IPP WG review- revised section 1 Introduction to replace with expanded scope text from Abstract, per IPP WG review- revised section 1.1 Rationale for two IPP Protocol Endpoints to clarify that a conforming IPP System Service supports both a URI for an IPP System object and a separate URI for the implementation defined “default” IPP Printer returned from Get-Printer-Attributes, per IPP WG review- revised section 2.2 Protocol Role Terminology to add definitions of Infrastructure System and Protocol Endpoint, remove the “IPP” prefix from the definitions of Client, Infrastructure Printer, Proxy, and System terms, and enhance the definition of Proxy, per IPP WG review- revised section 3.1 Rationale for the IPP System Service, to replace period “.” with semi-colon “;” in non-terminal members of both numbered lists, per IPP WG review- revised section 5.3 System Description Attributes in Table 1 to change owner-uri from RECOMMENDED to CONDITIONALLY REQUIRED and owner-vcard from OPTIONAL to CONDITIONALLY REQUIRED for systems that support the Set-System-Attributes and Register-System operations and added issue about possible multi-valued ordered sets for multiple owners (whose semantics are presently undefined in any PWG spec), per IPP WG review- revised section 5.4 System Status Attributes in Table 2, note (7) to delete sentence about already removed device-uuid attribute, per IPP WG review- revised section 5.5 System Operations to add Create/Cancel/Renew-Resource-Subscriptions, Create/Cancel/Renew-System-Subscriptions, Get-Notifications, Get-Printer-Attributes (for implementation-defined “default” Printer), RestartSystem (for restart with existing or new firmware Resource for remediation based on health monitoring), and to divide original StoreResource into Create-Resource and Send-Resource-Data (to correct scope ambiguity of original PWG Resource Service operation), per IPP WG review- added (blank placeholder) section 10.2 Conformance Requirements for Infrastructure Systems, per IPP WG review- revised section 11 Internationalization Considerations to add new Unicode boilerplate from JDFMAP, per IPP WG review- revised section 12 Security Considerations to add new Unicode boilerplate from JDFMAP, per IPP WG review- revised section 14.1 Normative References and section 14.2 Informative References to add new Unicode boilerplate specs from JDFMAP, per IPP WG review- TODO – add various spec references, per IPP WG review
15.16[16.15] 15 March 2015
- Interim draft – changes per PWG F2F and IPP WG reviews on 4 November 2014, 17 November 2014, 19 January 2015, and 3 February 2015- revised title to “IPP System Service”, per IPP WG review on 4 November 2014- revised Abstract to include management and status of Services, Subunits, and Resources and Cloud registration extensions, per IPP WG review on 4 November 2014- revised section 1.1 Rationale for two IPP Protocol Endpoint to mention of inclusion of
Page 108 of 111 Copyright © 2014-2016 The Printer Working Group. All rights reserved.
3193203247324832493250325132523253325432553256325732583259326032613262326332643265326632673268326932703271327232733274327532763277327832793280328132823283
3284
328532863287328832893290
321
Working Draft – IPP System Service v1.0 (SYSTEM) 6 July 2016
original Get-Printer-Attributes that automatically selects the implementation-defined or site-defined “default” IPP Printer object for the convenience of existing IPP Clients, per IPP WG review on 4 November 2014- revised section 2.2 Protocol Role Terminology to add definitions of Infrastructure Printer and IPP Proxy from IPP Shared Infrastructure Extensions, per IPP WG review on 3 February 2015- revised section 2.3 Printing Terminology to delete Resource Service and revise the definitions of Spooling Service and Streaming Service, per IPP WG review on 4 November 2014- revised section 2.3 Printing Terminology to add definitions of Logical Device, Output Device, and Physical Device from IPP Shared Infrastructure Extensions, per IPP WG review on 3 February 2015 - renamed section 2.4 from “Acronyms and Organizations” to simply “Abbreviations”, for consistency with RFC 7472, per RFC Editor on 5 March 2015- revised section 3.1 Rationale for the IPP System Service to add the Resource Service functionality (objects, operations, and attributes), per IPP WG review on 4 November 2014- added new use case in section 3.2.4 Resource Management, per IPP WG review on 4 November 2014- revised section 3.4 Out-of-Scope, to delete creation/deletion of Imaging Services, per IPP WG review on 3 February 2015- revised section 3.5 Design Requirements, to add Resource object, per IPP WG review on 4 November 2014- added section 4.6 Resource Service, to add Resource object, per IPP WG review on 4 November 2014- revised section 5.1 Attribute Groups to define the system-attributes-tag and resource-attributes-tag, per IPP WG review on 19 January 2015- revised section 5.2 Operation Attributes to define system-uri and resource-uri, per IPP WG review on 19 January 2015- revised title of section 5.3 to System Description Attributes, per IPP WG review on 19 January 2015- revised section 5.3 System Description Attributes in Table 1 to raise owner-uri from OPTIONAL to RECOMMENDED, per IPP WG review on 19 January 2015- revised section 5.3 System Description Attributes to delete redundant original Figure 3 and Figure 4, per IPP WG review on 19 January 2015- revised title of section 5.4 to System Status Attributes, per IPP WG review on 19 January 2015- revised section 5.4 to System Status Attributes in Table 2 to delete redundant device-uuid, per IPP WG review on 19 January 2015- revised section 5.4 to System Status Attributes to delete redundant original Figure 4, Figure 5, Figure 6, and Figure 7, per IPP WG review on 19 January 2015- revised section 5.5 System Operations to delete issue about Subscription operations, per IPP WG review on 3 February 2015- revised section 5.5 System Operations in Table 3 to add Create/Delete-Printer and Resource operations, per IPP WG review on 3 February 2015
Page 109 of 111 Copyright © 2014-2016 The Printer Working Group. All rights reserved.
32232332913292329332943295329632973298329933003301330233033304330533063307330833093310331133123313331433153316331733183319332033213322332333243325332633273328332933303331333233333334
324
Working Draft – IPP System Service v1.0 (SYSTEM) 6 July 2016
15.17[16.16] 2 November 2014
- Interim draft – changes per IPP WG review on 29 September 2014- corrected typos and wording- revised cover page and headers to change “IPPSYSTEM” to “SYSTEM”, per IPP WG review- globally changed “Imaging Device” to “Imaging System” where appropriate (most instances), per IPP WG review- globally changed “[RFC2616]” to “[RFC7230]”, per IPP WG review- globally changed “[PWG5100.SCAN]” to “PWG5100.17]” and corrected reference in section 10.1, per PWG approval of IPP Scan Service- added section 1.1 Rationale for two IPP Protocol Endpoints to explain the reason for separate URI for System and Printer objects, per IPP WG review- revised section 2.2 to change title from “Printing Terminology” to “Protocol Roles”, per IPP WG review- revised section 2.2 to delete “IPP Printer” (and thus Logical Device and Physical Device definitions and details) as not applicable to System Control Service and to add “IPP System”, per IPP WG review- revised section 2.3 to change title from “Other Terminology” to “Printing Terminology”, per IPP WG review- moved first sentence of section 2.2 (sources of terms) to section 2.3, per IPP WG review- revised section 2.3 to add new terms, including “Document”, “FaxOut Job/Service”, “ith”, “Job”, “Print Job/Service”, “Scan Job/Service”, “Spooling Service”, “Streaming Service”, “Subunit”, “Transform Job/Service”, per IPP WG review- revised section 2.3 to improve “Imaging System” definition, per IPP WG review- revised section 3.1 Rationale to clarify various paragraphs and add numbered lists, per IPP WG review- revised section 3.2 Use Cases to clarify various paragraphs, per IPP WG review- revised section 3.3 to change “TBD” to “There are no exceptions to the use cases defined in section 3.2”, per IPP WG review- revised section 3.4 Out of Scope to clarify first sentence, per IPP WG review- revised section 3.4 Out of Scope to clarify several statements, per IPP WG review- revised section 3.4 Design Requirements to clarify first sentence, per IPP WG review- added section 4.5 Document Object, per IPP WG review- revised section 5.3 System Description to change “READ-ONLY” to “READ-WRITE” (because Set-System-Attributes was restored in this draft), per IPP WG review and Cloud Imaging WG recommendations- revised section 5.4 System Status to clarify the “READ-ONLY” cannot be modified by a Set-System-Attributes operation, per IPP WG review and Cloud Imaging WG recommendations- revised section 5.4 System Status to clarify the meaning of “system-uuid” (SCS), “printer-uuid” (Imaging Service), and “device-uuid” (physical hardware, i.e., network device), per IPP WG review- revised section 5.4 System Status Table 2 to change “configured-services” to “configured-printers”, per IPP WG review- revised section 5.5 System Operations Table 3 to add back Restart-One-Printer, Startup-
Page 110 of 111 Copyright © 2014-2016 The Printer Working Group. All rights reserved.
325326
3335
33363337333833393340334133423343334433453346334733483349335033513352335333543355335633573358335933603361336233633364336533663367336833693370337133723373337433753376337733783379
327
Working Draft – IPP System Service v1.0 (SYSTEM) 6 July 2016
One-Printer, Shutdown-One-Printer, and Set-System-Elements, per IPP WG review and Cloud Imaging WG recommendations- revised section 6 New IPP Operations to add back Restart-One-Printer, Startup-One-Printer, Shutdown-One-Printer, and Set-System-Elements, per IPP WG review and Cloud Imaging WG recommendations- revised section 8.1 title to add “Create-Subscription” operation, per IPP WG review- revised section 13 to change title from “IANA Considerations” to “IANA and PWG Considerations”, per IPP WG review
15.18[16.17] 24 August 2014
- Interim draft- corrected typos and wording- revised section 5.3 and added Table 1 – Attributes in IPP System Description group with notes for rationale of all conformance requirements- revised section 5.4 and added Table 2 – Attributes in IPP System Status group with notes for rationale of all conformance requirements- added section 6 New IPP Operations (empty)- added section 7 New IPP Attributes (empty)
15.19[16.18] 11 August 2014
- Initial draft- based on Mike Sweet’s presentation at PWG F2F meeting in October 2013- added Abstract and Introduction- added Terminology, including new and refined terms for clarity- added Requirements (rationale, use cases, out-of-scope, design requirements)- added IPP Object Model (extensions to RFC 2911)- added IPP System Object (still a sketch)- combined System object and System Control Service object (separation was artificial)- added References (normative and informative)
Page 111 of 111 Copyright © 2014-2016 The Printer Working Group. All rights reserved.
32832933803381338233833384338533863387
3389
33903391339233933394339533963397
3398
339934003401340234033404340534063407
330