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.
- -x "attribute=value …"
- Consists of a single attribute string, containing one or more attribute and value pairs.
- -X AttributesFileName
- Specifies the name of a file containing attribute and value pairs that you want InfoPrint to insert at the current point in the command.
Using this flag is equivalent to specifying the command attribute attributes.
- -h
- Displays a command-specific help message containing information about command syntax and flags. If you use this flag with any other flag or attribute, InfoPrint recognizes only the -h flag.
Configuration logic
The command determines which server host and server port to use based on this sequence:
- Server host and server port specified with the -H parameter.
- Server host and server port specified with the PDHOST and PD_SOCKET envirnonment variables.
- Uses the defaults for PDHOST=localhost and PD_SOCKET=6874.
Command attributes
You can specify these attributes in a -x "attribute=value …" string or in an attributes file designated with the -X AttributesFileName flag.
- attributes=AttributesFileName
- Specifies the designated attributes file that InfoPrint reads and inserts at the current point in the command. This file contains attribute and value pairs that InfoPrint uses to expand the command.
- filter="FilterCriteria"
- Specifies the filter selection criteria you want used if you request attribute values for multiple objects. InfoPrint selects only some of the candidate jobs based on the filtering criteria. A filter is a logical expression consisting of relationships between attributes and attribute values. Among the specified jobs, InfoPrint only returns tho