.\" $Header:
.TA p
.TH pdset 1
.SH NAME
pdset \- defines the attribute values of the specified print object
.SH SYNOPSIS
.PP
.tr ~"
.C pdset 
.RC [ -c \0\f2ObjectClass\f4 \|\f1]
.RC [ -g \|\f1]
.RC [ -m \0\~\f2MessageText\f4~ \|\f1]
.RC [ -r \0\~\f2RequestedAttributes\f4~ \|\f1]
.RC [ -s \0\f2StyleName\f4 \|\f1]
.RC [ -x \0\~\f2AttributeValuePairs\f4~ \|\f1]
.RC [ -X \0\f2AttributesFileName\f4 \|\f1]
.RI \0\f2ServerName: InitialValueDocumentName ...\f4\0|
.RI \0\f2ServerName: InitialValueJobName ...\f4\0|
.RI \0\f2ServerName: PrinterName ...\f4\0|
.RI \0\f2ServerName: LogName ...\f4\0|
.RI \0\f2ServerName: QueueName ...\f4\0|
.RI \0\f2LocalJobID ...\f4\0|
.RI \0\f2GlobalJobID ...\f4\0|
.RI \0\f2ServerName ...\f4
.PP
.C pdset -h
.tr ~~
.PP
.SH DESCRIPTION
.PP
You use this administrative command 
.C pdset 
to define or modify the values
of the print-object attributes.  Printers must be disabled before their
attributes can be modified.
.\".PP
.\"Table 1-1 lists the four modification operators.
.\".PP
.\".nf
.\"|------------------------------------------------------------------------|
.\"| Table  1-1. pdset Syntax                                               |
.\"|------------------------------------------------------------------------|
.\"| Operator        | Syntax           | Description                       |
.\"|-----------------|------------------|-----------------------------------|
.\"| replace         | attribute=value  | Replaces the entire value of the  |
.\"|                 |                  | attribute attribute with value or |
.\"|                 |                  | adds the attribute to the object, |
.\"|                 |                  | if not already present.           |
.\"|-----------------|------------------|-----------------------------------|
.\"| add-values      | attribute+=value | Adds the value value to the       |
.\"|                 |                  | attribute attribute.  You cannot  |
.\"|                 |                  | add values to single-valued       |
.\"|                 |                  | attributes.  An add request that  |
.\"|                 |                  | duplicates values on a            |
.\"|                 |                  | multi-valued attribute is honored |
.\"|                 |                  | without warning.                  |
.\"|-----------------|------------------|-----------------------------------|
.\"| remove-values   | attribute-=value | Removes the value value from the  |
.\"|                 |                  | attribute attribute.  A remove    |
.\"|                 |                  | request for a nonexistent value   |
.\"|                 |                  | is ignored, without warning or    |
.\"|                 |                  | error.  A remove request for the  |
.\"|                 |                  | last or only value of an          |
.\"|                 |                  | attribute, is equivalent to a     |
.\"|                 |                  | set-to-default request.           |
.\"|-----------------|------------------|-----------------------------------|
.\"| reset-to-default| attribute==      | Sets the attribute value          |
.\"|                 |                  | attribute to the default.  If     |
.\"|                 |                  | values are supplied with a        |
.\"|                 |                  | reset-to-default request, they    |
.\"|                 |                  | are ignored.                      |
.\"|------------------------------------------------------------------------|
.\".fi
.PP
.TS
expand ;
lfB s s
lw(1.5i) lw(1.5i) lw(3i)
l l l.
Table 1-1 lists the four modification operators.

