4 Managing Your Print Job

This chapter explains how to check the status of, modify, cancel, and resubmit a print job.

4.1 Checking the Status of Your Job

Use the pdq command to request a list of jobs that you have submitted to a logical printer. This information can cover one or all jobs you have submitted and that are currently residing in the queue associated with the printer.

The pdq command writes the report to standard output.

If a printer is not specified, pdq lists jobs on the printer named as the PDPRINTER environment variable.

The returned list of jobs is displayed in the order in which the jobs are scheduled to print.

As an end user, you can view only the jobs that you own.

For example, to list all of your jobs in the queue associated with the default logical printer:

$ pdq

To list all of your jobs in the queue associated with logical printer bulldog, enter:

% pdq -p bulldog

When you use the pdq command to request status information, the command displays the following job attributes:

Job identifier (the server name and a number generated by the server)

Job name

Current job state

Number of intervening jobs ahead of yours in the queue

Logical printer requested

Physical printer assigned

4.1.1 Job States

Part of the information returned by the pdq command is the job's current state. Table 4-1 describes possible job states.

Table 4-1: Job States

State	Description
completed	The job completed printing or was canceled.
held	The job is being held until the `job-hold` attribute is set to no.
paused	The job was paused via the `pdpause` command.
pending	The job is waiting to be scheduled.
printing	The job is printing now.
processing	The job is scheduled for printing and is awaiting a connection to the physical printer.
retained	The job completed printing or failed. The job, its attributes, and data are being retained until a specified period of time elapses. During the retention period, you can resubmit the print job.
terminating	The job has been canceled. The supervisor is terminating its connection to the physical printer.

4.1.2 Displaying a Detailed List of Your Job's Attributes

To display a detailed list of your job's attributes, use the pdq command with the -r verbose option. For example, to display the verbose set of job attributes associated with job 123 on logical printer bulldog, spooler dogear_spl, enter:

$ pdq -p bulldog -r verbose dogear_spl:123

To display a list of your job's attributes including document attributes, use the pdls command and specify -x scope=1. For example, to display the verbose set of job and document attributes associated with job 123, enter:

$ pdls -c job -r verbose -x "scope=1" dogear_spl:123

To request all of a job's attributes, including many that are not displayed when you specify verbose, use the -r all option. Use the -s line option to display one attribute per line.

% pdls -c job -r all -s line dogear_spl:123

4.1.3 Requesting Job Error Information

If your job has not printed correctly you might be able to retrieve additional information by using the pdls command to request certain attributes. The job attributes that pertain to job errors are current-job-state, job-state-reasons, and job-state-message.

For example, to request job error information about job 1547 on the default server, enter:

$ pdls -c job \
-r "job-id current-job-state job-state-reasons \ job-state-message" 1547

If you suspect a problem with the printer device, you may be able to get additional information by requesting certain physical printer attributes.

Determine which physical printer was assigned your job.

Determine whether the job was assigned to a physical printer, and if so, which one.
```
$ pdls -c job -r printers-assigned 1547
```

If a printer name is displayed, for example, bulldog2_pp request information about that physical printer:
```
$ pdls -c printer -r\ 
"printer-state printer-problem-message" bulldog2_pp
```

If no name was returned for the value of the printers-assigned attribute, then the job has not yet been scheduled to print.

If the state is pending, there might be a job or document attribute that cannot be satisfied with the current set of physical printers. You might need to request help from an administrator to check that all required printer attributes are supported and ready. Once an appropriate physical printer is available, your job should print.

4.2 Modifying Your Print Job

Use the pdmod command to modify job and document attributes of a job that has not yet started to print.

The following guidelines apply to the pdmod command:

To modify job attributes:
- Include the job identifier and do not include a document identifier.
- Specify only job attributes.

To modify document attributes:
- Include the document identifier. This is a number less than or equal to the total number of documents in the job.
- Specify only document attributes.

To modify job and document attributes:
- Include the job identifier and document identifier of the specific document you are modifying.
- Include the specific job and document attributes that are to be changed.

The following examples show pdmod commands being used to modify jobs and documents on the default server.

To change the copy count to 4 for job 112 on dogear_spl, enter:
```
$ pdmod -n 4 dogear_spl:112
```

To modify the job retention period to 60 minutes for job 113 on the default spooler, enter:
```
% pdmod -x "job-retention-period=60" 113
```

To change the default medium for the first document of job 127 on the default spooler, enter:
```
% pdmod -x "default-medium=a" 127.1
```

4.3 Pausing and Resuming Your Job

Use the pdpause command to pause a pending print job or held print job. You cannot pause a job that has started to print. When you pause a job, the job is not submitted to a physical printer for printing.

The following guidelines apply to the pdpause command:

You can pause only your own jobs.

You cannot pause a specific document within the job, only the whole job.

You must specify the job identifier for the job to be paused. If the server is your default server, you need only specify the job number.

You cannot pause a job after it starts printing.

Some examples of pdpause commands are:

To pause job 1023, which is waiting to be printed on the default logical printer, enter:
```
$ pdpause 1023
```

To pause job 1153 on dogear_spl, enter:
```
$ pdpause dogear_spl:1153
```

Use the pdresume command to resume a job that was paused with the pdpause command. The job then becomes available for scheduling and printing.

The following guidelines apply to the pdresume command:

You can resume only jobs that were paused with thepdpause command.

You can resume only your own paused jobs.

You must specify the job identifier for the job to be resumed. If the server is your default server, you need only specify the job number.

The following examples show the pdresume commad being used:

To resume job 123, which was submitted to the default printer and then paused, enter:
```
% pdresume 123
```

To resume job 1153 on dogear_spl, enter:
```
% pdresume dogear_spl:1153
```

4.4 Resubmitting Your Job

Use the command to requeue a job for printing.

The following guidelines apply to the pdresubmit command:

You can resubmit only your own jobs.

The job to be resubmitted must currently be in a pending, held, paused, or retained state.

You cannot resubmit a job if its state is printing, processing, preprocessing, or completed.

The new (target) printer must be on the same server as the printer to which the job was originally sent.

You must specify the job identifier for the job to be resubmitted. If the server is your default server, you need only specify the job number.

The following example shows the pdresubmit command being used:

To resubmit jobs 2000 and 2001 on the default server to logical printer pawprint, enter:
```
$ pdresubmit pawprint 2000 2001  
```

4.5 Remove Your Job

Use the pdrm command to remove (cancel) a print job.

The following guidelines apply to the pdrm command:

You can cancel only your own jobs.

The removed job is placed in a retained state if the -r retention_period option is included in the command line or if the job-retention-period attribute has a value greater than zero. Otherwise, the job is placed in a completed state and the document data is deleted.

If you set a retention period for the job, you can use the pdresubmit command to resubmit the job at any time within the specified retention period.

You must specify the job identifier for the job to be canceled. If the server is your default server, you need only specify the job number.

The following examples show the pdrm command being used:

To cancel and delete job 2000 from the default server, enter:
```
$ pdrm 2000
```

To cancel job 2001 on server dogear_spl, and retain the document data for one hour, enter:
```
$ pdrm -r 60 dogear_spl:2001
```