.\" $Header:
.TA p
.TH pdls 1
.SH NAME
pdls \- lists selected attribute values
.SH SYNOPSIS
.tr ~"
.C pdls
.RC [ -c \0\f2ObjectClass \|\f1]
.RC [ -f \0~\f2FilterCriteria\f4~ \|\f1]
.RC [ -F ]
.RC [ -g ]
.RC [ -j ]
.RC [ -r \0~\f2RequestedAttributes\f4~ \|\f1]
.RC [ -s \0\f2StyleName\f4 \|\f1]
.RC [ -U ]
.RC [ -x \0~\|\f2AttributeValuePairs \|\f1~]
.RC [ -X \0\|\f2AttributesFileName \|\f1]
.RI [ ServerName ... \| |
.RI ServerName:InitialValueDocumentName\f1... | 
.RI ServerName:InitialValueJobName\f1... | 
.RI ServerName:LogName\f1... | 
.RI [ ServerName:\|\f1] \f2PrinterName\f1... |
.RI [ ServerName:\|\f1] \f2QueueName\f1... |
.RI LocalJobId\|\f1[.\f2DocNumber\f1]... |
.RI GlobalJobId\|\f1[.\f2DocNumber\f1]... ]
.PP
.tr ~~
.C pdls -h
.SH DESCRIPTION
You enter the 
.CR pdls 
command to request that selected attribute values be
displayed for one or more print jobs or other 
.CR HPDPS 
objects.
.PP
o   By default, a filter is created when listing jobs which only allows
you to see your jobs.  The jobs have a predefined value for the filter
that is equal to the job attribute 
.CR user-name ; 
this value is your login
identity when you submit a job.
.PP
o   You add to this filter by further restricting the jobs for which
information is to be returned.
.PP
o   You must suppress the default filter by using the 
.C -U 
option or turn off
all filtering with the 
.C -F 
option to see more than your own jobs.
.PP
o   If you only specify the \f2ServerName\fP as the command argument, the
attribute values for all objects belonging to the object class you
specify are displayed.
.PP
o   You can list the attribute values for specific jobs by using the local
ID or the global ID.  You must have submitted the job to use the local
ID.
.PP
.CR Note :  
There is a situation when you must use the global ID.  If the
client daemon responsible for the mapping of local ID to global ID is
not available, 
.CR HPDPS 
may not be able to tie the local ID to the global
ID.  If this situation exists, you must use the global ID, the name of
the sever (spooler), or an argument specification using global
characters.
.PP
.SH Options
You can use the following options with the 
.C pdls 
command:
.PP
.TP
.C -c \f2ObjectClass\fP
Specifies the object class of the object whose attributes you
want listed.  All the following object classes are valid:
.CR job " (default),"
.CR document ,
.CR initial-value-document ,
.CR initial-value-job ,
.CR log ,
.CR printer ,
.CR queue ,
and
.CR server .
Using this option is equivalent to specifying the
command-attribute 
.CR class .
.PP
.TP
.C "-f ""\f2FilterCriteria\fP"" "
Specifies the filter criteria you want to use in selecting from
the candidate objects.  Among the candidate objects, only those
matching the filter expression are returned.  See the
command-attribute 
.C filter 
for filter expression details.
Using this option is equivalent to specifying the
command-attribute 
.CR filter .
.PP
.TP
.C -F   
Turns off all filtering (both specified and default).  See the
.C -U 
option for suppressing only the default.
.PP
.TP
.C -g   
Turns off headings.
Using this option is equivalent to specifying the
command-attribute 
.CR headings=false .
.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 display only job attributes.
.PP
.TP
.C "-r \f2RequestedAttributes\f4"
Where 
.CR RequestedAttributes
can be
.C brief
(default),
.CR verbose ,
.CR archive ,
.C " ""\f2attributes list\fP"" " 
,
.CR all ,
or
.CR None\f1.
.br
Specifies the group of attributes that you want displayed for
the specified 
.CR job , 
.CR document ,
.CR initial-value-document , 
.CR initial-value-job , 
.CR log , 
.CR printer ,
.CR queue , 
or 
.CR server .
Within the valid classes,
.C archive 
only displays settable and specifiable attributes.  The
value of 
.C all 
lists all attributes listing first those that do
not have values assigned and then those with values assigned.
These values are additive.
Using this option is equivalent to specifying the
command-attribute 
.CR requested-attributes .
.TP
.C -s \f2StyleName\f4
Where \f2StyleName\f4 
.ft
can be
.CR column
(default)
or
.CR line .
.br
.C Column
is the default for
.C -r brief
and
.C -r verbose.
.br
.C Line
is the default for
.CR "-r all" ,
.C -r "\c
"\f2AttributesList\fP\c"
",
and
.C "-r archive."
.br
Specifies the format you want the attributes displayed in.  See
the command-attribute
.C style
for detail explanation of the column
and line formats.
Using this option is equivalent to specifying the
command-attribute
.CR style .
.PP
.TP
.C -U
Suppresses the default user-name filter.
.PP
.TP
.CR style .
.PP
.TP
.C -U    
Suppresses the default user-name filter.
.PP
.TP
.C "-x ""\f2AttributeValuePairs\fP"" "
Consists of a single attribute string, containing of one or more
attribute-value pairs.
.PP
.TP
.C -X \f2AttributesFileName\fP
Specifies the designated attributes file to be read and inserted
at the current point in the command line.  This file contains
attribute-value pairs that are used to expand on the command
being entered.
Using this option is equivalent to specifying the
command-attribute 
.CR attributes .
.PP
.SS Command Attributes
.PP
You can specify these attributes in a 
.C -x "\c
"\f2AttributeValuePairs\fP\c"
" string or
in an attributes file designated with the 
.C -X 
AttributesFileName option.
.PP
.TP
.CR attributes=\f2AttributesFileName\fP
Specifies the designated attributes file to be read and inserted
at the current point in the command line.  This file contains
attribute-value pairs that are used to expand on the command
being entered.
.PP
.TP
.CR class\f2=ObjectClass\f4
Specifies the object class you want for this command.
Valid object class names for the
.C pdls
command are:
.CR job " (default),"
.CR document ,
.CR log ,
.CR printer ,
.CR queue ,
.CR initial-value-job ,
.CR initial-value-document ,
and
.CR server .
.br
Specifies the object class of the object whose attributes you
want listed.  All object classes are valid.
.PP
.TP
.CR "filter=""\f2FilterCriteria\fP"" "
Specifies the selection criteria you want used to select a
subset from the candidate objects (if you request attribute
values for multiple objects).  A filter is a logical expression
consisting of relations of attributes to attribute values.
Among the objects you specify, only objects whose attribute
values match the filter expression are returned.
.br
You can only use attributes for the object class 
.CR \f2(\fPjob ,
.CR document , 
.CR initial-value-document ,
.CR initial-value-job , 
.CR log , 
.CR printer , 
.CR queue ,
or 
.CR server ) 
you specify in the command.  The
filter may contain an attribute other than one of those you are
requesting.
.br
A \f2filter\fP is a text string delimited by quotes.  The filter
syntax is one of the following:
.PP
.TP
1.  A filter item consisting of an "attribute operator value." 
.C Table 1-1
shows the operators and the data formats they can be used with to
separate the attribute and value.
.PP
.TS
expand;
lw(2i) s s s s
l l l l l.
\f3Table  1-1. Attribute Operators for Filters\f1
 
