pdmod command: modifies attributes of submitted print jobs


pdmod [-H host:port] [-g] [-m "MessageText"] [-n CopyCount] 
[-r attribute …] [-s StyleName] [-t JobName] 
[-x "attribute=value …"] [-X AttributesFileName] 
{LocalJobID … | GlobalJobID …}

pdmod -h


Use the pdmod command to modify the values of job and document attributes of previously submitted jobs.

You can specify any resettable job and document attributes. See the pd_att_job and pd_att_document man pages for descriptions of all job and document attributes.

You can only modify preprocessing, pending, held, paused, or retained jobs. In general, you cannot modify processing or printing jobs. The only exception is if you modify only job-hold=true, the job will be canceled from the printer and then modified.

Modifying an existing job might affect the scheduling of the job.

The next table lists the four modification operators.

pdmod operators

Operator Syntax Description
Replace attribute=value Replaces the entire value of the attribute with value, or if not already present, adds the attribute-value pair to the job.
Add values attribute+=value Adds the value value to the attribute. You cannot add values to single-valued attributes. An add request that duplicates values on a multi-valued attribute has no effect on the job.
Remove values attribute-=value Removes the value value from the attribute. A remove request for a nonexistent value has no effect on the object. A remove request for the last or only value of an attribute is equivalent to a reset-to-default request.
Reset to default attribute== Sets the attribute to the default values according to the job-defaulting hierarchy. If you supply values with a reset request, InfoPrint ignores them.

If you do not specify a value with a replace, add, or remove request, InfoPrint issues an error and rejects the request to change the attribute value for the object.

Note: If InfoPrint does not accept a modification, InfoPrint rejects the whole request and the job continues as before.

Use the global job identifier to identify jobs belonging to another person.

If the ignore-ivo-values attribute is set to true on the server and the request is to default or remove a value and there are no values left for that attribute, InfoPrint Manager ignores the value of the job and document default attribute when setting its value. See the ignore-ivo-values attribute.


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

Turns off headings.

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

-m "MessageText"
Specifies the message you want to store in the job-message-from-administrator attribute. You can use the message to give the reason why you are modifying the job or to provide any ot