BLOCK function
BLOCK ignores dependencies on the object being blocked. After the object is blocked, object evaluation occurs and any objects (children) with strong dependencies on the BLOCKED object are set to an evaluated status of INACTIVE, and then stopped. If the object being blocked has children with STRONG dependencies, we recommended that you use STOP instead of BLOCK so that TOM can determine which children, if any, need to be stopped. A dependency order stop (BOTTOMTOTOP) stops the children first and then the parent.
If you do not specify the RESNEXTIPL parameter on the STOP command, the object is BLOCKED. If you specify RESNEXTIPL, then the object is LOCKED.
Restarting objects in BLOCKED status
When you perform an initial program load (IPL) on a system, TOM does not start an object in BLOCKED status for that system in its Valid System List.
To allow TOM to start an object in BLOCKED status on a specific system before its IPL, you must perform one of the following actions (from the UI, in an EXEC, or from the operator console):
- Issue the START command.
- Specify the UNBLOCK command with the system name in the HOST parameter.
- Issue the RESET RESETOPT(STATUS) command.
- Issue the RESET RESETOPT(ALL) command.
If the object has multiple systems in its VSL and is not ACTIVE on one of those systems, TOM starts the object if you issue one of the following functions:
- UNBLOCK (or START) function (or command) for that system
- RESET RESETOPT(STATUS) or RESET RESETOPT(ALL) function (or command) for the object
The following table shows the command and parameters:
Command | Parameters |
|---|---|
TOMEXEC FUNCTION(BLOCK) | OBJECT(name)|SET(name) [HOST(hostName)] DEFBASE(name) SYSPLEX(name) [CMDNUMBER(nnn)] [NOTE('xxx')] [TOMID(tomID) | TOMPLEX(tomplexName)] |
The following table describes the parameters:
Parameter | Function |
|---|---|
OBJECT | Specify the object name to be blocked (mutually exclusive with the SET parameter). For information about specifying the object name, see Object-and-set-naming-restrictions. |
SET | Specify the set name to be blocked (mutually exclusive with the OBJECT parameter). For information about specifying the set name, see Object-and-set-naming-restrictions. |
HOST | (Optional) Specify the name of a MVS system that is specified in the object definition’s valid systems list. TOM issues the function on the primary system in the VSL. If you do not specify HOST, TOM issues the function on the ACTIVE system. |
DEFBASE | Specify the object Definition Base where the object or set is stored in the Registry. This value is associated with the sysplex keyword value. If you do not specify DEFBASE, the currently active object base is used. |
SYSPLEX | Specify the sysplex associated with the Definition Base named by the DEFBASE parameter where the object is stored in the Registry. |
CMDNUMBER | When multiple Stop commands are defined for the object, specify the number of the command that the BLOCK command will use. If you do not specify the CMDNUMBER keyword, TOM uses the STOP command that is defined by the object's Default Stop Command attribute. |
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 is rejected with RC147 and 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. For usage information, see Specifying-the-TOMID-and-TOMPLEX-parameters. |
This section contains the following topics: