.\" $Header:
.TA p
.TH pdcreate 1
.SH NAME
pdcreate \- creates print objects
.SH SYNOPSIS
.tr ~"
.CR pdcreate
.RC [ -c \0\f2ObjectClass \|\f1]
.RC [ -g ]
.RC [ -m \0~\f2MessageText\f4~ \|\f1]
.RC [ -r \0\f2RequestedAttributes \|\f1]
.RC [ -s \0\f2StyleName \|\f1]
.RC [ -x \0~\f2AttributeValuePairs\f4~ \|\f1]
.RC [ -X \0\f2AttributesFileName \|\f1]
.RI [ ServerName: \|\f1] \f2InitialValueDocumentName\f1... |
.RI [ ServerName: \|\f1] \f2InitialValueJobName\f1... |
.RI [ ServerName: \|\f1] \f2PrinterName\f1... |
.RI [ ServerName: \|\f1] \f2QueueName\f1... 
.PP
.tr ~~
.C pdcreate -h
.SH DESCRIPTION
You use the administrative command,
.CR pdcreate ,
to create print objects
(except servers, logs, documents and jobs) and to set their attributes
to specific values.
.PP 
.CR 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 
.C pdpr 
command.
.PP 
You must submit the 
.C pdcreate 
command to the appropriate server.  
.CR HPDPS
spoolers and supervisors support different sets of object classes.
.TS
lw(3i) lw(3i)
l l.
\f3                         \f1

.sp .5v
\f2Spooler	Supervisor\f1
 
document	document
initial-value-document	job
initial-value-job	log
job
log
printer
queue
server
.TE
.\".nf 
.\"|---------------------------------------------------------------|
.\"| Spooler                            | Supervisor               |
.\"|------------------------------------|--------------------------|
.\"|     document                       |     document             |
.\"|     initial-value-document         |     job                  |
.\"|     initial-value-job              |     log                  |
.\"|     job                            |     printer              |
.\"|     log                            |     server               |
.\"|     printer                        |                          |
.\"|     queue                          |                          |
.\"|     server                         |                          |
.\"|---------------------------------------------------------------|
.\".fi
.PP 
You can use the 
.C pdcreate 
command to create objects for the following
object classes:
.PP
 o   
.C printer 
(logical and physical)
 o   
.C queue
 o   
.C initial-value-job
 o   
