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:
- 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.
- 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.
- 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.
- 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 offile2
, 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:
- 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.
- When InfoPrint Manager job encryption is enabled, this flag is ignored.
- You must use caution when using this flag because:
- 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.
- If you delete the file before the job prints or while the job is printing, the printed output might fail or be incomplete.
- 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==<