.sp .5v
Operation	Operator	Strings	Integers	TimeFormat
_
.sp .5v
Equal	==	X	X	X
_
.sp .5v
T{
.na
Match first part of a value
.ad
T}	=*	X	X	X
_
.sp .5v
T{
.na
Match last part of a value
.ad
T}	*=	X	X	X
_
.sp .5v
T{
.na
Match any part of a value; such as a sub-string
.ad
T}	*=*	X	X	X
_
.sp .5v
T{
.na
Attribute present (any value)
.ad
T}	==*	X	X	X
.TE
.PP
Note:  Testing for attribute present returns true when the attribute
has a value, not just when the attribute exists.  A false value may be
needed to satisfy the requirement such as using quotes, as long as the
false value conforms to the general syntax.
.TS
.\"expand;
lw(2i) s s s s
l l l l l.
\f3                                          \f1
.sp .5v
         	        	       	        	          
_
.sp .5v
T{
.na
Match approximately; for case-insensitive sub-string
.ad
T}	~=	X	-	-
.TE
Note:
.PP
1.  An approximate match is when at least half of the target string,
    regardless of starting position, matches the filter value.
.PP
2.  A case insensitive match is when the target string may have a mix
    of upper- and lower-case characters, but the character do match.
.TS
.\"expand;
lw(2i) s s s s
l l l l l.
\f3                                         \f1
.sp .5v
         	        	       	        	          
