11.2.1 Disable-Printer Operation
This OPTIONAL operation allows a client to stop the Printer object from
accepting new jobs, i.e., cause the Printer to reject subsequent Job
Creation operations and return the 'server-error-not-accepting-jobs' status
code. The Printer still accepts all other operations, including
Validate-Job, Send-Document and Send-URI operations. Thus a Disable-Printer
operation allows a client to continue submitting multiple documents of a
multiple document job if the Create-Job operation had already been accepted.
All previously created or submitted Jobs and currently processing Jobs
Here is the [ipp-mod] spec for the "printer-is-accepting-jobs" that is clear
as to which operations are affects by the boolean attribute:
4.4.23 printer-is-accepting-jobs (boolean)
This REQUIRED Printer attribute indicates whether the printer is currently
able to accept jobs, i.e., is accepting Print-Job, Print-URI, and Create-Job
requests. If the value is 'true', the printer is accepting jobs. If the
value is 'false', the Printer object is currently rejecting any jobs
submitted to it. In this case, the Printer object returns the
'server-error-not-accepting-jobs' status code.
This value is independent of the "printer-state" and "printer-state-reasons"
attributes because its value does not affect the current job; rather it
affects future jobs. This attribute, when 'false', causes the Printer to
reject jobs even when the "printer-state" is 'idle' or, when 'true', causes
the Printer object to accepts jobs even when the "printer-state" is
In the IIG, there is a mistake in that section 22.214.171.124:
126.96.36.199 Suggested Additional Processing Steps for Operations that
Create/Validate Jobs and Add Documents
This section in combination with the previous section recommends the
processing steps for the Print-Job, Validate-Job, Print-URI, Create-Job,
Send-Document, and Send-URI operations that IPP objects SHOULD use. These
are the operations that create jobs, validate a Print-Job request, and add
documents to a job.
Does include a check of "printer-is-accepting-jobs" and returns an error for
all of these operations. It should only be for Print-Job, Print-URI, and
Create-Job which create jobs. The other operations are adding to a job that
is already created.
From: Venkatesh [mailto:firstname.lastname@example.org]
Sent: Wednesday, September 22, 1999 21:12
Subject: IPP> printer-is-accepting-jobs
The Printer Object attribute "printer-is-accepting-jobs" when set to
the printer object stops accepting any print job requests.
Assume that initially "printer-is-accepting-jobs" is set to true.
If a client issues a Create-Job request and if the Printer object
process the request successfully it returns the Job-URI and Job-ID.
Suppose now the Administrator of the Printer Object set
attribute to 'false' will the Prinetr Object accept any Send-Document
Send-URI operation for the Job created before.