pdpr command: submits jobs

Syntax

pdpr [-H host:port] [{-d | -p} DestinationName]
[-f FileName ...]  
[-l] [-n CopyCount] [-N NotificationMethod] 
[-r attribute ...] [-s StyleName] [-t JobName] 
[-x "attribute=value ..."] [-X AttributesFileName] 
[-Z InputFileName] {- | FileName ...}


pdpr -h

Description

Use the pdpr command to submit jobs to destinations. Each job can contain multiple printable documents and, for jobs sent to PSF physical printers, or email destinations, any number of resources.

With InfoPrint Manager for AIX or InfoPrint Manager for Linux, the target destination name defaults to the value of the PDPRINTER environment variable. You can override the default by specifying the name of another destination using the -d or -p flag or the job attribute destination-name-requested.

When the server accepts the job request, InfoPrint assigns a unique global ID (job identifier) and a local ID to it. Only the job submitter can use the local ID. 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.

InfoPrint sets the values for job and document attributes from these possibilities:

  1. Values specified in the pdpr command using the -x "attribute=value ..." flag or the -X AttributesFile flag.
    Note: If multiple values for the same attribute are specified in the pdpr command, InfoPrint uses the last value read, except for those attributes that can have different values for different documents in the same job.
  2. The values of a default job specified by the job attribute initial-value-job or the values for a default document specified by the document attribute initial-value-document.
  3. The values of a default job specified by the destination-initial-value-job attribute or the values of a default document specified by the destination-initial-value-document attribute of the logical destination to which the user submitted the job.
  4. Server defaults for required attribute values not specified through the previous methods.

You must be authorized to submit jobs to the specified destination if the logical destination is protected (the value of its authorize-jobs attribute is true).

If the server cannot locate an actual destination (associated with the requested logical destination) supporting the job and document attributes, InfoPrint rejects the job.

Flags

You can use these flags with the pdpr command:

-H host:port

Identifies the host and port of the InfoPrint Manager server used for communication. When not specified, the command follows the Configuration logic to define the host and socket.

-d TargetDestinationName
The target destination can be either the actual destination name if logical-destination-assigned is set on the actual destination or the logical destination name to which you want to submit the job.

With InfoPrint Manager for AIX or InfoPrint Manager for Linux, if you do not specify this flag (or the equivalent -p flag), InfoPrint uses the PDPRINTER environment variable to determine the destination.

Using this flag is equivalent to specifying the destination-name-requested attribute.

-f FileName
Specifies files you want included in the job. Use this flag only with file identifiers that are not placed at the end of the command. For example, to print all pages of file1 and pages 3 through 6 of file2, enter:
pdpr -f file1 -x page-select=3:6 file2
-l
Creates symbolic links to the job files rather than making temporary copies when used with InfoPrint Manager for AIX or InfoPrint Manager for Linux. When InfoPrint assigns the job to an actual destination, the server uses the links to the job files to locate the original files and copies them (if needed) at that time. This can be useful when printing large files or jobs.
    Note:
  1. Use this flag only for jobs submitted locally to AIX or Linux servers; you cannot use it when submitting jobs from a workstation client or to a Windows server.
  2. When InfoPrint Manager job encryption is enabled, this flag is ignored.
  3. You must use caution when using this flag because:
    1. Depending on when you make changes to the files and when the server prints them, the printed output might or might not reflect the changes.
    2. If you delete the file before the job prints or while the job is printing, the printed output might fail or be incomplete.
    3. When you are using an AIX or Linux client and sending a pdpr command with PDHOST or -H flag, you cannot specify the -l flag.
-n {1 | CopyCount} DEFAULT=1
Specifies the number of document copies that you want to print.

If you do not specify the -n flag, the copy count defaults to one (1).

Using this flag is equivalent to specifying the document attribute copy-count=CopyCount.

Note: You cannot use the -n flag or the document attribute copy-count if the job contains inline resources. Use the job attribute results-profile instead.
-N {message | email | job-log| none} DEFAULT=message
Specifies the delivery method that you want to use for notification of job events for this job.
Note: Using this flag and its value causes InfoPrint to generate a notification-profile attribute value for this job.
-p TargetDestinationName
The target destination can be either the actual destination name if logical-destination-assigned is set on the actual destination or the logical destination name to which you want to submit the job.

With InfoPrint Manager for AIX or InfoPrint Manager for Linux, if you do not specify this flag (or the equivalent -d flag), InfoPrint uses the PDPRINTER environment variable to determine the destination.

Using this flag is equivalent to specifying the destination-name-requested attribute.

-r {none | brief | verbose} DEFAULT=none
Identifies the job attribute values that you want to display for the job just created.
none
Displays no attributes.
brief
Displays a small subset of important attributes for the job.
verbose
Displays a larger subset of important attributes for the job.

Using this flag is equivalent to specifying the command attribute requested-attributes.

-s {column | doccol | line} DEFAULT=column
When combined with the -r flag or the requested-attributes command attribute, specifies the format in which you want the attributes displayed.
column
Attribute values are displayed in tabular format, so that values of the same attribute for multiple objects line up in columns.
doccol
For jobs only, job attribute values and the document attribute values for the first document in the job are displayed in column format on the same line.
line
Each attribute is displayed on a separate line.

Using this flag is equivalent to specifying the command attribute style.

-t JobName
Specifies the name you want to assign to the job.

Using this flag is equivalent to specifying the job attribute job-name.

-x "attribute=value ..."
Consists of a single attribute string containing one or more attribute-value pairs.

Any document attribute defined with the -x flag affects all files whose names follow that -x flag on the command line, unless you reset that attribute.

To reset an attribute to the default value, specify AttributeName==. For example, to reset the document-type attribute to its default value, printable, specify

document-type==<