.C initial-value-document
.PP 
When you create a printer object, it remains in the disabled state so
that print jobs cannot be accepted.  You must issue the 
.C pdenable 
command
to place the printers in an enabled state.
.PP 
An object you create with the 
.C 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.
.PP 
.SS Options
.PP
You can use the following options with the 
.C pdcreate 
command:
.PP 
.TP
.C -c \f2ObjectClass\fP
Specifies the object class you want for this command.
The \f2ObjectClass\fP can be:
.CR printer " (default)," 
.CR queue , 
.CR initial-value-job , 
.CR initial-value-document . 
You can
only specify one class per command invocation.
Using this option is equivalent to specifying the
command-attribute 
.CR class .
.PP 
.TP
.C -g    
Turns off headings.
.br
Using this option is equivalent to specifying the
command-attribute 
.CR headings=false .
.PP 
.TP
.C -h    
Displays a command-specific help message containing information
about command syntax and options.  This option is mutually
exclusive; cannot be used with another option or with an
attribute.
.PP 
.TP
.C "-m ""\f2MessageText\fP"" "
Specifies the message that is to be associated with the 
.CR printer ,  
.CR queue ,  
.CR initial-value-job , 
or 
.CR initial-value-document ,
that is being created.
You may indicate the reason for creating the 
.CR printer , 
.CR queue ,
.CR initial-value-job , 
or
.CR initial-value-document
or provide other comments.
.br 
You can list this message by specifying
.br
.CR requested-attributes=\f2message\fP 
with the 
.C pdls 
command. Using this option is equivalent to specifying the
command-attribute 
.CR message .
.PP  
.TP
.C -r \f2RequestedAttributes\f4
Specifies the attribute values you want displayed for the
specified objects. Values can be:
.CR none " (default),"
.CR brief  
or
.CR verbose .
Using this option is equivalent to specifying the
command-attribute 
.CR requested-attributes .
.PP 
.TP
.C -s \f2StyleName\fP
Specifies the format in which you want the attributes displayed.
\f2StyleName\fP can be either
.CR column " (default)"
or
.CR line .
Using this option is equivalent to specifying the
command-attribute 
.CR style .
.PP 
.TP
.C "-x ""\f2AttributeValuePairs\fP"" "
A single attribute string, consisting of one or more
attribute-value pairs.
.PP 
.TP
.C -X \f2AttributesFileName\fP
The name of a file containing attribute-value pairs to be
inserted at the current point in the command line.
.br
Using this option is equivalent to specifying the
command-attribute 
.CR attributes .
.PP
.SS Command Attributes
.PP
You can specify these attributes in a 
.C -x "\c
"\f2AttributeValuePairs\fP\c"
"
string or in an attributes file designated with the
.C "-X \f2AttributeFileName\fP"
option.
.PP
.TP 
.CR attributes=\f2AttributesFileName\fP
Causes the designated attributes file to be read.
.PP
.TP 
.CR class=\f2ObjectClass\fP
Specifies the \f2ObjectClass\fP to be created. 
Valid \f2ObjectClasses\fP for the 
.C pdcreate 
command are:
.CR printer " (default),"
.CR queue ,
.CR initial-value-job ,
and
.CR initial-value-document. 
You can only specify one class per command invocation.
.PP
.TP 
.CR force=\f2boolean\f4
Forces the creation of an object. Values are:
.CR False " (default)"
or
.CR 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. 
.br
If the designated object already exists and you do not specify
.CR force=true ,
an error is returned and the command is rejected.
.PP
.TP
.CR headings=\f2boolean\f4
Specifies whether you want headings displayed in the output.
The value can be:
.CR true " (default)"
or
.CR false .
.PP
.TP
.C "message=""\f2message text\fP"" "
Specifies the message that is to be associated with the  
.CR printer "," 
.CR queue , 
.CR initial-value-job , 
or
.CR initial-value-document 
that is being created.
You may indicate the reason for creating this object or
provide other comments.
.br
You can list this message by specifying 
.CR requested-attributes=message 
with the 
.C pdls 
command.
.PP
.TP
.CR requested-attributes=\f2AttributeType\f4
Specifies which output attributes you want displayed.
The command attribute value can be:
.CR none " (default),"
.CR brief
or
.CR verbose .
.PP
.TP
.CR style=\f2StyleName\f4
Specifies the presentation format you want for the displayed output.
The value can be:             
.CR column " (default)"  
or
.CR line .
.PP
.SS Object Attributes
You can specify these attributes in a 
.C -x "\c
"\f2AttributeValuePairs\fP\c"
"
string or in an attributes file designated with the 
.C "-X  AttributeFileName"
option.
.PP
You can specify any settable or specifiable attribute with the
.C pdcreate 
command. You can specify an attribute
only when creating the object.
.PP
.SS Arguments
.PP
You use the argument values to identify the specific object to be
created.  If you specify multiple objects, each must be separated
by spaces.
.PP 
.CR Note :  
Regardless of which object you are creating, you must use
\f2ServerName:\fP with the 
.C pdcreate 
command.
.PP 
Valid argument values you can use are:
.PP
\f2ServerName\fP:\f2PrinterName\fP
.br
\f2ServerName\fP:\f2QueueName\fP
.br
\f2ServerName\fP:\f2InitialValueDocumentName\fP
.br
\f2ServerName\fP:\f2InitialValueJobName\fP
.PP
.SH EXAMPLES
.PP
.SS Create a Queue
.PP 
o   To create the queue QUEUE1, on the spooler SPOOL1, enter the command:
.PP 
.C    pdcreate -c queue SPOOL1:QUEUE1
.PP 
.SS Create a Logical Printer
.PP 
o   To create the logical printer LogPrt1 in the spooler SPOOL1 and
specify the queue that the printer is to be associated with, enter
the command:
.PP 
.C    pdcreate -x "associated-queue=QUEUE1" SPOOL1:LogPrt1
.PP 
.SS Create a Physical Printer
.PP 
o   To create an   physical printer PhyPrt1 in the supervisor SUPER1
and specify the queue that the printer is to be associated with,
enter the command:
.PP 
.C    "pdcreate -x ""associated-queue=QUEUE1 printer-model=LaserJet3Si  \
 attatchment-type=tcpip printer-internet-address=15.0.64.97"" SUPER1:PhyPrt1
.PP 
.SS Create an Initial Value Object (IVO)
.PP 
o   To create an initial-value-document called LP3ivd, enter the
command:
.PP 
.C    "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"
.PP 
o   To create an initial-value-job object called MyJobTemplate using the
attributes specified in the attributes file named MyJobAttributes,
enter the command:
.PP 
.C    pdcreate -c initial-value-job -X MyJobAttributes \
    server3:MyJobTemplate
.PP 
The server server3 must be a spooler; if not, the command is rejected.
.PP 
.SS Create a Queue and its Notification Profile
.PP 
o   To create a notification profile for QUEUE1 in server SPOOL1, enter
the command:
.PP 
.C    "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"
.PP
.SH SEE ALSO
To view information about all supported attributes, enter
the command:
.PP
.C man pd_att
.PP
This will display a list of files by object from which you can select
the attribute listing you want.
.PP
See also:
.PP
pdclean(1), pddelete(1), pddisable(1), pdenable(1), pdls(1), pdmod(1),
pdpause(1), pdpr(1), pdpromote(1), pdq(1), pdresubmit(1), pdresume(1), pdrm(1), pdset(1), pdshutdown(1)
.PP
.SH STANDARDS CONFORMANCE
.CR pdcreate ": POSIX 1387.4"
.\" index@\f4pdcreate\f1 \- creates print objects@@@\f3pdcreate(1)\f1
.\" index@\f1creates print objects@@@\f3pdcreate(1)\f1
.\" index@\f1Distributed Print Service, creates print objects@@@\f3pdcreate(1)\f1
.\"
.\" toc@\f3pdcreate(1)\f1:\0\0\f4pdcreate\f1@@@creates print objects
.\"
.\"
.\"
