.\" $Header:
.TA p
.TH pdq 1
.SH NAME
pdq \- queries and lists the status of one or more print jobs
.SH SYNOPSIS
.tr ~"
.C pdq 
.RC [ -f \0\~\f2FilterCriteria\f4~ \|\f1]
.RC [ -F \|\f1]
.RC [ -g \|\f1]
.RC [ -j \|\f1]
.RC [ -p \0\f2LogicalPrinterName\f4 \|\f1]
.RC [ -r \0\f2RequestedAttributes\f4 \|\f1]
.RC [ -s \0\f2StyleName\f4 \|\f1]
.RC [ -U \|\f1]
.RC [ -x \0\~\f2AttributeValuePairs\f4~ \|\f1]
.RC [ -X \0\f2AttributeFileName\f4 \|\f1]
.RI \f2[LocalJobId[.DocNumber]... 
.RI |\0 GlobalJobId[.DocNumber]...]\f4
.PP
.C pdq -h
.tr ~~
.SH DESCRIPTION
You enter the 
.CR pdq 
command to list the status of some or all of the print
jobs that have been submitted to a logical printer.
.PP
If you omit both the \f2LocalJobId
.ft
and 
\f2GlobalJobId
.ft
and do not name a logical printer (either with the option
.C -p \f2LogicalPrinterName\f4 
or the command-attribute 
.C printer-name-requested
), all print jobs in the queue associated with the default
logical printer (as defined in the
.C PDPRINTER
environment variable) are listed.
.PP
If you do not specify a value for the 
.C -r
option or the command-attribute 
.CR requested-attributes ,
the
.C pdq
command defaults to the value
.CR brief.
By default, you can list the attribute values only for
jobs you submit.
.PP
Jobs will be listed in the order in which the queue considers them for
printing.
.PP
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 
.CR user-name ; 
this value is set to your login identity
when you submit a job.
.SS Options
You can use the following options with the 
.CR pdq 
command:
.PP
.TP
.tr ~"
.C -f \0\f2\~FilterCriteria\f4~
.tr ~~
Specifies the filter selection criteria 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. Using this option is equivalent to specifying
the command-attribute 
.C filter.
.PP
.TP
.C -F     
Turns off all filtering (both specified and default).
.br
See the 
.C -U
option for only turning the default filter off.
.PP
.TP
.C -g        
Turns off headings. Equivalent to specifying the
.CR headings=false 
command attribute.
.PP
.TP
.C -h  
Displays a command-specific help message containing information
about command syntax and options. This option is mutually exclusive;
cannot be used with another option or with an attribute.
.PP
.TP
.C -j
Use this option to return only job attributes.
.PP
.TP
.C -p \f2LogicalPrinterName\f4
Quieries all jobs in queue associated with this logical printer.
Using this option is equivalent to specifying the command-attribute
.CR printer-name-requested .
.PP
.TP
.C -r \f2RequestedAttributes\f4
Specifies the group of attributes you want displayed.
Values can be:
.CR brief  
(default), 
.CR verbose , 
.CR archive , 
.C " \f2""attribute_list\f4"" "
,
.CR all 
or
.CR none .
.C Archive
displays only specifiable and settable attributes.
Using this option is equivalent to specifying the command-attribute
.CR requested-attributes .
.PP
.TP
.C -s \f2StyleName\f4
where \f2StyleName\f4 can be 
.CR column  
(default) 
or
.CR line .
This option specifies the format in which you want attributes displayed.
Using this option is equivalent to specifying the command-attribute
.CR style .
.PP
.TP
.C -U
Suppresses the default user-name filter.
.PP
.TP
.tr ~"
.C   -x \0\f2\~AttributeValuePairs\f4~
.tr ~~
A single attribute string, containing one or more
attribute-value pairs.
.PP
.TP
.C   -X \f2\0AttributesFileName\f4
The name of a file containing attribute-value pairs you want
inserted at the current point in the command line.  Equivalent
to specifying the command attributes
.C attribute.
.PP
.SS Command Attributes
You can specify these attributes in a
.CR -x\0"\c
"\f2AttributeValuePairs\f4\c"
"
.ft
string or in an attributes file designated with the 
.C -X 
\f2AttributesFileName 
.ft
option.
.PP
.TP
.CR attributes\f2=AttributesFileName\f4
Causes the designated, user-provided, attributes file to be read.
.PP
.TP
.tr ~"
.CR filter\f2=\~FilterCriteria\f4~
.tr ~~
Specifies the filter selection criteria 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.
.IP
The 
.C filter 
command attribute functions the same way for the 
.C pdq
command as for the 
.C pdls 
command.  
.PP
.TP
.CR headings\f2=boolean\f4
Specifies whether or not you want headings displayed for the
requested attributes.
Possible values are:
.CR  true
(default) or
.CR false .
.PP
.TP
.CR printer-name-requested\f2=PrinterName\f4
Specifies the logical printer for which you want a list of queued jobs.
.IP
If you do not define a printer name, the 
.C PDPRINTER 
environment
variable is used to determine the printer.
.PP
.TP
.CR requested-attributes\f2=AttributeType\f4
Values:
.CR                brief 
(default),
.CR verbose ,
.C "\c
"\f2attribute_list\f4\c"
",
.CR all 
or
.CR none .
.IP
Specifies which attributes you want displayed.
.C archive
only displays settable and specifiable attributes.
.PP
.TP
.CR style\f2=StyleName\f4
Specifies the presentation format in which you want attributes 
displayed.
Possible values are:
.CR column 
(default) and
.CR line.
.PP
.SS Object Attributes
There are no object attributes for this command.
.PP
.SS Arguments
You 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.
.PP
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.
.PP
You can use the following argument values for the 
.C pdq
command:
.PP
.TP
\f2LocalJobId[.DocNumber]\f4
Specifies the jobs or documents 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.
.PP
.TP
\f2GlobalJobId[.DocNumber]\f4
Specifies 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.
.PP
.IP
If you omit the 
.C -p
\f2LogicalPrinterName
.ft
option, or the command-attribute
.CR printer-name-registered=\f2PrinterName\f4,
and the 
\f2LocalJobId
.ft
or 
\f2GlobalJobId
.ft
argument,
all of the jobs in the queue associated with your defaults
logical printer (defined in your
.C PDPRINTER
environment variable) are listed.
.PP
.SH EXAMPLES
.PP
.C Query All Jobs on the Default 
.C Printer
.PP
\(bu   To list all your jobs sent to your default logical printer LogPrt4,
enter the command:
.PP
.C    pdq
.PP
which will display information similar to the following:
.PP
.nf
                                         Intervening  Printer    Printers
Job  ID              Name    State       Jobs         Requested  Assigned
---  --------------  ------  ----------  -----------  ---------  --------
13   spl4:1104221000 File1   processing  0            LogPrt4    PhysPrt1
14   spl4:1105226030 JobA    pending     7            LogPrt4
15   spl4:1133000058 MyJob   pending     8            LogPrt4
.fi
.PP
.C 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.
.PP
.C Query all Jobs on a Logical 
.C Printer
.PP
\(bu   To list all jobs sent to logical printer dizzy, enter the command:
.PP
.C    pdq -p dizzy
.PP
.SH 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)
.PP
For information about:
.PP
\(bu   Filters, see the 
.C pdls 
command-attribute \f2filter\f4
.PP
\(bu   Headings,  see the 
.C pdls 
command-attribute \f2style\f4
.PP
\(bu   Requested attributes, see the 
.C pdls 
command-attribute \f2style\f4
.PP
\(bu   Style, see the 
.C pdls 
command-attribute \f2style\f4 
.PP
\(bu   To view information about all supported attributes, enter the
command:
.PP
.C    man pd_att
.PP
This will display a list of files by object from which you can select
the attribute listing you want.
.PP
.SH STANDARDS CONFORMANCE
.CR pdq ": POSIX 1387.4"
.\" index@\f4pdq\f1 \- queries and lists the status of one or more print jobs@@@\f3pdq(1)\f1
.\" index@\f1queries and lists the status of one or more print jobs@@@\f3pdq(1)\f1
.\" index@\f1HP Distributed Printer System, queries and lists the status of one or more print jobs@@@\f3pdq(1)\f1
.\"
.\" toc@\f3pdq(1)\f1:\0\0\f4pdq\f1@@@queries and lists the status of one or more print jobs
.\"
.\"
.\"