_
.sp .5v
T{
.na
Match a value greater than that specified
.ad
T}	>	-	X	X
_
.sp .5v
T{
.na
Match a value less than that specified
.ad
T}	<	-	X	X
_
.TE
.\".nf
.\".bp
.\".ft CW
.\".PP
.\"|------------------------------------------------------------------------|
.\"| Table  1-1. Attribute Operators for Filters                            |
.\"|------------------------------------------------------------------------|
.\"| Operation             | Operator   | Strings   | Integers  | TimeFormat|
.\"|-----------------------|------------|-----------|-----------|-----------|
.\"| Equal                 | ==         | X         | X         | X         |
.\"|-----------------------|------------|-----------|-----------|-----------|
.\"| Match first part of a | =*         | X         | X         | X         |
.\"| value                 |            |           |           |           |
.\"|-----------------------|------------|-----------|-----------|-----------|
.\"| Match last part of a  | *=         | X         | X         | X         |
.\"| value                 |            |           |           |           |
.\"|-----------------------|------------|-----------|-----------|-----------|
.\"| Match any part of a   | *=*        | X         | X         | X         |
.\"| value; such as a      |            |           |           |           |
.\"| sub-string            |            |           |           |           |
.\"|-----------------------|------------|-----------|-----------|-----------|
.\"| Attribute present     | ==*        | X         | X         | X         |
.\"| (any value)           |            |           |           |           |
.\"|------------------------------------------------------------------------|
.\"| Note:  Testing for attribute present returns true when the attribute   |
.\"| has a value, not just when the attribute exists.  A false value may be |
.\"| needed to satisfy the requirement such as using quotes, as long as the |
.\"| false value conforms to the general syntax.                            |
.\"|------------------------------------------------------------------------|
.\"| Match approximately;  | ~=         | X         | -         | -         |
.\"| for case-insensitive  |            |           |           |           |
.\"| sub-string            |            |           |           |           |
.\"|------------------------------------------------------------------------|
.\"| Note:                                                                  |
.\"|                                                                        |
.\"| 1.  An approximate match is when at least half of the target string,   |
.\"|     regardless of starting position, matches the filter value.         |
.\"| 2.  A case insensitive match is when the target string may have a mix  |
.\"|     of upper- and lower-case characters, but the character do match.   |
.\"|------------------------------------------------------------------------|
.\"| Match a value greater | >          | -         | X         | X         |
.\"| than that specified   |            |           |           |           |
.\"|-----------------------|------------|-----------|-----------|-----------|
.\"| Match a value less    | <          | -         | X         | X         |
.\"| than that specified   |            |           |           |           |
.\"|------------------------------------------------------------------------|
.\".fi
.PP
.TP
2.  In the previous table the attribute present operation consists of an
attribute name followed by the equality operator followed by an * in
the place of an attribute value.  For example:
.IP
.C    "-f ""printers-assigned==*"""
.IP
If the attribute has no value the filter item is evaluated as 
false.  It evaluates as true 
if the attribute has been assigned any value.
.PP
.TP
3.  Each attribute in a filter item can be compared to only one attribute
value.  To compare an attribute to more than one value, or to filter
on more than one attribute, separate the filter items with one of the
following operators:
.PP
.nf
    The "AND" operator ("&&")     filter-item && filter-item
.PP
                                  The expression evaluates to true only if
                                  both "filter-items" evaluate to true.
    The "OR" operator ("||")      filter-item || filter-item
.PP
                                  The expression evaluates to true if
                                  either of the "filter-items" evaluate to
                                  true.
.fi
.PP
.TP
4.  To evaluate a filter item as false, use the "NOT" operator before the
filter item and enclose the filter item in parentheses.
.PP
    The "NOT" operator ("!")      ! (filter-item)
.IP
If the filter item evaluates to true the expression is considered
false, and vice versa.
.PP
.TP
5.  When you use multiple logical operators in a filter, they are
evaluated in an order of precedence.  You can override the order of
precedence by using parentheses 
.C \f2"\fP( )\f2"\fP.  See 
.C Table 1-2
for order of precedence.
.PP
.C Table 1-2 
summarizes the filter syntax provided by the 
.CR HPDPS 
CLI.  The
operators are listed in the order of precedence from highest to lowest.
.PP
.TS
lw(3i) lw(3i)
l l.
\f3Table  1-2. Filter Syntax\f1
 
