pdmod(1)

NAME

pdmod — modifies attributes of submitted print jobs

SYNOPSIS

pdmod -h

pdmod [-g] [ -m "MessageText" ] [-n CopyCount] [ -r "RequestedAttributes" ] [-s StyleName] [-t JobName] [ -x "AttributeValuePairs" ] [-X AttributesFileName] LocalJobId ... | GlobalJobId ...

DESCRIPTION

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

You can only modify preprocessing, pending, held, paused, or retained jobs. You cannot modify any jobs that are currently printing.

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

Table 1-1 lists the four modification operators:

Table 1-1. Four Modification Operators:
Operator	Syntax	Description
replace	`attribute=value`	Replaces the entire value of the attribute `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 `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 values `value` from the attribute `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==`	Set the attribute `attribute` to the default values according to the job defaulting-hierarchy. If values are supplied with a reset request, they are ignored.

If you do not specify a value with a replace, add, or remove request, an error is issued and the request to change the attribute value for the object is rejected. Processing continues with the next argument on the command line, if any.

Note: If any modification is not accepted, then the whole request is rejected and the job continues as before.

You must be authorized to modify a job belonging to another person. Use the global job identifier to identify the job belonging to another person.

Options

You can use the following options with the pdmod command:

-g

Turn off headings. This option is equivalent to specifying the command-attribute headings=false.

-h

Display a command-specific help message containing information about command syntax and options. This option cannot be used with another option or with an attribute.

-m "MessageText"

Specify the message you want stored in the job-message-from-administrator attribute. You can use the message to give the reason the job is being modified or to provide other comments. If you do not specify the -m option, 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. This option is equivalent to specifying the command-attribute message.

-n CopyCount

Specify the number of document copies. A copy count of zero (0) is an error. This option is equivalent to the object-attribute copy-count.

-r RequestedAttributes

Specify the attribute values that you want to display for the specified objects.

RequestedAttributes can be none (default), brief, or verbose.

This option is equivalent to the command-attribute requested-attributes.

-s StyleName

Specify the style in which you want the attributes displayed.

StyleName may be column (default), or line.

This option is equivalent to the command-attribute style.

-t JobName

Specify the new name that you want for the job. This option is equivalent to the object-attribute job-name.

-x "AttributeValuePairs"

A single attribute string, consisting of one or more attribute-value pairs. Prefix the attribute value with the = character to replace a value, the += characters to add a value, and the -= characters to remove a value. Use the == characters with no attribute value to set the attribute to its default value.

-X AttributesFileName

The name of a file containing attribute-value pairs to be inserted at the current point in the command line. This option is equivalent to the command-attribute attributes.

Command Attributes

You can specify these attributes in a -x "AttributeValuePairs" string or in an attributes file designated with the -X AttributesFileName option.

attributes=AttributesFileName

Specifies the designated attributes file that HPDPS is to read and insert at the current point in the command line. This file contains attributes and value pairs that HPDPS uses to expand on the command being issued.

headings=Boolean

Boolean can be true (default), or false. Specifies if you want headings displayed.

message="MessageText"

Specify the message that you want stored in the job-message-from-administrator attribute. You can use the message to give the reason the job is being modified or to provide other comments. If you do not specify the message attribute, 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.

requested-attributes=AttributeType

Specify which attributes you want displayed. AttributeType can be none (default), brief, or verbose.

style=StyleName

Specify the presentation format that you want for the displayed output. StyleName can be column (default) or line.

Object Attributes

You can specify these attributes in a -x "AttributeValuePairs" string or in an attributes file designated with the -X AttributesFileName option.

copy-count=number

Specify the number of document copies you want. A copy count of zero (0) is an error.

job-hold=Boolean

Specify whether you want to put the job in a hold state.

Boolean can be true or false (default).

job-name=name

Specify the new name that you want for the job.

Also, you may specify any other settable attributes for the job or document.

Note: You can set the value for a settable attribute with either the pdset or pdmod command.

Arguments

Use the arguments to identify the specific objects that you want to modify. If you specify multiple objects, each must be separated by spaces.

LocalJobId or GlobalJobId: Specify the local or global job identifier. If you modify more than one job with a single command, each must be separated with one or more white spaces.

EXAMPLES

Modify Content Orientation

To modify the job (local id of 10) and change the orientation to landscape, enter the command:

pdmod -x content-orientation=landscape 10 

Modify Job Hold Condition

To modify the job-attribute job-hold to false for job 10, so that the job (which was previously submitted with job-hold set to true) can be scheduled, enter the command:

pdmod -x job-hold=false 10 

Modify Job Comment

To modify the job-attribute job-comment to be "Test Results 100" for job 10, enter:

pdmod -x job-comment="Test Results 100" 10

Modify Number of Sides to be Printed

To modify the document-attribute sides to be 2 for all documents in the global job 1011222243 on server DivSpool2 enter:

pdmod -x sides=2 DivSpool2:1011222243 

To modify the sides document attribute to specify to print documents on both sides for jobs 10 and 20:

pdmod -x sides=2 10 20 

Add a Value

To add the value building47 to the attribute Printer-locations-requested for job 10, enter:

pdmod -x Printer-locations-requested+=building47 10 

Remove a Value

To remove the value building47 from the Printer-locations-requested attribute in my job 10, enter:

pdmod -x Printer-locations-requested-=building47 10 

Reset to Default Values

To reset the job-originator job attribute to the default values in my job 10, enter:

pdmod -x job-originator==10 

Combining Modifications

To modify job 17, notifying the operator, and placing the job on hold, enter the command:

pdmod -x "job-message-to-operator=" 
This job requires blue legal-sized paper.
Please advise when the paper is
available
job-hold=yes
17

STANDARDS CONFORMANCE

pdmod: POSIX 1387.4