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

p
pdrm(1) pdrm(1)
(TO BE OBSOLETED)
NAME
pdrm - removes print jobs
SYNOPSIS
pdrm -h
pdrm
[ -m "MessageText
" ][-r JobRetentionPeriod][
-x "
AttributeValuePairs
" ]
[-X AttributesFileName]{LocalJobId ... | GlobalJobId ...}
DESCRIPTION
Use the
pdrm command to remove (delete) previously submitted print jobs.
1. If the job you specify is currently printing, it can only be removed at a pausable point in the job. The
pausable point at which the job can be removed is dependent on the type of printer being used to print
the job. A pausable point may be immediate or it may be the next page, sheet, document, or job boun-
dary. If there is no such point before the end of job, the job is not removed.
2. When you request a job to be removed with:
a job-retention-period
of zero, the job is deleted.
a
job-retention-period
of non-zero, the job is retained until the job-retention-
period
runs out. Then the job is deleted.
Note: The job-retention-period applies to both a previously set period or one specified with this com-
mand.
3. You can remove your own jobs, and if you are authorized, you can remove a job belonging to another
person by specifying the global ID for the job.
HPDPS issues a confirmation message prior to deleting jobs, unless the environment variable
PD_CONFIRM_DELETE
for the person requesting the job removal has a value of no.
Options
You can use the following options with the
pdrm command:
-h Display a command-specific help message containing information about command syntax and options.
This option cannot be used with another option or with an attribute.
-m "MessageText"
Specify the message to be associated with the specified job. The specified text becomes the
job-
message-from-administrator
attribute. You can use this message to indicate the reason for
removing the job or to provide other comments.
You can list this message by specifying
requested-attributes=job-message-from-
administrator
with the pdls command.
If the -m option is not specified, the message already stored with the job remains unchanged.
This option is equivalent to specifying the command-attribute
message.
-r JobRetentionPeriod
Specify the period of time that you want the job retained by the server before the job is deleted. This
is the retention period. If a retention period was previously specified for the job, this new retention
period takes precedence over the previous job retention period.
This option is equivalent to specifying the object-attribute job-retention-period
.
-x "AttributeValuePairs"
A single attribute string, consisting of one or more attribute-value pairs.
-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.
HP-UX 11i Version 1: September 2005 1 Hewlett-Packard Company Section 1757