IPP> OPS> Proposed NEW Operation extensions

IPP> OPS> Proposed NEW Operation extensions

kugler at us.ibm.com kugler at us.ibm.com
Wed May 26 12:56:54 EDT 1999




We'd like to propose these new IPP extensions for registration.

--------------------------------------------------------------------------

Type of registration:  operation
Proposed name of this operation:  Set-Job-Attributes (or Modify-Job)
Object Target (Job, Printer, etc. that operation is upon):  Job
Specification of this attribute (sic)(follow the style of IPP Model Section
3):

This operation allows the client to modify attributes of previously
submitted jobs.  For example, if a large job aborts in the middle,
"page-ranges" or "copies" could be modified and the job restarted.

Set-Job-Attributes Request:

Group 1: Operation Attributes

Natural Language and Character Set: The "attributes-charset" and
"attributes-natural-language" attributes as described in section
3.1.4.1.

Target: Either (1) the "printer-uri" (uri) plus "job-id"
(integer(1:MAX)) or (2) the "job-uri" (uri) operation attribute(s)
which define the target for this operation as described in section
3.1.5.

Requesting User Name: The "requesting-user-name" (name(MAX)) attribute
SHOULD be supplied by the client as described in section 8.3.

Group 2: Job Attributes

This is the group of attributes to be set and their requested new values.
Not all attributes are settable.

Set-Job-Attributes Response:

Group 1: Operation Attributes

Status Message: In addition to the REQUIRED status code returned in
every response, the response OPTIONALLY includes a "status-message"
(text) operation attribute.

Natural Language and Character Set: The "attributes-charset" and
"attributes-natural-language" attributes as described in section
3.1.4.2.

Group 2: Unsupported Attributes

See section 3.1.7 for details on returning Unsupported Attributes.

Status codes:

'successful-ok'
'client-error-not-possible'
'successful-ok-ignored-or-substituted-attributes',
'successful-ok-conflicting-attributes',
'client-error-attributes-or-values-not-supported'
'client-error-conflicting-attributes'.

--------------------------------------------------------------------------
Type of registration:  operation
Proposed name of this operation:  Set-Printer-Attributes (or
Modify-Printer)
Object Target (Job, Printer, etc. that operation is upon):  Printer
Specification of this attribute (follow the style of IPP Model Section
3):

This operation allows the client to modify attributes of a Printer.  For
example, a Printer can be disabled by setting "printer-is-accepting-jobs"
to 'false'.

Set-Printer-Attributes Request:

Group 1: Operation Attributes:

Natural Language and Character Set: The "attributes-charset" and
"attributes-natural-language" attributes as described in section
3.1.4.1.

Target: The "printer-uri" (uri) operation attribute which is the
target for this operation as described in section 3.1.5.

Requesting User Name: The "requesting-user-name" (name(MAX)) attribute
SHOULD be supplied by the client as described in section 8.3.

"document-format" (mimeMediaType) : The client OPTIONALLY supplies
this attribute.  This is used to select the interpreter to which these
attributes should be applied.

Group 2: Printer Attributes:

This is the set of attributes to be set and their requested new values.
Not all attributes are settable.

Set-Printer-Attributes Response:

Group 1: Operation Attributes:

Status Message: In addition to the REQUIRED status code returned in
every response, the response OPTIONALLY includes a "status-message"
(text) operation attribute.

Natural Language and Character Set: The "attributes-charset" and
"attributes-natural-language" attributes as described in section
3.1.4.2.

Group 2: Unsupported Attributes:

See section 3.1.7 for details on returning Unsupported Attributes.

Status codes:
'successful-ok'
'client-error-not-possible'
'successful-ok-ignored-or-substituted-attributes',
'successful-ok-conflicting-attributes',
'client-error-attributes-or-values-not-supported'
'client-error-conflicting-attributes'.

--------------------------------------------------------------------------
Type of registration:  operation
Proposed name of this operation:  Cancel-Current-Job
Object Target (Job, Printer, etc. that operation is upon):  Printer
Specification of this attribute (follow the style of IPP Model Section
3):

This operation allows a client to cancel the currently printing job
without having to specify the job-id or job-uri.

Cancel-Current-Job Request:

Group 1: Operation Attributes

