Issue a Shutdown Event

You can issue a SHUTDOWN event to shut down:

• The complete system i.e. all processes are stopped.
• A particular server (in a node cluster).
• Specific types of processes.
• Individual instances of processes.

To issue a SHUTDOWN event, use the following command:

swsvrmgr SHUTDOWN [machine_name | machine_id [process_name [instance]]]
[-T timeout]

where:

• machine_name is the name of the server.
• machine_id is the unique identifier of the server. You can find a server’s identifier using the swsvrmgr status command.
• process_name is the process name of the server process you want to stop and must be one of these: BG, BGPREDICT, DBQD, DLMGR, IAPJMS, SPO, or DIRECTOR. If any other process name is specified, the command fails and an error message is displayed.
• instance is the instance of the process to stop.
• timeout is the optional timeout period that can be used to specify the time after which the command will terminate. If this is not specified, the default is 60 seconds.
Note: When you issue a SHUTDOWN event, the swsvrmgr utility will test events automatically. If the events do not work, Process Sentinels will not stop processes. For more information, see Test Events.

The result of the attempt to shutdown each process is displayed on the screen and a final status is displayed at the end.

Example

The following command shuts down the third instance of a background process on the server with Machine ID 1.

swsvrmgr shutdown 1 BG 3
Attempting to stop 1 processes
Machine ID Proc Name Proc Inst Status Comment
1 BG 3 SHUTTING DOWN Normal Shutdown