pdmod command: modifies attributes of submitted print jobs

Syntax

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

pdmod -h

Description

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.

Flags

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.

-g
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 other comments. If you do not specify the -m flag, the message already stored with the job remains unchanged.

You can list this message by specifying requested-attributes=job-message-from-administrator with the pdls command.

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

-n CopyCount
Specifies the number of document copies.

Using this flag is equivalent to specifying the object attribute copy-count.

-r {none | brief | verbose} DEFAULT=none
Specifies the attribute values you want to display for the specified object.
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 equivalen