Specifying a z/OS federated node migration configuration in the zmmt command response file: Worksheet

Before you migrate a WebSphere® Application Server for z/OS® Version 7.0 or later node to Version 9.0, you must create Job Control Language (JCL) jobs (CNTL and DATA datasets) that you run on z/OS during the migration. You can use the zmmt command with a response file to create the appropriate migration jobs. Print this worksheet, and use it when you collect and specify information about the WebSphere Application Server for z/OS federated node migration configuration variables in the zmmt command response file.

Before you begin

Supported configurations Supported configurations:

This article is about profile configuration migration. To migrate your applications to the latest version, use the WebSphere Application Server Migration Toolkit. For more information, see the Migration Toolkit on WASdev.

sptcfg

Procedure

  1. Enter create.
  2. Specify values for the name and location.
    Table 1. Name and location . Enter your values:
    Variable Response-file variable Example value Your value
    Profile name profileName Default  
    Profile directory profilePath /AppServer/profiles  
    Template path templatePath zos-migFederated  
  3. Specify values for the target datasets.
    Table 2. Target datasets . Enter your values:
    Variable Response-file variable Example value Your value
    High-level qualifier (HLQ) zTargetHLQ FED  
  4. Specify values for the dataset names, product directory, and intermediate symbolic link.
    Table 3. Dataset names, product directory, and intermediate symbolic link . Enter your values:
    Variable Response-file variable Example value Your value
    JCL procedure library dataset name zmbProclibName SYS1.PROCLIB  
    WebSphere Application Server product directory zmbSMPEHome /usr/lpp/WebSphere/AppServer/V9R0  
    Intermediate symbolic link
      Create intermediate symbolic link intermediateSymlinkPreference Y  
      Path name of intermediate symbolic link IntermediateSymlink /V9/symlink  
  5. Specify values for the configuration file system.
    Table 4. Configuration file system . Enter your values:
    Variable Response-file variable Example value Your value
    Mount point zConfigMountPoint /wasv9config  
    Name zConfigHfsName OMVS.WAS90. CONFIG.HFS  
    Volume, or '*' for SMS zConfigHfsVolume *  
    Primary allocation in cylinders zConfigHfsPrimaryCylinders 420  
    Secondary allocation in cylinders zConfigHfsSecondaryCylinders 100  
    File system type
      Hierarchical File System (HFS) zFilesystemType HFS  
    zSeries File System (ZFS)
  6. Specify values for server customization.

    [9.0.0.3 or later]If you specified a clone migration, you must specify true for Replace Started Procedure Command Names and provide unique procedure names for the new environment. The new environment requires unique procedure names to coexist with the old environment.

    Table 5. Server customization . Enter your values:
    Variable Response-file variable Example value Your value
    From configuration location
      Mount point zmbFromConfigRoot /WebSphere/V7R0  
    Home directory zmbFromWASHomeDir AppServer  
    To configuration location
      Mount point zmbToConfigRoot /wasv9config  
    Home directory zmbToWASHomeDir AppServer  
    Daemon procedure name zmbDaemonProcName BBO9DMN  
    Controller procedure name zmbControllerProcName BBO9ACR  
    Servant procedure name zmbServantProcName BBO9ASR  
    Adjunct procedure name zmbAdjunctProcName BBO9CRA  
    Replace started procedure command names zmbReplaceStartedProcedure Names True  
    WebSphere administrator's user ID zmbAdminUserid XXXXXXXX  
    WebSphere administrator's password zmbAdminPassword XXXXXXXX  
    Table 6. Server customization . Enter your values:
    Variable Response-file variable Example value Your value
    Migrate administrative console customized "My tasks" settings
      Migrate the settings for "My tasks" saved in the default workspace user root location (D) zmbWorkspaceRoot Preference D  
    Migrate the settings for "My tasks" saved in a user defined workspace root location (U)
      User defined workspace root location zmbUserWorkspaceRoot    
  7. Specify values for migration process options.
    Table 7. Migration process options. Enter your values:
    Variable Response-file variable Example value Your value
    Migration trace options
      Enable script tracing zmbEnableScriptingTrace False  
    Enable profile creation tracing zmbEnableProfileTrace False  
    Enable pre-upgrade tracing zmbEnablePreUpgradeTrace False  
    Enable post-upgrade tracing zmbEnablePostUpgradeTrace False  
    JVM options for migration processes
      Initial heap size (MB) zmbInitialHeapSize 512  
      Maximum heap size (MB) zmbMaxHeapSize 768  
    Other options
    Temporary directory location zmbTempDirectory /tmp/migrate  
    Migration definition identifier zmbTimestamp 05124043  
    Java temporary directory location zmbJavaTempDirectory /tmp  
  8. Specify how to set port values and resolve port conflicts.

    [9.0.0.3 or later]If you specified a clone migration, you must specify zmbStartingPort, and set zmbSetPorts to startingPort, as this configuration is the only one that is valid. These settings are required to generate unique ports for every server in the profile.

    Table 8. Port values. Enter your values:
    Variable Response-file variable Example value Your value
    Setting ports
    Use the same ports that the old profile used (useOld) zmbSetPorts useOld  
    Generate new ports, incrementing from a common starting port value (startingPort)  
      Starting port value zmbStartingPort 1024  
    Port conflict resolution
    Increment from the conflicted port value (incrementCurrent) zmbResolvePortConflicts incrementCurrent  
    Increment from a common starting port value (startingPort)  
      Starting port value zmbStartingPort 1024  
  9. [9.0.0.3 or later]Specify value for clone migration.
    Table 9. Name and location. Enter your values:
    Variable Response-file variable Example value Your value
    Clone migration zmbCloneMigration False  
  10. [9.0.0.3 or later]If you specified true for a clone migration, specify values for the connection to the new deployment manager.
    Table 10. Name and location. Enter your values:
    Variable Response-file variable Example value Your value
    New deployment manager hostname zmbCloneDmgrHostname myserver.example.com  
    New deployment manager SOAP port zmbCloneDmgrSoapPort 8879  
    New deployment manager RMI port zmbCloneDmgrRmiPort 8880  
  11. [9.0.0.3 or later]If you specified true for a clone migration, specify values for new short names.
    Table 11. Name and location. Enter your values:
    Variable Response-file variable Example value Your value
    New cell short name zmbNodeShortName MIGRNODE  
    New node short name zmbServerShortName V9S  
  12. Specify values for job statement definition.
    Table 12. Job statement definition . Enter your values:
    Variable Response-file variable Example value Your value
    //jobname JOB zJobStatement1 (ACCTNO,ROOM),'USERID', CLASS=A,REGION=OM  
    //* zJobStatement2 //*  
    //* zJobStatement3 //*  
    //* zJobStatement4 //*  

Icon that indicates the type of topic Task topic



Timestamp icon Last updated: March 6, 2017 0:04
File name: tmig_zmmt_cmd_fednodewrk.html