pdpause command: pauses jobs, actual destinations, servers, or queues

Syntax

pdpause [-H host:port] [-c destination] [-m "MessageText"] [-n] 
[-x "attribute=value …"] [-X AttributesFileName] 
[-w {now | after-current-copy | after-current-job}] 
[ServerName:]DestinationName …

pdpause -j [-m "MessageText"] 
[-x "attribute=value …"] [-X AttributesFileName] 
[-w {now | after-current-copy}] [ServerName:]DestinationName …

pdpause -c job [-m "MessageText"] [-x "attribute=value …"] 
[-X AttributesFileName] [-w {now | after-current-copy}] 
{LocalJobID … | GlobalJobID …}

pdpause -c queue [-m "MessageText"] [-x "attribute=value …"] 
[-X AttributesFileName] [ServerName:]QueueName …

pdpause -c server [-m "MessageText"] [-n] 
[-x "attribute=value …"] [-X AttributesFileName] 
[-w {now | after-current-copy | after-current-job}] 
ServerName … 

pdpause -h

Description

Use the pdpause administrative command to pause an object that holds jobs or to pause a job.

You can pause these objects:

  • Jobs that are
    • pending
    • held
    • ripping
    • imposing
    • processing
    • printing
  • Actual destinations
  • Queues
  • Servers (pauses all of the queues and actual destinations contained in a server)

To resume a paused object, use the pdresume command.

    Note:
  1. Use the pdpause and pdresume commands to prevent or allow output from the object.
  2. Use the pddisable and pdenable commands to prevent or allow input to the object.
  3. You cannot pause PSF upload-TCP/IP-attached physical printers.
  4. You cannot pause jobs on a PSF-other or a PSF-command actual destination.
  5. You cannot pause an Anyplace queue.

Flags

You can use these flags with the pdpause command:

-H host:port

Identifies the host and port of the InfoPrint Manager server used for communication. When not specified, the command follows the Configuration logic to define the host and socket.

-c {destination | queue | job | server} DEFAULT=destination
Specifies the object class you want to pause. In the valid classes, destination is an actual destination.

Using this flag is equivalent to specifying the command attribute operation-class.

-j
This flag is only valid when you use it with object-class destination. Use this flag to pause the currently printing job on the specified actual destination. The actual destination must be a physical printer, not an email destination.
-m "MessageText"
Specifies the message you want to associate with the specified destination, queue, job, or server that you are pausing. You can use this message to indicate the reason that you are pausing the object or to provide any other comments.

When pausing a server, InfoPrint propagates the message to the message attribute of the actual destinations and queues residing in the server.

If the command operates on a destination or a queue, you can list this message by specifying requested-attributes=message with the pdls command.

When the command operates on a job, the specified text becomes the value of the job-message-from-administrator attribute. You can list this message by specifying requested-attributes=job-message-from-administrator with the pdls command.

If you do not specify the -m flag, the message already stored with the destination, queue, job, or server remains unchanged.

Using this flag is equivalent to specifying the command attribute message.

-n
Causes the destination to do an NPRO (move the last printed page to the stacker). Using this flag is equivalent to specifying the command attribute non-process-runout=true.

This flag is valid only with object class destination or server. It is not valid with the -j flag. It is valid only for PSF physical printers and for servers containing them.

-w {now | after-current-copy | after-current-job} DEFAULT=now
Specifies when to pause the destination, job, or server. If you specify:
now
and the paused object is a:
destination
The destination pauses as soon as possible. How long this takes depends on the output device.
job
The job pauses as soon as possible. If the job is processing or printing, how long this takes depends on the output device.
Note: If you only want to get the job off the printer immediately, you can use the pdmod command:
pdmod -xjob-hold=true
This will send the job back to the held queue and reprint all the pages in the job.
server
The server pauses as soon as possible. How long this takes depends on the output devices represented by the destinations in the server.
after-current-copy
and the paused object is a:
destination
The destination pauses after the current copy of the current job finishes printing.
job
The job pauses after the current copy finishes printing.
server
The server pauses after the current copy of the current job on each actual destination in the server finishes printing.

This value is valid only for PSF physical printers, for jobs printing on PSF physical printers, and for servers containing PSF physical printers.

after-current-job
and the paused object is a:
destination
The destination pauses after the current job finishes printing.
server
The server pauses after the current job on each actual destination in the server finishes printing.

This value is not valid for jobs, including jobs paused with the -j flag. It is valid only for PSF physical printers and for servers containing PSF physical printers.

Specifying this flag is equivalent to specifying the command attribute when.

-x "attribute=value …"
A single attribute string, consisting of one or more attribute-value pairs.
-X AttributesFileName
Specifies the name of a file containing attribute and value pairs you want inserted at the current point in the command.

Using this flag is equivalent to specifying the command attribute attributes.

-h
Displays a command-specific help message containing information about command syntax and flags. This flag and any other flag are mutually exclusive (if you use it with any other flag or attribute, InfoPrint recognizes only the -h flag).

Configuration logic

The command determines which server host and server port to use based on this sequence:

  1. Server host and server port specified with the -H parameter.
  2. Server host and server port specified with the PDHOST and PD_SOCKET envirnonment variables.
  3. Uses the defaults for PDHOST=localhost and PD_SOCKET=6874.
Note: This configuration logic enables multiple commands to run on a single machine communicating with one or more InfoPrint Manager servers.