.sp .5v
Operators	Placement
_
.sp .5v
Parentheses: ( )	Around filter items
.sp .5v
Relational operators: > <	Between attribute and value
.sp .5v
Equality operators: ==	Between attribute and value
.sp .5v
String matching: =* *= *=* ~=	Between attribute and value
.sp .5v
NOT Operator: !	Before (filter-item) only
.sp .5v
AND operator: &&	Between two filter items
.sp .5v
OR operator:||	Between two filter items
.sp .5v
.TE
.\".nf
.\"|------------------------------------------------------------------------|
.\"| Table  1-2. Filter Syntax                                              |
.\"|------------------------------------------------------------------------|
.\"| Operators                          | Placement                         |
.\"|------------------------------------|-----------------------------------|
.\"| Parentheses: ( )                   | Around filter items               |
.\"|------------------------------------|-----------------------------------|
.\"| Relational operators: > <          | Between attribute and value       |
.\"|------------------------------------|-----------------------------------|
.\"| Equality operators: ==             | Between attribute and value       |
.\"|------------------------------------|-----------------------------------|
.\"| String matching: =* *= *=* ~=      | Between attribute and value       |
.\"|------------------------------------|-----------------------------------|
.\"| NOT Operator: !                    | Before (filter-item) only         |
.\"|------------------------------------|-----------------------------------|
.\"| AND operator: &&                   | Between two filter items          |
.\"|------------------------------------|-----------------------------------|
.\"| OR operator: ||                    | Between two filter items          |
.\"|------------------------------------|-----------------------------------|
.\".fi
.PP
.TP
.C "headings=\f2Boolean\fP"
Specifies whether you want the output displayed with or without
headings where \f2Boolean\fP can be
.CR True
(default) or
.CR false.  
See the command-attribute 
.C style 
for examples.
.PP
.TP
.CR requested-attributes=\f2AttributeType\f4
The \f2AttributeType\f4 
.ft
value can be:
.CR brief " (default),"
.CR verbose ,
.C "archive, ""\f2AttributesList\fP"" "
.CR all
or
.CR none .
.br
Specifies the group of attributes you want displayed for the
specified 
.CR job , 
.CR document ,
.CR initial-value-document , 
.CR initial-value-job , 
.CR log , 
.CR printer ,
.CR queue , 
or 
.CR server .  
Within the valid classes,
.C archive 
only displays settable and specifiable attributes.  The
value of 
.CR all ,
lists all attributes listing first those that do
not have values assigned and then those with values assigned.
.br
The following list shows the 
.C brief 
and the 
.C verbose 
attributes
that are displayed for the specified object.  The 
.C brief 
attributes 
are a subset of the 
.C verbose  
attributes and are idenitifed in the
following list with a 
.C B 
to the left of the attribute name.		
.br
The attributes and their values are displayed in
the specified order.
.PP
.in +5
.C      Brief and Verbose Document Attributes
.PP
      B o   document-sequence-number
      B o   document-format
        o   octet-count
        o   copy-count
        o   sides
        o   document-type
      B o   document-file-name
.PP
.in +5
.C      Brief and Verbose Initial-Value-Document Attributes
.PP
      B o   initial-value-document-identifier
      B o   associated-server
      B o   logical-printers-ready
      B o   copy-count
      B o   sides
      B o   document-format
.PP
.in +5
.C        Brief and Verbose Initial-Value-Job Attributes
.PP
      B o   initial-value-job-identifier
      B o   associated-server
      B o   logical-printers-ready
      B o   printer-locations-requested
      B o   printer-models-requested
        o   job-retention-period
.PP
.in +5
.C      Brief and Verbose Job Attributes
.PP
      B o   job-client-id (local ID)
      B o   job-identifier (global ID)
      B o   job-name
      B o   current-job-state
        o   job-state-reasons
      B o   intervening-job  (See note 1)
      B o   printer-name-requested (See note 2)
      B o   printers-assigned (See note 3)
        o   total-job-octets (See note 4)
        o   job-owner
.PP
.CR \ \ \ \ \ \ \ \ \   Notes :
         1.  Only returned on the 
.C pdls 
and 
.C pdq 
commands
         2.  Logical printer name to which the job was submitted.
         3.  Physical printer name to which the job has been
             assigned (if such a scheduling decision has been made).
         4.  Sum of all printable files and copies.
