HP-UX Reference (11i v1 05/09) - 1 User Commands N-Z (vol 2)

p
pddelete(1) pddelete(1)
(TO BE OBSOLETED)
-X
AttributesFileName
The name of a file containing attribute-value pairs you want inserted at the current point in the com-
mand line. This option is equivalent to specifying the command-attribute
attributes .
Command Attributes
You may specify these attributes in a
-x "AttributeValuePairs
" string or in an attributes file designated
with the
-X AttributesFileName option.
attributes= AttributesFileName
Cause the designated attributes file to be read.
class=ObjectClass
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.
message="MessageText
"
Specify the message that you want associated with the
printer, job, queue, initial-
value-job
,orinitial-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,orjob 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.
Object Attribute
You can only use the object-attribute if object-class is
job. This command will be rejected if used with any
other class. You may specify this attribute in a
-x "AttributeValuePairs
" string or in an attributes file
designated with the
-X AttributesFileName option.
job-retention-period=
time
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.
Arguments
Use the argument to specify the object to delete. If you specify multiple objects, each must be separated by
spaces.
You can use the following arguments with the
pddelete command:
ServerName
You must remove all jobs contained within the named server before you can delete the server.
ServerName:InitialValueDocumentName
If any of the logical printers that reference this initial value document are enabled, you cannot delete
this initial value document.
ServerName:InitialValueJobName
If any of the logical printers that reference this initial value job are enabled, you cannot delete this
initial value job.
LocalJobID or GlobalJobId
A job object is deleted based on the specified value in its job-retention-period
attribute.
[ServerName:]PrinterName
All the jobs must be removed from physical printers. Physical and logical printers must be disabled
before they can be deleted.
[ServerName:]QueueName
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.
Section 1714 Hewlett-Packard Company 2 HP-UX 11i Version 1: September 2005