pdresubmit command: resubmits jobs

Syntax

pdresubmit [-H host:port] [-c ObjectClass] [-g] [-i][-r "RequestedAttribute …"] 
[-s StyleName] 
[-x "attribute=value …"] [-X AttributesFileName] 
[ServerName:]TargetLogicalDestinationName 
{LocalJobID … | GlobalJobID … | 
[ServerName:]QueueName … | 
[ServerName:]DestinationName …}

pdresubmit -h

Description

Use the pdresubmit command to resubmit an existing job to a specific logical destination. The logical destination can be in the same server as the logical destination to which the job was first submitted or a different server. You can only resubmit jobs that have the current job state of held, pending, retained, or unknown.

If the logical destination specified is in a different server, the old server resubmits the job with all of its current attributes to the new server. InfoPrint includes any default attributes associated with the old server so that the new job remains as similar as possible to the old job. If the new server accepts the job, it assigns a new global job identifier and the old global job identifier becomes not valid.

When you specify the -i flag, InfoPrint Manager deletes all the attributes with values in the default job and default document referenced by the current logical destination attributes destination-initial-value-job and destination-initial-value-document from the job and the job documents. The InfoPrint Manager server updates the job and document objects with the attribute values from the target destination default objects.

Logical destinations and queues can also be arguments for this command. If a logical destination is the argument, InfoPrint resubmits all of the jobs submitted to the old logical destination to the specified new logical destination. If a queue is the argument, InfoPrint resubmits all of the jobs in the old queue to the specified logical destination. InfoPrint validates all of the resubmitted jobs again. If the newly specified logical destination does does not support them, they remain in the queue that they were in originally.

If the new logical destination cannot accept the job for some reason, InfoPrint issues an error message and the job stays where it was.

    Note:
  1. InfoPrint does not change the global job identifier for the job if you resubmit the job to a logical destination on the same server.
  2. InfoPrint changes the global job identifier for the job if you resubmit the job to a logical destination on a different server. However, if you are the job-owner, you can still use the same local job identifier.
  3. The resubmit job request is rejected if the move is to another server and the document format is dpf-ipds.

Flags

You can use these flags with the pdresubmit 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.

-c {job | queue | destination} DEFAULT=job
Specifies the object class that you want for this command. In the valid classes, destination only applies to logical destinations.

Using this flag is equivalent to specifying the command attribute operation-class.

-g
Turns off headings.

Using this flag is equivalent to specifying the command attribute headings=false.

-i
Resets the job and document attributes default values.

Using this flag is equivalent to specifying the command attribute ignore-ivo=true.

When the target destination is on the same server, these apply:

  • Before moving the job to the new destination, InfoPrint Manager does not delete the document-format attribute from the job documents attributes.
  • The InfoPrint Manager server does not update the job-scheduling attribute. The job-scheduling attribute indicates how the associated job is scheduled.
  • InfoPrint Manager server attempts to recalculate job-page-count and total-job-octets attributes.
  • InfoPrint Manager server sets a retention period attribute only if one is not already set in the job. The retention period attributes are job-retain-until (Job only), job-retention-period and retain-forever.

-r {none | brief verbose} DEFAULT=none
Specifies the group of attributes you want InfoPrint to display for the specified job, queue, or destination.
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.

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, this flag 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.

-x "attribute=value …"
Consists of a single attribute string, containing one or more attribute-value pairs.
-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.

Using this flag is equivalent to specifying the command attribute 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 …" or in an attributes file designated with the -X AttributesFileName 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.