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
attribute. You can use the message to give the reason the job is
being promoted or to provide other comments. 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.
Arguments
Use the arguments to identify the specific objects that you want to promote.
You can use the following argument values with the
pdpromote
command:
- LocalJobId or GlobalJobId
Specify the local or global job identifier of
the job that you want to promote.
You as an administrator would generally use the global job
identifier but you can promote your own jobs using the local job
identifier.
When a job is specified with the
pdpromote
command, it becomes the first job in the queue.
If a another job is then promoted, it becomes the first
job in the queue (ahead of the job previously promoted).
EXAMPLES
Promote Job
To promote job 6450500001 on server DServe1, enter the command:
pdpromote DServe1:6450500001
To promote job 1099600001 on server SPOOL1, enter the command:
pdpromote -m "This job must be printed in 10 minutes" SPOOL1:1099600001
SEE ALSO
pdclean(1),
pdcreate(1),
pddelete(1),
pddisable(1),
pdenable(1),
pdls(1),
pdmod(1),
pdpause(1),
pdpr(1),
pdq(1),
pdresubmit(1),
pdresume(1),
pdrm(1),
pdset(1),
pdshutdown(1)
STANDARDS CONFORMANCE
pdpromote: POSIX 1387.4