HCL Workload Automation, Version 9.4

datamigrate

Use the datamigrate utility on the master domain manager to import into the database the data that is saved in the flat files created by using composer extract command line in another IBMIBM® Workload Scheduler instance, version 8.3 or later.

Syntax

Use the following syntax and order to import data:

datamigrate -u | -v

datamigrate -<object_type> <object_type_file> [-tmppath <temporary_directory]

Arguments

-u
Displays command usage information and exits.
-v
Displays the command version and exits.
-<object_type> <object_type_file>
-topology topology_filename
Imports all domain, workstation, and workstation class definitions saved in the topology_filename file that is created by using composer command line in the HCL Workload Automation instance.
-prompts prompts_filename
Imports all prompt definitions saved in the prompts_filename file that is created by using composer command line in the HCL Workload Automation instance.
-calendars calendars_filename
Imports all calendar definitions saved in the calendars_filename file that is created by using composer command line in the HCL Workload Automation instance.
-parms parms_filename
Imports all parameter definitions saved in the parms_filename file that is created by using composer command line in the HCL Workload Automation instance.
-resources resources_filename
Imports all resource definitions saved in the resources_filename file that is created by using composer command line in the HCL Workload Automation instance.
-rcgroups rcgroups_filename
Imports all run cycle group definitions saved in the rcgroups_filename file that is created by using composer command line in the HCL Workload Automation instance.
-users users_filename
Imports all user definitions saved in the users_filename file that is created by using composer command line in the HCL Workload Automation instance.
Note: Ensure that you substitute in the users file, all the "*********" entries with the real password values before running the datamigrate utility.
-jobs jobs_filename
Imports all job definitions saved in the jobs_filename file that is created by using composer command line in the HCL Workload Automation instance.
-scheds scheds_filename
Imports all job stream (schedule) definitions saved in the scheds_filename file that is created by using composer command line in the HCL Workload Automation instance.
-tmppath temp_path
temp_path is the temporary path where datamigrate can put its temporary work files. The default is <TWS_installation_dir>\tmp on Windows operating systems and <TWS_installation_dir>/tmp on UNIX systems.

Comments

If you prefer to use the datamigrate utility instead of the composer command with add or replace options, ensure that you follow the correct order to import data.

Starting from version 9.4, Fix Pack 1, it is no longer possible to migrate a job stream containing an external dependency that references a job stream that does not exist. In this case, an error message is displayed.

Examples

To import into the IBM Workload Scheduler V9.2 database the data exported from IBM Workload Scheduler V8.6, run in the following order:
datamigrate -topology topology86.txt 

datamigrate -prompts prompt86.txt

datamigrate -calendars cals86.txt 

datamigrate -parms parms86.txt 

datamigrate -resources res86.txt 

datamigrate -rcgroups rcs86.txt

datamigrate -users users86.txt 

datamigrate -jobs jobs86.txt 

datamigrate -scheds js86.txt