pdpr(1)

NAME

pdpr — submits print jobs

SYNOPSIS

pdpr -h

pdpr [-f FileName] [-g] [-l] [-n NumberOfCopies] [-N NotificationMethod] [-p LogicalPrinterName] [-r RequestedAttributes] [-s StyleName] [-t JobName] [ -x "AttributeValuePairs" ] [-X AttributesFileName] [FileName ...]

DESCRIPTION

Use the pdpr command to submit print jobs to logical printers. Each print job can contain multiple printable documents and any number of print resources.

The target logical printer name defaults to the value of the PDPRINTER environment variable. You can override the default by specifying the name of another logical printer using the option -p LogicalPrinterName or the per-job-attribute printer-name-requested.

When the print-job request is accepted by the server, it is given a unique global ID (job identifier). The job also has a local ID 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 pdmod, pdrm, or pdls. Anyone else who accesses the job, such as an administrator, must use the global ID.

The values for job and document attributes are derived as follows:

1.: Values specified in the pdpr command using the -x "AttributeValuePairs" option or specified in an attributes file.
2.: The values of an initial-value-job object specified in the job attribute initial-value-job or the values for an initial-value-document object specified in the document attribute initial-value-document.
3.: The values of an initial-value-job object specified in the printer-initial-value-job attribute or the values of an initial-value-document object specified in the printer-initial-value-document attribute of the logical printer the job is submitted to.
4.: Server defaults for required attribute values not specified by the items in 1 through 3.

You must be authorized to submit print jobs to the specified printer if the logical printer is protected.

If the server cannot locate a physical printer (associated with the requested logical printer) supporting the job and document attributes, the job is rejected.

Options

Use the following options with the pdpr command:

-f FileName

Specify a file that you want included in a print job. This option is useful for identifying files whose names begin with a - character.

-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.

-l

Create 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.

Notes: You can make changes to the files after the job is accepted and up to the time the supervisor makes a copy.

You must use caution when using this option because:

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.
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.

-n NumberOfCopies

Specify the number of document copies you want printed. NumberOfCopies can be either 1 (default) or more copies.

If you do not specify the -n option, the copy count defaults to one (1). A copy count of zero (0) is an error. This option is equivalent to specifying the per-document-attribute copy-count.

-N NotificationMethod

Specify the delivery method that you want used in notification of job events. NotificationMethod can be message, email (default), or none.

This option is equivalent to specifying the command-attribute notification-delivery-method.

Note: Using this option and its value causes the notification-profile attribute to be built.

-p LogicalPrinterName

The logical printer to which you want the job submitted. If you do not specify this option, the PDPRINTER environment variable is used to determine the printer. This option is equivalent to specifying the object-attribute printer-name-requested.

-r RequestedAttributes

Identify the attribute values you want displayed for the specified objects. RequestedAttributes can be none (default), brief, or 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 column (default) or line.

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

-t JobName

Specify the name you want to assign to the job. This option is equivalent to specifying the object-attribute job-name.

-x "AttributeValuePairs"

A single attribute string, consisting of one or more attribute-value pairs.

Document attributes defined with the -x option affect all files whose names follow that -x option on the command line, unless the document attributes are reset by using the -x option again.

-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.

-

Causes the command to read from stdin.

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.

headings=Boolean

Specify if you want headings displayed. Boolean can be true (default) or false.

notification-delivery-method=NotificationMethod

Specify the delivery method you want used in notification of job events. NotificationMethod may be message, email (default), or none.

Note: Using this attribute and its value causes the notification-profile to be built.

requested-attributes=AttributeType

Specify which attributes you want displayed. AttributeType is none (default), brief, or verbose.

style=StyleName

Specify the presentation format in which you want the output displayed. StyleName can be column (default) or line.

Object Attributes

There are two types of object attributes for the 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 pdpr command. You can only specify settable attributes with the pdset and pdmod commands.

Per-Job Attributes

Per-job attributes apply to the job as a whole and may occur anywhere in the pdpr command.

printer-name-requested=[ServerName:]PrinterName

Specify the name of a logical printer that you want the job submitted to.

If this attribute-value pair is not specified, the PDPRINTER environment variable is used to determine the printer.

job-name=name

Specify the name of the print job.

Per-Document Attributes

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 stdin file.

The value for a given attribute must be the same for all the documents in the job except for initial-value-document, document-type, and document-comment.

The only per-document attributes an initial-value-document can set are document-type and document-comment.

Note: Per-job attributes can be specified anywhere on the command line. Per-document attributes cannot be set after the final file name.

copy-count=NumberOfCopies

Specify the number of document copies that you want printed. NumberOfCopies can be 1 (default) or number.

If no value is specified, the value of the copy-count attribute defaults to one (1). A copy count of zero (0) is an error.

document-format=format

Specify the format that 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 ascii.

Arguments

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.

[FileName...]

Specify the document that you want printed. You should preceded the file name by any per-document attributes.
If you do not specify a file name or do specify a - (hyphen) as the file name, pdpr reads from stdin.
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.

EXAMPLES

Print a File

To submit the file File1 to your default logical printer, enter one of the following commands:

pdpr File1
pdpr -f File1

To submit the file File1 to the logical printer LogPrt2, enter one of the following commands:

pdpr -p LogPrt2 File1 
pdpr -x printer-name-requested=LogPrt2 File1 

