pdrm(1)

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 boundary. 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 command.

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 command 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.

message="MessageText"

Specify the message that you want stored in the job-message-from-administrator attribute. You can use this message to indicate the reason for removing the job or to provide other comments.

If the message attribute is not specified, the message already stored with the job remains unchanged.

You can list this message by specifying requested-attributes=job-message-from-administrator with the pdls command.

Object Attribute

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: Specify the amount of time for the server to retain the job before the job is deleted. If a retention period was previously specified for the job, this new retention period takes precedence over the previous job retention period.

Arguments

Use the argument to specify the job to delete.

You can use the following arguments with the pdrm command:

LocalJobID

Specify the local ID of the job that you want removed.

This argument must appear last in the command. If you want to cancel more than one job, each identifier must be separated by spaces.

GlobalJobId

Specify the global ID of the job that you want removed.

This argument must appear last in the command. If you want to cancel more than one job, each identifier must be separated by spaces.

EXAMPLES

Remove A Job

To remove your job number 15, enter the command:

pdrm 15 

To remove global job number Super1:1011223002 on the spooler Super1, enter the command:

pdrm Super1:1011223002 

Remove Job Regardless of Retention Time

To remove your job number 10 as soon as possible, regardless of any previously specified job-retention-period attribute value, enter one of the following commands:

pdrm -x job-retention-period=0 10 

pdrm -r 0 10 

STANDARDS CONFORMANCE

pdrm: POSIX 1387.4