How TOM reinstates a SUSPENDED object
When TOM's control mode for an object has been set to SUSPENDED, TOM does not take any action to start or stop the object. This includes during system start or IPL time and therefore, TOM would not issue start commands for suspended objects at IPL. This can cause unnecessary delays in the system startup process and require user intervention to address the delay.
If you specify Y for the Reinstate at IPL attribute in an object definition, the object's control mode is automatically set to ACTIVE at IPL time. You can also specify if reinstatement should occur at the next IPL or after a user-specified number of IPLs. TOM keeps track of each IPL so it can calculate when to start an object at IPL.
When the object's control mode is set to SUSPEND and the IPL occurrence counter matches the IPL count attribute in the definition, reinstatement occurs, and TOM resumes control of the object. The control mode is set to ACTIVE and the IPL occurrence counter is cleared. TOM issues the start commands for the object when its schedule and dependency criteria are met.
The following table shows the command and parameters:
Command | Parameters |
|---|---|
TOMEXEC FUNCTION(ACTIVATE) | OBJECT(name)|SET(name)|ALL OPT([CNTL] [START] [POSTSTART] [STARTRETRY] [ALLSTART] [PRESTOP] [STOP] [POSTSTOP] [STOPRETRY] [ALLSTOP] [RECOVERY]) DEFBASE(name) SYSPLEX(name) [NOTE('xxx')] IPLLEVEL EVAL MANAGE HOST(system-name) [TOMID(tom ID) | TOMPLEX(tomplex name)] |
The following table describes the parameters:
Parameter | Function |
|---|---|
OBJECT | Specify the object name (mutually exclusive with the SET parameter). For information about specifying the object name, see Object-and-set-naming-restrictions. |
SET | Specify the set name (mutually exclusive with the OBJECT parameter). For information about specifying the set name, see Object-and-set-naming-restrictions. |
ALL | Specifies to ACTIVATE all of the objects in the definition base named in the DEFBASE keyword. The ALL keyword is mutually exclusive with the OBJECT and SET keywords. |
DEFBASE | Specify the object definition base where the activated item is stored in the registry. This value is associated with the sysplex keyword value. If it is not specified, the currently active object base is used. |
SYSPLEX | Specify the sysplex associated with the definition base (object or calendar) where the activated item is stored in the registry. If it is not specified, the sysplex of the system where the TOM PAS is running will be used. |
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. |
IPLLEVEL | Specify that IPLLEVEL can be used after the TOM PAS is started with IPLL=N or after the SUSPEND IPLLEVEL command was issued. This allows you to use the START|STOP IPLLEVEL commands. |
EVAL | Specifies that TOM will run evaluation cycles after initialization completes. |
MANAGE | Specifies that TOM will start or stop objects depending upon feedback from an evaluation cycle. |
HOST | Specifies which system the action should affect. This parameter is valid only when used with IPLLEVEL, MANAGE, or EVAL. |
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. |
OPT | Specify which actions for the named object are to be activated. The following values can be supplied for this parameter: CNTL – The object will be placed under TOM’s control. STArt – Resume execution of the specified or default start command. POSTSTArt – Resume execution of all post-start commands defined for the object. STARTRetry – Resume execution of all start-retry commands defined for the object. ALLSTArt – Starting of the object will be placed under TOM’s control. Selecting this value will resume Pre-Start, Start, Post-Start and Start-Retry processing. PRESTOp – Resume execution of all pre-stop commands defined for the object. STOp – Resume execution of the specified or default stop command. POSTSTOp – Resume execution of all post-stop commands defined for the object. STOPRetry – Resume execution of all stop-retry commands defined for the object. ALLSTOp – Stopping of the object will be placed under TOM’s control. Selecting this value will resume Pre-Stop, Stop, Post-Stop and Stop-Retry processing. RECovery – Resume execution of all recovery commands defined for the object. |