.\" $Header:
.TA p
.TH pdshutdown 1 
.SH NAME
pdshutdown \- stops servers
.PP
.SH SYNOPSIS
.tr ~"
.C pdshutdown 
.RC [ -c \0\f2Server\f4 \|\f1]
.RC [ -m \0\~\f2MessageText\f4~ \|\f1]
.RC [ -w \0\f2WhenTime\f4 \|\f1]
.RC [ -x \0\~\f2AttributeValuePairs\f2~ \|\f1]
.RC [ -X \0\f2AttributesFileName\f4 \|\f1]
.RI \0\f2ServerName\f4
.PP
.C pdshutdown -h
.tr ~~
.PP
.SH DESCRIPTION
You use this administrative command 
.C pdshutdown 
to terminate a server
process.
.PP
A server can be shut down either immediately or after it has finished
processing some or all of its current jobs.
.PP
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.
.PP
A confirmation message may be issued, depending on the value of the
.C server-notification-profile 
attribute for the specified server when the
shutdown is complete.
.PP
.CR Note :  
To restart a server once shutdown, you need to use the 
.C pdstartspl 
or
.C pdstartsuv 
utility.
.PP
.SS Options
You can use the following options with the 
.C pdshutdown 
.ft
command:
.PP
.TP
.C -c \0\f2server\f4
The only supported class for this command is 
.C server
.
.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 server being
shut down.  You can use this message to indicate the reason why
the server is being shut down or to provide other comments.
.PP
.IP
You can list this message by specifying
.CR requested-attributes=message 
with the 
.C pdls 
command.  If the 
.C -m
option is not specified, the message already stored with the
object remains unchanged.
Using this option is equivalent to specifying the
command-attribute 
.CR message .
.PP
.C -w \f2WhenTime
.IP
Where
\f2WhenTime
.ft
can be
.C after-current
(default),
.C now
, or
.C after-all.
.
.IP
Specifies when the you want the shutdown to occur.  
.PP
.IP
When the value is:
.PP
.IP
.C now\f2\f4
and the server is a 
.PP
.IP
.RI \f2Supervisor:\f4
.IP
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.
.PP
.IP
.RI \f2Spooler:\f4
.IP
The result of the command is to shut the spooler
down immediately.
.PP
.IP
.C after-current\f2\f4
and the server is a 
.PP
.IP
.RI \f2Supervisor:\f4
.IP
The supervisor continues to accept requests other than print requests 
until the currently-printing jobs finish printing; 
then the supervisor shuts down.
.PP
.IP
.RI \f2Spooler:\f4
.PP
.IP
The spooler shuts down immediately.
.fi
.PP
.IP
.C after-all 
.PP
.nf
.IP
The server (spooler or supervisor) continues to accept
all requests except print requests until all scheduled
jobs finish printing; then the server shuts down.
.PP
Using this option is equivalent to specifying the command-attribute
.C when.
.PP
.TP
.tr ~"
.C -x  \f2\~AttributeValuePairs\f4~
.tr ~~
A single attribute string, consisting of one or more
attribute-value pairs.
.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 the
command-attribute 
.CR attributes .
.PP
.SS Command Attributes
You may specify these attributes in a 
.C -x "\c
"\f2attribute value pairs\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
.TP
.CR class\f2=server\f4
The only supported class for this command is 
.C server.
.PP
.TP
.tr ~"
.CR message=\f2\~MessageText\f4~
.tr ~~
Specifies the message you want associated with the server being
shut down.  You can use this message to indicate the reason why
the server is being shut down or to provide other comments.
.PP
.IP
You can list this message by specifying
.CR requested-attributes=message 
with the 
.C pdls 
command.  If the
.C message 
attribute is not specified, the message already stored
with the object remains unchanged.
.PP
.C when\f2=WhenTime
.ft
.IP
Where \f2WhenTime
.ft
can be
.C after-current
(default),
.C now
,
.C after-all.
.IP 
Specifies when you want the shutdown to occur.  
.PP
.IP
When the value is:
.PP
.IP
.C now       
and the server is a:
.PP
.IP
.RI \f2Supervisor:\f4
.IP
The result of the command is to abort the 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.
.PP
.IP
.RI \f2Spooler:\f4
.IP
The result of the command is to shut the spooler
down immediately.
.PP
.IP
.C after-current 
and the server is a:
.PP
.IP
.RI \f2Supervisor:\f4
.IP
The supervisor continues to accept requests
other than print requests until the
currently-printing jobs finish printing; 
then the supervisor shuts down.
.PP
.IP
.RI \f2Spooler:\f4
.IP
The spooler shuts down immediately.
.PP
.IP
.C after-all 
.PP
.IP
The server (spooler or supervisor) continues to accept
all requests except print requests until all scheduled
jobs finish printing; then the server shuts down.
.fi
.PP
.SS Object Attribute     
.PP
There are no object attributes for this command.
.PP
.SS Argument
You use the argument value to identify the specific server you want to
shut down.
.PP
You must use the following argument value with the 
.C pdshutdown 
command:
.PP
.TP
\f2ServerName\f4
Specifies the server to be shut down.
.PP
.SH EXAMPLES
.PP
.SS Shutdown a Server
.PP
\(bu   To shut down supervisor SUPER1, to abort all print jobs that are
currently printing, and to set a message, Down for maintenance, 
enter the command:
.PP
.C "pdshutdown -w now -m ""Down for maintenance"" SUPER1"
.PP
.SH SEE ALSO
pdstartspl(1M), pdstartsuv(1M)
.PP
.SH STANDARDS CONFORMANCE
.CR pdshutdown ": POSIX 1387.4"
.\" index@\f4pdshutdown\f1 \- stops servers@@@\f3pdshutdown(1)\f1
.\" index@\f1stops servers@@@\f3pdshutdown(1)\f1
.\" index@\f1HP Distributed Printer System, stops servers@@@\f3pdshutdown(1)\f1
.\"
.\" toc@\f3pdshutdown(1)\f1:\0\0\f4pdshutdown\f1@@@stops servers
.\"
.\"
.\"
