![]() |
![]() |
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. If the QUIESCE option is specified, transaction activity is halted when current transactions are completed and the server is shut down.
Use the QUIESCE option only if you plan to perform a stand-alone database dump with the DSMSERV DUMPDB command immediately following server shutdown. See the DSMSERV DUMPDB command for more information.
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:
Privilege Class
To issue this command, you must have system or operator privilege.
Syntax
>>-HALT--+---------+------------------------------------------->< '-Quiesce-'
Parameters
When you specify the QUIESCE option, the server attempts to stop all database update transactions and to record database pages to stable media. This process provides a consistent image of the database that can be dumped with the DSMSERV DUMPDB command. This attempt to stop update activity may be retried a number of times and may fail if there are many transactions in progress. If this failure occurs, the HALT command stops processing and the server continues to run. If this occurs, you can cancel all client sessions, cancel all background server processes, and re-issue the HALT QUIESCE command. The HALT command without the QUIESCE option causes the server to halt successfully.
Examples
Task 1
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.
Task 2
Before performing the standalone database dump using the DSMSERV DUMPDB command, shut down the TSM server with the QUIESCE option.
The standalone dump can now be performed.
Related Commands
Table 140. 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 clients 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. |