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

p
pdpromote(1) pdpromote(1)
(TO BE OBSOLETED)
NAME
pdpromote - advances a job to the top of a queue
SYNOPSIS
pdpromote -h
pdpromote
[ -m "MessageText
" ][-x "AttributeValuePairs
"
][-X AttributesFileName]
LocalJobId ... | GlobalJobId ...
DESCRIPTION
Use the
pdpromote command to move a pending job before any currently-queued jobs. The job becomes
the first job in the queue. If another job is then promoted, it becomes the first job in the queue (ahead of the
job previously promoted).
A move to the beginning of the queue does not necessarily guarantee that the job will be the next job
printed. The jobs currently printing on each of the physical printers associated with the queue continue
printing. The server assigns the promoted job to the first physical printer that becomes available and is
capable of handling the promoted job.
You must have at least read and write authority for the queue to promote your own jobs as well as the jobs
belonging to other people.
The priority level of a print job can be changed by setting the job-priority attribute using the
pdmod or the pdset command. However, a job is promoted to the top of the queue by the
pdpromote
command regardless of it priority.
Options
You can use the following options with the pdpromote 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 you want stored in the job-message-from-administrator
attribute.
You can use the message to give the reason the job is being or has been promoted or to provide other
comments. If you do not specify the
-m option, 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.
This option is equivalent to specifying the command-attribute
message.
-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 to be inserted at the current point in the command
line. This option is equivalent to the command-attribute
attributes .
Command Attributes
You can 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
attri-
bute. You can use the message to give the reason the job is being promoted or to provide other com-
ments. If you do not specify the
message attribute, 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 Attributes
There are no object attributes for this command.
HP-UX 11i Version 1: September 2005 − 1 − Hewlett-Packard Company Section 1−−747