Natural Language and Character Set: The "attributes-charset" and
"attributes-natural-language" attributes as described in section
3.1.4.1.

Target: The "printer-uri" (uri) operation attribute which is the
target for this operation as described in section 3.1.5.

Requesting User Name: The "requesting-user-name" (name(MAX)) attribute
SHOULD be supplied by the client as described in section 8.3.

Cancel-Current-Job Response:

Group 1: Operation Attributes

Status Message: In addition to the REQUIRED status code returned in
every response, the response OPTIONALLY includes a "status-message"
(text) operation attribute as described in sections 13 and 3.1.6.

Natural Language and Character Set: The "attributes-charset" and
"attributes-natural-language" attributes as described in section
3.1.4.2.

Group 2: Unsupported Attributes

See section 3.1.7 for details on returning Unsupported Attributes.

Status codes:
'successful-ok'
'client-error-not-possible'

--------------------------------------------------------------------------
Type of registration:  operation
Proposed name of this operation:  Shutdown
Object Target (Job, Printer, etc. that operation is upon):  Printer
Specification of this attribute (follow the style of IPP Model Section
3):

This operation allows a client to shut down a Printer. Specifically,
this operation:
  - Terminates all communication with the Printer
  - Disables the Printer

Shutdown Request:

Group 1: Operation Attributes

Natural Language and Character Set: The "attributes-charset" and
"attributes-natural-language" attributes as described in section
3.1.4.1.

Target: The "printer-uri" (uri) operation attribute which is the
target for this operation as described in section 3.1.5.

Requesting User Name: The "requesting-user-name" (name(MAX)) attribute
SHOULD be supplied by the client as described in section 8.3.

When:  (Keyword) "when" indicates when to shutdown the printer.
Standard values:
  'now':  cancel any currently printing jobs and shut down the Printer.
  'after-current':  continue to accept requests other than print
     requests until the currently printing Jobs finish printing.
  'after-all': continue to accept all requests except print requests
     until all scheduled jobs finish printing.

Shutdown Response:

Group 1: Operation Attributes

Status Message: In addition to the REQUIRED status code returned in
every response, the response OPTIONALLY includes a "status-message"
(text) operation attribute as described in sections 13 and 3.1.6.

Natural Language and Character Set: The "attributes-charset" and
"attributes-natural-language" attributes as described in section
3.1.4.2.

Group 2: Unsupported Attributes

See section 3.1.7 for details on returning Unsupported Attributes.

Status codes:
'successful-ok'
'client-error-not-possible'

--------------------------------------------------------------------------
Type of registration:  operation
Proposed name of this operation:  Backspace-Current-Job
Object Target (Job, Printer, etc. that operation is upon):  Printer
Specification of this attribute (follow the style of IPP Model Section
3):

Backspaces the currently printing job a given number of impressions.  For
example, if you specify that the job is to be backspaced 10 impressions
and the 14th impression was the last buffered impression to be printed,
the job starts printing with the fifth impression.

Backspace-Current-Job Request:

Group 1: Operation Attributes

Natural Language and Character Set: The "attributes-charset" and
"attributes-natural-language" attributes as described in section
3.1.4.1.

Target: The "printer-uri" (uri) operation attribute which is the
target for this operation as described in section 3.1.5.

Requesting User Name: The "requesting-user-name" (name(MAX)) attribute
SHOULD be supplied by the client as described in section 8.3.

Job Impressions: "job-impressions": the number of impressions to
backspace before continuing to print.

Backspace-Current-Job  Response:

Group 1: Operation Attributes

Status Message: In addition to the REQUIRED status code returned in
every response, the response OPTIONALLY includes a "status-message"
(text) operation attribute as described in sections 13 and 3.1.6.

Natural Language and Character Set: The "attributes-charset" and
"attributes-natural-language" attributes as described in section
3.1.4.2.

Group 2: Unsupported Attributes

See section 3.1.7 for details on returning Unsupported Attributes.

Status codes:
'successful-ok'
'client-error-not-possible'

--------------------------------------------------------------------------

Name of proposer:   Carl Kugler
Address of proposer:  6300 Diagonal Hwy, Boulder CO 80301
Email address of proposer:  kugler at us.ibm.com






More information about the Ipp mailing list