.\" $Header:
.TA p
.TH pddisable 1
.SH NAME
pddisable \- stops printers from accepting jobs and logs from logging
.SH SYNOPSIS
.tr ~"
.C pddisable
.RC [ -c \0\f2ObjectClass \|\f1]
.RC [ -m \0~\f2message_text\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 pddisable -h
.SH DESCRIPTION
You use this administrative command, 
.CR pddisable ,
to stop physical printers
or logical printers from accepting jobs, 
or to stop logs from logging data.
.PP
When you disable a printer, it does not accept jobs submitted with
.C pdpr 
or
.C pdresubmit 
commands. The printer still accepts other commands.  All previously
submitted jobs and currently-printing jobs continue unaffected.
.PP
You use the 
.C pdenable 
command to enable a printer to accept jobs again and
to enable the logging function of a log again.
.PP
.CR Note :
The 
.CR pddisable 
and 
.CR pdenable 
commands control input, whereas 
.CR pdpause
and 
.CR pdresume 
control output.
.PP
.SS Options
You can use the following options with the
.C pddisable 
command:
.PP
.TP
.C   -c \f2class_name\fP
where \f2class_name\fP is one of:
.CR printer " (default),"
.CR log ,
.CR queue 
and
.CR server .
Within the valid classes, 
.C queue 
disables all logical printers
associated with it, 
.C printer 
is for a logical or a physical
printer, and 
.C server 
is for a spooler or a supervisor and
disables all printers residing in the server.
.br
Using this option is 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 ""\f2message_text\fP"" "
Specifies the message you want associated with the 
.CR printer , 
.CR log ,
.CR queue , 
or 
.CR server .  
You can use this message to indicate the
reason for disabling the 
.CR printer , 
.CR log , 
.CR queue , 
or 
.CR server 
or to
provide other comments.
.br
If the 
.C -m 
option is not specified, the message already stored with
the object 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 the server.  The 
.CR message 
attribute for the server is not changed.
When the command is issued against a queue, the message is propagated to the 
.CR message 
attribute of the logical printers associated with the queue.  The 
.CR message 
attribute for the queue is not changed.
.br
You can list this message by specifying
.CR     requested-attributes=message 
with the 
.C pdls 
command.
.br
Using this option is equivalent to specifying the command-attribute 
.CR message .
.PP
.TP
.C "-x ""\f2AttributeValuePairs\fP"" "
A single attribute string, consisting of one or more
attribute-value pairs.
.PP
.TP
.C   -X \f2AttributeFileName\fP
The name of a file containing attribute-value pairs.
.br 
Using this option is equivalent to specifying the command-attribute
.CR attributes .
.PP
.SS Command Attributes
.PP
You may 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 .
Within the valid classes, 
.CR queue 
disables 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 disables all
printers residing in the server.
.PP
.TP
.C "message=""\f2message text\fP"" "
Specifies the message you want associated with the 
.CR printer , 
.CR log ,
.CR queue , 
or 
.CR server .  
You can use this message to indicate the
reason for disabling the 
.CR printer , 
.CR log , 
.CR queue , 
or 
.CR server 
or to provide other comments.
.br
If this attribute is not specified, the message already stored
with the object 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 the server.  The 
.CR message 
attribute for the 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 the queue is not changed.
.PP
.br
You can list this message by specifying
.CR requested-attributes=message 
with the 
.C pdls 
command.
.PP
.SH Object Attributes
There are no object attributes for this command.
.PP
.SS Arguments
You use the arguments to identify the specific object you want to disable.
If you specify multiple objects, each must be separated by spaces.
.PP
You can use the following arguments with the 
.C pddisable 
command:
.PP
.TP
.CR \f2ServerName:LogName\fP
Specifies the log you want disabled.  Disabling a log stops it from logging 
data.
.PP
.TP
.CR \f2[ServerName:]PrinterName\fP
Specifies the printer you want disabled.  Disabling a printer
stops the acceptance of print requests.  Any jobs currently
assigned to a physical printer continue printing.
.PP
.TP
.CR \f2[ServerName:]QueueName\fp
Specifies the queue you want disabled.  Issuing the command
against a queue disables all of the logical printers associated
with that queue.
.PP
.TP
.CR \f2ServerName\fp
Specifies the server you want disabled.  Issuing the command
against a server disables all of printers residing in the sever.
Issuing it against a:
.br
.TP 20
.in +5
.CR Spooler
Disables all of the logical printers residing in that server
.TP 20
.in +5
.CR Supervisor
Disables all of the physical printers residing in that server
.PP
.SH EXAMPLES
.PP
.SS Disable Printers
.PP
o   To disable printer lj4si (logical or physical) on server Serve1, enter
one of these commands:
.PP
.C    pddisable lj4si
.PP
.C    pddisable Serve1:lj4si
.PP
The server name is not required.
.PP
o   To disable the physical printers contained in the supervisor SuprG1
and assign a message to the printers, enter:
.PP
.C    "pddisable -c server -m ""Unavailable due to testing"" SuprG1"
.PP
o   To disable the logical printers associated with the queue
production-q1 on server spoolera, enter one of the following commands:
.PP
.C    pddisable -c queue production-q1
.PP
.C    pddisable -c queue spoolera:production-q1
.PP
Again, the server name is not required.
.PP
.SH SEE ALSO
pdclean(1), pdcreate(1), pddelete(1), pdenable(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 pddisable ": POSIX 1387.4"
.\" index@\f4pddisable\f1 \- stops printers from accepting jobs and logs from logging@@@\f3pddisable(1)\f1
.\" index@\f1stops printers from accepting jobs and logs from logging@@@\f3pddisable(1)\f1
.\" index@\f1Distributed Print Service, stops printers from accepting jobs and logs from logging@@@\f3pddisable(1)\f1
.\"
.\" toc@\f3pddisable(1)\f1:\0\0\f4pddisable\f1@@@stops printers from accepting jobs and logs from logging
.\"
.\"
.\"
