 |
» |
|
|
|
NAMEpddisable — stops printers from accepting jobs and logs from logging SYNOPSISpddisable -h pddisable
[-c ObjectClass]
[
-m "MessageText"
]
[
-x "AttributeValuePairs"
]
[-X AttributesFileName]
{ ServerName ...
| ServerName
:
LogName ...
| [ServerName
:
]PrinterName ...
| [ServerName
:
]QueueName ... }
DESCRIPTIONUse this administrative command,
pddisable,
to stop physical printers
or logical printers from accepting jobs,
or to stop logs from logging data. When you disable a printer, it does not accept jobs submitted with
pdpr
or
pdresubmit
commands. The printer still accepts other commands. All previously
submitted jobs and currently-printing jobs continue unaffected. You use the
pdenable
command to enable a printer to accept jobs again and
to enable the logging function of a log again. Note:
The
pddisable
and
pdenable
commands control input, whereas
pdpause
and
pdresume
control output. OptionsUse the following options with the
pddisable
command:
- -c ObjectClass
Specify the object class you want for this command.
The
ObjectClass
can be one of the following:
printer (default)
log
queue
server Within the valid classes,
queue
disables all logical printers associated with it,
printer
is for a logical or a physical printer,
server
is for a spooler or a supervisor and
disables all printers residing in the server, and
log
is for error log. See the
HPDPS Administration Guide
for more detail on error logging. This option is equivalent to specifying the command-attribute
class. - -h
Display a command-specific help message containing information
about command syntax and options.
This option cannot be used with another option or with an attribute. - -m "MessageText"
Specify the message that is to be associated with the
ObjectClass
specified:
printer,
log,
queue,
or
server.
You can use this message to indicate the reason for disabling the
printer,
log,
queue,
or
server
or to provide other comments. If the
-m
option is not specified, the message already stored with
the object remains unchanged. When the command is issued against a server,
HPDPS propagates the message to the
message
attribute of the printers residing in that server. The
message
attribute for that server is not changed.
When the command is issued against a queue, the message is propagated to the
message
attribute of the logical printers associated with the queue. The
message
attribute for the queue is not changed. You can list this message by specifying
requested-attributes=message
with the
pdls
command. This option is equivalent to specifying the command-attribute
message. - -x "AttributeValuePairs"
A single attribute string, consisting of one or more
attribute-value pairs. - -X AttributesFileName
The name of a file containing attribute-value pairs.
This option is equivalent to specifying the command-attribute
attributes.
Command AttributesYou may specify these attributes in a
-x "AttributeValuePairs"
string or in an attributes file designated with the
-X AttributesFileName
option.
- attributes=AttributesFileName
Cause the designated attributes file to be read. - class=ObjectClass
Specify the
ObjectClass
that you want for this command.
Valid object class names for the
pddisable
command are:
printer (default),
log,
queue,
or
server.
Within the valid classes,
queue
disables all associated logical printers,
printer
is for a logical or a physical printer,
server
is for a spooler or a supervisor and disables all printers
residing in the server, and
log
is for error log. - message="MessageText"
Specify the message you want associated with the
printer,
log,
queue,
or
server.
You can use this message to indicate the reason for disabling the
printer,
log,
queue,
or
server
or to provide other comments. If this attribute is not specified, the message already stored
with the object remains unchanged. When the command is issued against a server,
HPDPS propagates the message to the
message
attribute of the printers residing in that server. The
message
attribute for that server is not changed.
When the command is issued against a queue,
the message is propagated to the
message
attribute of the logical printers associated with the queue. The
message
attribute for the queue is not changed. You can list this message by specifying
requested-attributes=message
with the
pdls
command.
Object AttributesThere are no object attributes for this command. ArgumentsUse the argument to specify the object to disable.
If you specify multiple objects, each must be separated by spaces. You can use the following arguments with the
pddisable
command:
- ServerName:LogName
Specify the log you want disabled.
Disabling a log stops it from logging data. - [ServerName:]PrinterName
Specify the printer you want disabled.
Disabling a printer stops the acceptance of print requests.
Any jobs currently assigned to a physical printer continue printing. - [ServerName:]QueueName
Specify the queue you want disabled.
Issuing the
pddisable
command against a queue disables all of the logical printers
associated with that queue. - ServerName
Specify the server you want disabled. Issuing the
pddisable
command against a server disables all of printers residing in the server.
When issued against a:
- Spooler
HPDPS
attempts to disable all of the logical printers residing in that server. - Supervisor
HPDPS
attempts to disable all of the physical printers residing in that server.
EXAMPLESDisable PrintersTo disable printer lj4si (logical or physical) on server Serve1, enter
one of these commands:
pddisable lj4si
pddisable Serve1:lj4si The server name is not required. To disable the physical printers contained in the supervisor SuprG1
and assign a message to the printers, enter the command:
pddisable -c server -m "Unavailable due to testing" SuprG1 To disable the logical printers associated with the queue
production-q1 on server spoolera, enter one of the following commands:
pddisable -c queue production-q1
pddisable -c queue spoolera:production-q1 Again, the server name is not required. SEE ALSOpdclean(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) STANDARDS CONFORMANCEpddisable: POSIX 1387.4
|