.PP
.in +5
.C      Brief and Verbose Log Attributes
.PP
      B o   log-identifier
      B o   log-type
      B o   associated-server
      B o   enabled
        o   log-size
        o   log-wrap
.PP
.in +5
.C      Brief and Verbose Printer Attributes
.PP
      B o   printer-name
      B o   printer-realization
      B o   printer-state (physical printers)
        o   associated-server
        o   printer-locations
        o   printer-associated-printers (logical printers)
      B o   enabled
      B o   associated-queue
.PP
.in +5
.C      Brief and Verbose Queue Attributes
.PP
      B o   queue-name
      B o   queue-state
      B o   scheduler-ready
      B o   associated-server
        o   logical-printer-assigned
        o   physical-printer-assigned
.PP
.in +5
.C      Brief and Verbose Server Attributes
.PP
      B o   server-name
      B o   server-state
        o   logical-printers-supported (for spoolers)
        o   physical-printers-supported
      B o   server-type
        o   queues-supported
.PP
.TP
.C "style=StyleName"
Where
.C StyleName
may be either
.C column \f1(default) 
or 
.C line.
The format in which you want the attributes displayed.
.IP
.C column 
is the default for 
.CR requested-attributes=brief 
and
.CR requested-attributes=verbose
.IP
.C line 
is the default for 
.CR requested-attributes=all ,
.CR requested-attributes="\c
"\f2attributes list\fP\c"
", 
and
.CR requested-attributes=archive
.PP
The following is an example of 
.C column 
style with headings for 
.C brief 
set of attributes for a 
.C physical printer 
object within a specified supervisor.
.PP
.nf                                               Associated
       Name        Realization   State   Enabled  Queue
       --------    -----------   -----   -------  ----------
       PhysPrt1    physical      Idle    True     Queue1
       PhysPrt2    physical      Idle    True     Queue1
       PhysPrt3    physical      Idle    True     Queue2
.fi
.PP
The following is an example of 
.C column 
style without headings for 
.C brief 
set
of attributes for a 
.C physical printer 
object within a specified supervisor.
.PP
.nf
       PhysPrt1    physical      Idle    True  Queue1
       PhysPrt2    physcial      Idle    True  Queue1
       PhysPrt3    physical      Idle    True  Queue2
.fi
.PP
The following is an example of 
.C line 
style with headings for 
.C brief 
set of
attributes for a 
.C logical printer 
object within a specified spooler that
contains a single logical printer.
.PP
.nf
       LogPrt1: printer-name          =  LogPrt1
       LogPrt1: printer-realization   =  logical
       LogPrt1: printer-enabled       =  true
       LogPrt1: associated-queue      =  Queue1
.fi
.PP
The following is an example of 
.C line 
style without headings for 
.C brief 
set
of attributes for a 
.C logical printer 
object within a specified spooler that
contains a single logical printer.
.PP
.nf
       printer-name                  =  LogPrt1
       printer-realization           =  logical
       printer-enabled               =  true
       associated-queue              =  Queue1
.fi
.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 you want the
attributes displayed for.  If you specify multiple objects, each must be
separated by spaces.
.PP
You can use the following argument values with the 
.C pdls 
command:
.PP
\f2     LocalJobId[.DocNumber]\fP
\f2     GlobalJobId[.DocNumber]\fP
\f2     ServerName:InitialValueDocumentName\fP
\f2     ServerName:InitialValueJobName\fP
\f2     ServerName:LogName\fP
\f2     [ServerName:]PrinterName\fP
\f2     [ServerName:]QueueName\fP
\f2     ServerName\fP
.PP
.CR Note :  
When you only specify \f2ServerName\fP as the argument of the command
(without an object name), the attribute values are returned for all
of the objects within the object class you specify for that server
that meet the filter criteria.
.PP
.SH EXAMPLES
.SS Check on a Document        
.PP
o   To find out as much as you can about the first document in a job;
assume local ID of 13, enter the command:
.PP
.C     pdls -r all 13.1
.PP
.CR    Note :  
This will provide information about the job and the first
document.
.PP
o   To find the minimum about the second document in a job; assume local
ID of 13, enter the command:
.PP
.C    pdls -c document 13.2
.PP
.CR    Note :  
This will provide information only about the second document.
.PP
.SS "Determine Document Formats Supported by Given Printers"
.PP
o   To find out the document formats supported by the logical printers in
SPOOL1, enter one of the following command:
.PP
.C    "pdls -c printer -r document-format-supported -s line SPOOL"
.PP
.C    "pdls -x ""class=printer requested-attributes=document-format-supported
.C    style=line" SPOOL1
.PP
.CR HPDPS
will respond with information that looks something like this:
.PP
.nf
    LogPrt1:  document-formats-supported=document-format-ASCII
                                         document-format-postscript
