.\" $Header:
.TA p
.TH pdenable 1
.SH NAME
pdenable \- enables printers to accept jobs and logs to log
.SH SYNOPSIS
.tr ~"
.C pdenable
.RC [ -c \0\f2ObjectClass \|\f1]
.RC [ -m \0~\f2MessageText\f4~ \|\f1]
.RC [ -x \0~\f2AttributeValuePairs\f4~ \|\f1]
.RC [ -X \0\f2AttributesFileName \|\f1]
.IR ServerName ... \| |
.RI [ ServerName : \|\f1] \f2LogName\f1... |
.RI [ ServerName : \|\f1] \f2PrinterName\f1... |
.RI [ ServerName : \|\f1] \f2QueueName\f1...
.PP
.tr ~~
.C pdenable -h
.SH DESCRIPTION
You use this administrative command 
.CR pdenable
to enable the logging
function of logs or to enable logical printers or physical printers to
accept jobs.
.PP
To discontinue acceptance of print jobs, use the 
.C pddisable 
command.
To discontinue logs from logging data, use the 
.C pddisable 
command.
.PP
.CR Note :  
The 
.C pdenable 
and 
.C pddisable 
commands control input, whereas 
.C pdpause
and 
.C pdresume 
control output.
.PP
.SS Options
.PP
You can use the following options with the 
.C pdenable 
command:
.PP
.TP
.C -c \f2ObjectClass\fP
where \f2ObjectClass\fP is:
.CR printer " (default),"
.CR log ,
.CR queue 
or
.CR server .
Specifies the object class you want for this command.  Within
the valid classes, 
.C queue 
enables all associated logical
printers, 
.C printer 
is for a logical or a physical printer, and
.C server 
is for a spooler or a supervisor and enables all printers
residing in that server.
Equivalent to specifying the command-attribute 
.CR class .
.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 "-m ""\f2MessageText\fP"" "
Specifies the message you want associated with the 
.CR printer , 
.CR log ,
.CR queue , 
or 
.CR server 
that is being enabled.  You may use this
message to indicate the reason for enabling 
the 
.CR printer , 
.CR log ,
.CR queue , 
or 
.CR server 
or to provide other comments.  If the 
.CR -m 
option
is not specified, the message already stored with the 
.CR printer ,
.CR log , 
.CR queue , 
or 
.CR server 
remains unchanged.
.br
When the command is issued against a 
.CR server , 
.CR HPDPS 
propagates the message to the 
.CR message 
attribute of the printers residing in
that server.  The 
.CR message 
attribute for that server is not changed.
When the command is issued against a 
.CR queue , 
the message is
propagated to the 
.CR message 
attribute of the logical printers
associated with the queue.  The message attribute for that queue
is not changed.
.br
You can list this message by specifying
.CR requested-attributes=message 
with the 
.C pdls 
command.
Equivalent to specifying the command-attribute 
.CR message .
.PP
.TP
.C "-x ""\f2AttributeValuePairs\fP"" "
A single attribute string, consisting of one more
attribute-value pairs.
.PP
.TP
.C   -X \f2AttributesFileName\fP
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-attribute
.CR attributes .
.PP
.SS Command Attributes
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
Causes the designated attributes file to be read.
.PP
.TP
.CR class=\f2ObjectClass\fP
where \f2ObjectClass\fP is:
.CR printer " (default),"
.CR log ,
.CR queue ,
or
.CR server .
Specifies the object class you want for this command.
Within the valid classes,
.CR queue
enables all associated logical
printers, 
.CR printer 
is for a logical or a physical printer, and
.C server 
is for a spooler or a supervisor and enables all printers
residing in that server.
.PP
.TP
.C "message=""\f2MessageText\fP"" "
Specifies the message you want associated with the 
.CR printer , 
.CR log ,
.CR queue , 
or 
.C server 
that is being enabled.  You may use this
message to indicate the reason for enabling the 
.CR printer , 
.CR log ,
.CR queue , or 
.CR server 
or to provide other comments.  
If the 
.C message 
attribute
is not specified, the message already stored with the 
.CR printer ,
.CR log ,
.CR queue , or
.CR server
remain unchanged.
.br
When the command is issued against a 
.CR server , 
.CR HPDPS
propagates the message to the 
.CR message 
attribute of the printers residing in
that server.  The 
.CR message 
attribute for that server is not
changed.
When the command is issued against a 
.CR queue , 
the message is
propagated to the 
.CR message 
attribute of the logical printers
associated with the queue.  The 
.CR message 
attribute for that queue
is not changed.
.br
You can list this message by specifying
.CR requested-attributes=message 
with the 
.CR pdls 
command.
.PP
.SS Object Attributes      
.PP
There are no object attributes for this command.
.PP
.SS Arguments
.PP
You use the arguments to identify the specific object you want to enable.
If you specify multiple objects, each must be separated by spaces.
.PP
You can use the following arguments with the 
.C pdenable 
command:
.PP
.TP
\f2[ServerName:]LogName\fP
Specifies the log you want enabled.  Enabling a log allows it to
begin accepting input (logging).
.PP
.TP
\f2[ServerName:]PrinterName\fP
Specifies the printer you want enabled.  When first created,
printers are in the disabled state.  Printers cannot be enabled
unless they are associated with an existing queue.  Any other
objects referenced by the printer also must exist.  These are:
.PP
             o   For logical printers
                 -   
