.\" $Header:
.TA p
.TH pdpr 1
.SH NAME 
pdpr \- submits print jobs
.SH SYNOPSIS
.tr ~"
.C pdpr 
.RC [ -f \f2\0FileName\f4 \|\f1]
.RC [ -g \|\f1] 
.RC [ -l \|\f1] 
.RC [ -n \f2\0NumberOfCopies\f4 \|\f1]
.RC [ -N \f2\0NotificationMethod\f4 \|\f1] 
.RC [ -p \f2\0PrinterName\f4 \|\f1]
.RC [ -r \f2\0RequestedAttributes\f4 \|\f1] 
.RC [ -s \f2\0StyleName\f4 \|\f1] 
.RC [ -t \f2\0JobName\f4 \|\f1]
.RC [ -x \f2\0\~AttributeValuePairs\f4~\|\f1] 
.RC [ -X \f2\0AttributesFileName\f4 \|\f1]	
\f2[FileName ...\|\f1]\f4
.tr ~~
.PP
.C pdpr -h
.SH DESCRIPTION
You enter the 
.C pdpr 
command to submit print jobs to logical printers.  Each
print job can contain multiple printable documents and any number of print
resources.
.PP
The target logical printer name defaults to the value of the 
.C PDPRINTER
environment variable.  You can override the default by specifying the name
of another logical printer using the option 
.C -p \f2LogicalPrinterName\f4
or the
per-job-attribute 
.CR printer-name-requested .
.PP
When the 
.C print-job 
request is accepted by the server, it is given a unique
\f2global ID\f4
.ft
(job identifier).  The job also has a \f2local ID\f4 
.ft
that can only be
used by you (the job submitter).  The job submitter can use either the
global ID or the local ID in subsequent commands, such as 
.CR pdmod,  
.CR pdrm , 
or
.CR pdls .   
Anyone else who accesses the job, such as an administrator, must
use the global ID.
.br
The values for job and document attributes are derived from the following:
.PP
1.  Values specified in the 
.C pdpr 
command using the
.C    -x "\c
"\f2AttributeValuePairs\f4\c"
" 
.ft
option or specified in an attributes file.
.PP
2.  The values of an 
\f2initial-value-job\f4
.ft
object specified in the job
attribute 
.C initial-value-job 
or 
the values for an
\f2initial-value-document\f4
.ft
object specified in the document attribute
.CR initial-value-document .
.PP
3.  The values of an 
\f2initial-value-job\f4
.ft
object specified in the
.C printer-initial-value-job 
attribute 
or the values of an
\f2initial-value-document\f4
.ft
object specified in the
.C  printer-initial-value-document 
attribute of the logical printer the
job is submitted to.
.PP
4.  Server defaults for required attribute values not specified by the
items in 1 through 3.
.PP
You must be authorized to submit print jobs to the specified printer if
the logical printer is protected.
.PP
If the server cannot locate a physical printer (associated with the
requested logical printer) supporting the job and document attributes, the
job is rejected.
.PP
.SS Options
You can use the following options with the 
.C pdpr 
command: 
.PP
.TP
.C -f \f2FileName\f4
Specifies a file you want included in a print job.  This option is
useful for identifying files whose names begin with a
.C -
character.
.PP
.TP
.C -g   
Turns off headings.
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 -l   
Creates a job containing pointers (symbolic links) to the job
files rather than taking snapshot copies.  When the job is
assigned to a physical printer and is ready to be printed, the
supervisor uses the pointers in the job to locate the original
files and copies them at that time.  This can be useful when
printing large files or jobs.
.PP
.IP
.CRNotes :
.IP
You can make changes to the files after the job
is accepted and up to the time the supervisor makes a copy.
.IP
You must use caution when using this option because:
.RS
.IP
a. Depending on when you make changes to the files and the 
supervisor copies them, the printed output may or may 
not reflect the changes.
.IP
b. If you delete the file before the job prints or while
the job is being printed, the printed output may fail
or be incomplete.
.RE
.PP
.C -n \f2NumberOfCopies\f1
.ft
.IP
Where 
\f2NumberOfCopies\f1
can be either
.C 1 
(default) or more copies.
.IP
Specifies the number of document copies you want printed.
.IP
If you do not specify the 
.C -n 
option, the copy count defaults to
one (1).  A copy count of zero (0) is an error.
Using this option is equivalent to specifying the
per-document-attribute 
.CR copy-count .
.PP
.C -N \f2NotificationMethod\f1
.ft
.IP
Where \f2NotificationMethod\f1
can be
.CR message ,
.C email
(default), or
.C none.
.IP
Specifies the delivery method that you want used in notification
of job events. Using this option is equivalent to specifying the
command-attribute 
.CR notification-delivery-method .
.IP
.C Note:
Using this flag and its value cause the 
.CR notification-profile
attribute to be built.
.PP
.TP
.C -p \f2LogicalPrinterName\f4
The logical printer to which you want the job submitted.  If you
do not specify this option, the 
.C PDPRINTER 
environment variable is
used to determine the printer.
Using this option is equivalent to specifying the object-attribute
.C printer-name-requested.
.PP
.C -r \f2RequestedAttributes
.ft
.IP
Where \f2RequestedAttributes\f1
can be 
.C none
(default),
.C brief
, or
.C verbose.
.IP
Identifies the attribute values you want displayed for the
specified objects. Using this option is equivalent to specifying the
command-attribute 
.CR requested-attributes .
.PP
.C -s \f2StyleName
.ft
.IP
Where \f2StyleName
.ft
can be
.C column
(default), or
.C line.
.IP
Specifies the format in which you want the attributes displayed.
Using this option is equivalent to specifying the
command-attribute 
.CR style .
.PP
.TP
.C -t \f2JobName\f4
Specifies the name you want to assign to the job.
Using this option is equivalent to specifying the object-attribute
.CR job-name .
.PP
.TP
.tr ~"
.C -x \f2\~AttributeValuePairs\f4\~
.tr ~~
Consists of a single attribute string containing one or more
attribute-value pairs.
.PP
.IP
Document attributes defined with the 
.C -x 
option affect all files
whose names follow that 
.C -x 
option on the command line, unless the
document attributes are reset by using the 
.C -x 
option 
again.
.PP
.TP
.C -X \f2AttributesFileName\f4
The name of a file containing attribute-value pairs you want
inserted at the current point in the command line.
Using this option is equivalent to specifying the
command-attribute 
.CR attributes .
.PP
.C -     
Causes the command to read from 
.CR stdin .
.PP
.SS Command Attributes
You can specify these attributes in a 
.CR -x\0"\c
"\f2AttributeValuePairs\f4\c"
"
.ft
string or
in an attributes file designated with the 
.C -X \f2AttributesFileName\f4
option.
.PP
.TP
.C attributes\f2=AttributesFileName\f4
Causes the designated attributes file to be read.
.PP
.C headings\f2=Boolean
.ft
.IP
Where \f2Boolean
.ft
may equal
.C true 
(default), or
.C false.
.IP
Specifies if you want headings displayed.
.PP
.C notification-delivery-method\f2=NotificationMethod
.ft
.IP
Where \f2NotificationMethod
.ft
may be
.CR message ,
.C email
(default), or
.C none.
.IP
Specifies the delivery method you want used in notification of
job events.
.IP
.C
Note:
Using this attribute and its value causes the 
.C notification-profile
to be built.
.PP
.C requested-attributes\f2=ObjectAttribute
.ft
.IP
Where \f2ObjectAttribute
.ft
may be
.C none
(default),
.C brief
, or
.C verbose.
.IP
Specifies which attributes you want displayed.
.PP
.C style\f2=StyleName
.ft
.IP
Where \f2StyleName
.ft
maybe
.C column
(default), or
.C line.
.IP
Specifies the presentation format in which you want the output
displayed.
.PP
.SS Object Attributes
There are two types of object attributes for the 
.C pdpr 
command (per-job and
per-document) that have some special conditions.  However, you can specify
any settable or specifiable job or document attribute with the 
.C pdpr
command.  You can only specify settable attributes with the 
.C pdset 
and
.C pdmod 
commands.
.PP
.C Per-Job Attributes
.PP
Per-job attributes apply to the job as a whole and may occur anywhere in
the 
.C pdpr 
command.
.PP
.TP
.C printer-name-requested\f2=[ServerName:]PrinterName\f4
Specifies the name of a logical printer you want the job
submitted to.
.PP
.IP
If this attribute-value pair is not specified, the 
.C PDPRINTER
environment variable is used to determine the printer.
.PP
.TP
.C job-name\f2=name\f4
Specifies the name of the print job.
.PP
.C Per-Document Attributes
.PP
The per-document attributes apply to the individual document and precede
the file name of the document that they affect.  If no file name is
specified, the per-document attributes are applied to the 
.C stdin 
file.
.PP
The value for a given attribute must be the same for all the documents in
the job except for 
.CR initial-value-document,  
.CR document-type,  
and
.CR document-comment.   
.PP
The only per-document attributes an
.C initial-value-document 
can set are 
.C document-type 
and 
.CR document-comment .
.PP
.CR Note :   
Per-job attributes can be specified anywhere on the command line.
Per-document attributes cannot be set after the final file name.
.PP
.C copy-count\f2=NumberOfCopies
.ft
.IP
Where \f2NumberOfCopies
.ft
may be
.C 1 
(default), or
.C number.
.IP
Specifies the number of document copies you want printed.
If no value is specified the value of the 
.IP
.C copy-count 
attribute
defaults to one (1).  A copy count of zero (0) is an error.
.PP
.TP
.C document-format\f2=format\f4
Specifies the format you want for the document.
If the value for the document-format attribute is not provided,
HPDPS attempts to determine the correct value for the document
format by reading the file.  If HPDPS cannot determine the
document format, the value for the document-format attribute
defaults to 
.CR ascii .
.PP
.SS Arguments
You use the argument to identify the name of a file to be printed.  If you
specify multiple file names, each must be separated by spaces.  Each file
becomes a document within the job.
.PP
[FileName ...]
.IP
Specifies the document you want printed.  You should preceded
the file name by any per-document attributes.
.br
If you do not specify a file name or do specify a 
.C - 
(hyphen) 
as the file name, 
.C pdpr 
reads from 
.CR stdin.
.br
If you specify a multi-document job, and if any document within the job
cannot be supported, the job is rejected and an error message is
generated.
.SH EXAMPLES
.PP
.SS Print a File
.PP
\(bu   To submit the file 
.C File1 
to your default logical printer, 
enter one of the following commands:
.PP
.C pdpr File1
.PP
.C pdpr -f File1
.PP
\(bu   To submit the file 
.C File1 
to the logical printer LogPrt2, 
enter one of the following commands:
.PP
.C pdpr -p LogPrt2 File1
.PP
.C pdpr -x printer-name-requested=LogPrt2 File1
.PP
.SS Number of Copies
.PP
\(bu   To submit the file 
.C File1 
to the default logical printer and to specify
three copies of the print job, enter one of the following commands:
.PP
.C pdpr -n 3 File1
.PP
.C pdpr -x copy-count=3 File3
.PP
\(bu   To submit the job to the default logical printer and 
specify two copies of each file with the 
.C -n 
option, enter one of the following commands:
.PP
.C "pdpr -n 2 Title Contents Body1 Body2 Append"
.PP
.C "pdpr -x copy-count=2 Title Contents Body1 Body2 Append"
.PP
HPDPS prints two copies of Title, followed by two of 
Contents, and so on for each file in the job.
.PP
\(bu   To submit the job to the default logical printer and specify two
copies of the complete job, enter the command:
.PP
.C pdpr -x results-profile=:::2 Title Contents Body1 Body2 Append
.PP
HPDPS prints a single copy of each file in the job, 
and then prints a second set in the same manner.
.PP
\(bu	To submit the job to the default logical printer and 
specify two
copies of the complete job with each copy of the job containing 
three copies of each file, enter the command:
.PP
.C pdpr -n 3 -x results-profile=:::2 Title Contents Body1 Body2 Append
.PP
There are printed three copies of Title, followed by three copies 
of Contents and so until the first copy of the job is done.
HPDPS prints a second set in the same manner.
.PP
.SS Specifying Job Name   
.PP
\(bu   To submit the file 
.C File1 
to your default logical printer and 
specify the job name, enter the command:
.PP
.C pdpr -t CmdRef File1
.PP
.SS Duplex Printing 
.PP
\(bu   To submit the file 
.C File1 
to the default logical printer and 
specify normal-simplexed printing, enter the command:
.PP
.C "pdpr -x ""sides=2 plex=simplex"" File1"
.PP
\(bu   To submit the file 
.C File1 
to the logical printer LogPrt 
and specify duplexed printing, enter the command:
.PP
.C "pdpr -p LogPrt -x ""sides=2 plex=duplex"" File1"
.PP
.SS Page Orientation     
.PP
\(bu   To submit the file 
.C File1 
to the default logical printer 
and specify landscape orientation, enter the command:
.PP
.C pdpr -x content-orientation=landscape File1
.SS Document Format	
.PP
\(bu   To submit the file PSFile2 to the default logical printer 
and specify a document format of ASCII, enter the command:
.PP
.C pdpr -x document-format=ascii PSFile2
.PP
.SS Multiple Documents     
.PP
\(bu   To submit the files 
.C File1 
and 
.C File2 
to the default logical printer,
enter the command:
.PP
.C pdpr File1 File2
.PP
\(bu   	To submit the files 
.C File1 
and 
.C File2 
to the default logical 
printer and specify three copies of each file with double-sided printing, 
enter the command:
.PP
.C "pdpr -n 3 -x sides=2 File1 File2"
.PP
.SS Requesting Status    
.PP
\(bu	To submit the file 
.C File1 
to the default logical printer 
and receive brief status information, enter the command:
.PP
.C pdpr -r brief File1
.PP
HPDPS displays information similar to the following about your job:
.PP
.nf
                                     Current     Printer      Printers
         Job  ID              Name   State       Requested    Assigned
         ---  --------------  -----  ---------   -----------  ----------
         8    sp15:075410002  File1  pending     LogPrt1
.fi
.PP
\(bu   	To submit the file 
.C File1 
to the default logical printer and 
receive brief status information without headings, enter one 
of the following commands:
.PP
.C pdpr -g -r brief File1
.PP
.C "pdpr -x  ""headings=no  requested-attributes=brief"" File1"
.PP
HPDPS displays information similar to the following about your job:
.PP
.nf
    8    sp15:075410002  File1  pending     LogPrt1
.fi
.PP
.SS Delay Printing of File
.PP
\(bu   	To submit the file 
.C BigJob 
to the default logical printer 
and delay printing until after 6:30 p.m., enter the command:
.PP
.C pdpr -x job-print-after=18:30:00 BigJob
.PP
.SS "Delay Printing of File and Specifying a Symbolic Link"
.PP
\(bu   To submit the file 
.C BigJob 
to a logical printer LogPrt4 without copying
the file and delay printing until after 6:30 p.m. on April 4, 1995,
enter one of the following command:
.PP
.C pdpr -l -x job-print-after="18:30:00 04/04/95"   BigJob
.PP
.SS Job Discard Time      
.PP
\(bu   To submit the file 
.C BigJob 
to the default logical printer 
and specify that the job is to be discarded if it has not 
printed by 5:00 p.m., enter the command:
.PP
.C pdpr -x job-discard-time=17:00:00 BigJob
.PP
.SS Job to a Specific Printer Location
.PP
\(bu   To submit the file File5 to be printed on one of 
the printer devices
located in building 20 room 17, enter the command:
.PP
.C "pdpr -p LogPrt20 -x printer-locations-requested=bld20.rm17 File5"
.PP

.SS Job to a Specific Physical Printer
.PP
\(bu   To submit the file File5 to be printed on physical printer PhysPrt1,
enter the command:
.PP
.C "pdpr -p LogPrt20 -x physical-printers-requested=PhysPrt1 File5"
.PP
.SS Retaining a Job             
.PP
\(bu   To submit the file 
.C File1 
to the default logical printer, request 
feedback of job attributes (brief group), and specifying a retention period 
of 90 minutes so you can print more copies after you have looked at the 
first copy, enter the command:
.PP
.C pdpr  -r brief -x job-retention-period=90 File1
.PP
You want to note the job number (local ID) so you can use that number
when you want to print more copies within the time allotted.
.PP
.SS Specifying an Initial Value Object (IVO)
.PP
\(bu   To submit the file 
.C File1 
to the default logical printer and use the
job attribute values specified in the initial value job ivj23, enter
the command:
.PP
.C pdpr  -x initial-value-job=ivj23 File1
.PP
\(bu   To submit the file 
.C File1 
to the default logical printer and use the
document attribute values specified in the initial value document
ivd44, enter the command:
.PP
.C pdpr  -x initial-value-document=ivd44 File1
.PP
\(bu   To submit the file 
.C File1 
to the default logical printer and use both
IVOs specified in the previous two examples, enter the command:
.PP
.C "pdpr  -x ""initial-value-document=ivd44 initial-value-job=ivj23"" File1"
.PP
.SS Specifying Attributes Files for a Job
.PP
\(bu   To submit the file 
.C File1 
to the default logical printer and specify
the attributes file 
.C myjob.att
, enter the command:
.PP
.C pdpr  -X myjobs.att File1
.PP
\(bu   To submit the file File5 to the default logical printer and specify
the two attributes files (
.C default.att 
and 
.C special.att
), enter the command:

.PP
.C pdpr  -X default.att -X special.att File5
.PP
.SS Overriding an Attribute Value in an Attributes File
.PP
\(bu   To submit the file 
.C File1 
to the default logical printer and override
the value of 2 for the 
.C sides 
attribute specified in a given attributes
file, enter the command:
.PP
.C pdpr -X default.att -x sides=1 File1
.PP
.SS "Requesting Feedback Concerning the Job as Each Event Happens"
.PP
\(bu   To submit the file 
.C File1 
to the default logical printer and have all
possible event notifications sent to your display screen, enter the
command:
.PP
.C "pdpr -x ""notification-profile={delivery-method=message event-identifiers=job-modified class-job-problem class-job-attention}"" File1"
.PP
\(bu   To submit the file 
.C File1 
to the default logical printer and have the
default event notification sent to you by electronic-mail, enter the
command:
.PP
.C "pdpr  -x ""notification-profile={delivery-method=electronic-mail}"" File1"
.PP 
.SS Specifying a Different Job Owner
.PP
\(bu   To print the files 
.C MyFile1 
and 
.C MyFile2 
and specify 
.C Marta 
as the owner
of the job, enter the command:
.PP
.C pdpr -x job-owner=Marta MyFile1 MyFile2
.PP
.SH SEE ALSO
pdclean(1), pdcreate(1), pddelete(1), pddisable(1), pdenable(1), pdls(1), pdmod(1),
pdpause(1), pdpromote(1), pdq(1), pdresubmit(1), pdresume(1), pdrm(1), pdset(1),
pdshutdown(1)
.PP
For information about:
.PP
\(bu   Headings, see 
.C pdls 
command-attribute 
.C style
.PP
\(bu   Requested attributes, see 
.C pdls 
command-attribute 
.C requested-attributes
.PP
\(bu   Style, see 
.C pdls 
command-attribute 
.C style 
.PP
\(bu   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
.SH STANDARDS CONFORMANCE
.CR pdpr ": POSIX 1387.4"
.\" index@\f4pdpr\f1 \- submits print jobs@@@\f3pdpr(1)\f1
.\" index@\f1submits print jobs@@@\f3pdpr(1)\f1
.\" index@\f1HP Distributed Printer System, submits print jobs@@@\f3pdpr(1)\f1
.\"
.\" toc@\f3pdpr(1)\f1:\0\0\f4pdpr\f1@@@submits print jobs
.\"
.\"
.\"
