HPlogo HP-UX Reference Volume 1 of 5 > p

pdresume(1)

» 

Technical documentation

Complete book in PDF

 » Table of Contents

 » Index

NAME

pdresume — enables paused objects to resume operation

SYNOPSIS

pdresume -h

pdresume [-c ObjectClass] [ -m "MessageText" ] [ -x "AttributeValuePairs" ] [-X AttributesFileName] { LocalJobId ... | GlobalJobId ... | ServerName ... | [ServerName : ]PrinterName ... | [ServerName : ]QueueName ... }

DESCRIPTION

Use the pdresume command to start up (resume) paused jobs, physical printers, queues, or servers.

Note: The pdresume and pdpause commands are used to allow or prevent output from the object, whereas pddisable and pdenable are used to prevent or allow input to the object.

Options

Use the following options with the pdresume command:

-c ObjectClass

Specify the object class that you want to resume. The ObjectClass can be one of the following:

printer (default) queue job server

Within the valid classes, printer is a physical printer and server is either a spooler or a supervisor. This option is equivalent to specifying the command-attribute class.

-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 that is to be associated with the ObjectClass that is being resumed: printer, queue, job, or server. You can use this message to indicate the reason for resuming or to provide other comments.

When resuming a supervisor, HPDPS propagates the message to the message attribute of the physical printers residing in the supervisor. The message attribute for the supervisor is not changed.

When resuming a spooler, the message is propagated to the message attribute of the queues residing in the spooler. The message attribute for the spooler is not changed.

If the command operates on a job, you can list this message by specifying requested-attributes=job-message-from-administrator with the pdls command. If the command is to operate on a printer, queue, or server, you can list this message by specifying requested-attributes=message with the pdls command.

If the -m option is not specified, the message already stored with the object remains unchanged.

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 you want inserted at the current point in the command line. This option is equivalent to specifying 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.

class=ObjectClass

Specify the object class that you want to resume. Valid object class names for the pdresume command are: printer (default), queue, job, or server.

Within the valid classes, printer is a physical printer and server is either a spooler or a supervisor.

message="MessageText"

Specify the message that you want associated with the printer, queue, job, or server. You may use this message to indicate the reason for resuming or to provide other comments.

When resuming a supervisor, HPDPS propagates the message to the message attribute of the physical printers residing in the supervisor. The message attribute for the supervisor is not changed.

When resuming a spooler, the message is propagated to the message attribute of the queues residing in the spooler. The message attribute for the spooler is not changed.

If the command operates on a job, you can list this message by specifying requested-attributes=job-message-from-administrator with the pdls command. If the command is to operates on printer, queue, or server, you can list this message by specifying requested-attributes=message with the pdls command.

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

Object Attributes

There are no object attributes for this command.

Arguments

Use the argument values to specify the object that 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.

You can use the following argument values with the pdresume command:

LocalJobID or GlobalJobId

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

A resumed job does not automatically return to its previous state. For example, the job-hold or 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.

Resuming a job that was not previously assigned to a physical printer allows it to be scheduled.

Resuming a job that was processing when it was paused restores it to the pending state. An attempt is made to schedule it on the original physical printer. If the original printer is not available, 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.

[ServerName:]PrinterName

Specify the printer that you want to resume operating.

Resuming a physical printer allows the printer to start processing jobs that have been assigned to the printer.

[ServerName:]QueueName

Specify the queue that you want to resume operating.

Resuming a queue resumes the distribution of jobs to physical printers associated with that queue.

ServerName

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

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.

EXAMPLES

Resume a Physical Printer

To resume physical printer HPLJ6P and issue a message, enter:

pdresume -m "Toner refilled" HPLJ6P

Resume a Queue

To resume the queue Div1Q2, enter:

pdresume -c queue Div1Q2

To resume all of the queues in the spooler Mrk-spooler3, enter:

pdresume -c server Mrk-spooler3

STANDARDS CONFORMANCE

pdresume: POSIX 1387.4

© Hewlett-Packard Development Company, L.P.