HPlogo HP-UX Reference Volume 1 of 5 > p

pdclean(1)

» 

Technical documentation

Complete book in PDF

 » Table of Contents

 » Index

NAME

pdclean — removes all jobs from the specified object

SYNOPSIS

pdclean -h

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

DESCRIPTION

Use this administrative command, pdclean, to remove all jobs from the specified servers, logical printers, queues, or physical printers. If you are removing jobs from a server, any job-retention-period attribute values are ignored. For all other conditions, the job-retention-period is honored. If you are removing jobs from a logical printer, all jobs that have been submitted to it are removed from the queue. If you are removing jobs from a queue, all jobs that are contained in that queue are removed from the queue.

Jobs that are in the middle of printing are aborted, if possible.

HPDPS issues a confirmation message prior to cleaning the object, unless your environment variable PD_CONFIRM_DELETE has a value of no.

Options

Use the following options with the pdclean command:

-c ObjectClass

Specify the object class you want for this command. The ObjectClass can be one of the following:

printer (default) queue server

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

This option is equivalent to 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 specified: printer, queue, or server. You can use this message to indicate the reason why the printer, queue, or server is being cleaned or to provide other comments.

This option is equivalent to specifying the command-attribute message.

List this message by specifying requested-attributes=message with the pdls command.

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

Command Attributes

You may 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 ObjectClass that you want for this command. Valid object class names for the pdclean command are: printer, queue, or server. Within the valid classes, server is for a spooler or supervisor, and printer is for a logical or physical printer.

message="MessageText"

Specify the message you want associated with the printer, queue, or server. You can use this message to indicate the reason why the printer, queue, or server is being cleaned or to provide other comments.

You can list this message by specifying requested-attributes=message with the pdls command.

Arguments

Use the argument to specify the printer, queue, or server to clean. If you specify multiple objects, all must be of the same object class, and each must be separated by spaces.

You can use the following arguments with pdclean command:

[ServerName:]PrinterName

Specify which printer you want cleaned of jobs.

Cleaning a physical printer removes only those jobs that have been assigned to that physical printer.

Cleaning a logical printer removes all jobs that were submitted through that logical printer that have not yet been completed. They are removed from the queue associated with the logical printer. Any jobs currently printing are aborted if this is supported by the physical printer device.

[ServerName:]QueueName

Specify which queue you want cleaned of jobs.

Cleaning a queue deletes all jobs that reside in that queue. Any jobs currently printing will be aborted if this is supported by the physical printer device.

ServerName

Specify which server you want cleaned of jobs.

Cleaning a spooler deletes all jobs that have been submitted to any of the logical printers residing in that spooler including any retained jobs. Any jobs currently printing are aborted if this is supported by the physical printer device.

Cleaning a supervisor deletes all jobs that are assigned to any of the physical printers residing in that supervisor. Any jobs currently printing are aborted, if this is supported by the physical printer device.

EXAMPLES

Clean a Printer

To clean printer lj4si of all jobs, enter the command:

pdclean lj4si

Clean a Server

To clean server DSuper1, enter the command:

pdclean -c server DSuper1

Clean a Physical Printer

To clean printer PhysPrt2 of all jobs and leave a message enter the command:

pdclean -m "Printer PhysPrt2 is down for repairs" SUPER1:PhysPrt2

STANDARDS CONFORMANCE

pdclean: POSIX 1387.4

© Hewlett-Packard Development Company, L.P.