TotalNET Advanced Server 5.2 Reference Manual

tnshut

This command performs an orderly shutdown of the TAS system, realms, or services. It can send connected clients a sequence of warning messages first, including the number of minutes until disconnection and an explanation. To terminate connections for specific clients, use "tnkill". Use "tnstart" to restart the server.

Location

TNHOME/usr/sbin

Usage

tnshut [-f] [-r realm] [-t type] [-s service] [minutes [reason...]]
tnshut -C [-r realm] [-t type] [-s service]
tnshut [minutes [reason...]]

Options

"Realm Options"

-f	Shut down all TAS realms and services immediately, without sending a message to connected clients.
-C	Cancel a shutdown in progress.
`minutes`	Specify the number of minutes before you want TAS to shut down. If you do not specify a time, minutes defaults to 0. When you specify minutes and reason, TAS accepts client connections until five minutes before shutdown.
`reason`	Indicate a brief message to send to connected service clients. The clients must have message-receipt capacity. The reason can include up to 60 characters. If the explanation includes any of the following characters, you may need to enclose it in quotes, depending on your UNIX shell: # $ & * [ ' " ` ? \ \|^ ! When you specify minutes and reason, TAS accepts client connections until five minutes before shutdown.

Examples

Use the following command to cancel a shutdown in progress:
tnshut -C

Use the following command to provide a time until disconnection and a short message:
tnshut 10 to back up system

Use the following command to shut down all TAS realms and services:
tnshut