Shutting down a system that is running TOM

Although the primary purpose of TOM is to maintain the availability of the objects, there are times when the system where TOM is running will need to be stopped for maintenance or other tasks.

System shutdown can be an exacting and tedious process but TOM makes it simple and precise.

From the TSYS view, use the H (Shutsys) line command to try to stop all the objects under the control of TOM. Alternatively, you can use the SHUTSYS API function (see SHUTSYS function) or console command (see Console command CMD subcommands).

TOM attempts to stop objects based on their order in the dependency structure; TOM checks each object to see whether another object depends on it. If the dependent object or objects are still active, the object is not stopped. If an object has no dependents (or those dependents are no longer active), TOM stops the object.

By default, the SHUTSYS command will stop objects which are in SUSPEND control mode. To prevent this situation, specify SHUTDOWN(ACTIVE) in the BBPARM member MAMINIxx. When you restart TOM, these objects will remain suspended until a command is issued to control them with TOM. For more information about the SHUTDOWN parameter, see Parameters that affect shutdown.

When you issue the SHUTSYS command, TOM attempts to bring the status of all objects that have a status of ACTIVE or COMPLETE to a status of LOCKED. During this process, the status for an object might temporarily display as SCHEDULED-LOCKED or STOPPING.

If TOM is restarted after the SHUTSYS process is completed, transient objects will not be restarted unless an IPL was performed.

If all objects are not stopped, you must determine why and then stop them manually using the TOM STOP UI command, TOMEXEC API request, or console command. For information about how to manage objects that are not stopped automatically, see Manually shutting down remaining objects.

For information about how to shutdown a system from the TSYS view, see Stopping objects on a specific TOM PAS. For information about how TOM stops objects in sets, see Shutting down a set.

Was this page helpful? Yes No Submitting... Thank you