pddelete(1)

Specify the object class that the command is to operate upon. The ObjectClass can be one of the following:

This option is equivalent to specifying the command-attribute class.

Display a command-specific help message containing information about command syntax and options. This cannot be used with another option or an attribute.

Specify the message that is to be associated with the ObjectClass that is being deleted: printer, job, queue, initial-value-job, or initial-value-document. You can use this message to indicate the reason for deleting the printer, job, queue, initial-value-job, or initial-value-document, or to provide other comments.

If the command is to operate on a job with a non-zero job-retention-period, list this message by specifying requested-attributes=job-message-from-administrator with the pdls command. If the command is to operate on a printer, queue, initial-value-job, initial-value-document, or job with a job-retention-period of zero (0), this message is deleted with the object and cannot be retrieved.

If the -m is not specified, the message already stored with the object remains unchanged and is deleted as just described.

This option is equivalent to specifying the command-attribute message.

Can only be used if object-class is job. The command will be rejected if used with any other class.

If the job currently has a retention-period or is currently retained, this option must be specified with a zero (0) value to delete the job. If not specified, the present retention-period for the job is used.

This option is equivalent to specifying the object-attribute job-retention-period.

A single attribute string, consisting of one or more attribute-value pairs.

The name of a file containing attribute-value pairs you want inserted at the current point in the command line. This option is equivalent to specifying the command-attribute attributes.

Cause the designated attributes file to be read.

Specify the ObjectClass that you want for this command. Valid object class names for the pddelete command are: printer (default), job, queue, initial-value-job, initial-value-document, and server.

Specify the message that you want associated with the printer, job, queue, initial-value-job, or initial-value-document, that is being deleted. You can use this message to indicate the reason for deleting the printer, job, queue, initial-value-job, initial-value-document, or to provide other comments.

If the command is to operate on a job with a non-zero job-retention-period, you can list this message by specifying a value of requested-attributes=job-message-from-administrator with the pdls command. If the command is to operate on printer, job, queue, initial-value-job, initial-value-document, or job with job-retention-period of zero (0), this message is deleted with the object and cannot be retrieved.

If the message attribute is not specified, the message stored with the object remains unchanged and is deleted as just described.

If the job currently has a retention-period or is currently retained, this attribute must be specified with a zero (0) value to delete the job. If not specified, the present retention-period for the job is used.

You must remove all jobs contained within the named server before you can delete the server.

If any of the logical printers that reference this initial value document are enabled, you cannot delete this initial value document.

If any of the logical printers that reference this initial value job are enabled, you cannot delete this initial value job.

A job object is deleted based on the specified value in its job-retention-period attribute.

All the jobs must be removed from physical printers. Physical and logical printers must be disabled before they can be deleted.

You must disable all logical and physical printers associated with the queue before you can delete the queue. Before disabling physical printers, you must first remove all of the jobs from them. All of the jobs (including paused jobs) must be removed from the queue before the queue can be deleted.