.\".sp .v5
Operator	Syntax	Description
_
.sp .v5
replace	\f2attribute=value\f1	T{
.na
\f1Replaces the entire value of the
attribute \f2attribute\f1 with \f2value\f1 or
adds the attribute to the object,
if not already present.
T}
_
.sp .v5
add-values	\f2attribute+=value\f1	T{
.na
Adds the value \f2value\f1 to the
attribute \f2attribute\f1.  You cannot
add values to single-valued
attributes.  An add request that
duplicates values on a
multi-valued attribute is honored
without warning.
.ad
T}
_
.sp .v5
remove-values	\f2attribute-=value\f1	T{
.na
Removes the value \f2value\f1 from the
attribute \f2attribute\f1.  A remove
request for a nonexistent value
is ignored, without warning or
error.  A remove request for the
last or only value of an
attribute, is equivalent to a
sseett--ttoo--ddeeffaauuulltt
request.
.ad
T}
_
.sp .v5
reset-to-default	\f2attribute==\f1	T{
.na
Sets the attribute value
\f2attribute\f1 to the default.  If
values are supplied with a
rreesseett--ttoo--ddeeffaauuulltt 
request, they
are ignored.
.ad
T}
_
.TE
.PP
If you do not specify a value with a replace, add, or remove request, an
error is issued and the request to change the object is rejected.
.PP
Only values for settable attributes can be changed using the 
.C pdset
command.  Using this command for non-settable attributes results in an
error.  This is determined on an object-by-object basis.
.PP
Changes made to objects are permanent and remain changed even if the print
system is shutdown and then restarted.
.PP
.SS Options
.PP
You can use the following options with the 
.C pdset 
command:
.PP
.TP
.C -c \f2ObjectClass
\f2ObjectClass 
.ft
can be one of these classes:
.C printer
(default),
.C job
,
.C server
,
.C queue
,
.C document
,
.C initial-value-job
,
.C initial-value-document
, or
.C log.
.IP
Specifies the object class you want for this command.  Within
the valid classes, 
.C printer
is for a logical printer or a
physical printer and 
.C server
is for a spooler or a supervisor.
Using this option is equivalent to specifying the
command-attribute 
.CR class .
.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
.tr ~"
.C -m \0\f2\~MessageText\f4~
.tr ~~
Specifies the message you want associated with the 
.CR printer , 
.CR job ,
.CR server , 
.CR queue , 
.CR document , 
.CR initial-value-job ,
.CR initial-value-document , 
or 
.C log 
that is
being modified.  You may use this message to indicate the reason
that 
.CR printer , 
.CR job ,
.CR server , 
.CR queue , 
.CR document , 
.CR initial-value-job ,
.CR initial-value-document , 
or 
.C log 
is being set or modified or to provide
other comments.
.PP
.IP
If the command is to operate on a 
.C job\f2
, you can list this message
by specifying
.C requested-attributes=job-message-from-administrator 
with the
.C pdls 
command.  If the command is to operate on a 
.C printer
,
.C server
, 
.C queue
, 
.C document
, 
.C initial-value-document
, 
.C initial-value-job
, or 
.C log
, you
can list this message by specifying 
.C requested-attributes=message
with the 
.C pdls 
command.
.PP
.IP
If the 
.C -m 
option is not specified, the message already stored with
the object remains unchanged.
.PP
.IP
Using this option is equivalent to specifying the
command-attribute 
.CR message .
.PP
.TP
.C "-r ""\f2RequestedAttributes\f4"" "
\f2RequestedAttributes
.ft
can be
.C none
(default),
.C brief
, or
.C verbose.
.IP
Specifies the attribute values you want displayed for the
specified 
.C printer
, 
.C job
, 
.C server
, 
.C queue
, 
.C document
, 
.C initial-value-job
, 
.C initial-value-document
, or 
.C log.

