NAME
pdshutdown — stops servers
SYNOPSIS
pdshutdown -h
pdshutdown
[-c Server]
[-m "MessageText"
]
[-w WhenTime]
[-x "AttributeValuePairs"
]
[-X AttributesFileName]
ServerName
DESCRIPTION
Use the
pdshutdown
command to terminate a server process.
A server can be shut down either immediately or after it has finished
processing some or all of its current jobs.
While a server is shutting down and after it has shut down, the server
cannot accept new jobs. Printers that were enabled at shutdown time will
be enabled after restart. Printers that were disabled at shutdown time
will be disabled after restart.
A confirmation message may be issued, depending on the value of the
server-notification-profile
attribute for the specified server when the shutdown is complete.
Note:
To restart a server once shutdown, you need to use the
pdstartspl
or
pdstartsuv
utility. See
pdstartspl(1M)
and
pdstartsuv(1M).
Options
You can use the following options with the
pdshutdown
command:
- -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.
- -c server
The only supported class for this command is
server.
- -m "MessageText"
Specify the message to be associated with the
specified server being shut down.
You can use this message to indicate the reason for shutting down the
server or to provide other comments.
You can list this message by specifying
requested-attributes=message
with the
pdls
command.
If the
-m
option is not specified, the message already stored with the
object remains unchanged.
This option is equivalent to specifying the command-attribute
message.
- -w WhenTime
Specify when the you want the shutdown to occur.
WhenTime
can be
after-current
(default),
now,
or
after-all.
- now
If the server is a
Supervisor,
the result of the command is to abort any currently printing jobs,
then shut down the supervisor.
These jobs will be rescheduled to the next available
printer if the spooler is still active.
If the spooler has been shutdown, the job is aborted.
When the spooler and supervisor become active
again, the job will have to be submitted again.
If the server is a
Spooler,
the spooler shuts down immediately.
- after-current (default)
If the server is a
Supervisor,
The supervisor continues to accept requests other than print requests
until the currently-printing jobs finish printing.
Then the supervisor shuts down.
If the server is a
Spooler,
the spooler shuts down immediately.
- after-all
The server (spooler or supervisor) continues to accept
all requests except print requests until all scheduled
jobs finish printing. Then the server shuts down.
This option is equivalent to specifying the command-attribute
when.
- -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 you want
inserted at the current point in the command line.
This option is equivalent to specifying the command-attribute
attributes.
Command Attributes
You may specify these attributes in a
-x "AttributeValuePairs"
string or in an attributes file designated with the
I -X AttributesFileName
option.
- attributes=AttributesFileName
Cause the designated attributes file to be read.
- class=server
The only supported class for this command is
server.
- message="MessageText"
Specify the message that you want associated with the server
being shutdown.
You can use this message to indicate the reason for shutting down the
server or to provide other comments.
If the
message
attribute is not specified, the message already stored
with the object remains unchanged.
You can list this message by specifying
requested-attributes=message
with the
pdls
command.
- when=WhenTime
Specify when the you want the shutdown to occur.
WhenTime
can be
after-current
(default),
now,
or
after-all.
- now
If the server is a
Supervisor,
the result of the command is to abort any currently printing jobs,
then shut down the supervisor.
These job will be rescheduled to the next available
printer if the spooler is still active.
If the spooler has been shutdown, the job is aborted.
When the spooler and supervisor become active
again, the job will have to be submitted again.
If the server is a
Spooler,
the spooler shuts down immediately.
- after-current (default)
If the server is a
Supervisor,
The supervisor continues to accept requests other than print requests
until the currently-printing jobs finish printing.
Then the supervisor shuts down.
If the server is a
Spooler,
the spooler shuts down immediately.
- after-all
The server (spooler or supervisor) continues to accept
all requests except print requests until all scheduled
jobs finish printing. Then the server shuts down.
Object Attribute
There are no object attributes for this command.
Arguments
You must use the following argument value
with the
pdshutdown
command:
- ServerName
Specify the server to shut down.
EXAMPLES
Shutdown a Server
To shut down supervisor SUPER1, enter the following command.
This command also
aborts all print jobs that are
currently printing and sets a message, "Down for maintenance".
pdshutdown -w now -m "Down for maintenance" SUPER1
STANDARDS CONFORMANCE
pdshutdown: POSIX 1387.4