pdq command: queries job status

Syntax

pdq [-H host:port] [-f "FilterCriteria"] [{-d | -p} DestinationName] [-F] [-g] [-j]
[-r attribute …] [-s StyleName] [-U]
[-x "attribute=value …"] [-X AttributesFileName]
[LocalJobID[.DocNumber] … | GlobalJobID[.DocNumber] …]

pdq -h

Description

Use the pdq command to list the status of some or all jobs submitted to a logical destination or assigned to an actual destination.

With InfoPrint Manager for AIX or InfoPrint Manager for Linux, if you omit both the LocalJobID and the GlobalJobID and do not name a destination, InfoPrint lists all the jobs in the queue associated with the default logical destination, as defined by the PDPRINTER environment variable.

If you do not specify a value for the -r flag or the command attribute requested-attributes, the pdq command defaults to the value brief. By default, you can list the attribute values only for the jobs you submit.

InfoPrint lists the jobs in the order in which the queue considers them for printing.

You can use the filtering option so that InfoPrint returns status only for some jobs. The jobs have a predefined value for the filter that is equal to the job attribute user-name; InfoPrint sets this value to your login identity when you submit a job.

Flags

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

-d DestinationName
Queries all jobs in the queue associated with this destination, or all jobs assigned to this actual destination. The results depend on the destination realization and the value of the queue attribute assign-to-destination, as shown in the table.

Results of the pdq Command

Destination Realization assign-to-destination pdq Returns
Logical true or false All jobs in the queue associated with the logical destination
Actual true All jobs assigned to the actual destination
Actual false All jobs in the queue associated with the actual destination
-f "FilterCriteria"
Specifies the filter selection criteria that you want to use for the jobs. Among the jobs, InfoPrint returns only those matching the filter expression.

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

-F
Turns off all filtering, both specified and default. See the -U flag for only turning the default filter off.
-g
Turns off headings.

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

-j
Returns only the job attributes.
-p DestinationName
Same as -d DestinationName.
-r {brief | verbose | archive | "attribute …" | all | none} DEFAULT=brief
Specifies the group of attributes you want to display.
brief
Displays a small subset of important attributes for each object.
verbose
Displays a larger subset of important attributes for each object.
archive
Writes only initially settable and resettable attributes to an archive file.
attribute …
Displays the attributes you specify.
all
Displays all attributes.
none
Displays no attributes.

If you specify more than one of these values, InfoPrint displays all the attributes requested.

Using this flag is equivalent to specifying the command attribute requested-attributes.

-s {column | doccol | line} DEFAULT=column
Specifies the format in which you want InfoPrint to display the attributes.
column
Attribute values are displayed in tabular format, so that values of the same attribute for multiple objects line up in columns.
doccol
For jobs only, job attribute values and the document attribute values for the first document in the job are displayed in column format on the same line.
line
Each attribute is displayed on a separate line.

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

-U
Suppresses the default user-name filter.