Use the pdq command to request a list of jobs that you submitted to a logical printer. This information can cover one or all jobs you have submitted and currently residing in the queue associated with the printer. The returned list of jobs is displayed in the order in which the jobs are scheduled to print.
pdq writes the report to standard output.
If a printer is not specified, pdq lists jobs on the printer named as the PDPRINTER environment variable.
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, use the pdq command:
%pdq
To list all of your jobs in the queue associated with logical printer bulldog, use:
%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
Part of the information returned by the pdq command is the job's current state. The following table describes possible 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 may resubmit the print job. |
| terminating | The job has been canceled. The supervisor is terminating its connection to the physical printer. |
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
If you want 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 the 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 instead of wrapping to the width of your window, which
is harder to read.
%pdls -c job -r all -s line dogear_spl:123
If your job has not printed correctly, for any reason, you may 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, you can enter a command like the following:
%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. First, determine which physical printer was assigned your job. Using the above example, the following command determines 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, use a pdls command like the following to 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 may need to request help from an administrator, and check that all required printer attributes are supported and ready. Once an appropriate physical printer is available, your job should print.
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, do the following:
Include the job identifier and do not include a document identifier.
Specify only job attributes in the command.
To modify document attributes, do the following:
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 in the command.
To modify job and document attributes, do the following:
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
Use the pdpause command to pause a pending or held print job. You cannot pause a job that has already 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 reschedule the paused job until you resume it via the pdresume command.
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 use this command only on jobs that were paused via the pdpause 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.
Some examples of pdresume commands are:
To resume job 123, which was submitted to the default printer and then paused, enter:
%pdresume 123
To resume job 1153 on dogear_spl, use:
%pdresume dogear_spl:1153
Use the pdresubmit command to resend a job to another printer on the same spooler.
The following guidelines apply to the pdpause 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.
An example of the pdresubmit command is:
To resubmit jobs 2000 and 2001 on the default server to logical printer pawprint, type:
%pdresubmit pawprint 2000 2001
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 canceled 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.
Examples of the pdrm command follow:
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