Delete the initial-value-job called ivj1 from big-spooler

pddelete -c initial-value-job big-spooler:ivj1 3. Delete the queue called centralq from the default spooler.

pddisable -c queue centralq pddelete -c queue centralq

PDDELETE

6. pddisable

Name

pddisable - disable a printer, server, or queue.

Synopsis

pddisable [-c class_name] [-m message_text] [-x extended_attribute_string ... ]

[-X attribute_filename ... ]object_instance ...

Use this command to display help about pddisable.

pddisable -h

Description

Use the pddisable command to disable the acceptance of new print jobs on the specified printers, queues, or servers.

Until the pdenable command is used, print jobs submitted by the pdpr or pdresubmit commands are not accepted by that object. The specified object continues to respond to other commands.

You can invoke pddisable on printer, queue, and server objects only.

If you specify any other object or an invalid object, an error results.

Specifying an object that is already disabled also results in an error.

Note: The state of a disabled server, printer, or queue will still be indicated as ready because enabled/disabled is not a state.

• When the object to be disabled is a printer,

— If it is a logical printer, new print job requests are not accepted and the name of the printer is removed from the logical-printers-ready attribute for the associated queue and spooler.

— If it is a physical printer, the printer will not request new print jobs; however, any jobs currently printing or processing are completed. The name of the printer is removed from the physical-printers-ready attribute on the supervisor. If a queue is associated with the printer, the physical-printers-ready attributes for the queue and spooler are also updated, as well as the printers-ready attribute on all associated logical printers.

PDDISABLE

• When the object to be disabled is a queue,

— The printer-state attribute of associated logical printers is not changed.

— A pdpr command for any logical printer associated with the queue returns an error.

• When the object to be disabled is a server,

— When the server is a spooler, all new jobs are rejected, but previously submitted jobs are scheduled and delivered to physical printers.

— When the server is a supervisor, the supervisor will no longer request jobs from the spooler. Jobs already being processed by the supervisor are allowed to complete.

access level Operator

Options

The following options are supported for pddisable.

-c class_name

Specifies the class, or type, of object you are disabling.

arguments The values allowed for class_name are the following:

• printer (This is the default.)

• server

• queue

Note: The Operands section describes the object_instance that is associated with each class.

If you use the -x string option or the -X file option, the comparable attribute type and value is the following:

class=class_name

PDDISABLE

-m message_text

Use this option to include a message about the printer, queue, or server that you are disabling. For example, when a printer is to be disabled the message attached to the printer might be:

-m "Printer1 not accepting jobs."

If you use the -x extended_attribute_string option or the -X

attribute_filename option in the pddisable command, the comparable client attribute type and value is the following:

message=message_text The option will look like this:

-x "message='Printer1 not accepting jobs' "

To retrieve a message of this type, use the pdls command, specify the printer, queue, or server, and include the following option:

-r message

-x extended_attribute_string

Use this option to build a series, or string, of attribute=value pairs on the command line that will be implemented when pddisable is executed.

attributes Object attributes cannot be used in the -x option.

The following client attributes can be used:

• attributes

• class

• message

syntax Follow the syntax rules for attribute value strings, listed in the Overview chapter of the PrintXchange Command Line Interface Reference Guide.

Note: You can produce the same result by including the

extended_attribute_string in an attribute file and identifying that file as the attribute_filename in the -X option.

-X attribute_filename

The -X option identifies an attribute file to be read by the command.

When the pddisable command executes, the attribute data included in the file is processed at the current point in the command line as though it had been specified with the -x option.

attributes Object attributes cannot be used in the -X option. Refer to the -x section for a list of the client attributes that may be used.

Note: Refer to the Overview chapter of the PrintXchange Command Line Interface Reference Guide for information on developing an attribute file.

PDDISABLE

Operands

The value of the object_instance in the operand is based on the value of the -c class_name option or the class=class_name attribute.

printer_name ... When class is printer, the value of printer_name is the name of the logical or physical printer to be disabled.

queue_name ... When

class is queue, the value of queue_name is the name of the queue to be disabled.

server_name ... When class is server, the value of [server_name:] is the name of the spooler or supervisor to be disabled.

Examples

1. Disable both printer1 and printer2 printers. The printers can be