MOVE function
The MOVE function corresponds to the Move line command, which can be issued for objects from the TOBJOR view or sets from the TSETO view. The MOVE parameters are slightly different for objects and sets.
The MOVE function lets you make an ACTIVE object active on a different system or to make an object that is not ACTIVE, active on a specific system in its VSL. An object is considered moveable if it has more than one system listed in its VSL.
If the object that you want to move has dependents and you want to also move the dependents, you must specify the MOVEDEPS parameter. The MOVEDEPS parameters also ensures that the dependent objects are stopped in the correct dependency order. TOM starts the objects on the new system in dependency order.
To move an object that is not currently ACTIVE and start it on a another system in the TOMPLEX, specify the MOVEINACT parameter and the TOHOST parameter. The object will have a status of BLOCKED (or LOCKED if the RESNEXTIPL parameter is specified) on all of the other systems its VSL.
When you use the TOHOST parameter, you must always specify an active system that has TOM running on it. You will receive an error if you specify any of the following systems:
- A system that is not active
- A system that is not running TOM
- The system is not part of the TOMPLEX
For more information about errors, see MOVE-Return-codes.
The following table shows the command and parameters for moving an object.
Command (with OBJECT specified) | Parameters |
|---|---|
TOMEXEC FUNCTION(MOVE) | OBJECT(name) [HOST(hostname) ] [MOVEDEPS] [MOVEINACT] [NOTE('xxx')] TOHOST(hostname2’) [TOMID(tom ID) | TOMPLEX(tomplex name)] |
The following table shows the command and parameters when you use the MOVE function for a set.
Command (with SET specified) | Parameters |
|---|---|
TOMEXEC FUNCTION(MOVE) | SET(name) TOHOST(hostname2) [TOMID(tom ID) | TOMPLEX(tomplex name)] |
The following table describes the parameters:
Parameter | Function |
|---|---|
OBJECT | Specify the object name to be moved. For information about specifying the object name, see Object-and-set-naming-restrictions. |
SET | Specify the set name to be moved. For information about specifying the set name, see Object-and-set-naming-restrictions. |
HOST | Specify the name of a MVS system that is specified in the object definition’s valid systems list from which to move the object. The HOST parameter is optional. If you do not specify HOST, TOM issues the function on the ACTIVE system. Otherwise, TOM issues the function on the primary system in the VSL. The HOST parameter is mutually exclusive with the SET parameter. |
MOVEDEPS | Specify that TOM moves the selected object, and its dependents, to the system named in the TOHOST parameter. MOVEDEPS is optional. If you do not specify it, only the specified object is moved. When the specified object has dependents, this can cause unpredictable results for the dependents. If a dependent does not have the target system in its VSL, TOM moves the object to the highest priority system in its VSL. The dependents will be stopped and re-started in dependency order. |
MOVEINACT | Specify that TOM moves the object whether it is ACTIVE or not. |
TOHOST | Specify the name of a MVS system from the object definition’s valid systems list to move the object (or set). |
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. |