.C initial-value-job objects
                 -   
.C initial-value-document objects
.PP
.TP
\f2[ServerName:]QueueName\fp
Specifies the queue you want enabled.  When the 
.C pdenable 
command is issued against a queue, 
.CR HPDPS
attempts to enable all of its associated logical printers.
.PP
.TP
\f2ServerName\fP
Specifies the server you want enabled.  When the 
.C pdenable
command is issued against a server, 
.CR HPDPS
attempts to enable all of its printers.  When issued against a:
.PP
.in +6
o   \f2Spooler\fp, 
.CR HPDPS 
attempts to enable all of its logical printers
.PP
.in +6
o   \f2Supervisor\fp, 
.CR HPDPS 
attempts to enable all of its physical printers
.in 0
.PP
When a server is initialized again after being shut down, the
printers are either enabled or disabled.  This depends on the
state the printer was in when 
.CR HPDPS 
was shut down and on ability of the server to 
communicate with its associated queue.
.PP
.SH EXAMPLES
.PP
.SS Enable Printers
.PP
o   To enable logical printers lj4si and lj5si on spooler SPOOL1, enter
one of the following commands:
.PP
.C    pdenable  lj4si  lj5si
.PP
.C   pdenable  SPOOL1:lj4si  SPOOL1:lj5si
.PP
The server name is not required.
.PP
o   To enable all physical printers contained in the supervisor SUPERG1,
enter the command:
.PP
.C    pdenable -c server SUPERG1
.PP
.SH SEE ALSO
pdclean(1), pdcreate(1), pddelete(1), pddisable(1), pdls(1), pdmod(1),
pdpause(1), pdpr(1), pdpromote(1), pdq(1), pdresubmit(1), pdresume(1), pdrm(1), pdset(1),
pdshutdown(1)
.PP
.SH STANDARDS CONFORMANCE
.CR pdenable ": POSIX 1387.4"
.\" index@\f4pdenable\f1 \- enables printers to accept jobs and logs to log@@@\f3pdenable(1)\f1
.\" index@\f1enables printers to accept jobs and logs to log@@@\f3pdenable(1)\f1
.\" index@\f1Distributed Print Service, enables printers to accept jobs and logs to log@@@\f3pdenable(1)\f1
.\"
.\" toc@\f3pdenable(1)\f1:\0\0\f4pdenable\f1@@@enables printers to accept jobs and logs to log
.\"
.\"
.\"
