pdcreate(1)

NAME

pdcreate — creates print objects

SYNOPSIS

pdcreate -h

pdcreate [-c ObjectClass] [-g] [ -m "MessageText" ] [-r RequestedAttributes] [-s StyleName] [ -x "AttributeValuePairs" ] [-X AttributesFileName] { ServerName : InitialValueDocumentName ... | ServerName : InitialValueJobName ... | ServerName : PrinterName ... | ServerName : QueueName ... }

DESCRIPTION

Use this administrative command, pdcreate, to create print objects (except servers, logs, documents and jobs) and to set their attributes to specific values.

Note: Servers and logs are created when the server is started. Documents and jobs are created when the files are submitted for printing with the pdpr command.

You must submit the pdcreate command to the appropriate server. HPDPS spoolers and supervisors support different sets of object classes.

`Spooler`	`Supervisor`
`document`	`document`
`initial-value-document`	`job`
`initial-value-job`	`log`
`job`	`printer (physical)`
`log`	`server`
`printer (logical)`
`queue`
`server`

You can use the pdcreate command to create objects for the following object classes:

printer (logical and physical)
queue
initial-value-job
initial-value-document

When you create a printer object, it remains in the disabled state so that print jobs cannot be accepted. You must issue the pdenable command to place the printers in an enabled state.

An object you create with the pdcreate command still exists even if the server in which it is contained is terminated normally (shutdown) or abnormally. A logical printer or queue returns to its previous state when its server is restarted. A physical printer attempts to return to its previous state when its server is restarted.

Options

pdcreate accepts the following options:

-c ObjectClass

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

printer (default)
queue
initial-value-job
initial-value-document

You can only specify one class per command invocation. This option is equivalent to specifying the command-attribute class.

-g

Turn off headings. This option is equivalent to specifying the command-attribute headings=false.

-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 that is being created. You may indicate the reason for creating the ObjectClass or provide other comments.

You can list this message by specifying requested-attributes=message with the pdls command. This option is equivalent to specifying the command-attribute message.

-r RequestedAttributes

Specify the attribute values you want displayed for the specified objects. Values can be:

none (default)
brief
verbose

This option is equivalent to specifying the command-attribute requested-attributes.

-s StyleName

Specify the format in which you want the attributes displayed. StyleName can be one of:

column (default)
line

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

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

Command Attributes

You can 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 to be created. Valid object class names are specified in the -c option description. You can only specify one class per command invocation.

force=Boolean

Force the creation of an object. The value can be:

false (default)
true

If you (as an administrator) are authorized and the object already exists, the specified object replaces the existing object and no warning or error messages are returned.

If the designated object already exists and you do not specify force=true, an error is returned and the command is rejected.

headings=Boolean

Specify if you want headings displayed in the output. Boolean can be:

false
true (default)

message="MessageText"

Specify the message that is to be associated with the ObjectClass that is being created. You can use this message to indicate the reason for creating this object or to provide other comments.

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

requested-attributes=AttributeType

Specify which output attributes you want displayed. The command-attribute value can be:

none (default)
brief
verbose

style=StyleName

Specify the presentation format that you want for the displayed output. StyleName can be:

column (default)
line

Object Attributes

You can specify these attributes in a -x "AttributeValuePairs" string or in an attributes file designated with the -X AttributesFileName option.

You can specify any settable or specifiable attribute with the pdcreate command. You can specify an attribute only when creating the object.

Arguments

Use the argument to specify the object to create. If you specify multiple objects, each must be separated by spaces.

Note: Regardless of which object you are creating, you must use ServerName: with the pdcreate command.

Valid argument values you can use are:

ServerName:PrinterName
ServerName:QueueName
ServerName:InitialValueDocumentName
ServerName:InitialValueJobName

EXAMPLES

Create a Queue

To create the queue QUEUE1 on the spooler SPOOL1, enter the command:

pdcreate -c queue SPOOL1:QUEUE1 

Create a Logical Printer

To create the logical printer LogPrt1 on the spooler SPOOL1 and specify the queue that the printer is to be associated with, enter the command:

pdcreate -x "associated-queue=QUEUE1" SPOOL1:LogPrt1 

Create a Physical Printer

To create a physical printer PhyPrt1 in the supervisor SUPER1 and specify the queue that the printer is to be associated with, enter the command:

pdcreate -x "associated-queue=QUEUE1 printer-model=LaserJet3Si  \ 
     attachment-type=tcpip printer-internet-address=15.0.64.97"  \ 
     SUPER1:PhyPrt1 

Create an Initial Value Object (IVO)

To create an initial-value-document called LP3ivd, enter the command:

pdcreate -c initial-value-document -m "Created 11/15/94" \ 
     -x "copy-count=1 document-format=postscript\ 
     sides=1 descriptor='IVD for LogPrt3'" SPOOL1:LP3ivd 

To create an initial-value-job object called MyJobTemplate using the attributes specified in the attributes file named MyJobAttributes, enter the command:

pdcreate -c initial-value-job -X MyJobAttributes  \ 
     server3:MyJobTemplate 

The server server3 must be a spooler; if not, the command is rejected.

Create a Queue and its Notification Profile

To create a notification profile for QUEUE1 in server SPOOL1, enter the command:

pdcreate -c queue -x \ 
     "notification-profile={event-identifiers=job-modified \ 
     queue-status-changed delivery-method=e-mail \ 
     event-comment='This is a modification of job or status event' \ 
     delivery-address=dave@cowboy locale=C}" SPOOL1:QUEUE1 

STANDARDS CONFORMANCE

pdcreate: POSIX 1387.4