Using this option is equivalent to specifying the
command-attribute 
.CR requested-attributes .
.PP
.TP
.C -s \f2StyleName
\f2StyleName
.ft
can be one of these styles:
.C column
(default), or
.C line.
.IP
Specifies the format in which you want the attributes displayed.
Using this option is equivalent to specifying the
command-attribute 
.CR style .
.PP
.C -x "\c
"\f2AttributeValuePairs\f4\c"
"
.ft
.IP
A single attribute string, consisting of one or more
attribute-value pairs.  Prefix the attribute value with the 
.C =
character to replace a value, the 
.C += 
characters to add a value
and the 
.C -= 
characters to remove a value.  Use 
.C == 
characters
with no attribute value to set the value to its default.
.PP
.TP
.C -X \f2AttributesFileName\f4
The name of a file containing attribute-value pairs you want
inserted at the current point in the command line.
Using this option is equivalent to specifying command-attribute
.CR attributes .
.PP
.SS Command Attributes
You can specify these attributes in a 
.C -x "\c
"\f2AttributeValuePairs\f4\c"
" 
.ft
string or
in an attributes file designated with the 
.C -X \f2AttributesFileName\f4
option.
.PP
.TP
.C attributes\f2=AttributesFileName\f4
Causes the designated attributes file to be read.
.PP
.C class\f2=ObjectClass
.IP
\f2ObjectClass
.ft
may be any of these classes:
.C printer
(default), 
.C job
,
.C server
,
.C queue
,
.C document
,
.C initial-value-document
,
.C initial-value-job
, or
.C log.
.IP
Specifies the object class you want for this command.  Within
the valid classes, 
.C printer 
is for a logical printer or a
physical printer and 
.C server 
is for a spooler or a supervisor.
.PP
.C headings\f2=Boolean
.ft
.IP
Where \f2Boolean
.ft
may be either
.C true
(default) or
.C false.
.IP
Specifies if you want headings displayed on the output.
.PP
.TP
.tr ~"
.CR  message=\f2\~MessageText\f4~
.tr ~~
Specifies the message you want associated with the 
.C printer
, 
.C job
,
.C server
, 
.C queue
, 
.C document
, 
.C initial-value-job
,
.C initial-value-document
, or 
.C log 
that is
being modified.  You may use this message to indicate the reason
that 
.C printer
, 
.C job
, 
.C server
, 
.C queue
, 
.C document
,
.C initial-value-job
, 
.C initial-value-document
, or 
.C log 
is being set or modified or to provide
other comments.
.PP
.IP
If the command is to operate on a job, you can list this message
by specifying
.CR requested-attributes=job-message-from-administrator 
with the
.C pdls
command.  If the command is to operate on a 
.CR printer ,
.CR server , 
.CR queue , 
.CR document , 
.CR initial-value-job ,
.CR initial-value-document , 
or 
.CR log , 
you can list this message by specifying 
.CR requested-attributes=message
with the 
.C pdls 
command.
.PP
.IP
If the 
.C message 
attribute is not specified, the message already
stored with the object remains unchanged.
.PP
.C requested-attributes\f2=ObjectAttribute
.ft
.IP
\f2ObjectAttribute
.ft
can be
.C none
(default),
.C verbose
, or
.C brief.
.IP
Specifies which output attributes you want displayed.
.PP
.C style\f2=StyleName
.ft
.IP
.ft
Where \f2StyleName
.ft
may be either
.C column
(default), or
.C line.
.IP
Specifies the presentation format in which you want the output
displayed.
.PP
.SS Object Attributes          
.PP
There are no object attributes for this command.
.PP
.SS Arguments
.PP
You use the argument values to identify the specific 
.CR printer ,
.CR job ,
.CR server , 
.CR queue , 
.CR document , 
.CR initial-value-job ,
.CR initial-value-document , 
or 
.CR log , 
for which you
want to set or modify some attributes.  If you specify multiple objects,
each must be separated by spaces.
.PP
The 
.C pdset 
command accepts any of the settable job and document attributes.
A settable attribute for jobs and documents can be modified with either
the 
.C pdset 
or 
.C pdmod 
commands.
.PP
You can use the following argument values with the 
.C pdset 
command:
.PP
\f2[ServerName:]_InitialValueJobName\f4
.PP
\f2[ServerName:]InitialValueDocumentName\f4
.PP
\f2ServerName:LogName\f4
.PP
\f2[ServerName:]PrinterName\f4
.PP
\f2[ServerName:]QueueName\f4
.PP
\f2ServerName\f4
.PP
\f2LocalJobID\f4
.PP
\f2GlobalJobID\f4
.PP
.SH EXAMPLES
.PP
.SS Specifying a Descriptor for a Server
.PP
\(bu   To set a description for the supervisor SUPER1 and identify the
processor name where it is located and the TCP/IP address for the
processor, enter the command:
.PP
.C "pdset -c server -x ""descriptor='Supervisor SUPER1 is installed on cowboy.  The TCP/IP address for cowboy is 9.99.9.143.'"" SUPER1"
.PP
.SS "Specifying a List of Managers for a Server"
.PP
\(bu   To identify the people who are responsible for the server and 
how to contact them, enter the command:
.PP
.C "pdset -c server -x ""list-of-managers='John Smith, extension 4488, office 3-10' 'Mary Jones, extension 5562, office 110'"" SUPER1"
.PP
.SS Change the Operator to Receive Messages
.PP
\(bu   To identify the new person that is to receive start and stop 
messages for physical printer PhysPrt1, enter the command:
.PP
.C "pdset -c printer -x ""notify-operator=electronic-mail:ro@cowboy"" SUPER1:PhysPrt1"
.PP
.SS  Set the Job Size Range       
.PP
\(bu   To set the size of jobs that can submitted to a physical printer
PhysPrt2, enter the command:
.PP
.C "pdset -x ""job-size-range-supported=0:10000 job-size-range-ready=0:10000"" PhysPrt2"
.PP
.SS To set a Message 
.PP
\(bu   To set the message for server SUPER2, enter:
.PP
.C "pdset -c server -m ""printing system now ok"" SUPER2"
.PP
.SH SEE ALSO
pdclean(1), pdcreate(1), pddelete(1), pddisable(1), pdenable(1), pdls(1), pdmod(1),
pdpause(1), pdpr(1), pdpromote(1), pdq(1), pdresubmit(1), pdresume(1), pdrm(1),
pdshutdown(1)
.PP
For information about:
.PP
\(bu   Headings, see the 
.C pdls 
command-attribute 
.C style
.PP
\(bu   Style, see the 
.C pdls 
command-attribute 
.C style
.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 pdset ": POSIX 1387.4"
.\" index@\f4pdset\f1 \- defines the attribute values of the specified print object@@@\f3pdset(1)\f1
.\" index@\f1defines the attribute values of the specified print object@@@\f3pdset(1)\f1
.\" index@\f1HP Distributed Printer System, defines the attribute values of the specified print object@@@\f3pdset(1)\f1
.\"
.\" toc@\f3pdset(1)\f1:\0\0\f4pdset\f1@@@defines the attribute values of the specified print object
.\"
.\"
.\"
