.\" $Header:
.TA p
.TH pdrm 1
.SH NAME
pdrm \- removes print jobs
.SH SYNOPSIS
.tr ~"
.C pdrm 
.RC [ -m \0\~\f2MessageText\f4~ \|\f1]
.RC [ -r \0\f2JobRetentionPeriod\f4 \|\f1]
.RC [ -x \0\~\f2AttributeValuePairs\f4~ \|\f1]
.RC [ -X \0\f2AttributesFileName\f4 \|\f1]
.RI \0\f2LocalJobId ... | GlobalJobId ...\f4
.PP
.C pdrm -h
.PP
.tr ~~
.SH DESCRIPTION
You enter the 
.C pdrm 
command to remove (delete) previously submitted print
jobs.
.PP
.CR Notes :
.PP
1.  If the job you specify is currently printing, it can only be removed
at a pause point in the job.  The pause point at which the job can be
removed is dependent on the type of printer being used to print the
job.  A pause point 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.
.PP
2.  When you request a job to be removed with:
.PP
    \(bu   A 
.C job-retention-period 
of zero, the job is deleted.
.PP
    \(bu   A 
.C job-retention-period 
of non-zero, the job is retained until the
.C job-retention-period 
runs out; then the job is deleted.
.PP
.IP
.CR Note :   
The job-retention-period 
applies to both a previously set
period or one specified with this command.
.PP
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.
.br
.in +4
HPDPS issues a confirmation message prior to deleting jobs, 
unless the
environment variable 
.C PD_CONFIRM_DELETE 
for the person requesting the
job removal has a value of 
.CR no .
.PP
.SS Options
You can use the following options with the 
.C pdrm 
command:
.PP
.TP
.C -h   
Displays a command-specific help message containing information
about command syntax and options.  This option is mutually
exclusive; cannot be used with another option or with an
attribute.
.PP
.C -m "\c
"\f2MessageText\f4\c"
"
.ft
.IP
Specifies the message you want to be associated with the
specified job.  The specified text becomes the
.C job-message-from-administrator 
attribute.  You can use it to
provide the reason the job is being removed or other comments.
If the 
.C -m 
option is not specified, the message already stored with
the job remains unchanged.
.PP
.IP
You can list this message by specifying
.CR requested-attributes=job-message-from-administrator 
with the
.C pdls 
command.
Using this option is equivalent to specifying the
command-attribute 
.CR     message .
.PP
.TP
.C -r \f2JobRetentionPeriod\f4
Specifies the period of time you want the job to be retained by
the server before the job is deleted.  If specified, this
retention-period takes precedence over the previous job
retention period set for the job.
Using this option is equivalent to specifying the object-attribute
.CR job-retention-period .
.PP
.TP
.C "-x ""\f2AttributeValuePairs\f4"" "
Consists of a single attribute string, containing one or more
attribute-value pairs.
.PP
.TP
.C -X \f2AttributeFileName\f4
The name of a file containing attribute-value pairs you want
inserted at the current point in the command line.  Using this
option is equivalent to specifying the command-attribute
.CR attributes .
.PP
.SS Command Attributes
.PP
You can define these attributes in a 
.C -x "\c
"\f2AttributeValuePairs\f4\c"
" 
.ft
string or
in an attributes file designated in the 
.C -X \f2AttributesFileName\f4
option.
.PP
.TP
.C attributes\f2=AttributesFileName\f4
Causes the designated attributes file to be read.
.PP
.C "message\f2=""MessageText""\f4\c "
.ft
.IP
Specifies the message that you want to be stored in the
.C job-message-from-administrator
attribute.  You can use it to
provide the reason the job is being removed or other comments.
If the 
.C message 
attribute is not specified, the message already
stored with the job remains unchanged.
.PP
.IP
You can list this message by specifying
.C requested-attributes=job-message-from-administrator 
with the
.C pdls 
command.
.PP
.SS Object Attributes
.PP
You can define this attribute in a 
.C -x "\c
"\f2AttributeValuePairs\f4" 
.ft
string or in
the attributes file designated in the 
.C -X AttributesFileName 
option.
.PP
.TP
.C job-retention-period\f2=time\f4
Specifies the amount of time you want the job retained by the
server before the job is deleted.  If specified, this retention
period takes precedence over the previous job retention time set
for the job.
.PP
.SS Arguments       
.PP
You use the arguments to identify the specific job you want to delete.
You must use one of the following valid argument values for the 
.C pdrm
command:
.PP
\f2LocalJobId\f4
.ft
.IP
Specifies the local ID of the jobs you want removed.
.PP
.IP
This argument must appear last in the command.  If you want to
cancel more than one job, each identifier must be separated by
spaces.
.PP
\f2GlobalJobId\f4
.ft
.IP
Specifies the global ID of the job you want removed.
.PP
.IP
This argument must appear last in the command.  If you want to
cancel more than one job, each identifier must be separated by
spaces.
.PP
.SH EXAMPLES
.PP
.SS Remove A Job         
.PP
\(bu   To remove your job numbered 15, enter the command:
.PP
.C    pdrm 15
.PP
\(bu   To remove global job number 1011 on the server Super1, enter the
    command:
.PP
.C    pdrm Super1:1011
.PP
.SS Remove Job Regardless of Retention Time
.PP
\(bu   To remove your job number 10 as soon as possible, regardless of 
any previously specified 
.C    job-retention-period 
attribute value, enter one
of the following commands:
.PP
.C    pdrm -x job-retention-period=0 10
.PP
.C    pdrm -r 0 10
.PP
.SH SEE ALSO
pdclean(1), pdcreate(1), pddelete(1), pddisable(1), pdenable(1), pdls(1), pdmod(1),
pdpause(1), pdpr(1), pdpromote(1), pdq(1), pdresubmit(1), pdresume(1), pdset(1),
pdshutdown(1)
.PP
.SH STANDARDS CONFORMANCE
.CR pdrm ": POSIX 1387.4"
.\" index@\f4pdrm\f1 \- removes print jobs@@@\f3pdrm(1)\f1
.\" index@\f1removes print jobs@@@\f3pdrm(1)\f1
.\" index@\f1HP Distributed Printer System, removes print jobs@@@\f3pdrm(1)\f1
.\"
.\" toc@\f3pdrm(1)\f1:\0\0\f4pdrm\f1@@@removes print jobs
.\"
.\"
.\"
