NAME
pdq — queries and lists the status of one or more print jobs
SYNOPSIS
pdq -h
pdq
[
-f "FilterCriteria"
]
[-F]
[-g]
[-j]
[-p LogicalPrinterName]
[-r RequestedAttributes]
[-s StyleName]
[-U]
[
-x "AttributeValuePairs"
]
[-X AttributesFileName]
[LocalJobId
[. DocNumber] ...
| [GlobalJobId
[. DocNumber] ... ]
DESCRIPTION
Use the
pdq
command to list the status of some or all of the print
jobs that have been submitted to a logical printer.
If you omit both the
LocalJobId
and
GlobalJobId
and do not name a logical printer (either with the option
-p LogicalPrinterName
or the command-attribute
printer-name-requested),
all print jobs in the queue associated with the default
logical printer (as defined in the
PDPRINTER
environment variable) are listed.
If you do not specify a value for the
-r
option or the command-attribute
requested-attributes,
the
pdq
command defaults to the value
brief.
By default, you can list the attribute values only for jobs you submit.
Jobs will be listed in the order in which the queue considers them for
printing.
You can use the filtering option so the status is returned
for specific jobs only. The jobs have a predefined value
for the filter that is equal to the job attribute
user-name;
this value is set to your login identity
when you submit a job.
Options
Use the following options with the
pdq
command:
- -f FilterCriteria
Specify the filter selection criteria that you want to use for
the candidate objects or print jobs.
Among the candidate object or print jobs, only those matching
the filter expression are returned.
This option is equivalent to specifying the command-attribute
filter.
- -F
Turn off all filtering (both specified and default).
See the
-U
option for only turning the default filter off.
- -g
Turn off headings.
This option is equivalent to specifying the
headings=false
command attribute.
- -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.
- -j
Use this option to return only job attributes.
- -p LogicalPrinterName
Query all jobs in queue associated with this logical printer.
This option is equivalent to specifying the command-attribute
printer-name-requested.
- -r RequestedAttributes
Specify the attribute values you want displayed for the specified objects.
Values can be:
brief
(default),
verbose,
archive,
"attribute_list" ,
all,
or
none.
archive
displays only attributes that can be specified and set.
This option is equivalent to specifying the command-attribute
requested-attributes.
- -s StyleName
Specify the format in which you want the attributes displayed.
StyleName
can be
column (default)
or
line
This option is equivalent to specifying the command-attribute
style.
- -U
Suppress the default user-name filter.
- -x "AttributeValuePairs"
A single attribute string, consisting of one or more attribute-value pairs.
- -X AttributesFileName
The name of a file containing attribute-value pairs
to be inserted at the current point in the command line.
This options is equivalent to specifying the command attributes
attribute.
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
Cause the designated attributes file to be read.
- filter="FilterCriteria"
Specify the filter selection criteria that you want used
if you request attribute values for multiple jobs.
Only some of the candidate jobs are selected based on the filtering
criteria. A filter is
a logical expression consisting of relations of attributes to
attribute values. Among the specified jobs, only those whose
attribute values match the filter expression are returned.
The
filter
command attribute functions the same way for the
pdq
command as for the
pdls
command.
- headings=Boolean
Specify whether or not you want headings displayed for the
requested attributes.
Boolean
can be:
true
(default) or
false.
- printer-name-requested=PrinterName
Specify the logical printer for which you want a list of queued jobs.
If you do not define a printer name, the
PDPRINTER
environment variable is used to determine the printer.
- requested-attributes=AttributeType
Specify which output attributes you want displayed.
The command-attribute value can be:
brief
(default),
verbose,
"attribute_list" ,
all,
or
none.
archive
only displays attributes that can be set and specified.
- style=StyleName
Specify the presentation format in which you want attributes displayed.
StyleName
can be
column
(default) or
line.
Object Attributes
There are no object attributes for this command.
Arguments
Use the argument value to identify the specific object for which
you want the status. If you specify multiple objects, each must be
separated by spaces.
The argument value identifies the specific object the command applies to.
If multiple objects are specified, each instance must be separated by one
or more white spaces.
You can use the following argument values with the
pdq
command:
- LocalJobId[.DocNumber]
Specify the jobs or documents that you want listed as determined by a
local ID or a local ID and document number.
If you specify multiple arguments on the command line,
each must be separated by spaces.
- GlobalJobId[.DocNumber]
Specify the job or documents you want listed as determined by
a global ID or a global ID and document number.
If you specify multiple arguments on the command line,
each must be separated by spaces.
If you omit the
-p LogicalPrinterName
option, or the command-attribute
printer-name-registered=PrinterName,
and the
LocalJobId
or
GlobalJobId
argument, all of the jobs in the queue associated with your defaults
logical printer (defined in your
PDPRINTER
environment variable) are listed.
EXAMPLES
Query All Jobs on the Default Printer
To list all your jobs sent to your default logical printer LogPrt4,
enter the command:
which will display information similar to the following:
Note:
Status information is displayed for all of your jobs in the
queue associated with your default logical printer, not just those
that were submitted to your default logical printer.
Query all Jobs on a Logical Printer
To list all jobs sent to logical printer dizzy, enter the command:
SEE ALSO
pdclean(1),
pdcreate(1),
pddelete(1),
pddisable(1),
pdenable(1),
pdls(1),
pdmod(1),
pdpause(1),
pdpr(1),
pdpromote(1),
pdresubmit(1),
pdresume(1),
pdrm(1),
pdset(1),
pdshutdown(1)
For information about:
Filters, see the
pdls
command-attribute filter
Headings, see the
pdls
command-attribute style
Requested attributes, see the
pdls
command-attribute style
Style, see the
pdls
command-attribute style
To view information about all supported attributes,
see manpage
pd_att(5).
It contains a list of files by object from which
you can select the attribute listing that you want.
STANDARDS CONFORMANCE
pdq: POSIX 1387.4