.PP
    LogPrt2:  document-formats-supported=document-format-ASCII
                                         document-format-HPL
                                         document-format-postscript
.fi
.PP
.SS Using a Filter             
.PP
o   To determine the logical printers, physical printers, and queues that
support selected attributes on any server, enter one of the following
commands:
.PP
.C    "pdls -c printer -f ""content-orientation-supported==landscape && "
.C        "sides-supported==2"" "
.C        "-r printer-realization,associated-queue ""*:"" "
.PP
.C    "pdls -x ""class=printer "
.C        filter='content-orientation-supported==landscape &&
.C        sides-supported==2' 
.C        "requested-attributes=printer-realization associated-queue"" "
.C        """*:"" "
.PP
The system will return information that 
looks something like this:
.PP
.nf
    LogPrtHi:  Printer-name         =  LogPrtHi
    LogPrtHi:  Printer-realization  =  logical
    LogPrtHi:  associated-queue     =  HiResQ
    LogPrtLo:  Printer-name         =  LogPrtLo
    LogPrtLo:  Printer-realization  =  logical
    LogPrtLo:  associated-queue     =  LoResQ
    PhysPrt1:  Printer-name         =  PhysPrt1
    PhysPrt1:  Printer-realization  =  physical
    PhysPrt1:  associated-queue     =  HiResQ
    PhysPrt2:  Printer-name         =  PhysPrt2
    PhysPrt2:  Printer-realization  =  physical
    PhysPrt2:  associated-queue     =  LoResQ
.fi
.PP
o   To list all jobs that are owned by Smith, enter one of the following
commands:
.PP
.C     "pdls -f ""job-owner==Smith"" -U SPOOL1"
.PP
.C     "pdls -f ""j-ow==Smith"" -U SPOOL1"
.PP
o   To list all job that are not owned by Smith, enter the following
command:
.PP
.C     "pdls -f !(""job-owner==Smith"") -U SPOOL1"
.PP
o   To list jobs owned by someone with a given sub-string in their name
(sub-string matching) use one of the following filters with the 
.CR pdls
command:
.PP
.C    "pdls -U -f ""job-owner=*Jones""         # Initial string match"
.br
.C    "pdls -U -f ""job-owner*=*one""          # Any sub-string match"
.br
.C    "pdls -U -f ""job-owner*=nes""           # Final string match"
.PP
All of these will return jobs owned by "Jones".
.PP
o   To list jobs owned by all users with a name close to "Jones"
(approximate match), enter the command:
.PP
.C    "pdls -U -f ""job-owner~=jones"""
.PP
o   To list all jobs which have requested more than one copy and that have
been assigned to the lj4pp physical printer, enter the command:
.PP
.C    "pdls -U -f ""copy-count>1 && printer-assigned==lj4pp"" ""*:"" "
.PP
.SS "To Determine the Server Associated with a Printer"
.PP
o   To query for the name of the spooler containing logical printer
    LogPrt1, enter one of the following commands:
.PP
.C    pdls -c printer -r associated-server LogPrt1
.PP
.C    "pdls -x ""class=printer requested-attributes=associated-server"" LogPrt1"
.PP
.CR HPDPS
returns information similar to the following:
.PP
.nf
    LogPrt1:  associated-server=SPOOL1
.fi
.PP
.SS "To Determine the Attributes Specified in an IVO"
.PP
o   To query for the attributes specified in the initial value document
spl7ivd contained in SPOOL7, enter one of the following commands:
.PP
.C    pdls -c initial-value-document -r all SPOOL7:spl7ivd
.PP
.C    "pdls -x ""class=initial-value-document requested-attributes=all""
.C    SPOOL17:spl17ivd
.PP
.CR HPDPS
returns information similar to the following:
.PP
.nf
    spl7ivd:  initial-value-document-identifier = spl7ivd
    spl7ivd:  associated-server                 = SPOOL7
    spl7ivd:  object-class                      = initial-value-document
    spl7ivd:  copy-count                        = 2
    spl7ivd:  document-format                   = line-data
    spl7ivd:  descriptor                        = "IVD for SPOOL7"
