pdpr command: submits jobs

Syntax

pdpr [-H host:port] [{-d | -p} DestinationName]
[-f FileName]      
[-l] [-nCopyCount] [-NNotificationMethod]     
[-rattribute ] [-sStyleName] [-tJobName]     
[-x"attribute=value"] [-XAttributesFileName]     
[-ZInputFileName] {- | 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 -XAttributesFile 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. 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==

-X AttributesFileName
Specifies the name of a file containing attribute and value pairs that you want InfoPrint to insert at the current point in the command.

Any document attribute in the file 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==

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

-Z InputFileName
Specifies the name of a file containing command flags, command attributes, or the names of files to be printed, that you want InfoPrint to insert at the current point in the command. Use this flag when the command is too long to fit on the command line.

For more information about the format of the InputFileName, see Attributes file.

-
Entering a dash (hyphen) causes the command to read from standard input (STDIN). If you use this flag, it must occur at the end of the command after any other flags or command attributes.
-h
Displays a command-specific help message containing information about command syntax and flags. If you use this flag with any other flag or attribute, InfoPrint recognizes only the -h flag).

Configuration logic

The command determines which server host and server port to use based on this sequence:

  1. Server host and server port specified with the -H parameter.
  2. Server host and server port specified with the PDHOST and PD_SOCKET envirnonment variables.
  3. Uses the defaults for PDHOST=localhost and PD_SOCKET=6874.
Note: This configuration logic enables multiple commands to run on a single machine communicating with one or more InfoPrint Manager servers.

Command attributes

You can specify these attributes in a -x"attribute=value" string or in an attributes file designated with the -XAttributesFileName flag.

attributes=AttributesFileName
Specifies the designated attributes file that InfoPrint reads and inserts at the current point in the command. This file contains attribute and value pairs that InfoPrint uses to expand the command.

Any document attribute in the attributes file affects all files whose names follow that attributes command attribute 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==

headings={true | false} DEFAULT=true
Specifies whether you want InfoPrint to display headings with the attributes.
requested-attributes={none | brief | verbose} DEFAULT=none
Specifies which job attributes you want InfoPrint to display.
none
Displays no attributes.
brief
Displays a small subset of important attributes for each object.
verbose
Displays a larger subset of important attributes for each object.
style={column | doccol | line} DEFAULT=column
Specifies the presentation format in which you want InfoPrint to display the output.
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.

Job and document attributes used with the command

There are two types of object attributes used with the pdpr command, per-job and per-document. You can specify these attributes in a -x"attribute=value" string or in an attributes file designated with the -XAttributesFileName flag. You can specify any initially settable or resettable job or document attribute with the pdpr command. See Attributes for documents and default documents and Attributes for jobs and default jobs for descriptions of job and document attributes. See Chapter 3 of the InfoPrint Manager: Reference, S544-5475, for descriptions of job and document attributes.

  • Per-job attributes

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

  • Per-document attributes

    If you specify some document attributes before the first document (file) on the command line, those attributes apply to all documents (files) you specify for this job. If you specify a different document attribute between the first and second document (files), that attribute applies to the second document and any following document you specify for this job. This progression of attributes to files continues until the last document (file) specified.

    The value for a given attribute must be the same for all the documents in the job except for those listed in Per-document attribute listing. Even for those attributes, the value must be the same for all documents in the job if the documents are in ASCII format.

    The value for a given attribute must be the same for all the documents in the job except for those listed in Per-Document Attribute Listing under Attributes for Documents and Default Documents in Chapter 3 of the InfoPrint Manager: Reference, S544-5475. Even for those attributes, the value must be the same for all documents in the job if the documents are in ASCII format.

Arguments

Use the argument value to identify the name of a file that you want to print. If you specify multiple file identifiers, separate the file identifiers with spaces. Each file becomes a document in the job. Unless you end the command with the - flag, indicating that pdpr is to read from standard input, you must place at least one file identifier without the -f flag at the end of the command.

FileName
Specifies the document that you want to print. Precede the file name by any per-document attributes.

If you specify a multi-document job, and if InfoPrint cannot support one or more of the documents in the job, InfoPrint rejects the job and issues an error message.

Examples

  • Print a job on the default logical destination

    To submit the file File1 to your default logical destination, enter the commands:

    pdpr File1

  • Print a job on a specified logical destination

    To submit the file File1 to the logical destination fred-lp, enter the command:

    pdpr -d fred-lp File1

  • Print a job on a specified actual destination

    To submit the file File5 for printing on actual destination draft-pp, enter the command:

    pdpr -p fred-lp -x "actual-destinations-requested=draft-pp" File5 

    Or if the draft-pp actual destination has its logical-destinations-assigned attribute set to fred-lp:

    pdpr -p draft-pp File 5

  • Print a multi-document job

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

    pdpr File1 File2

  • Print a job

    To print a job on the default logical destination on a specific InfoPrint Manager system. To submit the file File1 to your default logical destination on server infoprint1, communicating on port 6876, enter the command:

    pdpr -H infoprint1:6876 File1

  • Email a job

    To submit the file report.ps to the logical destination mailbox for electronic mailing to julia@kingston, enter the command:

    pdpr -d mailbox -x "email-to-address=julia@kingston 
       subject-text='Status Report'" report.ps

  • Print multiple copies of each document in a job

    To submit a job to the default logical destination and to specify two copies of each file in the job, enter one of these commands: