pdshutdown command: stops servers or actual destinations

Syntax

pdshutdown [-H host:port] [-c server] [-m "MessageText"] [-w time] 
[-x "attribute=value …"] [-X AttributesFileName] 
ServerName

pdshutdown [-c destination] [-m "MessageText"] 
[-x "attribute=value …"] [-X AttributesFileName] 
[-s [-n]] [ServerName:]DestinationName

pdshutdown -h

Description

Use the pdshutdown administrative command to terminate a server process or shut down a PSF physical printer, or email destination.

You can shut down a server either immediately or after it finishes processing some or all of its current jobs.

InfoPrint prevents the server from accepting new jobs while the server is shutting down and after it has shut down. Destinations in the server that were enabled at shut down time are enabled when the server restarts. Destinations in the server that were disabled at shut down time are disabled when the server restarts.

Shutting down an actual destination:

  • Terminates all communication with the output device
  • Pauses the job printing or sending on the actual destination
  • Terminates all jobs processing on the actual destination and puts these jobs in the pending state
  • Releases jobs assigned to the actual destination so that you can reschedule them on another actual destination
  • Disables the actual destination

You can shut down a PSF physical printer either immediately or after synchronizing the current job's checkpoint data with the pages that have actually printed.

    Note:
  1. To restart an actual destination after shut down, use the pdenable command. See pdenable command: enables destinations to accept jobs and logs to log. See the pdenable man page.
  2. Synchronize the checkpoint data for a controlled shut down, for example, when you want to do maintenance that will take some time.
  3. If InfoPrint cannot communicate with the output device, shut down the actual destination so that you can reschedule the jobs assigned to it. Do not synchronize the checkpoint data. If you try, the command will hang, waiting for the output device to respond.

    If you shut down without synchronization, the shut down will take effect and allow any previously hung commands to complete.

  4. A job paused by a destination shut down without synchronization can reprint some pages when printing is resumed.
  5. To interrupt the actual destination for only a short time, consider pausing it rather than shutting it down. When you pause an actual destination, scheduled jobs remain scheduled. When you shut down an actual destination, scheduled jobs are requeued.

Flags

You can use these flags with the pdshutdown 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 {server | destination} DEFAULT=server
Specifies the object class you want to shut down. In the valid classes, destination is a PSF physical printer, or email destination.

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

-m "MessageText"
Specifies the message that you want to associate with the server or actual destination being shut down. You can use this message to indicate the reason for the shut down or to provide any other comments.

You can list this message by specifying requested-attributes=message with the pdls command. If you do not specify the -m flag, the message already stored with the object remains unchanged.

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

-n
Causes the PSF physical printer 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, and only if you also specify -s. It is not valid for email destinations.

-s
Synchronizes the checkpoint data for the current job with the pages that have actually printed. This permits the job to resume at the point of synchronization. Using this flag is equivalent to specifying the command attribute synchronize=true. Do not use this flag if InfoPrint cannot communicate with the printer device.

This flag is valid only with object class destination. It is not valid for email destinations.

-w {after-current | now | after-all} DEFAULT=after-current
Specifies when you want a server to shut down. When the value is:
now
InfoPrint cancels and requeues any currently printing jobs, then shuts down the server. You must resubmit the jobs using the pdresubmit command when the server restarts.