SHUTSYS function


The SHUTSYS function corresponds to the sHutsys line command, which can be issued from the TSYS view.

This command causes an orderly shutdown of all objects on the system specified by the HOST parameter.

TOM uses dependency order to stop the objects. This means that TOM issues the stop commands for dependent objects before shutting down the parent object. When the objects have stopped and SHUTSYS processing completes, TOM will not reset, unlock, or start the objects. To restart the objects, you must stop the TOM PAS, start the TOM PAS, and UNLOCK any objects that you want TOM to start because the previous SHUTSYS changed the stopped objects' statuses to LOCKED.

By default, the SHUTSYS function stops all of the objects running on the system specified on the HOST parameter. If an object is defined so that it can run on multiple systems, the TOM system on the object's next highest priority VSL entry tries to start the object when schedule and dependency criteria have been met.

If you do not want an object to be started on another system in the VSL, specify the LOCK parameter with the SHUTSYS function. When you use the SHUTSYS function, SHUTSYS sets an object's status to LOCKED only on the local system. When you use SHUTSYS LOCK, TOM sets the object's status to LOCKED on all of the systems listed in the object's VSL. TOM does not restart an object with LOCKED status unless the RESET RESETOPT(STATUS|ALL), UNLOCK, or START function is issued for that object.

For information about shutdown and BBPARM parameters that affect a shutdown, see Shutting-down-a-system-that-is-running-TOM.

The following table shows the command and parameters:

Command

Parameters

TOMEXEC FUNCTION(SHUTSYS)

HOST(hostname)

[LOCK]

[NOTE('xxx')]

[TOMID(tom ID) | TOMPLEX(tomplex name)]

The following table describes the parameters:

Parameter

Function

HOST

Specify the name of a MVS system for which all objects will be stopped.

LOCK

Specify this (optional) parameter to cause TOM to bypass any attempt to restart the objects on alternate systems that have been defined as valid systems for the objects.

When LOCK is not specified, TOM attempts to start the objects on alternate systems that have been defined as valid systems in the object’s VSL.

NOTE

Specify a reason for the action taken.

By default this parameter is optional but it is required if you specify OPER_NOTE_REQUIRED=YES in BBPARM member MAMINIxx.

If NOTE('xxx') is required but is not specified, the request will be rejected with RC147. Error message MAMOD2035E is written to the log.

TOMID

Specify the ID of the TOM PAS on which you want the command issued.

TOMPLEX

Specify the name of the TOMPLEX where you want to issue the function.

See Specifying-the-TOMID-and-TOMPLEX-parameters for usage information.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*