.\" $Header:
.TA p
.TH pdresume 1 
.SH NAME
pdresume \- enables paused objects to resume operation
.SH SYNOPSIS
.tr ~"
.C pdresume 
.RC [ -c \0\f2ObjectClass\f4 \|\f1]
.RC [ -m \0\~\f2MessageText\f4~ \|\f1]
.RC [ -x \0\~\f2AttributeValuePairs\f4~ \|\f1]
.RC [ -X \0\f2AttributesFileName\f4 \|\f1]
.RI \0\f2LocalJobId ... \f4\0| 
.RI \0\f2GlobalJobId ... \f4\0|
.RI \0\f2[ServerName:]PrinterName ...\f4\0| 
.RI \0\f2[ServerName:]QueueName... | \f4\0|
.RI \0\f2ServerName ...\f4
.PP
.C pdresume -h
.PP
.tr ~~
.SH DESCRIPTION
You use this administrative command 
.C \f2(\f4pdresume\f2)\f4 
to cause paused jobs,
physical printers, queues, or servers to be started again.
.PP
.CR Note :   
The 
.C pdresume 
and 
.C pdpause 
commands control output, whereas 
.C pddisable
and 
.C pdenable 
control input.
.PP
.SS Options
You can use the following options with the 
.C pdresume 
command:
.PP
.C -c \f2ObjectClass
.IP
Where \f2ObjectClass
.ft
can be
.C printer
(default),
.C queue
,
.C job
, or
.C server.
.IP
Specifies the object class you want for this command.  Within
the valid classes, 
.C printer 
is a physical printer and 
.C server 
is either a spooler or a supervisor.
Using this option is equivalent to specifying the
command-attribute 
.C class.
.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 associated with the specified
.C printer
, 
.C queue
, 
.C job 
, or 
.C server.
You may use this message to
indicate the reason for resumption or other comments.
.PP
.IP
When resuming a supervisor, 
.CR HPDPS 
propagates the message to the
.C message 
attribute of the physical printers residing in the
supervisor.  The 
.C message 
attribute for the supervisor is not changed.
.PP
.IP
When resuming a spooler, the message is propagated to the
.C message 
attribute of the queues residing in the spooler.  The
.C message 
attribute for the spooler is not changed.
.PP
.IP
If the command operates on a 
.C job
, you can list this message by
specifying 
.CR requested-attributes=job-message-from-administrator
with the 
.C pdls 
command.  If the command is to operate on a
.C printer
, 
.C queue
, or 
.C server
you can list this message by
specifying 
.CR requested-attributes=message 
with the 
.C pdls 
command.
.PP
.IP
If the 
.C -m 
option is not specified, the message already stored with
the object remains unchanged.
.PP
.IP
Using this option is equivalent to specifying the
command-attribute 
.CR message .
.PP
.TP
.tr ~"
.C -x \0\f2\~AttributeValuePairs\f4~
.tr ~"
A single attribute string, consisting of one or more
attribute-value pairs.
.PP
.TP
.C -X \0\f2AttributesFileName\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 specify these attributes in a 
.C -x "\c
"\f2AttributeValuePairs\f4\c"
" 
.ft
string or
in an attributes file designated with the 
.C -X \f2AttributesFileName \f4
option.
.PP
.TP
.C attributes\f2=AttributesFileName\f4
Causes the designated attributes file to be read.
.PP
.C class\f2=ObjectClass
.IP
Where \f2ObjectClass
.ft
can be
.C printer
(default),
.C queue
,
.C job
, or
.C server.
.IP
Specifies the object class you want for this command.  Within
the valid classes, 
.C printer
is a physical printer and 
.C server
is either a spooler or a supervisor.
.PP
.TP
.tr ~"
.CR message\f2=\~MessageText\f4~
.tr ~~
Specifies the message you want associated with the specified
.C printer
, 
.C queue
, 
.C job 
, or 
.C server.  
You may use this message to
indicate the reason for resumption or other comments.
.PP
.IP
When resuming a supervisor, 
.CR HPDPS 
propagates the message to the
.C message 
attribute of the physical printers residing in the
supervisor.  The 
.C message 
attribute for the supervisor is not
changed.
.PP
.IP
When resuming a spooler, the message is propagated to the
.C message 
attribute of the queues residing in the spooler.  The
.C message 
attribute for the spooler is not changed.
.PP
.IP
If the command operates on a job, you can list this message by
specifying 
.CR requested-attributes=job-message-from-administrator
with the 
.C pdls 
command.  If the command is to operates on
.C printer
, 
.C queue
, or 
.C server
, 
you can list this message by
specifying 
.CR requested-attributes=message 
with the 
.C pdls 
command.
.PP
.IP
If the 
.C message 
attribute is not specified, the message already
stored with the object remains unchanged.
.PP
.SS Object Attributes           
.PP
There are no object attributes for this command.
.PP
.SS Arguments
.PP
You use the argument values to identify the specific 
.C printer
, 
.C queue
, 
.C job
,
or 
.C server 
you want to start processing again (resume operating).  If you
specify multiple objects, all of the objects must be of the same class,
and each must be separated by spaces.
.PP
You can use the following argument values with the 
.C pdresume 
command:
.PP
.TP
\f2LocalJobId...\f4 or \f2GlobalJobId...\f4
Specifies the job you want to resume as determined by a local
job identifier or global job identifier.  Only an administrator
has the authority to resume jobs, and generally use the global
job identifier.
.PP
.IP
A resumed job does not automatically return to its previous
state.  For example, the 
.C job-hold 
or 
.C print-after 
attributes of a
paused job may have been modified, and returning to its previous
state would cause the job to be held even after it has been
resumed.
.PP
.IP
Resuming a job that was not previously assigned to a physical
printer allows it to be scheduled.
.PP
.IP
Resuming a job that was processing when it was paused restores
it to the pending state, and an attempt is made to schedule it
on the original physical printer.  If the original printer is
not available, 
.CR HPDPS 
schedules the job on another physical printer
that can support the job checkpoint format and begins printing
the job where it stopped.  If another physical printer cannot be
found that supports the checkpoint format, the job is placed in
the held state.  The job can be resubmitted, which means that
the job will be started from the beginning.
.PP
.TP
\f2[ServerName:]PrinterName\f4
Specifies the printer you want to resume operation.
.PP
.IP
Resuming a physical printer allows the printer to start
processing jobs that have been assigned to the printer.
.PP
.TP
\f2[ServerName:]queue\f4
Specifies the queue you want to resume operating.
.PP
.IP
Resuming a queue resumes the distribution of jobs to physical
printers associated with that queue.
.PP
.TP
\f2ServerName\f4
Specifies the server on which you want the command to operate.
A server does not have a paused state.  Issuing the command to a
spooler resumes all of the paused queues that reside in that
spooler.  The queues can then continue to distribute jobs to
physical printers.
.PP
.IP
Issuing the command to a supervisor resumes all of the physical
printers that reside in that supervisor.  The physical printers
are then allowed to start processing jobs that have been
assigned to them.
.PP
.SH EXAMPLES
.PP
.SS Resume a Physical Printer
.PP
\(bu   To resume physical printer HPLJ6P and issue a message, enter:
.PP
.tr ~"
.C "pdresume -m ""Toner refilled"" HPLJ6P"
.tr ~~
.PP
.SS Resume a Queue 
.PP
\(bu   To resume the queue Div1Q2, enter:
.PP
.C pdresume -c queue  Div1Q2
.PP
\(bu   To resume all of the queues in the spooler Mrk-spooler3, enter:
.PP
.C pdresume -c server Mrk-spooler3
.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), pdrm(1), pdset(1),
pdshutdown(1)
.PP
.SH STANDARDS CONFORMANCE
.CR pdresume ": POSIX 1387.4"
.\" index@\f4pdresume\f1 \- enables paused objects to resume operation@@@\f3pdresume(1)\f1
.\" index@\f1enables paused objects to resume operation@@@\f3pdresume(1)\f1
.\" index@\f1HP Distributed Printer System, enables paused objects to resume operation@@@\f3pdresume(1)\f1
.\"
.\" toc@\f3pdresume(1)\f1:\0\0\f4pdresume\f1@@@enables paused objects to resume operation
.\"
.\"
.\"
