Using the zmmt command to create migration definitions on z/OS
Before you migrate a WebSphere® Application Server Version 7.0 or later node to Version 9.0, you must create Job Control Language (JCL) jobs (CNTL and DATA datasets) that you will run during the actual migration. You can use the zmmt command to create the appropriate jobs and instructions. Learn how you can use the zmmt command in the migration process.
Before you begin
This topic is about profile configuration migration. To migrate your applications to the latest version, use the WebSphere Application Server Migration Toolkit.
Install WebSphere Application Server Version 9.0 on a z/OS® system containing a Version 7.0 or later configuration.
About this task
-
You can use the zmmt command to create migration jobs for migrating WebSphere Application Server Version 7.0 or later nodes to Version 9.0. The zmmt command itself does not perform the migration; it creates batch jobs and instructions that you can then use to perform the actual migration tasks.
The zmmt command is an alternative to the z/OS Migration Management Tool. You might want to use this command rather than the tool to create migration jobs if you have no workstations with the WebSphere Customization Toolbox available or need to automate the generation of your migration jobs.
You run the zmmt command using a migration response file that you create manually.
Tip: Migrating a WebSphere Application Server application-serving environment requires a fair amount of planning and coordination. If you have not previously migrated an application server, you should first migrate a "practice" standalone application server using a sample response file.Note: In WebSphere Application Server Version 9.0, you can use the z/OS Migration Management Tool or the zmmt command and the jobs that they generate to migrate from Version 7.0 or later to Version 9.0 nodes. After you actually migrate a node, however, you use the WebSphere Application Server Version 9.0 administrative console or scripting to administer it. - The zmmt.sh shell script is located in the
install_root/bin directory.
The shell script uses the following parameters:
Datasets are determined by appending the values ".CNTL" and ".DATA" to the zTargetHLQ value for the profile containing the jobs that are being copied. This operation overwrites existing files of the same name in those datasets.
Procedure
Results
install_root/bin:> zmmt.sh /zmmt/workspace
-responseFile /ZMigDmgr01.responseFile -allocate -transfer<
osgi> Customization definition successfully written to
/zmt/workspace/.metadata/.plugins/com.ibm.ws390.mmt.config/profiles/ZMigDmgr01
Attempting to allocate dataset: ZMMT.CNTL
Allocation successful.
Attempting to allocate dataset: ZMMT.DATA
Allocation successful.
Copying CNTL files to ZMMT.CNTL...
Copy successful.
Copying DATA files to ZMMT.DATA...
Copy successful.
The migration jobs have been copied to the CNTL and DATA datasets. Follow the generated instructions provided in the CNTL dataset to perform the actual migration.
Example
The following examples describe typical command lines with attributes for the zmmt command. In these examples, /xxx can be any directory to which the user invoking the zmmt.sh script has read and write access.