May 9, 2023Working Draft
The Printer Working Group
PWG Semantic Model v2.0 (SM2)
Status: Initial
Abstract: The original PWG Semantic Model [PWG5105.1] has been extended from just the printing service to all of the typical MFD Services, reflecting the consolidation of hardcopy imaging services in common Multifunction Devices (MFDs). The MFD Imaging Services model is described in this MFD Model and PWG Semantic Model Specification Common Semantics specification which is published in conjunction with the PWG Semantic Model XML Schema [MFD SM20_SCHEMA], individual specifications for each of the services, and a specification for the System object, the core Element of an MFD. The MFD Model and Common Semantics specificationPWG Semantic Model identifies defines Imaging Services that may be included within an MFD Imaging System, and addresses the relationships between these Services and the System, describes the concepts and elements common to the different services, and defines the terminology used in the Service specifications.
This document is a PWG Working Draft. For a definition of a "PWG Working Draft", see: ftp://ftp.pwg.org/pub/pwg/general/pwg-process30.pdf
This document is available electronically at:
ftp://ftp.pwg.org/pub/pwg/mfd/wd/wd-pwgsemanticmodel20-20120103.pdf
Copyright © 2011-2013 The Printer Working Group. All rights reserved.
123456789
10
11
12
13
14
15
16171819202122232425
2627
28
29
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Copyright © 2011 2013 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: PWG Semantic Model v2.0 (SM2)
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 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
12
30
313233343536
37
383940
414243
44454647
484950515253
545556
57585960
3
Working Draft – PWG Semantic Model v2.0 May 9, 2023
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 systems 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 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
45
61
6263646566
67
68
69
707172737475767778
798081
82
83
84
858687888990
6
Working Draft – PWG Semantic Model v2.0 May 9, 2023
About the PWG Semantic Model Work Group
The Semantic Model Working Group is responsible for the modeling of the services - Print, Copy, Scan, Fax, Email, Resource, System Control, and Transform hosted on Multifunction DevicesImaging Systems . Standardization of the Multifunction Device (MFD)Imaging System model and semantics will support interoperability of devices and services in local, and enterprise and cloud networks enabling improved job submission, job management, remote administration, and support. The goal of the project PWG Semantic Model is to define a unified semantic model and set of abstract operations for the most common and essential service and device features of the Multifunction DeviceImaging System.
For additional information regarding PWG Semantic Model visit:
http://www.pwg.org/mfd
Implementers of this specification are encouraged to join the Semantic Model 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 [email protected] Mailing list for consideration.
Page 4 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
78
91
92939495969798
99
100
101102103
9
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Table of Contents1. Introduction....................................................................................................................13
1.1 Scope.......................................................................................................................131.2 Background..............................................................................................................13
2. Terminology...................................................................................................................142.1 Conformance Terminology.......................................................................................142.2 Other Terminology...................................................................................................142.3 Modeling Representations used in this Document...................................................19
2.3.1 Element, Operation and Attribute Name Representation..................................202.3.2 “Any” Element and “Any” Attribute Extensions..................................................202.3.3 Representation of Mandatory versus Optional Elements and Number of Instances....................................................................................................................202.3.4 Representation of Exclusive Or.........................................................................21
2.4 Datatypes.................................................................................................................213. Requirements................................................................................................................23
3.1 Rationale for Title of Standard.................................................................................233.2 Use Cases...............................................................................................................233.3 Out of Scope............................................................................................................233.4 Design Requirements..............................................................................................23
4. Model Concepts.............................................................................................................234.1 Top Level Model Elements.......................................................................................234.2 Overview of Services...............................................................................................244.3 Primary Service Interfaces.......................................................................................244.4 Functional Overview of a Multifunction Device........................................................264.5 Jobs, Documents, Tickets and Templates...............................................................284.6 Content Region and Images....................................................................................29
4.6.1 Content Region.................................................................................................294.6.2 Job/Document Object and Digital Document Cardinality...................................30
4.7 Coordinate Systems.................................................................................................314.7.1 Coordinate Nomenclature..................................................................................314.7.2 Content Coordinate Systems.............................................................................32
4.8 Job and Job Ticket Life Cycle..................................................................................355. System Configuration Subunits.....................................................................................38
5.1 Common Subunit Elements.....................................................................................405.1.1 Common Subunit Status Elements....................................................................415.1.2 Common Subunit Description Elements............................................................46
5.2 Consoles..................................................................................................................495.3 Covers......................................................................................................................525.4 FaxModems.............................................................................................................545.5 Finishers..................................................................................................................585.6 Input Channels.........................................................................................................625.7 Input Trays...............................................................................................................645.8 Interfaces.................................................................................................................675.9 Interpreters...............................................................................................................715.10 Marker....................................................................................................................72
Page 5 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
1011
104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148
12
Working Draft – PWG Semantic Model v2.0 May 9, 2023
5.11 Media Paths...........................................................................................................765.12 Output Channels....................................................................................................785.13 Output Trays..........................................................................................................805.14 Processors.............................................................................................................835.15 Scan Media Paths..................................................................................................855.16 Scanners................................................................................................................875.17 Storages.................................................................................................................905.18 Vendor Subunits....................................................................................................92
6. Service Model Element Groups.....................................................................................946.1 Job Table.................................................................................................................956.2 Service Available Job Ticket....................................................................................966.3 Service Capabilities and Service Capabilities Ready...............................................976.4 Service Job and Document Ticket Document Processing Capabilities....................98
6.4.2 Service Document Ticket Document Description Capabilities.........................1076.4.3 Service Job Ticket Job Processing Capabilities..............................................110
6.5 Service Configuration.............................................................................................1156.6 Service Defaults.....................................................................................................1156.7 Service Description................................................................................................116
6.7.1 OwnerURI........................................................................................................1186.7.2 OwnerVCard....................................................................................................1186.7.3 MultipleOperationTimeoutAction.....................................................................118
6.8 Service Status........................................................................................................1216.8.1 Condition Table...............................................................................................1236.8.2 Relationship among Service State, Service State Reasons, Condition Table and Service State Message Elements.............................................................................125
7. Imaging Job Model......................................................................................................1267.1 Job Status..............................................................................................................126
7.1.1 JobOriginatingUri.............................................................................................1307.2 Job Ticket...............................................................................................................132
7.2.1 Job Ticket Document Processing....................................................................1327.2.2 Job Ticket Job Description..............................................................................1457.2.3 JobTicket Job Processing................................................................................149
7.3 Job Receipt............................................................................................................1588. Document Model.........................................................................................................159
8.1 Document Status...................................................................................................1598.2 Document Ticket....................................................................................................163
8.2.1 Document Description.....................................................................................1648.2.2 Document Processing.....................................................................................166
8.3 Document Receipt.................................................................................................1669. Service Operations and States....................................................................................167
9.1 General Service Sequence of Operation...............................................................1679.1.1 Initialization and Startup..................................................................................1689.1.2 Job Creation....................................................................................................1689.1.3 Job Processing................................................................................................1689.1.4 Service Pause, Service Shutdown and Abnormal Job Termination................169
Page 6 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
1314
149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193
15
Working Draft – PWG Semantic Model v2.0 May 9, 2023
9.2 Service, Job and Document States........................................................................1699.2.1 Service States, Conditions and State Transitions............................................1699.2.2 Job States and State Transitions.....................................................................1739.2.3 Document States and State Transitions..........................................................174
9.3 Service Operations................................................................................................1769.3.1 Basic Service Operations................................................................................1799.3.2 Administrative Service Operations..................................................................190
10. Counters & Timers.....................................................................................................19610.1 Work Counters (WorkTotals, DataStream, Auxiliary, Waste and Maintenance). .19710.2 MediaUsed Counters...........................................................................................20110.3 Availability Counters.............................................................................................20210.4 Monitoring Counters.............................................................................................202
11. Conformance Requirements......................................................................................20412. Internationalization Considerations............................................................................20413. Security Considerations.............................................................................................20414. IANA Considerations.................................................................................................20415. PWG Registration Considerations.............................................................................20516. References................................................................................................................205
16.1 Normative References.........................................................................................20516.2 Informative References........................................................................................210
17. Authors' Addresses....................................................................................................21018. Change Log...............................................................................................................211
18.1 January 3, 2012...................................................................................................21118.2 January 9, 2012...................................................................................................211
19. Appendix A: PWG SMv2 Elements’ Semantic information........................................21220. Appendix B: Service Capabilities...............................................................................23321. Appendix C: Keyword Well-Known Values................................................................23522. Appendix C: Keyword Value extension patterns........................................................24623. Appendix D – IPP Mapping........................................................................................247
23.1 Changes to remove some IPP specific aspects...................................................24723.2 Attribute Group Mapping......................................................................................248
Note: Section 10 will discuss the various Imaging Services. The section on Counters and Timers will be a subsection called Service Counters and Timers within an earlier section (see service status).
List of FiguresFigure 1 Element Extension Symbol.................................................................................20Figure 2 Attribute Extension Symbol.................................................................................20Figure 3 Conditionally Mandatory Element........................................................................20Figure 4 Optional Element.................................................................................................21Figure 5 System Object.....................................................................................................24Figure 6 Primary Interfaces with Servic.............................................................................25Figure 7 Relationships within a Multifunction Device.........................................................27
Page 7 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
1617
194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230
231232233234235236237238
18
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Figure 8 Scan Region Element..........................................................................................29Figure 9 Hardcopy Document, Region, Image Relationsh................................................30Figure 10 Document Cardinality........................................................................................30Figure 11 Scanner or Marker Coordinates........................................................................32Figure 12 Service Scan Coordinates.................................................................................33Figure 13 Document Format coordinates..........................................................................34Figure 14 UML Diagram Showing Relationships Relative to Job Ticket............................37Figure 15 Elements in System Configuration....................................................................39Figure 16 SubunitStatus Elements...................................................................................41Figure 17 Power Counters Schema...................................................................................42Figure 18 Power Meters Schema......................................................................................43Figure 19 Power Monitor Schema.....................................................................................44Figure 20 Power Support Schema.....................................................................................45Figure 21 Power Transition Schema.................................................................................46Figure 22 Subunit Description Schema.............................................................................46Figure 23 Power Calendar Schema...................................................................................47Figure 24 Power Event Schema........................................................................................48Figure 25 Power Timeout Schema....................................................................................49Figure 26 Console Subunit Schema..................................................................................50Figure 27 Console Lights Schema.....................................................................................52Figure 28 Cover Subunit Schema......................................................................................53Figure 29 FaxModem........................................................................................................54Figure 30 FaxModem Description......................................................................................55Figure 31 FaxModem Status.............................................................................................57Figure 32 Finisher..............................................................................................................58Figure 33 FinisherDescription............................................................................................58Figure 34 FinisherStatus...................................................................................................59Figure 35 FinisherSupply...................................................................................................60Figure 36 FinisherSupplyMediaInput.................................................................................61Figure 37 Input Tray..........................................................................................................64Figure 38 Input Tray Description.......................................................................................65Figure 39 Input Tray Status...............................................................................................66Figure 40 Interface............................................................................................................67Figure 41 InterfaceDescription...........................................................................................68Figure 42 InterfaceStatus..................................................................................................69Figure 43 Interpreter..........................................................................................................71Figure 44 Marker Schema.................................................................................................73Figure 45 MarkerDescription Schema...............................................................................73Figure 46 MarkerStatus Schema.......................................................................................74Figure 47 Marker Colorant Schema...................................................................................75Figure 48 Marker Supply...................................................................................................76Figure 49 Media Path........................................................................................................77Figure 50 MediaPathDescription.......................................................................................77Figure 51 MediaPathStatus...............................................................................................77Figure 52 Output Channel.................................................................................................79
Page 8 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
1920
239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283
21
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Figure 53 Output Tray.......................................................................................................80Figure 54 Output Tray Description.....................................................................................81Figure 55 Output Tray Status............................................................................................82Figure 56 Processor..........................................................................................................84Figure 57 Scan Media Path...............................................................................................86Figure 58 Scanner.............................................................................................................88Figure 59 Scanner Addressability......................................................................................89Figure 60 Scanner Margin.................................................................................................90Figure 61 Storage..............................................................................................................91Figure 62 Vendor Subunit..................................................................................................93Figure 63 Abstract Imaging Service Structure...................................................................95Figure 64 Imaging Job Table.............................................................................................95Figure 65 Imaging Job Model............................................................................................96Figure 66 Imaging Service Available Job Ticket................................................................96Figure 67 Imaging Service Capabilities.............................................................................98Figure 68 Imaging Document Processing Capabilities......................................................99Figure 69 Representative Service-Specific Document Processing Capabilities (Scan
Service).....................................................................................................................100Figure 70 Print Document Capabilities............................................................................103Figure 71 Media Col Structure.........................................................................................106Figure 72 Imaging Service Job Description Capabilities.................................................108Figure 73 Print Service Specific Job Description Capabilities.........................................109Figure 74 Document Format Details Structure................................................................110Figure 75 Imaging Service Job Processing Capabilities..................................................111Figure 76 Representative Service-Specific JobProcessingCapabilities Elements (FaxOut
Service Examples).....................................................................................................112Figure 77 Imaging Service Defaults.................................................................................115Figure 78 Basic Document Ticket Default.......................................................................116Figure 79 Imaging Service Job Ticket Defaults...............................................................116Figure 80 Imaging Service Description............................................................................117Figure 81 Representative Service-Specific Service Description (FaxOut).......................119Figure 82 Detail of DocumentFormatDetailsDefault........................................................121Figure 83 Imaging Service Status....................................................................................122Figure 84 Condition Table...............................................................................................124Figure 85 Imaging Job.....................................................................................................126Figure 86 Imaging Job Status..........................................................................................128Figure 87 Job Originating User Authentication Info.........................................................130Figure 88 Representative Service-Specific Job Status Elements....................................131Figure 89 Imaging Job Ticket..........................................................................................132Figure 90 JobTicket Superclass DocumentProcessing...................................................133Figure 91 JobTicket DocumentProcessing - Image Output Services Sheet 1.................134Figure 92 JobTicket DocumentProcessing - Image Output Services Sheet 2.................135Figure 93 JobTicket DocumentProcessing - Image Output Services MediaBox.............136Figure 94 JobTicket DocumentProcessing - Impression Output Services Sheet 1.........139Figure 95 JobTicket DocumentProcessing – Impression Output Services Sheet 2.........139
Page 9 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
2223
284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328
24
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Figure 96 JobTicket DocumentProcessing – Impression Output Services Sheet 3.........140Figure 97 Media Col Structure Specific...........................................................................144Figure 98 ImagingJobDescription (Superclass)...............................................................146Figure 99 Representative Service-Specific Job Ticket Job Description Elements (Print
Service).....................................................................................................................148Figure 100 Superclass Job Processing Elements...........................................................150Figure 101 Representative Service-Specific Job Processing Elements (FaxOut Service)
Sheet 1......................................................................................................................154Figure 102 Representative Service-Specific Job Processing Elements (FaxOut Service)
Sheet 2......................................................................................................................155Figure 103 Representative Service-Specific Job Processing Elements (Copy Service)
Sheet 1......................................................................................................................155Figure 104 Representative Service-Specific Job Processing Elements (Copy Service)
Sheet 2......................................................................................................................155Figure 105 Imaging Document Model..............................................................................159Figure 106 Imaging Document Status.............................................................................160Figure 107 Service-Specific Document Status Elements................................................162Figure 108 Imaging Document Ticket..............................................................................163Figure 109 Imaging Document Description.....................................................................164Figure 110 Service-Specific Document Description Elements.........................................165Figure 111 Service State Model......................................................................................167Figure 112 Service State Transitions and Causal Events...............................................171Figure 113 Job State Transition.......................................................................................174Figure 114 Document State Transition............................................................................176Figure 115 System Counters...........................................................................................197Figure 116 Counters, Showing the Derivation of Service Totals and System Totals.......199Figure 117 Work Counter Counts Type...........................................................................200Figure 118 Media Used Counters....................................................................................201Figure 119 Availability Counters......................................................................................202Figure 120 Monitoring Counts.........................................................................................203
List of TablesTable 1 PWG Semantic Model Terminology......................................................................14Table 2 Basic Element Datatypes......................................................................................21Table 3 Subunits...............................................................................................................39Table 4 Description of SubunitStatus Elements................................................................41Table 5 Power Counter Elements......................................................................................42Table 6 Power Meter Elements.........................................................................................43Table 7 Power Monitor Elements.......................................................................................44Table 8 Power Support Elements......................................................................................45Table 9 Power Transition Elements...................................................................................46Table 10 Description of Subunit Description Elements......................................................46Table 11 Power Calendar Elements..................................................................................47Table 12 Power Event Elements.......................................................................................48Page 10 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
2526
329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358
359360
361362363364365366367368369370371372373
27
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Table 13 Power Timeout Elements....................................................................................49Table 14 Console Elements..............................................................................................50Table 15 Cover Elements..................................................................................................53Table 16 Fax Modem Description Elements......................................................................55Table 17 Fax Modem Status Elements..............................................................................57Table 18 Finisher Subunit Elements..................................................................................59Table 19 FinisherSupply Elements....................................................................................60Table 20 FinisherSupplyMediaInput Elements..................................................................61Table 21 Input Tray Description Elements.........................................................................65Table 22 Input Tray Status Elements................................................................................66Table 23 InterfaceDescription Elements............................................................................68Table 24 InterfaceStatus Elements....................................................................................69Table 25 Interpreter Elements...........................................................................................71Table 26 Marker Elements................................................................................................73Table 27 Marker Status Elements.....................................................................................74Table 28 Market Colorant Elements..................................................................................75Table 29 Marker Supply Elements.....................................................................................76Table 30 Media Paths Elements........................................................................................77Table 31 Output Channel Elements...................................................................................80Table 32 Output Tray Elements.........................................................................................82Table 33 Processor Subunit Elements..............................................................................84Table 34 Scan Media Path Elements................................................................................86Table 35 Scanner Subunit Elements.................................................................................88Table 36 Scanner Addressability Elements.......................................................................89Table 37 Scanner Margin Elements..................................................................................90Table 38 Storage Elements...............................................................................................91Table 39 Vendor Subunit Elements...................................................................................93Table 40 Imaging Document Processing Capabilities.......................................................99Table 41 Service-Specific Document Processing Capabilities Image Output..................100Table 42 Service-Specific Document Processing Capabilities Impression Outputs........104Table 43 MediaCol Elements...........................................................................................106Table 44 Imaging Service Job Description Capabilities...................................................108Table 45 Service Specific Job Description Capabilities...................................................109Table 46 Document Format Detail Elements...................................................................110Table 47 Imaging Service Job Processing Capabilities...................................................111Table 48 Service-Specific JobProcessingCapabilities Elements....................................112Table 49 Service Description Elements...........................................................................118Table 50 Service-Specific Service Description Elements................................................119Table 51 Constituent Elements of DocumentFormatDetailsDefault.................................121Table 52 Service Status Elements...................................................................................122Table 53 Service-Specific Service Status Elements........................................................123Table 54 Condition Table Elements.................................................................................124Table 55 Job Status Elements.........................................................................................128Table 56 Job Originating User Authentication Info Elements..........................................130Table 57 Service-Specific Job Status Elements..............................................................131
Page 11 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
2829
374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418
30
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Table 58 JobTicket Superclass DocumentProcessing Elements.....................................133Table 59 Service-Specific Job Ticket Document Processing Elements - Image Output
Services.....................................................................................................................136Table 60 Color Processing Elements..............................................................................138Table 61 Service-Specific Job Ticket Document Processing Elements - Impression Output
Services.....................................................................................................................140Table 62 Media Collection Elements in Job Ticket..........................................................144Table 63 JobTicket ImagingJobDescription Elements (Superclass)................................146Table 64 Service-Specific JobTicketJobDescription Elements........................................148Table 65 Superclass JobProcessing Element Descriptions.............................................150Table 66 Service-Specific Job Processing Elements......................................................155Table 67 Document Status Elements..............................................................................160Table 68 Service-Specific Document Status Elements...................................................163Table 69 Document Description Elements......................................................................164Table 70 Service-Specific Document Description Elements............................................165Table 71 Conditions and Bounding Events......................................................................170Table 72 ServiceState Change by Operations................................................................172Table 73 Service State Change by Events......................................................................172Table 74 MFD Common Operations and Antecedents....................................................177Table 75 Basic MFD Interface Requests and Responses...............................................178Table 76 Administrative Operations.................................................................................190Table 77 Counter Elements Used in the Various Service and System Work Counters...200Table 78 Media Used Counter Elements.........................................................................201Table 79 Availability Counter Elements...........................................................................202Table 80 Monitoring Count Elements..............................................................................203
Page 12 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
3132
419420421422423424425426427428429430431432433434435436437438439440441442443444
33
Working Draft – PWG Semantic Model v2.0 May 9, 2023
1. Introduction
1.1 ScopeThis specification presents the concepts, semantics and structure of a generalized model of the hardcopy imaging services provided by a Multifunction Device (MFD), a hardcopy device also known as a Multifunction Peripheral (MFP), a Multifunction Printer (MFP) or an All-in-One. This specification is both an overall introduction to the PWG MFD Model and a description of concepts and Elements common to several MFD Services. It is intended to serve as an orientation to the separate PWG specifications defining the MFD Model. The root Element of an MFD, (i.e., System) and the individual MDF Services (e.g., Copy, Print) are more appropriately covered in their own specifications. This MFD Model and Common Semantics specification is technically aligned with a named version of the PWG MFD XML Schema [MFD_SCHEMA].
For purposes of this modeling, the services that may be performed by an MFD are: Print Scan Copy FaxIn FaxOut EmailIn EmailOut Transform Resource
This Document defines: The overall MFD model including the terminology and concepts used in the MFD Service models. The models of an MFD Service, Job and Document “Imaging Service” complex Elements, representing structures appearing in several Services but
because of XML Schema restrictions, not instantiated in any Service; the appropriate Services have parallel structures that include some Service-specific Elements, and
Elements common to several Services, eliminating the need to repeat these definitions in each Service specification.
The specific model of each MFD service, the specific interfaces and operations, and the factors unique to each service are discussed in the individual MFD Service specifications.
1.2 BackgroundOffice imaging functions were once limited to copying, formed letter printing and primitive telephone-line based facsimile, each performed by a different device. Impact printers gave way to high quality image printers with complex interpreters and network communication. Optical copying devices were replaced by digital scanners driving image printers. Facsimile matured to wed the digital scanners and image printers with more complex encoding and transports. From the viewpoints of utility, functionality and efficiency, it made sense to integrate these imaging services in a multifunction device.
Although there was increasing commonality in technology, there were very different cultures supporting the manufacture, marketing and maintenance of the different office imaging functions. Slowly, copy and fax functions started appearing in printers; print functionality was added to copiers; and facsimile machines had copy functionality added. Eventually, manufacturers supplied equipment specifically designed to address multiple imaging functions. Utilization of the networking, the massive storage, and the internet capabilities
Page 13 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
3435
445
446
447448449450451452453454
455456457458459460461462463464
465466467468469470471472
473474
475
476477478479480481
482483484485486
36
Working Draft – PWG Semantic Model v2.0 May 9, 2023
that were brought to the office and home environments allowed further expansion of imaging device functionality and has made the Multifunction Device the primary hardcopy imaging equipment in enterprise and SOHO environments.
Despite the commonality of technology and the related functionality, the terminology, method of use, and anticipated user interaction of the office imaging functions has been tied to the different cultures associated with these functions and has been slow to coalesce. The PWG V2 Semantics effort defines an MFD model with consistent semantics for capabilities, configuration, operations and states for each of the MFD services. Recognizing the actual and historic distinctions, each service model is described in a separate specification.
2. TerminologyNew terms and terms used in a specific way for this modeling are described in the text of this Document and in the individual Service specifications. For convenience, the following table lists these terms with a summary definition.
The definitions below contain common definitions for service qualified terms. The term ‘<service>’ in any of the definitions below should be taken to be the name of the specific Service being considered (i.e., ‘Copy”, ‘EmailIn’, ‘EmailOut’, ‘FaxIn’, ‘FaxOut’, ‘Print’, ‘Scan’, ‘Transform’ or ‘Resource’) when the term is used in the individual Service specification.
Multi-word terms are presented in this table with normal spacing between words. However, in some places in this specification, and in the individual Service model specifications, the term may be referring to a specific XML Element in an XML Schema. In that case, the spaces between words are omitted in accord with the XML Element tag. In either case, the definition of the term is the same.
2.1 Conformance TerminologyCapitalized terms, such as MUST, MUST NOT, REQUIRED, SHOULD, SHOULD NOT, MAY, and OPTIONAL, have special meaning relating to conformance as defined in RFC 2119 [RFC2119].
2.2 Other TerminologyNew terms and terms used in a specific way for this modeling are described in the text of this Document and in the individual Service specifications. For convenience, the following table lists these terms with a summary definition.
The definitions below contain common definitions for service qualified terms. The term ‘<service>’ in any of the definitions below should be taken to be the name of the specific Service being considered (i.e., ‘Copy”, ‘EmailIn’, ‘EmailOut’, ‘FaxIn’, ‘FaxOut’, ‘Print’, ‘Scan’, ‘Transform’ or ‘Resource’) when the term is used in the individual Service specification.
Multi-word terms are presented in this table with normal spacing between words. However, in some places in this specification, and in the individual Service model specifications, the term may be referring to a specific XML Element in an XML Schema. In that case, the spaces between words are omitted in accord with the XML Element tag. In either case, the definition of the term is the same.
Table 1 PWG Semantic Model Terminology
Page 14 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
3738
487488489
490491492493494
495
496497498
499500501502
503504505506
507
508509
510
511512513
514515516517
518519520521
522
39
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Term Definition<service> An identification of the specific Imaging Service involved, sometimes
preceding (and sometimes embedded in) terms dealing with Devices, Clients, Jobs and Job Elements, Documents and Document Elements (e.g., Print Document Ticket, Scan Intent, FaxIn Job.) See definition of Service.
Active Jobs A Service instance specific queue containing all the Jobs that are waiting to be processed or are currently processing.
Automatic Document Feeder (ADF) A mechanism for handling Hard Copy Documents for scanning. The mechanism selects a media sheet from its bin and passes it to the image acquisition subsystem of the Scan Device. After the Scan is complete the ADF transports the Hardcopy Document’s media sheet to its final destination (e.g., output bin, ADF bin.)
Capabilities Used in the context of <service> Capabilities, this term refers to those Elements of a Service that can be used in the processing or description of a Job or Document. The models include Job Processing Capabilities, Job Description Capabilities and Document Processing Capabilities. Generally, a Service must be able to report its Capabilities and Job Tickets may include the desired values of these Capabilities Elements to describe the User’s Intent.
Client The local or remote software entity that interfaces with the Job Originator and interacts with an Imaging Service.
Content Region The area of a Hardcopy Document or Digital Document which is to be processed by an MFD Service. Content Regions are applicable to Scan, FaxOut, Copy and, to an extent, Print Services. For example, a Scan Content Region is the portion of a Hardcopy Document media sheet side to be scanned and converted into a Digital Document. A Copy Content Region is the portion of a Hardcopy Document media sheet side to be printed. Depending upon the Service and the implementation. There can be multiple Content Regions defined for a given media sheet side.
Cross Feed direction The direction perpendicular to the movement of the Hard Copy Document or the direction that the print head or scanner light bar moves. For scanners that use a technology other that a light bar, this is the direction along which the image data is acquired most quickly. (Also called Fast Scan direction, X) This direction is sometimes referred to as X Feed direction.
Default Job Ticket,Default <service>Job Ticket
A Job Ticket data object that is bound to an instance of an Imaging Service. The Job Ticket Default <service>Job Ticket values are used by the Imaging Service when the Job Ticket for Job being processed does not specify a different value.
Destination The end point network address of a storage location for a Digital Document output from a Service.
Destination URI A URI that specifies the recipient of a Digital Document transmission for FaxOut or EmailOut services. It may also contain the URI for the routing to the recipient.
Device An abstract object representing a hardware component that implements one or more Imaging Services. The term may be preceded with the name of the specific Imaging Service (represented here by <service>). A Device exposes every Subunit on the associated host system involved in performing the functions of the indicated Imaging Service. For example a Print Device Scan Device.
Page 15 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
4041
42
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Term DefinitionDigital Document A Document in digitally encoded form as distinguished from a Hardcopy
Document. The data input to or output from a Service containing the electronic representation a Hardcopy Document. The Digital Document may also include metadata relative to the Document. Digital Documents are the primary input to Print, FaxOut, EmailOut and Transform Services and the primary output from Scan, FaxIn, EmailIn and Transform services. The Print, EmailOut and FaxOut Services may also have a secondary Digital Document output. See Hardcopy Document.
Directory Service A software application or a set of applications that stores and organizes information about a computer network’s users and resources, and that allows network administrators to manage user’s accesses to the resources.
Discovery Client A software application that performs service or resource discovery on a computer network.
Document An object created and managed by an Imaging Service that contains the description, processing, and status information of a data object submitted by a User. A Document object is bound to a single Job.
Document Data The digitized data submitted by a Job Originator as the Document or portion of a Document to be processed by an MFD service, or as the resulting data from the scanning of Hardcopy Document(s) in an MFD. The images from the scanned Hardcopy Document(s) are encoded in a specified format and stored at a Destination.
Document Repository A local or remote data store where Digital Documents are stored by or recovered from an MFD Service
Document Resource A Resource associated with a Document within a Job of an MFD Service is a Document Resource.
Document Ticket A data object that contains a User’s <service>Intent for Document processing and descriptive properties of a Document in a Job. Any Document processing properties in the Document Ticket for a particular Job will override the values specified in the Job Ticket’s Document processing properties. The content of a Document Ticket is configured by a User through a <service> Client.
Element A term used to convey structure and relationships in XML Document instances. An Element can contain both content and Elements. Complex Elements are composed, at least in part, of other Elements.
End User A User (Administrator, Job Owner, Operator, member of the Owner's group or other authenticated entity) for whom the Job output is intended.
Executable Resource Executable code that is installed in an MFD system and executed for performing a task. Executable Resource includes two types of resources: Firmware, and Software. (See Firmware, Software definitions below.) Executable resource is a category of resources that is served by the Resource Service.
Fast Scan direction Same as Cross Feed direction or X.Feed direction The direction along which the physical medium is moved or the direction that
the print head or scanner light bar moves relative to the Hard copy Document. For scanners that use a technology other that a light bar this is the direction along which the image data is acquired most slowly. (Also called Slow Scan direction or Y)
Firmware Persistent computer instructions and data embedded in the MFD that perform the basic functions of that device. Firmware is only replaced during a specialized update process. [IEEE2600] Firmware is a type of resource that can be retrieved and stored by PWG MFD Resource Services.
Page 16 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
4344
45
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Term DefinitionFont A complete character set of a single size and style of a particular typeface.
Most current computer fonts are based on fully scalable outlines. However, the term “Font” still refers to a single style. Times New Roman regular, italic, bold and bold italic are four fonts, but one typeface. Font is a type of resource that can be retrieved and stored by a MFD Resource Service.
Form A Document (printed or electronic) with spaces in which to write or enter data. Used in the context of the MFD specifications, the term “Form” refers to an electronic form, which is a type of resource that can be retrieved and stored by PWG MFD Resource Services.
Group Element A collection of Elements that constitutes a complex Element.Hardcopy Document A Document on physical media such as paper, transparency or film that is
the input source to Scan, Copy and FaxOut Services and the output from Print, Copy and FaxIn Services.
ICC Profile A set of data that characterizes a color input or output device, or a color space, according to standards promulgated by the International Color Consortium (ICC). Profiles describe the color Elements of a particular device or viewing requirement by defining a mapping between the device source or target color space and a profile connection space (PCS) (see definition below). This PCS is either CIELAB or CIEXYZ. Mappings may be specified using tables, to which interpolation is applied, or through a series of parameters for transformations. Every device that captures or displays color can have its own profile. ICC profile is a type of resource that can be retrieved and stored by a PWG MFD Resource Service.
Image A digital electronic representation of the information captured by a Scan Device. One Image is produced as a result of a Scan Device scanning a Scan Region. One or more images are contained in the Digital Document produced by a Scan Service.
Imaging Client A Client interacting or seeking to interact with an Imaging Service. Imaging Device A hardware entity that supports one or more Imaging Services (as defined
below), including the System. A more general alternate term for Multifunction Device, which name suggests that more than one Imaging Service is supported.
Imaging Service One of the Services considered in the modeling of a Multifunction Device, including Print, Scan, Copy, FaxIn, FaxOut, EmailIn, EmailOut, Transform and Resource
Intent The User’s preferences for the processing and description properties of a Job or Document.
Job A data object, created and managed by a Service, that contains the description, processing, and status information of a Job submitted by a User. The Job can contain one or more Document objects.
Job History An MFD Service instance specific queue containing all the <service>Jobs that have reached a terminating state. The terminating states are defined as Completed, Aborted and Canceled. The length of this queue is determined by the implementer. The Jobs should remain in the Job History for a time sufficient for interested parties to obtain information on completed Jobs.
Job Originator The User that submits the initial request to create the Job.Job Owner (or Owner) Normally the User who submits a Job is the Job Owner, although under
certain circumstances an administrator can reassign ownership. The Job owner has certain administrative privileges with respect to his Jobs.
Job Receipt An Element of the Service that contains information on the actual values of processing Elements used by the Service for processing a Job. The content of a Job Receipt is populated by the Service when a Job is processed.
Job Resource A Resource associated with a Job.
Page 17 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
4647
48
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Term DefinitionJob Template A Job Ticket data object representing a User’s preconfigured Intent that is
not bound to a specific Service or Job.Job Ticket A data object that contains a User’s Job-level Intent for Document
processing, Job processing and descriptive Job properties of a Job, sent to an MFD Service. Job Elements apply to the entire Job. Document processing Elements apply to all Documents within the Job unless overridden at the Document level (See Document Ticket). The content of a Job Ticket is configured by a User through a Client.
Local Client A software application entity that is co-located with the Service and interacts on behalf of a User. May also be referred to as Local <service> client, where <service> is one of the Services supported by the MFD.
Logo A graphical Element, (ideogram, symbol, emblem, icon, sign) that, together with its logotype (a uniquely set and arranged typeface) form a trademark or commercial brand. Logo is a type of resource that can be retrieved and stored by a PWG MFD Resource Service.
Multifunction Device (MFD) A hardware entity that supports one or more Imaging Services, including the System. Generally abbreviated MFD, this also includes Imaging Devices commonly called Multifunction Peripherals or Multifunction Printers (MFPs) and All-In-Ones.
Physical Document Ticket, Physical <service>Document Ticket
A printed, encoded Document Ticket submitted by the Job Originator with the Hardcopy Document to be scanned, which becomes a Document Ticket data object after being scanned and processed. This may be used for Scan, Copy and Fax-Out Services.
Physical Job Ticket, Physical <service>Job Ticket
A printed encoded Job Ticket, submitted by the Job Originator with the Hardcopy Document to be scanned, that becomes a Job Ticket data object after being scanned and processed. This may be used for Scan, Copy and Fax-Out Services.
Profile Connection Space (PCS) A standard device independent color space defined by the International Color Consortium (ICC) that is used for mapping the color space of one device to the color space of another by describing the relationship of each device’s color space to this device independent color space.
Region A rectangular area of a Digital Document that has been specified by an Administrator or End User as the bounding area for which a digital data representation will be output; or a rectangular area of a Hardcopy Document that has been specified by an Administrator or End User to be generated from a Digital Document
Remote Client The Remote Client is a Client external to the MFD that interfaces with the End User and interacts with a Service.
Resource A data object that can be served by the Resource Service when required by an MFD system for performing a task or a Job. There are two categories of Resources required by an MFD: Executable Resource, and Static Resource. (See the definitions of Executable Resource and Static Resource).
Resource Client The local or remote software entity that interfaces with the Job Originator and interacts with a Resource Service.
Resource Service A software service that provides the interfaces for storing, retrieving, and maintaining users’ Resources.
Retained Job A Retained Job is one which remains in the Service after it has been completed or canceled. This retention may be incidental or because the Job, is a Saved Job. A Retained Job is the only type of Job that can be referenced in a Resubmit Job operation.
Saved Job A Completed or Canceled Job with a “JobSaveDispostion” Element value indicating that the Job, including Document Data if any, should not be deleted or aged-out after the Job is completed.
Page 18 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
4950
51
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Term DefinitionSequence A type of XML structure that represents an ordered list of Elements.Service An Imaging Service (or MFD Service) that accepts and processes requests
to create, monitor and manage Jobs, or to directly support other Imaging Services in an imaging-specific way (i.e., the Resource Service). The Service accepts and processes requests to monitor and control the status of the Service itself and its associated Resources. A Service may be hosted either locally or remotely to the MFD.
Slow Scan direction Same as Feed Direction or Y Software Persistent computer instructions and data placed on the MFD, via download,
that are separate from, and not a part of, the base Firmware. Software supports features or applications that are in addition to those provided by the base Firmware. Software is a type of Executable Resource. Software is a type of resource that can be retrieved and stored by a PWG MFD Resource Service.
Static Resource A non-executable electronic data object that is required by an MFD system for performing a task. Static Resource includes the following types of resource: Font, Form, Images, Logo, and Template.
Subunit A physical entity contained within or controlled by an Imaging Device that performs a specific process necessary to support one or more Imaging Services; (e.g., Marker, Console, Covers, Interfaces, Input Channels, Output Channels, etc). Note that, for historical reasons, the term Scanner may refer to either a Subunit or a Scan Device.
System The object handling interaction that needs to be with the MFD as an entity rather than a specific Service. The System is modeled to include all of the Subunits of the MFD, as well as device identification and overall status.
Template A data object that contains descriptive information and the pre-configured content of a Job or Document Ticket for a specific MFD service. A Template is not bound to a specific Job or Document. It can be stored or retrieved from a Resource Service, collocated on the MFD or hosted on a remote system. Template is a type of Resource that can be retrieved and stored by a PWG MFD Resource Service.
User Users include the Administrators, Job Owners, Operators, members of the Job Owner's group and other authenticated entities.
Watermark A recognizable image or pattern when printed on paper used to identify authenticity. Watermark is a type of resource that can be retrieved and stored by a PWG MFD Resource Service.
X An axis of the coordinate system. This axis is associated with the Fast Scan direction of the Scan Device. If the light bar or Hard Copy Document moves, they do not move in the X direction. They move in the Y direction. (See also Cross Feed direction, Fast Scan direction)
Y An axis of the coordinate system. This axis is associated with the slow scan direction of the Scan Device. If the light bar or Hard Copy Document moves, they move in Y direction. (See also Feed direction, Slow Scan direction)
2.3 Modeling Representations used in this DocumentThis specification describes the overall aspects of the MFD model in general. Furthermore, it describes in detail the Elements of the model that are common to multiple Services by presenting the graphic representation of the applicable Elements from the PWG MFD XML Schema [MFD_SCHEMA] and providing the datatype, a brief description and the reference for each of the constituent Elements in a table. The references identify the existing standard document, usually a MIB or IPP specification, where the Element is Page 19 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
5253
523
524
525526527528529
54
Working Draft – PWG Semantic Model v2.0 May 9, 2023
defined. In instances where an Element is newly defined in this specification, the Element definition is provided.
2.3.1 Element, Operation and Attribute Name Representation
In the text of this specification, the names of semantic Elements follow normal English format, with the individual words in a multi-word name initially capitalized (as are all defined terms) and the individual words separated by a space. However because the graphic representations are generated from the PWG MFD XML Schema [MFD_SCHEMA], the Elements in the figures and in the tables providing details of these Elements use the XML nomenclature. In the case of multi-word names, the words are concatenated (no spaces) with the first letter of the each word capitalized. For example, the complex Element ‘Subunit Status’ appears this way when being discussed in the text, but appears as ‘SubunitStatus’ in the schema diagrams and their associated tables.
However, multi-word Operation and Attribute names, which do not normally appear in the schema figures, are presented in the text concatenated (no spaces) with the first letter of the each word capitalized (e.g., CreateJob.)
2.3.2 “Any” Element and “Any” Attribute Extensions
The MFD model allows for vendor extensions to the model at various levels. Within the schema figures, an “Any” Element symbol is shown as an Element extension point to allow vendor product differentiation by implementation-specific Element extensions while maintaining interoperability. That is, one or more vendor extension Elements may be added where the schema shows an “Any” Element extension. Within the schema diagrams included in this specification, the Element extension is represented by “Any” in a rectangle, as shown in Figure 1.
Figure 1 Element Extension Symbol
In some cases, Attribute extensions are also allowed as Attributes associated with an Element. In the schema diagrams included in this specification, the Attribute extension is represented by “Any” in a five-sided, tab-like symbol as shown in Figure 2
Figure 2 Attribute Extension Symbol
2.3.3 Representation of Mandatory versus Optional Elements and Number of Instances
The line leading to an Element representation may be marked with the minimum and maximum number of instances of that Element. If there is no instance marking or if the minimum instance is greater than 0, that Element is mandatory to the extent that what precedes it is implemented. For example, Figure 3 shows that Copy Service Status is a mandatory element, but it is mandatory only if the preceding Element (which in this case is Copy Service) is implemented. However, because the schema figure segments in this specification are but small parts extracted from the overall model schema, considering the tags on one figure may give an incorrect impression. Since instances of an Element may occur at different places in the model, it is best to view the entire schema when considering these instance tags.
Page 20 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
5556
530531
532
533534535536537538539540
541542543
544
545546547548549550
551
552
553554555
556
557
558559
560561562563564565566567
57
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Figure 3 Conditionally Mandatory Element
A tag of 0.1 as in Figure 4 means that the Element is optional, but if it exists, no more than one may exist at that position in the model. A tag of 0.* as shown of the “Any” Element in Figure 1 means that the Element is optional but any number could exist in that position.
Figure 4 Optional Element
2.3.4 Representation of Exclusive Or
In this specification, an “or” condition may be represented by a vertical bar (|) not just in an Augmented Backus–Naur Form (ABNF) notation but also when listing parameters that are mutually exclusive, as in “IsAcceptingJobs|IsAcceptingResources”.
2.4 DatatypesThe modeling of an MFD is schematically represented in PWG MFD XML Schema [MFD_SCHEMA], using a structured hierarchy of components eventually leading down to leaf Elements of simple XML datatypes. In this specification these components are defined in terms of their constituent Elements, and the leaf Elements are identified as being of one of the datatypes in Table 2 Basic Element Datatypes.
When the datatype is keyword or list of keywords (fixed or extensible), the description will identify the keyword group. A fixed keyword datatype is specified as a WKV (Well Known Values), i.e., an enumeration of the allowed values defined in the relevant MFD specification please refer to the keyword group (i.e., PwgWellKnownValues.xsd, MediaWellKnownValues) in the PWG MFD XML Schema [MFD_SCHEMA] for an explicit list of the applicable keyword values. An extensible keyword datatype is usually specified as a union of the WKV and a keyword extension pattern (e.g., KeywordNsExtensionPattern, MimeExtensionPattern). The WKV defines the values that are explicit in the specification and the keyword extension pattern defines the syntax for vendor extended values. Actual vendor extended values are outside the scope of this specification. There are several instances where extensible keywords are defined simply as keyword this is done when the set of explicit keywords is very large (e.g., the set of all the processing and description Element names) and the vendor extensions themselves must be specified as keywords.
While the abstract datatype “list of Xxx” may be unordered for some Elements, the concrete encoding defined is “sequence of Xxx” in XML Schema [W3C-XSD2] and “1setOf Xxx” in IPP/1.1 [RFC2911], both of which are ordered datatypes. Many PWG Semantic Model and IPP/1.1 Elements in fact do depend on ordered values, so implementations should preserve the ordering (e.g., in protocol gateways).
Table 2 Basic Element Datatypes
Abstract Datatype
XML DataType
XML SchemaReference
Description and IPP Reference
any anyType [W3C-XSD1] 3.4.7
This datatype is used throughout the model to indicate the location of extension points in the model for the PWG or vendors to add Elements in a way consistent with the model. Those who
Page 21 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
5859
568
569
570571572
573
574
575
576577578
579
580581582583
584585586587588589590591592593594
595596597598
599
60
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Abstract Datatype
XML DataType
XML SchemaReference
Description and IPP Reference
wish to extend the model may do so only at these points.boolean boolean [W3C-XSD2]
3.3.2This datatype has two possible values: ‘true’ and ‘false’.See: Section 4.1.11 ‘boolean’ in IPP/1.1 [RFC2911]
base64binary base64binary [W3C-XSD2] 3.2.16
This datatype consists of a sequence of four characters representing a 24-bit value using an encoding processes defined in RFC 2045 [RFC2045]. The encoding process represents 24-bit groups of input bits as output strings of four encoded characters. Proceeding from left to right, a 24-bit input group is formed by concatenating three 8-bit input groups. These 24 bits are then treated as four concatenated 6-bit groups, each of which is translated into a single digit in the base64 alphabet.
Complex complexType [W3C-XSD1] 3.4.1
This datatype is used to indicate that the associated Element is a container for multiple Elements.
list of complex sequence of complexType
[W3C-XSD2] 3.4.1
This datatype is used to indicate the associated Element is an ordered set of containers for multiple Elements.See: Section 4.1.16 ‘1setOf X’ in IPP/1.1 [RFC2911]
dateTime dateTime [W3C-XSD2] 3.3.8
This datatype consists of a string of characters that represent a year, month, day, hour, minute, second and timezone. This datatype is derived from the ISO definition [ISO 8601:2000 Second Edition].See: Section 4.1.14 ‘dateTime’ in IPP/1.1 [RFC2911]
hexBinary hexBinary [W3C-XSD2] 3.3.16
This datatype consists of a sequence of binary octets encoded in a protocol binding-specific safe manner. This datatype is used for opaque data instead of text.See: Section 4.1.10 ‘octetString’ in IPP/1.1 [RFC2911]
Int int [W3C-XSD2] 3.4.17
This datatype consists of a 32-bit signed integer.See: Section 4.1.12 ‘integer’ in IPP/1.1 [RFC2911]
list of int sequence of int [W3C-XSD2] 3.4.17
This datatype consists of an ordered set of 32-bit signed integers.See: Section 4.1.16 ‘1setOf X’ in IPP/1.1 [RFC2911]
range of int restriction of int [W3C-XSD2] 3.4.17
This datatype is a complex type consisting of the Elements “upperBound” and “lowerBound” which are both 32-bit signed integers.See: Section 4.1.13 ‘rangeOfInteger’ in IPP/1.1 [RFC2911]
keyword restriction of NMTOKEN
[W3C-XSD2] 3.4.4
This datatype consists of a string of US-ASCII characters representing a single enumeration value. The legal characters that may be used in defining a keyword are uppercase and lowercase letters, decimal digits, hyphen(-), dot (.), and underscore(_). Colon (:) may also be used, but ONLY for distringuishing namespace prefixes. Vendor extension keywords must be qualified with a prefix of valid characters, followed by a colon (:), and then the vendor’s extended keyword. Note that IPP/1.1 [RFC2911] does not allow the use of uppercase letters. IPP keywords are transformed to XML Schema keywords by deleting hyphens and capitalizing the following letter.See: Section 4.1.3 ‘keyword’ in IPP/.1 [RFC2911]
list of keyword sequence of restriction of NMTOKEN
[W3C-XSD2] 3.4.4
This datatype consists of an ordered set of keywords.See: Section 4.1.16 ‘1setOf X’ in IPP/1.1 [RFC2911]
string string [W3C-XSD2] 3.3.1
This datatype consists of a UTF-8 [RFC3629] encoded human-readable string of Unicode characters as defined in [ISO646] [UNICODE].See: Section 4.1.1 ‘text’ in IPP/.1 [RFC2911]
list of string sequence of string [W3C-XSD2] 3.3.1
This datatype consists of an ordered set of strings.See: Section 4.1.16 ‘1setOf X’ in IPP/1.1 [RFC2911]
anyURI anyURI [W3C-XSD2] 3.3.19
This datatype consists of a string containing a URI as defined in [RFC3986].See: Section 4.1.5 ‘uri’ in IPP/.1 [RFC2911]
list of anyURI sequence of anyURI
[W3C-XSD2] 3.3.18
This datatype consists of an ordered set of URIs.See: Section 4.1.16 ‘1setOf X’ in IPP/1.1 [RFC2911]
anyURI Scheme
restriction of string [W3C-XSD2] 3.3.1 and
This datatype consists of a URI scheme name as defined in [RFC3986] and registered in [RFC4395], followed by a colon and
Page 22 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
6162
63
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Abstract Datatype
XML DataType
XML SchemaReference
Description and IPP Reference
3.3.18 double slashes (where applicable).See: Section 4.1.6 ‘uriScheme’ in IPP/.1 [RFC2911]
list of anyURI scheme
sequence of restriction of string
[W3C-XSD2] 3.3.1 and 3.3.18
This datatype consists of an ordered set of URI schemes.See: Section 4.1.16 ‘1setOf X’ in IPP/1.1 [RFC2911]
3. Requirements
3.1 Rationale for Title of StandardProvide a rationale for the standard.
3.2 Use CasesProvide use cases for the standard.
3.3 Out of ScopeProvide a list of use cases that are out-of-scope and the reasons.
3.4 Design RequirementsProvide a list of requirements based on the rationale and use cases.
4. Model Concepts
4.1 Top Level Model Elements
The PWG MFD XML Schema [MFD_SCHEMA] is a concise description of an MFD, identifying all Elements in the model about which information may be communicated and/or to which operations may be addressed. In this model, the top Element of the MFD is the System object. As shown in Error: Reference source not found, the System includes four mandatory Complex Elements which are basic to the perceived imaging functionality of the MFD, three optional Elements and an extension point.
Services: The group of Complex Elements performing the functional imaging services associated with an MFD. The Elements common to two or more Services are identified in this specification. Each Service and the Elements and characteristics unique to that Service are individually described in a separate specification.
System Configuration: the set of Subunits contained in the MFD, certain of which are used by each Service to implement Service functionality. Because the Subunits are a necessary part of the Service specifications, the Subunits are also addressed in this specification.
Page 23 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
6465
600
601
602
603
604
605
606
607
608
609
610
611
612
613614615616617618619620621622623624625
66
Working Draft – PWG Semantic Model v2.0 May 9, 2023
System Description and System Status: the Elements of the System object that are administrator settable (description) and inherent (status); these System specific elements are more appropriately described in a separate System specification.
Managers, Agents and Devices: The Elements involved in managing the Services and the actual or virtual devices implementing them. Although represented in the PWG MFD XML Schema [MFD_SCHEMA], these Elements are discussed in a separate specification. [PWG5106.2].
Figure 5 System Object
4.2 Overview of ServicesThe identified MFD Services are modeled to reflect the typical users’ perception of imaging services; Print, Scan, Fax etc. These intuitive perceptions can be strengthened by considering the relation between each service and the “outside world”, between other services, and between the Service and the MFD itself.
4.3 Primary Service InterfacesThe MFD Services and their primary interfaces are represented in Figure 6. All MFD Services other than the Resource Service (and the System Control Service, which is not shown here) process Jobs that deal with Documents. The Documents may be in either Hardcopy Document form, processed by Scanner or Marker Subunits, or electronic (digital) form, communicated through a network, Fax or Email interface Subunit. All MFD Services are integral in themselves, interfacing with an external client, repository or communication facility. (Note that “repository” in this context refers to an external Digital Document source or destination, such as a storage medium.) Although the PWG MFD XML Schema [MFD_SCHEMA] does not address work flow, it does define Service interfaces and operations in a manner which would allow the use of some established workflow methodology.
Page 24 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
6768
626627628629630631632
633
634
635
636637638
639
640641642643644645646647648
69
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Figure 6 Primary Interfaces with Servic
The Resource Service is intended to support the image-processing MFD Services, although it could be used as an independent, but limited, storage/retrieval service. The Resource Service interfaces represented in the figure are those to enter and maintain resources, and those creating a Job Template for submission of a JobCreation request to a Document-processing MFD Service. It would also be possible for the Document-processing MFD Services to include or interface with clients which would directly access resources to be used in a Job, such as fonts or forms, from a Resource Service.
The Transform Service is modeled as an independent primary service, accepting Digital Documents from clients and delivering transformed Digital Documents to clients. It is analogous to the Copy Service that takes in a Hardcopy Document and outputs one or more Hardcopy Documents. The Transform Service may also be used in tandem with one or more other MFD Services in a workflow mode.
All Services actually operate on Digital Documents, using the Scanner Subunit and/or Marker Subunit for the HardcopyDocument/Digital Document conversion. (Note that, for Copy Service, the Digital Document is totally internal and neither it nor its characteristics are accessible outside the service; therefore, for modeling purposes the Digital Documents is not included in the Copy Service.) Users’ hardcopy interface with a service is either through a Scanner or Marker Subunit. Users’ “softcopy” and control interface is always through a Client, which may be a remote application or may be access via a local Console contained in the MFD. The Repository, which stores Digital Documents before and/or after servicing, may be either
Page 25 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
7071
649
650
651652653654655656
657658659660
661662663664665666667
72
Working Draft – PWG Semantic Model v2.0 May 9, 2023
contained within the MFD or may be remote (such as a network file server), or may be some combination. The Fax transmission/reception facilities may be fully external (e.g., digital network Fax) or partially internal (e.g., PSTN Fax Modem). For functional modeling of the services, it makes no difference if these Subunits are facilities internal to the physical MFD or not.
4.4 Functional Overview of a Multifunction DeviceThe Semantic Model is very general, covering an MFD hosting anything from one to all of the MFD Services as well as an MFD hosting multiple instances of one or more instances of a given Service. Hosting multiple instances of a Service allows an implementation to expose multiple queues for each service instance, each with its own set of defaults and capabilities.
The top level relationship view of the MFD model is represented in Figure 7, which shows the relationship of Services and Subunits (i.e., System Configuration) within the MFD. The root of the model is the “System”, which is more appropriately described in a separate System specification.
System Configuration contains all the Subunits that comprise the MFD. These Subunits are the hardware and software entities used by Services to perform their tasks. While the System has a global view of the Subunits, the individual Services contain a Service specific view. The individual Service specifications describe the Service Configuration that may be applicable to that Service type. The Service Configuration identifies the Subunits of the System that are or may be used by that Service.
Each Service (except the Resource and System Control Services, which do not deal with Jobs) also includes a Service Defaults and a Service Capabilities Element. Service Defaults includes the Default Job Ticket and Default Document Ticket, each containing the default ticket values used by that Service. Service Capabilities contains the Job Ticket Capabilities and Document Ticket Capabilities. These provide the allowed values for the Job Ticket and Document Ticket respectively.
Each Service (except the Resource and System Control Services) may contain zero or more Jobs. Jobs reflect user intent as submitted via Job Tickets and possibly Document Tickets. Jobs waiting to be processed or currently being processed are considered Active Jobs. Jobs that have reached a terminated state (i.e., Completed, Aborted, or Canceled) are under Job History. Whether or not the Job History list is implemented and how long Jobs remain on the Job History list is implementation specific.
Page 26 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
7374
668669670671
672
673674675676
677678679
680681682683684
685686687688689
690691692693694
75
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Figure 7 Relationships within a Multifunction Device
Page 27 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
7677
695
696
697
78
Working Draft – PWG Semantic Model v2.0 May 9, 2023
4.5 Jobs, Documents, Tickets and TemplatesThe MFD Semantic Model uses terms in a specific way that may not be familiar. Because these terms and the concepts they represent are integral to the definition of all MFD Services, this section provides conceptual definitions
A Document is text and/or graphic information that initially and/or ultimately is displayed on hardcopy media or on some display device. Documents may be in hardcopy form (Hardcopy Document) or any number of electronic forms (Digital Document). MFD Services handle Documents by:
Converting Documents between hardcopy and electronic forms (scan and print) Duplicating Documents in hardcopy form, usually going through an electronic form (Copy) Transmitting Documents electronically (Facsimile) Transforming Documents from one electronic form to another (Transform)
A Job is the work Element by which one or more Documents are submitted to a service. A Job includes: The Document(s) or reference to the Document(s) which are the objects to be serviced (although,
for some Services, there can be a time during Job creation where a Job does not yet have a Document.)
A Job Ticket, which contains instructions of how the Document(s) should be processed, identification information on the Documents, descriptive information about the Job and optionally one or more Documents, and associated metadata. The Job Ticket Document Processing instructions apply to all Documents within the Job unless overridden at the Document level with a Document Ticket.
Support of multi-Document Jobs is optional. Some services, such as FaxIn, cannot distinguish separate Documents and are effectively limited to one Document per Job. The Service’s support for multi-Document Jobs can be determined by examining the Service Capabilities.
Once a Job has been created, its Status may be updated with information about the servicing and the state of the Job. This provides useful for Job management, tracking and billing.
A Ticket is a data object created by a Service and bound to a Job or Document. The ticket contains an end user’s Intent for Job and Document processing and the descriptive properties of a Job and optionally one or more Documents.
A Job Ticket relates to the Job and all Documents in the Job, except those for which a Document Ticket is created.
A Document Ticket relates to a specific Document and any property specified in a Document Ticket overrides the value of that property that may be specified in the Job Ticket.
A Template, in this context, may be a Job Ticket Template or a Document Ticket Template. It is a partially filled out Ticket not yet bound to a specific Job or Document, but which represents an often-used (or preferred by policy) set of instructions. Templates are completed and/or modified within the service to form specific Job or Document Tickets.
The Job Receipt is produced by a Service. It contains the actual values of processing Elements used by the Service for processing the Job, usually including some information from the Job Ticket.
The Document Receipt is produced by a Service for Documents for which the user has supplied a Document Ticket. The Document Receipt contains the actual values of processing Elements used by the Service for processing the Document, including information from the Job Ticket.
Page 28 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
7980
698
699700701
702703704705706707708
709710711712713714715716717
718719720
721722
723724725726727728729
730731732733
734735
736737738
81
Working Draft – PWG Semantic Model v2.0 May 9, 2023
4.6 Content Region and ImagesAn MFD deals with Documents, converting them from Hardcopy to Digital Document, Digital to Hardcopy Document, Hardcopy to Hardcopy Document or Digital to another form of Digital Document. There is not always a 1:1 relation between a Hardcopy Document and the Digital Document derived from it or from which it is derived. Services that can obtain input from a Scanner Subunit (e.g., Scan, Copy and FaxOut) may allow the user to select or may restrict regions of the original hardcopy to be rendered in the Digital Document. Similarly, Services that provide output to a Marker Subunit may allow selection or may restrict regions of the Digital Document to be rendered in the Hardcopy Document output.
4.6.1 Content Region
Content Region is a complex type referring to a rectangular area of interest in a Document; i.e., an area of the Document that contains desired content. In the MFD modeling, the Scan Region and ImageBox complex Elements are of the Content Region type. The Elements in the Scan Region, which also constitute the constituent Elements of the Content RegionType, are shown in Figure 8.
Figure 8 Scan Region Element
It is possible to identify multiple Scan Regions on a media sheet side. Each such region has a one-to-one mapping to a scanned image. The relationships among Hardcopy Document, Scan Region, and Image are represented in Figure 9. A Service using the Scanner Subunit defines a Scan Region and converts the acquired data into an Image. The encoding of the Image at this point is implementation specific. The Service accumulates the set of images that are to be extracted from the input Hardcopy Document and encodes them in the format reflecting appropriate to the Service and the User Intent to produce the Digital Document Depending upon the Service, this Digital Document may be sent to a repository (Scan), to a printer (Copy), or transmitted as a Facsimile (FaxOut).
Content Region also applies to a Service using the Marker Subunit, such as Print. In most cases, the selection of Content Region in these cases is done outside of the MFD. However, in certain production printing environments, there are service Elements to define a print content region independent of the maximum printable area defined as part of the Marker Subunit status. These Elements are included in the
Page 29 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
8283
739
740741742743744745746
747
748749750751
752
753
754755756757758759760761
762763764765
84
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Print Service model, but being limited to a special type of Print Service, are not described here. See Production Printing Attributes Set 1[PWG 5100.3], Para. 2.2 Finished Page Image Cell.
Figure 9 Hardcopy Document, Region, Image Relationsh
4.6.2 Job/Document Object and Digital Document Cardinality
There can be multiple Documents in a Job. Digital Documents are output as Files. Therefore, there are various ways in which the Services that accept multi-Document Jobs (i.e., Scan and Transform) can provide their Digital Document output. These are diagramed in Figure 10.
Page 30 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
8586
766767
768
769
770
771772773
774
87
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Figure 10 Document Cardinality
SDSF (Single Document Single File Job): One Document object that contains a reference to one single file. There is one file URI for the single Document location. The Destination is the Document URI; i.e., the single file URI.
SDMF (Single Document Multiple File Job): One Document object that contains references to multiple files. Each image in the Document data is stored in a separate file. There is one file URI per image file which constitutes the Document. The Destination is the directory URI of the files for the Document.
MDSF (Multiple Document Single File Job): Job object contains multiple Document objects. Each Document can have a different set of processing parameters. Each file contains a specified number of images for the Document. Each such set of images is stored in a separate file. Each Document object contains one file URI for each image file location. Each Destination is a Document URI; i.e., the single file URI.
MDMF (Multiple Document Multiple File Job): Job object contains multiple Document objects. Each Document can have different set of processing parameters from another. Each image in the Document data is stored in a separate file. The Document object contains a file URI for each image file location. Each Destination is the directory URI for the Document.
A Scan or Transform Job produces 1 to N Document objects. The Job has a unique ID within a unique Service. The Documents within the Job are numbered 1 to N. The Destination of a multi-Document Job is a directory for multi-Document files. After the Document file is stored, the Document file URI will be updated in the Document object as the Document location.
In addition to URI, the MIME type of a stored Document MUST be specified by the end user to clearly indicate the content type to be used for transporting the stored Document.
The capability of a Service to generate the various Document/File cardinalities is declared in the Document Output Mode in the Job Processing Capabilities Element. The value of the Document Output Mode which is set in the Job Ticket allows an End User to request one of the supported values.
4.7 Coordinate SystemsAll primary MFD services deal with Documents that, at some point in their existence, are visually presented for human consumption. Ideally, MFD Services would use a consistent coordinate system mapping between a hardcopy (or monitor displayed) Document and its Digital Document form. However, different systems have evolved in different environments and a realistic coordinate system approach must accommodate the existing practices. This section discusses the relationships between the coordinate systems used for scanning, printing, and for various Digital Document formats.
4.7.1 Coordinate Nomenclature
In a comprehensive MFD model, the intent is that the definition of a semantic Element be consistent across the modeling of the constituent Services. Because this also applies to the coordinate system semantics, there may appear to be some inconsistency in the names associated with coordinate related semantics.
There are scan Subunit specific semantics (e.g., Fast Scan Direction), print Subunit semantics, media related semantics (e.g., width), as well as general image processing semantics (e.g., X). Each semantic system has terms which are related to terms in the other systems. The terms Cross Feed, XFeed, Fast Scan, X, and Width are semantically aligned. For Scan and Print Subunits, these terms refer to the axis which is perpendicular to the movement of the Hard Copy Document, the Scan Subunit’s light bar or the Print Subunit’s print head or laser sweep path; it is also the axis along which the image data is read or
Page 31 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
8889
775
776777778
779780781
782783784785
786787788789
790791792793
794795
796797798
799
800801802803804805
806
807808809
810811812813814815
90
Working Draft – PWG Semantic Model v2.0 May 9, 2023
written most quickly. The terms Feed, SlowScan, Y, and Height are semantically aligned. They refer to the axis which is parallel to the movement of the Hard Copy Document, the Scan Subunit’s light bar or the Print Subunit’s print head or laser sweep path; it is also the axis along which the image data is read or written most slowly.
4.7.2 Content Coordinate Systems
Below are descriptions of the coordinate systems and units of measures for the Scanner and Marker Subunits and various Services. The Digital Document output is discussed as it relates to the semantic of the layout affecting Document Processing Elements.
4.7.2.1 Scan and Marker Subunit Media Content Coordinates
Figure 11 identifies the terms used to describe the placement and relative motion of media on a hardcopy scanner or printer. The outermost rectangle represents the surface upon which the media moves in the case of a scanner ADF or typical printer, or rests in the case of a flatbed scanner. The dimensions of this are given in terms of a MediaPathMax Element for printers and a Scan Media Path for scanners. In the case of a flatbed scanner, the platen is considered an instance of the Scan Media Path. These dimensions determine the maximum sized media that may be accommodated.
The media content (represented by the innermost rectangle in Figure 11) is the information that is being impressed upon the media or read from the media. The media itself is represented by the middle rectangle. The leading edge of the media is referred to as the North (N) edge, with the side of the media containing the content area facing the observer. The other edges of the media are defined by the normal compass layout of East (E), West (W), and South (S), with the compass facing the observer.
Page 32 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
9192
816817818819
820
821822823
824
825826827828829830
831832833834835
836
93
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Figure 11 Scanner or Marker Coordinates
In a Scanner ADF or a typical printer, the media is moved in the direction indicated by the large arrow in Figure 11; in a flatbed scanner, the media may be stationary and the scan head moved in the opposite direction. In either case, the relative direction of motion of the media with respect to the head is the same as is the direction of feed or slow-scan (as indicated by the arrow at the right of the diagram.) The content area is scanned in two orthogonal directions, variously defined as Cross Feed, Fast Scan or X and Feed, SlowScan or Y. The origin is at the leading edge of the Cross Feed and proceeds down the media.
4.7.2.2 Service Coordinates
Figure 12 shows the coordinate system that is used for a Service using a Scanner Subunit. The Content Region is facing the observer. Note that a Content Region for a Scan Service is termed a Scan Region (para. 2.4.) The service coordinate system and the defining parameters are the same in both cases. The Scan Region associated with a scan operation is defined in terms of the offset from the junction of the Fast Scan and SlowScan origins and the height and width dimensions of the region. The coordinate system for the Device and Service are linked together; that is, the origin of the Device’s coordinate system is the same as the origin of the Service’s coordinate system. The Scan Region may be defined by the user, or it may be default to the media size or the maximum allowable scan area. It is possible to have multiple overlapping Scan Regions.
Figure 12 Service Scan Coordinates
Page 33 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
9495
837
838839840841842843
844
845846847848849850851852853
854
855
96
Working Draft – PWG Semantic Model v2.0 May 9, 2023
4.7.2.3 Document Format Coordinates
When the output of a Service such as Scan or Transform is converted into certain Document Formats and stored (e.g., PDF, XPS), under some circumstances the entire image may not be stored. This is because these Document formats contain various constructs that bound the area where the image can be placed.
As represented in Figure 13, the MFD Model includes the Image Box and the Media Box. The Image Box is where the image will be placed and corresponds to the Hardcopy Document “content area” within the Digital Document. The Media Box delineates the area where the image can appear in the output Document and corresponds to the Hardcopy Document Media Size that may or may not be assumed in the Digital Document. If the X Offset and Y Offset are absent or set to 0, the origin of the coordinate systems for the Image Box and Media Box are aligned.
Figure 13 Document Format coordinates
These bounding boxes correspond to two PostScript bounding boxes. - ImagingBBox: A bounding box defining an outer boundary for each page image. This corresponds to the MFD Model Image Box.- PageSize: A rectangular area corresponding to the overall dimensions of the physical medium that was assumed in page description. This corresponds to the MFD Model Media Box.
The Portable Document Format (PDF) defines five boxes described by various bounding conditions:
- ArtBox: A rectangle, expressed in default user space units, defining the extent of the page’s meaningful content (including potential white space) as intended by the page’s creator. This corresponds to the MFD Model Image Box- MediaBox: A rectangle, expressed in default user space units, defining the boundaries of the physical medium on which the page is intended to be displayed or printed. This corresponds to the MFD Model Media Box.
Page 34 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
9798
856
857858859
860861862863864865
866
867
868869870871872873874875876877878879880881
99
Working Draft – PWG Semantic Model v2.0 May 9, 2023
PDF also defines some additional bounding boxes than are not included in the MFD Model.
- BleedBox: A rectangle, expressed in default user space units, defining the region to which the contents of the page should be clipped when output in a production environment - CropBox: A rectangle, expressed in default user space units, defining the visible region of default user space. When the page is displayed or printed, its contents are to be clipped (cropped) to this rectangle and then imposed on the output medium in some implementation-defined manner. - TrimBox: A rectangle, expressed in default user space units, defining the intended dimensions of the finished page after trimming.
4.8 Job and Job Ticket Life CycleThe relationships among the Elements associated with a service are shown in Figure 14. This discussion is applicable to Scan, Print, Copy, FaxOut and Transform MFD services, although aspects of these relationships specific to each service will be discussed in each specific Service specification. The Document and Document Ticket lifecycle is similar to the Job and Job Ticket lifecycle. The main differences are that:
A Document Ticket contains only Document Description and Processing Elements, A Document Ticket is bound to a Document and, The Document creation operations are Send Document and Add Document.
The Job Ticket is a data object that contains Job descriptions and Job and Document processing instructions. The Job Ticket life cycle is bound to the lifecycle of its associated Job. The Job is created when a Client initiates a Create Job operation. The Create Job can come from a Remote User interacting with an Application or by a Walkup User interacting with a User Interface and pressing the “START” button. In either case the user is able to communicate his Intent through the <service> protocol. The general sets of operations available to the User and to the Administrator are described in Section 0.
Prior to the Create Job submission, a Job Template can be selected or created. If available, a preconfigured Job Template can be retrieved from a data store outside the scope of this specification. For example the Resource Service can be used to retrieve a Job Template from such a repository. Alternatively a Job Template can be created by instantiating the associated XML Schema or retrieving the Default Job Ticket from the Service.
A Job Template is a Job Ticket that is not bound to any Job or Service. It is used as a convenience or to standardize the submission of future Jobs. A Job Template can be created in a number of ways. Some examples are:
A walk-up end user uses the Local application and User Interface to create a Job Template by configuring a set of preferred values for Job and Document Processing and Job Description.
An end user uses a remote application (in a computer) to create a Job Template by configuring a set of preferred values for Job and Document Processing and Job Description.
A walk-up end user or Remote user creates a Job Template by retrieving the Services Default Ticket and optionally modifying the values.
A walk-up end user or Remote user retrieves a Job Template from a Resource Service and optionally modifies the values.
The Job Template can then be modified to meet the user’s Intent. The Service also makes available the Service Capabilities that list all the allowed values for a Job’s Job Ticket for that instance of the Service. Once the Job Template fully embodies the User’s Intent, it can be bound to a Create Job operation parameter to send to the Service.
Page 35 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
100101882883884885886887888889890891892
893
894895896897898899900
901902903904905906
907908909910911
912913914915916917918919920921922
923924925926
102
Working Draft – PWG Semantic Model v2.0 May 9, 2023
The Service creates a Job based on the parameters in the Create Job operation. The Job’s Job Ticket is created based on the user supplied parameters. The Job Ticket remains bound to the Job until the Job is eventually deleted.
The Services’ Service Job Ticket Capabilities can be retrieved to provide the set of allowed values when modifying the Job Template
If an end user does not select a Job Template, then the processing instructions are the Default Job Ticket values. The Default Job Ticket can be administratively modified to control default behaviors for the associated Service.
Page 36 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
103104927928929
930931
932933934
105
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Figure 14 UML Diagram Showing Relationships Relative to Job Ticket
Page 37 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
106107
935
936
108
Working Draft – PWG Semantic Model v2.0 May 9, 2023
When a Job Ticket is created, it is bound to the end user’s Job by the Service. The Service manages and processes the Job according to the instructions supplied in the Job Ticket. If a processing instruction in the Job Ticket cannot be supported, the Service either returns an error or substitutes the instruction with another that best matches the user’s intent. The actual values used for processing the Job are captured in the Job Receipt of the Job in the Job History queue, which can be queried later.
After a Job is completed, it is moved to the Job History queue. A Job is deleted from the Service when it is deleted from the Job History according to a set of site-specific Job History retention rules.
The Job Ticket lifecycle ends as soon as the Job Ticket is deleted along with the Job
5. System Configuration SubunitsThe System Configuration represents device semantics in the MFD Model. The included Elements are semantically aligned with objects in the Printer MIB [RFC3805] and the Elements in the DMTF CIM Printing classes defined in [CIM-SCHEMA].
The System Configuration includes all of the Subunits used (or that could be used) by any of the Services in the MFD. For purposes of the model, Subunits are considered in terms of how they relate to Service functionality and Job processing, including configuration and statistics.
Figure 15 shows and Table 3 describes the Subunit Types that may be part of System Configuration and each <service>Configuration. These types are derived primarily from the groups used in the Printer MIB [RFC3805] or the HR MIB [RFC2790] as referenced in the Printer MIB. The System may have 0 to 1 instances of each Subunit type. If a Subunit type exists, there may be one or more instances of the Subunit (although, in the case of some Subunits, such as Cover, that may not be applicable.) No Service uses all possible Subunits; rather, each Service instance has a <service>Configuration which identifies the Subunits that may be used by an instance of that Service.
Page 38 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
109110937938939940941
942943
944
945
946947948
949950951
952953954955956957958
111
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Figure 15 Elements in System Configuration
Each instance of a Subunit has Status and Description complex Elements. The values of Status Elements are determined by the nature or state of the equipment and cannot be directly set by the user or administrator. Description Elements can be set by the users or administrator in Subunit or system configuration.
Table 3 Subunits
Subunits Reference DescriptionConsoles prtConsole [RFC3805] User Interface Console(s) used to display and modify the state of the
Device, Service, and Job. It may also use for setting configuration, generating and modifying Job Tickets and getting Service history and statistical information
Page 39 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
112113
959
960
961962963964
965
114
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Subunits Reference DescriptionCovers prtCover[RFC3805] covers, doors, housings and interlocks. FaxModems [RFC1696] PSTN modems used to transmit and receive Digital DocumentsFinishers prtOutput and all of
RFC3806 [RFC3806]performs some operations on the media other than marking
InputChannels prtChannel [RFC3805] source of Job (or Resource) control information and, for some services, the input of Digital Documents
InputTrays prtInput [RFC3805] mechanisms that feed media to be marked on into the Media PathInterfaces RFC2863 [RFC2863] communication ports and associated protocol stacks into and out of the
Server. The Input and Output Channels utilize the Interfaces.Interpreters prtInterpreter [RFC3805] conversion of Digital Documents into images that are to be marked on
the media, of scanned images into Digital Documents of the desired format, and Digital Documents from one format to another.
Markers prtMarker [RFC3805] produces marks on media. Includes both the mechanism and the associated supplies
MediaPaths prtMediaPath [RFC3805] the mechanisms that move the media which is to marked and connects all marking related Subunits: Input Trays, Output Trays, Markers and Finishers.
Output Channels prtChannel [RFC3805] destination pathways for Service Request responses and, for MFD Services with a Digital Document output; the destination pathways for these Documents.
OutputTrays prtOutput [RFC3805] general purpose trays capable of receiving Hard Copy Documents that have been printed or scanned. This Element may not be applicable to Scanner Subunits equipped with an ADF that re-circulates the media if the ADF is the only destination of the Hard Copy Documents handled by the ADF.
Processors RFC2790[RFC2790] hrProcessorTable
computing and logical Elements of device, including associated operational memory, that typically execute the device software and/or firmware
ScanMediaPaths [PWG5108.2] encompasses the mechanisms that move the media to be scanned This can include an Automatic Document Feeder for Scanner Subunits so equipped.
Scanners [PWG5108.2] - mechanism that acquires the image of the selected scan of a Hardcopy Document
Storages prtStorage and RFC2790[RFC2790] hrStorage
mechanism that stores and allows retrival of Digital Documents and/or resources
Vendor Subunits Implementation-specific Elements for which status and description information should be available
Many Status Elements and Description Elements are common to all Subunits. Other Elements reflect the specific nature of the Subunits type. In the subsequent paragraphs of this section, the Elements constituting each Subunit are outlined in Schema graphic segments and the Subunit-specific Elements are described in tables. Note that, at various levels, an “Any” Element is provided as an Element extension point to allow vendor product differentiation by implementation-specific Element extensions while maintaining interoperability. This Element of type “Any” appears through the models to provide vendor extensibility.
5.1 Common Subunit ElementsThe Status and Description Elements common to most Subunits are grouped into the complex types Subunit Status and Subunit Description, respectively. Following the MFD modeling convention, Subunit Status contains Elements which define the basic characteristics, state or condition of the Subunit; the values of Status Elements are not subject to administrator modification or reset. Subunit Description contains Elements which are intended to be set by the administrator. The descriptions of these common Subunit Elements are presented once in this section rather than being repeated for each Subunit. The individual
Page 40 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
115116
966
967968969970971972
973
974975976977978979
117
Working Draft – PWG Semantic Model v2.0 May 9, 2023
descriptions of Subunits that include these Subunit Status and Subunit Description complex Elements refer back to this section.
There will typically be Power Management Elements, derived from the PWG Power Management Model [PWG 5106.4] associated with and operating on the System (i.e., on the MFD as a unit). The description of these complex Elements is appropriate to the System specification. However, within the MFD model, the Subunits correlate most closely to the physical components of the MFD. Because the various Services in an MFD which employ the Subunits may be used at different times and under different circumstances, it may be desirable to have independent power control of the various Subunits. Therefore, the Subunit Status and Subunit Description complex Elements include Power Status and Management Elements. Because of this inclusion, the common Subunit Element groups are not constituent Elements of Subunits for which Power Management Elements are considered inapplicable, such as Covers and software-based Subunits including Interpreters, Input Channels and Output Channels.
5.1.1 Common Subunit Status Elements
The Subunit Status complex type is represented in Figure 16 and described in Table 4. Subsequent subsections describe the constituent power-related complex types. Subunit Status Elements are inherently read-only.
Figure 16 SubunitStatus Elements
Table 4 Description of SubunitStatus Elements
Element DataType Description or Keyword Group
Reference
DeviceErrors int count of detected errors may or may not be power persistent
hrDeviceErrors [RFC2790]
ID int unique value for each instance of the Subunit in the MFD
hrDeviceIndex [RFC2790]
Page 41 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
118119980981
982983984985986987988989990991
992
993994995
996
997
998
120
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Element DataType Description or Keyword Group
Reference
PowerCounters complex See 3.1.1.1PowerMeters complex See 3.1.1.2PowerMonitor complex See 3.1.1.3PowerSupport complex See 3.1.1.4PowerTransition complex See 3.1.1.5ProductID string manufacturer’s ID for the Subunit hrDeviceID [RFC2790]SubunitStates keyword current operational state of the
Subunit SubunitStateWKV
hrDeviceStatus [RFC2790]
5.1.1.1 Power Counters
Power Counters track major power state transitions. Hibernate, On, Standby and Suspend are stable power states, and are defined in an Imaging Device context in the PWG Power Management Model [PWG 5106.4]. The Power Counter Element is represented in Figure 17 and its Elements identified in Table 5. These counters are specified as persistent across power cycles and hardware reconfigurations.
Figure 17 Power Counters Schema
Table 5 Power Counter Elements
Element DataType Description Reference(PWG Power Management Model
[PWG 5106.4]
Power Counters complex Para 5.4HibernateTransitions int Para 5.4.1OnTransitions int Para 5.4.2StandbyTransitions int Para 5.4.3SuspendTransitions int Para 5.4.4Any Various Extensions to Power Counters
Page 42 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
121122
999
1000
1001100210031004
1005
1006
1007
1008
123
Working Draft – PWG Semantic Model v2.0 May 9, 2023
5.1.1.2 Power Meters
Power Meters includes a group of meter Elements concerned with keeping track of the power consumption of the Subunit. This complex Element is represented in Figure 18, with the component Elements identified in Table 6. The Power Meters Are Actual Element is a Boolean allowing the use of either measured or anticipated power consumption values. Power Peak Watts tracks the maximum energy drawn by the Subunit since the last reboot and is inherently not power persistent. The Power Current Month KWH Element accumulates power consumption values (or estimates) in real time. It may be expected to be continually increasing and to be power persistent during the month. At the end of each month the value is transferred to the Power Previous Month KWH Element value. Power Lifetime KWH is, of course, persistent over power and reconfiguration cycles.
Figure 18 Power Meters Schema
Table 6 Power Meter Elements
Element DataType Description or Keyword Group
Reference(PWG Power Management Model
[PWG 5106.4]
PowerMeters Complex the current power meters for each System or Subunit
PowerMetersAreActual boolean power meter values are actual measurement(true) or estimation (false)
Para 5.5 [PWG 5106.4]
PowerCurrentWatts int current power consumption in watts Para 5.5.1 [PWG 5106.4]PowerPeakWatts int peak power consumption in watts Para 5.5.2 [PWG 5106.4]PowerCurrentMonthKWH int current month's power consumption in
kilowatt hoursPara 5.5.3 [PWG 5106.4]
PowerPreviousMonthKWH int previous month's power consumption in kilowatt hours
Para 5.5.4 [PWG 5106.4]
PowerLifetimeKWH int lifetime power consumption in kilowatt hours
Para 5.5.5 [PWG 5106.4]
Any Various Extensions to PowerMeters
Page 43 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
124125
1009
101010111012101310141015101610171018
1019
1020
1021
126
Working Draft – PWG Semantic Model v2.0 May 9, 2023
5.1.1.3 Power Monitor
The Power Monitor Elements for a Subunit identifies the current power state of the Subunit. This complex Element consists of just a Power State Element and a Power State Message Element. The representation is Figure 19 and the Elements are identified in Table 7.
Figure 19 Power Monitor Schema
Table 7 Power Monitor Elements
Element DataType Description or Keyword Group
Reference(PWG Power Management Model)
[PWG 5106.4]Power Monitor complex
PowerState keyword PowerStateWKV Para 5.2.1 [PWG 5106.4]PowerStateMessage string human-readable that describes,
explains, or qualifies the current power state
Para 5.2.2 [PWG 5106.4]
Any various Extensions for Power Monitor
5.1.1.4 Power Support
The Power Support complex Element lists the supported stable power states for the Subunit along with the functional and power consumption characteristics of the Subunit in each state. The complex Element is represented in Figure 20 and the constituent Elements identified in Table 8.
The Can Use Interfaces Element specifies the Interfaces, listed in a string, that are not inherently disabled when the Subunit is in the identified state, not necessarily that these interfaces can be used. That is, this Element does not report the disabled or down conditions of the Interfaces. Although identified as a string datatype, the value must be in the format “<ID1>,…,<IDn>” (e.g., 1,3,4) and must contain a comma-delimited list of Interface ID values (XML Schema) or corresponding if Index values (SNMP MIB). When this Element is instantiated on a Subunit, it must have the same value as corresponding Element in the System object.
Page 44 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
127128
1022
102310241025
1026
1027
1028
1029
103010311032
1033103410351036103710381039
129
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Figure 20 Power Support Schema
Table 8 Power Support Elements
Element DataType Description or Keyword Group
Reference(PWG Power Management Model)
[PWG 5106.4]Support Entry Complex
CanAcceptJobs boolean Para 6.1.5 [PWG 5106.4]CanProcessJobs boolean Para 6.1.6 [PWG 5106.4]CanRequestPowerState boolean Para 6.1.7 [PWG 5106.4]CanUseInterfaces string list of interfaces that can be used see
3.1.1.4 Para 6.1.8 [PWG 5106.4]
PowerActiveWatts int Para 6.1.3 [PWG 5106.4]PowerInactiveWatts int Para 6.1.2 [PWG 5106.4]PowerPeakWatts int Patra 6.1.4 [PWG 5106.4]PowerState keyword PowerStateWKV Para 6.1.1. [PWG 5106.4]Any various Extensions for Power SupportEntry
5.1.1.5 Power Transition
This complex Element identifies the design value of the transition time between one stable power state and another. As shown in Figure 21 and listed in Table 9, it is constitued of three Elements: the Starting Power State, the Ending Powerstate and the Transition Time.
Page 45 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
130131
1040
1041
1042
1043
1044
104510461047
132
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Figure 21 Power Transition Schema
Table 9 Power Transition Elements
Element DataType Description or Keyword Group
Reference(PWG Power Management Model
[PWG 5106.4]TransitionEntry Complex
EndPowerState keyword PowerStateWKV Para 6.2.1 StartPowerState keyword PowerStateWKV Para 6.2.2StateChangeSeconds int Time in Seconds Para 6.2.3Any various Extensions to Power TransitionEntry
5.1.2 Common Subunit Description Elements
The common description Elements for Subunits are identified in Figure 22 and Table 10. Following the convention, Description Elements are those which can be set. As with the common Subunit Status Elements, many of the common Subunit description Elements are power related, but these are settable power Elements. The Elements contained under Subunit Description are described in the following paragraphs.
Figure 22 Subunit Description Schema
Table 10 Description of Subunit Description Elements
Element DataType Description or Keyword Group
Reference
Description string textual description of the Subunit, possibly identifying manufacturer, revision and serial number
hrDeviceDescr (hrDeviceTable of [RFC2790]
PowerCalendar complex See 3.1.2.1
Page 46 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
133134
1048
1049
1050
1051
10521053105410551056
1057
1058
1059
135
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Element DataType Description or Keyword Group
Reference
PowerEvent complex See 3.1.2.2PowerTimeout complex See 3.1.2.3
5.1.2.1 Power Calendar
Figure 23 Power Calendar Schema
Table 11 Power Calendar Elements
Element DataType Description or Keyword Group Reference(PWG Power Management Model
[PWG 5106.4]
CalendarEntry ComplexId int Id of entry, policy Para 7.3.1 [PWG 5106.4]RequestPowerState keyword PowerStateWKV Para 7.3.2 [PWG 5106.4]CalendarRunOnce boolean Once vs recurring Para 7.3.3. [PWG 5106.4]CalendarDayOfWeek keyword Requested time of transition to
indicated power statePara 7.3.4 [PWG 5106.4]
CalendarMonth keyword Para 7.3.5 [PWG 5106.4]CalendarDay keyword Para 7.3.6 [PWG 5106.4]CalendarHour int Patra 7.3.7 [PWG 5106.4]CalendarMinute int Para 7.3.8 [PWG 5106.4]Any Various Extensions to CalendarEntry
Page 47 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
136137
1060
1061
1062
1063
1064
1065
138
Working Draft – PWG Semantic Model v2.0 May 9, 2023
5.1.2.2 Power Event
The Power Event complex type defines administrator set policies requesting that the Subunit be placed in a specified power state on the occurrence of a specified event. For example, a Marker Subunit might be put in a Standby power state when the required media stock is determined to be not accessible. The Power Event complex Element is represented in Figure 24 and the constituent Elements of this complex Element are identified in Table 12.
Figure 24 Power Event Schema
Table 12 Power Event Elements
Element DataType Description or Keyword Group Reference (PWG Power Management Model)
[PWG 5106.4]EventEntry complex
id int Number of power event policy Para 7.4.1 [PWG 5106.4]
EventName string See 3.1.2.2, above Para 7.4.2 [PWG 5106.4]RequestPowerState keyword PowerStateWKV Para 7.4.3 [PWG 5106.4]Any Various Extensions to Power EventEntry
Note that the Event Name Element, identifying the event on which the power state is to be set, must be structured as 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 keyword (starting with an uppercase character) vendor event name (e.g., ‘AcmeCrackedCrock’).
5.1.2.3 Power Timeout
This complex Element allows for specifying timeout polices by which a Subunit is to revert to a lower power state after some specified period. The complex Element is represented in Figure 25 and the constituent Elements are identified in Table 13.
Page 48 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
139140
1066
10671068106910701071
1072
1073
1074
10751076107710781079108010811082
1083
108410851086
1087
141
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Figure 25 Power Timeout Schema
Table 13 Power Timeout Elements
Element DataType Description or Keyword Group Reference(PWG Power Management Model
[PWG 5106.4]
TimeoutEntry ComplexId int Id of entry, policy Para 7.2.1 [PWG 5106.4]RequestPowerState keyword PowerStateWKV Para 7.2.2 [PWG 5106.4]StartPowerState keyword PowerStateWKV Para 7.2.3 [PWG 5106.4]TimeoutSeconds int Para 7.2.5 [PWG 5106.4]TimeoutPredicate keyword TimeoutPredicateWKV Para 7.2.4 [PWG 5106.4]Any Various Extensions to Power TimeoutEntry
5.2 ConsolesThis is a complex Element that represents a user or operator interface panel. It is technically aligned with the prtConsoleGroup [RFC3805]. The constituents of the Console Subunit complex Element are represented in Figure 26 and described in .Table 14.
Page 49 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
142143
1088
1089
1090
1091
109210931094
144
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Figure 26 Console Subunit Schema
Table 14 Console Elements
Page 50 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
145146
1095
1096
1097
147
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Element DataType Description or Keyword Group
Reference (all [RFC3805]*)
ConsoleDescription complexSubunitDescription complex See 3.1.2ConsoleNumberOfDisplayChars int number of characters per line displayed
on the physical display. prtConsoleNumberOfDisplayChars
ConsoleNumberOfDisplayLines int number of lines on the printer’s physical display.
prtConsoleNumberOfDisplayLines
Any various Extension point for ConsoleDescriptionConsoleStatus
SubunitStatus complex See 3.1.1ConsoleDisable boolean input is accepted from the operator
console.prtConsoleDisable
ConsoleDisplayBuffer complex Physical display buffer for printer console display or operator panel.
prtConsoleDisplayBufferTable
ConsoleDisplayText list of string Contents of buffer associated with each physical line on the display or operator panel
prtConsoleDisplayBufferEntry
ConsoleLights complex Set of indicatorsConsoleLight list of
complex ConsoleLight
description and state information for each light present on the printer console.
prtConsoleLightTable and prtConsoleLightEntry
ConsoleLightOnTime int defines the current status of the light in conjunction with ConsoleLightOffTime
prtConsoleOnTime
ConsoleLightOffTime int defines the current status of the light in conjunction with ConsoleLightOnTime,.
prtConsoleOffTime
ConsoleLightColor keyword color of this light. ConsoleLightColorWKV
prtConsoleColor
ConsoleLightInfo string prtConsoleDescription ConsoleNaturalLanguage string language, country, and character set to
be used for the console. prtConsoleLocalization and [RFC3066]
Any various Extension point for ConsoleStatus
Error: Reference source not found is a detailed schema of the Console Lights Element. Note that four Elements are available to configure each console light. Console Light Color and Console Light Info are self-explanatory. Console Light On Time and Console Light Off Time define the current status of the light. If both are non-zero, the lamp is blinking and the values presented define the on time and off time, respectively, in milliseconds. If Console Light On Time is zero and ConsoleLightOffTime is non-zero, the lamp is off. If Console Light Off Time is zero and Console Light On Time is non-zero, the lamp is on. If both values are zero, the lamp is off.
Page 51 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
148149
10981099110011011102110311041105
150
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Figure 27 Console Lights Schema
5.3 CoversThis complex Element represents a device’s covers, doors, housings or interlocks. It is technically aligned with prtCoverTable [RFC3805]. The constituents of the Cover Subunit complex Element are represented in Figure 28 and described in Table 15.
Page 52 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
151152
1106
1107
1108
110911101111
153
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Figure 28 Cover Subunit Schema
Table 15 Cover Elements
Element DataType Description or Keyword Group
Reference (All [RFC3805])
CoverDescription complex The Cover Subunit does not include the Power provisions in the standard Subunit Description and therefore uses a specific CoverDescriptionType.
[RFC3805]
Description string String description of coverAny various Extension point for CoverDescription
CoverStatusCoverIsOpen booleanCoverSubunitType keyword Differentiates between cover, interlock, etc.
CoverSubunitTypeWKVAny various Extension point for CoverStatus
Any various Extension point for Cover
Page 53 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
154155
1112
1113
1114
156
Working Draft – PWG Semantic Model v2.0 May 9, 2023
5.4 FaxModemsThis complex Element models the Subunit that provides the interface of the FaxIn and FaxOut Services with the public switched telephone network. It is technically aligned with the mdmMib [RFC1696]. The FaxModem Subunit contains many Elements, with the top structure represented in Figure 29; the FaxModem Description structure represented in Figure 30 and described in Table 16 and the Fax Modem Status structure is represented in Figure 31 and described in Table 17.
Figure 29 FaxModem
Page 54 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
157158
1115
11161117111811191120
1121
1122
1123
159
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Figure 30 FaxModem Description
Table 16 Fax Modem Description Elements
Element DataType Description or Keyword Group
Reference (All[RFC1696])
FaxModemDescription complex [RFC1696]SubunitDescription complex See 3.1.2AudioVolume intCallSetUpFailTimer intDialingMethod keywordDTEInactivityTimeout intDTESyncAsyncMode keyword DTESynchModeWKVDTESyncTimingSource keyword DTESynchWKV
Page 55 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
160161
1124
1125
1126
162
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Element DataType Description or Keyword Group
Reference (All[RFC1696])
EscapeAction keyword CCEscapeActionWKVFaxModemInfo stringFaxModemName stringFaxModemModel stringFaxModemVersion stringFaxModemSerialNumber stringFaxModemVendorName stringFaxModemLineCapabilities list of keywords LineCapabilityWKVFaxModemDTROnToOff keyword DTRToOffWKVFaxModemDTROffToOn keyword DTRToOnWKVNumberOfRetries intRingsBeforeAnswer intAny various Extension point for
FaxModemDescription
Page 56 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
163164
165
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Figure 31 FaxModem Status
Table 17 Fax Modem Status Elements
Element DataType Description or Keyword Group
Reference (All[RFC1696])
FaxModemStatus complex [RFC1696]SubunitStatus complex See 3.1.1CompressionTypeUsed keyword CompressionTypeConnectionFailReason keyword ConnectionFailReasonWKV
Page 57 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
166167
1127
1128
1129
168
Working Draft – PWG Semantic Model v2.0 May 9, 2023
CurrentLineReceiveRate intCurrentLineTransmitRate intErrorControlUsed keyword ErrorControlWKVLineCarrierLossTime intModulationSchemeUsed keyword ModulationSchemeUsedAny various Extension point for FaxModemStatus
Any various Extension point for FaxModem
5.5 FinishersThis complex Element represents the devices handling the printed media as it emerges from the Marker Subunit. It is technically aligned with finDevice in the Finisher MIB [RFC3806] and the updates in the IANA Finisher MIB [IANA-FIN]. The constituents of the Finisher Subunit complex Element are represented in Figure 32 and described in Table 18.
Figure 32 Finisher
Figure 33 FinisherDescription
Page 58 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
169170
1130
1131113211331134
1135
1136
1137
1138
1139
1140
171
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Figure 34 FinisherStatus
Table 18 Finisher Subunit Elements
Element Datatype Description or Keyword Group
Reference
FinisherDescription complexSubunitDescription complex See 3.1.2FinisherType keyword FinisherTypeWKV FinDeviceTypeTC [RFC3806]
updated to [IANA-FIN] and finDeviceType [RFC3806]
FinisherCapacityUnit keyword SubunitCapacityUnitWKV finDeviceCapacityUnit [RFC3806] and PrtCapacityUnitTC [RFC3805]
FinisherMaxCapacityBasis keyword ObjectCounterBasisWKV finDeviceMaxCapacity [RFC3806]FinisherMaxCapacity counter finisher maximum capacity (in units
specified by FinisherCapacityUnit)finDeviceMaxCapacity [RFC3806]
Any various Extension point for FinisherDescription
FinisherStatus complexSubunitStatus complex See 3.1.1FinisherPresentOnOff keyword SubunitPresentOnOffWKV PresentOnOff [RFC3805] updated
to [IANA-PRT] & finDevicePresentOnOff [RFC3806]
Page 59 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
172173
1141
1142
1143
1144
174
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Element Datatype Description or Keyword Group
Reference
FinisherCurrentCapacity int finDeviceCurrentCapacity [RFC3806]
FinisherAssociatedMediaPaths string finisher associated media paths (bit-mask of values of MediaPathId)
finDeviceAssociatedMediaPaths (bit-mask) [RFC3806]
FinisherAssociatedOutputTrays string finisher associated output trays (bit-mask of values of OutputTrayId)
finDeviceAssociatedOutputs (bit-mask) [RFC3806
FinisherSupplies complex See Error: Reference source not found and Error: Reference source not found
Any various Extension point for FinisherStatus
Figure 35 FinisherSupply
Table 19 FinisherSupply Elements
Element DataType Description or Keyword Group
Reference (RFC3805 and RFC3806)
FinisherSupplyStatus complexId int Index of finisher supplies for finisher finSupplyIndex in [RFC3806]FinisherSupplyCurrentLevelBasis keyword ObjectCounterBasisWKV finSupplyCurrentLevel [RFC3806]FinisherSupplyCurrentLevel int finisher supply current level (in units
specified by FinisherSupplyCapacityUnit)finSupplyCurrentLevel [RFC3806]
FinisherSupplyMediaInputs complex See Error: Reference source not found and Error: Reference source not found
Any various Extension point for FinisherSupplyStatusFinisherSupplyDescription complex
Page 60 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
175176
1145
1146
1147
177
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Element DataType Description or Keyword Group
Reference (RFC3805 and RFC3806)
FinisherSupplyClass keyword MarkerSupplyClassWKV prtMarkerSuppliesClass [RFC3805]FinisherSupplyType keyword MarkerSupplyTypeWKV prtMarkerSuppliesType [RFC3805]FinisherSupplyInfo string prtMarkerSuppliesDescription
[RFC3805]FinisherSupplyColorName string prtMarkerSuppliesColorantIndex
[RFC3805]FinisherSupplyCapacityUnit keyword MarkerSupplyCapacityUnitWKV prtMarkerSuppliesSupplyUnit
[RFC3805]FinisherSupplyMaxCapacityBasis keyword ObjectCounterBasisWKVFinisherSupplyMaxCapacity int prtMarkerSuppliesMaxCapacity
[RFC3805]Any various Extension point for
FinisherSupplyDescription
Figure 36 FinisherSupplyMediaInput
Table 20 FinisherSupplyMediaInput Elements
Element DataType Description or Keyword Group
Reference
FinisherSupplyMediaInputDescription complexFinisherSupplyMediaInputType keyword Input TrayTypeWKV PrtInputTypeTC in [RFC3805] &
finSupplyMediaInputType [RFC3806] FinisherSupplyMediaInputInfo string finSupplyMediaInputDescription [RFC3806]
FinisherSupplyMediaInputName string finSupplyMediaInputName [RFC3806]Any various Extension point for
FinisherSupplyMediaInputDescription
FinisherSupplyMediaInputStatus complex
Page 61 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
178179
1148
1149
1150
180
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Element DataType Description or Keyword Group
Reference
Id int finisher supply media input local unique integer key
finSupplyMediaInputIndex [RFC3806]
FinisherSupplyMediaInputStates keyword SubunitStateWKVFinisherSupplyMediaInputSecurity keyword SubunitPresentOnOffWKV finSupplyMediaInputSecurity
(PresentOnOff) [RFC3806]FinisherSupplyMediaInputMediaSizeName string finisher supply media input
current media size nameMedia Size Self-Describing Names section 5 [PWG5101.1] & finSupplyMediaInputMediaName [RFC3806]
FinisherSupplyMediaInputMediaType string finisher supply media input current media type
Media Type Names section 3 in [PWG5101.1] & finSupplyMediaInputMediaType [RFC3806]
FinisherSupplyMediaInputMediaInfo string finisher supply media input current media info (weight, etc.)
finSupplyMediaInputMediaWeight & finSupplyMediaInputMediaThickness [RFC3806]
Any various Extension point for FinisherSupplyMediaInputStatus
5.6 Input ChannelsThis complex Element represents the source of Job control information, Resource Requests and Digital Documents input to MFD Services. It is technically aligned with prtChannelTable [RFC3805]. The constituents of the Input Channel Subunit complex Element are represented in Figure 35. Input Channel Elements are identified in Table 21.
Page 62 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
181182
1151
1152115311541155
183
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Element Datatype Description or Keyword Group
Reference (all [RFC3805]*)
InputChannelDescription complex See Note 1 below.Description string prtChannelInformationInputChannelType keyword InputChannelTypeWKV PrtChannelTypeTC InputChannelProtocolVersion string input channel protocol
version (refines InputChannelType)
prtChannelProtocolVersion
InputChannelAuxInfo string input channel auxiliary information in a structured string
PrtChannelTypeTC prtChannelInformation
Any various Extension point to InputChannelDescription
InputChannelStatus complex See Note 1 below.DeviceErrors int hrDeviceErrors[RFC2790]Id int prtChannelIndex
Page 63 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
184185
1156
186
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Element Datatype Description or Keyword Group
Reference (all [RFC3805]*)
InputChannelDefaultJobControlLanguage complex Refers to instance of langage interpreter See Note 2 and Elements of an Interpreter, Error: Reference source not found
prtChannelCurrentJobCntlLangIndex
InputChannelDefaultPageDescription complex Refers to instance of langage interpreter See Note 2 and Elements of an Interpreter, Error: Reference source not found
prtChannelDefaultPageDescLangIndex
InputChannelInterface complex Refers to instance of Interface- See Note 2 and Elements of an Interface, Error: Reference source not found
prtChannelIfIndex
InputChannelIsAcceptingJobs boolean input channel is accepting Jobs (if true)
PrtChannelStateTCprtChannelState
ProductID string hrDeviceID [RFC2790]SubunitStates keyword SubunitStateWKV prtChannelStatusAny various Extension point for
InputChannelStatusAny various Extension point to
InputChannel
Notes:
1. Because the Input Channel Subunit is considered software, it does not include the Power Elements in the standard Subunit Description and Subunit Status complex Elements. Therefore, these common Subunit complex Elements are not constituent Elements of the Input Channel Subunit, although some of the constituent Elements of these common complex Elements (such as Product ID) are independently included.
2. The Default Job Control Language, Default Page Description and Interface Elements of the Input Channel Subunit refer to instances of Interpreter and Interface Subunits and are composed of the Elements defined those Subunits. Please see the corresponding Subunit paragraph for the description of these Elements.
*Unless otherwise indicated
5.7 Input TraysThis complex Element represents the mechanisms containing and supplying the Media to be marked in a Marker Subunit. It is technically aligned with prtInputTable [RFC3805]. As shown in Figure 36, the constituents of the Input Tray Subunit complex Element are Input Tray Description, Input Tray Status and Any These Elements are described in Table 22. Input Tray Description (Figure 37) and Input Tray Status (Figure 38) are shown with their Elements described in Table 23 and Table 24.
Page 64 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
187188
1157
11581159116011611162
1163116411651166
11671168
1169
11701171117211731174
1175
189
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Figure 37 Input Tray
Figure 38 Input Tray Description
Table 21 Input Tray Description Elements
Element DataType Description or Keyword Group Reference (all [RFC3805])InputTrayDescription complex
InputTrayType keyword InputTrayTypeWKV prtInputType InputTrayName string prtInputName InputTrayVendorName string prtInputVendorName InputTrayModel string input tray /vendor-supplied model of Subunit prtInputModel InputTrayVersion string input tray vendor-supplied version prtInputVersion InputTraySerialNumber string input tray vendor-supplied serial number of
SubunitprtInputSerialNumber
Page 65 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
190191
1176
1177
1178
1179
192
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Element DataType Description or Keyword Group Reference (all [RFC3805])InputTrayCapacityUnit keyword SubunitCapacityUnitWKV PrtCapacityUnitTC InputTrayMaxCapacityBasis keyword ObjectCounterBasisWKV PrtCapacityUnitTC InputTrayMaxCapacity counter input tray maximum capacity (in units
specified by InputTrayCapacityUnit)PrtCapacityUnitTC
Any various Extension point to InputTrayDescription
Figure 39 Input Tray Status
Table 22 Input Tray Status Elements
Element DataType Description or Keyword Group
Reference (all [RFC3805])
InputTrayStatusInputTraySecurity keyword SubunitPresentOnOffWKV PresentOnOff
prtInputSecurity
Page 66 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
193194
1180
1181
1182
1183
195
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Element DataType Description or Keyword Group
Reference (all [RFC3805])
(PresentOnOff) InputTrayMediaSizeName string input tray current media size name - see
Media Size Self-Describing Names section 5 in [PWG5101.1]
prtInputMediaName
Input TrayMediaType string input tray current media type see Media Type Names section 3 in [PWG5101.1]
prtInputMediaType
Input TrayMediaInfo string input tray current media info (weight, color, etc.) see Media Type Names section 3 in [PWG5101.1]
prtInputMediaWeight prtInputMediaColor prtInputMediaFormParts
Input TrayCurrentLevelBasis keyword input tray current level basis (i.e., accuracy) ObjectCounterBasisWKV
prtInputCurrentLevel
Input TrayCurrentLevel counter input tray current level (in units specified by Input TrayCapacityUnit)
prtInputCurrentLevel
Input TrayMediaLoadTimeoutBasis keyword ObjectCounterBasisWKV prtInputMediaLoadTimeout Input TrayMediaLoadTimeout counter input tray media load timeout (in seconds) prtInputMediaLoadTimeout Input TrayNextInputTrayIdBasis keyword ObjectCounterBasisWKV prtInputNextIndex in Input TrayNextInputTrayId int input tray next input tray (after media load
timeout) (a value of '0' means 'None', i.e., no input switching)
prtInputNextIndex in
FeedDirection keyword For example, ShortEdgeFeed or LongEdgeFeedFeedOrientationWKV
Any various Extension point to InputTrayStatus
5.8 InterfacesThis complex Element represents the communication ports into and out of the device. It is technically aligned with the ifTable defined in MIB-II [RFC2863] The major constituents of the Interface Subunit complex Element are represented in Figure 39; the Interface Description Elements are described in Table 25. Interface Status is modeled in Figure 40 and described in Table 26.
Figure 40 Interface
Page 67 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
196197
1184
1185118611871188
1189
1190
198
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Figure 41 InterfaceDescription
Table 23 InterfaceDescription Elements
Element DataType Description or Keyword Group
Reference(all [RFC2863])*
InterfaceDescription complexSubunitDescription complex See 3.1.2InterfaceName string textual name of the interface. The value of this object should
be the name of the interface as assigned by the local device and should be suitable for use in commands entered at the device’s ‘console’.
ifName
InterfaceType int type of interface. Values are assigned by the Internet Assigned Numbers Authority IANA, through updating the syntax of the IANAifType textual convention.
ifType and [IANA_NUMBERS]
Any various Extension point to InterfaceDescriptionInterfaceStatus complex See Error: Reference source not foundAny various Extension point to Interface
Page 68 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
199200
1191
1192
1193
201
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Figure 42 InterfaceStatus
Table 24 InterfaceStatus Elements
Element DataType Description or Keyword Group
Reference(all [RFC2863])
InterfaceStatus complex
Page 69 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
202203
1194
1195
1196
204
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Element DataType Description or Keyword Group
Reference(all [RFC2863])
SubunitStatus complex See 3.1.1InterfaceAdminState keyword desired state of the interface.
InterfaceAdminStateWKV ifAdminStatus
InterfaceHighSpeed int estimate of the interface’s current bandwidth in units of 1,000,000 bits per second.
ifHighSpeed
InterfaceInDiscards int number of inbound packets which were chosen to be discarded even though no errors had been detected to prevent their being deliverable to a higher-layer protocol.
ifInDiscards
InterfaceInErrors int For packet-oriented interfaces, the number of inbound packets that contained errors preventing them from being deliverable to a higher-layer protocol. For character-oriented or fixed-length interfaces, the number of inbound transmission units that contained errors preventing them from being deliverable to a higher-layer protocol.
ifInErrors
InterfaceInOctets int total number of octets received on the interface, including framing characters.
ifInOctets
InterfaceInUnicastPackets int number of packets delivered by this sub-layer to a higher sub-layer which were not addressed to a multicast or broadcast address at this sub-layer.
ifInUcastPkts
InterfaceInUnknownProtocols
int for packet-oriented interfaces, the number of packets received via the interface which were discarded because of an unknown or unsupported protocol. For character-oriented or fixed-length interfaces that support protocol multiplexing, the number of transmission units received via the interface which were discarded because of an unknown or unsupported protocol.
ifInUnknownProtos
InterfaceLastChangeDate dateTime date/time the interface entered its current operational state NOTE: The syntax of this Element differs from its MIB counterpart int (i.e., seconds)
ifLastChange
InterfaceMaxPacketSize int size of the largest packet which can be sent/received on the interface, specified in octets.
ifMtu
InterfaceOperState keyword current operational state of the interface.InterfaceOperStateWKV
for additional details on ifIndex.
InterfaceOutDiscards int number of outbound packets which were chosen to be discarded even though no errors had been detected to prevent their being transmitted.
ifOutDiscards
InterfaceOutErrors int for packet-oriented interfaces, the number of outbound packets that could not be transmitted because of errors. For character-oriented or fixed-length interfaces, the number of outbound transmission units that could not be transmitted because of errors.
ifOutErrors
InterfaceOutUnicastPackets int total number of packets that higher-level protocols requested be transmitted, and which were not addressed to a multicast or broadcast address at this sub-layer, including those that were discarded or not sent.
ifOutUcastPkts
InterfaceOutOctets int total number of octets transmitted out of the interface, including framing characters.
ifOutOctets
InterfacePhysicalAddress string interface’s address at its protocol sub-layer. ifPhysAddress InterfaceSpeed int estimate of the interface’s current bandwidth in bits per
second. If the bandwidth of the interface is greater than the maximum value reportable by this object then this object should report its maximum value 4,294,967,295 and InterfaceHighSpeed must be used to report the interface’s speed.
ifSpeed
Any various Extension point to InterfaceStatus
Page 70 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
205206
207
Working Draft – PWG Semantic Model v2.0 May 9, 2023
5.9 InterpretersThis complex Element represents the functions necessary to understand the control languages by which instructions and requests are input and/or to understand the Digital Document description languages by which Digital Documents are input. It is technically aligned with prtInterpreter Table [RFC3805]. The constituents of the Interpreter Subunit complex Element are represented in Figure 41. The Elements are described in Table 27.
Figure 43 Interpreter
Table 25 Interpreter Elements
Page 71 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
208209
1197
11981199120012011202
1203
1204
1205
210
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Element DataType Description or Keyword Group
Reference (all [RFC3805])
InterpreterDescription complex See note below.Description stringInterpreterLanguageSupported keyword control languages which this interpreter can
interpret or emulate. The list of keywords is extensible. InterpreterLanguageFamilyWKV
prtInterpreterLangFamily
InterpreterLanguageLevel string level of the language which this interpreter is interpreting or emulating. This might contain a value like ’5e’for an interpreter which is emulating level 5e of the PCL language.
[prtInterpreterLangLevel]
InterpreterLanguageVersion string date code or version of the language which this interpreter is interpreting or emulating.
prtInterpreterLangVersion
InterpreterVersion string date code, version number, or other product specific information tied to this interpreter. This value is associated with the interpreter, rather than with the version of the language which is being interpreted or emulated.
prtInterpreterVersion
InterpreterLanguageFamily keyword family name of the control language which this interpreter is interpreting or emulating. The keyword values are extensible. InterpreterLanguageFamilyWKV
prtInterpreterLangFamily
Any various Extension point to InterpreterDescriptionInterpreterStatus See note below.
InterpreterDefaultOrientation keyword current orientation default for this interpreter.InterpreterPageOrientationWKV
prtInterpreterDefaultOrientation
InterpreterAddressabilityUnit keyword units used for Interpreter Addressability. SubunitAddressabilityUnitWKV
prtMarkerAddressabilityUnits
InterpreterAddressabilityBasis keyword confidence level of the addressability information for the Interpreter. ObjectCounterBasisWKV
prtInterpreterFeedAddressability
InterpreterAddressabilityCrossFeed int addressability in the cross feed direction i.e., fast scan direction in InterpreterAddressabilityUnits.
prtInterpreterXFeedAddressability
InterpreterAddressabilityFeed int addressability in the feed direction i.e., slow –scan direction in InterpreterAddressabilityUnits
prtInterpreterFeedAddressability
InterpreterDefaultCharsetIn string default coded character set for input octets encountered outside a context in which the Page Description Language establishes octet interpretation.
prtInterpreterDefaultCharSetIn
InterpreterDefaultCharsetOut string default character set for data from interpreter through output channel i.e., the ’backchannel’
prtInterpreterDefaultCharSetOut
InterpreterIsTwoWay boolean interpreter returns information to the host. prtInterpreterTwoWay Any various Extension point to InterpreterStatus
Any various Extension point to InterpreterNote: Because the Interpreter Subunit is considered software, the Power elements in the common. Subunit Status and Subunit Description base Elements are not applicable. The Interpreter Subunit therefore does not include these common complex base Elements, although it does include some lower level elements that are also in the common complex Subunit Status and Subunit Description Elements.
5.10 MarkerThis complex Element represents the mechanisms by which marks are impressed upon the media. It is technically aligned with prtMarkerTable [RFC3805] The constituents of the Marker Subunit and Marker Subunit Description complex Elements are represented in Figure 42 and described in Table 28. Marker Status is represented in Figure 43 and Table 29. Two of the constituent Elements of Marker Status, Marker Colorants and Marker Supply are separately represented in Figure 44 and Figure 45, with their Elements described in Table 30 and Table 31.
Page 72 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
211212
1206120712081209
1210
121112121213121412151216
213
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Figure 44 Marker Schema
Figure 45 MarkerDescription Schema
Table 26 Marker Elements
Element DataType Description or Keyword Group
Reference (all [RFC3805])
MarkerDescription complex
SubunitDescription complex See 3.1.2
MarkerTechnology keyword MarkerTechnologyWKV PrtMarkerMarkTechTC MarkerProcessColorants counter prtMarkerProcessColorants MarkerSpotColorants counter prtMarkerSpotColorants Any various Extension point to
MarkerDescription
Page 73 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
214215
1217
1218
1219
1220
1221
1222
216
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Figure 46 MarkerStatus Schema
Table 27 Marker Status Elements
Element DataType Description or Keyword Group
Reference (all [RFC3805])
SubunitStatus complex See 3.1.1MarkerAddressability complex
MarkerAddressabilityBasis keyword ObjectCounterBasisWKV prtMarkerFeed/xFeedAddressability out of band values
MarkerAddressabilityCrossFeed counter prtMarkerXFeedAddressability MarkerAddressabilityFeed counter prtMarkerFeedAddressability MarkerAddressabilityUnit keyword SubunitAddressabilityUnitWKV PrtMarkerAddressabilityUnitTC
MarkerColorants complex See Error: Reference source not found
MarkerCounterUnit keyword SubunitCounterUnitWKV prtMarkerCounterUnit MarkerCounterLife counter marker usage over Subunit
lifetimeprtMarkerLifeCount
MarkerCounterPowerOn counter marker usage since last power on
prtMarkerPowerOnCount
MarkerMargins complexMarkerEastMargin counter prtMarkerEastMargin MarkerMarginBasis keyword ObjectCounterBasisWKV prtMarkerNorth/South/East/
WestMargin out of band value
Page 74 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
217218
1223
1224
1225
219
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Element DataType Description or Keyword Group
Reference (all [RFC3805])
MarkerNorthMargin counter prtMarkerNorthMargin MarkerSouthMargin counter prtMarkerSouthMargin MarkerWestMargin counter prtMarkerWestMargin
MarkerSupplies complex See Error: Reference source not found for Elements defining each marker supply
Any various Extension point for Marker Status
Any various Extension point for Marker
Figure 47 Marker Colorant Schema
Table 28 Market Colorant Elements
Element DataType Description or Keyword Group
Reference (all [RFC3805])
MarkerColorant complexMarkerColorantStatus complex
Id int prtMarkerColorantIndex Any various Extension point for
MarkerColorantStatusMarkerColorantDescription complex
MarkerColorantRole keyword MarkerColorantRoleWKV prtMarkerColorantRole MarkerColorantInfo string marker colorant vendor-supplied
description (in locale specified by SystemNaturalLanguage)
MarkerColorantName string marker colorant standard name see marker colorant vendor-supplied description (in locale specified by SystemNaturalLanguage)
prtMarkerColorantValue
MarkerColorantTonality counter marker colorant distinct levels of tonality (levels of tonal difference available for rendering)
prtMarkerColorantTonality
Any various Extension point for MarkerColorantDescription
Any various Extension point for MarkerColorant
Page 75 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
220221
1226
1227
1228
222
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Figure 48 Marker Supply
Table 29 Marker Supply Elements
Element DataType Description or Keyword Group
Reference (all [RFC3805])
MarkerSupplyStatus complexMarkerSupplyId int prtMarkerSuppliesIndex MarkerSupplyColorantId pointer prtMarkerSuppliesColorantIndex MarkerSupplyCurrentLevelBasis keyword ObjectCounterBasisWKV prtMarkerSuppliesLevel MarkerSupplyCurrentLevel counter prtMarkerSuppliesLevel Any various Extension point for
MarkerSupplyStatusMarkerSupplyDescription complex
MarkerSupplyClass keyword MarkerSupplyClassWKV prtMarkerSuppliesClass MarkerSupplyType keyword MarkerSupplyTypeWKV prtMarkerSuppliesType MarkerSupplyInfo string prtMarkerSuppliesDescription MarkerSupplyCapacityUnit keyword MarkerSupplyCapacityUnitWKV prtMarkerSuppliesSupplyUnit MarkerSupplyMaxCapacityBasis keyword ObjectCounterBasisWKV prtMarkerSuppliesMaxCapacity MarkerSupplyMaxCapacity counter prtMarkerSuppliesMaxCapacity Any various Extension point for
MarkerSupplyDescriptionAny various Extension point for MarkerSupply
5.11 Media PathsThis is more fully identified as the Print Media Paths This complex Element represents the mechanisms by which the media is moved through a Printer Subunit, from Input Tray to Output Tray or Finisher. It is technically aligned with prtMediaPathTable [RFC3805]. The Elements of a Media Path Subunit are
Page 76 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
223224
1229
1230
1231
1232
123312341235
225
Working Draft – PWG Semantic Model v2.0 May 9, 2023
represented in Figure 46. The constituent Elements are described in Table 32. Note that Scan Media Paths are a separate Subunit described in paragraph3.15.
Figure 49 Media Path
Figure 50 MediaPathDescription
Figure 51 MediaPathStatus
Table 30 Media Paths Elements
Page 77 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
226227
12361237
1238
1239
1240
1241
1242
1243
1244
228
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Element DataType
Description or Keyword Group
Reference (all [RFC3805])
MediaPathDescription complexSubunitDescription complex See 3.1.2MediaPathMaxSpeed counter prtMediaPathMaxSpeed MediaPathMaxSpeedUnit keyword PrtMediaPathMaxSpeedPrintUnitTC in
[RFC3805] MediaPathMaxSpeedUnitWKV
prtMediaPathMaxSpeedPrintUnit
MediaPathMaxMediaSizeName string Media Size Self-Describing Names section 5 in [PWG5101.1]
prtMediaPathMediaSizeUnit; prtMediaPathMaxMediaFeedDir prtMediaPathMaxMediaXFeedDir
MediaPathMinMediaSizeName string prtMediaPathMediaSizeUnit; prtMediaPathMinMediaFeedDir prtMediaPathMinMediaXFeedDir
MediaPathType keyword PrtMediaPathTypeTC in [RFC3805] MediaPathTypeWKV;
prtMediaPathType
MediaTypesSupported list of keywords
Sequence of allowed mediatype valuesMediaTypeWKV
Any various Extension point for MediaPathDescription
MediaPathStatus complexSubunitStatus complex See 3.1.1 prtMediaPathStatusAny various Extension point for MediaPathStatus
Any various Extension point MediaPath
5.12 Output ChannelsThis complex Element represents the destination pathways for Digital Documents. It is technically aligned with prtChannelTable [RFC3805]. Output Channels are associated with an underlying Interface and are usually bound to a transport protocol or file system. The constituents of this complex Element are represented in Figure 47; the Elements are described in Table 33.
Page 78 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
229230
1245
1246124712481249
231
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Figure 52 Output Channel
Page 79 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
232233
1250
1251
234
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Table 31 Output Channel Elements
Element DataType Description or Keyword Group
Reference [RFC3805]*
OutputChannelDescription complex See Note below.Description string prtChannelInformationOutputChannelAuxInfo string additional protocol information needed to use the Output
Channel’s protocol. The information is protocol specific.ifDescr [RFC1213]
OutputChannelProtocolVersion string version of the protocol associated with an Output Channel instance in a protocol specific manner.
prtChannelProtocolVersion
OutputChannelType keyword This Element specifies the protocol associated with an Output Channel instance. OutputChannelTypeWKV
prtChannelType
Any various extension point for OutputChannelDescriptionOutputChannelStatus complex See Note below.
DeviceErrors int hrDeviceErrors [RFC2790]
Id intOutputChannelDefault
JobControlLanguagecomplex the Job Control Language i.e., Interpreter associated
with the channel. This defines the syntax used for Document control functions See 5.9 for constituent Elements
prtChannelDefaultPageDescLangIndex
OutputChannelInterface complex This is the Interface instance associated with this instance of an Output Channel. See 5.8 for constituent Elements.
prtChannelIfIndex
OutputChannelIsEnabled boolean indicates whether or not an Output Channel instance is available for
PrtChannelStateTC prtChannelState
Product Id string Human readable name hrDeviceID [RFC2790]
SubunitStates keyword SubunitStateWKV prtChannelStatusAny various Extension point for OutputChannelStatus
Any various Extension point for OutputChannelNote: Because the Output Channel Subunit is considered software, the Power elements in the common SubunitStatus and Subunit Description are not applicable. The Output Channel Subunit therefore does not include these common complex base Elements, although it does include some lower level elements that are also in the common complex Subunit Status and Subunit Description Elements.
*Unless otherwise indicated
5.13 Output TraysThis complex Element represents the trays or bins capable of receiving Hard Copy Documents that have been printed or scanned. The definition of Output Trays is technically aligned with prtOutputTable [RFC3805]. The basic constituents of the Output Tray Subunit complex Element are represented in Figure 48, with Output Tray Description and Output Tray Status being pictured in Figure 49 and Figure 50 respectively and described in Table 34.
Figure 53 Output Tray
Page 80 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
235236
1252
125312541255125612571258
1259
12601261126212631264
1265
1266
237
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Figure 54 Output Tray Description
Page 81 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
238239
1267
1268
1269
240
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Figure 55 Output Tray Status
Table 32 Output Tray Elements
Element DataType Description or Keyword Group
Reference (all [RFC3805])
OutputTrayDescription complexSubunitDescription complex See 3.1.2OutputTrayType keyword PrtOutputTypeTC in [RFC3805]
OutputTrayTypeWKV;prtOutputType
OutputTrayName string prtOutputName OutputTrayVendorName string prtOutputVendorName OutputTrayModel string prtOutputModel OutputTrayVersion string prtOutputVersion OutputTraySerialNumber string prtOutputSerialNumber OutputTrayCapacityUnit keyword PrtCapacityUnitTC in [RFC3805]
SubunitCapacityUnitWKV;prtOutputCapacityUnit
OutputTrayMaxCapacityBasis keyword ObjectCounterBasisWKV prtOutputMaxCapacity OutputTrayMaxCapacity counter output tray maximum capacity (in units
specified by OutputTrayCapacityUnitOutputTrayMaxMediaSizeName string see Media Size Self-Describing Names
section 5 in [PWG5101.1]prtOutputDimUnit; prtOutputMaxDimFeedDir prtOutputMaxDimXFeedDir
OutputTrayMinMediaSizeName string
Any various Extension point to OutputTrayDescription
Page 82 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
241242
1270
1271
1272
243
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Element DataType Description or Keyword Group
Reference (all [RFC3805])
OutputTrayStatus complexSubunitStatus complex See 3.1.1OutputTraySecurity keyword SubunitPresentOnOffWKV prtOutputSecurity (PresentOnOff)
OutputTrayRemainingCapacityBasis
keyword ObjectCounterBasisWKV prtOutputRemainingCapacity
OutputTrayRemainingCapacity counter in units specified by OutputTrayCapacityUnit)
prtOutputRemainingCapacity
OutputTrayStackingOrder keyword first to last or last to first. See PrtOutputStackingOrderTC in [RFC3805]
OutputTrayStackingOrderWKV;
prtOutputStackingOrder
OutputTrayPageDeliveryOrientation keyword face up or face down See PrtOutputPageDeliveryOrientationTC in [RFC3805] OutputTrayPageDeliveryOrientationWKV
prtOutputPageDeliveryOrientation
OutputTrayBursting keyword see PresentOnOff in [RFC3805] SubunitPresentOnOffWKV;
prtOutputBursting (PresentOnOff) OutputTrayDecollating keyword prtOutputDecollating
(PresentOnOff) OutputTrayPageCollated keyword prtOutputPageCollated
(PresentOnOff) OutputTrayOffsetStacking keyword prtOutputOffsetStacking
(PresentOnOff) Any various Extension point to OutputTrayStatus
Any various Extension point to OutputTray
5.14 ProcessorsThis complex Element represents the computing and logical Elements that, in conjunction with operational memory, execute the firmware and/or software providing the device functions and features. The Processor corresponds to the System Controller as defined in paragraph 2.2.8 of RFC3805 [RFC3805] It is modeled in Figure 51 with constituent Elements described in Table 35.
Page 83 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
244245
1273
1274127512761277
246
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Figure 56 Processor
Table 33 Processor Subunit Elements
Element DataType Description Reference (all [RFC2790])ProcessorDescription complex
SubunitDescription complex See 5.1.2ProcessorFirmwareID int product ID of the firmware associated
with the processor identifying manufacturer, model, and version
hrProcessorFrwID
ProcessorLoad int percentage of the last minute that processor was not idle
hrProcessorLoad
Page 84 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
247248
1278
1279
1280
249
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Any various Extension point to ProcessorDescription
ProcessorStatus complex Common Subunit StatusSubunitStatus complex See 5.1.1 prtChannelStatus
Any various Extension point to Processor
5.15 Scan Media PathsThis complex Element represents the media handling aspects of a Scanner Device. It is distinct from the Media Path Subunit (3.11), which refers to the media handling aspects of a Printer Device. Scan Media Paths can contain more than one Scan Media Path Subunit; for example, the platen of a flatbed scanner can be treated as a separate Scan Media Path Subunit from the auto Document feeder. The constituents of the Scan Media Path Subunit complex Element are represented in Figure 52. The Scan Media Path Elements are described in Table 36.
Page 85 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
250251
1281
128212831284128512861287
252
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Figure 57 Scan Media Path
Table 34 Scan Media Path Elements
Element Datatype Description or Keyword Group
Reference
ScanMediaPathDescription complex
SubunitDescription complex See 3.1.2
Page 86 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
253254
1288
1289
1290
255
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Element Datatype Description or Keyword Group
Reference
Recirculating boolean applicable to Scan Media Paths that are capable of feeding Hard Copy Documents. If value of this Element is ‘true’ then the Scan Media Path is both an input and output for the Hard Copy Documents. If the Element is missing or the value is set to ‘false’ then the Hard Copy Document is delivered to an Output Bin after scanning is complete.
[PWG5108.2]
ScanMediaPathMaxSpeed intScanMediaPathMaxSpeedUnit keyword units used for the maximum speed
of Scan Media Path. MediaPathMaxSpeedUnitWKV
[RFC3805] prtMediaPathMaxSpeedPrintUnit
ScanMediaPathMaxMediaSizeName keyword maximum size of media that can flow through the Scan Media Path in Media Self Describing Name see Media Size Self-Describing Names section 5 in [PWG5101.1]; MediaSizeNameType
. [PWG5101.1]
prtScanMediaPathMediaSizeUnit prtScanMediaPathMaxMediaFeedDir prtScanMediaPathMaxMediaXFeedDir in [RFC3805]
ScanMediaPathMinMediaSizeName keyword Minimum size of media that can flow through the Scan Media Path in Media Self Describing Name see Media Size Self-Describing Names section 5 in [PWG5101.1]; MediaSizeNameType
. [PWG5101.1]
prtScanMediaPathMediaSizeUnit prtScanMediaPathMinMediaFeedDir prtScanMediaPathMinMediaXFeedDir in [RFC3805]
ScanMediaPathType keyword type of Scan Media Path.; ScanMediaPathTypeWKV
[RFC3805] prtMediaPathType
Sides keyword the ability of the ScanMediaPath to scan multiple sides of an input media sheet. SidesWKV
[RFC2911] sides
Any various Extension point for ScanMediaPathDescription
ScanMediaPathStatus complex [PWG5108.2]SubunitStatus complex See 5.1.1SheetsCompleted int number of times a media sheets
has passed through the ScanMediaPath.
[PWG5108.2]
Any various Extension point for ScanMediaPathStatus
Any various Extension point for ScanMediaPath
5.16 ScannersThis complex Element represents the image acquisition aspects of a Scanner Device. The constituents of a Scanner Subunit are represented in Figure 53 The constituent Elements are defined in Table 37. The constituent complex Elements Scanner Addressability and Scanner Margin are represented in Figure 54 and Figure 55, with the Elements within these complex Elements identified in Table 38 and Table 39.
Page 87 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
256257
1291
1292129312941295
258
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Figure 58 Scanner
Table 35 Scanner Subunit Elements
Element Datatype Description or Keyword Group
Reference [RFC3805] *
ScannerDescription complex [PWG5108.2]
Page 88 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
259260
1296
1297
1298
261
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Element Datatype Description or Keyword Group
Reference [RFC3805] *
SubunitDescription complex See 3.1.2ScannerBitsPerPixel int number of bits per pixel used by the scanner’s image acquisition
subsystem. [PWG5108.2]
ScannerColorPlanes int number of color planes used by the scanner’s image acquisition subsystem.
[PWG5108.2]
Any various Extension point for ScannerDescription.ScannerStatus complex [PWG5108.2]
SubunitStatus complex See 3.1.1ScannerAddressabilities complex information on the available addressabilities i.e., resolution of
the Scanning hardware. See Error: Reference source not found prtMarkerAddressability
ScannerLifeCount int number of scans performed by the scanning hardware for the life of the device. The units are measured in ScannerCounterUnits.
prtMarkerLifeCount
ScannerPowerOnCount int number of scans performed by the scanning hardware since the device was lasted turned on. The count is in ScannerCounterUnits.
prtMarkerPowerOnCount
ScannerCounterUnit keyword units for ScannerCounterLife and ScannerCounterPowerOn. SubunitCounterUnitWKV
prtMarkerCounterUnit objects
ScannerMargin complex information on the Margin of the Scanning hardware. The margins provide a bounding box within which the Scanner hardware is capable of scanning. See Error: Reference source not found.
prtMarkerMargin objects
Any various Extension point for ScannerStatusAny various Extenstion point for Scanner Subunit
Figure 59 Scanner Addressability
Table 36 Scanner Addressability Elements
Element Datatype Description or Keyword Group
Reference all [RFC3805]*
ScannerAddressabilityBasis keyword confidence level of the addressability information for the Scanning hardware ObjectCounterBasisWKV
prtMarkerFeed/XFeedAddressibility out of band values
ScannerAddressabilityCross Feed int resolution in the cross feed direction i.e., fast scan direction for the Scanning hardware. This is expressed in ScannerAddressabilityUnits.
prtInterpreterXFeedAddressability
ScannerAddressabilityFeed int resolution in the feed direction i.e., slow scan direction for the Scanning hardware. This is expressed in ScannerAddressabilityUnits.
prtInterpreterFeedAddressability
ScannerAddressabilityUnit keyword SubunitAddressabilityUnitWKV prtMarkerAddressabilityUnit
Page 89 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
262263
1299
1300
1301
264
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Figure 60 Scanner Margin
Table 37 Scanner Margin Elements
Element Datatype Description or Keyword Group
Reference all [RFC3805]
ScannerMarginBasis keyword confidence level of the Margin information for the Scanning hardware. ObjectCounterBasisWKV
prtMarkerNorth/South/East/West out of band values
ScannerNorthMargin int offset from the leading edge of the scan hardware or platen where Image acquisition can occur. The units are given in ScannerAddressabilityUnit.
prtMarkerNorthMargin
ScannerSouthMargin int offset from the trailing edge of the scan hardware or platen where Image acquisition can occur. The units are given in ScannerAddressabilityUnit.
prtMarkerSouthMargin
ScannerWestMargin int offset from the west edge of the scan hardware or platen where Image acquisition can occur. The units are given in ScannerAddressabilityUnit.
prtMarkerWestMargin
ScannerEastMargin int This Element expresses the offset from the east edge of the scan hardware or platen where Image acquisition can occur. The units are given in ScannerAddressabilityUnit.
prtMarkerEastMargin
5.17 StoragesThis is a sequence of digital data storage Elements, each modeling a storage Subunit used by a Service that provides for digital data storage and recovery as a primary function. The constituents of the Storage Subunit complex Element are represented in Figure 56. A Storage complex Element contains the Elements described in Table 40.
Page 90 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
265266
1302
1303
1304
1305
1306130713081309
267
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Figure 61 Storage
Table 38 Storage Elements
Element DataType Description or Keyword Group
Reference
StorageDescription complexSubunitDescription complex See 3.1.2StorageDataEncryption boolean Data encryption is supported
Page 91 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
268269
1310
1311
1312
270
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Element DataType Description or Keyword Group
Reference
StorageMakeAndModel string information on the manufacturer of the storage Subunit including model name of the storage Subunit
[RFC 2790]
StorageName string name of the storage Subunit that is unique within a Service instance.
Values derived from IPPv1.1 ServiceStatus
StorageUri uri network location information of the storage Subunit. (applicable only to a NetworkStorage device)
Any various Extension point for StorageDescriptionStorageStatus complex
SubunitStatus complex See 3.1.1StorageFree int total bytes currently free for use by the
servicehrStorageSize minus hrStorageUsed [RFC 2790]
StorageIsRemovable boolean Storage Subunit is removable by the design of its manufacturer See Note.
hrDiskStorageRemoveble [RFC 2790]
StorageSize int total number of bytes allocated to the service hrStorageSize [RFC 2790]
StorageType keyword type of the storage Subunit (expanded from HR MIB.)StorageTypeWKV
hrStorageType [RFC 2790]
Any various Extension point for StorageStatusAny various Extension point for Storage
5.18 Vendor SubunitsThis complex Element allows the vendor to add one or more additional Subunits to his product model. These would be major hardware or software components that do not fit within the set of Subunits listed here, but which act to enhance or give additional functionality to a MFD product. Examples are a thumbprint or access card reader for security. It is modeled in Figure 57 and described in Table 41.
Page 92 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
271272
1313
1314131513161317
273
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Figure 62 Vendor Subunit
Table 39 Vendor Subunit Elements
Element Datatype Description or Keyword Group
VendorSubunitDescription
complex
SubunitDescription complex See 3.1.2Any various Extension point for VendorSubunitDescription
VendorSubunitStatus complexSubunitStatus complex See 3.1.1SubunitCounterUnit keyword SubunitCounterUnitWKVSubunitLifeCount counter
Page 93 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
274275
1318
1319
1320
276
Working Draft – PWG Semantic Model v2.0 May 9, 2023
SubunitPowerOnCount counterAny various Extension point for VendorSubunitStatus
Any various Extension point for VendorSubunit
6. Service Model Element GroupsAlthough the different MFD Services have distinct detailed models, which are described in the Service-specific specifications, the models do have a common basic structure. Further, the unifying concepts described in Chapter 2 and the similarity of aspects of each Service produce some Element commonality. Each MFD Service, and the complex Elements included in it, are composed of Elements which are:
common to all services (e.g., Service Description, Service Status) common to a subset of Services (e.g., Document Processing Capabilities, Job Description
Capabilities) and unique to a given Service.
This Chapter presents the general model structure of a Service and describes the Elements which are common to all, or to several Services, thereby eliminating the need to repeat these descriptions in each Service specification.
Note that descriptions and schema diagrams in this Chapter refer to the abstract class “Imaging Service”. This class is included in the PWG MFD XML Schema [MFD_SCHEMA] to assist in understanding the model, but it is not a basic complex Element that is actually contained in any real MFD Service. Rather, the schema representation of each individual MFD Service includes Elements corresponding to those in the abstract Imaging Service that are applicable to that individual MFD Service. The names of Elements in the abstract class are prefixed with string ”Imaging” while the names of corresponding Elements in the actual MFD Service are prefixed with the Service name (e.g., “Print”, “Scan”.) For example, “Imaging Service Capabilities” in the abstract class corresponds to “Copy Service Capabilities” in the Copy Service. The following descriptions should be read with the understanding that not all of the Elements described in the abstract Imaging Service are necessarily included in each actual MFD Service.
The abstract Imaging Service is represented in Figure 58. It is composed of a Job Table and the Element groups in the Imaging Service type:
Available Job Ticket Service Capabilities Service Capabilities Ready Service Configuration- Service Defaults Service Description Service Status Any (for PWG or vendor extension)
Services that do not process Jobs (e.g., Resource Service) do not include a Job Table or Service Defaults. Those services do not process Jobs nor act on tickets; rather, they simply process requests. Services to which a user typically supplies a Job Ticket do not include an Available FaxIn Job Ticket. That is, the Available Job Ticket is included only for those Services that have jobs created by inbound traffic (e.g., FaxIn, EmailIn).
Page 94 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
277278
1321
13221323132413251326132713281329
133013311332
1333133413351336133713381339134013411342
1343134413451346134713481349135013511352
13531354135513561357
279
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Figure 63 Abstract Imaging Service Structure
6.1 Job TableEach Job-handling Service includes a Job Table that is constituted of two lists, as represented in Figure 59:
Pending and Active Jobs appear in the Active Jobs list. Jobs that have reached a terminal state (i.e., Completed, Aborted, and Canceled) appear in the
Job History list.
Figure 64 Imaging Job Table
The Job History is optional and the amount of time a Job is retained in the Job History list is implementation specific.
The same Jobs model is used in Active Jobs and Job History and is represented in Figure 60.
Page 95 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
280281
1358
1359
1360
1361136213631364
1365
1366
13671368
1369
282
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Figure 65 Imaging Job Model
The Job Element is considered as including both overall Job Elements (Job Status, Job Ticket and Job Receipt, of which only Job Status is mandatory); and optionally, Documents, consisting of zero or more Document Elements. The Document is itself a complex Element.
Because the Job Element and the Document Element are each fairly complicated, their models are separately discussed in Chapters 5 and 6 respectively.
6.2 Service Available Job TicketMFD Services that receive an implied Job Create request by an incoming FaxIn or EmailIn transmission typically do not received a Job Ticket with the request. However, there may be information in or associated with the transmission that contain implicit Job Ticket information, such as destination or origination address, or time of day. Therefore, a single Default Job Ticket would not be adequate. Such Services may therefore include a Service Available Job Ticket, formed as shown in Figure 61.
Figure 66 Imaging Service Available Job Ticket
The Available Job Ticket is composed of a basic ImagingJobTicket complex Element, itself of a form common to all Job Tickets and described in section 5.2, and an ImagingMetrics Element. This ImagingMetrics Element provides for the conditions associated with or contained with the transmission that may impact the values of Elements in the Job Ticket. The form and contents of ImagingMetrics are Service dependent, and are discussed in the specifications of the appropriate Services.
Page 96 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
283284
1370
1371
137213731374
13751376
1377
13781379138013811382
1383
1384
13851386138713881389
285
Working Draft – PWG Semantic Model v2.0 May 9, 2023
6.3 Service Capabilities and Service Capabilities ReadyThe Service Capabilities provide information about the Elements that can be used in Job Tickets and Document Tickets to describe the desired processing of a Job and its Documents. Some Services also include a Service Capabilities Ready Element, of the same form and content as Service Capabilities. The Service Capabilities Ready Element provides information about the Elements that can be used in Job Tickets and Document Tickets without operator intervention. For example, a printer that can accept media of a given size would have that media size listed under Print Service Capabilities Media Size Name. However, if use of that media size required a particular input tray that was not mounted, that media size would not be listed under Print Service Capabilities Ready Media Size Name.
The Imaging Service Capabilities (Figure 62)) and Imaging Service Capabilities Ready Elements are grouped into:
Document Ticket Capabilities Document Processing Capabilities: Document Description Capabilities
Job Ticket Capabilities Document Processing Capabilities: Job Description Capabilities Job Processing Capabilities
These names reflect that fact that Service Capabilities are the processing and description elements that can be requested (and presumably satisfied) in the Job and Document Tickets. Because Document Processing instructions can be in either Document or Job Tickets, identical Document Processing Capabilities structures are included for both Document and Job Ticket Capabilities.
Note that the “Capabilities” Elements identified in this Chapter have the same names as the Elements that may be included in the Job or Document Ticket, identified in Chapter 5 and Chapter 6, respectively. However, a “capabilities” Element is typically multivalued because it must specify all allowable values, and this is reflected its syntax. The corresponding Job Ticket or Document Ticket Element has the specific value to be used for the Job. For example, the Input Source Capabilities Element is a sequence of keywords while the Input Source Ticket Element is a single keyword.
The following sections tabulate the Elements in each of the Service Capabilities Element groups, with the data typedatatype and brief description of each Element. Where the data typedatatype is keyword or list of keywords, the table identifies the keyword group. In general, the keywords will be either designated WKV (Well Known Value) or Extension Patterns WKV keyword groups contain “fixed” values defined by specification; please refer to the keyword group in the PWG MFD XML Schema [MFD_SCHEMA] for an explicit list of the applicable keyword values. Keyword groups that include Extension Patterns refer to a vendor’s extension keyword group. These are typically unions with a defined pattern assigned by vendors to extend the keyword value set.
The capabilities typically include both Elements inherited from the imaging service class and service dependent Elements, although there may be some commonality of these latter Elements among Services.
Page 97 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
286287
1390
13911392139313941395139613971398
139914001401140214031404140514061407
1408140914101411
141214131414141514161417
14181419142014211422142314241425
14261427
288
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Figure 67 Imaging Service Capabilities
6.4 Service Job and Document Ticket Document Processing CapabilitiesDocument Processing Capabilities are System Capabilities that identify the information about the Document Processing Elements that can be used in Job Tickets and Document Tickets. Document Processing Capabilities consists of two sequences:
Elements inherited from the Service super class as modeled in Figure 63, including Presentation Direction Number Up; Number Up. These elements are listed in Table 42.
Service specific Elements (a much larger set) that may be common to two or more Services. Generally, these elements are common among image-outputting Services such as Scan, FaxOut and EmailOut (Figure 64 and Table 43) , and among impression-outputting Services such as Print, FaxIn and EmailIn (Figure 65, Figure 66 and Figure 67 and Table 44).
Page 98 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
289290
1428
1429
1430
1431
143214331434143514361437143814391440
291
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Figure 68 Imaging Document Processing Capabilities
Table 40 Imaging Document Processing Capabilities
Element DataType Description orKeyword Group
NumberUp list of int list of number of input “pages” that are included in a single output “impression; or the number of input “images” that are included in an output image.
PresentationDirectionNumberUp list of keywords supported placement order of the input pages or images in the finished output. PresentationDirectionNumberUpWKV
Any various Extension point for ImagingDocumentProcessingCapabilities
The Service-specific Document Processing Capability elements for the Scan Service are representative of the Service-specific Document Processing Capability elements for image-outputting Services such as EmailOut and FaxOut. The elements are shown schematically in Figure 69 and Figure 69 and identified in Table 41.
Page 99 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
292293
1441
1442
1443
1444144514461447
294
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Figure 69 Representative Service-Specific Document Processing Capabilities (Scan Service)
Table 41 Service-Specific Document Processing Capabilities Image OutputPage 100 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
295296
1448
14491450
1451
297
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Element DataType Description or Keyword Group
AutoSkewCorrection boolean Service’s ability to detect and correct small skew orientation errors resulting from placement of the original Document relative to the Scan Subunit
ColorEntry list of keywords color related characteristics for the output; e.g., BlackAndWhite1, Grayscale4, RGB24, CMYK32.ColorEntryWKV, KeywordNsExtensionPattern
CompressionQualityFactor range of int range of compression factors supportedContentType list of keywords main characteristics of a Document as supported by the Service.
ContentTypeWKV DestinationUriSchemes list of strings URI Schemes supported that can be used to transfer a Digital
Document to its Destination. See [RFC4395]Exposure complex Elements relating to the perceived quality of a scanned Image AutoExposure boolean if true, Service supports automatic adjustment of Brightness Contrast
and/or Sharpness. Brightness boolean if true, Service supports operator control of brightness i Contrast boolean if true, Service supports operator control of contrast
Sharpness boolean if true, Service supports operator control of sharpness Any various Extension point for ExposureFilmScanMode list of keywords supported exposure types for scanning film
FilmScanModeWKV, KeywordNsExtensionPattern ImagesToTransfer boolean If true, Service supports specifying the number of scanned Images in a
output DigitalDocument InputSource list of keywords source of the scanned Document supported.
InputSourceWKVMediaBox complex ImageBox complex Height range of int set of ranges of integers bound to the RegionUnit Width range of int X-Offset range of int Y-Offset range of int RegionUnits keyword RegionUnitWKV MediaSizeName list of keywords MediaSizeNameType OrientationRequested list of keywords OrientationRequestedType Any various Extension point for MediaBoxResolutions complex
See [RFC2911] Resolution complex the supported sequence of resolutions in Cross Feed and Feed
direction for image capture. [RFC2911 para 4.1.15] CrossFeedDir int allowed values for resolutions, in Units, in CrossFeed direction
[RFC2911 para 4.1.15] FeedDir int allowed values for resolutions, in Units, in Feed direction
[RFC2911 para 4.1.15] Units list of keywords UnitsWKVRotation list of int the supported rotation in degrees clockwise for a scanned Document.
Vendors may extend the allowed values RotationWKV (allowed values: 0, 90, 180, 270)
Scaling complex the support for scaling.ScalingHeight range of int supported range of the Scaling in the fast scan direction. A value of
‘100’ specifies that no adjustments are made to the scanned Image. Scaling is expressed in 1 percent increments. Values below ‘100’ reduce the magnification and values above increase magnification.
ScalingWidth range of int supported range of the Scaling in the fast scan direction. A value of ‘100’ specifies that no adjustments are made to the scanned Image. Scaling is expressed in 1 percent increments. Values below ‘100’ reduce the magnification and values above increase magnification.
AutoScaling boolean the support for automatically adjusting the Scaling of the image from
Page 101 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
298299
300
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Element DataType Description or Keyword Group
the Hardcopy Document in an implementation specific mannerDocumentSizeAutoDetect boolean [WS-Scan] para.4.5.2.2.7.1 Scan Regions complex [WS-Scan] para. 4.5.2.2.11.1.1
Scan Region complex [WS-Scan] para. 4.5.2.2.11.1.1 Height range of int set of ranges of integers bound to the RegionUnitWidth range of intX-Offset range of intY-Offset range of intContentRegionUnits keyword RegionUnitWKV
Sides list of keywords SidesWKV Any various Extension point for <service> DocumentProcessingCapabilities
The Service-specific Document Processing Capability elements for the Print Service are representative of the Service-specific Document Processing Capability elements for impression-outputting Services such as EmailIn and FaxIn. The elements are shown schematically in Figure 70, Figure 70 and Figure 67 and are identified in Table 42.
Note that, as a Document Processing Element, MediaCol (Collection of attributes characterizing the media upon which the impressions are made) is a complex element with many members. It appears in many places in the model. However, within capabilities, the Element of this name is a simple Boolean Element, indicating whether or not that MediaCol is supported in conjunction with defining the media to be used for some purpose. Capabilities also includes a MediaCol Supported complex element which includes all of the constituent elements of MediaCol and the values supported by the Service for each of these elements. The description of MediaCol Supported, including the constituent elements, is in 4.3.1.1.
Page 102 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
301302
1452145314541455
1456145714581459146014611462
303
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Figure 70 Print Document Capabilities
Page 103 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
304305
1463
1464
306
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Table 42 Service-Specific Document Processing Capabilities Impression Outputs
Element DataType Description or Keyword Group
Copies range of intCoverBack complex
CoverType list of keywords CoverTypeWKV, KeywordNsExtensionPattern Media list of keywords MediaSizeAliasNameWKV, MediaSizeLegacyNamesWKV,
MediaSizeSelfDescribingNameWKVMediaType list of keywords MediaTypeWKVMediaCol boolean Indicates whether feature is supportedAny various Extension point for CoverBack
CoverFront complexCoverType list of keywords CoverTypeWKV, KeywordNsExtensionPattern Media list of keywords MediaSizeAliasNameWKV, MediaSizeLegacyNamesWKV,
MediaSizeSelfDescribingNameWKVMediaType list of keywords MediaTypeWKVMediaCol boolean Indicates whether feature is supported
Any various Extension point for CoverFront
FeedOrientation list of keywords FeedOrientationWKV KeywordNsExtensionPattern
Finishings list of keywords FinishingsWKV, KeywordNsExtensionPattern FinishingsCol complex
FinishingTemplate booleanStitching complex
StitchingReferenceEdge list of keywords StitchingReferenceEdgeWKV, KeywordNsExtensionPattern StitchingOffeset range of intStitchingLocation range of intAny various Extension point for Stiching
Any various Extension point for FinishingsColFontNameRequested list of stringsFontSizeRequestedSupported range of intForceFrontSide range of intHeaderPrint list of keywords HeaderPrintType (e.g., FaxOut and EmailOut)ImpositionTemplate list of stringsInsertSheet complex
IsheetInsertAfterPage range of intInsertCount range of intMedia list of keywords MediaSizeAliasNameWKV, MediaSizeLegacyNamesWKV,
MediaSizeSelfDescribingNameWKVMediaType list of keywords MediaTypeWKVMediaCol boolean Indicates whether feature is supportedAny various Extension point for InsertSheet
Media list of keywords MediaSizeAliasNameWKV, MediaSizeLegacyNamesWKV, MediaSizeSelfDescribingNameWKV
MediaType list of keywordsMediaColSupported complex Zero or more instances of MediaCol. See 6.4.1.1
MediaCol complex The Media Col complex element appears in several places and is separately described. See Error: Reference source not found
MediaInput TrayCheck list of keywords MediaInput TrayCheckWKV, MediaNsExtensionPattern
OrientationRequested list of keywords OrientationRequestedWKVOutputBin list of keywords OutputBinWKV, KeywordNsExtensionPatternOutputDevice string
Page 104 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
307308
1465
309
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Element DataType Description or Keyword Group
PageDelivery list of keywordsPageDeliveryWKV, KeywordNsExtensionPattern
PageRanges boolean if true, Service supports this featurePagesPerSubset boolean if true, Service supports this featurePdlInitFile complex (Note: PdlInitFiles is an artifact of the XML encoding)
PdlInitFileLocation list of strings specifies the path(s) to the directory (directories) of the supported initialization file(s) [PWG5100.11] paragraph 7.10.1.1.1
PdlInitFileName list of strings name(s) of the supported initialization file(s) [PWG5100.11] para 7.10.1.2.1
PdlInitFileNameSubdirectory boolean(attribute of PdlInitFileName
indicates whether or not the Printer will accept a FORWARD SLASH (“/”) character in the value of the “PdlInitFileName” [PWG5100.11] paragraph 7.10.1.2.2
PdlInitFileEntry list of strings specifies the name(s) of the supported entry points within the initialization file(s) [PWG5100.11] paragraph 7.10.1.3.1
Any various Extension point for PdlInitFile<service>ColorMode list of keywords PrintColorModeWKV<service>tContentOptimize list of keywords PrintContentOptimizeWKV, KeywordNsExtensionPatternQuality list of keywords
PrintQualityWKV, KeywordNsExtensionPatternResolutions complex
Resolution complex the supported sequence of resolutions in Cross Feed and Feed direction for image capture.
CrossFeedDir intFeedDir intUnits list of keywords UnitsWKV
SeparatorSheets complexSpreaderSheetsType list of keywords SeparatorSheetsTypeWKV, KeywordNsExtensionPatternMedia list of keywords MediaSizeAliasNameWKV, MediaSizeLegacyNamesWKV,
MediaSizeSelfDescribingNameWKVMediaType list of keywords MediaTypeWKVMediaCol boolean Indicates whether feature is supportedAny various Extension point for SeparatorSheets
SheetCollate list of keywords SheetCollateWKVSides list of keywords SidesWKV XImagePosition list of keywords See [PWG5100.3 ]
XImagePositionWKVXImageShift range of int See [PWG5100.3 ]]XSide1ImageShift range of intXSide2ImageShift range of intYImagePosition list of keywords See [PWG5100.3 ]]
YImagePositionWKVYImageShift range of int See [PWG5100.3 ]YSide1ImageShift range of intYSide2ImageShift range of intAny various Extension point for <service> DocumentProcessingCapabilities
6.4.1.1 Media Collection Supported
The collection of media attributes, grouped in the Media Col complex element, appears both in Document Processing and Job Processing. Therefore, Media Col Supported appears in both Document Processing Capabilities and Job Processing Capabilities. The Media Col structure is shown in Figure 68 with the
Page 105 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
310311
1466
146714681469
312
Working Draft – PWG Semantic Model v2.0 May 9, 2023
constituent capabilities elements listed in Table 45. As with other capabilities Element values, Media Col Supported elements are largely multivalued. Within an actual Job or Document Ticket, these elements would typically have a single value.
Media Col contains many member Elements. Therefore, unlike for other capabilities Elements, Services should not return Media Col Supported values in response to a general Get<service>Elements request. Rather, an explicit request for the specific Media Col elements desired is required.
Figure 71 Media Col Structure
Table 43 MediaCol Elements
Element DataType Description or Keyword
Reference [PWG5100.3]
MediaColMediaBackCoating list of keywords supported pre-process coatings applied to the media
MediaCoatingWKV, MediaColorExtensionPatternpara 3.13.10
Page 106 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
313314
147014711472
147314741475
1476
1477
1478
315
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Element DataType Description or Keyword
Reference [PWG5100.3]
MediaColor list of keywords media color supported MediaColorWKV, MediaColorExtensionPattern
para 3.13.4
MediaFrontCoating list of keywords supported pre-process coating applied to the media MediaCoatingWKV, MediaNsExtensionPattern
para 3.13.10
MediaGrain list of keywords Supported grain of the media (affects curling and foldingMediaGrainWKV, MediaNsExtensionPattern
[PWG5100.11] para 11.5.2
MediaHoleCount range of int Supported number of predrilled holes for the media para 3.13.6MediaInfo boolean If true, descriptive information for the media is supported para 3.13.3MediaKey boolean If true, service supports unique name of the media 1 para 3.13.MediaOrderCount range of int number of sheets, within an ordered sequence of sheets; after which the
sequence begins to repeat permitted by the service para 3.13.7
MediaPreprinted list of keywords Indicates supported pre-printed characteristics of the media MediaPreprintedWKV, MediaNsExtensionPattern
para 3.13.5
MediaRecycled list of keywords Indicates the supported recycled characteristics of the media MediaRecycledWKV, MediaNsExtensionPattern
para 3.13.11
MediaSize complex numerical media width and height dimensions supported by the service para 3.13.8XDimension range of int para 3.13..8.1
YDimension range of int para 3.13..8.2
MediaSizeName list of keywords Supported named sizes of the media MediaSizeNameWKV, MediaSizeNameExtensionPattern
[PWG5101.1] para 5
MediaThickness range of int Supported thickness of the media in hundredths of millimeters] [PWG5100.11para 11.5.3
MediaTooth list of keywords Supported “roughness” of the media MediaToothWKV, MediaNsExtensionPattern
[PWG5100.11] para 11.5.1
MediaType list of keywords Supported types of media MediaTypeWKV, MediaTypeExtensionPattern
para 3.13.2
MediaWeightMetric range of int Supported weight of the media in grams per square meter para 3.13.9Any various
6.4.2 Service Document Ticket Document Description Capabilities
Document Description Capabilities group Elements provide descriptive information about the Document that can be used in Document Tickets.
Document Description Capabilities may consist of two sequences:
Elements inherited from the Imaging Document Description Capabilities (Figure 72) These are listed in the table in Table 44
Service specific Elements (but these are unique to the Print Service and are not covered here.
Page 107 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
316317
1479
14801481
1482
14831484
1485
318
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Figure 72 Imaging Service Job Description Capabilities
Table 44 Imaging Service Job Description Capabilities
Element DataType DescriptionElementsNaturalLanguage list of keywords supported natural languages for the Elements with a string syntax (See [RFC3066]
NaturalLanguageWKVJobAccountingID boolean Service’s support for Job Accounts.JobAccountingUserID boolean Service’s support for a User supplied Accounting ID associated with Job.JobMandatoryElements boolean Service’s support JobMandatoryElements which is an alternative method of encoding
MustHonor flagged Elements. This Element is not valid in an XML encoding.JobMessageFromOperator boolean Service’s support of messages from the operator for Jobs.JobMessageToOperator boolean Service’s support of messages to the operator for Jobs.JobMoreInfo boolean Service’s support for a User supplied URI referencing some resource with more
information about the Job . [RFC2911] pargraph 4.3.4JobName boolean Service’s support of a name for the Job.JobOriginatingUserName boolean Service’s support of the name of the user submitting the JobJobOriginatingUserUri boolean Service’s support of the URI for the user submitting the JobJobPassword int Indicates service’s support for holding a Job until the correct password is entered.
Value is the maximum password length accepted.JobPasswordEncryption list of keywords list of password encryption and hash methods supported by the Service. See [DES],
[ECC], [AES], [MD2], [MD4], [MD5], [SHA]JobPasswordEncryptionWKV, KeywordNsExtensionPattern
KOctets boolean Service’s support for storing the size of the Job in integral units of 1024 octets. TemplateCreatorUserName boolean Service’s support for storing the user who created the template on which the Job Ticket
was based. TemplateId boolean Service’s support for storing the Id of the template on which the ScanJob Ticket was
based. TemplateInfo boolean Service’s support for storing information about the template on which Job Ticket was
based.
Page 108 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
319320
1486
1487
1488
321
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Element DataType DescriptionTemplateName boolean Service’s support for storing the user friendly name of the template on which the Job
Ticket was based.TemplateType list of keywords Service’s support for storing the type of the template on which the Job Ticket was
based. The Service should only support Job and Document Templates. TemplateTypeWKV
Figure 73 Print Service Specific Job Description Capabilities
Table 45 Service Specific Job Description Capabilities
Element DataType DescriptionCompressiuonSupplied list of keywords CompressionWKV, KeywordNsExtensionPatternDocumentCharsetSuppied list of keywords CharsetWKV, KeywordNsExtensionPatternDocumentDigitalSignatureSupplied boolean True if supportedDocumentFormatDetailsSupplied complex Service’s support of Document Format Details (See Error: Reference source
not found and Error: Reference source not found)DocumentFormatSupplied list of keywords DocumentFormatWKV, KeywordNsExtensionPatternDocumentFormatVersionSupplied boolean Service’s support for Document Format VersionDocumentMessageSupplied boolean Service’s support for Document MessageDocumentNameSupplied boolean Service’s support for Document NameAny (service specific) various an extension point for <service>JobDescriptionCapabilities
Page 109 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
322323
1489
1490
1491
324
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Figure 74 Document Format Details Structure
Table 46 Document Format Detail Elements
Element DataType Description ReferenceDocumentFormatDetailsSupplied complex Service’s support for Document Format Details (See Error:
Reference source not found) Following Elements may be supplied for each supported DocumentFormat
DocumentSourceApplicationName string Name of the application that created the document [PWG5100.5] para 9.1.13
DocumentSourceApplicationVersion string Version of the application that created the document [PWG5100.5] para 9.1.13
DocumentSourceOsName keyword Name of the operating system on which the document was generated para
[PWG5100.5] 9.1.13
DocumentSourceOsVersion string Version of the operating system on which the document was generated para
[PWG5100.5] 9.1.13
DocumentFormat keyword Document format (i.e., PDL) for this Document [RFC2911] para 3.2.1.1
DocumentFormatDeviceId string Type of device for which the document was formatted [PWG5100.5] para 9.1.13
DocumentFormatVersion string Level or version of the DocumentFormat [PWG5100.5] para 9.1.16
DocumentNaturalLanguage keyword Primary Natural Language of this Document [RFC2911] para 3.2.1.1
6.4.3 Service Job Ticket Job Processing Capabilities
The Job Processing Capabilities group Element provides information about the Job processing Elements that can be used in Job Tickets. “Capabilities” values are often just a Boolean indicating whether or not the identified Job Processing Element is supported. In other instances, it may be a list of supported values.For descriptions of the Job Processing Elements themselves, see paragraph 5.2.3.
Job Processing Capabilities consists of two sequences:
Elements inherited from the Imaging Service super class Job Processing Capabilities Type, (Error: Reference source not found) including Elements such as Job Hold Until. These are listed in Error: Reference source not found.
Service specific Elements. The FaxOut Service’s Service Job Processing Capabilities shown in Figure 74, and the Copy Service Job Processing Capabilities shown in Figure 75 and Figure 76
Page 110 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
325326
1492
1493
1494
1495
1496149714981499
1500
150115021503
15041505
327
Working Draft – PWG Semantic Model v2.0 May 9, 2023
include Service-specific capabilities applicable to several Services. Table 51 lists these Job Processing Capabilities Elements as well as some others that are not included in the example Service Schema illustrations.
Figure 75 Imaging Service Job Processing Capabilities
Table 47 Imaging Service Job Processing Capabilities
Element DataType Description orKeyword
Reference
JobDelayOutputUntil list of keywords the named events for releasing the delayed output [PWG5100.11] para 7.4JobDelayOutputUntilTime boolean Service allows a Job Ticket to specify a Date and
Time when the output delay is to expire.[PWG5100.11] para 7.5
JobHoldUntil list of keywords the named events for releasing the held Job. JobHoldUntilWKV
[RFC2911] para 4.2.2
JobHoldUntilTime boolean Service allows a Job Ticket to specify a Date / Time when a Job that is on hold will be released.
[PWG5100.11] para 7.6
JobMandatoryElements boolean The Service support sJobMandatoryElements. [PWG5100.5] para 8.1JobPhoneNumber boolean The Service supports storing the contact phone
number for the Job [PWG5100.11] para 7.7
JobPriority range of int [RFC2911] para 4.2.1JobRecipientName boolean The Service supports storing the name of the
recipient of a Job [PWG5100.11] para 7.8
Any various Extension point for JobProcessingCapabilities
Page 111 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
328329
150615071508
1509
1510
1511
330
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Figure 76 Representative Service-Specific JobProcessingCapabilities Elements (FaxOut Service Examples)
Table 48 Service-Specific JobProcessingCapabilities Elements
Element DataType Description orKeyword
Reference
BatchMode boolean True = Service supports the BatchMode element (Figure 75)
[PWG5108..2] para 7.1.2.3.5
ComfirmationSheetPrint boolean True = Service supports the ComfirmationSheetPrint element. The format of the confirmation sheet is implementation specific. (Figure 74)
CoverSheetInfo complex (Figure 74)CompanyName boolean True = Service supports the Element conaining
the user-supplied name of the company for the cover sheet.
Page 112 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
331332
1512
15131514
1515
333
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Element DataType Description orKeyword
Reference
DateTime boolean True = Service supports the Element containing the user-supplied date and time for the cover sheet.
From boolean True = Service supports the Element containing user-supplied name of the person group or entity for the cover sheet
Logo boolean True = Service supports the Element containing user-supplied URL pointing to image used as the logo on the cover sheet.
Message boolean True = Service supports the Element containing user-supplied message on the cover sheet.
Subject boolean True = Service supports the Element containing user-supplied subject line on the cover sheet.
To boolean True = Service supports the Element containing user-supplied addressee line on the cover sheet.
Any various Extension point for CoverSheetInfoDestinationUris Complex feature is supported (Figfure 74)
DestinationUriSchemes list of strings URI Schemes supported that can be used to transfer a Digital Document to its Destination. See
DestinationUriSchemes [RFC4395]
PreDialString boolean True = Service supports the Element defining a Dial string to be entered before the DestinationUri is applied. See Error: Reference source not found.
PostDialString boolean True = Service supports the Element defining a Dial string to be entered after the DestinationUri is applied. See 7.2.3.1.3.
T33Subaddress boolean True = Service supports the Element allowing T33 subaddressing. See 7.2.3.1.4.
[RFC3192]
DocumentOutputMode list of keywords (Scan, etc) DocumentOutputModeWKV, KeywordNsExtensionPattern
[PWG5108.2] para 8.1.3.3.6
JobAccountingSheets complex (Figure 75) [PWG5100.3] para 3.8JobAccountingSheetsType list of keywords JobAccountingSheetsTypWKV [PWG5100.3] para 3.8.1JobAccountingOutputBin list of keywords JobAccountingOutputBin [PWG5100.3] para 3.8.3Media list of keywords MediaSizeAliasNameWKV,
MediaSizeLegacyNamesWKV, MediaSizeSelfDescribingNameWKV MediaSizeNameExtensionPattern
[RFC2911] para 4.2.11
MediaType list of keywords MediaTypeWKV MediaTypeExtensionPattern [PWG5100.3] para 3.13.2MediaCol boolean Indicates if MediaCol is supported for
JobAccountingSheets[PWG5100.3] para 3.13
Any various Extension point for JobAccountingSheetsJobCopies range of int Numbers of copies supported (Figure 74) [PWG5100.7] para 4.1.1JobCoverBack complex (Figure 75) [PWG5100.7] para 4.1.2
CoverType list of keywords [PWG5100.3] para 3.1.2
Media list of keywords MediaSizeAliasNameWKV, MediaSizeLegacyNamesWKV, MediaSizeSelfDescribingNameWKV MediaSizeNameExtensionPattern
[RFC2911] para 4.2.11
MediaType list of keywords MediaTypeWKV MediaTypeExtensionPattern [PWG5100.3] para 3.13.2MediaCol boolean Indicates if MediaCol is supported for
JobCoverBack[PWG5100.3] para 3.13
Any various Extension point for JobCoverBackJobCoverFront complex (Figure 75) [PWG5100.7]para4.1.3
CoverType list of keywords [PWG5100.3]para3.1.2
Page 113 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
334335
336
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Element DataType Description orKeyword
Reference
Media list of keywords MediaSizeAliasNameWKV, MediaSizeLegacyNamesWKV, MediaSizeSelfDescribingNameWKV MediaSizeNameExtensionPattern
[RFC2911] para 4.2.11
MediaType list of keywords MediaTypeWKV MediaTypeExtensionPattern [PWG5100.3] para 3.13.2MediaCol boolean Indicates if MediaCol is supported for
JobCoverFront[PWG5100.3] para 3.13
Any various Extension point for JobCoverFrontJobErrorSheet complex (Figure 76)
JobErrorSheetType list of keywords JobErrorSheetTypeWKVJobErrorSheetWhen list of keywords JobErrorSheetWhenWKVMedia list of keywords MediaSizeAliasNameWKV,
MediaSizeLegacyNamesWKV, MediaSizeSelfDescribingNameWKV MediaSizeNameExtensionPattern
[RFC2911] para 4.2.11
MediaType list of keywords MediaTypeWKV MediaTypeExtensionPattern [PWG5100.3] para 3.13.2MediaCol Boolean Indicates if MediaCol is supported for
JobErrorSheet[PWG5100.3] para 3.13
Any various Extension point for JobErrorSheetJobFinishings list of keywords JobFinishingsWKV (Figure 76) [RFC2911] para 4.2.6
[PWG5100.1] para 2JobFinishingsCol complex (Figure 76) [PWG5100.3] para 3.2
FinishingTemplate list of string Allowed values [PWG5100.3] para 3.2.1Stitching complex [PWG5100.3] para 3.2.2
StitchingReferenceEdge list of keywords StitchingReferenceEdgeWKV [PWG5100.3] para 3.2.2.1StitchingOffset range of int [PWG5100.3] para 3.2.2.2StitchingLocations range of int [PWG5100.3] para 3.2.2.3Any various Extension point for Stitching
Any various Extension point for JobFinishingsColJobSaveDisposition complex (Figure 76) [PWG5100.11] para 7.9
SaveDisposition list of keywords SaveDispositionWKV [PWG5100.11] para 7.9.1.1SaveInfor complex [PWG5100.11] para 7.9.1.2
SaveDocumentFormat list of keywords SaveDocumentFormatType [PWG5100.11] para 7.9.1.2.3.3
SaveLocation list of strings URI Schemes supported that can be used to transfer a Digital Document to its Destination. See [RFC4395]
[PWG5100.11] para 7.9.1.2.3.1
SaveName boolean [PWG5100.11] para 7.9.1.2.3.2
Any various Extension point for SaveInformationAny various Extension point for JobSaveDisposition
JobSheetMessage boolean feature is supported (Figure 76) [PWG5100.3] para 3.12JobSheets list of keywords (Figure 76) JobSheetsWKV,
KeywordNsExtensionPattern[RFC2911] para 4.2.3[PWG5100.3] para 6.2
JobSheetsCol complex Error: Reference source not found
[PWG5100.3] para 3.11
JobSheets list of keywords JobSheetsWKV, KeywordNsExtensionPattern [RFC2911] para 4.2.3[PWG5100.3] para 6.2
Media list of keywords MediaSizeAliasNameWKV, MediaSizeLegacyNamesWKV, MediaSizeSelfDescribingNameWKV MediaSizeNameExtensionPattern
[RFC2911] para 4.2.11
MediaType list of keywords MediaTypeWKV MediaTypeExtensionPattern [PWG5100.3] para 3.13.2
Page 114 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
337338
339
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Element DataType Description orKeyword
Reference
MediaCol boolean Indicates if MediaCol is supported for JobAccountingSheets
[PWG5100.3] para 3.13
Any various Extension point for JobSheetsColMultipleDocumentsHandling list of keywords MultipleDocumentsHandlingWKV,
KeywordNsExtensionPattern[RFC2911] para 4.2.4
MultipleSetOriginal boolean feature is supported (Figure 74) [PWG5108.2] para 7.1.2.3.7OutputBin list of keywords (Figure 74) OutputBinWKV,
KeywordNsExtensionPattern[PWG5100.2] para 2.1 [PWG5100.5] para 8.1
OutputDevice list of string Allowed values (Print) [PWG5100.7] para 4.2.1 [PWG5100.5] para 8.1
Overrides llst of keywords List of JobTicket elements that can be used in an override for this service
[PWG5100.6] para 4.1
PagesPerSubset boolean feature is supported (Print) [PWG5100.4] para 5.3RetryInfo complex Supported capabilities of elements used to
control document transmission timeoutsNumberOfRetries range of int Allowed range of values for number of attempts to
retransmit a document in the event of transmission failure s, before aborting the job
RetryInterval range of int Allowed range of values for time duration in seconds between transmission attempts
RetryTimeout range of int Allowed range of values for time duration in seconds before terminating a transmission attempt when no document data is being sent.
Any(service specific) various an extension point for RetryInfoAny (service specific) various an extension point for <service>
JobProcessingCapabilities
6.5 Service ConfigurationThe Service Configuration Element for each service contains the subset of the Subunits identified in the System Configuration (Chapter 3) that may be necessary for that particular service. The Elements comprising each identified Subunit are described in Chapter 3.
The individual Service specific specifications define the subset of System Configuration Subunits applicable to each Service
6.6 Service DefaultsThe Service Defaults (Error: Reference source not found) can include a Default Document Ticket (Error: Reference source not found) and a Default Job Ticket (Error: Reference source not found.) These default tickets provide the values that will be used for Elements values omitted in the supplied Tickets. The processing instructions are not bound to the Job until the Job is actually processed nor are they bound to the Document until the Document is processed. The values from the Default Tickets are not copied to the Job’s Job Ticket or Document Ticket(s). If the Job Receipt is supported, the combined Elements from the user supplied Job Ticket and the applied values from the Default Job Ticket are copied to the Job Receipt.
Page 115 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
340341
1516
1517
151815191520
15211522
1523
1524152515261527152815291530
342
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Figure 77 Imaging Service Defaults
Figure 78 Basic Document Ticket Default
Figure 79 Imaging Service Job Ticket Defaults
The Default Job Ticket may contain all of the Elements in a Job Ticket, as described in section 0. The Default Document Ticket may contain all of the Elements of a supplied Document Ticket, as described in Section 6.2
Page 116 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
343344
1531
1532
1533
1534
1535
1536
1537
153815391540
345
Working Draft – PWG Semantic Model v2.0 May 9, 2023
6.7 Service DescriptionThe Service Description Elements of a Service provide descriptive information; that is, the values of the Elements can be administratively set and/or can be modified directly or indirectly through an operation. Service Description consists of two sequences.
Elements inherited from the Imaging Service super class. These are represented in Figure 80 with the constituent Elements listed in Table 52.
Service specific Elements. Service-specific Elements for the FaxOut Service, which are shared with some other Services, are represented in Error: Reference source not found. Service-specific Description Elements used by more than one Service are listed in Error: Reference source not found.
Page 117 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
346347
1541
154215431544154515461547154815491550
348
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Figure 80 Imaging Service Description
Page 118 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
349350
1551
1552
351
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Table 49 Service Description Elements
Element DataType Description or Keyword
Reference
CharsetConfigured keyword CharsetWKV [RFC2911] Para 4.3.19CharsetSupported list of keywords CharsetWKV [RFC2911] Para 4.3.19DeviceId string IEEE 1284 Device ID [PWG 5105.1] Para 11.1MakeAndModel string [RFC2911] Para 4.4.9MessageFromOperator string [RFC2911] Para 4.4.25NaturalLanguageConfigured keyword NaturalLanguageWKV [RFC2911] Para 4.4.19NaturalLanguageSupported * list of keywords NaturalLanguageWKV [RFC2911] Para 4.4.20OperationsSupported list of keywords OperationsSupportedWKV [RFC2911] Para 4.4.15OwnerURI anyUri URI that is an authoritative identifier
(e.g., a 'mailto:' URI) of the authenticated Owner of this Service instance.
[RFC3986]
OwnerVCard string A MIME vCard that contains contact information (e.g., email, postal, telephone, etc.) for the authenticated Owner of this Service instance.
[RFC2426]
ServiceGeoLocation anyUri [RFC5870]ServiceInfo string [RFC2911] Para 4.4.6ServiceLocation string [RFC2911] Para 4.4.5ServiceName string [RFC2911] Para 4.4.4VersionsSupported list of strings [RFC2911] Para 4.4.14XriSupported complex Service transport ednpoint
XriUri anyURI [RFC2911] Para 4.4.1XriAuthentication list of keywords UriAuthenticationWKV [RFC2911] Para 4.4.2XriSecurity list of keywords UriSecurityWKV [RFC2911] Para 4.4.3
Any various Extension point for ServiceDescription
6.7.1 OwnerURI
This Service Description element is a URI [RFC3986] that is an authoritative identifier (e.g., a 'mailto:' URI) of the authenticated Owner of this Service instance. This element MAY be usable to deliver notifications to the Owner. The abstract syntax for this element is a string.
6.7.2 OwnerVCard
This Service Description element is a MIME vCard [RFC2426] that contains contact information (e.g., email, postal, telephone, etc.) for the authenticated Owner of this Service instance. This element SHOULD be usable to deliver notifications (e.g., security alerts) to the service owner. The abstract syntax for this element is a string.
6.7.3 MultipleOperationTimeoutAction
This Service Description element specifies what action the service should take when a job times out. The data typedatatype for this element is keyword. This element can be extended by adding new keywords. The defined keywords are:
‘Abort’ – the job is closed and aborted, ‘Hold’ – The job is closed and put on indefinite hold, ‘Process’ – the job is closed and queued for processing.
Page 119 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
352353
1553
1554
155515561557
1558
1559156015611562
1563
156415651566156715681569
354
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Figure 81 Representative Service-Specific Service Description (FaxOut)
Table 50 Service-Specific Service Description Elements
Page 120 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
355356
1570
1571
1572
357
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Element DataType Description ReferenceCompressionDefault keyword Default Compression algorithm assumed to be used on
the Document Data [RFC2911] Para 4.4.32
CompressionSupported list of keywords Identifies the set of supported compression algorithms for Document content
[RFC2911] Para 4.4.32
DocumentFormatDefault keyword Default document format (i.e., PDL) assumed for a Document
[RFC2911] Para 3.2.1.1 [PWG5100.5] Para 9.1.12
DocumentFormatSupported list of keywords Identifies the set of supported document format s [RFC2911] Para 3.2.1.1 [PWG5100.5] Para 9.1.12
DocumentFormatDetailsDefault complex the member attributes of Doc umentFormatDetails that the Service supports See Figure 82 and Table 54
[PWG5100.7] Para 7.6 –
DocumentFormatDetailsSupported list of keyword Default Compression algorithm assumed to be used on the Document Data
[RFC2911] Para 4.4.32
DocumentFormatVersionSupported list of strings levels or versions of the DocumentFormats that the Service will accept
[PWG5100.7] Para 7.8
DocumentFormatVersionDefault string level or version of the DocumentFormat that the Service will assume when none is provided by the client
[PWG5100.7] Para 7.7
MultipleDocumentJobsSupported booleanMultipleOperationTimeout int Identifies the minimum time (in seconds) that the service
will wait between actions on an open job before timing out[RFC2911] Para 4.4.31
MultipleOperationTimeoutAction keyword value indicates what action the service should take when a job times out. This element can be extended by adding new keywords.Defined keywords are:
‘Abort’ – the job is closed and aborted, ‘Hold’ – The job is closed and put on indefinite hold, ‘Process’ – the job is closed and queued for processing.
ServiceChargeInfoUri anyURIServiceOrganizations complex
ServiceOrganization stringServiceOrganizationUnit stringAny various Extension point for ServiceOrganizations
Any various Extension point for <service>ServiceDescription
Page 121 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
358359
360
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Figure 82 Detail of DocumentFormatDetailsDefault
Table 51 Constituent Elements of DocumentFormatDetailsDefault
Element DataType ReferenceDocumentFormatDetailsDefault complex [PWG5100.7] section 7.6
DocumentSourceApplicationName stringDocumentSourceApplicationVersion stringDocumentSourceOsName keywordDocumentSourceOsVersion stringDocumentFormat keywordDocumentFormatDeviceId stringDocumentFormatVersion stringDocumentNaturalLanguage keyword
6.8 Service StatusThe Status Elements provide state information for the Service. The Elements are maintained by automata and cannot be directly set. The Element values may be modified indirectly through an operation. For example, a <service> Pause operation may result in the change of the State and State Reasons Elements.
Service Status Elements consists of two sequences. Elements inherited in the Service Status type from the Imaging Service super class including
Elements such as Id and State. This includes work counters specific to output and input of the
Page 122 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
361362
1573
1574
1575
1576
1577
157815791580
158115821583
363
Working Draft – PWG Semantic Model v2.0 May 9, 2023
service; e.g.,Images vs Impressions; Jobs vs Resources. These are listed in Table 55 and illustrated in Figure 83.
Service specific Elements. The common Service-specific Elements for each image processing Service, are the Service-specific counters, as identified in Table 56.
The Service-specific elements are differentiated by each Service having a complex <service>Counters Element which includes the counters applicable to that Service. Counters are discussed separately in Chapter 8, Counters & Timers.
Figure 83 Imaging Service Status
Table 52 Service Status Elements
Page 123 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
364365
1584158515861587
158815891590
1591
1592
1593
366
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Element DataType DescriptionAccessModes list of keywords basic access control policy for authenticated users. This Element corresponds to the
access mode property of a POSIX file and specifies the basic access control policy for the Service object, as set by the Owner. The AccessMode Element takes precedence over any externally specified access policy.ObjectAccessModeWKV
ConditionTable complex additional information on the current and past state of Services and Subunits. See Error: Reference source not found
CreateDate dateTime date and time that the Service was createdCurrentTime dateTime current date and time according the Service’s internal clockID int a32 bit Object Identifier for the Scan Service instance. It is unique withinthe containing
System.ServiceUuid anyUri An urn::uuid unique URI value [RFC4122]MessageDateTime dateTimeMessageTime intNaturalLanguage string local language currently used by the Service. This is the language used unless the
operation specifies a RequestedNaturalLanguage(example values: en-us, fr, de, ja) See [RFC3066].
SerialNumber string the serial number of the device hosting the service.State keyword current state of scanning service. The state is a unification of the service states from IPP
and the Host Resource MIB. See [RFC2911] and [RFC2790]. See paragraph9.2.1 (ObjectStateWKV )
StateMessages list of string information about the Service State and StateReasons in human readable text. If the Service supports this Element, it must be able to generate the messages in any of the natural languages supported by the Service.
StateReasons list of keywords additional detail about the service's state. The keywords are extensible. The standard keyword values are defined in paragraph 4.4.12 of [RFC2911] and paragraph 4.4.3.1 of [WS-Scan]. (StateReasonsWKVs)
UpTime int Time that the Service has been in the Operational UP state, in seconds.ImagesCompleted int Lifetime count count of what the Service has completed. See Counter Spec [PWG5106.1
Images or impressions are in units of 1; KOctets are in units of 1024 octets.ImpressionsCompleted intKOctetsProcessed intIsAcceptingJobs boolean If True, Service is currently able to accept CreateJob operation. Method of configuring the
value for this Element is implementation-specific, e.g., local console, web page.IsAcceptingResources boolean an extension point for vendor differentiation and implementation specific extensions while
maintaining interoperability.QueuedJobCount int Number of Jobs this Service has currently created but not yet completed
Table 53 Service-Specific Service Status Elements
Element DataType DescriptionServiceCounters complex the counters for the amount of work performed by the Service, timers covering utilization
and monitoring information covering errors, warnings, traffic, Job counts and configuration changes. See Chapter 10 and the PWG Counter Spec. [PWG5106.1]
6.8.1 Condition Table
The Condition Table Elements provide additional current and past state information for the Service and its associated Subunits. Note that the System’s Condition Table provides a global view of all conditions. The entries are maintained by automata and cannot be modified by users or administrators. This Element’s information maps to the Printer MIBs Alert Table [RFC3805]. One improvement is that a history may be kept for when Alerts (i.e., Conditions) are corrected.
Page 124 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
367368
1594
1595
1596
1597
15981599160016011602
369
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Note that Condition Elements consists of two sequences. A mandatory list of active conditions An optional Condition History.
Note that the only difference between the data typedatatypes for Active Condition and Condition History entries is that Condition Histories contain an Element containing the time the condition was cleared. Condition Table Elements are shown in Figure 84 and are described in Table 57.
Figure 84 Condition Table
Table 54 Condition Table Elements
Element DataType DescriptionComponent complex
Group keyword The type of Subunit/service for this conditionName string Instance identifier for the Subunit/service for this condition
Page 125 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
370371
160316041605
160616071608
1609
1610
1611
372
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Element DataType DescriptionConditionId int Condition instance identifierName keyword The Condition Name: StateReasonsWKV, KeywordNsExtensionPatternSeverity keyword Severity level of the condition: Informational, Warning, CriticalTime dateTime Date and time the condition occurredClearTime dateTime Date and time the condition was removed
6.8.2 Relationship among Service State, Service State Reasons, Condition Table and Service State Message Elements
There are a number of related elements in the Service Status group that describe the state of a Service, with the primary indicator being the Service State element. This element has a well-defined set of values that cannot be extended. The transitions between the values of Service State are also well defined. (See section 7.1 and 7.2.1 ). This permits interoperable interpretation of the state of a service by independently developed automata.
However, although the Service State element allows for a high level representation of the state of a Service, it does not provide enough detail to understand the reason for the Service being in a particular state or what work (if any) is being performed. Therefore, Service State is augmented by the Service State Reasons element. Service State Reasons has a well-defined base set of values that can be extended. Extensions are permissible by the PWG, by a vendor, or even an instance of a Service. This permits interoperable interpretation of the state reason for a service by independently developed automata with the caveat that vendor or site specific values will be treated as 'Other' values.
The Service State Reasons provides additional detail for the current state a Service. For example a Service might be in a ‘Stopped’ state as indicated by the value of Service State, but Service State Reasons might provide additional detail for the Service’s state. Service State Reasons could contain a value such as ‘Media Empty’. Note that both Service State and Service State Reasons are needed to interpret the affect of a Service State Reason on the state of a Service. For example. a “Media Empty” Service State Reason element value can indicate either a warning condition for a Service or the cause for the service to move from a ‘Processing’ state to a ‘Stopped’ state. (i.e., the Service will only move to a Stopped state if the Service requires the media previously available in that tray to continue processing the current job.)
The information inherent in the Service State Reason value may be very limited; for example ‘Media Empty’ does not identity what tray is empty. Additional information may be available in the Condition Table element of Service Status (Error: Reference source not found). The Condition Table element contains two tables that represent the current conditions and the previous conditions for the Device hosting the Service. With the example of the ‘MediaEmpty’ Service State Reason, the Current Condition table entry may contain details such as which tray is empty, the condition severity and when the condition occurred. When the condition is cleared the entry is moved to the Condition History table and the time the condition was cleared is added to the entry. Note however that there is not a one to one mapping between entries in the Condition Table and Service State Reasons entries. One condition may result in zero or more Service State Reasons and more than one service may be affected by a single condition.
While Service State and Service State Reason are intended for consumption by automata and can be localized for End User presentation by client software, State Messages is an optional status element that is intended to be presented for direct End User consumption. State Messages is derived from IPP printer-state-message ( RFC2911, para 4,4,13 [RFC2911]) and is a Server side localized set of strings that summarize the state of the Service. This element is used to provide information on the state of a Service in one or more message strings. The content of the string(s) is vendor specific and is intended to augment the information contained in Service State and Service State Reasons.
Page 126 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
373374
1612
16131614
16151616161716181619
1620162116221623162416251626
16271628162916301631163216331634
1635163616371638163916401641164216431644
1645164616471648164916501651
375
Working Draft – PWG Semantic Model v2.0 May 9, 2023
7. Imaging Job Model The general Imaging Job model includes the Job Status, Job Ticket and Job Receipt Element groups and the Documents complex Element, as shown in Error: Reference source not found. The individual Services each have their own <service>Job model, paralleling this general Imaging Job model.
The state of the Job is described in the Job Status Element. The Job Ticket and the Job Receipt contain descriptive information about the Job and about the Job and Document processing instructions. The Job Ticket and the Job Receipt have the same structure, but the Element values in the Job Ticket are the information provided by the user in the CreateJob operation while the Element values in the Job Receipt reflect what was actually used in processing the Job.
Jobs can contain zero or more Documents. (During Job creation, it is possible that temporarily there are zero Documents.) Some Services do not expose the Document object. Therefore the Imaging Job model includes the optional Documents Element, which in turn may include zero or more Document Elements. It is possible to override the Job level Document Processing instructions on a Document by Document basis by supplying Document Processing Elements in Document Tickets for the affected Documents. The Document model (described in Chapter 8) mirrors the Job model, consisting of Document Status, Document Ticket and Document Receipt. The Document Ticket like the Job Ticket represents the End User’s intent while the Document Receipt like the Job Receipt represents what the Service actually did.
Figure 85 Imaging Job
7.1 Job StatusJob Status Elements provide state information for the Job. The <service> Job Status Elements typically include Elements from the generic Imaging Job Status as well as Service-specific Elements. Imaging Job Status is modeled in Figure 86, Figure 87 and Figure 88. The Elements are described in Error: Reference Page 127 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
376377
1652
165316541655
16561657165816591660
16611662166316641665166616671668
1669
1670
1671
167216731674
378
Working Draft – PWG Semantic Model v2.0 May 9, 2023
source not found, Table 59 and Table 60. The values of these Elements are maintained by automata and cannot be set directly by a User or Administrator, although Element values can be modified indirectly through an operation. For example, the CancelJob operation on a Job may result in the change in values of the State and State Reasons Elements.
Some Service-specific Job Status Elements are represented in Error: Reference source not found and listed in Error: Reference source not found All Services include a <service>Job Counters complex Element; the constituent counters are discussed in Chapter 10. Most include an Images Completed or Impressions Completed Element. Some Services include substantially more Elements in Job Status.
Page 128 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
379380
1675167616771678
1679168016811682
381
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Figure 86 Imaging Job Status
Table 55 Job Status Elements
Page 129 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
382383
1683
1684
1685
384
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Element DataType Description or Keyword
Reference
DateTimeAtCompleted dateTime date and time at which the Job object processing was completed (or was canceled or aborted
[RFC2911] para. 4.3.14.7
DateTimeAtCreation dateTime date and time at which the Job object was created. [RFC2911] para. 4.3.14.5
DateTimeAtProcessing dateTime date and time at which the Job object first began processing [RFC2911] para. 4.3.14.6
DetailedStatusMessages list of string
additional detailed and technical information about the Job. The Service MAY localize the message(s), since they are intended for use by the system administrator or other experienced technical persons. Localization might obscure the technical meaning of such messages. Clients MUST NOT attempt to parse the value of this Element.
[PWG5100.11] para. 10.8
DocumentAccessErrors list of string
additional information about each Document access error for this Job encountered by the Service after it attempted to access or store the Image data at the locations supplied in the Job Ticket.
[RFC2911] para. 4.3.11
ErrorsCount int number of errors encountered during processing (e.g., for the Scan Service, while scanning the Hardcopy Document and generating and storing the Digital Document.)
[PWG5100.7] para. 5.1.1
JobId int uniquely identifies the Job within the Service. The Service is responsible for implementing a Job numbering scheme that will not allow two different Jobs to coexist with the same JobId.
[RFC2911] para. 4.3.2
JobUuid anyUri An urn::uuid unique URI value [RFC4122] [RFC4122]JobOriginatingUserAuthenticationInfo
complex See Table 59. [RFC2617], [RFC4556], [RFC2911]
JobOriginatingUserName string Service sets this to the most authenticated printable name that it can obtain (example: “John Doe”, \authDomain\John Doe”)
[RFC2911] para. 4.3.6
JobOriginatingUri anyUri the URL used in processing the job. For example this element would be populated with the source phone number for a FaxOut job.
See 7.1.1
JobState keyword current state of Job. The state values MUST NOT be extended by an implementation. From RFC2911, JobStateWKV
[RFC2911] para. 4.3.7
JobStateMessages string information about the Job State and StateReasons in human readable text. If the Service supports this Element, it MUST be able to generate the messages in any of the natural languages supported by the Service.
[RFC2911] para. 4.3.6
JobStateReasons list of keywords
additional detail about the Job state. The typical keyword values are listed below. Values specific to a service are identified in the specification for that service.JobStateReason
para. 4.3.8 of [RFC2911] and para. 4.5.1.3 of [WS-Scan].
JobUri string globally unique identifier for a Job. [RFC2911] para. 4.3.1
KOctetsProcessed int total number of octets processed at that time, in integral units of 1024 octets
[RFC2911] para. 4.3.18.1
MoreInfo string URI used to obtain information intended for End User consumption about this specific Job.
[RFC2911] para. 4.3.4
NumberOfDocuments int number of Documents in this Job. [RFC2911] para. 4.3.12
NumberOfInterveningJobs int number of Jobs that are "ahead" of this Job, assuming the current scheduled order.
[RFC2911] para. 4.3.15
TimeAtCompleted int time at which the Job completed in “UpTime” seconds. [RFC2911] para. 4.3.14.3
TimeAtCreation int time at which the Job was created in “UpTime” seconds. [RFC2911] para. 4.3.14.1
TimeAtProcessing int time at which the Job first began processing in “UpTime” seconds. [RFC2911] para. 4.3.14.2
UpTime int time duration (in seconds) that the service has been up and running [RFC2911] para. 4.3.14.4
WarningsCount int total number of warnings that a Service has generated while processing and delivering the Job’s Document(s)
[PWG5100.4] para. 6.1
Page 130 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
385386
387
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Element DataType Description or Keyword
Reference
ImagesCompleted int Progress measure for Job in terms of output. Output may be Images for Hardcopy Document producers and/or Impressions for Hardcopy Document consumers. See PWG Counter Spec [PWG5106.1]
[PWG5106.1] para. 5.2.1
ImpressionsCompleted int [RFC2911] para. 4.3.18.2
Any various an extension point for JobStatus
7.1.1 JobOriginatingUri
This Job Status element is the URL used in processing the job. For example this element would be populated with the source phone number for a FaxOut job. The abstract data typedatatype for this element is string.
Figure 87 Job Originating User Authentication Info
Table 56 Job Originating User Authentication Info Elements
Element DataType Description ReferenceAuthenticationType keyword Type of authentication used:
Basic, Digest: data in Token,Certificate: data in Cert,Kerberos: data in Token,Token: data in Token,RequestingUserName: data in AuthString,None: no associated dataAny vendor extended keyword: any of the fields below
RFC2617,e.g., RFC4158,RFC4556,Vendor specific contentRFC2911 No referenceVendor specific content
Token base64binary Contains a transport safe encoded token RFC4648Cert base64binary Contains a transport safe encoded certificate RFC4648AuthUri anyUri A sting with a URI syntax RFC2396AuthString string A stringAny various Vendor specific type other than one of the above
Page 131 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
388389
1686
168716881689
1690
1691
1692
390
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Figure 88 Representative Service-Specific Job Status Elements
Table 57 Service-Specific Job Status Elements
Element DataType Description ReferenceCompressionDetected keyword Compression type actually used on the Document [PWG5100.5]
para9.1.12DocumentFormatDetailsDetected complex Generated by the service to indicate the actual document
format details of the Document object[PWG5100.5] para9.1.14
DocumentSourceApplicationName string name of the application that created the document, without its version number
[PWG5100.5] para9.1.13
DocumentSourceApplicationVersion string version of the application that created the document, without its name
[PWG5100.5] para9.1.13
DocumentSourceOsName string name of the operating system, without version number, on which the document was generated
[PWG5100.5] para9.1.13
DocumentSourceOsVersion string version of the operating system, without its name, on which the document was generated
[PWG5100.5] para9.1.13
DocumentFormat keyword Document format (i.e., PDL) for the Document [RFC2911] para3.2.1.1[PWG5100.5] para9.1.12
DocumentFormatDeviceId string Identifies the type of device for which the document was formatted, including manufacturer and model, following the IEEE 1284-2000 Device ID string
[PWG5100.5] para9.1.13
DocumentFormatVersion string the level or version of the DocumentFormat. [PWG5100.5] para9.1.16
Page 132 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
391392
1693
1694
1695
393
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Element DataType Description ReferenceDocumentNaturalLanguage keyword Identifies the primary Natural Language of the Document. [RFC2911]
para3.2.1.1[PWG5100.5] para9.1.22
DocumentFormatDetected keyword service sets this to the actual DocumentFormat detected when auto-sensing
[PWG5100.5] para9.1.15
DocumentFormatVersionDetected string service sets this to the actual DocumentFormat level detected when auto-sensing
[PWG5100.5] para9.1.17
<service>JobCounters complex Counters appropriate to the Service See Chapter 10 [PWG5106.1]Images (or Impressions)Completed int Number of images (or impressions) processed by the
service[PWG5106.1]
Any various Extension point for <service>JobStatus
7.2 Job TicketThe generic Imaging Job Ticket (Error: Reference source not found) contains description and processing Elements provided by the client in the CreateJob request. This information is used by the Service during the processing of a Job and is made available to Clients through the GetJobElements operation. A subset of this information is made available through the GetActiveJobs and GetJobsHistory operations.
Figure 89 Imaging Job Ticket
The general Imaging Job Ticket indicates the Elements that may be included in a Job Ticket. The Service-specific models may contain additional Elements. A Job Ticket supplied with a CreateJob request need not contain all permitted Elements. Elements that are necessary but not supplied with the CreateJob request are supplied the by the Default<service>Job Ticket that is part of the Service model (see Error: Reference source not found, section Error: Reference source not found.) The Default Job Ticket may contain all of the same Elements as are defined for the Job Ticket. However, the Element values within a Job Ticket are specific and single-valued.
7.2.1 Job Ticket Document Processing
The Document Processing complex Element provides the Document processing instructions that have been requested by the End User at the Job level. Each Element has a Must Honor Element to indicate whether Documents within the Job must be processed according to what user has requested or whether a “best
Page 133 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
394395
1696
1697169816991700
1701
1702
17031704170517061707170817091710
1711
171217131714
396
Working Draft – PWG Semantic Model v2.0 May 9, 2023
effort” implementation is allowed. Note that the Document Processing Elements contained in the JobTicket follow the same general structure as Service Capabilities DocumentProcessing, but the Datatypes and values reflect specific instances reflecting the User’s intent.
Document Processing consists of two sequences: Elements inherited from the Imaging Service super class (just Number Up and Presentation
Direction Number Up, as shown in Figure 90 and described in Table 61. Service specific Elements (a much larger set) that may be common to two or more Services.
Generally, these elements are common among image-outputting Services such as Scan, FaxOut and EmailOut (Figure 91, Figure 92 and Figure 93 and Table 62), and among impression-outputting Services such as Print, FaxIn and EmailIn (Figure 94, Figure 95 and Figure 96 and Table 64). Some Services may have elements from both image and impression outputting groups.
Although the structure and names of constituent elements are generally the same as shown in the Service Model description (Chapter 6), the data typedatatypes and descriptions of these Elements in a Job Ticket are as described in this section.
Figure 90 JobTicket Superclass DocumentProcessing
Table 58 JobTicket Superclass DocumentProcessing Elements
Element DataType Description or Keyword Group ReferenceNumberUp fint number of input “pages” that are ro be included in a single
output “impression; or the number of input “images” that areto be included in the output image.
[RFC2911] para 4.2.9
PresentationDirectionNumberUp keyword placement order of the Images from the input Scan Regions or pdl pages on to the output Image or impression. Associated with the “NumberUp” Element PresentationDirectionNumberUpWKV
[PWG5100.3] para 3.17
Any various Extension point for ImagingDocumentProcessingCapabilities
Page 134 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
397398
171517161717
171817191720172117221723172417251726
172717281729
1730
1731
1732
399
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Figure 91 JobTicket DocumentProcessing - Image Output Services Sheet 1
Page 135 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
400401
1733
1734
402
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Figure 92 JobTicket DocumentProcessing - Image Output Services Sheet 2
Page 136 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
403404
1735
1736
405
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Figure 93 JobTicket DocumentProcessing - Image Output Services MediaBox
Table 59 Service-Specific Job Ticket Document Processing Elements - Image Output Services
Element DataType Description orKeyword
Reference
AutoSkewCorrection boolean detection and correction of small skew orientation error from the media loading from the ADF or placement on the platen by the user is to be applied.
[PWG5108.2] para 8.1.3.1.3
ColorEntry keyword color processing mode. Each keyword describes a color encoding, color space, bit depth and samples per pixel combination. See Error: Reference source not found for keywords Vendors may add additional keywords. ColorEntryWKV
[PWG5108.2] para 8.1.3.1.4
Compression keyword compression algorithm used on the Document Data, if any. CompressionWKV
[RFC2911] para 4.4.32
CompressionQualityFactor int normalized integer value used by JPEG compression to determine the amount of acceptable image loss. JPEG compression can be lossy, some amount of data is lost (not reproducible) or lossless. The higher the requested compression factor the smaller the resulting file size. The value is normalized as an integer between 0 and 100.
[PWG5108.2] para 8.1.3.1.6
ContentType keyword main characteristics of the original Document. It is used as a hint to the Scan Service on how it should handle the scanning of the Hardcopy Document. ContentTypeWKV
[PWG5108.2] para 8.1.3.1.7
Destination complex destination to which output of the Job s to be delivered. Either a directory in which the Digital Document is stored or the URI to the Digital Document file.
[PWG5108.2] para 8.1.3.1.8
Destination anyURI [PWG5108.2] para 8.1.3.1.8.1
DestinationDirectory anyURI used when the output of the Job is a set of Digital Document files stored in a directory.
[PWG5108.2] para 8.1.3.1.8.2
Any various Extension point for DestinationDocumentDigitalSignature keyword type of digital signature, if any, used in the creation of the Digital
Document. DocumentDigitalSignatureWKV, KeywordNsExtensionPattern
[PWG5100.7] para 3.2.3 [PWG5100.5] para 9.1.11
DocumentFormat keyword format used to save Digital Documents. This is given as an enumeration value of MIME type which is pwg:DocumentFormat type. DocumentFormatWKV
[RFC2911] para 3.2.1.1 and [PWG5100.5] para 9.1.12
DocumentSizeAutoDetect boolean area within the input Hardcopy Document’s media sheet side boundaries to scan are automatically determined by the device in an implementation specific manner. This Element is mutually exclusive with Scan Region.
[PWG5108.2] para 8.1.3.1.20
Page 137 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
406407
1737
1738
17391740
408
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Element DataType Description orKeyword
Reference
Exposure complex AutoExposure Element or a sequence of four Elements: Brightness, Contrast, Sharpness, and Any.
[PWG5108.2] para 8.1.3.1.11
AutoExposure boolean automatic background reduction will be performed on the input Document.
[PWG5108.2] para 8.1.3.1.11.1
Brightness int relative amount to enhance or reduce the brightness of the scanned Image. Negative values will darken the Image and positive values will lighten the Image. The value is normalized as an integer between -100 and 100.
[PWG5108.2] para 8.1.3.1.11.2
Contrast int relative amount to enhance or reduce the contrast of the scanned Image Negative values will reduce the apparent difference between light and dark pixels in the Image. Positive values will increase the apparent difference between light and dark pixels in the Image. The value is normalized as an integer between -100 and 100.
[PWG5108.2] para 8.1.3.1.11.3
Sharpness int relative amount to enhance or reduce object edges within a scanned Image. Positive values enhance object edges and negative values reduce object edges. The value is normalized as an integer between -100 and 100.
[PWG5108.2] para 8.1.3.1.11.4
Any extension point forExposureFilmScanMode keyword exposure type of the film to be scanned. The Element is valid
only if the InputSource Element is set to a value of ‘FilmReader’. FilmScanModeWKV, KeywordNsExtensionPattern
[PWG5108.2] para 8.1.3.1.12
ImagesToTransfer int number of Images to scan from the Hardcopy Document. [PWG5108.2] para 8.1.3.1.13
InputSource keyword source of the scanned Document. InputSourceWKV [PWG5108.2] para 8.1.3.1.14
MediaBox complex Applicable only when the Document format used to store the Digital Document has a similar construct that controls the placement and bounding of the scanned Image on the Document format specific page Image. Prior to applying all other processing Elements are assumed to have been applied.
[PWG5108.2] para 6.5.3
ImageBox complex region where the Image from the scan of the Scan Region will be placed.
[PWG5108.2] para 6.5.3
Height int height of the image box in RegionUnits. [PWG5108.2] para 7.1.2.1.19.1
Width int width of the image box in RegionUnits. [PWG5108.2] para 7.1.2.1.19.2
X-Offset int offset, positive or negative, on the X axis from the origin of the MediaBox in RegionUnits.
[PWG5108.2] para 7.1.2.1.19.3
Y-Offset int offset, positive or negative, on the Y axis from the origin of the MediaBox in RegionUnits
[PWG5108.2] para 7.1.2.1.19.4
Any various extension point for ImageBoxRegionUnits keyword unit used for specifying all dimensions defining the region.
RegionUnitWKV[PWG5108.2] para 7.1.2.1.19.5
ImageCroppingPolicy keyword controls handling of mismatches in the size of the Image and the intersection of the ImageBox and MediaBox where the Image will be placed. ImageCroppingPolicyWKV, KeywordNsExtensionPattern
[PWG5108.2] para 8.1.3.1.15.2
MediaSizeName keyword identifies the size of the canvas for an Image in the Digital Document expressed as a media size name. MediaSizeNameType
[PWG5101.1] para 5
OrientationRequested keyword identifies the orientation of the MediaBox OrientationRequestedType
[RFC2911] para 4.2.10
Any various Extension point for MediaBox
Page 138 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
409410
411
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Element DataType Description orKeyword
Reference
Resolution complex resolution in the Feed and Cross Feed directions at which to impress or capture the Image. The Resolution data structure does not limit the values. However, individual devices may limit the range of options to a predefined list or range. This information will be available as part of the Service Capabilities provided as a result of a Get,serevice>Elements query. Resolution is specified in pixels per inch or pixels per centimeter. Constituent elements of Resolution are described in Table 64.
RFC2911] para 4.2.12
Rotation keyword amount each Image of a scanned Document is to be rotated. Specified in limted set of values in degrees clockwise. Standard values are 90, 180, 270. Vendors may add more. RotationWKV
[PWG5108.2] para 8.1.3.1.17
Scaling complex scaling to be applied to the scanned Image. Isomorphic (i.e., the aspect ratio of the Image does not change) is accomplished by specifying the same values for ScalingWidth and ScalingHeight. A value of ‘100’ specifies that no adjustments are made to the scanned Image. Magnification is expressed in 1 percent increments. Values below ‘100’ reduce the magnification and values above increase magnification.
[PWG5108.2] para 8.1.3.1.18
ScalingHeight int scaling in the fast scan direction expressed in 1 percent increments. Values below ‘100’ reduce the magnification and values above increase magnification.
[PWG5108.2] para 8.1.3.1.18.1
ScalingWidth int scaling in the slow scan direction expressed in 1 percent increments. Values below ‘100’ reduce the magnification and values above increase magnification.
[PWG5108.2] para 8.1.3.1.18.2
AutoScaling boolean scaling of the image to be automatic, in an implementation specific manner.
[PWG5108.2] para 8.1.3.1.18.3
ScanRegions complex areas within the input Hardcopy Document’s media sheet side boundaries to scan. If Scan Region is not specified, the device should use 0 as the offsets and the width and height of the InputSize, if given. If Scan Region is not specified and InputSize is not specified or cannot be determined by the device, the implementation is up to the hardware vendor. Is mutually exclusive with DocumentSizeAutoDetect.
[PWG5108.2] para 8.1.3.1.19
ScanRegion complex See 4.6.1 [PWG5108.2] para 8.1.3.1.19.1
Height int height of the Scan Region in RegionUnits [PWG5108.2] para 8.1.3.1.19.1.1
Width int width of the Scan Region in RegionUnits Width corresponds to the fast scan direction and Height corresponds to the slow scan direction.
[PWG5108.2] para 8.1.3.1.19.1.2
X-Offset int offset, positive or negative, on the X axis from the West Margin of the Scanner Subunit in RegionUnits
[PWG5108.2] para 8.1.3.1.19.1.3
Y-Offset int offset, positive or negative, on the Y axis from the West Margin of the Scanner Subunit in RegionUnits
[PWG5108.2] para 8.1.3.1.19.1.4
ContentRegionUnits keyword units used for specifying the region RegionUnitWKV
[PWG5108.2] para 8.1.3.1.19.1.5
Any various Extension point for ScanRegionDocumentSizeAutoDetect boolean True= document size automatically determinedSides keyword SidesWKVAny various extension point for JobTicketDocumentProcessing
Note: the ColorEntry Element describes the color processing mode. Each keyword describes a color encoding, color space, bit depth and samples per pixel combination. Vendors may add additional keywords.
Table 60 Color Processing Elements
Page 139 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
412413
174117421743
1744
414
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Keyword Color Type Color Encoding Bit Depth Samples per pixelBlackandWhite1 Binary 1 1Grayscale4 Gray 4 4Grayscale8 Gray 8 8Grayscale16 Gray 16 16RGB24 color RGB 24 8RGB48 color RGB 48 16RGBa32 color RGB 32 8RGBa64 color RGB 64 16CMYK32 color CMYK 32 8CMYK64 color CMYK 64 16
7.2.1.1 HeaderPrint
This Document Processing element specifies Indicates how a transmitted document header is added to the outbound transmission by a service (e.g., FaxOut EmailOut). The data typedatatype for this element is keyword. This element can be extended by adding new keywords. The corresponding Document Ticket Capabilities element is a list of keywords specifying the values supported by the implementation. The defined keywords are:
‘Inside’ – the header is added within document image for transmission, ‘Outside’ – The header is added outside the document image for transmission, ‘NoPrint’ – the header is not added to the document image for transmission.
Figure 94 JobTicket DocumentProcessing - Impression Output Services Sheet 1
Figure 95 JobTicket DocumentProcessing – Impression Output Services Sheet 2
Page 140 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
415416
1745
17461747174817491750175117521753
1754
1755
1756
1757
1758
417
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Figure 96 JobTicket DocumentProcessing – Impression Output Services Sheet 3
Table 61 Service-Specific Job Ticket Document Processing Elements - Impression Output Services
Element DataType Description orKeyword
Reference
Copies int [RFC2911] para 4.2.5
CoverBack complex Note that all complex Elements referring to a sheet of physical media upon which an impression could be made, are of the same structure as illustrated for CoverBack. This applies to CoverFront, ISheetType, SeparatorSheet, eyc.
[PWG5100.3] para 3.1
CoverType keyword CoverTypeWKV, KeywordNsExtensionPattern [PWG5100.3] para 3.1.2
Media keyword MediaSizeAliasNameWKV, MediaSizeLegacyNamesWKV, MediaSizeSelfDescribingNameWKV
[RFC2911] para 4.2.11
MediaType keyword MediaTypeWKV [PWG5100.3] para 3.13.2
MediaCol complex See Error: Reference source not found [PWG5100.3] para 3.13
Any various Extension point for CoverBack [PWG5100.3] para 3.13.2
CoverFront complex [PWG5100.3] para 3.1
CoverType keyword CoverTypeWKV, KeywordNsExtensionPattern [PWG5100.3] para 3.1.2
Media keyword MediaSizeAliasNameWKV, MediaSizeLegacyNamesWKV, MediaSizeSelfDescribingNameWKV
[RFC2911] para 4.2.11
MediaType keyword MediaTypeWKV [PWG5100.3] para 3.13.2
MediaCol complex See Error: Reference source not found [PWG5100.3] para 3.13
Any various Extension point for CoverFrontFeedOrientation keyword FeedOrientationWKV KeywordNsExtensionPattern [PWG5100.11]
para 7.1FilmScanMode keyword exposure type of the film to be scanned. The Element is valid
only if the InputSource Element is set to a value of ‘FilmReader’. FilmScanModeWKV, KeywordNsExtensionPattern
[PWG5108.2] para 8.1.3.1.12
Finishings keyword FinishingsWKV, KeywordNsExtensionPattern [RFC2911] para 4.2.6[PWG5100.1] para 2
FinishingsCol complex [PWG5100.3] para 3.2
FinishingTemplate string A string specifying some particular finishing operation [PWG5100.3] para 3.2.1
Stitching complex [PWG5100.3] para 3.2.2
StitchingReferenceEdge keyword Specifies the stitching reference edge of the output media StitchingReferenceEdgeWKV, KeywordNsExtensionPattern
[PWG5100.3] para 3.2.2.1
StitchingOffeset int The perpendicular distance from the reference edge to the stitching axis in hundredths of a millimeter.
[PWG5100.3] para 3.2.2.2
StitchingLocations int The distance along the stitching axis where a stitch will be placed in hundredths of a millimeter
[PWG5100.3] para 3.2.2.3
Any various Extension point for StitchingAny various Extension point for FinishingsCol
Page 141 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
418419
1759
17601761
420
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Element DataType Description orKeyword
Reference
FontNameRequested string Specifies the font name for a document format that does not have inherent font information
[PWG5100.11] para 7.2
FontSizeRequested int Specifies the font size for a document format that does not have inherent font information
[PWG5100.11] para 7.3
ForceFrontSide int Forces the specified pages to be printed on the front side of a sheet of media.
[PWG5100.3] para 3.3
HeaderPrint keyword Indicates how a transmitted document header is added to the outbound transmission by the service (FaxOut EmailOut)HeaderPrintWKV, KeywordNsExtensionPattern
See 7.2.1.1
ImpositionTemplate string Specifies imposition method for laying out finished page images onto the surface of output media
[PWG5100.3] para 3.4
InsertSheet complex Specifies how Insert Sheets are to be inserted into the sequence of media sheets that are produced for each copy of the documents
[PWG5100.3] para 3.5
ISheetInsertAfterPage int Specifies the input page after which the Insert Sheet will be
placed. [PWG5100.3] para 3.5.1
InsertCount int Specifies the number of Insert Sheet to insert [PWG5100.3] para 3.5.2
Media keyword MediaSizeAliasNameWKV, MediaSizeLegacyNamesWKV, MediaSizeSelfDescribingNameWKV
[RFC2911] para 4.2.11
MediaType keyword MediaTypeWKV [PWG5100.3] para 3.13.2
MediaCol complex See Figure 97, and Error: Reference source not found [PWG5100.3] para 3.13
Any various Extension point for InsertSheetMedia keyword MediaSizeAliasNameWKV, MediaSizeLegacyNamesWKV,
MediaSizeSelfDescribingNameWKV[RFC2911] para 4.2.11
MediaType keyword MediaTypeWKV [PWG5100.3] para 3.13.2
MediaCol complex Figure 97, and Error: Reference source not found [PWG5100.3] para 3.13
MediaInputTrayCheck keyword characteristics of the media in the identified input tray must match the characteristics of the media identified by the "media" or "media-col" element. MediaInput TrayCheckWKV, MediaNsExtensionPattern
[PWG5100.3] para 3.14
OrientationRequested keyword The desired orientation for printed pages for document formats that don’t have a built-in orientation. OrientationRequestedWKV
[RFC2911] para 4.2.10
OutputBin keyword Specifies the output bin where the job is to be delivered. OutputBinWKV, KeywordNsExtensionPattern
[PWG5100.2] para 2.1 [PWG5100.5] para 8.1
OutputDevice string Specifies the device where the pages of of a Job/Document will be printed
[PWG5100.7] para 4.2.1 [PWG5100.5] para 8.1
PageDelivery keyword Indicates whether the pages of the job are to be delivered to the output bin or finisher in the same page order as the original document and face up or face down PageDeliveryWKV, KeywordNsExtensionPattern
[PWG5100.3] para 3.15
PageRanges range of int Specifies a range of pages in the document data to be output [RFC2911] para 4.2.7
PagesPerSubset int Combines all of the Pages of all of the Documents into a single stream of -Pages. Then the Printer partitions that single stream into contiguous subsets of -Pages according to the list of integers
[PWG5100.4] para 5.3
PdlInitFile complex (Note: PdlInitFiles is an artifact of the XML encoding) [PWG5100.11] para 7.10
Page 142 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
421422
423
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Element DataType Description orKeyword
Reference
PdlInitFileLocation Uri Absolute URI that specifies the path to the directory where the initialization file to be sent to the Printer’s PDL interpreter will be found
[PWG5100.11] para 7.10.1.1
PdlInitFileName string specifies the name of the initialization file within the directory [PWG5100.11] para 7.10.1.2
PdlInitFileEntry string specifies an entry point within the init file at which the PDL interpreter starts.
[PWG5100.11] para 7.10.1.2
PrintContentOptimize keyword PrintContentOptimizeWKV, KeywordNsExtensionPattern [PWG5100.7] para 4.2.2 [PWG5100.5] para 8.1
Quality keyword PrintQualityWKV, KeywordNsExtensionPattern [RFC2911] para 4.2.13
Resolution complex resolution in the Feed and Cross Feed directions at which to impress or capture the Image. The Resolution data structure does not limit the values. However, individual devices may limit the range of options to a predefined list or range. This information will be available as part of the Service Capabilities provided as a result of a Get,serevice>Elements query. Resolution is specified in pixels per inch or pixels per centimeter.
RFC2911] para 4.2.12
CrossFeedDir int resolution in Units for the Cross Feed directions at which to capture the Image
RFC2911] para 4.1.15
FeedDir int resolution in Units for the Feed directions at which to capture the Image
RFC2911] para 4.1.15
Units keyword units used to express the resolution UnitsWKV
RFC2911] para 4.1.15
SeparatorSheets complex Specifies the separator sheets to be printed with the Document [PWG5100.3] para 3.18
SpreaderSheetsType keyword Specifies the separator sheets typeSeparatorSheetsTypeWKV, KeywordNsExtensionPattern
[PWG5100.3] para 3.18.1
Media keyword MediaSizeAliasNameWKV, MediaSizeLegacyNamesWKV, MediaSizeSelfDescribingNameWKV
[RFC2911] para 4.2.11
MediaType keyword MediaTypeWKV [PWG5100.3] para 3.13.2
MediaCol complex See Figure 97 and Error: Reference source not found [PWG5100.3] para 3.13
Any various Extension point for SeparatorSheetsSheetCollate keyword SheetCollateWKV [PWG5100.3]
para 3.18.1Sides keyword SidesWKVXImagePosition keyword XImagePositionWKV [PWG5100.3]
para 3.19.2XImageShift int Causes the Finished-Page Image to be shifted in position with
respect to the x-axis of the media[PWG5100.3] para 3.19.3
XSide1ImageShift int Causes each Finished-Page Image that would be placed on the front side of a sheet to be shifted in position with respect to the x-axis of the media
[PWG5100.3] para 3.19.4
XSide2ImageShift int Causes each Finished-Page Image that would be placed on the backside of a sheet to be shifted in position with respect to the x-axis of the media
[PWG5100.3] para 3.19.5
YImagePosition keyword YImagePositionWKV [PWG5100.3] para 3.19.6
YImageShift int Causes the Finished-Page Image to be shifted in position with respect to the y-axis of the media
[PWG5100.3] para 3.19.7
YSide1ImageShift int Causes each Finished-Page Image that would be placed on the front side of a sheet to be shifted in position with respect to the y-axis of the media
[PWG5100.3] para 3.19.8
Page 143 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
424425
426
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Element DataType Description orKeyword
Reference
YSide2ImageShift int Causes each Finished-Page Image that would be placed on the backside of a sheet to be shifted in position with respect to the y-axis of the media
[PWG5100.3] para 3.19.9
Any various extension point for JobTicketDocumentProcessing
7.2.1.2 Media Collection (Specific)
The collection of media attributes, grouped in the Media Col complex Element, appears many places where media is to be defined, or capabilities of handling media are identified. The Media Col capabilities structure was shown in Error: Reference source not found with the constituent capabilities elements listed in Error: Reference source not found. The Media Col structure when referring to a specific item of media (a medium) is represented in Error: Reference source not found, with the Elements listed in Error: Reference source not found.
Media Col contains many member Elements. Therefore, unlike for other Job or Document Elements, Services should not return Media Col values in response to a Get<service>JobElements or Get<service>JobElements request. An explicit request for the specific Media Col elements is required.
Page 144 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
427428
1762
176317641765176617671768
176917701771
429
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Figure 97 Media Col Structure Specific
Table 62 Media Collection Elements in Job Ticket
Page 145 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
430431
1772
1773
1774
432
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Element DataType
Description or Keyword
Reference [PWG5100.3]
MediaColMediaBackCoating keyword pre-process coatings applied to the media
MediaCoatingWKV, MediaColorExtensionPatternpara 3.13.10
MediaColor keyword color of the media MediaColorWKV, MediaColorExtensionPattern
para 3.13.4
MediaFrontCoating keyword pre-process coatings applied to the media MediaCoatingWKV, MediaNsExtensionPattern
para 3.13.10
MediaGrain keyword grain of the media (affects curling and folding)MediaGrainWKV, MediaNsExtensionPattern
[PWG5100.11] para 11.5.2
MediaHoleCount int number of predrilled holes for the media para 3.13.6MediaInfo string information that helps describe the media instance para 3.13.3MediaKey string unique name of the media. The media that MediaKey represents is a named
collection of MediaCol elements and their valuespara 3.13.1
MediaOrderCount int number of sheets, within an ordered sequence of sheets; after which the sequence begins to repeat
para 3.13.7
MediaPreprinted keyword pre-printed characteristics of the media MediaPreprintedWKV, MediaNsExtensionPattern
Para 3.13.5
MediaRecycled keyword recycled characteristics of the media MediaRecycledWKV, MediaNsExtensionPattern
para 3.13.1
MediaSize complex numerical media width and height dimensions of media in hundredths of a millimeter
para 3.13.8
XDimension int para 3.13..8.1
YDimension int para 3.13..8.2
MediaSizeName keyword Name of medium size that the Printer uses for all impressions of the Job MediaSizeNameWKV, MediaSizeNameExtensionPattern
[PWG5101.1] para 5
MediaThickness int thickness of the media in .01 millimeters [PWG5100.11] para 11.5.3
MediaTooth keyword The tooth (or roughness) of the media MediaToothWKV, MediaNsExtensionPattern
[PWG5100.11] para 11.5.1
MediaType keyword t medium type used for all impressions of the JobMediaTypeWKV, MediaTypeExtensionPattern
para 3.13.2
MediaWeightMetric int weight of the desired media rounded to the nearest whole number of grams per square meter
para 3.13.9
Any various Extension point for MediaCol
7.2.2 Job Ticket Job Description
Job Description as related to a specific Job has a structure like that described for Service JobDescriptionCapabilities para. Error: Reference source not found except that in a Ticket, the values of the simple Elements correspond to actual values for the given Job rather than describing the capabilities of the Service.
The Job Description complex Element consists of two sequences. Elements inherited from the Imaging Job super class (i.e., Imaging Job Description), as
represented in Figure 98 and listed in Table 66. Service specific extensions to the super class including the extension point for vendors. Those
specific to Print Service (and also largely applicable to EmailOut and FaxOut) are represented in Figure 99 and listed in Table 67.
The group of Job Description Elements common to more than one Service that may be included in a Job Ticket are described in Error: Reference source not found. This table includes both those Elements from the general Imaging Job Description and common Service-specific Elements. Note that, although the Element names are the same or similar to those in Chapter 4, the data typedatatypes of the Elements are typically different.
Page 146 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
433434
1775
1776177717781779
178017811782178317841785
17861787178817891790
435
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Figure 98 ImagingJobDescription (Superclass)
Table 63 JobTicket ImagingJobDescription Elements (Superclass)
Element DataType Description ReferenceElementsNaturalLanguage keyword natural language of the system-generated string Elements, as
set by the End User.NaturalLanguageWKV
[RFC3066].
JobAccountingID string accounting ID associated with this Job. PWG5100.3] para 3.6
JobAccountingUserID string This Element specifies the User ID associated with the “JobAccountId”.
[PWG5100.3] para 3.7
Page 147 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
436437
1791
1792
1793
438
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Element DataType Description ReferenceJobMandatoryElements various List of PWG standard vendor-specified Elements considred
mandatory,with each Element of appropriatestatype. Identifies Ticket Elements the Scanner must honor. The Service rejects the request for Job creation if any of the listed Elements are unsupported or contain values that the Service does not support. All of the remaining supplied Elements are best effort.
attribute-fidelity [RFC2911] para 15.1 and [PWG5100.5] para 8.1.1
JobMessageFromOperator string message to the End User indicating the reasons for any management action taken on this Job
[RFC2911] para 4.3.16
JobMessageToOperator string message from the End User to indicate something about the processing of this Job.
[PWG5100.3] para 3.10
JobMoreInfo anyUri User supplied URI referencing some resource with more information about this Job
[RFC2911] para 4.3.4
JobName string Service sets this to the client-supplied, end-user friendly name for the Job. When it is not supplied by the client, the Service must generate a name from other information.
[RFC2911] para 4.3.5
JobOriginatingUserName string set to the most authenticated printable name of the originating user that the service can obtain
[RFC2911] para4.3.6
JobOriginatingUserUri anyUri URI of the User originating the JobJobPassword octetString password supplied by the client, encrypted according to
method specified by the client in the JobPasswordEncryption Element.
[PWG5100.11] para 6.1
JobPasswordEncryption keyword encryption the client is using for the supplied value of the JobPassword Element. JobPasswordEncryptionWKV, KeywordNsExtensionPattern
PWG5100.11] para 6.2
KOctets int total size of this Job’s Digital Document(s) in integral units of 1024 octets.
[RFC2911] para 4.3.17.1
TemplateCreatorUserName string name of user who created the template used to create the Job Ticket (if any). Note: For a Job Template this is used to hold the most authenticated user name of the Template Creator.
[PWG5108.2] para 7.1.2.2.12
TemplateId URI ID of the template used to create the Job Ticket (if any). [PWG5108.2] para 7.1.2.2.13
TemplateInfo string TemplateInfo for the template used to create the Job Ticket (if any).
[PWG5108.2] para 7.1.2.2.14
TemplateName string name of template used to create the Job Ticket (if any). Note: For a Job Template this is used to hold the Template Repository wide unique Template name.
[PWG5108.2] para 7.1.2.2.15
TemplateType keyword type of the template used to create the Job Ticket (if any). The type of the template MUST be appropriate for the service
TemplateTypeWKV
[PWG5108.2] para 7.1.2.2.16
Any (service specific) various Extension point for JobTicketJobDescription
Page 148 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
439440
441
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Figure 99 Representative Service-Specific Job Ticket Job Description Elements (Print Service)
Table 64 Service-Specific JobTicketJobDescription Elements
Element DataType Description ReferenceCompressiuonSupplied keyword Default compression algorithm used for the Documents
Data , CompressionWKV, KeywordNsExtensionPattern
[PWG5100.7] para5.2.1
DocumentCharsetSupplied keyword The default charset of the Documents content , CharsetWKV, KeywordNsExtensionPattern
[PWG5100.7] para5.2.2
DocumentDigitalSignatureSupplied keyword The type of digital signature used in the Document Content , DigitalSignatureWKV, KeywordNsExtensionPattern
[PWG5100.7] para5.2.3
DocumentFormatDetailsSupplied complex Summarizes the default distinct contained document formats
[PWG5100.7] para5.2.4
DocumentSourceApplicationName string name of the application that created the document, without its version number
[PWG5100.5] para9.1.13
DocumentSourceApplicationVersion string version of the application that created the document, without its name
[PWG5100.5] para9.1.13
Page 149 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
442443
1794
17951796
1797
444
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Element DataType Description ReferenceDocumentSourceOsName keyword name of the operating system, without version number,
on which the document was generated[PWG5100.5] para9.1.13
DocumentSourceOsVersion string version of the operating system, without its name, on which the document was generated
[PWG5100.5] para9.1.13
DocumentFormat keyword Document format (i.e., PDL) for this Document, DocumentFormatWKV, MimeExtensionPattern
[RFC2911] para3.2.1.1[PWG5100.5] para9.1.12
DocumentFormatDeviceId string type of device for which the document was formatted, following the IEEE 1284-2000 Device ID string
[PWG5100.5] para9.1.13
DocumentFormatVersion string level or version of the DocumentFormat [PWG5100.5] para9.1.16
DocumentNaturalLanguage keyword primary Natural Language of the Document, NaturalLanguageWKV, NatLangExtensionPattern
[RFC2911] para3.2.1.1[PWG5100.5] para9.1.22
DocumentFormatSupplied keyword default Document format (i.e., PDL) for Documents in the Job , DocumentFormatWKV, KeywordNsExtensionPattern
[PWG5100.7] para5.2.5
DocumentFormatVersionSupplied string default level or version of the DocumentFormat [PWG5100.7] para5.2.6
DocumentMessageSupplied string message from either (1) the user to the operator about the Documents or (2) from the operator, system administrator, or "intelligent" process to indicate to the end user the reasons for modification or other management action taken on the Documents
[PWG5100.7] para5.2.7
DocumentNameSupplied string default name for the Documents in the Job to be used in an implementation specific manner
[PWG5100.7] para5.2.8
Impressions int total size in number of impressions in all the Job’s Document(s)
[RFC2911] para4.3.17.2
MediaSheets int total number of media sheets to be produced for this Job’s Document(s)
[RFC2911] para4.3.17.3
PageOrderReceived keyword the order of pages in this Document data as supplied with the job , PageOrdertWKV, KeywordNsExtensionPattern
[PWG5100.3] para3.16
Any (service specific) various Extension point for JobTicketJobDescription
7.2.3 JobTicket Job Processing
JobTicketJob Processing provides the Job processing instructions that have been requested by the End User. Each Element has a Must Honor Element. When the value of Must Honor is true, the Service does not process the Job unless the Element is supported; otherwise the Service processes the Job with its best effort.
The Job Processing consists of two sequences: Elements inherited from the Imaging Service super class (Error: Reference source not found)
including Elements such as Job Hold Until. These Elements are described in Table 68. Service-specific extensions to the super class. The FaxOut Service and the Copy Service include
Job Processing Elements which are also applicable to other Services. These Elements represented in Figure 101, Figure 102, Figure 103 and Figure 104. Service-specific Job Processing Elements are described in Error: Reference source not found. Note that many of the complex Element structures also appear elsewhere.
Page 150 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
445446
1798
1799180018011802
18031804180518061807180818091810
447
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Figure 100 Superclass Job Processing Elements
Table 65 Superclass JobProcessing Element Descriptions
Element DataType Description Reference
JobDelayOutputUntil keyword duration of time that a Job output is to be delayed..HoldUntilWKV
[PWG5100.11]para 7.4
JobDelayOutputUntilTime dateTime absolute date and time a Job output delay is to expire. This Element allows delay of a Job output until a specific time
[PWG5100.11]para 7.5
JobHoldUntil keyword duration of time that a Job is put on hold.. HoldUntilWKV
[RFC2911] para 4.2.2
JobHoldUntilTime dateTime absolute date and time a Jos Element allows you to hold a remotely submitted Job until a specific time for processing.
[PWG5100.11] para 5.4
JobPhoneNumber uri contact phone number for the Job owner. Can be used to contact the owner in the event additional information is required
[PWG5100.11] para5.5, [ RFC3966], [RFC4355]
JobMandatoryElements variousJobPriority int JobPriorityType [RFC2911] para4.2.1JobRecipientName string name of the intended recipient of the Job. [[PWG5100.11para 5.6
7.2.3.1 Description of DestinationUris’ Elements
This Job Processing complex element specifies destinations for the Job transmission (e.g., FaxOut). It is a sequence (type:complex) of DestinationUrisEntry each of which defines a single destination. Dial Strings were dropped when RFC3966 superseded RFC2806 [RFC2806], "Dial strings" are the actual numbers, symbols, and pauses entered by a user to place a phone call. We have added some elements to contain the Dial String information even though they could be encoded as RFC3966 compliant parameters.
7.2.3.1.1 DestinationUri
The DestinationUri is an RFC3966 [RFC3966] compliant URI. The abstract datatype is string. The corresponding Job Ticket Capabilities element for this element is DestinationUriSupported and is a set of strings. Each string contains the URI scheme supported fo use in DestinationUri.
Page 151 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
448449
1811
1812
1813
1814
18151816181718181819
1820
182118221823
450
Working Draft – PWG Semantic Model v2.0 May 9, 2023
7.2.3.1.2 PreDialString
The PreDialString is the Dial string entered before the DestinationUri is applied. The data typedatatype for a dial string is a string. The ABNF that applies to a PreDialString is given below. The corresponding Job Ticket Capabilities element is of type Boolean that indicates whether or not this element is supported.
DialString = 1*(phonedigit / dtmf-digit / pause-character)pause-character = one-second-pause / wait-for-dial-toneone-second-pause = "p"wait-for-dial-tone = "w"dtmf-digit = "*" / "A" | "B" / "C" / "D" / “#”phonedigit = DIGIT / [ visual-separator ]visual-separator = "-" / "." / "(" / ")" / "'" / "(" / ")"
7.2.3.1.3 PostDialString
The PostDialString is the Dial string entered after the DestinationUri is applied. The data typedatatype for a dial string is a string. The Dial Sting ABNF (abiove) also applies to a PostDialString. The corresponding Job Ticket Capabilities element is of type Boolean that indicates whether or not this element is supported.
7.2.3.1.4 T33Subaddress
The T33 subaddressing can be specified by the T33Subaddress element. Because a T33 subaddress can only contain digits [RFC3192], the datatype for the T33Subaddress is an integer. Multiple T33 subaddresses are not supported in a single DestinationUrisEntry. If multiple mailboxes are to be addressed, each one requires its own entry. The corresponding Job Ticket Capabilities element is of type Boolean that indicates whether or not this element is supported.
7.2.3.1.5 Any
This is the extension point for the DestinationUris element.
7.2.3.2 Description of ConfirmationSheetPrint Element
This optional Job Processing element specifies whether or not a confirmation sheet will be printed upon job completion. Services such as FaxOut offer such a feature. The data typedatatype for this element is Boolean. If ConfirmationSheetPrint is true, a confirmation sheet will be printed when the job reaches a terminating state. The format of the confirmation sheet is implementation specific. The content of the confirmation is outside the scope of this specification but is expected to conform to common practive and/or prevailing regulatory requirements. The corresponding Job Ticket Capabilities element is of type Boolean that indicates whether or not this element is supported.
7.2.3.3 Description of CoverSheetInfo’s Elements
This optional Job Processing element contains user supplied information to be put on a system generated Fax cover sheet. Note that the syntax for all the contained elements in the corresponding Job Ticket Capabilities elements are Boolean and represent the implementations support for the Job Processing elements.
Page 152 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
451452
1824
182518261827
1828182918301831183218331834
1835
183618371838
1839
18401841184218431844
1845
1846
1847
1848184918501851185218531854
1855
1856185718581859
453
Working Draft – PWG Semantic Model v2.0 May 9, 2023
7.2.3.3.1 CompanyName
This Job Processing element contains the user supplied string to place in the “Company Name” field of the system generated Fax Cover Sheet.
7.2.3.3.2 DateTime
This Job Processing element contains the date and time to place in the “Date” and “Time” fields of the system generated Fax Cover Sheet. Note this does not affect the date/time stamp contained in the Fax Protocol itself.
7.2.3.3.3 From
This Job Processing element contains a user supplied string to be placed in the “From” field of the system generated Fax Cover Sheet.
7.2.3.3.4 Logo
This Job Processing element contains a URL of an image to be placed in an appropriate location of the system generated Fax Cover Sheet.
7.2.3.3.5 Message
This Job Processing element contains the user supplied string to place in the “Message” field of the system generated Fax Cover Sheet.
7.2.3.3.6 Subject
This Job Processing element contains the user supplied string to place in the “Subject” field of the system generated Fax Cover Sheet.
7.2.3.3.7 To
This Job Processing element contains the user supplied string to place in the “To” field of the system generated Fax Cover Sheet.
7.2.3.3.8 Any
This is the extension point for the CoverSheetInfo element.
7.2.3.4 Description of RetryInfo’s Elements
This Job Processing element contains user supplied information to be used to control the attempts to complete a job after an initial failure to transmit a document.
7.2.3.4.1 NumberOfRetries
This Job Processing element specifies the number of attempts to retransmit a document in the event of transmission failure, before aborting the job. The data typedatatype for this element is an integer. The corresponding Job Ticket Capabilities element is a range of integers specifying the allowed values for number of attempts.
Page 153 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
454455
1860
18611862
1863
186418651866
1867
18681869
1870
18711872
1873
18741875
1876
18771878
1879
18801881
1882
1883
1884
18851886
1887
1888188918901891
456
Working Draft – PWG Semantic Model v2.0 May 9, 2023
7.2.3.4.2 RetryInterval
This Job Processing element specifies the time duration in seconds between transmission attempts. The data typedatatype for this element is an integer. The corresponding Job Ticket Capabilities element is a range of integers specifying the allowed values for time duration in seconds between transmission attempts.
7.2.3.4.3 RetryTimeout
This Job Processing element specifies the time duration in seconds before terminating a transmission attempt when no document data is being sent. . The data typedatatype for this element is an integer. The corresponding Job Ticket Capabilities element is a range of integers specifying the allowed values for time duration in seconds before terminating a transmission attempt when no document data is being sent.
7.2.3.4.4 Any
This is the extension point for the RetryInfo element.
Page 154 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
457458
1892
189318941895
1896
1897189818991900
1901
1902
459
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Figure 101 Representative Service-Specific Job Processing Elements (FaxOut Service) Sheet 1
Page 155 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
460461
1903
19041905
462
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Figure 102 Representative Service-Specific Job Processing Elements (FaxOut Service) Sheet 2
Figure 103 Representative Service-Specific Job Processing Elements (Copy Service) Sheet 1
Figure 104 Representative Service-Specific Job Processing Elements (Copy Service) Sheet 2
Table 66 Service-Specific Job Processing Elements
Element DataType Description or Keyword
Reference
BatchMode boolean job is to be processed in Batch Mode. Batch mode for each Service, if applicable, is defined in the specification of the Service.
[PWG5108.2] para 8.1.3.3.5
ConfirmationSheetPrint boolean if true, confirmation sheet, for example for a FaxOut Job, will be printed when the job reaches a terminating state. The format of the confirmation sheet is implementation specific.
See 7.2.3.2
CoverSheetInfo complex Information entered by user to be put on Fax cover sheet.
See 7.2.3.3
CompanyName string user-supplied company name See 7.2.3.3.1DateTime string user-supplied date and time See 7.2.3.3.2From string user supplied name of the person group or entity for
the cover sheetSee 7.2.3.3.3
Logo URI user supplied URL pointing to an image to use as the logo for the cover sheet
See 7.2.3.3.4
Message string user-supplied message for the cover sheet See 7.2.3.3.5Subject boolean user-supplied subject entry for the cover sheet See 7.2.3.3.6To boolean user-supplied name of the intended recipient of the
documentSee 7.2.3.3.7
Any various extension point for CoverSheetInfo See 7.2.3.3.8DestinationUris Complex see para.7.2.3.1
DestinationUri URI URL used to transfer a Digital Document to its Destination.
See 7.2.3.1
PreDialString string dial string entered before the DestinationUri is applied See Error: Reference source not found
Page 156 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
463464
1906
19071908
1909
19101911
1912
19131914
1915
465
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Element DataType Description or Keyword
Reference
PostDialString string dial string entered after the DestinationUri is applied See 7.2.3.1.3T33Subaddress int For T33 subaddressing See 7.2.3.1.4Any various extension point for DestinationUris
DocumentOutputMode keyword Way in which the output documents are partitioned among files. See para 4.6.2DocumentOutputModeWKV, KeywordNsExtensionPattern
[PWG5108.2] para 8.1.3.3.6
JobAccountingSheets complex Specifies the accounting sheet for a job [PWG5100.3] para 3.8JobAccountingSheetsType keyword Specifies the accounting sheet format
JobAccountingSheetTypeWKV, KeywordNsExtensionPattern
[PWG5100.3] para 3.8.1
Media keyword Name of media to be used for accounting sheet, MediaWKV, KeywordNsExtensionPattern
[RFC2911] para 4.2.11
MediaType keyword medium type used for the job accounting sheet MediaTypeWKV, KeywordNsExtensionPattern
[PWG5100.3] para 3.13.2
MediaCol complex See Media Collection (Specific) 5.2.1.1 [PWG5100.3] para 3.13JobAccountingOutputBin keyword output bin where the accounting sheet is to be placed,
OutputBinWKV, KeywordNsExtensionPattern
[PWG5100.3] para 3.8.3
Any various extension point for JobAccountingSheetsJobCopies int The number of copies of the Job to be printed [PWG5100.7] para 4.1.1JobCoverBack complex Characteristics of back cover for this Job
CoverType keyword Indicates if back cover is requested and which sides will contain print stream pages, CoverTypeWKV, KeywordNsExtensionPattern
[PWG5100.3]para3.1.2
Media keyword Name of mediato be used for back coverMediaSizeAliasNameWKV, MediaSizeLegacyNamesWKV, MediaSizeSelfDescribingNameWKV MediaSizeNameExtensionPattern
[RFC2911] para 4.2.11
MediaType keyword medium type to be used for back coverMediaTypeWKV, MediaTypeExtensionPattern
[PWG5100.3] para 3.13.2
MediaCol complex See 5.2.1.1 [PWG5100.3] para 3.13Any various Extension point for JobCoverBack
JobCoverFront complex Characteristics of front cover for this Job [PWG5100.7]para4.1.3Coverype keyword Indicates if front cover is requested and which sides
will contain print stream pages, CoverTypeWKV, KeywordNsExtensionPattern
[PWG5100.3]para3.1.2
Media keyword Name of mediato be used for front coverMediaSizeAliasNameWKV, MediaSizeLegacyNamesWKV, MediaSizeSelfDescribingNameWKV MediaSizeNameExtensionPattern
[RFC2911] para 4.2.11
MediaType keyword medium type to be used for front coverMediaTypeWKV, MediaTypeExtensionPattern
[PWG5100.3] para 3.13.2
MediaCol complex See 5.2.1.1 [PWG5100.3] para 3.13Any various Extension point for JobCover Front
JobErrorSheet complex Characteristics of JobErrorSheet for this Job [PWG5100.3] para 3.9JobErrorSheetType keyword Indicates if JobErrorSheet is requested and which
sides will contain print [PWG5100.3] para 3.9.1
JobErrorSheetWhen keyword Indicatedsconditions to produce JobErrorSheetJobErrorSheetTypeWKV, KeywordNsExtensionPattern
Page 157 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
466467
468
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Element DataType Description or Keyword
Reference
Media keyword Name of mediato be used for JobErrorSheetMediaSizeAliasNameWKV, MediaSizeLegacyNamesWKV, MediaSizeSelfDescribingNameWKV MediaSizeNameExtensionPattern
[RFC2911] para 4.2.11
MediaType keyword medium type to be used for front coverMediaTypeWKV, MediaTypeExtensionPattern
[PWG5100.3] para 3.13.2
MediaCol complex See 5.2.1.1 [PWG5100.3] para 3.13Any various extension point for JobErrorSheet
JobFinishings keyword finishing that the Printer uses for each job copy of the Job, FinishingsWKV, KeywordNsExtensionPattern
[RFC2911] para 4.2.6[PWG5100.1] para 2[PWG5100.7] para 4.1.4
JobFinishingsCol complex specify detailed finishing options not possible with the “JobFinishings”
[PWG5100.3] para 3.2
FinishingTemplate string string specifying some particular finishing operation [PWG5100.3] para 3.2.1Stiching complex detailed stitching parameters [PWG5100.3] para 3.2.2
StitchingReferenceEdge keyword stitching reference edge of the output media StitchingReferenceEdgeWKV, KeywordNsExtensionPattern
[PWG5100.3] para 3.2.2.1
StitchingOffset int perpendicular distance from the reference edge to the stitching axis in hundredths of a millimeter.
[PWG5100.3] para 3.2.2.2
StitchingLocations int distance along the stitching axis where a stitch will be placed in hundredths of a millimeter
[PWG5100.3] para 3.2.2.3
Any various extension point for StichingAny various extension point for JobFinishingsCol
JobSaveDisposition complex used to archive/save the Document Data of a job [PWG5100.11] para 7.9SaveDisposition keyword specifies whether or not the job MUST be printed
and/or saved, SaveDispositionWKV, KeywordNsExtensionPattern
[PWG5100.11] para 7.9.1
SaveInfo complex [PWG5100.11] para 7.9.1.2
SaveDocumentFormat keyword SaveDocumentFormatType DocumentFormatWKV, MimeExtensionPattern
[PWG5100.11] para 7.9.1.2.3
SaveLocation uri path to the directory as a URI where the Service saves the Document Data and other information
[PWG5100.11] para 7.9.1.2.1
SaveName string name of the saved job [PWG5100.11] para 7.9.1.2.2
Any various Extension point for SaveInfoAny various Extension point for JobSaveDisposition
JobSheetMessage string a message that is delivered with the job [PWG5100.3] para 3.12JobSheets Specifies which Job start/end sheet(s), will be printed
with a JobJobSheetsWKV, KeywordNsExtensionPattern
[RFC2911] para 4.2.3[PWG5100.3] para 6.2
JobSheetsCol complex specify the media for the JobSheet [PWG5100.3] para 3.11JobSheets Specifies which job start/end sheet(s), will be printed
with a Job JobSheetsWKV, KeywordNsExtensionPattern
[RFC2911] para 4.2.3[PWG5100.3] para 6.2
Media keyword Name of media to be sued for JobSheetsMediaWKV, KeywordNsExtensionPattern
[RFC2911] para 4.2.11
MediaType keyword medium type used for JobSheets MediaTypeWKV, KeywordNsExtensionPattern
[PWG5100.3] para 3.13.2
MediaCol complex See Media Collection (Specific) 5.2.1 [PWG5100.3] para 3.13Any various Extension point for JobSheetsCol
MultipleDocumentsHandling keyword MultipleDocumentsHandlingWKV, KeywordNsExtensionPattern
[RFC2911] para 4.2.4
Page 158 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
469470
471
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Element DataType Description or Keyword
Reference
MutipleSetOriginal boolean Service is required to intake multiple sets of originals from the selected inpb will be released after being put on hold. Thiut source.
[PWG5108.2] para 8.1.3.3.7
OutputBin keyword output bin where the Job is to be placedOutputBinWKV, KeywordNsExtensionPattern
[PWG5100.2] para 2.1 [PWG5100.5] para 8.1
OutputDevice string Requested OutputDevice [PWG5100.7] para 4.2.1 [PWG5100.5] para 8.1
Overrides complex Page processing overrides [PWG5100.6] para 4.1Pages range of
intidentifies one or more pages where the override will be applied
[PWG5100.6] para 4.1.1
DocumentNumbers range of int
identifies one or more documents in which the pages will have the override applied
[PWG5100.6] para 4.1.2
DocumentCopies range of int
identifies one or more copies of the document in which the pages will have the override applied
[PWG5100.6] para 4.1.3
OverridingElements list of document ticket elements
Document Ticket processing elements to apply to the specified Document pages
[PWG5100.6] para 4.1.4
Any various Extension point for OverridesPagesPerSubset int Combines all of the Pages of all of the Documents
into a single stream of -Pages. Then the Printer partitions that single stream into contiguous subsets of -Pages according to the value of this Element
[PWG5100.4] para 5.3
RetryInfo complex Supported capabilities of elements used to control document transmission timeouts
See 7.2.3.4
NumberOfRetries int number of retries before Job aborts See 7.2.3.4.1RetryInterval int time duration in seconds between retry attempts See 7.2.3.4.2RetryTimeout int time duration in seconds before terminating a retry See 7.2.3.4.3
Any (service specific) various an extension point for RetryInfo See 7.2.3.4.4Any various Extension point for Job Processing
7.3 Job ReceiptThis Element has exactly the same structure as the Job Ticket. For each processing Element of a Job, it records the actual value used by the Service for processing the Job. It contains the Elements supplied by the Client and applied to the Job, any Element or values substitutions made by the Service and any default Elements or values applied by the Service. See paragraph 7.2 for Element descriptions.
Page 159 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
472473
1916
1917191819191920
474
Working Draft – PWG Semantic Model v2.0 May 9, 2023
8. Document ModelThe general Imaging Document model includes the Document Status, Document Ticket and Document Receipt Element groups, as shown in Error: Reference source not found. The individual Services that include accessible Document objects each have their own <service>Document model, paralleling this general Imaging Document model. Jobs can contain zero or more Documents. During Job creation, it is possible that temporarily there are zero Documents. Note that some Services do not include accessible <service>Documents.
The state of the Document is described in the Document Status Element. This contains descriptive information about the Document processing instructions. The Document Ticket and the Document Receipt have the same structure, but the Element values in the Document Ticket are the information provided by the user in the CreateJob operation while the Element values in the Document Receipt reflect what was actually used in processing the Document.
Document Tickets allow a User to supply Document Processing Elements to override the Document Processing instructions in the Job Ticket on a Document by Document basis. This Document model mirrors the Job model, described in Chapter 7.
Figure 105 Imaging Document Model
8.1 Document StatusJob Status consists of two sequences.
Elements inherited from the Imaging Document super class (i.e., Imaging Document Status) See Figure 106 for the structure and Table 70 for the Elements description.
Service specific extensions to the super class such as the Service counters. Representative Service-specific Elements are represented in Figure 107 and described in Table 71.
Document Status Elements including both those from the abstract Imaging Status and representative Service-specific elements are described in The complex Elements in the table also occur elsewhere. Please refer to the reference sections for the details of these elements.
Page 160 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
475476
1921
192219231924192519261927
19281929193019311932
193319341935
1936
1937
1938
19391940194119421943
194419451946
477
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Figure 106 Imaging Document Status
Table 67 Document Status Elements
Page 161 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
478479
1947
1948
1949
480
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Element DataType Description or Keyword Group ReferenceDateTimeAtCompleted DateTime date and time at which the Job object completed or was
canceled or aborted [RFC2911] para 4.3.14.7
DateTimeAtCreation DateTime date and time at which the Job object created. [RFC2911] para 4.3.14.5
DateTimeAtProcessing DateTime date and time at which the Job object first began processing
[RFC2911] para 4.3.14.6
DetailedStatusMessages list of string
additional detailed and technical information about the Job. Element
[RFC2911] para 4.3.10
DocumentAccessErrors list of string
additional information about each Document access error for this Job encountered by the Service after attempting to store or access Document Data at the locations supplied
[RFC2911] para 4.3.11
DocumentNumber int uniquely identifies a Document within a Job. [PWG5100.4] para 9.2, [PWG5100.5] para 9.1.23
DocumentUuid anyUri An urn::uuid unique URI value [RFC4122]DocumentState keyword current state of Document.
DocumentStateWKV [PWG5100.5] para 9.1.25
DocumentStateMessage string information about the Document State and StateReasons in human readable text.Element.
[PWG5100.5] para 9.1.26
DocumentStateReasons list of keywords
additional detail about the Document state. The specific keywords allowed are defined within the specification for the Service.DocumentStateReasonsWKV, KeywordNsExtensionPattern
[PWG5100.5] para 9.1.27 and {RFC2911] para 4.3.8 for standard values.
DocumentUri anyUri An urn::uuid unique URI value [RFC4122]ErrorsCount int number of errors encountered while processing the
Document [PWG5100.5] para 9.1.29
JobId int JobID of the Job to which this Document belongs. [PWG5100.5] para 9.1.18
JobUuid anyUri An urn::uuid unique URI value [RFC4122]JobUri URI globally unique ID of the Job to which this Document
belongs [PWG5100.5] para 9.1.19
KOctetsProcessed int total number of octets processed to that point, in integral units of 1024 octets
[RFC2911] para 4.3.17.1
MoreInfo string URI used to obtain information intended for End User consumption about this specific Job
[RFC2911] para 4.3.4
TimeAtCompleted int time at which the Document completed, in “<service>UpTime” seconds
[RFC2911] para 4.3.14.3
TimeAtCreation int time at which the Document was created in “<service>UpTime” seconds
[RFC2911] para 4.3.14.1
TimeAtProcessing int time at which the Document first began processing in “<service>UpTime” seconds
[RFC2911] para 4.3.14.2
UpTime intWarningsCount int total number of warnings that a Scan Service has
generated while processing and storing the Job’s Documents).
[PWG5100.4 para 6.1
ImagesCompleted int Progress measure for Job in terms of output. Output may be Images for Hardcopy Document producers and/or Impressions for Hardcopy Document consumers. See PWG Counter Spec [PWG5106.1]
ImpressionsCompleted int
Any various Extension point for DocumentStatus
Page 162 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
481482
483
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Figure 107 Service-Specific Document Status Elements
Page 163 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
484485
1950
1951
486
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Table 68 Service-Specific Document Status Elements
Element DataType Description or Keyword Group ReferenceCurrentPageOrder keyword the page order of the pages in the document data,
PageOrderWKV[PWG5100.3] para 4.1
DocumentFormatDetailsDetected complex See breakdown of constituent elements in Table 67.DocumentFormatDetected keyword The service sets this to the actual DocumentFormat
detected when auto-sensing, DocumentFormatWKV, MimeExtensionPattern
[PWG5100.5] para 9.1.15
DocumentFormatVersionDetected string The service sets this to the actual DocumentFormat level detected when auto-sensing
[PWG5100.5] para 9.1.17
Impressions (or Images) Completed int Number of Impressions (for Impression output Services) or Images (for Image output Services) processed by the service
[PWG5106.1]
ImpressionsCompletedCurrentCopy int number of impressions completed for the current iteration of this Document so far
MediaSheetsCompleted int media-sheets completed marking and stacking for this Document so far
[RFC3381] para 4.4
OutputDeviceAssigned string the output device to which the service has assigned this Job
[RFC2911] para 4.3.18.3
SheetsCompletedCopyNumber int Number of the copy being stacked for this Document [RFC2911] para 4.3.13
<service>Counters complex counters for the amount of work performed for this Document by the Service, including timers covering utilization, and monitoring information covering errors, warnings traffic, Job counts
[RFC3381] para 4.2
ServiceUri anyUri the URI of the Service containing the Job which contains this Document
[PWG5106.1]
Any various extension point for<service>DocumentStatus PWG5100.5 para 9.1.24
8.2 Document TicketThe Document Ticket contains description and processing Elements provided by the Client. The general Imaging Document Ticket is shown in Error: Reference source not found. All <service> Document Tickets follow this form, although the description and processing elements may contain Service specific elements. Document Ticket information is used by the Service during the processing of a Document. The information is made available to Clients through the Get Document Elements operation.
Figure 108 Imaging Document Ticket
Page 164 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
487488
1952
1953
1954
19551956195719581959
1960
1961
489
Working Draft – PWG Semantic Model v2.0 May 9, 2023
8.2.1 Document Description
Document Description consists of two sequences: Elements inherited from the Imaging Document abstract class, represented in Error: Reference
source not found with the Elements described in Error: Reference source not found. Service specific extensions. Representative Service-specific elements are shown in Error:
Reference source not found and described in Table 73. These Elements also appear in several other places in the Model and the structures of the complex Elements is described elsewhere, as referenced in the table.
Figure 109 Imaging Document Description
Table 69 Document Description Elements
Element DataType Description orKeyword
Reference
DocumentDigitalSignature keyword type of digital signature that is used in the creation of the Digital Document. DocumentDigitalSignatureWKV, KeywordNsExtensionPattern
[PWG5100.7] para 3.2.3 [PWG5100.5] para 9.1.11
DocumentMessage string message from either 1) the user to the operator about the Document or 2) from the operator, system administrator, or "intelligent" process to indicate to the End User the reasons for modification or other management action taken on the Document.
[PWG5100.5] para 9.1.20
DocumentName string name for this Document to be used in an implementation specific manner.
[RFC2911] para 3.2.1.1
DocumentNaturalLanguage keyword hint about the language used in Hard Copy Documents that contain text. This Element is not useful for Hard Copy Documents that do not contain text or are not intended to undergo Optical Character Recognition NaturalLanguageWKV
[RFC2911] para3.2.1.1, [PWG5100.5] para 9.1.22
LastDocument Boolean last Document in the Job. (Element set to false or omitted for Document which is not the last)
[RFC2911] para 3.3.1
Any various extension point for DocumentDescription
Page 165 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
490491
1962
1963196419651966196719681969
1970
1971
1972
492
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Figure 110 Service-Specific Document Description Elements
Table 70 Service-Specific Document Description Elements
Element DataType Description orKeyword
Reference[PWG5100.7]
CompressionSupplied keyword compression algorithm used for the Documents Data CompressionWKV, KeywordNsExtensionPattern
para 5.2.1
DocumentCharsetSupplied keyword default charset of the Documents content, CharsetWKV, StringExtensionPattern
para 5.2.2
DocumentDigitalSignatureSupplied keyword type of digital signature, if any, used in the Document ContentDocumentDigitalSignatureWKV, KeywordNsExtensionPattern
para 5.2.3
DocumentFormatDetailsSupplied complex Summarizes the distinct contained document format, See Figure 99 and Table 67
para 5.2.4
DocumentFormatSupplied keyword The Document format (i.e., PDL) for Document, DocumentFormat, MimeExtensionPattern
para 5.2.5
DocumentFormatVersionSupplied string level or version of the DocumentFormat para 5.2.6DocumentMessageSupplied string message from either (1) the user to the operator about the
Documents or (2) from the operator, system administrator, or "intelligent" process to indicate to the end user the reasons for modification or other management action taken on the Document
para 5.2.7
DocumentNameSupplied string name for the Document to be used in an implementation specific manner
para 5.2.8
Any various Extension point for <service>DocumentDescription
Page 166 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
493494
1973
1974
1975
495
Working Draft – PWG Semantic Model v2.0 May 9, 2023
8.2.2 Document Processing
This group Element has exactly the same structure as the Document Processing Element of Job (See 7.2.1). It provides the Document processing instructions that have been requested by the End User at each Document level, overriding the Job level Document processing instructions.
8.3 Document ReceiptThis Service-specific Element has exactly the same structure as the Document Ticket. For each processing Element of a Document, it records the actual value used by the Service for processing the Document. It contains the Elements supplied by the Client, any substitutions made by the Service and any Default Elements applied by the Service. See Section 8.2 for Element descriptions.
Page 167 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
496497
1976
197719781979
1980
198119821983198419851986
498
Working Draft – PWG Semantic Model v2.0 May 9, 2023
9. Service Operations and States
9.1 General Service Sequence of Operation A Service operates autonomously in one of three phases: Initial, Online, and Offline. As represented in Error: Reference source not found in the Initial Phase the service is in an Unknown state. How this phase is entered and exited is implementation and largely device dependent. From the Initial phase, the Service can transition only to the Offline Phase. In the Offline Phase the Service can be in the Down or Testing states. Although there may be access to the Service via the Console Subunit in this phase, such access does not include creating or processing Jobs; there is no remote access. Although transitions from Online phase states to the Down state are defined in this model, the manner and modes of testing and therefore the paths to and from the Testing phase are implementation dependent.
The basic Job-handling functions of the Service are done in the Online phase, which includes Idle, Processing and Stopped. The following paragraphs describe the nature of these states. Service States as status Elements, and the operations, events and conditions involved in changing states are described in more detail in section 9.2.
Note that the Resource Service does not deal with Jobs and Documents but rather with Resources. Therefore, although it goes through similar states, the sequence of operations is linked to Client Resource activity rather than Job activity.
Figure 111 Service State Model
Page 168 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
499500
1987
1988
19891990199119921993199419951996
1997199819992000
200120022003
2004
2005
501
Working Draft – PWG Semantic Model v2.0 May 9, 2023
9.1.1 Initialization and Startup
On creation, an MFD Service enters its Initial phase during which all its service Elements and connected Subunits are initialized. This phase may include test of the configured Subunit(s) and self-testing of the Service. After successful initialization, the Service performs a start-up operation that brings it to the Online phase. Once in this phase, it authenticates and registers its service with an on-line service directory or otherwise announces its service to the network domain in which it resides. The Service is then in the “Idle” state, it is ready for service discovery and it can accept service requests from Clients.
The Service generally accepts new requests as long as it is in one of the three Online phase states: Idle, Processing or Stopped. However, performing an administrative Disable operation while in any state will stop the Service from accepting a CreateJob requests to start a new Job. (In the case of the Resource Service, a Disable operation will stop acceptance of any Resource “put” or “get” request.) Performing an Enable operation in any Online state while the Service is disabled will re-enable the Service to accept the disabled requests.
9.1.2 Job Creation
A user initiates a Job by submitting a CreateJob request through a local (via the MFD user interface) or remote (via local network or Internet) Client. The “intent” of the user in creating the Job, that is the processing and handling instructions, may be identified in a Job Template submitted with the CreateJob request, or aspects may be left to be determined by Service defaults. When the Job is created, the Service also creates a Job Ticket, a data object containing Job description and Job and Document processing instructions derived from the Job Template information. The Job Ticket remains bound to the Job until the Job is eventually deleted from the Service.
The Job Template has the form of a Job Ticket, but is unbound to any Job or Service. The Job Template for a specific Job can be created in several ways. (See Job and Job Ticket Life Cycle, section 4.8.)
The Service Capabilities of the selected Service can be retrieved to provide the set of supported features and values to allow creating or modifying a template so that it is appropriate to the service accepting the Job request. Once the Job Template fully embodies the Intent, it can be bound to a CreateJob request to send to the Service.
The Default Job Ticket is an Element of the Service. If a CreateJob request does not include a Job Template or if the Job Template did not include some required information, the applicable processing directive defaults to the Default Job Ticket values. The values from the Default Job Ticket are not copied to the Job’s Job Ticket rather the combined Elements from the user supplied Job Ticket and the applied values from the Default Job Ticket are used. The Default Job Ticket can be administratively modified to control default behaviors for the associated Service.
The Service places created Jobs in the Active Jobs queue. Created Jobs are in the Pending state until they are advanced to the Processing State. A Pending Job may be held to delay scheduling for processing by a Job Hold Until Time Element in the Job’s Ticket to allow time for user to walk up to the printer or scanner Subunit to handle the hardcopy Document; a Pending Job may also be held by an administrator Hold Job operation. Held Jobs are released by a Job Hold Until Time timeout or a administrator Release Job operation. Jobs that are not in a “held” state are scheduled for processing immediately or when a StartJob event is signaled, based on Job priority relative to other Jobs in the Active Jobs queue.
9.1.3 Job Processing
When a Job is released for scheduling and reaches the top of Active Jobs queue, it enters the Job Processing state. If the Service is not already in the Service Processing state, it will now enter that state. The Service manages and processes the Job according to the instructions in the Job Ticket, supplemented
Page 169 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
502503
2006
200720082009201020112012
201320142015201620172018
2019
2020202120222023202420252026
20272028
2029203020312032
203320342035203620372038
2039204020412042204320442045
2046
204720482049
504
Working Draft – PWG Semantic Model v2.0 May 9, 2023
where necessary by information in the Default Job Ticket. If a processing instruction in the Job Ticket cannot be supported, the Service either returns an error or substitutes the instruction with another that best matches the user’s intent. When Job processing is complete, the actual values used for processing the Job are captured in the Job Receipt, the Job is in the Completed state and it is entered into the Job History queue. The Service either returns to Idle or continues in the ServiceProcessing state with a subsequent Job.
9.1.4 Service Pause, Service Shutdown and Abnormal Job Termination
During Job processing, an administrative “PauseService”or “PauseServiceAfterCurrentJob” operation will cause the Service to enter the “Stopped” state. This prevents further scheduling of Jobs for that Service. Depending on implementation, the Service transition to Stopped may be delayed to allow the processing of the current Job to be completed or suspended in a controlled way. Jobs that are in the Job Processing state when the Service is Stopped remain in the Active Jobs Queue but go into the ProcessingStopped Job state. A “PauseService” operation allows a user to interrupt the scheduled Jobs to submit and process an urgent Job or a Job for another service. A ServiceResume operation returns the Service to the Processing state and allows Job scheduling and processing to resume. Note that, if the Service Pause/Resume operations are to be used to allow a Job processing to be interrupted to allow another Job to be processed by the same service, then the inserted Job must have higher scheduling priority than a ProcessingStopped Job and the Service must readjust its schedule on receiving the Resume command.
When there are critical conditions impacting serviceability during “Idle” or “Processing” state, either a Critical Fault event is generated or an Administrative PauseService is performed to bring the service to the Stopped state. From there the condition can be fixed by user’s intervention. Then either the Service generates a EndCritical event (removal of critical condition) or an administrator performs a Resume operation to bring the Service back to the “Idle” or “Processing” state. If the Service requires a ShutdownService operation before service can be resumed or for testing, a RestartService must be issued to bring the Service to the On-Line phase again.
Any Job in the Active Jobs queue can be canceled via a CancelJob operation by an authorized user, a. The Job is then in the Cancelled state and entered into the Job History queue. Jobs that are terminated because of a Service fault are in the Aborted state and are also entered into the Job History queue.
9.2 Service, Job and Document StatesThe values of the Service, Jobs and Document states are critical Elements in the Service, Job and Document models. Moreover, understanding what these states are and what is involved in transitioning from one state to another is also critical in understanding the operations, processes and conditions that control the ability of the Service to execute a Job and process a Document.
9.2.1 Service States, Conditions and State Transitions
The states of a Service are identified below and in Error: Reference source not found. The states and the events (including client requests) that cause state transitions are represented Figure 112. Service State and condition transitions as a result of Operations and Events are summarized in Error: Reference source not found, Error: Reference source not found and Error: Reference source not found.
9.2.1.1 Service States
The modeling of a Service is based on the following six states. 1. Unknown: This is a state in the initial phase when a Service has been just created. There is no
outside interface with the Service. Within the MFD, the Service will be initialized and will transition to the Down state.
Page 170 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
505506
20502051205220532054
2055
20562057205820592060206120622063206420652066
2067206820692070207120722073
207420752076
2077
2078207920802081
2082
2083208420852086
2087
2088208920902091
507
Working Draft – PWG Semantic Model v2.0 May 9, 2023
2. Down: The Service instance exists and has been initialized. The service cannot accept any client operation request other than Start or Restart (which brings the Service to the Idle state, unless some error condition exists). The service can also be put into a Test state via some implementation-dependent path that initiates testing.
3. Testing: An implementation-dependent state in which normal processing is not possible but the Service is operating in a test mode.
4. Idle: The Service is up and able to accept client requests, but is not currently processing a Job. There may be no unterminated Jobs, or Jobs may be in a PendingHeld Job state.
5. Processing: At least one Job is in the Processing Job state. 6. Stopped: The Service is unable to process Jobs because it has received a Pause request or
because an event signifying the existence of a critical condition has occurred.
9.2.1.2 Operations, Events and Conditions
Figure 112 illustrates the Service state transitions resulting from Operations and Events. The following notations are used.
Initial Caps = state; e.g., IdleInitial caps followed by argument parenthesis = operation; e.g., Startup Lower case = action; e.g., schedule, enable, etcC. prefix = a condition; e.g., C.isAcceptingJobs means the isAcceptingJobs condition exists or is affirmative E. prefix = an event; e.g., E.endJob means "Job completed"~ = logical NOT applied to condition (e.g., ~C.paused means the Pause condition does not exist or "not paused")
Service Conditions and their initiating and terminating events are listed in Error: Reference source not found. In general, Conditions may exist in several states and are not necessarily associated with state changes. Administrative Operations that cause Service State changes are identified in Error: Reference source not found. Conditions and Events that characterize Service operation are identified in Error: Reference source not found. Note that although no specific Test operation or events are defined in this specification, the Test state is included to indicate that the transition to and from this Service state is made in a specific manner.
Table 71 Conditions and Bounding Events
Condition Initiating Event Initiating Cause Terminating Event Terminating CauseC.testing E.testing Implementation dependent E.testingCleared Implementation dependentC.warning E.warning Some non critical equipment
problemE.warningCleared Clearing non critical equipment
problemC.critical E.critical A critical equipment problem E.criticalCleared Clearing critical equipment
problemC.JobProcessing E.startJob A Created Job is scheduled E.endJob All scheduled Jobs advanced to
Terminating state (Completed, Canceled, Aborted)
C.isAcceptingJobs E.enable Enable E.disable DisableC.Pause E.pause Pause E.resume Resume
Note: C.isAcceptingJobs represents the ability of the service to create new Jobs (i.e., CreateJob will fail if ~C.isAcceptingJobs). Other operations are not affected by this condition.
Page 171 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
508509
20922093209420952096209720982099210021012102
2103
210421052106
210721082109211021112112
211321142115211621172118
2119
212021212122
510
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Figure 112 Service State Transitions and Causal Events
Page 172 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
511512
2123
2124
513
Working Draft – PWG Semantic Model v2.0 May 9, 2023
9.2.1.3 Service State Transition by Operations
Error: Reference source not found summarizes the effect of the primary Administrator operations on the Service state, depending upon the Service state when the operation request is received. The entry “error” indicates that sending in indicated operation when the Service is in the indicated state is invalid and an error response is returned to the requestor.
Table 72 ServiceState Change by Operations
State
Down Testing Idle Processing Stopped
Operation Action(end state, condition)
Action(end state, condition)
Action(end state, condition)
Action(end state, condition)
Action(end state, condition)
PauseService (Note 2) error
pause(Testing, C.Pause)
pause(Stopped, C.Pause)
pause(Stopped, C.Pause)
pause(Stopped,C. Pause)
ResumeService error resume(Testing, ~C.Pause)
resume(Idle, ~C.Pause)
resume(Processing, ~C.Pause)
resume(Idle, ~C.Pause)
RestartService(Note 1)
restart (Idle)
restart (Idle)
restart (Idle)
restart (Idle)
restart (Idle)
ShutdownService (Note 2) error
shutdown(Down)
shutdown(Down)
shutdown(Down)
shutdown(Down)
StartupService (Note 1)
restart (Idle) error error error error
test(Note 3)
test(Testing)
test(Testing) error error error
Notes 1. StartupService is normally sent when the Service is first created. It prompts an E.startup event that initializes the Service and
takes it through the Down state to Idle, assuming that there are no inhibiting conditions.2. RestartService can be sent with the Service in any state. It prompts a restart which initializes the Service and takes it through
the Down state to Idle, assuming that there are no inhibiting conditions.3. StartupService sent when the Service is in the Down state has the same effect as a RestartService. StartupService is illegal
in any other state.4. PauseService and ShutdownService. Depending upon implementation:5. A PauseService or ShutdownService received when the Service is in the Testing, Idle or Stopped states forces the Service
immediately to the indicated state ( Stopped and Down respectively). 6. ShutdownService when the Service is in the Processing state may initiate an E.shutdown event, leaving the Service in the
Processing state while the Job in process is completed or otherwise terminated. The E.shutdown event will eventually cause the Service to go to the Down state.
7. PauseService when the Service is in the Processing state may initiate an pause event, leaving the Service in the Processing state while the Job in process is completed or otherwise terminated. The pause event will eventually cause the Service to go to the Stopped state.
9.2.1.4 Service State Transition and Condition Change by Events
Error: Reference source not found summarizes the Service state and condition change as a result certain events, depending upon the Service state when the event occurred. The table should be read from top to bottom. Consecutive entries of the same event are differentiated by differing associated conditions. The last entry in the series is equivalent to the event with a condition other than the ones already covered.
An “error” entry indicates an invalid circumstance and that an error message should be logged indicating an implementation error.
Table 73 Service State Change by Events
Page 173 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
514515
2125
2126212721282129
2130
2131213221332134213521362137213821392140214121422143214421452146
2147
2148
2149215021512152
21532154
2155
516
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Input
State
Down Testing Idle Processing Stopped
Event(Condition)
Condition(end state)
Condition(end state)
Condition(end state)
Condition(endstate)
Condition(end state)
E.critical C.critical C.criticalC.critical(Stopped)
C.critical(Stopped) C.critical
E.criticalCleared(i.e., last C.Critical) ~C.critical ~C.critical error error
~C.critical (Idle or Processing)
E.endJob(C.shutdown)
Error shutdown(Down) error
shutdown(Down) error
E.endJob(C.paused) error
C.paused
errorC.paused(Stopped) error
E.endJob
error --- errorschedule(Idle or Processing) error
E. Warning C.warning C.warning C.warning C.warning C.warningE. warningCleared(i.e., last C.warning) ~C.warning ~C.warning ~C.warning ~C.warning ~C.warning
E.startup(Note 1)
restart(Idle) error error error error
E.startJob(C.paused) error error error error errorE.startJob
error schedule schedule (Processing) schedule error
E.testing (Testing) error error errorE.testingCleared error (Down) error error error
Notes 1. StartupService is normally sent when the Service is first created. It prompts an E.startup event that initializes the Service and
takes it through the Down state to Idle, assuming that there are no inhibiting conditions.2. RestartService can be sent with the Service in any state. It prompts a restart which initializes the Service and takes it through
the Down state to Idle, assuming that there are no inhibiting conditions.3. StartupService sent when the Service is in the Down state has the same effect as a RestartService. StartupService is illegal
in any other state.4. PauseService and ShutdownService. Depending upon implementation:5. A PauseService or ShutdownService received when the Service is in the Testing, Idle or Stopped states forces the Service
immediately to the indicated state ( Stopped and Down respectively). 6. ShutdownService when the Service is in the Processing state may initiate an E.shutdown event, leaving the Service in the
Processing state while the Job in process is completed or otherwise terminated. The E.shutdown event will eventually cause the Service to go to the Down state.
7. PauseService when the Service is in the Processing state may initiate an pause event, leaving the Service in the Processing state while the Job in process is completed or otherwise terminated. The pause event will eventually cause the Service to go to the Stopped state.
9.2.2 Job States and State Transitions
Jobs are created by a Service in response to a CreateJob request from a client. The Job will transition through several states under the control of the Service, and may be forced into several states by client Operations or equipment conditions. The possible Job states are listed below and the Job state transitions are diagramed in Error: Reference source not found. [RFC2911]
Note that a “saved Job” is not in a distinct state. It is a Completed Job with certain processing instructions. If a saved Job is recalled a ResubmitJob operation, a new Job is created and submitted with an implicit CreateJob request. The “saved Job” remains as a Completed Job.
Page 174 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
517518
2156215721582159216021612162216321642165216621672168216921702171
2172
2173217421752176
217721782179
2180
519
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Aborted the Job was halted due to an error.
Canceled the Job was halted by a CancelJob operation.
Completed the Job has been successfully completed.
Pending the Job has been accepted by the system and is awaiting system resources before it can start processing. It is in a queue and is scheduled for processing.
PendingHeld the Job is not a candidate for processing for any number of reasons and will return to the Pending state when the reasons are no longer present.
Processing the Job is being processed by the Service according to the Job Ticket instructions.
ProcessingStopped the Job is sent to the ProcessingStopped state when it is in the Processing state and the Service has been sent to the Stopped state. The Service may go to the Stopped state because of a PauseService operation, a Critical Event, or because the Service is awaiting resources necessary to continue processing.
Figure 113 Job State Transition
9.2.3 Document States and State Transitions
Document states and state transitions largely parallel the states and state transitions of the Job that was created to process the Document. The states are listed below and the state transitions are diagrammed in Figure 114. [PWG5100.5].
Aborted The Document has been aborted by the system, usually while the Document was in the 'Processing' state and the Scan Service has completed aborting the Document and all Document status Elements have reached their final values for the Document. While the Scan Service is aborting the Document, the Document remains in its current state, but the Document’s "DocumentStateReasons” Element SHOULD contain the 'ProcessingToStopPoint'
Page 175 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
520521
2181
2182
2183
21842185
21862187
2188
2189219021912192
2193
2194
2195
219621972198
21992200220122022203
522
Working Draft – PWG Semantic Model v2.0 May 9, 2023
and 'AbortedBySystem' values. When the Document moves to the Aborted state, the 'ProcessingToStopPoint' value, if present, MUST be removed, but the 'AbortedBySystem' value, if present, MUST remain.
Canceled The Document has been canceled as a result of the Scan Job being cancelled by a CancelScanJob” operation prior to the Document reaching a ‘Completed’ or ‘Aborted’ state. While the Scan Service is canceling the Document, the Document remains in its current state, but the Document’s "DocumentStateReasons” Element SHOULD contain the 'ProcessingToStopPoint' value and one of the 'CanceledByUser', 'CanceledByOperator', or 'CanceledAtDevice' values. When the Document moves to the 'canceled' state, the 'ProcessingToStopPoint' value, if present, MUST be removed, but the 'CanceledByXxx', if present, MUST remain.
Completed The Document has completed successfully or with warnings or errors after processing and all of the Document’s Digital Documents have been sent to their Destination and all Document status Elements have reached their final values for the Document. The Document’s "DocumentStateReasons” Element SHOULD contain one of: 'CompletedSuccessfully', 'CompletedWithWarnings', or 'CompletedWithErrors' values.
Pending The Document has not started to be processed at all.
Processing The Job has begun using, or is attempting to use, one or more purely software processes that are analyzing, creating, or interpreting the Hard Copy Document or Digital Document. The Job has begun using, or is attempting to use, one or more hardware devices that are analyzing, creating, or interpreting the Hard Copy Document or Digital Document. The Digital Document is ready for sending to its Destination, but the Output Channel is not yet transferring it, either because the Digital Document hasn't reached the Output Channel or because the Document is queued in the Output Channel or some other spooler, awaiting the Output Channel to transfer it. The ‘processing’ state for the Document indicates that the Document has begun to be processed. Even if the Job stops being processed, the Document remains in the ‘processing’ state until it moves to one of the three terminal states. Implementations MAY include additional values in the Document’s ”DocumentStateReasons” Element to indicate the progress of the Document, such as adding the ’Scanning’ value to indicate when the Scanner device is actually acquiring the Image from the Scan Region of the Hard Copy Document.
Page 176 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
523524
220422052206
22072208220922102211221222132214
22152216221722182219
2220
22212222222322242225222622272228222922302231223222332234
525
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Figure 114 Document State Transition
9.3 Service OperationsThis section defines normative semantics of Service operations and the behavior in response to these operation requests by a Service conformant to the MFD model.
A User makes a Service request by interacting through a local Client (via the MFD console) or through a remote Client via its software application user interface. Each Service provides the same set of service interfaces for the co-located local Client or a Remote Client. The Client can operate via a local interface, a local area network, or the Internet.
The individual Service specifications identify all operations applicable to that Service, some of which may be unique to that Service. The MFD Operations described in this section are common to more than one Service, with the “<service>” component in the operation name identifying the specific Service to which the operation request is addressed.
All operations consist of a Request issued by a client and a Response returned by the Service. All Requests are sent to the target Service except Startup<service>Service, which is sent to the MFD System. Some responses may just indicate that the request was or was not honored, perhaps with explanation messages; others will contain requested or related information, perhaps with additional explanatory “reasons” information.
The MFP operations applicable to two or more Services are listed in Error: Reference source not found along with references to their antecedent Printer operations. The operations are, for the most part, derived from IPP Print Service operations defined in RFC2911 [RFC2911], RFC3380[RFC3380] and RFC3998 [3998] and further discussed in the PWG IPP 2.0 specification [PWG5100.10] and the IPP Job and Printer Extensions-Set 2 specification [PWG5100.11]. The print specific context has been extended to MFD Services. Several print operations have been omitted as inapplicable to MFD Services as a whole, while a few operations have been added.
Page 177 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
526527
2235
2236
2237
22382239
2240224122422243
2244224522462247
22482249225022512252
2253225422552256225722582259
528
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Table 74 MFD Common Operations and Antecedents
MDF Operation Antecedent IPP Operation Antecedent Reference Access*Add<service>HardcopyDocument Send-URI** [RFC2911] UserCancel<service>Document Cancel-Document [PWG5100.5] 4.5 UserCancel<service>Job Cancel-Job [RFC2911] 3.3.3 UserCancel<service>Jobs Cancel-Jobs [PWG5100.11] 5.1 AdminCancelCurrent<service>Job Cancel-Current-Job [RFC3998] 4.2 UserCancelMy<service>Jobs Cancel-My-Jobs [PWG5100.11] 5.2 User
Close<service>Job Close-Job [PWG5100.11] 5.3 UserCreate<service>Job Create-Job
Print-Job[RFC2911] 3.1.4
3.2.1User
Disable<service>Service Disable-Printer [RFC3998] 3.1.1 AdminEnable<service>Service Enable-Printer [RFC3998] 3.1.2 AdminGet<service>DocumentElements Get-Document-Attributes [PWG5100.5] 4.3 UserGet<service>Documents Get-Documents [PWG5100.5] 3.3 User
Get<service>JobElements Get-Job-Attributes [RFC2911] 3.3.4 UserGet<service>Job History Get-Jobs (which-Jobs Element =
‘completed’)[RFC2911] 3.2.6 User
Get<service>ServiceElements Get-Printer-Attributes, Get-Printer-Supported-Values
[RFC2911], [RFC3380]
3.2.5 User
GetActive<service>Jobs Get-Jobs (which-Jobs Element = ‘not-completed’)
[RFC2911] 3.2.6 User
Hold<service>Job Hold-Job [RFC2911] 3.3.5 UserHoldNew<service>Jobs Hold-New-Jobs [RFC3998] 3.3.1 AdminPause<service>Service Pause-Printer [RFC2911] 3.2.7 AdminPause<service>ServiceAfterCurrentJob Pause-Printer-After-Current-Job [RFC3998] 3.2.1 AdminPromote<service>Job Promote-Job
Schedule-Job-After[RFC3998] [RFC3998]
4.4.1 Admin
Release<service>Job Release-Job [RFC2911] 3.3.6 UserReleaseNew<service>Jobs Release-Held-New-Jobs [RFC3998] 3.3.2 AdminRestart<service>Service Restart-Printer [RFC3998] 3.5.1 AdminResubmit<service>Job Resubmit-Job [PWG5100.11] 5.4 UserResume<service>Job Resume-Job [RFC3998] 4.3.2 UserResume<service>Service Resume-Printer [RFC2911] 3.2.8 AdminSend<service>Document Send-Document [RFC2911] 3.3.1 UserSend<service>URI Send-URI [RFC2911] 3.3.2 UserSet<service>DocumentElements Set-Document-Attributes [PWG5100.5] 4.4 UserSet<service>JobElements Set-Job-Attributes [RFC3380] 4.2 UserSet<service>ServiceElements Set-Printer-Attributes [RFC3380] 4.1 AdminShutdown<service>Service Shutdown-Printer [RFC3998] 3.5.2 AdminStartup<service>Service Startup-Printer [RFC3998] 3.5.3 AdminSuspendCurrent<service>Job Suspend-Current-Job [RFC3998] 4.3.1 User
Notes:* For operations where a User may set Job Elements or otherwise directly affect the state or parameters of a Job, the User must be either the Job owner of record or must be an Administrator or Operator. For operations where a User has access to Job or Service information (Get<service>JobElement, Get<service>JobHistory and Get<service>Jobs), site policy determines what information is made available to Users who are not Administrators or Operators and who do not own the Jobs about which the information is provided.** Although the Add<service>HardcopyDocument operation is a “new” operation created to address the input to Services accepting Hardcopy versus Digital Documents, the purpose and form of the operation is parallel to the IPP Send-URL operation
Page 178 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
529530
2260
2261
22622263226422652266226722682269
531
Working Draft – PWG Semantic Model v2.0 May 9, 2023
The MFD operation definitions in this section are generic. Depending on the encoding used by the binding, the actual identification of the operation may be different. For example, IPP uses a numeric code. Further, depending on the addressing inherent in the transport, the operation requests might include an implicit rather than explicit identification of the Service. For example, IPP operations coming on the TCP port 631 are inherently Print Service operations.
The MFD Operation definitions are divided between basic or User (Job-oriented) operations and administrative operations. The basic MFD operations are listed in Error: Reference source not found. These operations are concerned primarily with creating, monitoring, modifying and canceling Jobs and Job-related Elements. Basic operations are available to Users including Administrators and Operators, although any operation affecting a Job or Document is restricted to the Job Owner or to an Administrator or Operator. Identification and authentication of the User as Job Owner depends upon the Service and binding, as well as the specific implementation. For example, the Copy Service may consider whoever is present at the machine to be the Job Owner.
Site Policy may cause a Service to restrict information provided to a User who is not an Administrator or Operator. Administrative Operations, accessible only to Administrators (and Operators), are concerned primarily with managing the Service and are listed in Error: Reference source not found. Note that for some Services where the User is present at the device (such as Copy), certain operations may consider any User that is present at the implementing device as having Administrator access
Table 75 Basic MFD Interface Requests and Responses
1. OperationRequest
Parameters (Notes 2)Response
Parameters (Note 3)Note
Add<service>HardcopyDocument InputSource, JobId, Document Ticket(optional), ElementsNaturalLanguage(optional), LastDocument(optional), RequestingUserNameRequestingUserName or RequestingUserUri
DocumentNumber, UnsupportedElements(optional)
Cancel<service>Document DocumentNumber, ElementsNaturalLanguage(optional), JobId, Message (optional) RequestingUserNameRequestingUserName or RequestingUserUri
Cancel<service>Job ElementsNaturalLanguage(optional), JobId, Message (optional) RequestingUserNameRequestingUserName or RequestingUserUri
CancelCurrent<service>Job ElementsNaturalLanguage(optional), JobId(optional), Message (optional) RequestingUserNameRequestingUserName or RequestingUserUri
CancelMy<service>Jobs JobIds (optional), Message (optional), ElementsNaturalLanguage(optional), RequestingUserNameRequestingUserName or RequestingUserUri
JobIds (optional) 1
Close<service>Job JobId, RequestingUserNameRequestingUserName or RequestingUserUri
Create<service>Job ElementsNaturalLanguage(optional), Job Ticket (optional) RequestingUserNameRequestingUserName or RequestingUserUri
JobId, UnsupportedElements(optional)
GetActive<service>Jobs ElementsNaturalLanguageRequested(optional), Limit(optional) RequestingUserNameRequestingUserName or RequestingUserUri
ElementsNaturalLanguage(optional)JobSummaries (includes JobID, JobName, JobOriginatingUserName, JobState and perhaps JobStateReasons)(optional)
Page 179 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
532533
22702271227222732274
22752276227722782279228022812282
22832284228522862287
2288
534
Working Draft – PWG Semantic Model v2.0 May 9, 2023
1. OperationRequest
Parameters (Notes 2)Response
Parameters (Note 3)Note
Get<service>DocumentElements Document Number, ElementsNaturalLanguageRequested(optional), JobId, RequestingUserNameRequestingUserName or RequestingUserUri
DocumentElements(optional), ElementsNaturalLanguage(optional)
Get<service>Documents ElementsNaturalLanguageRequested(optional), JobId, RequestingUserNameRequestingUserName or RequestingUserUri
Documents(list of DocumentSummaries)(optional), ElementsNaturalLanguage(optional)JobID, JobName
Get<service>JobElements ElementsNaturalLanguageRequested(optional), JobId, RequestedElements (JobReceipt, JobStatus, or Job Ticket.)(optional) RequestingUserNameRequestingUserName or RequestingUserUri
JobElements, ElementsNaturalLanguage(optional)
Get<service>Job History ElementsNaturalLanguageRequested(optional), Limit(optional) RequestingUserNameRequestingUserName or RequestingUserUri
ElementsNaturalLanguage(optional)JobSummaries (includes JobID, JobName, JobOriginatingUserName, JobState and perhaps JobStateReasons
Get<service>ServiceElements ElementsNaturalLanguageRequested(optional), RequestedElements (Service Capabilities, ServiceConfiguration, ServiceDescription, ServiceStatus or DefaultJob Ticket.)(optional) RequestingUserNameRequestingUserName or RequestingUserUri
ElementsNaturalLanguage(optional)ServiceElements(optional)
Hold<service>Job ElementsNaturalLanguageRequested(optional), JobHoldUntil or JobHoldUntilTime, JobId, Message(optional), RequestingUserNameRequestingUserName or RequestingUserUri
Release<service>Job ElementsNaturalLanguageRequested(optional), JobId, Message(optional), RequestingUserNameRequestingUserName or RequestingUserUri
Resubmit<service>Job ElementsNaturalLanguageRequested(optional), JobId, Job Ticket (optional) RequestingUserNameRequestingUserName or RequestingUserUri
JobId, UnsupportedElements(optional)
Resume<service>Job ElementsNaturalLanguageRequested(optional), JobId, Message(optional)RequestingUserNameRequestingUserName or RequestingUserUri
Send<service>Document ElementsNaturalLanguageRequested(optional), Document Ticket (optional) JobId, LastDocument(optional), RequestingUserNameRequestingUserName or RequestingUserUri, DocumentData
DocumentNumber, UnsupportedElements(optional)
Send<service>Uri DocumentUri, ElementsNaturalLanguageRequested(optional), Document Ticket (optional) JobId, LastDocument(optional), RequestingUserNameRequestingUserName or RequestingUserUri
DocumentNumber, UnsupportedElements(optional)
Set<service>DocumentElements DocumentNumber, ElementsNaturalLanguage(optional), SocumentTicket, JobId, Message(optional), RequestingUserNameRequestingUserName or RequestingUserUri
UnsupportedElements(optional)
Page 180 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
535536
537
Working Draft – PWG Semantic Model v2.0 May 9, 2023
1. OperationRequest
Parameters (Notes 2)Response
Parameters (Note 3)Note
Set<service>JobElements ElementsNaturalLanguage(optional), Job Ticket, JobId, Message(optional), RequestingUserNameRequestingUserName or RequestingUserUri
UnsupportedElements(optional)
SuspendCurrent<service>Job ElementsNaturalLanguage(optional), JobId(optional), Message(optional), RequestingUserNameRequestingUserName or RequestingUserUri
Validate<service>Document Ticket
ElementsNaturalLanguageRequested(optional), Document Ticket RequestingUserNameRequestingUserName or RequestingUserUri
UnsupportedElements(optional)
Validate <service>Job Ticket ElementsNaturalLanguage(optional), Job Ticket, RequestingUserNameRequestingUserName or RequestingUserUri
UnsupportedElements(optional)
Notes:Note 1: Response includes identified but un-cancellable Jobs Note 2: The RequestingUserNameRequestingUserName or RequestingUserUri, is used by the Service to determine whether the requestor is an Administrator, Operator or the Job Owner and is therefore authorized to make the request. Some implementations may require further authentication of the requestor’s identity. If the requestor is not determined to have access, the Service MUST reject the request.Note 3: All responses must include correlation to request and whether request was successful or failed.
9.3.1 Basic Service Operations
The common Basic operations are listed in Error: Reference source not found; they are concerned with creating and controlling Jobs and Documents within Jobs. The Operations include those by which a client gets Service Elements to allow selection of Services and formulation of Job Tickets. Some of these operations do affect the state of a Job. However, none of these operations directly affect the state or configuration of the Service except to the extent that creating or canceling a Job may initiate a sequence that affects the Service.
9.3.1.1 Add<service>HardcopyDocument
The Add<service>HardcopyDocument operation allows a client to prepare a Service to accept a Hardcopy Document via a scanner Subunit and to add it to an identified Job. It is analogous to the Send<service>Document and Send<service>Uri operations except that it is applicable to Services for which input Documents are obtained by a scan of a region of a media sheet side, such as FaxOut and EmailOut.
The Service MUST reject this request and send an appropriate message if:1. The requestor is not the owner of the identified Job, or is not an Administrator or Operator; 2. The Service has already closed inputs to the identified Job, or 3. The Job is not found.
Otherwise, provided the request is properly constructed, complete and references valid objects, the Service MUST accept the request, MUST close the Job if the LastDocument Element is asserted, MUST be prepared to add Document Data from the identified input to the identified Job, and MUST respond to the request.
9.3.1.2 Cancel<service>Document
The Cancel<service>Document operation allows a client to cancel a specified Document in a specified Job of the specified Service any time from when the time the Document is created up to, but not including, the time that the Document is Completed, Canceled or Aborted. Because a Document might already be in
Page 181 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
538539
2289229022912292229322942295
2296
229722982299230023012302
2303
2304230523062307
2308230923102311
2312231323142315
2316
231723182319
540
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Processing by the time a Cancel<service>Document request is received, some portion of the Document processing might be completed before the Document is actually canceled.
The Cancel<service>Document operation does not remove the Document from the Job or the Service, but does set the specified Document’s Document State Document Status Element to Canceled and the Document’s Document State Reasons Element to an appropriate value. If the Job containing the Document is again submitted using Resubmit<service>Job, the canceled Document is also submitted for processing. Thus Cancel<service>Document has the same semantics as Cancel<service>Job which cancels only the processing of the Job but does not delete the Job object itself.
The Cancel<service>Document operation does not affect the states of any of the other Documents in the Job. If the Job is in the Processing state and there are more Documents to be processed, the Service does continue to process the un-canceled Documents. If there are no further Documents to process, the Job is advanced to the Completed state.
The Service MUST reject the operation and return an appropriate response message if the operation requestor is not either the Job owner or a Service or System operator or administrator. Otherwise the Service MUST accept or reject the Cancel<service>Document request based on the Document's current state and, if the request is accepted, the Service MUST transition the Document to the indicated new state as follows:
Once a “success” response has been sent, the implementation guarantees that the Document will eventually end up in the Canceled state. Between the time that the Cancel<service>Document request is accepted and when the Document enters the Canceled Document-state, the DocumentStateReasons Element MUST contain a value which indicates to any later query that, although the Document might still be Processing, it will eventually end up in the Canceled state.
9.3.1.3 Cancel<service>Job
The Cancel<service>Job operation changes the state of the identified Job to Canceled, provided that the Job is not already in or in a mode leading directly to a termination state. (i.e., Completed, Canceled, or Aborted.) Because a Job might already be active by the time a Cancel<service>Job is received, a portion of the Job may be done before the Job is actually terminated.
The Service MUST accept or reject the request based on the Job's current state. If the request is accepted, the Job state is transitioned to Canceled and the Service will issue a success response. See the transition diagram under Job State (Error: Reference source not found). If the implementation requires some significant time to cancel a Job in the Processing or ProcessingStopped states, the Service MUST set the Job's JobStateReasons to a value indicating that the Job is transitioning to a Canceled state. If the Job already has a JobStateReasons indicating that it is transitioning to a Canceled state, then the Service MUST reject a Cancel<service>Job operation
9.3.1.4 CancelCurrent<service>Job
The CancelCurrent<service>Job operation allows a client to cause the Service to terminate processing on the currently processing Job and to move that Job to the Canceled state. As with any other Basic operation directly affecting a Job, this operation is accepted by the Service only if the originator is the Owner of the affected Job(s) or is an Administrator or Operator.
There is the potential that the current Job may have changed between the time a client requests this operation and the time the Service implements it. Therefore, if the intent is to cancel a particular Job the Client MAY include an optional JobId parameter in the request.
Page 182 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
541542
23202321
232223232324232523262327
2328232923302331
23322333233423352336
23372338233923402341
2342
2343234423452346
2347234823492350235123522353
2354
2355235623572358
235923602361
543
Working Draft – PWG Semantic Model v2.0 May 9, 2023
1. If the JobId is included in the request and that Job is currently in the Processing or ProcessingStopped state and the operation requestor has access rights to that Job, the Service MUST accept the request and cancel the Job.
2. If no JobId is included in the request and the operation requestor has access rights to the Job currently in the Processing or ProcessingStopped state, the Service MUST accept the request and cancel that Job.
3. If more than one Job is in the Processing or ProcessingStopped state, all currently processing Jobs to which the request originator has access MUST be canceled unless the operation included the optional JobId, in which case only the identified Job is canceled.
4. If the JobId is included in the request and that Job is not currently in the Processing or ProcessingStopped state; or if the requestor does not have access rights to the identified Job, the Service MUST reject the request and return the appropriate error code.
5. If there is no Job currently in the Processing or ProcessingStopped state or if the requestor does not have access rights to any Job that is in the Processing or ProcessingStopped state, the Service MUST reject the request and return the appropriate error code.
9.3.1.5 CancelMy<service>Jobs
The CancelMy<service>Jobs operation permits a user to cancel all of their own identified non-Terminated Jobs or, if no specific Jobs are identified in the request, to cancel all of their own non-Terminated Jobs in the Service. This operation works like the Cancel-Job operation except that the operation can apply to multiple Jobs. The client specifies the set of candidate Jobs to be canceled by supplying and/or omitting the JobIds. The Service MUST check the access rights of the requesting user against all of the candidate Jobs. If any of the candidate Jobs are not owned by the requesting user, the Service MUST NOT cancel any Jobs and MUST return the appropriate error status code along with the list of any JobIds that were specifically identified in the operation request but to which the User is not authorized access.
If this check succeeds, then (and only then) the Service MUST accept or reject the request based on the current state of each of the candidate Jobs and must transition each Job to the indicated new state as shown for the antecedent Cancel-My-Jobs operation in the Standard for Internet Printing Protocol (IPP): Job and Printer Extensions Set 2 [PWG5100.11]. If any of the candidate Jobs that were not already in a Terminating state cannot be canceled, the Service MUST NOT cancel any Jobs and MUST return the appropriate error status code along with the list of JobIds for those Jobs which were specifically identified in the operation request but could not be canceled. If the requested Jobs include some Jobs that are already in a terminating state, this circumstance in itself MUST NOT interfere with the canceling of non-terminated candidate Jobs, but SHOULD result in the return of a warning message identifying the specifically identified Jobs that already were in a Terminating state.
9.3.1.6 Close<service>Job
The Close<service>Job operation allows a client to close Job inputs to those Services accepting Documents, even when the last Document input operation for the Job (Send<service>Document, Send<service>URI or Add<service>Document) did not include the LastDocument Element with a 'true' value. This Close<service>Job operation supersedes and, if supported by the Service, is preferable to the practice of using a Send<service>Document with no Document Data but with a LastDocument Element containing a 'true' value to close inputs.
The Service MUST reject this operation request if the target Job is not found or if the requestor is not the Job Owner or an Administrator. Otherwise, the Service MUST accept this operation request even if the target Job is already closed and regardless of JobState. Closing the Job MUST cause the Service to reject any subsequent Document input operation for the target Job, but MUST NOT affect the execution of any previously accepted Document input operation.
Page 183 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
544545
236223632364236523662367236823692370237123722373237423752376
2377
23782379238023812382238323842385
2386238723882389239023912392239323942395
2396
239723982399240024012402
24032404240524062407
546
Working Draft – PWG Semantic Model v2.0 May 9, 2023
9.3.1.7 Create<service>Job
The Create<service>Job operation allows a Client to request creation of a Job in the Service. Upon creation, the Job is in Pending state and available for scheduling unless a Job Processing instruction prevents this. (e.g., JobHoldUntil puts it in PendingHeld state) The Create<service>Job operation MUST fail if the Service’s IsAcceptingJobs Element value is ‘false’.
Job Processing is done on one or more Documents. Unlike the antecedent IPP Print-Job operation, the MFD Create<service>Job may involve more than one Document. Depending upon the type of Service, the input may be a Hardcopy Document or a Digital Document. In either case, the source(s) of the input Document(s) as well as the destination(s) of the output Document(s) are identified in the Job Ticket submitted in the Create<service>Job Request,
Once a Job is created, Documents may be input as part of that Job by Send<service>Document, Send<service>URI or, for Services that accept hardcopy input, Add<Service>Document operations. In Service implementations that do not accept multiple Documents (i.e., MultipleDocumentJobsSupported = False), Document input is closed after one Document is accepted. In Service implementations that do accept multiple Documents (i.e., Multiple Document Jobs Supported = True), there may be multiple Send<service>Document, Send<service>URI or Add<Service>Document operations. There are two methods of indicating when all Documents have been sent:
1. issuing a Close<service>Document request 2. issuing a Send<service>Document, Send<service>URI or, 3. Add<Service>Document request with the LastDocument Element = True
To avoid a possible hang condition, Service implementations supporting multiple Document Jobs must also support the Multiple Operation Time Out Element that indicates the minimum number of seconds the Service will wait for the next Send or Add operation before taking some recovery action. If, for some reason, there is a longer period between Create<service>Job and valid Send or Add operations, or between sequential Send or Add operations, the Client MUST send Send or Add requests, even if they are empty, to reset the timeout. If there is a multiple operation timeout, the Service will take remedial action according to the value that Service has indicated in its Multiple Operation Timeout Action Element.
9.3.1.8 Get<Service>DocumentElements
The Get<Service>DocumentElements operation allows a Client to obtain detailed information about the specified Document within the specified Job. This operation is parallel to the Get<service>Job-Elements operation, but with the target and response Elements relating to a Document rather than a Job.
The Client requests specific groups of Elements (complex Elements) contained within the Document. The Document Data is not part of the Document and cannot be retrieved using this operation. However the location of the Document Data is available. The allowed values for Requested Elements are Document Receipt, Document Status and Document Ticket. Vendors may extend the allowed values.
The Service MUST return the Document Description Element values that a client supplied in the Document Creation operation (Create<service>Job, Send<service>Document or Send<service>URI) or provided in Set<service>DocumentElements operation a plus any additional Document Description Elements that the Service has generated, such as Document State. The Service MUST NOT return any Job level Elements that the Document inherits from the Job level but MUST return Document Elements specified at the Document level. It is NOT REQUIRED that a specific Document include all Elements belonging to a group (since some Elements are optional). However, it is REQUIRED that the Service support all these group names for the Document object.
Page 184 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
547548
2408
2409241024112412
24132414241524162417
2418241924202421242224232424242524262427
2428242924302431243224332434
2435
243624372438
2439244024412442
24432444244524462447244824492450
549
Working Draft – PWG Semantic Model v2.0 May 9, 2023
9.3.1.9 Get<service>Documents
The Get<service>Documents operation allows a client to retrieve the list of Documents belonging to the identified Job. A Document summary containing a group of Document Element names with their values will be returned for each Document in the Job.
This operation is similar to the Get<service> and Get<service> operations except that it returns Elements from Documents rather than identified Jobs. As with the Get<service>DocumentElements operation, the Service MUST return only those Elements that are in the Document Ticket.
9.3.1.10 Get<service>JobElements
The Get<Service>JobElements operation allows a Client to obtain detailed information on the specified Job. Unlike the antecedent IPP Get-Job-Attributes operation, the Get<Service>JobElements request may not specify individual Elements. Rather, the Client requests specific groups of Elements contained within the Job. The allowed values for RequestedElements are Job Receipt, Job Status, or Job Ticket. Vendors may extend the allowed values.
The Service MUST reject this request if the requestor is not authorized access to the identified Job,
9.3.1.11 Get<service>Jobs
The Get<service>Jobs operation provides summary information on all Jobs that have reached a terminating state (i.e., Completed, Canceled Aborted). As such, it is similar to the antecedent Get-Jobs operation with the which-Jobs Element set to ‘completed’. Unlike Get-Jobs, Get<service>Jobs may not include a Requested Elements argument; rather, it always returns a Job Summary for each terminated Job including JobId, JobName, JobOriginatingUserName, JobState and perhaps JobStateReasons and other service specific information.
When the operation is exercised by a User that is not an Administrator, the Job summary may not include all of the summary information, depending upon site security policy.
9.3.1.12 Get<service>ServiceElements
The Get<service>ServiceElements operation allows a Client to obtain detailed information on the Elements and their values supported by the Service. Unlike the antecedent IPP Get-Printer-Attributes operation, the Get<Service>ServiceElements request may not specify individual Elements. Rather, the Client requests information on one or more specific group of Elements. The allowed values for Requested Elements are Service Capabilities, Service Configuration, Service Description, Service Status or DefaultJob Ticket. Vendors may extend the allowed values.
Some Services may accept an additional argument in a Get<service>ServiceElements request to further filter the response, much as the antecedent IPP Get-Printer-Attributes operation accepted the Document-Format Element. The individual Service specifications identify such arguments if any, their effect and whether support is mandatory.
In addition to the status message, the Service response includes the set of requested Element names and their values for all supported Elements. The response need not contain the requested Element names for any Elements not supported by the Service.
Page 185 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
550551
2451
245224532454
245524562457
2458
24592460246124622463
2464
2465
246624672468246924702471
24722473
2474
247524762477247824792480
2481248224832484
248524862487
552
Working Draft – PWG Semantic Model v2.0 May 9, 2023
9.3.1.13 GetActive<service>Jobs
The GetActive<service>Jobs operation provides summary information on all Jobs in the Pending or Processing state. As such, it is equivalent to the antecedent Get-Jobs operation with the which-Jobs Element set to ‘not-completed’. Unlike the antecedent Get-Jobs operation, GetActive<service>Jobs may not include a RequestedElements argument; rather, it always returns a JobSummary for each Active Job with the summary including JobId, JobName, JobOriginatingUserName, JobState and perhaps JobStateReasons and other service specific information.
When the operation is exercised by a User that is not an Administrator or Operator, the Job summary may not include all of the summary information, depending upon site security policy.
9.3.1.14 Hold<service>Job
NOTE: The antecedent Hold-Job operation and the associated Release-Job operation, as defined in IPP/1.1: Model and Semantics [RFC2911], have been deprecated in later IPP specifications in favor of using the antecedent Set-Job-Attributes operation [RFC3380] to set the Hold-Job-Until or Hold-Job-Until-Time attributes.
The Hold<service>Job operation allows a client acting for the Job Owner or an Administrator or Operator to hold a Pending Job in the queue so that it is not eligible for scheduling. The Job transitions as a result of a Hold<service>Job operation depend upon the current Job state, as indicated for the antecedent Hold-Job operation in paragraph 3.3.5 of IPP/1.1: Model and Semantics [RFC2911] The Hold<service>Job request can specify hold until a specific date-time (JobHoldUntilTime) or according to a keyword (JobHoldUntil), where the keyword can specify a period (such as “third-shift”) or be indefinite. A given Hold<service>Job request can specify only one hold condition. In the case of multiple Hold<service>Job requests, the last accepted request overrides the condition imposed by any previous Hold<service>Request.
The restraint imposed by a Hold<service>Job is removed by a Release<service>Job operation directed to the same Job. If a Service implementation supports Hold<service>Job, it must also support Release<service>Job and vice-versa.
If the HoldJob operation is supported, then the ReleaseJob operation MUST be supported, and vice-versa. The OPTIONAL JobHoldUntil or JobHoldUntilTime parameter allows a client to specify whether to hold the Job until a specified time, indefinitely or until a specified time period. The Service MUST accept or reject the request based on the Job's current state and transition the Job to the indicated new state as follows. A HoldJob request is rejected when the identified Job is in the Processing or ProcessingStopped states.
9.3.1.15 Release<service>Job
NOTE: The antecedent Release-Job operation and the associated Hold-Job operation, as defined in IPP/1.1: Model and Semantics [RFC2911], have been deprecated in later IPP specifications in favor of using the antecedent Set-Job-Attributes operation [RFC3380] to set Hold-Job-Until or Hold-Job-Until-Time attributes.
The Release<service>Job operation allows a client acting for the Job Owner or an Administrator or Operator to release a previously held Job from the PendingHeld state so that it is eligible for scheduling, provided that there is no other reason to keep the Job in the PendingHeld state. That is, the restraint imposed by a Hold<service>Job operation is removed by a Release<service>Job operation directed to the same Job. If a Service implementation supports Hold<service>Job, it must also support Release<service>Job and vice-versa.
Page 186 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
553554
2488
248924902491249224932494
24952496
2497
2498249925002501
25022503250425052506250725082509
251025112512
25132514251525162517
2518
2519252025212522
252325242525252625272528
555
Working Draft – PWG Semantic Model v2.0 May 9, 2023
The Job Transitions as a result of a Release<service>Job operation depend upon the current Job state, as indicated for the antecedent Release-Job operation in paragraph 3.3.6 of IPP/1.1: Model and Semantics [RFC2911]
9.3.1.16 Resubmit<service>Job
The Resubmit<service>Job operation allows a client acting for the Job Owner or an Administrator or Operator to resubmit a previously completed Job, but with the option of providing new Job Ticket information (other than input Document Data or input Document Data descriptive information.)
The Resubmit<service>Job operation is applicable only to a RetainedJob. A Retained Job is one which remains in the Service after it has been completed or canceled. This may be incidentally or because it is a saved Job, which is a Completed or Canceled Job with a JobSaveDispostion Element value that indicates that the Job, including Document Data if any, should not be deleted or aged-out after the Job is completed.
If a Resubmit<service>Job operation is accepted, the state of the retained Job is not changed; rather, a new Job is created from the identified retained Job and submitted with an implicit CreateJob request.
1. If the Resubmit<service>Job request contains a processing Element that was in the retained Job but with a different value, the value supplied in the Resubmit<service>Job operation MUST override the original value (if supported by the Service).
2. If the Resubmit<service>Job request contains a processing Element that was not in the retained Job, the Element with the value supplied with the Resubmit<service>Job operation MUST be applied (if supported by the Service)
3. For any processing Element in the original retained Job the value of which is not changed in the Resubmit<service>Job request, that Element and its value MUST be applied to newly created Job except that a JobSaveDispostion Element value indicating that the Job should be saved, and certain other Service-specific Element values, MUST NOT be copied but are applied to the new Job only if they are in the Resubmit<service>Job request.
The newly created Job is moved to the Pending or PendingHeld Job state with the same Element values as the original saved Job (except for the save Element). If any of the Documents in the saved Job were passed by reference (Send<service>URI or Send>service>URI), the Service MUST re-fetch the data, since the semantics of Restart<service>Job are to repeat all Job processing. The Service MUST assign new JobUri and JobId values to the newly created Job; the JobDescription Elements that accumulate Job progress, such as JobImpressionsCompleted, JobMediaSheetsCompleted, and JobKOctetsProcessed, MUST be an accurate record for the newly created Job.
The Service MUST accept or reject the Resubmit<service>Job Request based on the authority of the requester and the referenced Job's current state. The Requester must either be the Job owner or an operator or administrator of the Service. The target Job must be retained with a Completed or Canceled state.
9.3.1.17 Resume<service>Job
The Resume<service>Job operation allows a client acting for the Job Owner or an Administrator or Operator to resume the identified Job at the point where it was suspended. Provided that no other condition exists that forces the Job to the PendingStopped state, the Service moves the Job from the ProcessingStopped state to the Pending state and removes the JobSuspended value from the Job's StateReasons Element. If the identified Job is not in the ProcessingStopped state with the JobSuspended value in the Job's StateReasons Element, the Service MUST reject the request and return an appropriate status code, since the Job was not suspended.
If a Service supports Suspend<service>Job or SuspendCurrent<service>Job operations, it MUST support the Resume<service>Job operation, and vice-versa.
Page 187 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
556557
252925302531
2532
253325342535
2536253725382539
2540254125422543254425452546254725482549255025512552
2553255425552556255725582559
2560256125622563
2564
2565256625672568256925702571
25722573
558
Working Draft – PWG Semantic Model v2.0 May 9, 2023
9.3.1.18 Send<service>Document
The Send<service>Document operation allows a client acting for the Job Owner or an Administrator or Operator to input a Digital Document to a Service as part of an already created Job. In response to the Create<service>Job, the Service will have returned the JobURI and the JobId. For each Document that the client desires to add to this Job, the client issues a Send<service>Document request which includes the JobId and contains the entire stream of Document Data for one Document.
If the Service supports this operation but does not support multiple Documents per Job, Document input is closed after the first Document is accepted and the Service MUST reject subsequent Send<service>Document requests associated with the same Job. Similarly, if the Service does support multiple Documents per Job, the Service MUST reject Send<service>Document requests associated with a given Job after inputs to that Job have been closed either a Close<service>Job operation or a previous Send<service>Document with a 'true' value for the LastDocument Element. Note that the Client may send and the Service must accept a Send<service>Document request with a 'true' value for the LastDocument Element to close input to that Job, even if that request includes no Document data.
See the Create<system>Job description for discussion of issues relating to excessive delay between multiple Send<service>Document requests.
The Service MUST reject a Send<service>Document request and send an appropriate message if:1. The requestor is not the owner of the identified Job, or is not an Administrator or operator2. The Service has already closed inputs to the identified Job, 3. The Document size, format and/or compression are not supported by the Service, or4. The Job is not found.
Otherwise, the Service MUST accept the request, MUST close the Job if the LastDocument Element is asserted, MUST add the supplied Document Data (if any) to the identified Job, and MUST respond to the request.
9.3.1.19 Send<service>Uri
The Send<service>Uri operation allows a client acting for the Job Owner or an Administrator or Operator to input a Digital Document to a Service as part of an already created Job. As such, the Send<service>Uri operation is identical to the Send<service>Document except that a client supplies a URI reference (DocumentUri Element) rather than the Document Data itself. If a Service supports both operations, clients can use both Send<service>Uri and Send<service>Document operations to add new Documents to an existing multi-Document Job.
As with Send<service>Document, if the Service supports Send<service>Uri but does not support multiple Documents per Job, the Service MUST reject subsequent Send<service>Uri requests associated with the same Job. Similarly, if the Service does support multiple Documents per Job, the Service MUST reject Send<service>Uri requests associated with a given Job after inputs to that Job have been closed. Job inputs can be closed either by a Close<service>Job operation or a Send<service>Document (NOT a Send<service>Uri) request with a 'true' value for the LastDocument Element. Note that the Client may send and the Service must accept a Send<service>Document request with a 'true' value for the LastDocument Element to close input to that Job even if that request includes no Document data.
The Service MUST reject this request and send an appropriate message if:1. The requestor is not the owner of the identified Job, or is not an Administrator or operator2. The Service has already closed inputs to the identified Job, 3. The Job is not found 4. The Document size, format and/or compression are not supported by the Service, or5. The Service does not support the URI Scheme specified.
Page 188 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
559560
2574
25752576257725782579
25802581258225832584258525862587
25882589
25902591259225932594
259525962597
2598
259926002601260226032604
26052606260726082609261026112612
261326142615261626172618
561
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Otherwise, the Service MUST accept the request, MUST close the Job if the LastDocument Element is asserted, MUST add the Document Data (if any) to the identified Job, and MUST respond to the request. See the Create<system>Job description for discussion of issues relating to excessive delay between multiple Send<service>Uri requests.
9.3.1.20 Set<service>DocumentElements
The Set<service>DocumentElements operation allows a Client, operating for the Job Owner or an Administrator, to set the values of identified Elements of the specified Document within the specified Job. This operation is parallel to the Set<service>JobElements and Set<service>ServiceElements operations and it follows the same rules for validation, but with the target and response Elements relating to a Document rather than a Job or the Service.
The Client must fully identify the Elements to be set as well as the set values. The only settable Elements are those within the Document Ticket. The Document Data is not part of the Document and cannot be changed using this operation. If a Document was originally submitted without a given settable Element that the Set<service>DocumentElements request attempts to set, the Service adds the specified Element to the Document.
If the client identifies a Document Element but does not specify a value for that Element, then the Service MUST remove the Element and all of its values from the Document. The semantic effect of the client supplying the Element with no value in a Set<service>DocumentElements operation MUST be the same as if the Element had not originally been supplied with the Document. This corresponds to the action of the out-of-band value “DeleteElement” in the antecedent IPP Set-Document-Attributes operation. Any subsequent Get<service>DocumentElements or Get<service>Documents request MUST NOT return any Element that has been deleted. However, a client can re-establish such a deleted Document Element with any supported value(s) using a subsequent Set<service>DocumentElements operation.
If the client supplies an Element in a Set<service>DocumentElements request with no value and that Element is not present in the Document object, the Service ignores that supplied Element in the request, does not return the Element in the Unsupported Elements group, and returns the ‘success’ status code, provided that there are no other problems with the request.
The validation of the Set<service>DocumentElements request is performed by the Service as if the Document had been submitted originally with the new Element values (and the deleted Elements removed); i.e., all modified Document Elements and values must be supported in combination with the Document Elements not modified. If such a Document Creation operation would have been accepted, then the Set<service>DocumentElements MUST be accepted. If such a Document Creation operation would have been rejected, then the Set<service>DocumentElements MUST be rejected and the Document MUST be unchanged. In addition, if any of the supplied Elements are not supported, are not settable, or the values are not supported, the Service MUST reject the entire operation; the Service MUST NOT set just some of the supplied Elements. That is, Set<service>DocumentElements MUST be implemented as an atomic operation; after the operation, all the supplied Elements MUST be set or all of them MUST NOT be set.
The value of JobMandatoryElements supplied in the original Create<service>Job request, if any, MUST have no effect on the behavior of the Set<service>DocumentElements operation. Rather, the Service must consider that any Element or Element value in a Set<service>DocumentElements operation is mandatory. The Service MUST reject any request to set a Document Element to an unsupported value or to a value that would conflict with another Document Element value.
The Service MUST respond to the Set<service>DocumentElements operation as defined for the antecedent Set-Document-Attributes operation in the Standard for IPP Document Objects [PWG5100.5]. Although the Document's current state affects whether the Service accepts or rejects the Set<service>DocumentElements request, the operation MUST NOT change the state of the Document
Page 189 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
562563
2619262026212622
2623
26242625262626272628
26292630263126322633
26342635263626372638263926402641
2642264326442645
2646264726482649265026512652265326542655
26562657265826592660
2661266226632664
564
Working Draft – PWG Semantic Model v2.0 May 9, 2023
object (since the Document is a passive object and the Document state is a subset of the JobState). For example, if the operation creates a request for unavailable resources, the Job (but not the Document) transitions to a new state.
9.3.1.21 Set<service>JobElements
The Set<Service>JobElements operation allows a Client operating for the Job Owner or an Administrator, to set the values of identified Elements of the specified Job. The Client must fully identify the Elements to be set as well as the set values. In the response, the Service returns success or rejects the entire request with indications of which Element or Elements could not be set to the specified values.
This operation is parallel to the Set<service>DocumentElements and Set<service>ServiceElements operations and it follows the same rules for validation, but with the target and response Elements relating to a Job rather than a Document or the Service
If the client identifies a Job Element but does not specify a value for that Element,, then the Service MUST remove the Element and all of its values from the Job. The semantic effect of the client supplying the Element with no value in a Set<service>JobElements operation MUST be the same as if the Element had not originally been supplied with the Job. This corresponds to the action of the out-of-band value “DeleteElement” in the antecedent IPP Set-Job-Attributes operation. Any subsequent Get<service>JobElements or Get<service>Jobs request MUST NOT return any Element that has been deleted. However, a client can re-establish such a deleted Job Element with any supported value(s) using a subsequent Set<service>JobElements operation.
If the client supplies an Element in a Set<service>JobElements request with the DeleteElement value and that Element is not present on the Job object, the Service ignores that supplied Element in the request, does not return the Element in the Unsupported Elements group, and returns the ‘success’ status code, provided that there are no other problems with the request.
The validation of the Set<service>JobElements request is performed by the Service as if the Job had been submitted originally with the new Element values (and the deleted Elements removed); i.e., all modified Job Elements and values must be supported in combination with the Job Elements not modified. If such a Job Creation operation would have been accepted, then the Set<service>JobElements request MUST be accepted. If such a Creation operation would have been rejected, then the Set<service>JobElements MUST be rejected and the Job MUST be unchanged. In addition, if any of the supplied Elements are not supported, are not settable, or the values are not supported, the Service MUST reject the entire operation; the Service MUST NOT partially set some of the supplied Elements. In other words, after the operation, all the supplied Elements MUST be set or none of them MUST be set, thus making the Set<service>JobElements an atomic operation.
The value of JobMandatoryElements supplied in the original Create<service>Job request, if any, MUST have no effect on the behavior of the Set<service>JobElements operation. Rather, the Service must consider that any Element or Element value in a Set<service>JobElements operation is mandatory. The Service MUST reject any request to set a Job Element to an unsupported value or to a value that would conflict with another Job Element value.
The Service MUST accept or reject the Set<service>JobElements operation according to the rules defined for the antecedent Set-Job-Attributes operation in Internet Printing Protocol (IPP):Job and Printer Set Operations [RFC3380].
9.3.1.22 SuspendCurrent<service>Job
The SuspendCurrent<service>Job operation allows a Client operating for the Job Owner or an Administrator, to suspend a Job by setting a condition in a Job that is currently in the Processing or
Page 190 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
565566
266526662667
2668
2669267026712672
267326742675
26762677267826792680268126822683
2684268526862687
2688268926902691269226932694269526962697
26982699270027012702
270327042705
2706
27072708
567
Working Draft – PWG Semantic Model v2.0 May 9, 2023
ProcessingStopped state. This condition, reflected by the JobSuspended value in that Job’s JobStateReasons Element, causes that Job to be in the ProcessingStopped state. The Service is able to processes other Jobs normally, provided that no other inhibiting conditions exist. Note that a Job may be ProcessingStopped state for other reasons and that, once it has been suspended, the Job will remain in the ProcessingStopped state even after the other conditions have been removed.
There is the potential that the current Job may have changed between the time a client requests this operation and the time the Service implements it. Therefore, if the intent is to suspend a particular Job, the Client can include an optional JobId parameter in the request.
The target Job is:
The Job identified by the JobId, if included in the request
If the JobId is not included in the request, any Jobs in the Processing or ProcessingStopped state to which the requestor has access rights.
The Service MUST reject the request and send an appropriate message if:1. There is no target Job in the Processing or ProcessingStopped state to which the requestor has
access rights.2. The target Job or all potential target Jobs have already been suspended.
The Service MUST accept the request, cancel any target Job(s) that have not been previously suspended, and return an appropriate message if:
1. The target JobId is included in the request and that Job is currently in the Processing or ProcessingStopped state (but is not suspended), and the requestor has access rights,
2. If no JobId is included and the requestor has access rights to the Job that is currently in the Processing or ProcessingStopped state (but is not suspended), the Service MUST accept the request and suspend that Job.
3. If more than one Job is in the Processing or ProcessingStopped state (but are not suspended), all such Jobs MUST be suspended unless the operation request included the optional JobId, in which case only the identified target Job MUST be suspended.
4. If the JobId is included in the request and that Job is not currently in the Processing or ProcessingStopped state; or if the JobId is not included and there is no Job currently in the Processing or ProcessingStopped state, the Service MUST reject the request and return the appropriate error code.
5. If the JobId is included in the request and that Job has been suspended; or if no JobId is included and is currently in the Processing or ProcessingStopped state, the Service MUST reject the request and return the appropriate error code.
The Resume<service>Job operation causes a suspended Job to be released. If a Service supports SuspendCurrent<service>Job operation, it MUST support the Resume<service>Job operation, and vice-versa.
9.3.2 Administrative Service Operations
Administrative Service operations directly affect the Service as a whole or affect the Jobs of multiple Job Owners. Access is reserved for Administrators or Operators. The MFD Administrative Service Operations are listed in Error: Reference source not found and are described below.
Page 191 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
568569
27092710271127122713
271427152716
2717
2718
27192720
2721272227232724
27252726272727282729273027312732273327342735273627372738273927402741
274227432744
2745
274627472748
570
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Table 76 Administrative Operations
1. OperationRequest Parameters (Note 2) Response
Parameters (Note 3)Note
Cancel<service>Jobs ElementsNaturalLanguage(optional), JobIds(optional), Message (optional) RequestingUserNameRequestingUserName or RequestingUserUri
JobIds (optional) 1
Disable<service>Service ElementsNaturalLanguage(optional) Message (optional), RequestingUserNameRequestingUserName or RequestingUserUri
Enable<service>Service ElementsNaturalLanguage(optional),Message (optional) RequestingUserNameRequestingUserName or RequestingUserUri
-
HoldNew<service>Jobs ElementsNaturalLanguageRequested (optional), JobHoldUntil | JobHoldUntilTime, Message(optional), RequestingUserNameRequestingUserName or RequestingUserUri
Pause<service>Service ElementsNaturalLanguageRequested (optional), Message(optional), RequestingUserNameRequestingUserName or RequestingUserUri
Pause<service>ServiceAfterCurrentJob ElementsNaturalLanguageRequested (optional), Message(optional), RequestingUserNameRequestingUserName or RequestingUserUri
Promote<service>Job ElementsNaturalLanguageRequested (optional), JobId, Message(optional), PredecessorJobID(optional), RequestingUserNameRequestingUserName or RequestingUserUri
ReleaseNew<service>Jobs ElementsNaturalLanguageRequested (optional), Message(optional), RequestingUserNameRequestingUserName or RequestingUserUri
Restart<service>Service ElementsNaturalLanguageRequested (optional), IsAcceptingJobs| IsAcceptingResources (optional), Message(optional), RequestingUserNameRequestingUserName or RequestingUserUri
Resume<service>Job ElementsNaturalLanguageRequested(optional), JobId, Message(optional), RequestingUserNameRequestingUserName or RequestingUserUri
Resume<service>Service ElementsNaturalLanguageRequested(optional), Message(optional), RequestingUserNameRequestingUserName or RequestingUserUri
Set<service>ServiceElements DefaultJob Ticket(optional), RequestingUserNameRequestingUserName or RequestingUserUri ElementsNaturalLanguageRequested (optional), Capabilities(optional), CapabilitiesReady(optional), Description(optional), Message(optional),
Unsupported Elements(optional)
Shutdown<service>Service ElementsNaturalLanguageRequested(optional), Message(optional), RequestingUserNameRequestingUserName or RequestingUserUri
4
Note 1: Cancel<service>Jobs response includes identified but un-cancellable JobsNote 2: The RequestingUserNameRequestingUserName or RequestingUserUri, is used by the Service to determine whether the requestor is an Administrator, Operator or the Job Owner and is therefore authorized to make the request. Some
Page 192 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
571572
2749
275027512752
573
Working Draft – PWG Semantic Model v2.0 May 9, 2023
implementations may require further authentication of the requestor’s identity. If the requestor is not determined to have access, the Service MUST reject the request.Note 3: All responses must correlate to request and indicate whether request was successful or failed.Note 4: Forcing Service Shutdown may also force the state of any active Jobs to Aborted.
9.3.2.1 Cancel<service>Jobs
The Cancel<service>Jobs operation allows the Operator or Administrator of the Service to cancel all identified non-Terminated Jobs or, if no specific Jobs are identified in the request, to cancel all non-Terminated Jobs in the Service. It differs from the Cancel<service>Job operation in that it works on a number of Jobs at once. If, following the legal Job state Transitions in Table, the Service cannot successfully cancel all explicitly or implicitly requested Jobs that are not already in the terminated state it MUST NOT cancel any Jobs but MUST return an error code. In this case, the Service MUST also return the list of JobIds for those Jobs that were explicitly identified in the request but could not be canceled.
The set of candidate Jobs to be canceled is specified by the supplied JobIds. If no JobIds are supplied, it is implicit that all Jobs that are not in a Terminating state are to be canceled. As with all Administrative operations, the Service MUST check the access rights of the requesting user. Provided that the requester has access rights, the Service MUST check the current state of each of the candidate Jobs. If any of the candidate Jobs cannot be canceled, the Service MUST NOT cancel any Jobs and MUST return the indicated error status code along with the list of offending JobId values. If there are no Jobs that cannot be canceled, the Service MUST transition each identified Job to the indicated new state as defined for the antecedent Cancel-Jobs operation in paragraph 6.1 of Standard for Internet Printing Protocol (IPP):9 Job and Printer Extensions Set 2 [PWG5100.11].
9.3.2.2 Disable<service>Service
The Disable<service>Service operation prevents the Service from creating any new Jobs by negating the IsAcceptingJobs Element. This operation has no effect upon the Service State and the Service is still able to process operations other than Create<service>Job. All previously created or submitted Jobs and all Jobs currently processing continue unaffected.
If the requestor is determined to have proper access, the Service MUST accept this request and MUST negate the IsAcceptingJobs Element.
The IsAcceptingJobs Element value is reaffirmed by the Enable<service>Service operation. If an implementation supports Disable<service>Service it must also support Enable<service>Service and vice-versa.
9.3.2.3 Enable<service>Service
The Enable<service>Service operation asserts the IsAcceptingJobs Element to allow the Service to accept new Create<service>Job requests. The operation has no effect upon the Service State or any other operation requests the Service may receive.
If the requestor is determined to have proper access, the Service MUST accept this request and MUST assert the IsAcceptingJobs Element. The Service MUST then be able to accept and implement Create<Service>Job requests, provided that no other inhibiting condition exists.
If a Service implementation supports the Disable<service>Service operation, then it must also support Enable<service>Service operation and vice-versa.
Page 193 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
5745752753275427552756
2757
2758275927602761276227632764
276527662767276827692770277127722773
2774
2775277627772778
27792780
278127822783
2784
278527862787
278827892790
27912792
576
Working Draft – PWG Semantic Model v2.0 May 9, 2023
9.3.2.4 HoldNew<service>Jobs
The HoldNew<service>Jobs operation allows a client to prevent any new Jobs from being eligible for scheduling by forcing all newly-created Jobs to the PendingHeld state with a JobHoldUntil or JobHoldUntilTime Job Processing Element added, depending upon the Element supplied with the HoldNew<service>Jobs operation request. The operation has the same effect as a Hold<service>Jobs operation except that any Jobs in the Pending or Processing state when the HoldNew<service>Jobs request is accepted are allowed to go to completion, provided that no other conditions or operations prevent this.
The JobHoldUntil parameter allows a client to specify holding new Jobs indefinitely or until a specified named time period. The JobHoldUntilTime parameter allows a client to hold new Jobs until a specified time. Provided that the requestor is authorized and the operation and requested parameters are supported, a Service MUST accept a HoldNew<service>Jobs request and MUST add the supplied 'JobHoldUntil' or JobHoldUntilTime Element to the Jobs. This HoldNew<service>Job condition may be cleared by a ReleaseNew<Service>Jobs operation.
If the HoldNewJobs operation is supported, then the ReleaseNew<Service>Jobs operation MUST be supported, and vice-versa
9.3.2.5 Pause<service>Service
The Pause<service>Service operation allows a client to send the Service to the Stopped state. In this Service state, the Service MUST NOT advance any Job to Job Processing state. Depending on implementation, the Pause<service>Service operation MAY also stop the Service from continuing to process any current Job, sending the Job to the ProcessingStopped state. That is, depending upon implementation, any Job that is currently in the Processing state may be sent to the ProcessingStopped state as soon as the implementation permits; or the Job may continue to a termination state as determined by other conditions. The Service MUST still accept CreateJob operations to create new Jobs, provided that there are no other conditions preventing it.
If the Pause<service>Service operation is supported, then the Resume operation MUST also be supported, and vice-versa.
Service State transitions resulting from a Pause<service>Service operation are the same as defined for the antecedent Pause-Printer operation in paragraph 3.2.7 of IPP/1.1: Model and Semantics [RFC29110. The Pause<service>Service action should be done as soon as the possible after the request is accepted. If the implementation will take more than negligible time to stop processing (perhaps to finish processing the current Job), the Service may remain in the ‘Processing’ state but MUST add the 'MovingToPaused' value to the Service’s StateReasons Element. When the Service transitions to the 'Stopped' state, it removes the 'MovingToPaused' value and adds the 'Paused' value to the Service’s StateReasons Element. If the implementation permits the current Job to stop in mid processing, the Service transitions directly to the ‘Stopped’ state with the Service’s StateReasons Element set to the 'Paused' value and the current Job transitions to the 'ProcessingStopped' state with the JobStateReasons Element set to the 'Stopped' value.
For any Jobs in the 'Pending' or 'PendingHeld' state, the ‘Stopped' value of the Jobs' JobStateReasons Element also applies. However, the Service need not update those Jobs' JobStateReasons Element and need only return the 'Stopped' value when those Jobs are queried (so-called lazy evaluation).
Provided that the requestor is authorized, the Service MUST accept the Pause<service>Service request in any Service state and act as defined for the antecedent Pause-Printer operation in paragraph 3.2.7 of IPP/1.1: Model and Semantics [RFC29110].
Page 194 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
577578
2793
279427952796279727982799
280028012802280328042805
28062807
2808
28092810281128122813281428152816
28172818
2819282028212822282328242825282628272828
282928302831
283228332834
579
Working Draft – PWG Semantic Model v2.0 May 9, 2023
9.3.2.6 Pause<service>ServiceAfterCurrentJob
The Pause<service>ServiceAfterCurrentJob operation allows a client to stop the Service from processing any Jobs once any Jobs currently in Processing are completed. This operation has no effect on the current Jobs and the Service MUST complete the processing of the current Jobs, provided that no other condition or operations preclude it. The Service MUST still accept CreateJob operations to create new Jobs, but MUST not cause any Jobs to enter 'Processing'. If the Pause<service>ServiceAfterCurrentJob operation is supported, then the Resume<service>Service operation MUST also be supported.
Service State transitions resulting from a Pause<service>ServiceAfterCurrentJob operation are as identified for the antecedent Pause-Printer-After-Current-Job operation in IPP: Job and Printer Operations [RFC3998]. Note that, in implementations where the Service implementation is not able to pause Jobs currently in the Processing state, the response to the Pause<service>ServiceAfterCurrentJob request and the Pause<service>Service request are exactly the same.
If the implementation will take more than negligible time to finish processing the current Jobs, the Service will remain in the Processing state and must add the 'MovingToPaused' value to the Service’s StateReasons Element. When the Service transitions to the 'Stopped' state, it removes the 'MovingToPaused' value and adds the 'Paused' value to the Service’s StateReasons Element.
For any Jobs in the 'Pending' or 'PendingHeld' state, their state is unchanged but the JobStateReasons Element must be set to the ‘Stopped' value. However, the Service need not update those Jobs' JobStateReasons Element and only need return the 'Stopped' value when those Jobs are queried (so-called lazy evaluation).
Provided that the requestor is authorized, the Service MUST accept the request in any Service state and MUST transition the Service to the indicated new State as follows before returning the operation response as defined for the antecedent Pause-Printer-After-Current-Job operation in IPP: Job and Printer Operations [RFC3998].
9.3.2.7 Promote<service>Job
The Promote<service>Job operation schedules the identified Job to be processed next, after the currently processing Jobs or, if the request includes the predecessor JobId, immediately after the identified predecessor Job. The Promote<service>Job operation is a combination of the IPP Promote-Job and Schedule-Job-After operations. If the predecessor Job is not specified, it acts in the same way as the antecedent IPP Promote-Job operation. If the predecessor Job is specified, it acts the same way as the antecedent IPP Schedule-Job-After operation.
The identified target Job must be in the 'Pending' state. If the identified target Job is not in the 'Pending' state or if the predecessor Job is identified and it is not in the ‘Pending’, ‘Processing’ or ‘ProcessingStopped’ state, the Service MUST reject the request and return an appropriate status code. If the Promote<service>Job request is accepted, the target Job MUST be processed immediately after the current Jobs or identified predecessor Job reaches a Termination state (Canceled, Completed or Aborted)
Note that the action of this operation is consistent even if a previous Promote<service>Job Request has caused some other Job to be scheduled after the current or predecessor Job; that is, within the rescheduling time limitations of the Service, the Job identified in the last Promote<service>Job Request accepted will be processed next.
9.3.2.8 ReleaseNew<service>Jobs
The ReleaseNew<service>Jobs operation allows a client to remove the condition initiated by HoldNew<service>Jobs and to release all Jobs previously forced to a PendingHeld state by the Page 195 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
580581
2835
283628372838283928402841
28422843284428452846
2847284828492850
2851285228532854
2855285628572858
2859
286028612862286328642865
28662867286828692870
2871287228732874
2875
28762877
582
Working Draft – PWG Semantic Model v2.0 May 9, 2023
HoldNew<service>Jobs initiated condition so that these Jobs are eligible for scheduling. This is done by removing the 'JobHoldUntilSpecified' and ‘JobHeldByService’ values from the Job's JobStateReasons Element and changing the Jobs’ states to ‘Pending’.
Provided that the requestor is authorized, the Service MUST accept this request in any Service state and the Service MUST remove the 'JobHoldUntilSpecified' value from the Job's JobStateReasons Element for any Job previously forced to a PendingHeld state by the HoldNew<service>Jobs initiated condition.
If the ReleaseNew<service>Jobs operation is supported, then the HoldNew<service>Jobs operation MUST be supported, and vice-versa.
9.3.2.9 Restart<service>Service
The Restart<service>Service operation causes a Service in any state, even a previously shut down instance of a Service, to be initialized and set to the Idle state, provided that no errors occur or conditions exist that would prevent normal operation. The handling of Jobs that were in the Processing, Pending, PendingHeld, and ProcessingHeld states state prior to Restart is implementation dependent, but a Service Restart MUST be performed as gracefully as possible and in a way preserving the content and integrity of any non-terminated Jobs. Job history data, if supported, SHOULD also be preserved; a particular Service may make this mandatory.
Provided that the requestor is authorized, the Service MUST accept the request Restart<service>Service regardless of its current state. Providing that no conditions exist that would normally prevent these actions, the Service MUST reinitialize its State to Idle, clear the StateReasons Element and set the IsAcceptingJobs Element to true.
9.3.2.10 Resume<service>Service
The Resume<service>Service operation allows a client to cause the Service to resume scheduling Jobs after scheduling has been paused. Provided that the requestor is authorized and the Service supports this operation, a Service MUST accept a Resume<service>Service request regardless of the current Service state, corresponding to the actions defined for the antecedent Resume-Printer operation in Internet Printing Protocol/1.1: Model and Semantics [RFC2911]. If there are no other reasons why the Service is in the Stopped state, this operation returns the Service from the Stopped state to the Idle or Processing state from which it was paused, and removes the 'Paused' value to the Service’s StateReasons Element.
If the Resume<service>Service operation is supported, then the Pause<service>Service operation MUST be supported, and vice-versa.
9.3.2.11 Set<service>ServiceElements
The Set<service>ServiceElements operation allows a Client to set the values of identified Elements in the Service, provided that they are settable. Settable Elements may be in Service Capabilities, Service Configuration, Service Description and DefaultJob Ticket but not in Service Status.
The Service MUST reject the entire request with indications of which Element or Elements could not be set if a client request attempts to:
1. Set a non-settable Element (including an Element not in the Service Capabilities, Service Configuration, Service Description or DefaultJob Ticket groups, a read-only Element, and an Element not supported or not supported as a writable Element in the specific Service implementation)
Page 196 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
583584
287828792880
288128822883
28842885
2886
2887288828892890289128922893
2894289528962897
2898
2899290029012902290329042905
29062907
2908
290929102911
29122913
2914291529162917
585
Working Draft – PWG Semantic Model v2.0 May 9, 2023
2. Set a settable Element to an invalid value or to a value that conflicts with the values of other Service Elements, including Elements being set in the same request.
3. Set a greater number of Elements in one operation than are supported by the Service implementation (a Service implementation need not support set of more than one Element at a time).
A Set<service>ServiceElements operation that specifies an Element but provides no value for that Element is not an error but rather a request to eliminate that Element and whatever value it has.
If there is no reason to reject setting all of the specified Elements to the specified values or elimination of the Element, the Service MUST accept this operation request when it is in the Idle or Stopped state, and SHOULD accept the request when it is in the Processing state.
If the Service accepts the request, only those Elements specified in the request are changed unless the definition of one or more of the set Elements explicitly specifies an effect upon some other Element.
9.3.2.12 Shutdown<service>Service
The Shutdown<service>Service operation forces the Service to the ‘Down’ state from any state that it is in, in an orderly manner. That is, the Service MUST stop accepting any further client requests, and MUST stop scheduling Jobs for processing as soon as the implementation allows, although it SHOULD complete the processing of any currently processing Jobs. Once down, the Service will no longer respond to any Client requests other than Restart<service>Service request. As with the antecedent IPP Shutdown-Printer operation all Jobs MUST be preserved. As with Restart<service>Service, Service shutdown must be performed as gracefully as possible and in a way in preserving the content and integrity of any non-terminated Jobs. Job history data, if supported, SHOULD also be preserved.
Once shut down, a Service can be roused from its Down state by a Restart<service>Service operation. If a Service implementation supports Shutdown<service>Service it must also support Restart<service>Service and vice-versa. In the down state, the only operation request that a service will respond to is a Restart<service>Service operation.
Provided that the requestor is authorized, the Service MUST accept this operation and following an orderly progression, transition to the Down state regardless of the current state of the Service.
Page 197 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
586587
29182919292029212922
29232924
292529262927
29282929
2930
29312932293329342935293629372938
2939294029412942
29432944
588
Working Draft – PWG Semantic Model v2.0 May 9, 2023
10. Counters & TimersCounters and timers provide necessary information relating to cost accounting, component wear, utilization efficiency, reliability and other factors. Some of the items being counted or periods being timed are specific to a particular Service or Subunit and are discussed in conjunction with that Service or Subunit. However, because MFDs are ultimately concerned with Hardcopy Documents and involve typical computing and communication components, many of the counter and timer types are common to several layers of Elements in the MFD Model as well as in the System. Counters and timers of a particular parameter may be with respect to the MFD System, a Service, or Subunits. Many counters and timers may also apply to a Job or to a Document. The potential for a counter or timer to be present is indicated in the models of the System, Service, Subunit, Job and Document.
These counter types are defined in the PWG Standardized Imaging System Counters specification [PWG5106.1], and are briefly identified in this Chapter. Functionally, counters are classified according to four main areas, as shown below, with the major Work group being further divided.
Work Counters: This category measures work that is produced or processed by the imaging Service or System as its primary function. The Work counters are subdivided into six groups:
1. Work Totals: The sum total of counts in the remaining five Work group counters.2. Datastream: Counters associated with work performed directly in processing datastream content.
That is, these counters reflect the desired primary output of the Service or System.3. Auxiliary: Counters associated with auxiliary content (e.g., banner sheets, confirmations, and
separator sheets) or units of work generated internally by the system or service (e.g., reports, start-up, calibration).
4. Waste Counters: Counters associated with non-productive work or waste generated by the Imaging System
5. Maintenance Counters: Counters associated with all work performed and waste generated while the system is in maintenance mode.
6. Other: Counts accumulated in a WorkTotals counters that are not otherwise discriminated as Datastream, Auxiliary, Waste or Maintenance.
Media Used Counters: Measure of the sheets of defined media types used by an imaging service or consumed across multiple services during the imaging process.
Monitoring Counters: Measure of raw traffic and record of error and fault information associated with a service used to determine workload and operating conditions at a high level.
Availability Counters: Measure of the number of times a service is in a particular state. Availability counters are used to measure availability of a system or service.
The counter Elements associated with the System Status are represented in Error: Reference source not found. Although not evident from this diagram, the WorkTotals counter reflects the totals from only the “work” counters: DataStream, Auxiliary, Maintenance and Waste (and possibly some vendor specific “work” counters) Media Used, Monitoring and Availability counters (and possibly some vendor specific other counters.)are independent. This same ‘counters’ structure is used for System, Services, Subunits, Jobs and Documents.
This chapter describes this structure and that of each of the counter types in the structure.
Page 198 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
589590
2945
294629472948294929502951295229532954
295529562957
2958
29592960296129622963296429652966296729682969297029712972
29732974
29752976
29772978
2979
298029812982298329842985
2986
591
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Figure 115 System Counters
The counter structure can exist at different levels in the model and there should be a relationship between counters. For example, the summation of the Document Counters for all Documents in a Job should equal the values of the corresponding Job Counters. The summation of all Job Counters should equal the values of the corresponding Service Counters. The counters for the System are the accumulation of all counts of that type from all of the Services in the System. The WorkTotals values are a different summation, namely that of all of the Work Counters at the same level. These relationships are represented inError: Reference source not found.
The Counters in the MFD Model are all “lifetime” counters; that is, they are not settable or resettable but accumulate counts for the lifetime of the Document, Job, Service or System to which they apply.
10.1 Work Counters (WorkTotals, DataStream, Auxiliary, Waste and Maintenance)The Work counters reflect an Imaging System, Service or Subunit in performing its primary function. For example, the Work done by a Service producing hardcopy output is measured primarily in terms of Impressions; the Work done by a Service producing Digital Documents is measured in terms of Images. Facsimile Services work is characterized by Messages. Because most Services deal with Digital Data communication, most include a count of Input and/or Output KOctets.
Page 199 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
592593
2987
2988
2989299029912992299329942995
29962997
2998
2999
30003001300230033004
594
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Note that: An Impression is the content imposed upon a one side of a Media Sheet by a marking engine,
independent of the number of times that the sheet side passes any marker. A Blank Impression results when no content is imposed on a Media Sheet side, although the
sheet side has passed though the Marker in a way that could have imposed content. The reverse side of a Media Sheet which has been printed in a simplex [one sided] mode is not considered to have a blank impression.
An Image is the digital representation of a virtual media sheet side. A Message is a single application protocol request or response (that may consist of multiple
application protocol data units) received or sent by Service such as EmailIn or FaxOut. KOctets is the unit of measurement of the amount of data (in 1024 octets) that was consumed
(input) or produced (output) by the Service or System.
Each of the Work Counters (WorkTotals, DataStream, Auxiliary, Waste and Maintenance), at each level where counters may exist, has the same structure, shown in Error: Reference source not found, with constituent Elements listed in Error: Reference source not found. Note however that all counter types are optional.
Page 200 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
595596
3005
300630073008300930103011301230133014301530163017
3018301930203021
597
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Figure 116 Counters, Showing the Derivation of Service Totals and System Totals
Page 201 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
598599
3022
3023
600
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Figure 117 Work Counter Counts Type
Table 77 Counter Elements Used in the Various Service and System Work Counters
Element DataType Description *BlankImpressions int Total of blank impressions, simplex and duplexBlankImpressionsTwoSided int Number of instances where both sides of a sheet printed in duplex are
blankFullColorImages int Number of Images requiring three or more pixel colors to representFullColorImpressions int Number of Impression requiring three or more colorantsFullColorImpressionsTwoSided int Number of instances where both sides of a sheet printed in duplex are
FullColorImpressionsHighlightColorImpressions int Number of Impression requiring a black colorant plus one other colorantHighlightColorImpressionsTwoSided int Number of instances where both sides of a sheet printed in duplex are
HighlightColorImpressionsImages int Total images of all typesImpressions Int Total Impressions of all types
Page 202 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
601602
3024
3025
3026
603
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Element DataType Description *ImpressionsTwoSided int Total number of instances of all types where both sides of a sheet
printed in duplex InputKOctets int Quantity of incoming data In units of 1024 octetsInputMessages int Total number of messages received by the serviceMonochromeImages int Number of Images requiring one pixel color to representMonochromeImpressions int Number of Impression requiring one colorantMonochromeImpressionsTwoSided int Number of instances where both sides of a sheet printed in duplex are
MonochromeImpressionsOutputKOctets int Quantity of outgoing data In units of 1024 octetsOutputMessages int Total number of messages sent by the serviceAny various Extension point for Counts
10.2 MediaUsed CountersThe Media Used counters track the number of sheets of defined media types used by an Imaging System, Service, Job or Document. These counts are necessary for billing and accounting, and for stock control. Media Counter structure is shown in Error: Reference source not found with constituent Elements described in Error: Reference source not found.
Figure 118 Media Used Counters
Table 78 Media Used Counter Elements
Element Datatype Description*
MediaUsedAccountingKey keyword non-localizable keyword ensuring machine readable, locally unique identification of the specific media. This Element MUST clearly distinguish different instances of the same media size (for example, by including specific media color, weight, etc.)
MediaUsedBlankSheets int Count of instances this media had blank impressionMediaUsedFullColorSheets int Count of instances this media had full color impressionMediaUsedHighlightColorSheets int Count of instances this media had highlight color impression
Page 203 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
604605
3027
3028302930303031
3032
3033
3034
606
Working Draft – PWG Semantic Model v2.0 May 9, 2023
MediaUsedMediaInfo string Human readable media descriptionMediaUsedMonochromeSheets int Count of instances this media had monochrome impressionMediaUsedSizeName keyword See PWG Media Standardized Names [PWG 5101.1)MediaUsedTotalSheets int Count of all instancs that this media was used called
MediaUsedSheets in Counter Spec.[PWG5106.1]Any various Extension point for MediaUsed
10.3 Availability CountersThe Availability counters indicate the availability a System, Service or Subunit by measuring the Down Time, Processing Time, Time In, Maintenance Mode and Total Time. Idle Time can be derived by subtracting the Down, Processing and Maintenance time values from Total Time.
The structure of Availability Counters is represented in Error: Reference source not found. The description of the constituent Elements is in Error: Reference source not found.
Figure 119 Availability Counters
Table 79 Availability Counter Elements
Element Datatype DescriptionDownTime int See PWG 5106.1-2007, "The Printer Working Group (PWG)
Standardized Imaging System Counters 1.1" for definitions. Units are in seconds. [PWG5106.1]
MaintenanceTimeProcessingTimeTotalTimeAny various Extension point for Availability
10.4 Monitoring CountersMonitoring counters give a high level view of the imaging System, Service, and Subunit workload and conditions by recording data flow and warnings and errors conditions. The Monitoring counter structure is represented in Error: Reference source not found with the counter types listed in Error: Reference source not found .
Page 204 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
607608
3035
303630373038
30393040
3041
3042
3043
3044
3045304630473048
609
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Figure 120 Monitoring Counts
Table 80 Monitoring Count Elements
Element Datatype DescriptionAbortedJobs int See PWG 5106.1-2007, "The Printer Working Group (PWG)
Standardized Imaging System Counters 1.1" [PWG5106.1] CanceledJobs intCompletedFinisherJobs intCompletedJobs intConfigChanges intCriticalAlerts intLocalStorageKOctets intMemoryAllocErrors intMemoryAllocWarnings intRemoteStorageKOctets intStorageAllocErrors intStorageAllocWarnings intTotalAlerts intAny various Extension point for Monitoring Counts
Page 205 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
610611
3049
3050
3051
3052
3053
612
Working Draft – PWG Semantic Model v2.0 May 9, 2023
11. Conformance RequirementsThis Document does not define the model of any particular Imaging Service but rather defines Elements, terms, concepts and operations common to several Imaging Service Models. Conformance requirements applicable to each Service Model are defined in the specification for that Service Model.
MFD Service Model and MFD System Model specifications MUST import the definitions of Elements, terms and semantics from this specification.
Although when necessary, those MFD Service Model and the MFD System Model specifications may define new Elements, terms or concepts, they MUST NOT attempt to redefine, alter or even restate any of the Elements, terms or semantics defined in this specification.
.
12. Internationalization ConsiderationsAll Element values defined by enumeration (e.g., State) represent keywords. Keywords are never localized by the device. The client may convert the values into a form acceptable to the client. This includes not only localization but also transformations into graphical representation. The Elements with an extensible list of keyword are represented by the union of an enumeration of keywords and a pattern for new values.
Some of the Elements have values that are Service-generated strings (e.g., State Messages). In each operation request, the client identifies a natural language that affects the Service generated strings returned by the Service in operation responses. The Service MUST provide the localized value as requested by the user for any supported natural languages. A request for a language not supported results in a response with the string in the default localization.
The final category of string values are those supplied by administrator or End User (e.g., JobName). No localization is performed on these strings and they are returned in operation responses as set by the administrator or End User.
For interoperability and basic support for multiple languages, conforming implementations MUST support the UTF-8 [RFC3629] encoding of Unicode [UNICODE] [ISO10646].
13. Security ConsiderationsThe exact security model for MFD’s and implementation are out-of-scope for this specification. The IEEE 2600™-2008 standard [IEEE2600] defines security requirements for manufacturers, administrators, and others in the selection, installation, configuration, and usage of hardcopy devices, including MFDs. The common security considerations for all MFD Imaging Services outlined in the MFD Service Model Requirements [MFD-REQ] are intended to support the IEEE 2600™-2008 standard. Implementations must preserve the MFD Service Model semantics when addressing security considerations and requirements.
Security considerations specific to each MFD Service are discussed in the specification for the corresponding Service Model.
.
14. IANA ConsiderationsProvide IANA registration information for this specification.
Page 206 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
613614
3054
30553056305730583059306030613062
3063
3064
3065306630673068
30693070307130723073
307430753076
30773078
3079
308030813082308330843085
30863087
3088
3089
3090
615
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Subsections include IANA registration templates using the Example style:
Some IANA registration text.
15. PWG Registration ConsiderationsThis specification and the associated schema will require an update to register extensions to the MFD Service model. Vendors may use extensions in their own namespace until such time as an update to the specification is under review. At that time the extension can be registered with the PWG and included in the PWG standard.
16. References
16.1 Normative References[CIM-PRINTER]
DMTF CIM Schema Printer class CIM_Printer.mof in any version of [CIM-SCHEMA]
[DCMI]
Dublin Core Metadata Initiative, "Dublin Core Metadata Registry, 1995-2011, http://dcmi.kc.tsukuba.ac.jp/dcregistry/
[CIM-SCHEMA]
DMTF CIM Schema Repository http://dmtf.org/standards/cim
[DSP0004]
DMTF Common Information Model (CIM) Infrastructure, DSP0004, March 2010, http://dmtf.org/sites/default/files/standards/documents/DSP0004_2.6.0_0.pdf
[IANA-FIN]
IANA Finisher MIB (originally published in RFC 3806), June 2004, R. Bergman, H. Lewis, I. McDonald, n http://www.iana.org/assignments/ianafinisher-mib
[IANA-PRT]
IANA Printer MIB (originally published in RFC 3805), June 2004, R. Bergman, H. Lewis, I. McDonald, http://www.iana.org/assignments/ianaprinter-mib
[IEEE2600]
IEEE 2600™-2008 IEEE Standard for Information Technology: Hardcopy Device and System Security, 2008
[IPPREG]
Page 207 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
616617
3091
3092
3093
3094309530963097
3098
3099
3100
3101
3102
3103
31043105
3106
3107
3108
31093110
3111
31123113
3114
31153116
3117
3118
3119
618
Working Draft – PWG Semantic Model v2.0 May 9, 2023
IANA “Internet Printing Protocol (IPP) Registrations”, December 2011, http://www.iana.org/assignments/ipp-registrations/ipp-registrations.xml
[MFD-REQ]
PWG Multifunction Device Service Model Requirements, September, 2010, N. Chen, I. McDonald, W. Wagner, P. Zehler, ftp://ftp.pwg.org/pub/pwg/informational/req-mfdreq10-20100901.pdf
[MFD_SCHEMA]
PWG Semantic Model Schema v1.127, P. Zehler, I. McDonald, Namespace:http://www.pwg.org/schemas/2011/3/sm/ ftp://ftp.pwg.org/pub/pwg/mfd/schemas/PWG_SM2_ver_1.127.zip
[PWG5100.1]
PWG 5100.1-2001, "Internet Printing Protocol (IPP): “finishings” attribute values extension ", February 5, 2001, T. Hastings, D. Fullman, ftp://ftp.pwg.org/pub/pwg/candidates/cs-ippfinishings10-20010205-5100.1.pdf
[PWG5100.2]
PWG 5100.2-2001, "Internet Printing Protocol (IPP): “output-bin” attribute extension ", February 7, 2001, T. Hastings, R. Bergman, ftp://ftp.pwg.org/pub/pwg/candidates/cs-ippoutputbin10-20010207-5100.2.pdf
[PWG5100.3]
PWG 5100.3-2001, "Internet Printing Protocol (IPP): Production Printing Attributes Set1", February 12, 2001, K. Ocke, T. Hastings, ftp://ftp.pwg.org/pub/pwg/candidates/cs-ippprodprint10-20010212-5100.3.pdf
[PWG5100.4]
PWG 5100.4-2001, "Internet Printing Protocol (IPP): Override Attributes for Documents and Pages ", February 7, 2001, K. Ocke, R. Herriot, ftp://ftp.pwg.org/pub/pwg/candidates/cs-ippoverride10-20010207-5100.4.pdf
[PWG5100.5]
PWG 5100.5-2003, "Internet Printing Protocol (IPP): Document Object", October 31, 2003, D. Carney, T. Hastings, and P. Zehler, ftp://ftp.pwg.org/pub/pwg/candidates/cs-ippdocobject10-20031031-5100.5.pdf
[PWG5100.6]
PWG 5100.6-2003, Standard for The Internet Printing Protocol (IPP): Page Overrides”, October 31, 2003, P. Zehler, R. Herriot, K. Ocke, ftp://ftp.pwg.org/pub/pwg/candidates/cs-ipppageoverride10-20031031-5100.6.pdf
[PWG5100.7]
Page 208 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
619620
31203121
3122
312331243125
3126
312731283129
3130
313131323133
3134
313531363137
3138
313931403141
3142
314331443145
3146
314731483149
3150
315131523153
3154
621
Working Draft – PWG Semantic Model v2.0 May 9, 2023
PWG 5100.7-2003, Standard for The Internet Printing Protocol (IPP): Job Extensions”, October 31, 2003, T. Hastings, P. Zehler, ftp://ftp.pwg.org/pub/pwg/candidates/cs-ippjobext10-20031031-5100.7.pdf
[PWG5100.10]
PWG 5100.10-2009, "The Internet Printing Protocol Version 2.0", 31 July 2009, R. Bergman, H. Lewis, I. McDonald, M. Sweet, ftp://ftp.pwg.org/pub/pwg/candidates/cs-ipp20-20090731-5100.10.pdf
[PWG5100.11]
PWG 5100.11-2010 “IPP Job and Printer Extensions Set 2 (JPS2)”, 30 October 2010, T. Hastings, D. Fullman, ftp://ftp.pwg.org/pub/pwg/candidates/cs-ippjobprinterext10-20101030-5100.11.pdf
[PWG5101.1]
PWG 5101.1-2002 Media Standardized Names, February 26, 2002, R. Bergman, T. Hastings, ftp://ftp.pwg.org/pub/pwg/candidates/cs-pwgmsn10-20020226-5101.1.pdf
[PWG5101.2]
PWG 5101.2-2004, "The Printer Working Group (PWG) RepertoireSupported Element", February 1, 2004, H. Lewis, et al, ftp://ftp.pwg.org/pub/pwg/candidates/cs-crrepsup10-20040201-5101.2.pdf
[PWG5105.1]
PWG 5101.2-2004, " Printer Working Group (PWG) Semantic Model ", February 1, 2004, P.Zehler, T. Hastings, S. Albright, ftp://ftp.pwg.org/pub/pwg/candidates/cs-sm10-20040120-5105.1.pdf
[PWG5106.1]
PWG 5106.1-2007, "The Printer Working Group (PWG) Standardized Imaging System Counters 1.1", April 27, 2007, H. Lewis, I. McDonald, J. Thrasher, W. Wagner, and P. Zehler, ftp://ftp.pwg.org/pub/pwg/candidates/cs-wimscount11-20070427-5106.1.pdf
[PWG5106.2]
PWG 5106.2-2006 “Web-based Imaging Management Service V1.0/Abstract Protocol, April 21, 2006. H. Lewis, I. McDonald and W. Wagner, ftp://ftp.pwg.org/pub/pwg/candidates/cs-wims10-20060421-5106.2.pdf
[PWG 5106.4]
PWG 5106.4-2011 “Power Management Model for Imaging Systems 1.0”, February 14, 2011, I. McDonald, ftp://ftp.pwg.org/pub/pwg/candidates/cs-wimspower10-20110214-5106.4.pdf
Page 209 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
622623
315531563157
3158
315931603161
3162
316331643165
3166
31673168
3169
317031713172
3173
317431753176
3177
317831793180
3181
318231833184
3185
31863187
3188
3189
624
Working Draft – PWG Semantic Model v2.0 May 9, 2023
[PWG5108.2]
PWG 5108.2-2009, Network Scan Service Semantic Model and Service Interface v1.0", 10 April 2009, N.Chen, P. Zehler, ftp://ftp.pwg.org/pub/pwg/candidates/cs-sm20-scan10-20090410-5108.02.pdf
[RFC 1696]
RFC 1696, “Modem Management Information Base (MIB) using SMIv2”, August 1994, J. Barnes, L. Brown, R. Royston, S. Waldbusser, ftp://ftp.RFC-editor.org/in-notes/RFC1896.txt
[RFC2119]
RFC 2119, “Key words for use in RFCs to Indicate Requirement Levels”, March 1997, S. Bradner, ftp://ftp.RFC-editor.org/in-notes/RFC2119.txt
[RFC2396]
RFC 2396, “Uniform Resource Identifiers (URI): Generic Syntax”, August 1998, T. Berners-Lee, R. Fielding, L. Masinter, ftp://ftp.RFC-editor.org/in-notes/RFC2396.txt
[RFC2426]
RFC 2426, “vCard MIME Directory Profile”, September 1998, F. Dawson, T. Howes, www.ietf.org/RFC/RFC2426.txt
[RFC2617]
RFC 2617, “HTTP Authentication: Basic and Digest Access Authentication“June 1999, ,J. Franks, P. Hallam-Baker, J. Hostetler, S. Lawrence, P. Leach, A. Luotonen, L. Stewart, http://www.ietf.org/RFC/RFC2617.txt
[RFC 2790]
RFC 2790, “Host Resources MIB, March 2000, S. Waldbusser, P. Grillo, http://www.ietf.org/RFC/RFC3805.txt
[RFC 2863]
RFC 2863, “The Interfaces Group MIB”, June 2000, K. McCloghrie, F. Kastenholz, http://www.ietf.org/RFC/RFC2863.txt
[RFC2911]
RFC 2911 “Internet Printing Protocol/1.1 Model and Semantics”, September 2000, T. Hastings, R. Herriot, R. deBry, S. Isaacson, P. Powell, ftp://ftp.RFC-editor.org/in-notes/RFC2911.txt
[RFC3066]
RFC 3066 “Tags for the Identification of Languages”, January 2001, H. Alvestrand, http://www.ietf.org/RFC/RFC3066.txt
[RFC3192]
Page 210 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
625626
3190
319131923193
3194
31953196
3197
31983199
3200
32013202
3203
32043205
3206
320732083209
3210
32113212
3213
32143215
3216
32173218
3219
32203221
3222
627
Working Draft – PWG Semantic Model v2.0 May 9, 2023
RFC 3192 “Minimal FAX address format in Internet Mail”, October, 2001, C. Allocchio. http://www.ietf.org/RFC/RFC3192.txt
[RFC3380]
RFC 3380 “Internet Printing Protocol (IPP): Job and Printer Set Operations”, September 2002, C. Kugler, H. Lewis, T. Hastings, R. Herriot, http://www.ietf.org/RFC/RFC3380.txt
[RFC 3805]
RFC 3805, “Printer MIB v2”, June 2004, R. Bergman, H. Lewis, I. McDonald, http://www.ietf.org/RFC/RFC3805.txt
[RFC 3806]
RFC 3806, “Printer Finishing MIB”, June 2004, R. Bergman, H. Lewis, I. McDonald, http://www.ietf.org/RFC/RFC3806.txt
[RFC3986]
RFC3986, “Uniform Resource Identifier (URI): Generic Syntax”, January 2005, T. Berners-Lee, R. Fielding, L. Masinter, http://www.ietf.org/RFC/RFC3986.txt
[RFC3998]
RFC 3998 “Internet Printing Protocol (IPP): Job and Printer Administrative Operations”, March 2005, C. Kugler, H. Lewis, T. Hastings, http://www.ietf.org/RFC/RFC3998.txt
[RFC4122]
RFC 4122 “A Universally Unique IDentifier (UUID) URN Namespace”, July 2005, P. Leach, M. Mealling, R. Salz, http://www.ietf.org/RFC/RFC4122.txt
[RFC4355]
RFC4355, “IANA Registration for Enumservices email, fax, mms, ems, and sms”, January 2006, R. Brandner, L. Conroy, R. Stastny, http://www.ietf.org/RFC/RFC4355.txt
[RFC4556]
RFC 4556, “Public Key Cryptography for Initial Authentication in Kerberos (PKINIT)” June 2006, L. Zhu, B. Tung, http://www.ietf.org/RFC/RFC4556.txt
[RFC4648]
RFC 4648, “The Base16, Base32, and Base64 Data Encodings”, October 2006, S. Josefsson, http://www.ietf.org/RFC/RFC4648.txt
[RFC5870]
RFC 5870, “A Uniform Resource Identifier for Geographic Locations ('geo' URI)”, June 2010, A. Mayrhofer, C. Spanring, http://www.ietf.org/RFC/RFC5870.txt
[W3C-XSD1]
Page 211 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
628629
32233224
3225
32263227
3228
32293230
3231
32323233
3234
32353236
3237
32383239
3240
32413242
3243
32443245
3246
32473248
3249
32503251
3252
32533254
3255
630
Working Draft – PWG Semantic Model v2.0 May 9, 2023
XML Schema Part 1: Structures Second Edition W3C Recommendation, 28 October 2004, H. Thompson, D. Beech, M. Maloney, N. Mendelsohn, http://www.w3.org/TR/xmlschema-1/
[W3C-XSD2]
XML Schema Part 2: Datatypes Second Edition, 28 October 2004, P. Biron, A. Malhotra, http://www.w3.org/TR/xmlschema-2/
[WS-Scan]
“Scan Service DefinitionVersion 1.0 For Web Services on Devices”, November 2006, Microsoft, M.Fenelon, http://www.microsoft.com/whdc/connect/rally/wsdspecs.mspx
16.2 Informative References[REFERENCE] F. Last author list or standards body, "Title of referenced document", Document
Number, Month YYYY, URL (if any)
17. Authors' AddressesWilliam A WagnerTechnical Interface ConsultingEmail: [email protected] Voice: (978)251-4565
Peter ZehlerXerox Research Center WebsterEmail: [email protected] Voice: (585) 265-8755Fax: (585) 265-7441US Mail: Peter ZehlerXerox Corp.800 Phillips Rd.M/S 128-25EWebster NY, 14580-9701
The authors would also like to thank the following individuals for their contributions to this standard:
Nancy Chen, OkiDataLee Farrell Ira McDonald, High NorthAnd other members of the PWG MFD Working Group
Page 212 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
631632
32563257
3258
32593260
3261
32623263
3264
32653266
3267
3268326932703271327232733274327532763277327832793280328132823283
3284
3285328632873288
633
Working Draft – PWG Semantic Model v2.0 May 9, 2023
18. Change Log
18.1 January 3, 2012 Initial revision. Converted MFD Model and Common Semantics Version 1.0 to new PWG template & changed name. All the figures have been updated. (Revision marks turned off) – Peter Zehler.
18.2 January 9, 2012 Updated to latest JPs3 and Raster spec. Began adding missing elements to appendix A. Added section on IPP mapping. (Revision marks turned on) – Peter Zehler.
18.3 June 3, 2013 Updated the Abstract, and the section on “About the Semantic Model Working Group” – Daniel Manchala.
Page 213 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
634635
3289
3290
32913292
3293
32943295
3296
3297
3298
3299
636
Working Draft – PWG Semantic Model v2.0 May 9, 2023
19. Appendix A: PWG SMv2 Elements’ Semantic information Table 81 provides information about all the PWG Semantic Model v2 elements. Included in the information is the element’s name, whether or not it can have multiple values, its syntax and a brief description of its semantics. Included in the brief description for elements with syntax of Keyword are some example values. A description of the Group and Constraint fields is included below. Each entry includes a reference to the standard and section number that provides the authoritative details for the element.
Group: 1 – Document Processing2 – Job Description3 – Job Processing4 – Document Description (multi-document job only) 5 – Print Service Description6 - Operational
Constraint:Type2 and Type3 keywords are defined in [rfc2911] §6.1. These are extensible keywords with different registration requirements. All keywords can be extended with vendor or site specific extensions [PWG5108.1] §10. Other constraints include integer ranges or string length.
Table 81 PWG SMv2 Element Summary
Element Name Multivalued Syntax Constraint Group ReferenceDescription (values)
AutoExposure No Boolean N/A 1 [PWG5108.02] § 8.1.3.1.11.1When selected automatic background reduction will be performed on the image. (Included in Exposure)
AutoSkewCorrection No Boolean N/A 1 [PWG5108.02] § 8.1.3.1.3Indicates if detection and correction of small skew orientation error from the media loadingfrom the ADF or placement on the platen by the user is to be applied
Brightness No Integer -100:100 1 [PWG5108.02] § 8.1.3.1.11.2Specifies the relative amount to enhance or reduce the brightness of the image. Negative values will darken the Image. (Included in Exposure)
ColorEntry No Keyword Type2 1 [PWG5108.02] § 8.1.3.1.4This element describes the color processing mode. Each keyword describes a color encoding, color space, bit depth and samples per pixel combination. Values: ColorEntryWKV, KeywordNsExtensionPattern (e.g., Grayscale16, RGBa32, CMYK64)
Page 214 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
637638
3300
33013302330333043305
3306
3307330833093310331133123313
3314
33153316331733183319
3320
639
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Element Name Multivalued Syntax Constraint Group ReferenceDescription (values)
Compression No Keyword Type2 2,4 [RFC2911] §3.2.1.1Client specified compression algorithm used for the Document’s Data. Values: CompressionWKV, KeywordNsExtensionPattern (e.g., Compress, Deflate, Gzip, None)
CompressionSupplied No Keyword Type2 2,4 [PWG5100.7] §5.2.1Default compression algorithm used for the all the Job’s Document Data. Values: CompressionWKV, KeywordNsExtensionPattern (e.g., Compress, Deflate, Gzip, None)
CompressionQualityFactor
No Integer 0:100 1 [PWG5108.02] § 8.1.3.1.6
a normalized integer value used by JPEG compression to determine the amount ofacceptable image loss. The higher the requested compression factor the smaller the resulting file size.
ContentType No Keyword Type2 1 [PWG5108.02] § 8.1.3.1.4This element describes the main characteristics of the original Document. Values: ContentTypeWKV, KeywordNsExtensionPattern (e.g., Auto, Text, Photo)
Contrast No Integer -100:100 1 [PWG5108.02] § 8.1.3.1.11.3Specifies the relative amount to enhance or reduce the contrast of the image. Negative values will reduce the apparent difference between light and dark pixels in the image. (Included in Exposure)
Copies No Integer 1:MAX 1,3 [rfc2911] §4.2.5The number of copies of the associated Document(s) to be printed. (See also JobCopies)
CoverBack No complex Type2 1 [PWG5100.3] §3.1The back cover to apply this Document. (Contains Media/MediaType or MediaCol, CoverType) (See also Job CoverBack)
CoverFront No complex Type2 1 [PWG5100.3] §3.1The front cover to apply to this Document. (Contains Media/MediaType or MediaCol, CoverType) (See also Job CoverFront)
CoverType No Keyword Type2 1 [PWG5100.3] §3.1.2Indicates if covers are requested and which sides will contain print stream pages. Values: CoverTypeWKV, KeywordNsExtensionPattern (e.g., NoCover, PrintNone, PrintFront, PrintBack, PrintBoth) (Included in CoverBack, CoverFront, JobCoverBack & JobCoverFront )
Page 215 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
640641
642
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Element Name Multivalued Syntax Constraint Group ReferenceDescription (values)
CrossFeed No Integer 1:MAX 1 RFC2911] §4.2.12[PWG5108.02] § 8.1.3.1.12
Specifies the resolution in Units for the CrossFeed direction. (Included in Resolution)
Destination No complex Type2 1 [PWG5108.02] § 8.1.3.1.8Indicates where the output of the job is delivered. The destination indicates the location of either a directory or file. (Contains DestinationFile, DestinationDirectory)
DestinationDirectory No URI Unlimited 1 [PWG5108.02] § 8.1.3.1.8.2This element is used when the output of the job is a set of Digital Document files stored in adirectory. (Included in Destination)
DestinationFile No URI Unlimited 1 [PWG5108.02] § 8.1.3.1.8.1This element is used when the output of the job is a Digital Document file. (Included in Destination)
DocumentCharsetSupplied No Keyword Type2 2,4 [PWG5100.7] §5.2.2Default charset of the Documents content. Values:CharsetWKV, StringExtensionPattern (e.g., utf-8, iso-10646-unicode-latin1)
DocumentCopies Yes RangeOfInteger 1:MAX 3 [PWG5100.6] §4.1.3Specifies which copies of a Document to apply the override Processing elements. (Included in Overrides)
DocumentDigitalSignature No Keyword Type2 4 [PWG5100.7] §3.2.3 [PWG5100.5] §9.1.11
The type of digital signature used in the Document Content , Values: DigitalSignatureWKV, KeywordNsExtensionPattern (e.g., None, Pgp, Xdsig)
DocumentDigitalSignatureSupplied No Keyword Type2 2 [PWG5100.7] §5.2.3The type of digital signature used in the Document Content. This , Values: DigitalSignatureWKV, KeywordNsExtensionPattern (e.g., None, Pgp, Xdsig)
DocumentFormat No Keyword Type2 2,4 [RFC2911] §3.2.1.1Document format (i.e., PDL) for the Document content, Values: DocumentFormatWKV, MimeExtensionPattern (e.g., application/postscript, image/jpeg, text/plain) (Included in DocumentFormatDetailsSupplied)
DocumentFormatDetailsSupplied No Complex N/A 2,4 [PWG5100.7] §5.2.4
Page 216 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
643644
645
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Element Name Multivalued Syntax Constraint Group ReferenceDescription (values) Summarizes the default distinct contained document formats (Contains DocumentSourceApplicationName, DocumentSourceApplicationVersion, DocumentSourceOsName, DocumentSourceOsVersion, DocumentFormat, DocumentFormatDeviceId, DocumentFormatVersion, DocumentNaturalLanguage)
DocumentFormatDeviceId No String Maxlength=1023 2,4 [PWG5100.5] §9.1.13Type of device for which the document was formatted, following the IEEE 1284-2000 Device ID string. (Included in DocumentFormatDetailsSupplied)
DocumentFormatSupplied No Keyword Type2 2 [PWG5100.7] §5.2.5Document format (i.e., PDL) for the Document content, Values: DocumentFormatWKV, MimeExtensionPattern (e.g., application/postscript, image/jpeg, text/plain)
DocumentFormatVersion No String Type2 2,4 [PWG5100.5] §9.1.16Level or version of the DocumentFormat. (Included in DocumentFormatDetailsSupplied)
DocumentFormatVersionSupplied No String Type2 2 [PWG5100.7] §5.2.6Level or version of the DocumentFormat.
DocumentMessage No String Maxlength=1023 4 [PWG5100.5] §9.1.20Message from either (1) the user to the operator about the Documents or (2) from the operator, system administrator, or "intelligent" process to indicate to the end user the reasons for modification or other management action taken on the Documents
DocumentMessageSupplied No String Maxlength=1023 2 [PWG5100.7] §5.2.7message from either (1) the user to the operator about the Documents or (2) from the operator, system administrator, or "intelligent" process to indicate to the end user the reasons for modification or other management action taken on the Documents
DocumentMetadata No Complex N/A 4 [DCMI][JPS3] § 5.1.1
The Dublin Core Metadata Element Set for the document. The XML binding uses XML schema from <http://dublincore.org/schemas/xmls/qdc/2008/02/11/qualifieddc.xsd>. See JPS3 § 5.1.1 for IPP encoding.
DocumentName No String Maxlength=255 4 [PWG5100.5] §9.1.21Name for the Document to be used in an implementation specific manner.
DocumentNameSupplied No String Maxlength=255 2 [PWG5100.7] §5.2.8Default name for the Documents in the Job to be used in an implementation specific manner.
DocumentNaturalLanguage No Keyword Type2 2,4 [RFC2911] §3.2.1.1
Page 217 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
646647
648
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Element Name Multivalued Syntax Constraint Group ReferenceDescription (values) Primary Natural Language of the Document. Values: NaturalLanguageWKV, NatLangExtensionPattern (e.g., en, de, fr, en-us) (Included in DocumentFormatDetailsSupplied)
DocumentNumbers Yes RangeOfInteger 1:MAX 3 [PWG5100.6] §4.1.2Specifies the documents in a Job for override processing. (Included in Overrides)
DocumentPassword No Base64Binary 1:1366 1 [JPS3] §5.1.2Specifies the unencrypted passphrase to be used to access the document content. (DocumentPassword length maximum is 1024 octets before encoding)
DocumentSourceApplicationName No String Type2 2,4 [PWG5100.5] §9.1.13Name of the application that created the document, without its version number. (Included in DocumentFormatDetailsSupplied)
DocumentSourceApplicationVersion No String Type2 2,4 [PWG5100.5] §9.1.13Version of the application that created the document, without its name. (Included in DocumentFormatDetailsSupplied)
DocumentSourceOsName No Keyword Type3 2,4 [PWG5100.5] §9.1.13Name of the operating system, without version number, on which the document was generated. Values: OperatingSystemNameWKV, OperatingSystemNameExtensionPattern (e.g., LINUX, OSX , WIN32 ) (Included in DocumentFormatDetailsSupplied)
DocumentSourceOsVersion No String Type2 2,4 [PWG5100.5] §9.1.13version of the operating system, without its name, on which the document was generated. (Included in DocumentFormatDetailsSupplied)
DocumentUri No URI Unlimited 2,4 [PWG5100.5] §9.1.28Reference to the document to print. (See also [rfc2911] § 3.3.2)
DocumentMessage No String Maxlength=1023 4 [PWG5100.5] §9.1.20A message from either (1) the user to the operator about the Document or (2) from the operator, system administrator, or "intelligent" process to indicate to the end user the reasons for modification or other management action taken on the Document.
DocumentName No String Maxlength=255 4 [rfc2911] §3.2.1.1Name for this Document to be used in an implementation specific manner.
DocumentNaturalLanguage No String Maxlength=127 4 [rfc2911] §3.2.1.1[PWG5100.5] §9.1.22
Identifies the primary Natural Language of this Document.
ElementsNaturalLanguage No Keyword Type2 2 [rfc2911] §4.3.20
Page 218 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
649650
651
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Element Name Multivalued Syntax Constraint Group ReferenceDescription (values) Identifies the natural language used for any Client supplied strings. Values: NaturalLanguageWKV, NatLangExtensionPattern (e.g., en, de, fr, en-us)
Exposure No complex Type2 1 [PWG5108.02] § 8.1.3.1.11Specifies how the Service will employ image processing techniques to reduce the background of the Document to a white Image. (Contains AutoExposure, Brightness, Contrast, Sharpness, and Any)
Feed No Integer 1:MAX 1 RFC2911] §4.2.12[PWG5108.02] § 8.1.3.1.12
Specifies the resolution in Units for the Feed direction. (Included in Resolution)
FeedOrientation No Keyword Type3 1 [PWG5100.11] §7.1Specifies the media edge that is fed into the print engine from the paper tray. Values: FeedOrientationWKV, KeywordNsExtensionPattern (e.g., LongEdgeFirst ShortEdgeFirst)
Finishings Yes Keyword Type2 1 [rfc2911] §4.2.6[PWG5100.1] §2
Identifies the finishings that the PrintService uses for each copy of the Output Document. Values: FinishingsWKV, KeywordNsExtensionPattern (e.g., Bale, Bind, BindLeft, BookletMaker, EdgeStitch, Fold, JogOffset, None, Punch, Staple, StapleTopLeft, Trim). (See also JobFinishings Job element)
FinishingsCol No complex N/A 1 [PWG5100.3] §3.2Enables an end user to specify detailed finishing options not possible with the “Finishings” element for the Output Document. (Contains FinishingTemplate, Stitching) (See also JobFinishingsCol element)
FinishingTemplate No String Maxlength=1023 1 [PWG5100.3] §3.2.1A string specifying some particular finishing operation. (Included in FinishingsCol, JobFinishingsCol)
FirstIndex No Integer 0:MAX 6 [PWG5108.02] § 8.1.3.1.12Specifies the first object or element, starting at 0, to be returned in a response.
FontNameRequested No String Maxlength=255 1 [PWG5100.11] §7.2Specifies the name of the font if the document data is in a format that does not have inherent font information (e.g., ‘text/plain’), otherwise, this element is ignored.
FontSizeRequested No Integer 1:MAX 1 [PWG5100.11] §7.3
Page 219 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
652653
654
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Element Name Multivalued Syntax Constraint Group ReferenceDescription (values) Specifies the font size in points (1/72 of an inch) if the document data is in a format that does not have inherent font information, otherwise, this element is ignored.
ForceFrontSide Yes Integer 1:MAX 1 [PWG5100.3] §3.3Forces the specified pages to be printed on the front side of a sheet of media. The pages of the output document start at 1.
Height No Integer MIN:MAX 1 [PWG5108.02] §8.1.3.1.15.1.1Element identifies the height of the image box in RegionUnits. (Contained in ImageBox)
IdentifyActions Yes List of keywords Type 3 6 [JPS3] § 5.1.4Specifies the action(s) that are taken to identify the device hosting the service.
IdentifyActionsDefault Yes List of keywords Type 3 5 [JPS3] § 5.6.3Specifies the defaults action(s) that are taken to identify the device hosting the service.
IdentifyActionsSupported Yes List of keywords Type 3 5 [JPS3] § 5.1.4Specifies the defaults action(s) that are taken to identify the device hosting the service.
ImageBox No Complex N/A 1 [PWG5108.02] § 8.1.3.1.15.1Describes the region where the Image from the scan of the ScanRegion will be placed. (Contains Height, RegionUnits, Width, XOffset, YOffset)
ImagesToTransfer No Integer 0:MAX 1 [PWG5108.02] § 8.1.3.1.13Specifies the number of Images to scan from the Hardcopy Document.
ImpositionTemplate No Keyword Type2 1 [PWG5100.3] §3.4Specifies imposition method for laying out finished page images onto the surface of output media. Values: ImpositionWKV, KeywordNsPattern (e.g., None, Signature)
Impressions No Integer 0:MAX 2,4 [RFC2911] §4.3.17.2Total size in number of impressions in all the Job‟s Document(s).
InputSource No Keyword Type2 1 [PWG5108.02] § 8.1.3.1.14Specifies the source of the scanned Document. Values: InputSourceWKV, KeywordNsPattern (e.g., ADF, Platen, FilmReader)
InsertAfterPageNumber No Integer 0:MAX 1 [PWG5100.3] §3.5.1
Specifies the input page after which the Insert Sheet will be placed. Pages are numbered starting at 1. A 0 value means in front of the first page. (Included in InsertSheet)
Page 220 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
655656
657
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Element Name Multivalued Syntax Constraint Group ReferenceDescription (values)
InsertCount No Integer 0:MAX 1 [PWG5100.3] §3.5.2
Specifies the number of Insert Sheet to insert. (Included in InsertSheet)
InsertSheet Yes complex N/A 1 [PWG5100.3] §3.5Specifies how Insert Sheets are to be inserted into the sequence of media sheets that are produced for each copy of the documents. (Contains InsertAfterPageNumber, InsertCount, Media/MediaType or MediaCol)
JobAccountingID No String Maxlength=1023 2 [PWG5100.3] §3.6The account associated with the job (e.g., customer name, internal billing number) . Use of this element is implementation dependent.
JobAccountingOutputBin No Keyword Type3 3 [PWG5100.3] §3.8.3Specifies the output bin where the accounting sheet is to be placed. Values: OutputBinWKV, KeywordNsPattern (e.g., Bottom, FaceUp, LargeCapacity, Left, MailboxN*, Rear, Right, Side, StackerN*, Top, TrayN*. *Note: N is replaced by a cardinal number)
JobAccountingSheets No complex N/A 3 [PWG5100.3] §3.8Specifies the accounting sheet for a job. (Contains JobAccountingSheetsType, Media/ MediaType or MediaCol, JobAccountingOutputBin).
JobAccountingSheetsType No Keyword Type3 3 [PWG5100.3] §3.8.1Specifies the accounting sheet format for a job. Values: JobAccountingSheetsTypeWKV, KeywordNsPattern (e.g., None, Standard) (Included in JobAccountingSheets)
JobAccountingUserID No String Maxlength=1023 2 [PWG5100.3] §3.7Specifies the user ID associated with the account specified by the JobAccountingID. These two elements are used for authentication and account tracking
JobCopies No Integer 1:MAX 3 [PWG5100.7] §4.1.1The number of copies of the Job to be printed. (See also Copies)
JobCoverBack No complex N/A 3 [PWG5100.7] §4.1.2The back cover to apply this Job. (Contains Media/MediaType or MediaCol, CoverType) (See also Job CoverBack)
JobCoverFront No complex N/A 3 [PWG5100.7] §4.1.3The front cover to apply to this Job. (Contains Media/MediaType or MediaCol, CoverType) (See also Job CoverFront)
JobDelayOutputUntil No Keyword Type3 3 [PWG5100.11] §7.4
Page 221 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
658659
660
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Element Name Multivalued Syntax Constraint Group ReferenceDescription (values) Specifies the named time period during which the Job output may be produced. Other job processing can occur at any time. Values: HolddUntilWKV, KeywordNsPattern (e.g., NoHold, Indefinite, DayTime, Evening, Night, Weekend, SecondShift, ThirdShift)
JobDelayOutputUntilTime No String DateTime [rfc1123] 3 [PWG5100.11] §7.5Specifies the date and time after which the Job output may be produced. Other job processing can occur at any time. (e.g., Fri, 03 May 2002 08:49:37 GMT)
JobErrorSheet No complex N/A 3 [PWG5100.3] §3.9Specifies the error sheet for a job. (Contains JobErrorSheetType, JobErrorSheetWhen, Media/MediaType or MediaCol).
JobErrorSheetType No Keyword
Type3 3 [PWG5100.3] §3.9.1
Specifies the error sheet format for a job. Values: JobErrorSheetTypeWKV, KeywordNsPattern (e.g., None, Standard) (Included in JobErrorSheet)
JobErrorSheetWhen No Keyword Type2 3 [PWG5100.3] §3.9.2Indicateds conditions required to produce JobErrorSheet. Values: JobErrorSheetWhenWKV, KeywordNsExtensionPattern (e.g., OnError, Always) (Included in JobErrorSheet)
JobFinishings Yes Keyword Type2 3 [PWG5100.7] §4.1.4Identifies the finishings that the PrintService uses for the Job. Values: FinishingsWKV, KeywordNsExtensionPattern (e.g., Bale, Bind, BookletMaker, Fold, JogOffset, None, Punch, Staple, StapleTopLeft, Trim). (See also Finishings element)
JobFinishingCol No complex N/A 3 [PWG5100.7] §4.1.5Enables an end user to specify detailed finishing options not possible with the “JobFinishings” element for the Job. (Contains FinishingTemplate, Stitching) (See also FinishingsCol element)
JobHoldUntil No Keyword Type3 3 [rfc2911] §4.2.2Specifies the named time period during which the Job must become a candidate for processing (i.e., document(s) interpreted and output produced). Values: HolddUntilWKV, KeywordNsPattern (keywords: NoHold, Indefinite, DayTime, Evening, Night, Weekend, SecondShift, ThirdShift)
JobHoldUntilTime No String DateTime [rfc1123] 3 [PWG5100.11] §7.6Specifies the date and time after which the Job must become a candidate for processing (i.e., document(s) interpreted and output produced). (e.g., Fri, 03 May 2002 08:49:37 GMT)
JobMandatoryElements Yes List of keywords Type 3 3 [PWG5100.7] §3.12
Page 222 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
661662
663
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Element Name Multivalued Syntax Constraint Group ReferenceDescription (values) This deprecated element permits the client to identify which Processing elements the PrintService MUST support in this Job Creation request in order to accept the Job. This element has been replaced by the “MustHonor” attribute on all the processing elements. Values: Any Processing element keyword
JobMessageFromOperator
No String Maxlength=1023 2 [rfc2911] §4.3.16
Message from an operator, system administrator or "intelligent" process to indicate to the end user the reasons for modification or other management action taken on a job. (e.g., “Job held until system maintenance completed”)
JobMessageToOperator No String Maxlength=1023
2 [PWG5100.3] §3.10
Message from the end user to indicate something about the processing of this Job. (e.g., “Call 555-1234 before running this job”)
JobMoreInfo No URI Unlimited 2 [rfc2911] §4.3.4the URI referencing some resource with more information about this Job Object, perhaps an HTML page containing information about the Job.
JobName No String Maxlength=255 2 [rfc2911] §4.3.5User friendly name of the Job. It does not have to be unique.
JobOriginatingUserName No String Maxlength=255 2 [rfc2911] §4.3.5Name of the end user that submitted the print job. The PrintService sets this element to the most authenticated printable name.
JobOriginatingUserUri No URI Unlimited 2 [JPS3] §5.3.56URI of the User that submitted the Job creation request. The PrintService sets this element to the most authenticated user URI available. This element differs from JobOriginatingUserName which is a human readable name. This element is a URI (e.g., urn:uuid:f92eface-7dec-21c3-ab55-12d3c91eabff, mailto:[email protected]).
JobPassword No Base64Binary Unlimited1:340
2 [PWG5100.11] §6.1
Password supplied by the client, encrypted according to method specified by the client in the JobPasswordEncryption Element. (JobPassword length maximum is 255 octets before encoding)
JobPasswordEncryption No Keyword type3 2 [PWG5100.11] §6.2Encryption the client is using for the supplied value of the JobPassword Element. Values: JobPasswordEncryptionWKV, KeywordNsExtensionPattern (e.g., None, Shah, MD5)
JobPhoneNumber No String Maxlength=127 3 [PWG5100.11] §7.7,
Page 223 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
664665
666
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Element Name Multivalued Syntax Constraint Group ReferenceDescription (values) Contains the contact telephone number for this Job.
JobPriority No Integer 1:100 3 [rfc2911] §4.2.1Priority for scheduling the Job. A higher value specifies a higher priority.
JobRecipientName No String Maxlength=255 3 [PWG5100.11]§ 5.6Name of the intended recipient of the Job.
JobSaveDisposition No Complex N/A 3 [PWG5100.11] §7.9Specifies that the PrintService is to save the job as a file that can be re-printed on demand anytime in the future (Contains SaveDisposition, SaveInfo)
JobSheetMessage No String Maxlength=1023 3 [PWG5100.3] §3.12Conveys a message that is delivered with the job.
JobSheets No Keyword type3 3 [rfc2911] §4.2.3Specifies which job start/end sheet(s), will be printed with a job. Values: JobSheetsWKV, KeywordNsExtensionPattern (e.g., None, Standard, JobStartSheet, FirstPrintStreamPage)
JobSheetsCol No complex N/A 3 [PWG5100.3] §3.11Enables an end user to specify detailed Job Sheet options not possible with the “JobSheet” element. (Contains JobSheets, Media/MediaType or MediaCol)
JobUuid No URI Maxlength=45 2 [JPS3] §5.3.1Specifies a globally-unique identifier for the job. This element is a URN (e.g., urn:uuid:f92eface-7dec-21c3-ab55-12d3c91eabff).
Koctets No Integer 0:MAX 2,4 [rfc2911] §4.3.17.1Total size of this Job‟s Digital Document(s) in integral units of 1024 octets.
LastDocument No Boolean N/A 4 [PWG5100.5] §9.1.35Indicates whether or not this Document is the last Document in the Job.
Margin No complex N/A 1,3 [JPS3] §7.4
Defines the PrintService's physical margin for the associated media in hundredths of millimeters. (Contains media-bottom-margin, media-left-margin, media-right-margin, media-top-margin)
MediaBottomMargin No int 0:MAX 1,3 [JPS3] §7.4.1
Defines the PrintService's physical bottom margin in hundredths of millimeters from the bottom edge, without respect to the value of the “OrientationRequested” element.
Page 224 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
667668
669
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Element Name Multivalued Syntax Constraint Group ReferenceDescription (values)
MediaBottomMarginSupported Yes int 0:MAX 1,3 [JPS3] §5.6.9
Lists the supported values for the "MediaBottomMargin" in hundredths of millimeters or 1/2540th of an inch and specifies a hardware margin supported by the Printer
MediaLeftMargin No int 0:MAX 1,3 [JPS3] §7.4.2
Defines the PrintService's physical left margin in hundredths of millimeters from the left edge, without respect to the value of the “OrientationRequested” element.
MediaLeftMarginSupported Yes int 0:MAX 1,3 [JPS3] §5.6.10
Lists the supported values for the "MediaLeftMargin" in hundredths of millimeters or 1/2540th of an inch and specifies a hardware margin supported by the Printer
MediaRightMargin No int 0:MAX 1,3 [JPS3] §7.4.3
Defines the PrintService's physical right margin in hundredths of millimeters from the right edge, without respect to the value of the “OrientationRequested” element.
MediaRightMarginSupported Yes int 0:MAX 1,3 [JPS3] §5.6.11
Lists the supported values for the "MediaRightMargin" in hundredths of millimeters or 1/2540th of an inch and specifies a hardware margin supported by the Printer
MediaSheets No int 0:MAX 4 [rfc2911] §4.3.17.3
The total number of media sheets to be produced for this Document. (job-media-sheets in IPP)
MediaTopMargin No int 0:MAX 1,3 [JPS3] §7.4.7
Defines the PrintService's physical top margin in hundredths of millimeters from the top edge, without respect to the value of the “OrientationRequested” element.
MediaTopMarginSupported Yes int 0:MAX 1,3 [JPS3] §5.6.12
Lists the supported values for the "MediaTopMargin" in hundredths of millimeters or 1/2540th of an inch and specifies a hardware margin supported by the Printer
Page 225 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
670671
672
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Element Name Multivalued Syntax Constraint Group ReferenceDescription (values)
Media No Keyword type3 1,3 [RFC2911] ] §4.2.11, [PWG5101.1] §5
The name of the medium that the PrintService uses for all impressions of the Job. Values: MediaWKV, MediaNsExtensionPattern (e.g., na_letter_8.5x11in, iso_a4_210x297mm, na_monarch_3.875x7.5in, choice_iso_a4_210x297mm_na_letter_8.5x11in. ) (Included in CoverBack, CoverFront, InsertSheet, SeparatorSheets, JobAccountingSheets, JobCoverBack, JobCoverFront, JobErrorSheet, JobSheetsCol, MediaCol)
MediaBox No Complex N/A 1 [PWG5101.1] §5
This element is only applicable when the document format used to store the Digital Document has a similar construct that controls the placement and bounding of the scanned Image on the document format specific page Image. (Contains ImageBox, ImageCroppingPolicy, MediaSizeName, OrientationRequested )
MediaCol No complex N/A 1,3 [PWG5100.3] §3.13Enables a client end user to submit a list of media characteristics to the PrintService as a way to more completely specify the media to be used than the Media element. (Contains MediaBackCoating, MediaColor, MediaFrontCoating, MediaGrain , MediaHoleCount, MediaInfo, MediaKey, MediaOrderCount, MediaPrePrinted, MediaRecycled, MediaSize, MediaSizeName, MediaThickness, MediaTooth, MediaType, MediaWeightMetric, Margins, MediaSource) (Included in CoverBack, CoverFront, InsertSheet, SeparatorSheets, JobAccountingSheets, JobCoverBack, JobCoverFront, JobErrorSheet, JobSheetsCol)
MediaBackCoating No Keyword Type3 1,3 [PWG5100.3] §3.13.10Indicates the pre-process coating applied to the back of the media. Values: MediaCoatingWKV, MediaNsExtensionPattern (e.g., None, Glossy, HighGloss, SemiGloss, Satin, Matte) (Included in MediaCol)
MediaColor No Keyword Type3 1 [PWG5100.3] §3.13.4Indicates the desired color of the media being specified. Values: MediaColorWKV, KeywordNsExtensionPattern (e.g., no-color, white, pink, yellow, blue, green, buff, goldenrod, red, gray, ivory, orange) (See also [pwg5101.1] §4) (Included in MediaCol)
MediaFrontCoating No Keyword Type3 1,3 [PWG5100.3] §3.13.10Indicates the pre-process coating applied to the front of the media. Values: MediaCoatingWKV, MediaNsExtensionPattern (e.g., None, Glossy, HighGloss, SemiGloss, Satin, Matte) (Included in MediaCol)
MediaGrain No Keyword Type3 1,3 [PWG5100.11] §11.5.2Indicates the grain of the media. Values: MediaGrainWKV, KeywordNsExtensionPattern (e.g, x-direction, y-direction) (Included in MediaCol)
MediaHoleCount No Integer 0:MAX 1,3 [PWG5100.3] §3.13.6
Page 226 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
673674
675
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Element Name Multivalued Syntax Constraint Group ReferenceDescription (values) Indicates the number of pre-drilled holes in the desired media. (Included in MediaCol)
MediaInfo No String Maxlength=255 1,3 [PWG5100.3] §3.13.3Specifies information that helps describe the media instance. Intended for human consumption. (Included in MediaCol)
MediaInputTrayCheck No Keyword Type3 1 [PWG5100.3] §3.14Indicates that the characteristics of the media in the identified input tray must match the characteristics of the media identified by the "media" or "media-col" element. Values: MediaInputTrayWKV, MediaNsExtensionPattern (e.g., Top, Middle, Bottom, Side, LargeCapacity, Envelope, Main, Manual. See [RFC2911] Appendix C)
MediaKey No Keyword Type3 1,3 [PWG5100.3] §3.13.1The unique media name associated with an instance of MediaCol elements and their values. Identical values of MediaKey and the Media element represent the same media. (Included in MediaCol)
MediaOrderCount No Integer 1:MAX 1,3 [PWG5100.3] §3.13.7Indicates the number of sheets, within an ordered sequence of sheets; after which the sequence begins to repeat. (Included in MediaCol)
MediaPrePrinted No Keyword Type3 1,3 [PWG5100.3] §3.13.115
Indicates the pre-printed characteristics of the desired media. Values: MediaPrePrintedWKV, KeywordNsExtensionPattern (e.g., Blank, PrePrinted, LetterHead) (Included in MediaCol)
MediaRecycled No Keyword Type3 1,3 [PWG5100.3] §3.13.1011
Indicates the recycled characteristics of the media. Values: MediaRecycledWKV, KeywordNsExtensionPattern (e.g., None, Standard) (Included in MediaCol)
MediaSheets No Integer 0:MAX 2,4 [RFC2911] §4.3.17.2Total size in number of impressions in all the Job‟s Document(s).
MediaSize No Complex N/A 1,3 [PWG5100.3] §3.13.8Explicitly specifies the numerical media width and height dimensions in hundredth of a millimeter. (Contains XDimension, YDimension) (Included in MediaCol)
MediaSizeName No Keyword Type3 1,3 [PWG5108.02] § 8.1.3.1.15.3 , [PWG5101.1] §5 [PWG5100.5] §8.1.
Page 227 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
676677
678
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Element Name Multivalued Syntax Constraint Group ReferenceDescription (values) The size of the canvas for an Image in the Digital Document expressed as a named size. (See Media)The medium size that the PrintService uses for all impressions of the Job. Values: MediaWKV, MediaNsExtensionPattern (e.g., na_letter_8.5x11in, iso_a4_210x297mm, na_monarch_3.875x7.5in). (See also [pwg5101.1] §5) (Included in MediaColMediaBox)
MediaSource No Keyword Type3 1,3 JPS3] §7.4.5Specifies the input tray, slot, roll, or other source for the media Values: MediaSourceWKV, KeywordNsExtensionPattern (e.g., Auto, Bottom, Envelope, LargeCapacity, Top, Tray1) (Included in MediaCol)
MediaThickness No Integer 1:MAX 1,3 [PWG5100.11] §11.5.3The thickness of the media in units of one hundredth of a millimeter. This unit is equivalent to 1/2540 th of an inch. (Included in MediaCol)
MediaTooth No Keyword Type3 1,3 [PWG5100.11] §8.4.111.5.1
The tooth (or roughness) of the media. Values: MediaToothWKV, KeywordNsExtensionPattern (e.g., Fine, Medium, Coarse, Linen) (Included in MediaCol)
MediaType No Keyword Type3 1,3 [PWG5101.1] §3[WS-Print] §3.5.2.3.2
The medium type that the PrintService uses for all impressions. Values: MediaTypeWKV, KeywordNsExtensionPattern (e.g., stationery, transparency envelopecontinuous, tab-stock, pre-cut-tabs, photographic, cardstock, other) (Included in CoverBack, CoverFront, InsertSheet, JobAccountingSheets, JobCoverBack, JobCoverFront, JobErrorSheet, JobSheetsCo, MediaCol l, SeparatorSheets)
MediaWeightMetric No Integer 0:MAX 1,3 [PWG5100.3] §3.13.9Indicates the weight of the desired media rounded to the nearest whole number of grams per square meter. (Included in MediaCol)
MultipleDocumentHandling No Keyword type2 3 [rfc2911] §4.2.4Controls whether Input Document in multi-Document jobs are combined into a single Output Document or are kept as separate Output Documents Useful for application of Finishings. Values: MultipleDocumentsHandlingWKV, KeywordNsExtensionPattern (e.g. SingleDocument, SeparateDocumentCollatedCopies, SingleDocumentNewSheet)
NumberOfPagesInSubset Yes Integer 1:MAX 3 [PWG5100.4] §5.3
Specifies The number of pages in a subset of pages of the document PDL data. (Included in PagesPerSubset)
NumberUp No Integer 1:MAX 1 [rfc2911] §4.2.9
Page 228 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
679680
681
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Element Name Multivalued Syntax Constraint Group ReferenceDescription (values) Indicates the number of Input pages that the PrintService is to image on one impression.
OrientationRequested No Keyword type2 1 [rfc2911] §4.2.10The desired orientation for printed pages for document formats that don’t have a built-in orientation. Values: OrientationRequestedWKV, KeywordNsExtensionPattern (e.g., Portrait, Landscape, ReverseLandscape, ReversePortrait)
OutputBin No Keyword type2 1,3 [PWG5100.2] §2.1 [PWG5100.5] §8.1
Specifies the output bin where the job is to be delivered. Values: OutputBinWKV, KeywordNsExtensionPattern (e.g., Bottom, FaceUp, LargeCapacity, Left, MailboxN*, Rear, Right, Side, StackerN*, Top, TrayN*. *Note: N is replaced by a cardinal number)
OutputDevice No String Maxlength=255
1,3 [PWG5100.7] §4.2.1 [PWG5100.5] §8.1
Specifies the device where the pages of of a Job/Document will be printed.
Overrides Yes complex N/A 3 [PWG5100.6] §4.1Provides for the overriding of processing instructions on a page basis. (Contains Pages, DocumentNumbers, DocumentCopies, OverridingElements)
OverridingElements Yes Any Supported Element 3 [PWG5100.6] §4.1.4Document Ticket processing elements to apply to the Document pages specified in the Override (Contained in Overrides)
PageDelivery No Keyword Type2 1 [PWG5100.3] §3.15Indicates whether the pages of the job are to be delivered to the output bin or finisher in the same page order as the original document and face up or face down. Values: PageDeliveryWKV, KeywordNsExtensionPattern (e.g., ReverseOrderFaceDown, SameOrderFaceUp, SystemSpecified) . (See also PageOrderReceived)
PageOrderReceived No Keyword Type3 2,4 [PWG5100.3] §3.16The order of pages in this Document data as supplied with the job. Values: PageOrderReceivedWKV, KeywordNsExtensionPattern (e.g., 1ToNOrder, NTo1Order)
PageRanges Yes RangeOfInteger 1:MAX 1 [RFC2911] §4.2.7Specifies a range of pages in the document data to be output.
Pages Yes RangeOfInteger 1:MAX 3 [pwg5100.6] §4.1.1Specifies a range of pages in the document PDL data. (Included in Overrides)
PagesPerSubset Yes Complex Ordered list of Integer 3 [PWG5100.4JPS3] §5.32.1
Page 229 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
682683
684
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Element Name Multivalued Syntax Constraint Group ReferenceDescription (values) Combines all of the Pages of all of the Documents into a single stream of Pages. Then the PrintService partitions that single stream into contiguous subsets of Pages according to the list of integers. The list of integers is cyclical. When the last integer in the list is reached, the next subset uses the first.in the list. (Contains NumberOfPagesInSubset)
PdlInitFile Yes Complex N/A 1 [PWG5100.11] §7.10Controls initialization of the PrintService’s Page Description Language (PDL) interpreter. (Contains PdlInitFileEntry, PdlInitFileLocation. PdlInitFileName)
PdlInitFileEntry No String Maxlength=255 1 [PWG5100.11] §7.10Specifies an entry point within the init file at which the PDL interpreter starts. (Included in PdlInitFile)
PdlInitFileLocation No String Maxlength=1023 1 [PWG5100.11] §7.10Contains a URL that specifies the path to the directory where the initialization file for the PrintService’s PDL interpreter will be found. (Included in PdlInitFile)
PdlInitFileName No String Maxlength=255 1 [PWG5100.11] §7.10Specifies the name of the PDL interpreter’s initialization file within the directory specified by the PdlInitFileLocation element. (Included in PdlInitFile)
PdlOverrideSupported No Keyword Type2 1 [RFC2911] §4.4.28Expresses the ability for a PrintService to override document data instructions with PrintJobTicket. Values: PdlOverrideSupportedWKV, KeywordNsExtensionPattern(e.g., NotAttempted, Attempted, Guaranteed)
PresentationDirectionNumberUp No Keyword Type2 1 [PWG5100.3] §3.17Specifies the placement order of the page images on a Finished-Page Image with the "number-up" element. Values: PresentationDirectionNumberUpWKV , KeywordNsExtensionPattern (e.g., TorightTobottom, TobottomToright, ToleftTotop)
PrintColorMode No keyword Type3 1 [JPS3] §5.2.12Specifies the color mode to use for printing. Values: PrintColorModeWKV, KeywordNsExtensionPattern (e.g., Auto, BiLevel, Color, Monochrome, ProcessBilevel)
PrintContentOptimize No Keyword Type3 1 [PWG5100.7] §4.2.2 [PWG5100.5] §8.1
Directs the type of optimization/processing that will be performed on the Document content. It does not necessarily mean the value describes the content. Values:PrintContentOptimizeWKV, KeywordNsExtensionPattern (e.g., Photo, Text)
PrintRenderingIntent No Keyword Type3 1 [JPS3] §5.2.23
Page 230 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
685686
687
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Element Name Multivalued Syntax Constraint Group ReferenceDescription (values) Specifies how out-of-gamut colors (or shades of gray) are mapped to device colors when printing. Values: PrintRenderingIntentWKV, KeywordNsExtensionPattern (e.g., Absolute, Perceptual, Relative)
ProofPrint No Complex N/A 3 [PWG5100.11] §7.11Specifies the elements for proof prints of the job that are to be printed prior to the printing the full run of the job. (Contains Copies , Media/MediaType or MediaCol and any other Processing elements).
PwgRasterDocumentBackside
No Keyword Type3 5 [RST] §10.1
Specifies the bitmap coordinate system for the backside of duplex sheets. Values: PwgRasterDocumentBacksideWKV, KeywordNsExtensionPattern (e.g., Flipped, ManualTumble)
PwgRasterDocumentResolutionSupported
Yes List of Resolution N/A 5 [RST] §10.2
Lists the supported page bitmap resolutions in dots per inch
PwgRasterDocumentTypeSupported
Yes List of Keywords Type3 5 [RST] §10.3
Lists the supported Color Space and bit depth combinations. Values: ColorEntryWKV, KeywordNsExtensionPattern (e.g., Grayscale16, RGBa32, CMYK64)
Quality No Keyword type2 1 RFC2911] §4.2.13The output quality that the PrintService uses for the Job. Values: PrintQualityWKV, KeywordNsExtensionPattern (e.g., Draft, Normal, High) Note: FaxQualityWKV values are also included in the Quality definition for when this element is used in FaxOutJobTickets.
RegionUnits No Keyword type2 1 [PWG5108.02] §8.1.3.1.15.1.2Element identifies the the units used for specifying the region. Values: RegionUnitsWKV, KeywordNsExtensionPattern (e.g., Micrometers, Pixels) (Contained in ImageBox)
Resolution No Complexresolution
1:MAXN/A
1 RFC2911] §4.2.12[PWG5108.02] §8.1.3.1.16
The resolution in Units for the Feed CrossFeed directions at which an image is captured or an impression is printedthat PrintService uses for the Job in cross-feed and feed direction in units of dpi or dpcm. (Contains Feed, XFeed and Units)
Rotation No Keyword type2 1 [PWG5108.02] §8.1.3.1.17Specifies the amount to rotate each Image of a scanned document specified in degrees clockwise. Values: RegionUnitsWKV, KeywordNsExtensionPattern (e.g., 0, 90, 180, 270)
SaveDisposition No Keyword type3 3 [PWG5100.11] Page 231 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
688689
690
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Element Name Multivalued Syntax Constraint Group ReferenceDescription (values)
§7.9.1.1Specifies whether the PrintService must print and/or save the job. Values: SaveDispositionWKV, KeywordNsExtensionPattern (e.g., None, PrintSave, SaveOnly) (Included in JobSaveDisposition)
SaveDocumentFormat No String MimeMediaType 3 [PWG5100.11] §7.9.1.2.3.3 [rfc2046], [rfc2048]
Indicates the document format in which the PrintService saves the Document Data. (See DocumentFormat Document Description element) (Included in SaveInfo)
SaveInfo Yes complex N/A 3 [PWG5100.11] §7.9.1.2Contains sets of elements that each tells the PrintService how to create each copy of the saved job. (Included in JobSaveDisposition) (Contains SaveLocation, SaveName, SaveDocumentFormat)
SaveLocation No URI Unlimited 3 [PWG5100.11] §7.9.1.2.3.1
Specifies the path to the directory as a URI where the PrintService saves the Document Data and other Job information. (Included in SaveInfo)
SaveName No String Unlimited 3 [PWG5100.11] §7.9.1.2.3.2Specifies the name of the saved job in the directory specified by the “save-location” member element. The value may be a relative path. (Included in SaveInfo)
SeparatorSheets No complex N/A 1 [PWG5100.3] §3.18Specifies the separator sheets to be printed with the Document. (Contains SeparatorSheetsType, Media/MediaType or MediaCol)
SeparatorSheetsType No Keyword Type3 1 [PWG5100.3] §3.18.1Specifies the separator sheets type. Values: SeparatorSheetsTypeWKV, KeywordNsExtensionPattern (e.g., None, SlipSheets, StartSheet, EndSheet, BothSheets) (Included in SeparatorSheets)
Sharpness No Integer -100:100 1 [PWG5108.02] § 8.1.3.1.11.3
Specifies the relative amount to enhance or reduce object edges within an image. Negative values will reduce object edges in the image. (Included in Exposure)
SheetCollate No Keyword Type2 1 [rfc3381] §3.1Specifies if the media sheets of each copy of each printed document in a job are to be in sequence. Values: SheetCollateWKV, KeywordNsExtensionPattern (e.g., Collated)
Sides No Keyword type2 1 [rfc2911] §4.2.8Indicates how an impression is to be placed upon the side(s) of the media. Values: SidesWKV, KeywordNsExtensionPattern (e.g., OneSided, TwoSidedShortEdge)
Page 232 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
691692
693
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Element Name Multivalued Syntax Constraint Group ReferenceDescription (values)
Stitching No complex N/A 1 [PWG5100.3] §3.2.2Provides detailed stitching parameters. (Included in FinishingsCol, JobFinishingsCol) (Contains StitchingReferenceEdge, StitchingOffset, StitchingLocations)
StitchingLocations Yes Integer 0:MAX D [PWG5100.3] §3.2.2.3The distance along the stitching axis where a stitch will be placed in hundredths of a millimeter. (Included in Stitching)
StitchingOffset No Integer 0:MAX 1 [PWG5100.3] §3.2.2.2The perpendicular distance from the reference edge to the stitching axis in hundredths of a millimeter. (Included in Stitching)
StitchingReferenceEdge
No Keyword type2 1 [PWG5100.3] §3.2.2.1
Specifies edge of the output media from which the stitching offset is measured. Values: StitchingReferenceEdgeWKV, KeywordNsExtensionPattern (e.g., Bottom, Top, Left, Right) (Included in Stitching)
TemplateCreatorUserName No String Unlimited 2 [PWG5108.32] §8.1.3.2.12Used only when Ticket is created from a template. This is the most authenticated user name of the template creator
TemplateId No URI Unlimited 2 [PWG5108.32] §8.1.3.2.13Used only when Ticket is created from a template. This is the ID of the template used to create the Job Ticket.
TemplateInfo No String Maxlength=2047 2 [PWG5108.32] §8.1.3.2.14Used only when Ticket is created from a template. Information about the template used to create the Job Ticket.
TemplateName No String Unlimited 2 [PWG5108.32] §8.1.3.2.15Used only when Ticket is created from a template. Name of template used to create the Job Ticket.
TemplateType No Keyword Type3Type2
2 [PWG5108.32] §8.1.3.2.16
Used only when Ticket is created from a template. Type of the template used to create the Job Ticket (i.e., PrintJob). . Values: TemplateTypeWKV, KeywordNsExtensionPattern (e.g., None, Center)
Page 233 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
694695
696
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Element Name Multivalued Syntax Constraint Group ReferenceDescription (values)
Units No Keyword Type2 1 RFC2911] §4.2.12 [PWG5108.3] § 8.1.3.1.16.3
This specifies the units used to express the resolution. Values: UnitsWKV, KeywordNsExtensionPattern (e.g., Dpcm, Dpi)
Width No Integer MIN:MAX 1 [PWG5108.02] §8.1.3.1.15.1.3Element identifies the width of the image box in RegionUnits. (Contained in ImageBox)
XDimension No Integer 0:MAX 1,3 [PWG5100.3] §3.13.8.1Size of the media in hundredths of a millimeter along the bottom edge. (Included in MediaSize)
XImagePosition No Keyword type2 1 [PWG5100.3] §3.19.2Causes the specified point of the Finished-Page Image to be positioned at a specified location. Values: XImagePositionWKV, KeywordNsExtensionPattern (e.g., None, Center)
XImageShift No Integer MIN:MAX 1 [PWG5100.3] §3.19.3Causes the Finished-Page Image to be shifted in position with respect to the x-axis of the media in hundredths of a millimeter. The values’s sign indicates the direction of the shift.
XOffset No Integer MIN:MAX 1 [PWG5108.02] §8.1.3.1.15.1.4Element identifies the offset, positive or negative, on the X axis from the origin of the MediaBox in RegionUnits. (Contained in ImageBox)
Xside1ImageShift No Integer MIN:MAX 1 [PWG5100.3] §3.19.4Causes each Finished-Page Image that would be placed on the front side of a sheet to be shifted in position with respect to the x-axis of the media in hundredths of a millimeter. The value’s sign indicates the direction of the shift.
Xside2ImageShift No Integer MIN:MAX 1 [PWG5100.3] §3.19.5Causes each Finished-Page Image that would be placed on the backside of a sheet to be shifted in position with respect to the x-axis of the media in hundredths of a millimeter. The value’s sign indicates the direction of the shift.
YDimension No Integer 0:MAX 1,3 [PWG5100.3] §3.13.8.2Size of the media in hundredths of a millimeter along the left edge. (Included in MediaSize)
YImagePosition No Keyword type2 1 [PWG5100.3] §3.19.6Causes the specified point of the Finished-Page Image to be positioned at a specified location. Values: YImagePositionWKV, KeywordNsExtensionPattern (e.g., None, Center)
YImageShift No Integer MIN:MAX 1 [PWG5100.3] §3.19.7
Page 234 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
697698
699
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Element Name Multivalued Syntax Constraint Group ReferenceDescription (values) Causes the Finished-Page Image to be shifted in position with respect to the y-axis of the media in hundredths of a millimeter. The value’s sign indicates the direction of the shift.
YOffset No Integer MIN:MAX 1 [PWG5108.02] §8.1.3.1.15.1.5Element identifies the offset, positive or negative, on the Y axis from the origin of the MediaBox in RegionUnits. (Contained in ImageBox)
Yside1ImageShift No Integer MIN:MAX 1 [PWG5100.3] §3.19.8Causes each Finished-Page Image that would be placed on the front side of a sheet to be shifted in position with respect to the y-axis of the media in hundredths of a millimeter. The Value’s sign indicates the direction of the shift.
Yside2ImageShift No Integer MIN:MAX 1 [PWG5100.3] §3.19.9Causes each Finished-Page Image that would be placed on the backside of a sheet to be shifted in position with respect to the y-axis of the media in hundredths of a millimeter. The value’s sign indicates the direction of the shift.
20. Appendix B: Service Capabilities<service>ServiceCapabilities are closely related to the <service>JobTicket. The <service>ServiceCapabilities have the same structure and element names as the corresponding <service>JobTicket elements. The <service>ServiceCapabilities elements differ in syntax. The purpose of <service>ServiceCapabilities is to provide information on what <service>JobTicket elements are supported and what values those elements can have.
For example if a <service>JobTicket element can contain a keyword (e.g. DocumentFormat), then the presence of the corresponding <service>ServiceCapabilities element indicate that the <service>JobTicket element is supported. The <service>ServiceCapabilities element’s syntax is a list of keywords that supplies the allowed values for the <service>JobTicket element.
In a similar fashion a <service>JobTicket element that has a datatype of integer has a <service>ServiceCapabilities element with syntax of a range of integers specifying the range of allowed values for the <service>JobTicket element.
Some <service>JobTicket elements only require the <service>ServiceCapabilities to specify that the element is supported. For these instances the <service>ServiceCapabilities element uses the Boolean type.
It should be noted that the the MediaCol element can be quite large for high end systems (e.g., Production PrintServices). The syntax for the MediaCol capabilities element is a list of MediaCol. There are a number of elements in the MediaCol datatype and a large number of combinations are possible. An implementation of a registration process must accommodate this potentially large amount of data.
Table 82 summarizes the semantics of the <service>ServiceCapabilities syntax and specifies which <service>ServiceCapabilities element uses the syntax.
Page 235 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
700701
3321
33223323332433253326
3327332833293330
333133323333
33343335
3336333733383339
33403341
702
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Table 82 <service>ServiceCapabilities Syntax
Capabilities Syntax
Semantics Capabilities Element
Boolean Specifies the JobTicket element is supported
DocumentDigitalSignatureSupplied , DocumentSourceApplicationName , DocumentSourceApplicationVersion , DocumentSourceOsVersion , DocumentFormatDeviceId , DocumentFormatVersion , DocumentMessageSupplied , DocumentNameSupplied , FinishingTemplate, Impressions , JobAccountingID , JobAccountingUserID , JobMandatoryElements , JobMessageFromOperator , JobMessageToOperator , JobMoreInfo , JobName , JobOriginatingUserName , JobOriginatingUserUri , JobSheetMessage, KOctets , MediaCol, MediaSheets , Overrides, PageRanges, PagesPerSubset, SaveName, TemplateCreatorUserName, TemplateId, TemplateInfo, TemplateName
Integer Specifies the supported string length for the JobTicket element
JobPassword
List of Keywords Specifies the valid list of keywords for the JobTicket element
CompressionSupplied , CoverType, DocumentCharsetSupplied , DocumentFormatDetailsSupplied , DocumentFormatSupplied , DocumentSourceOsName , DocumentFormat , DocumentFormatSupplied , DocumentFormatVersionSupplied , DocumentNaturalLanguage , ElementsNaturalLanguage , FeedOrientation, Finishings, FontNameRequested, ImpositionTemplate, JobAccountingSheetsType, JobAccountingOutputBin, JobErrorSheetType, JobErrorSheetWhen, JobPasswordEncryption , JobSheets, Media, MediaInputTrayCheck, MediaSource, MediaType, MultipleDocumentsHandling, OrientationRequested, OutputBin, OutputDevice, PageDelivery, PageOrderReceived , PdlInitFileLocation, PdlInitFileName, PdlInitFileEntry, PresentationDirectionNumberUp, PrintColorMode , PrintContentOptimize, PrintRenderingIntent , Quality, SaveDisposition, SaveDocumentFormat, SeparatorSheetsType , SheetCollate, Sides , StitchingReferenceEdge, TemplateType , XImagePosition, YImagePosition
List of Integers Specifies the valid list of integers for the JobTicket element
NumberUp
List of MediaCol This element is associated with the MediaCol
MediaColSupported
Page 236 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
703704
3342
705
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Capabilities Syntax
Semantics Capabilities Element
PrintDocumentProcessing element. This element is referred to as the MediaCol database. It is a list of all the instances of MediaCol supported by the PrintService. Note that this element must be explicitly requested and is not returned with the other PrintDocumentProcessing elements.
(Note for MediaCol in element groups such as InsertSheet, the MediaCol capabilities element with a syntax of Boolean is used)
List of Resolutions
Specifies the allowed resolution tuples for the JobTicket element
Resolution
List of URI schemes
Specifies the allowed URI schemes for the JobTicket element
SaveLocation, Destination
Range of Integers
Specifies the lower and upper bounds for the JobTicket element
Copies, FontSizeRequestedSupported, ForceFrontSide, InsertAfterPage, InsertCount, JobCopies, StitchingLocation, StitchingOffset, XImageShift, XSide1ImageShift, XSide2ImageShift, YImageShift, YSide1ImageShift, YSide2ImageShift
21. Appendix C: Keyword Well-Known ValuesError: Reference source not found shows some of the well-known keywords from the PWG Semantic Model [PWG5108.1] and associated schema. The authoritative registry for the keywords defined in the Internet Printing Protocol is hosted by IANA [IPPREG]. IANA is also the source for other keywords such and character sets <http://www.iana.org/assignments/character-sets> and operating system names <http://www.iana.org/assignments/operating-system-names/operating-system-names.xml>. Where applicable the last value(s) enclosed in brackets indicate the name of the extension pattern used to extend the values.
Keyword Well Known Values
CharsetWKV adobe-standard-encoding, adobe-symbol-encoding, ansi-x3-110-1983, asmo-449, big5, big5-hkscs, bocu-1, bs-4730, bs-viewdata, cesu-8, csa-z243-4-1985-1, csa-z243-4-1985-2, csa-z243-4-1985-gr, csn-369103, dec-mcs, din-66003, dk-us, ds-2089, ebcdic-at-de, ebcdic-at-de-a, ebcdic-ca-fr, ebcdic-dk-no, ebcdic-dk-no-a, ebcdic-es, ebcdic-es-a, ebcdic-es-s, ebcdic-fi-se, ebcdic-fi-se-a, ebcdic-fr, ebcdic-it, ebcdic-pt, ebcdic-uk, ebcdic-us, ecma-cyrillic, es, es2, euc-jp, euc-kr, extended-unix-code-fixed-width-for-japanese, gb18030, gb-1988-80, gb2312, gb-2312-80, gbk, gost-19768-74, greek7, greek7-old, greek-ccitt, hp-desktop, hp-legal, hp-math8, hp-pi-font, hp-roman8, hz-gb-2312, ibm00858, ibm00924, ibm01140, ibm01141, ibm01142, ibm01143, ibm01144, ibm01145, ibm01146, ibm01147, ibm01148, ibm01149, ibm037, ibm038, ibm1026, ibm1047, ibm273, ibm274, ibm275, ibm277, ibm278, ibm280, ibm281, ibm284, ibm285, ibm290, ibm297, ibm420, ibm423, ibm424, ibm437, ibm500, ibm775, ibm850, ibm851, ibm852, ibm855, ibm857, ibm860, ibm861, ibm862, ibm863, ibm864, ibm865, ibm866, ibm868, ibm869, ibm870, ibm871, ibm880, ibm891, ibm903, ibm904, ibm905, ibm918, ibm-symbols, ibm-thai,
Page 237 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
706707
3343
3344334533463347334833493350
708
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Keyword Well Known Values
iec-p27-1, inis, inis-8, inis-cyrillic, invariant, iso-10367-box, iso-10646-ucs-2, iso-10646-ucs-4, iso-10646-ucs-basic, iso-10646-unicode-latin1, iso-10646-utf-1, iso-2022-cn, iso-2022-cn-ext, iso-2022-jp, iso-2022-jp-2, iso-2022-kr, iso-2033-1983, iso-5427, iso-5427-1981, iso-5428-1980, iso-646-basic-1983, iso-646-irv-1983, iso-6937-2-25, iso-6937-2-add, iso-8859-1, iso-8859-10, iso-8859-13, iso-8859-14, iso-8859-15, iso-8859-16, iso-8859-1-windows-3-0-latin-1, iso-8859-1-windows-3-1-latin-1, iso-8859-2, iso-8859-2-windows-latin-2, iso-8859-3, iso-8859-4, iso-8859-5, iso-8859-6, iso-8859-6-e, iso-8859-6-i, iso-8859-7, iso-8859-8, iso-8859-8-e, iso-8859-8-i, iso-8859-9, iso-8859-9-windows-latin-5, iso-8859-supp, iso-ir-90, iso-unicode-ibm-1261, iso-unicode-ibm-1264, iso-unicode-ibm-1265, iso-unicode-ibm-1268, iso-unicode-ibm-1276, it, jis-c6220-1969-jp, jis-c6220-1969-ro, jis-c6226-1978, jis-c6226-1983, jis-c6229-1984-a, jis-c6229-1984-b, jis-c6229-1984-b-add, jis-c6229-1984-hand, jis-c6229-1984-hand-add, jis-c6229-1984-kana, jis-encoding, jis-x0201, jis-x0212-1990, jus-i-b1-002, jus-i-b1-003-mac, jus-i-b1-003-serb, koi8-r, koi8-u, ks-c-5601-1987, ksc5636, latin-greek, latin-greek-1, latin-lap, macintosh, microsoft-publishing, mnem, mnemonic, msz-7795-3, nats-dano, nats-dano-add, nats-sefi, nats-sefi-add, nc-nc00-10-81, nf-z-62-010, nf-z-62-010--1973-, ns-4551-1, ns-4551-2, pc8-danish-norwegian, pc8-turkish, pt, pt2, ptcp154, scsu, sen-850200-b, sen-850200-c, shift-jis, t-101-g2, t-61-7bit, t-61-8bit, tis-620, unicode-1-1, unicode-1-1-utf-7, unknown-8bit, us-ascii, us-dk, utf-16, utf-16be, utf-16le, utf-32, utf-32be, utf-32le, utf-7, utf-8, ventura-international, ventura-math, ventura-us, videotex-suppl, viqr, viscii, windows-1250, windows-1251, windows-1252, windows-1253, windows-1254, windows-1255, windows-1256, windows-1257, windows-1258, windows-31j, [StringNsExtensionPattern]
ColorEntryWKV BlackAndWhite1, Grayscale4, Grayscale8, Grayscale16, RGB24, RGB48, RGBa32, RGBa64, CMYK32, [KeywordNsExtensionPattern]
CompressionWKV Compress, Deflate, Gzip, ModifiedHuffman, ModifiedRead, MatsushitaWhitelineSkip, None, [KeywordNsExtensionPattern]
ContentTypeWKV Auto, Text, Photo, TextAndPhoto, LineArt, Magazine, Halftone, [KeywordNsExtensionPattern]
CoverTypeWKV NoCover, PrintBack, PrintBoth, PrintFront, PrintNone, [KeywordNsExtensionPattern]
DocumentDigitalSignatureWKV
Dss, None, Pgp, Smime, Xdsig, [KeywordNsExtensionPattern]
DocumentFormatWKV
application/octet-stream, application/pdf, application/postscript, application/vnd.pwg-xhtml-print+xml, application/vnd.hp-PCL, image/g3fax, image/jpeg, image/tiff, image/tiff-fx, text/html, text/plain, text/plain; charset=ISO-8859-1, text/plain; charset=US-ASCII, text/plain; charset=utf-8, unknown, [MimeExtensionPattern]
FeedOrientationWKV LongEdgeFirst, ShortEdgeFirst, [KeywordNsExtensionPattern]FilmScanModeWKV NotApplicable, ColorSlideFilm, ColorNegativeFilm,
BlackandWhiteNegativeFilm, [KeywordNsExtensionPattern]FinishingsWKV Bale, Bind, BindBottom, BindLeft, BindRight, BindTop, BookletMaker,
Cover, EdgeStitch, EdgeStitchBottom, EdgeStitchLeft, EdgeStichRight, EdgeStitchTop, Fold, JogOffset, None, Punch, SaddleStitch, Staple, StapleBottomLeft, StapleBottomRight, StapleDualBottom, StapleDualLeft,
Page 238 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
709710
711
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Keyword Well Known Values
StapleDualRight, StapleDualTop, StapleTopLeft, StapleTopRight, Trim, TrimAfterCopies, TrimAfterDocuments, TrimAfterJob, TrimAfterPages, [KeywordNsExtensionPattern]
HoldUntilWKV DayTime, Evening, Indefinite, Night, NoHold, SecondShift, ThirdShift, Weekend, [KeywordNsExtensionPattern]
IdentifyActionWKV Display, Flash, Print, Sound, Speak, [KeywordNsExtensionPattern]ImpositionWKV None, Signature, [KeywordNsExtensionPattern]InputSourceWKV ADF, Platen, FilmReader, [KeywordNsExtensionPattern]JobAccountingSheetTypeWKV
None, Standard, [KeywordNsExtensionPattern]
JobErrorSheetTypeWKV
None, Standard, [KeywordNsExtensionPattern]
JobErrorSheetWhenWKV
Always, OnError, [KeywordNsExtensionPattern]
JobPasswordEncryptionWKV
AES, ECC, Md2, Md4, Md5, None, Sha, TripleDES, [KeywordNsExtensionPattern]
JobSheetsWKV BothSheets, EndSheet, FirstPrintStreamPage, None, Standard, StartSheet, [KeywordNsExtensionPattern]
MediaCoatingWKV none, glossy, high-gloss, semi-gloss, satin, matte, [MediaNsExtensionPattern]
MediaColorWKV no-color, white, pink, yellow, blue, green, buff, goldenrod, red, gray, ivory, orange, [MediaColorExtensionPattern]
MediaGrainWKV x-direction, y-direction, [MediaNsExtensionPattern]MediaInputTrayWKV top, middle, bottom, side, large-capacity, envelope, main, manual,
[MediaNsExtensionPattern]MediaPreprintedWKV
blank, preprinted, letterhead, [MediaNsExtensionPattern]
MediaRecycledWKV none, standard, [MediaNsExtensionPattern]MediaSourceWKV Alternate, AlternateRoll, Auto, Bottom, Center, Disc, Envelope, Hagaki,
LargeCapacity, Left, Main, MainRoll, Manual, Middle, Photo, Rear, Right, Side, Top, Tray1, Tray2, Tray3, Tray4, Tray5, Tray6, [MediaNsExtensionPattern]
MediaToothWKV coarse, fine, medium, [MediaNsExtensionPattern]MediaTypeWKV back-print-film, cardstock, continuous, continuous-long, continuous-short,
envelope, envelope-plain, envelope-window, full-cut-tabs, labels, pre-cut-tabs, multi-layer, multi-part-forms, photographic, photographic-film, photographic-glossy, photographic-high-gloss, photographic-matte, photographic-satin, photographic-semi-gloss, roll, screen, screen-paged, stationery, stationery-coated, stationery-fine, stationery-heavyweight, stationery-inkjet, stationery-letterhead, stationery-lightweight, stationery-preprinted, stationery-prepunched, tab-stock, transparency, other, [MediaTypeExtensionPattern]
MediaWKV asme_f_28x40in, iso_2a0_1189x1682mm, iso_a0_841x1189mm, iso_a0x3_1189x2523mm, iso_a1_594x841mm, iso_a10_26x37mm, iso_a1x3_841x1783mm, iso_a1x4_841x2378mm, iso_a2_420x594mm,
Page 239 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
712713
714
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Keyword Well Known Values
iso_a2x3_594x1261mm, iso_a2x4_594x1682mm, iso_a2x5_594x2102mm, iso_a3_297x420mm, iso_a3-extra_322x445mm, iso_a3x3_420x891mm, iso_a3x4_420x1189mm, iso_a3x5_420x1486mm, iso_a3x6_420x1783mm, iso_a3x7_420x2080mm, iso_a4_210x297mm, iso_a4-extra_235.5x322.3mm, iso_a4-tab_225x297mm, iso_a4x3_297x630mm, iso_a4x4_297x841mm, iso_a4x5_297x1051mm, iso_a4x6_297x1261mm, iso_a4x7_297x1471mm, iso_a4x8_297x1682mm, iso_a4x9_297x1892mm, iso_a5_148x210mm, iso_a5-extra_174x235mm, iso_a6_105x148mm, iso_a7_74x105mm, iso_a8_52x74mm, iso_a9_37x52mm, iso_b0_1000x1414mm, iso_b1_707x1000mm, iso_b10_31x44mm, iso_b2_500x707mm, iso_b3_353x500mm, iso_b4_250x353mm, iso_b5_176x250mm, iso_b5-extra_201x276mm, iso_b6_125x176mm, iso_b6c4_125x324mm, iso_b7_88x125mm, iso_b8_62x88mm, iso_b9_44x62mm, iso_c0_917x1297mm, iso_c1_648x917mm, iso_c10_28x40mm, iso_c2_458x648mm, iso_c3_324x458mm, iso_c4_229x324mm, iso_c5_162x229mm, iso_c6_114x162mm, iso_c6c5_114x229mm, iso_c7_81x114mm, iso_c7c6_81x162mm, iso_c8_57x81mm, iso_c9_40x57mm, iso_dl_110x220mm, iso_ra0_860x1220mm, iso_ra1_610x860mm, iso_ra2_430x610mm, iso_sra0_900x1280mm, iso_sra1_640x900mm, iso_sra2_450x640mm, jis_b0_1030x1456mm, jis_b1_728x1030mm, jis_b10_32x45mm, jis_b2_515x728mm, jis_b3_364x515mm, jis_b4_257x364mm, jis_b5_182x257mm, jis_b6_128x182mm, jis_b7_91x128mm, jis_b8_64x91mm, jis_b9_45x64mm, jis_exec_216x330mm, jpn_chou2_111.1x146mm, jpn_chou3_120x235mm, jpn_chou4_90x205mm, jpn_hagaki_100x148mm, jpn_kahu_240x322.1mm, jpn_kaku2_240x332mm, jpn_oufuku_148x200mm, jpn_you4_105x235mm, na_10x11_10x11in, na_10x13_10x13in, na_10x14_10x14in, na_10x15_10x15in, na_10x15_10x15in, na_11x12_11x12in, na_11x15_11x15in, na_12x19_12x19in, na_5x7_5x7in, na_6x9_6x9in, na_7x9_7x9in, na_9x11_9x11in, na_a2_4.375x5.75in, na_arch-a_9x12in, na_arch-b_12x18in, na_arch-c_18x24in, na_arch-d_24x36in, na_arch-e_36x48in, na_b-plus_12x19.17in, na_c_17x22in, na_c5_6.5x9.5in, na_d_22x34in, na_e_34x44in, na_edp_11x14in, na_eur-edp_12x14in, na_executive_7.25x10.5in, na_f_44x68in, na_fanfold-eur_8.5x12in, na_fanfold-us_11x14.875in, na_foolscap_8.5x13in, na_govt-legal_8x13in, na_govt-letter_8x10in, na_index-3x5_3x5in, na_index-4x6_4x6in, na_index-4x6-ext_6x8in, na_index-5x8_5x8in, na_invoice_5.5x8.5in, na_ledger_11x17in, na_legal_8.5x14in, na_legal-extra_9.5x15in, na_letter_8.5x11in, na_letter-extra_9.5x12in, na_letter-plus_8.5x12.69in, na_monarch_3.875x7.5in, na_number-10_4.125x9.5in, na_number-11_4.5x10.375in, na_number-12_4.75x11in, na_number-14_5x11.5in, na_number-9_3.875x8.875in, na_personal_3.625x6.5in, na_quarto_8.5x10.83in, na_super-a_8.94x14in, na_super-b_13x19in, na_wide-format_30x42in, om_dai-pa-kai_275x395mm, om_folio_210x330mm, om_folio-sp_215x315mm, om_invite_220x220mm, om_italian_110x230mm, om_juuro-ku-kai_198x275mm, om_large-photo_200x300mm, om_pa-kai_267x389mm, om_postfix_114x229mm, om_small-photo_100x150mm, prc_1_102x165mm, prc_10_324x458mm, prc_16k_146x215mm, prc_2_102x176mm, prc_3_125x176mm, prc_32k_97x151mm, prc_4_110x208mm, prc_5_110x220mm, prc_6_120x320mm, prc_7_160x230mm, prc_8_120x309mm, pwg_letter-or-a4_choice, roc_16k_7.75x10.75in, roc_8k_10.75x15.5in, a0x2, a0x3,
Page 240 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
715716
717
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Keyword Well Known Values
a1x3, a1x4, a2x3, a2x4, a2x5, a3x3, a3x4, a3x5, a3x6, a3x7, a4x3, a4x4, a4x5, a4x6, a4x7, a4x8, a4x9, arch-a, arch-b, arch-c, arch-d, arch-e, c, d, e, executive, f, folio, invoice, iso-a0, iso-a1, iso-a10, iso-a1x3, iso-a1x4, iso-a2, iso-a2x3, iso-a2x4, iso-a2x5, iso-a3, iso-a3-extra, iso-a3x3, iso-a3x4, iso-a3x5, iso-a3x6, iso-a3x7, iso-a4, iso-a4x3, iso-a4x4, iso-a4x5, iso-a4x6, iso-a4x7, iso-a4x8, iso-a4x9, iso-a5, iso-a6, iso-a7, iso-a8, iso-a9, iso-b0, iso-b1, iso-b10, iso-b2, iso-b3, iso-b4, iso-b5, iso-b6, iso-b7, iso-b8, iso-b9, iso-c0, iso-c1, iso-c2, iso-c3, iso-c4, iso-c5, iso-c6, iso-c7, iso-c8, iso-designated, iso-ra0, iso-ra1, iso-ra2, iso-sra0, iso-sra1, iso-sra2, jis-b0, jis-b1, jis-b10, jis-b2, jis-b3, jis-b4, jis-b5, jis-b6, jis-b7, jis-b8, jis-b9, monarch-envelope, na-10x13-envelope, na-10x14-envelope, na-10x15-envelope, na-10x15-envelope, na-6x9-envelope, na-7x9-envelope, na-8x10, na-9x11-envelope, na-legal, na-letter, na-number-10-envelope, na-number-9-envelope, quarto, tabloid, 10x11, 10x13, 10x14, 10x15, 11x12, 11x15, 12x19, 2a0, 5x7, 6x9, 7x9, 9x11, a, a0, a1, a10, a2, a3, a4, a4-extra, a4-tab, a5, a5-extra, a6, a7, a8, a9, architecture-a, architecture-b, architecture-c, architecture-d, architecture-e, architecture-f, b, b0, b1, b10, b2, b3, b4, b5, b5-extra, b6, b6/c4, b7, b8, b9, b-plus, c0, c1, c10, c2, c3, c4, c5, c6, c6/c5, c7, c7/c6, c8, c9, chou2, chou3, chou4, comm-10, dai-pa-kai, designated-long, dl, e1, edp, engineering-a, engineering-b, engineering-c, engineering-d, engineering-e, engineering-f, european-edp, exec, f, fanfold-European, fanfold-us, folio-sp, foolscap, german-legal-fanfold, government-legal, government-letter, hagaki, half-letter, index-3x5, index-4x6, index-4x6-ext, index-5x8, Invite, Italian, juuro-ku-kai, kahu, kaku2, large-photo, ledger, legal, legal-extra, letter, letter-extra, letter-plus, letter-tab, mini, number-11, number-12, number-14, oufuku, pa-kai, personal, Postfix, prc1, prc10, prc-16k, prc2, prc3, prc-32k, prc4, prc5, prc6, prc7, prc8, roc-16k, roc-8k, small-photo, statement, super-a, super-b, tabloid-extra, wide-format, you4, bottom, by-pass-tray, large-capacity, main, manual, middle, top, side, tray-1, tray-2, tray-3, tray-4, tray-5, tray-6, tray-7, tray-8, tray-9, tray-10, [MediaSizeNameExtensionPattern]
MultipleDocumentsHandlingWKV
SeparateDocumentsCollatedCopies, SeparateDocumentsUncollatedCopies, SingleDocument, SingleDocumentNewSheet, [KeywordNsExtensionPattern]
MultipleOperationTimeoutActionWKV
Abort, Hold, Process, [KeywordNsExtensionPattern]
NaturalLanguageWKV
ar, de, en, en-us, es, fr, hi, it, ja, pt, zh, [NatLangExtensionPattern]
OperatingSystemNameWKV
aegis, amiga-os-1.2, amiga-os-1.3, amiga-os-2.0, amiga-os-2.1, amiga-os-3.0, amiga-os-3.1, amiga-os-3.5, amiga-os-3.9 , apollo, aix/370, aix-ps/2, beos-4.5.2, beos-5.0, bs-2000, cedar, cgw, chorus, chrysalis, cmos, cms, cos, cpix, ctos, ctss, dcn, ddnos, domain, dos, edx, elf, embos, emmos, epos, foonex, freebsd, forth, fuzz, gcos, gpos, hdos, imagen, instant-internet, intercom, impress, interlisp, ios, irix, isi-68020, its, kosos, linux, linux-1.0, linux-1.2, linux-2.0, linux-2.2, linux-2.4, lisp, lispm, locus, macos, minos, mos, mpe5, mpe/v, mpe/ix, msdos, multics, music, music/sp, mvs, mvs/sp, netbsd-1.0, netbsd-1.1, netbsd-1.2, netbsd-1.3, netware-3, netware-3.11, netware-4.0, netware-4.1, netware-5.0, nexus, nms, nonstop, nos-2, ntos, openbsd, openvms, os/ddp, os/2, os4, os86, osx, pcdos, perq/os, pli, psdos/mit, psos, primos, risc-os, risc-os-3.10, risc-os-3.50, risc-os-3.60, risc-os-3.70, risc-os-4.00, rmx/rdos, ros, rsx11m, rte-a, satops,
Page 241 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
718719
720
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Keyword Well Known Values
sinix, sco-open-desktop-1.0, sco-open-desktop-1.1, sco-open-desktop-2.0, sco-open-desktop-3.0, sco-open-desktop-lite-3.0, sco-open-server-3.0, sco-unix-3.2.0, sco-unix-3.2v2.0, sco-unix-3.2v2.1, sco-unix-3.2v4.0, sco-unix-3.2v4.1, sco-unix-3.2v4.2, sco-xenix-386-2.3.2, sco-xenix-386-2.3.3, sco-xenix-386-2.3.4, scs, simp, sun, sun-os-3.5, sun-os-4.0, swift, tac, tandem, tenex, the-major-bbs, tops10, tops20, tos, tp3010, trsdos, ultrix, unix, unix-bsd, unix-v1at, unix-v, unix-v.1, unix-v.2, unix-v.3, unix-pc, unknown, ut2d, v, vm, vm/370, vm/cms, vm/sp, vms, vms/eunice, vrtx, waits, wang, win32, windows-95, windows-95-osr1, windows-95-osr2, windows-98, windows-ce, windows-nt, windows-nt-2, windows-nt-3, windows-nt-3.5, windows-nt-3.51, windows-nt-4, windows-nt-5, worldgroup, wyse-wyxware, x11r3, xde, xenix, [OperatingSystemNameExtensionPattern]
OrientationRequestedWKV
Landscape, Portrait, ReverseLandscape, ReversePortrait, [KeywordNsExtensionPattern]
OutputBinWKV Bottom, Center, Face-down, Face-up, Large-capacity, Left, Middle, My-mailbox, Rear, Right, Side, Top, [KeywordNsExtensionPattern]
OutputChannelWKV Other, Unknown, SerialPort, ParallelPort, IEEE1284Port, SCSIPort, FTP, TFTP, IEEE1394, DCERemoteProcCall, ONCRemoteProcCall, OLE, NamedPipe, ServerMessageBlock, DLLAPI, VxDAPI, SystemObjectManager, DECLAT, USB, IRDA, PortTCP, BidirPortTCP, PortHTTP,, [KeywordNsExtensionPattern]
PageDeliveryWKV ReverseOrderFaceDown, ReverseOrderFaceUp, SameOrderFaceDown, SameOrderFaceUp, SystemSpecified, [KeywordNsExtensionPattern]
PageOrderReceivedWKV
1ToNOrder, NTo1Order, [KeywordNsExtensionPattern]
PdlOverrideSupportedWKV
Attempted, Guaranteed, NotAttempted, [KeywordNsExtensionPattern]
PresentationDirectionNumberUpWKV
TobottomToleft, TobottomToright, ToleftTobottom, ToleftTotop, TorightTobottom, TorightTotop, TotopToleft, TotopToright, [KeywordNsExtensionPattern]
PrintColorModeWKV Auto, BiLevel, Color, Highlight, Monochrome, ProcessBiLevel, ProcessMonochrome, [KeywordNsExtensionPattern]
PrintContentOptimizeWKV
Graphics, Photo, Text, TextAndGraphics, [KeywordNsExtensionPattern]
PrintQualityWKV Draft, High, Normal, [KeywordNsExtensionPattern]PrintRenderingIntentWKV
Absolute, Perceptual, Relative, Saturation, [KeywordNsExtensionPattern]
PwgRasterDocumentBacksideWKV
Flipped, ManualTumble, Normal, Rotated, [KeywordNsExtensionPattern]
RegionUnitWKV Absolute, Perceptual, Relative, Saturation, [KeywordNsExtensionPattern]SaveDispositionWKV None, PrintSave, SaveOnly, [KeywordNsExtensionPattern]SeparatorSheetsTypeWKV
BothSheets, EndSheet, None, SlipSheets, StartSheet, [KeywordNsExtensionPattern]
SheetCollateWKV Collated, Uncollated, [KeywordNsExtensionPattern]SidesWKV OneSided, TwoSidedLongEdge, TwoSidedShortEdge,
Page 242 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
721722
723
Working Draft – PWG Semantic Model v2.0 May 9, 2023
Keyword Well Known Values
[KeywordNsExtensionPattern]StitchingReferenceEdgeWKV
Bottom, Left, Right, Top, [KeywordNsExtensionPattern]
TemplateTypeWKV
CopyDocument, CopyJob, EmailInDocument, EmailInJob, EmailOutDocument, EmailOutJob, FaxInDocument, FaxInJob, FaxOutDocument, FaxOutJob, NetFaxInDocument, NetFaxInJob, NetFaxOutDocument, NetFaxOutJob, PrintDocument, PrintJob, ScanDocument, ScanJob, TransformDocument, TransformJob, Vendor, [KeywordNsExtensionPattern]
UnitsWKV Dpcm. Dpi, [KeywordNsExtensionPattern]XImagePositionWKV
Center, Left, None, Right, [KeywordNsExtensionPattern]
YImagePositionWKV
Bottom, Center, None, Top, [KeywordNsExtensionPattern]
[22.] Appendix CD: Keyword Value extension patternsTable 83 shows the extension patterns for PWG keyword elements. The regular expression syntax is specified in appendix F of the XML Schema Part 2: Datatypes Second Edition specification [XMLDAT]. The link to the appendix that covers regular expressions is <http://www.w3.org/TR/xmlschema-2/#dt-regex>
Table 83 Keyword Value extension patterns
Pattern Name Regular ExpressionKeywordNsExtensionPattern \w+:[\w_\-\.]+MediaColorExtensionPattern custom-media-color-[a-z][a-z0-9\-]*MediaNsExtensionPattern \w+:[\w:/;_\-\.]+MediaSizeNameExtensionPattern (custom_max|custom_min|custom|
na|asme|roc|oe)_[\p{Ll}\d][\p{Ll}\d\-]*_\d+(\.\d+)?x\d+(\.\d+)?in
(custom_max|custom_min|custom|na|asme|roc|oe)_[\p{Ll}\d][\p{Ll}\d\-]*_\d+(\.\d+)?x\d+(\.\d+)?mm
MediaTypeExtensionPattern custom-media-type-[a-z][a-z0-9\-]*MimeExtensionPattern \w+[\w:/;_\-\\\+\.]*NatLangExtensionPattern \w+[\w:/;_\-\\\+\.]*
Page 243 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
724725
3351
3352
335333543355
3356
726
Working Draft – PWG Semantic Model v2.0 May 9, 2023
OperatingSystemNameExtensionPattern
[A-Z/\.\-]+
StringExtensionPattern \w+[\w:/;_\-\\\+\.]*StringNsExtensionPattern \w+:[\w:/;_\-\\\+\.]*
22.[23.] Appendix D – IPP Mapping
22.1 Changes to remove some IPP specific aspectsThis section lists some changes to remove some IPP specific aspects from the PWG Semantic Model.
1. IPP enumerations use their well-known string name instead of the integer enumeration. This applies not only to IPP attributes but also to IPP Operations.
2. Any IPP attribute name containing “ipp” has had the “ipp” removed.
3. All IPP attribute and operation keywords have the substring “attribute” replaced with “element”.
4. All IPP operation, status codes, attribute, and attribute value keyword names have had the first letter capitalized and the ‘-‘ character removed and the character following the ‘-‘ has been capitalized. (All mixed case PWG Semantic Model keywords can be interpreted without regard to case.)
5. Certain elements prefixed with”Job” that apply to either Jobs or Documents has had the “Job” prefix removed. (This mapping clarified by the value in the “Group” cell of the PWG SMv2 Element Summary table in appendix A)
6. The IPP attribute value keywords defined in other registries remain unchanged. Note that the PWG defined media keyword values for the Semantic Elements MediaType, MediaColor, MediaSizeName and Media use the values as specified in PWG 5101.1.
7. XML datatypes are used that map as closely as possible to the IPP specification.
a. The IPP datatypes NameWithoutLanguage, NameWithLanguage, TextWithoutLanguage and TextWithLanguage are mapped to the XML datatype String. Localization is handled globally by the ElementsNaturalLanguage element.
b. The IPP datatype Enum is mapped to the XML datatype NMToken. See #1 above.
c. The IPP collection datatype is represented as an XML sequence. Although sequence is used the set of elements is unordered unless order is explicitly specified in the element definition.
d. The “1setOf X” types are represented as the base type and the “Multivalued” field in the tables set to “Yes”.
Page 244 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
727728
3357
3358
3359
3360
33613362
3363
33643365
3366336733683369
337033713372
337333743375
3376
337733783379
3380
338133823383
33843385
729
Working Draft – PWG Semantic Model v2.0 May 9, 2023
8. Any constraints placed on attribute values has been noted in the tables and whenever possible expressed in the XML schema.
The term “keyword” continues to be used for string values enumerated as part of the PWG Model. The term “object” is sometimes changed to “data class”. The term “operation” has been changed to “action” to use the term more frequently used with XML.
The following IPP attributes are not included: operation-id, attributes-charset, request-id.
22.2 Attribute Group MappingIPP Actions may contain a number of parameters. The first parameter is always the Operation Attributes for the Action. The IPP Operation Attributes have been mapped to the Printer and Job Description Element Groups.
The IPP Printer Description Attributes map to the PWG Printer Status Elements and Printer Description Elements. The IPP Job Description Attributes map to the PWG Job Status Elements and Job Description Elements. The PWG Model differentiates elements that can be directly set (i.e., Description) versus those that are maintained by automata and can only be changed through first class operations (i.e., Status)
The IPP Job Template Attributes map to the PWG Job Processing Elements and Document Processing Elements.
Page 245 of 245 Copyright © 2011-2013 The Printer Working Group. All rights reserved.
730731
33863387
338833893390
3391
3392
339333943395
3396339733983399
340034013402
3403
3404
732