.fi
.PP
.SS List Job Attributes          
.PP
o   To list the all attributes of jobs 10 and 12, enter the command:
.PP
.C    pdls -r all 10 12
.PP
o   To list the just the job attributes of jobs 10 and 12, enter the
command:
.PP
.C    pdls -j 10 12
.PP
.in -2
In the following examples, which show printers as the command arguments,
assume that the logical printer named DepartPrt is your default logical
printer as defined in your 
.C PDPRINTER 
environment variable and that it
sends input to the queue associated with the physical printers LaserJet5
and 3825X.
.PP
.SS List Status of All Jobs     
.PP
o   To list the status of all jobs you have submitted to the logical
printer DepartPrt, enter the command:
.PP
.C    "pdls -f ""printer-name-requested==DepartPrt"" SPOOL1:"
.PP
The following is displayed:
.PP
.nf
                                  Current    Intervening Printer   Printer
Job ID               Name         State      Jobs        Requested Assigned
--- --------------   ----------   ---------  ----------- --------- --------
4   SplX: 1099222204 Mthly-report processing 0           DepartPrt 3825X
5   SplX: 1114222205 Test-report  processing 0           DepartPrt LaserJet3
6   SplX: 1224222206 Trip-report  pending    2           DepartPrt
1   SplX: 0988222201 Dept-memo12  retained               DepartPrt
.fi
.PP
.SS List Status of All Pending Jobs  
.PP
To list job status of all jobs that have been submitted to the logical
printer DepartPrt and that are pending, enter the command:
.PP
.C   "pdls -f ""printer-name-requested==DepartPrt && current-job-state==pending""
.C   SPOOL1:
.PP
The following is displayed:
.PP
.nf
                                      Current    Printer    Printer
         Job   ID        Name         State      Requested  Assigned
         ---- ---------- ------------ ---------- ---------  ---------
         5     SplX:1114 Trip-report  pending    DepartPrt
.fi
.PP
.SS "List the Brief Attributes of a Logical Printer"
.PP
o   To list the 
.CR brief 
attributes of your default logical printer (assigned to the 
.C PDPRINTER 
environment variable), enter the following command:
.PP
.C    pdls -c printer DepartPrt
.PP
Which causes the following to be displayed:
.PP
.nf
         Printer     Realization  Enabled  Queue
         -------     -----------  -------  -----
         DepartPrt   logical      true     DepartQ
.fi
.PP
If you do not specify a printer name, the command will list the brief
attributes of all the logical printers that share the same spooler
with your default logical printer (as defined in your 
.C PDPRINTER
environment variable.
.PP
.SS List Document Formats Supported 
.PP
o   To list the document-formats supported by the logical printer
DepartPrt in the 
.CR line 
style with headings (default style for an
attribute list), enter the following command:
.PP
.C "pdls -c printer -r document-format-supported  DepartPrt"
.PP
The following is an example of what might be displayed:
.PP
.nf
   DepartPrt: document-formats-supported=document-format-ASCII
=document-format-ps
.fi
.PP
o   To list the document-formats supported by the logical printer
DepartPrt in the column style with headings, enter the following
command:
.PP
.C    "pdls -c printer -r document-formats-supported -s column DepartPrt"
.PP
The following is an example of what might be displayed:
.nf
.PP
    Document
    Formats
    -----------
    ASCII
    PostScript
.fi
.PP
.SS Create an Archive File        
.PP
o   To create an archive file for a spooler, enter the command:
.PP
.C "pdls -c server -r archive  SPOOL1 > /attr/SPOOL1.archive"
.PP
.SH SEE ALSO
pdclean(1), pdcreate(1), pddelete(1), pddisable(1), pdenable(1), pdmod(1),
pdpause(1), pdpr(1), pdpromote(1), pdq(1), pdresubmit(1), pdresume(1), pdrm(1), pdset(1),
pdshutdown(1)
.PP
See also:
.PP
o 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 pdls ":POSIX 1387.4"
\" index@\f4pdls\f1 \- lists selected attribute values@@@\f3pdclean(1)\f1
.\" index@\f1lists selected attribute values@@@\f3pdls(1)\f1
.\" index@\f1Distributed Print Service, lists selected attribute values@@@\f3pdls(1)\f1
.\"
.\" toc@\f3pdls(1)\f1:\0\0\f4pdls\f1@@@lists selected attribute values
.\"
.\"
.\"