Number of Copies

To submit the file File1 to the default logical printer and to specify three copies of the print job, enter one of the following commands:

pdpr -n 3 File1 
pdpr -x copy-count=3 File3 

To submit the job to the default logical printer and specify two copies of each file with the -n option, enter one of the following commands:

pdpr -n 2 Title Contents Body1 Body2 Append 
pdpr -x copy-count=2 Title Contents Body1 Body2 Append 

HPDPS prints two copies of Title, followed by two of Contents, and so on for each file in the job.

To submit the job to the default logical printer and specify two copies of the complete job, enter the command:

pdpr -x results-profile=:::2 Title Contents Body1 Body2 Append 

HPDPS prints a single copy of each file in the job, and then prints a second set in the same manner.

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:

pdpr -n 3 -x results-profile=:::2 Title Contents Body1 Body2 Append 

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.

Specifying Job Name

To submit the file File1 to your default logical printer and specify the job name, enter the command:

pdpr -t CmdRef File1 

Double-sided Printing

To submit the file File1 to the default logical printer and specify double-sided printing, enter the command:

pdpr -x "sides=2" File1 

Page Orientation

To submit the file File1 to the default logical printer and specify landscape orientation, enter the command:

pdpr -x content-orientation=landscape File1 

Document Format

To submit the file PSFile2 to the default logical printer and specify a document format of ASCII, enter the command:

pdpr -x document-format=ascii PSFile2 

Multiple Documents

To submit the files File1 and File2 to the default logical printer, enter the command:

pdpr File1 File2 

To submit the files File1 and File2 to the default logical printer and specify three copies of each file with double-sided printing, enter the command:

pdpr -n 3 -x sides=2 File1 File2 

Requesting Status

To submit the file File1 to the default logical printer and receive brief status information, enter the command:

pdpr -r brief File1 

HPDPS displays information similar to the following about your job:

			`Current`	`Printer`	`Printers`
`Job`	`ID`	`Name`	`State`	`Requested`	`Assigned`
`8`	`sp15:075410002`	`File1`	`pending`	`LogPrt1`

To submit the file File1 to the default logical printer and receive brief status information without headings, enter one of the following commands:

pdpr -g -r brief File1 
pdpr -x  "headings=no  requested-attributes=brief" File1 

HPDPS displays information similar to the following about your job:

8    sp15:075410002  File1  pending     LogPrt1 

Delay Printing of File

To submit the file BigJob to the default logical printer and delay printing until after 6:30 p.m., enter the command:

pdpr -x job-print-after=18:30:00 BigJob 

Delay Printing of File and Specifying a Symbolic Link

To submit the file BigJob to a logical printer LogPrt4 without copying the file and delay printing until after 6:30 p.m. on April 4, 1995, enter the following command:

pdpr -l -x job-print-after="18:30:00 04/04/95"   BigJob 

Job Discard Time

To submit the file 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:

pdpr -x job-discard-time=17:00:00 BigJob 

Job to a Specific Printer Location

To submit the file File5 to be printed on one of the printer devices located in building 20 room 17, enter the command:

pdpr -p LogPrt20 -x printer-locations-requested=bld20.rm17 File5 

Job to a Specific Physical Printer

To submit the file File5 to be printed on physical printer PhysPrt1, enter the command:

pdpr -p LogPrt20 -x physical-printers-requested=PhysPrt1 File5 

Retaining a Job

To submit the file 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:

pdpr  -r brief -x job-retention-period=90 File1 

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.

Specifying an Initial Value Object (IVO)

To submit the file File1 to the default logical printer and use the job attribute values specified in the initial value job ivj23, enter the command:

pdpr -x initial-value-job=ivj23 File1 

To submit the file File1 to the default logical printer and use the document attribute values specified in the initial value document ivd44, enter the command:

pdpr -x initial-value-document=ivd44 File1 

To submit the file File1 to the default logical printer and use both IVOs specified in the previous two examples, enter the command:

pdpr -x "initial-value-document=ivd44 initial-value-job=ivj23" File1 

Specifying Attributes Files for a Job

To submit the file File1 to the default logical printer and specify the attributes file myjob.att, enter the command:

pdpr -X myjobs.att File1 

To submit the file File5 to the default logical printer and specify the two attributes files (default.att and special.att), enter the command:

pdpr -X default.att -X special.att File5 

Overriding an Attribute Value in an Attributes File

To submit the file File1 to the default logical printer and override the value of 2 for the sides attribute specified in a given attributes file, enter the command:

pdpr -X default.att -x sides=1 File1 

Requesting Feedback Concerning the Job as Each Event Happens

To submit the file File1 to the default logical printer and have all possible event notifications sent to your display screen, enter the command:

pdpr -x "notification-profile={delivery-method=message \ 
     event-identifiers=job-modified class-job-problem \ 
     class-job-attention}" File1 

To submit the file File1 to the default logical printer and have the default event notification sent to you by electronic-mail, enter the command:

pdpr  -x "notification-profile={delivery-method=electronic-mail}" File1 

Specifying a Different Job Owner

To print the files MyFile1 and MyFile2 and specify Marta as the owner of the job, enter the command:

pdpr -x job-owner=Marta MyFile1 MyFile2 

STANDARDS CONFORMANCE

pdpr: POSIX 1387.4