Remove all jobs currently in the queue named central, on the spooler named big-spooler

pdclean -c queue big-spooler:central

4. pdcreate

Name

pdcreate - create a printer, queue, job, or initial-value-document.

Synopsis

pdcreate [-c class_name] [-g] [-m message_text] [-r requested_attributes] [-s style_name]

[-x extended_attribute_string ... ]

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

Use this command to display help about pdcreate.

pdcreate -h

Description

Use the pdcreate command to create a logical printer, physical printer, queue, initial value job, or initial value document object.

Consider the following items when using this command:

• The new object is permanent and remains in place after shutdown and restart operations.

• NameSpace considerations:

— When creating printers or queues, the command will fail if an object of the same name already exists in the Name Service, even if the object is of a different class.

— In the Windows NT environment:

— For PrintXchange Name Service, the name is automatically registered with the Name Service.

PDCREATE

— In the UNIX environment:

— In the Local File environment, the administrator must propagate the change throughout the network since the object name is only added to the Local File NameSpace of the current host issuing the pdcreate command.

— In the NIS environment, the administrator must manually add a new printer to the NIS NameSpace database (printers.conf.byname) and communicate this change throughout all the NIS servers operating in the same domain.

• You can set the values of attributes in the pdcreate command.

Note: You can also use the pdset command to assign values to attributes.

• When creating a physical printer:

— The new printer is created within a supervisor and initialized as disabled (enabled=no).

— A supervisor must be available that can support the connectivity attributes of the new printer. Refer to the PrintXchange System Administration and Operations Guide for details on connectivity support for the Xerox and Reference Supervisors.

— Use a printer attribute file (paf) which contains the connectivity attributes required for the new printer. For example, use the following command to create a physical printer object for an HP LaserJet IIISi printer:

— pdcreate -c printer -X HP_LaserJetIIISi_Level1PS.paf supervisor_name:printer_name

— The two attributes required when creating a physical printer are: printer-model and printer-name.

— The associated-queue and printer-address attributes are required in order to enable the physical printer. If not specified during pdcreate, they need to be added via pdset before pdenable.

— The supervisor automatically updates its physical-printers-supported attribute to acknowledge the new printer.

— The pdcreate command fails if the command line includes

PDCREATE

• When creating a logical printer:

— The new printer is created within a spooler and initialized as disabled (enabled=no). Perform a pdenable on the printer to start accepting print requests.

— The spooler automatically updates its logical-printers-supported attribute to acknowledge the new printer.

— The command fails if the command line includes the job or the printer-initial-value-document attribute and the object specified by the attribute does not exist.

— If you include the copy-from=copy_object_instance attribute, the attribute values of the copied logical printer are used as the initial values of the new logical printer. Both the copied object and the new object must reside on the same spooler.

• When creating a queue:

— The initial state of the new queue is disabled and new jobs are not accepted. Use the pdenable command to enable the new queue to start accepting jobs.

— The queues-supported attribute for the spooler is updated to acknowledge the presence of the new queue.

— If you include the copy-from=copy_object_instance attribute, the attribute values of the copied queue are used as the initial values of the new queue. Both the copied object and the new object must reside on the same spooler.

• When creating an initial-value-job:

— A new object is created within the default spooler if a specific spooler name is not included in the object instance.

— An initial-value-job is used by a logical printer. It can also be used as part of a pdpr command.

— If you include the copy-from=copy _object_instance attribute, the attribute values of the copied object are used as the initial values of the new object. Both must reside on the same spooler.

— After the initial-value-job has been created, one of the following commands must be used to associate it with a logical printer:

— If the logical printer already exists, perform a pdset on the printer to set the printer-initial-value-job attribute to the initial-value-job that you just created.

— If the logical printer does not exist, use pdcreate to create a new one. Include the printer-initial-value-job attribute, with the values set to the name of the initial-value-job that you just created.

PDCREATE

• When creating an initial-value-document:

— The new object is created within the default spooler if a specific spooler name is not included in the object instance.

— An initial-value-document can be used as part of the pdpr command.

— If you include the copy-from=copy_object_instance attribute, the attribute values of the copied object are used as the initial values of the new object. Both must reside on the same spooler.

— After the object has been created, one of the following commands must be used to associate it with a logical printer:

— If the logical printer already exists, perform a pdset on the printer to set the printer-initial-value-document attribute to the initial-value-document that you just created.

— If the logical printer does not exist, use pdcreate to create a new one. Include the printer-initial-value-document attribute, with the value set to the name of the initial-value-document that you just created.

access level Administrator

Options

The following options are supported for pdcreate.

-c class_name

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

arguments The values allowed for class_name are the following:

• printer (This is the default.)

• queue

PDCREATE

-g

Use this option to omit line or column headings.

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

headings=no

-m message_text

Use this option to include a message about the object that you are creating. For example, when a queue is to be created, the message attached to the new queue might be:

-m "Queue2 will soon be accepting jobs."

If you use the -x extended-attribute-string option or the -X

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

message=message_text The option will look like this:

-x "message = 'Queue2 will soon be accepting jobs.' "

To retrieve a message of this type, use the pdls command, specify the object, and include the following option:

-r message