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:

    pdpr -n 2 b Contents Body1 Body2 Append ? pdpr -x "copy-count=2" b 
       Contents Body1 Body2 Append
    InfoPrint prints two copies of b, followed by two of Contents, and so forth for each file in the job.

    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.
  • Print multiple copies of a job

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

    pdpr -x "results-profile=::2" b Contents Body1 Body2 Append
    InfoPrint prints a single copy of each file in the job, and then prints a second set in the same manner.

  • Print multiple copies of documents and jobs

    To submit a job to the default logical destination and to 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" b Contents Body1 Body2 Append
    InfoPrint prints three copies of b, followed by three copies of Contents and so until the first copy of the job completes. Then InfoPrint prints a second set in the same manner.

  • Specify job name

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

    pdpr -t CmdRef File1

  • Print a duplexed job

    To submit the file File1 to the default logical destination and to specify normal-duplexed printing, enter the command:

    pdpr -x "sides=2 plex=simplex" File1

  • Specify document format

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

    pdpr -x "document-format=ascii" PSFile2

  • Request status

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

    pdpr -r brief File1
    InfoPrint displays information similar to:
                                 Current     Destination    Destinations 
    Job  ID               Name   State       Requested      Assigned 
    ---  --------------   -----  ---------   -------------  ------------ 
    8    sp15:0754100002  File1  pending     LogPrt1

  • Delay printing

    To submit the file BigJob to the default logical destination and to delay printing until after 6:30 p.m. on May 2, 1997, enter the command:

    pdpr -x "job-print-after='18:30:00 05/02/97'" BigJob

  • Specify a symbolic link

    To submit the file BigJob to a logical destination LogPrt4 without copying the file, enter the command:

    pdpr -p LogPrt4 -l BigJob
    Note: This example only applies to InfoPrint Manager for AIX or InfoPrint Manager for Linux.

  • Specify job discard time

    To submit the file BigJob to the default logical destination and to specify that InfoPrint is to discard the job if it has not printed by 5:00?p.m., enter the command:

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

  • Retain a job

    To submit the file File1 to the default logical destination requesting feedback of job attributes (brief group), and to 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
    Note the job number (local ID) so you can use that number when you want to print more copies in the time allotted.

  • Specify default job and document

    To submit the file File1 to the default logical destination and use the job attribute values specified in the default job ivj23 and the document attribute values specified in the default document ivd44, enter the command:

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

  • Specify attributes files for a job

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

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

  • Specify different attribute values for different documents

    To submit the files File5, File6, and File7 to the default logical destination and to specify that:

    • Each document starts on a new sheet of paper
    • You want to print pages 11 through 20 of File5, all pages of File6, and all pages of File7
    • Each document has a different estimated page count
    enter the command:
    pdpr -x "start-on-new-sheet=true page-select=11:20 page-count=10"
       -f File5 -x "page-select== page-count=3" -f File6
       -x "page-count=19" File7

  • Override an attribute value in an attributes file

    To submit the file File1 to the default logical destination 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

  • Request feedback concerning the job as each event happens

    To submit the file File1 to the default logical destination and to have all possible event notifications sent to you by electronic mail, enter the command:

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

  • Specify destination location

    To submit the file File5 for printing on one of the printer devices located in Building 20, Room 17, enter the command:

    pdpr -d LogPrt20 -x "destination-locations-requested=bld20.rm17" File5

  • Specify a medium

    To submit the file MyAddress to logical destination MServ-lp and to specify a default medium of number-10-envelope for the job, enter the command:

    pdpr -p MServ-lp -x "default-medium=number-10-envelope" MyAddress

  • Specify a command input file

    To submit a job and read the command flags, command attributes, and names of files to be printed from the file pdinput instead of from the command line, enter the command:

    pdpr -Z pdinput

  • Specify a code page for ASCII jobs

    To print the files File1 and File2 and to specify the code page IBM-863, enter the commands:

    pdpr -d LogPrtPSF -x "default-character-mapping=IBM-863" File1 File2

  • Print a range of pages

    To print pages 1 through 10 of the file a.pdf, enter the command:

    pdpr -d FDCSP002 -x "results-profile=::2: image-width=14i 
    image-length=10i page-select=2:4" a.pdf

Suggested reading in hardcopy

For information about: