IBM Tivoli Storage Manager, Version 7.1

HALT (Shut down the server)

Use this command to shut down the server. The HALT command forces an abrupt shutdown, which cancels all the administrative and client node sessions even if they are not completed.

Any transactions in progress interrupted by the HALT command are rolled back when you restart the server. Use the HALT command only after the administrative and client node sessions are completed or canceled. To shut down the server without severely impacting administrative and client node sessions, perform the following steps:

Use the DISABLE SESSIONS command to prevent starting new client node sessions.
Use the QUERY SESSIONS command to identify any existing administrative and client node sessions.
Notify any existing administrative and client node sessions that you plan to shut down the server (you must do this outside of Tivoli® Storage Manager).
Use the CANCEL SESSIONS command to cancel any existing administrative or client node sessions.
Issue the HALT command to shut down the server and stop any administrative and client node sessions.

Tip:

The HALT command can be replicated using the ALIASHALT server option. Use the server option to define a term other than HALT that performs the same function. The HALT command retains its normal function however, the server option provides an additional method for issuing the HALT command. See ALIASHALT for additional information.

Privilege class

To issue this command, you must have system or operator privilege.

Syntax


>>-HALT--------------------------------------------------------><

Parameters

None.

Example: Shut down the server

Shut down the server, either from the server console or from an administrative client. All user activity stops immediately and no new activity can start.

halt

Related commands

Table 1. Commands related to HALT
Command	Description
CANCEL PROCESS	Cancels a background server process.
CANCEL SESSION	Cancels active sessions with the server.
DISABLE SESSIONS	Prevents new sessions from accessing Tivoli Storage Manager but permits existing sessions to continue.
ENABLE SESSIONS	Resumes server activity following the DISABLE command or the ACCEPT DATE command.
QUERY PROCESS	Displays information about background processes.
QUERY SESSION	Displays information about all active administrator and client sessions with Tivoli Storage Manager.

Feedback