zmmt コマンドを使用して z/OS スタンドアロン・アプリケーション・サーバーをマイグレーションするための構成変数

WebSphere® Application Server for z/OS® にマイグレーションする前に、実際のマイグレーション中に実行するジョブ制御言語 (JCL) ジョブ (CNTL および DATA データ・セット) を作成する必要があります。応答ファイルで zmmt コマンドを使用して、該当するマイグレーション・ジョブを作成することができます。 マイグレーションの応答ファイルには、スタンドアロン・アプリケーション・サーバーのマイグレーション・ジョブの作成に使用する一連の構成変数が含まれています。

サポートされる構成 サポートされる構成:

この項目では、プロファイル構成マイグレーションについて説明します。アプリケーションを最新バージョンにマイグレーションするには、WebSphere Application Server Migration Toolkit を使用します。詳しくは、WASdev の Migration Toolkit を参照してください。

sptcfg

応答ファイル変数

作成
新規マイグレーション定義の作成を示す、必須キーワード。
intermediateSymlinkPreference
中間シンボリック・リンクをセットアップするかどうか。

中間シンボリック・リンクを指定すると、構成ファイル・システムから中間シンボリック・リンクへのシンボリック・リンクが作成されます。中間シンボリック・リンクを指定しない場合、製品ファイル・システムへのシンボリック・リンクが直接作成されます。

IntermediateSymlink
中間シンボリック・リンクのパス名

このリンクは、カスタマイズ・ジョブによって作成され、製品ファイル・システム・ディレクトリーを指します。

profileName
マイグレーション時に作成されるプロファイルの名前

これは、z/OS プラットフォームでは常に「default」です。

profilePath
生成されたマイグレーション定義の出力が書き込まれる、完全修飾パス。
templatePath
テンプレート・パス
以下の値のいずれかになります。
  • zos-migDmgr

    デプロイメント・マネージャーのマイグレーション

  • zos-migFederated

    統合ノードのマイグレーション

  • zos-migStandalone

    スタンドアロン・アプリケーション・サーバーのマイグレーション

zConfigHfsName
構成ファイル・システムを含む MVS™ データ・セットの名前

この名前は、構成ファイル・システムを作成するマイグレーション・ジョブへの入力データとして使用されます。

zConfigHfsPrimaryCylinders
構成ファイル・システムに割り振られる 1 次シリンダーの数

アプリケーション・サーバーでは、このデータ・セットに必要な総スペースは、 インストールされたアプリケーションのサイズと数に従って増えます。

推奨: 推奨される最小サイズは 420 シリンダーです。
zConfigHfsSecondaryCylinders
構成ファイル・システムに割り振られる 2 次シリンダーの数
推奨: 推奨される最小サイズは 100 シリンダーです。
zConfigHfsVolume
上記のデータ・セットを格納する DASD ボリューム通し番号。「*」を指定すると、SMS がボリュームを選択します。

「*」を使用する場合は、 ボリュームを選択できるように SMS 自動クラス選択 (ACS) ルーチンが準備されている必要があります。 SMS がデータ・セット割り振りを自動的に処理するようにセットアップされていない場合は、 ボリュームを明示的にリストしてください。

zConfigMountPoint
アプリケーション・データおよび環境ファイルが書き込まれる、ファイル・システム・ディレクトリーのマウント・ポイント。

構成ファイル・システムは、マイグレーションされるノードの構成が物理的に保管される場所です。マイグレーションされるノード上に既に適切なファイル・システムがある場合は、既存のバージョン 9.0 ファイル・システムの使用を選択できます。既存のバージョン 9.0 ファイル・システムの使用を選択する場合、このツールを使用して作成されるマイグレーション・ジョブを実行する前に、ここで指定するマウント・ポイントが存在していることを確認する必要があります。 マイグレーションされるノード上にバージョン 9.0 ファイル・システムを新規作成する場合、実際のマイグレーション・プロセス中にオプションのジョブ BBOMBHFS または BBOMBZFS を実行するまで、新規のファイル・システムは実際には作成されません。 いずれの場合にも、ここで、マウント・ポイントの正確な値を指定する必要があります。

zFilesystemType
ファイル・システムのタイプ。
以下の値のいずれかになります。
  • HFS

    階層ファイル・システムを使用して、構成ファイル・システムのデータ・セットを割り振ってマウントします。

  • ZFS

    zSeries ファイル・システムを使用して、構成ファイル・システムのデータ・セットを割り振ってマウントします。

zJobStatement1 . . . n
生成されたマイグレーション・ジョブに使用される、カスタマイズ可能な JOB ステートメント。

調整されるすべてのマイグレーション・ジョブでは JOB ステートメントが必要となります。インストール済み環境に有効な JOB ステートメントを入力します。マイグレーションの作成プロセスによって、すべての生成されたジョブでジョブ名が更新されます。そのため、JOB ステートメントのその部分に関して気にかける必要はありません。 継続行が必要であれば、コメント行を継続行で置き換えます。

zTargetHLQ
生成されたジョブと命令を含む z/OS ターゲット・データ・セットの高位修飾子
注: データ・セットの高位修飾子として、マルチレベルの高位修飾子を指定することができます。
zmbAppMigrationPreference
インストール済みのアプリケーションのマイグレーション方法を指定します。
以下の値のいずれかになります。
  • D

    マイグレーションの一部として、ユーザー・エンタープライズ・アプリケーションをデフォルトのアプリケーション・インストール・ディレクトリーにインストールします。

  • Y

    マイグレーションの一部として、ユーザー・エンタープライズ・アプリケーションを、次に示す変数で指定されたディレクトリーにインストールします。

    zmbAppInstallDirLine1
    zmbAppInstallDirLine2
    WebSphere Application Server がエンタープライズ・アプリケーションをインストールするロケーション。

    アプリケーションをアプリケーションのマイグレーション設定に従ってマイグレーションおよびインストールしたいことを指定する際にこのロケーションを使用します。カスタマイズ環境に特定したロケーションを選択するか、またはデフォルト・ロケーションを使用するかをオプションで選択することができます。

    ロケーションのパス長が 60 文字を超える場合は、以下に示すように 2 行で指定する必要がありますが、合計の長さが 120 文字を超えてはいけません。

    zmbAppMigrationPreference に Y を指定しない限り、この 2 つのフィールドはブランクのままにしておいてください。

  • S

    ユーザー・エンタープライズ・アプリケーションをマイグレーション時に実際にインストールすることなく、WebSphere Application Server バージョン 9.0installableApps ディレクトリーにインストールできるように準備します。

    これらのアプリケーションをインストールする際に使用できるスクリプトが生成され、マイグレーション・バックアップ・ディレクトリーに保存されます。 WebSphere Application Server for z/OS の場合は、このバックアップ・ディレクトリーのロケーションは、zmbTempDirectory 変数で指定する一時ディレクトリーを基準とします。バックアップ・ディレクトリーのロケーションは、派生マイグレーション ID およびマイグレーションされるノードのタイプによって決定されます。 例えば、一時ディレクトリーとして /tmp/migrate を指定したとき、派生したマイグレーション ID が 55449 だとすれば、生成されたスクリプトのロケーションは次のようになります。
    /tmp/migrate/55449/nodetype_backup/
    ここで、nodetype は、マイグレーションされるノードのタイプによって、dmgr、fed、または base です。

    これらのファイルは、 マイグレーション完了後に任意の時点および任意の組み合わせで実行することができます。また、アプリケーションのインストールをより効率的に行うために、これらのファイルを再編成して結合することもできます。 追加情報については、『Wsadmin ツール』を参照してください。

  • P

    マイグレーションの一部として、ユーザー・エンタープライズ・アプリケーションをインストールして、以前のバージョンと同じアプリケーション・インストール・ディレクトリーを保持します。

    制約事項: このオプションを選択すると、このロケーションは WebSphere Application Server バージョン 7.0 以降 の既存のインストールとバージョン 9.0 のインストールによって共有されます。 マイグレーションされたアプリケーションを以前のバージョンのアプリケーションと同じロケーションに保持する場合は、以下の制約事項が適用されます。
    • WebSphere Application Server バージョン 9.0 バージョン 6.1 混合ノードのサポート制限に従う必要があります。 つまり、wsadmin コマンドを呼び出す場合に以下のサポートは使用できません。
      • JSP のプリコンパイル
      • バイナリー構成の使用
      • EJB のデプロイ
    • バージョン 7.0 以降 のインストール・システムを管理する際に、 後でこれらのロケーションからアプリケーションを削除する場合、 マイグレーション済みのアプリケーションを誤って失う危険性があります。
    • バージョン 7.0 以降 の変数に相対してインストールされたすべてのアプリケーションは、バージョン 9.0 でのその変数に割り当てられるロケーションに相対してインストールされます。すなわち、絶対ロケーションは保持されず、新しい バージョン 9.0 環境内の相対ロケーションに、アプリケーションがマイグレーションされることになります。
      マイグレーションされるアプリケーションの deployment.xml ファイル内の binariesURL が WebSphere Application Server に対して相対的なパスである場合、つまり、 $(APP_INSTALL_ROOT)$(WAS_INSTALL_ROOT) などで始まっている場合は、 アプリケーションが新しいロケーションにインストールされるときに、新しい WebSphere Application Server 変数値を使用してパスが解決されます。このオプションを選択する場合は、以下の結果になります。
      • WebSphere Application Server 変数に相対的なディレクトリー・ロケーションにインストールされたアプリケーションは、いずれもバージョン 9.0 のその変数値の下にインストールされます。
      • WebSphere Application Server 変数に相対的でないディレクトリー・ロケーションにインストールされたアプリケーションは、いずれもその同じディレクトリーにマイグレーションされ、上書きされます。アプリケーションが /employee_records/retrieval_Apps ディレクトリー内にインストールされた場合は、例えば、アプリケーションは /employee_records/retrieval_Apps ディレクトリーにマイグレーションされ、上書きされます。
  • N

    ユーザー・エンタープライズ・アプリケーションに関して何も行いません。

注: WebSphere Application Server システム・アプリケーションは、ここで設定された値に関係なくマイグレーションされます。
zmbControllerProcName
マイグレーションされたコントローラーを開始するのに使用する JCL 開始済みプロシージャーの名前。

バージョン 9.0 にマイグレーションする場合、JCL 開始済みプロシージャーをアップグレードする必要があります。新規の開始済みプロシージャーは、マイグレーション中に生成されます。コントローラー・プロシージャーに新しい名前を指定するか、または古いコントローラー・プロシージャーを使用することができます。

zmbServantProcName
マイグレーションされたサーバントを開始するのに使用する JCL 開始済みプロシージャーの名前。

バージョン 9.0 にマイグレーションする場合、JCL 開始済みプロシージャーをアップグレードする必要があります。新規の開始済みプロシージャーは、マイグレーション中に生成されます。サーバント・プロシージャーに新しい名前を指定するか、または古いサーバント・プロシージャーを使用することができます。

zmbDaemonProcName
マイグレーションされたデーモンを開始するのに使用する JCL 開始済みプロシージャーの名前。

バージョン 9.0 にマイグレーションする場合、JCL 開始済みプロシージャーをアップグレードする必要があります。新規の開始済みプロシージャーは、マイグレーション中に生成されます。デーモン・プロシージャーに新しい名前を指定するか、または古いデーモン・プロシージャーを使用することができます。

zmbAdjunctProcName
マイグレーションされた付属プロセスを開始するのに使用する JCL 開始済みプロシージャーの名前。

バージョン 9.0 にマイグレーションする場合、JCL 開始済みプロシージャーをアップグレードする必要があります。新規の開始済みプロシージャーは、マイグレーション中に生成されます。付属プロセス・プロシージャーに新しい名前を指定するか、または古い付属プロセス・プロシージャーを使用することができます。

zmbReplaceStartedProcedureNames
構成内の START コマンドを、新しい名前を指定して (true) 更新するか、または同じ名前を保持して (false) 更新するかを指定します。

JCL プロシージャーに新しい名前を指定した場合は、WebSphere Application Server 構成内の対応する START コマンドを、新しいプロシージャー名と一致するように更新する必要があります。この構成の更新を実行するには、この変数に true を指定します。

同じプロシージャー名を使用する場合には、この変数に false を指定します。 マイグレーションするノードの特定プロセス・タイプ (例えば、すべてのサーバント) のサーバーすべてに、一貫して同じプロシージャー名を使用しない場合には、この変数に false を指定することをお勧めします。 この場合、同じ START コマンドのままで、マイグレーション中にテンプレートとして生成されたプロシージャーを使用して、 手動でプロシージャーを置き換える必要があります。

注:
  • バージョン 9.0 の構成では、バージョン 7.0 以降 の構成で使用したものとは別の JCL プロシージャーを使用する必要があります。マイグレーション・プロセスは、 ここで指定したプロシージャー名を使用して、新規バージョン 9.0 JCL プロシージャーを作成します。
  • バージョン 7.0 以降 の構成で使用したものと同じ名前を使用する場合、マイグレーション・プロセスは既存のプロシージャーをオーバーレイします。同じ名前を使用している場合は、後でロールバックが必要となる場合に備えて、マイグレーション・ジョブを実行する前に、バージョン 7.0 以降 の既存のプロシージャーを必ずバックアップするようにしてください。
  • バージョン 9.0 の構成では、バージョン 7.0 以降 の構成で使用したものとは別の JCL プロシージャーを使用する必要があります。マイグレーション・プロセスは、 ここで指定したプロシージャー名を使用して、新規バージョン 9.0 JCL プロシージャーを作成します。
  • バージョン 7.0 以降 の構成で使用したものと同じ名前を使用する場合、マイグレーション・プロセスは既存のプロシージャーをオーバーレイします。同じ名前を使用している場合は、後でロールバックが必要となる場合に備えて、マイグレーション・ジョブを実行する前に、バージョン 7.0 以降 の既存のプロシージャーを必ずバックアップするようにしてください。
zmbEnablePostUpgradeTrace
WASPostUpgrade プロセス中に、トレースを使用可能にするか (true)、使用不可にするか (false) を指定します。
zmbEnablePreUpgradeTrace
WASPreUpgrade プロセス中に、トレースを使用可能にするか (true)、使用不可にするか (false) を指定します。
zmbEnableProfileTrace
プロファイルの作成中に、トレースを使用可能にするか (true)、使用不可にするか (false) を指定します。
zmbEnableScriptingTrace
ホームの作成、プロファイルおよびマイグレーション・ツールの呼び出し、およびマイグレーションの最終処理段階について、トレースを使用可能にするか (true)、使用不可にするか (false) を指定します。
zmbFromConfigRoot
マイグレーション元の構成のマウント・ポイント。
zmbFromWASHomeDir
マイグレーション元の構成のホーム・ディレクトリー。
zmbInitialHeapSize
JVM ヒープ用に割り振られる初期メモリー。
zmbInstallDefaultApp
Snoop サーブレット、Hello サーブレット、および HitCount サーブレットを含んでいるデフォルト・アプリケーションをインストールします。
zmbInstallSamples
サンプル・アプリケーションをデプロイするかどうかを指定します。
注: これらのアプリケーションは、 WebSphere Application Server Network Deployment セル内ではサポートされません。

アプリケーション・サーバーを使用して最新の技術的進歩を評価するには、サンプル・アプリケーションをインストールしてください。 サンプル・アプリケーションを実動アプリケーション・サーバー環境にデプロイすることは推奨されていません。

zmbJavaTempDirectory
マイグレーション中に一時ファイルの作成と保管のために Java 仮想マシンによって使用される Java 一時ディレクトリー。
zmbManagedBaseNode
ソース・プロファイルが管理エージェントに登録されるかどうかを指定します。
zmbMaxHeapSize
JVM ヒープ用に割り振ることができる最大ヒープ・サイズ。
zmbNewAdminAgentHostname
ソース管理エージェントのホスト名。
zmbNewAdminAgentPassword
セキュリティーが有効になっている場合、ソース管理エージェントの管理セキュリティー・パスワード。
zmbNewAdminAgentProfilePath
ソース管理エージェントのファイル・システム・パス。
zmbNewAdminAgentSoapPort
ソース管理エージェントが SOAP 接続のために使用するポート。
zmbNewAdminAgentUsername
セキュリティーが有効になっている場合、ソース管理エージェントのユーザー名。
zmbOldAdminAgentHostname
ターゲット管理エージェントのホスト名。
zmbOldAdminAgentPassword
セキュリティーが有効になっている場合、ターゲット管理エージェントの管理セキュリティー・パスワード。
zmbOldAdminAgentProfilePath
ターゲット管理エージェントのファイル・システム・パス。
zmbOldAdminAgentSoapPort
ターゲット管理エージェントが SOAP 接続のために使用するポート。
zmbOldAdminAgentUsername
セキュリティーが有効になっている場合、ターゲット管理エージェントのユーザー名。
zmbProclibName
WebSphere Application Server for z/OS カタログ式プロシージャーのコピー先となる既存のプロシージャー・ライブラリー。
zmbResolvePortConflicts
以下のいずれかの値を指定することによって、ポート競合をどのように処理するのかを定義します。
  • incrementCurrent

    ポートの競合が検出された場合、競合するポートから始めて、次に使用可能なポート値になるまでポート値が増やされます。

  • startingPort
    ポートの競合が検出された場合、指定された値から始めて、次に使用可能なポート値になるまでポート値が増やされます。
    注: zmbResolvePortConflictszmbSetPorts の両方が startingPort に設定されている場合、zmbResolvePortConflicts 変数は無視されます。
    zmbStartingPort
    新しいポートの生成を始める開始ポート値。
zmbSetPorts
以下のいずれかの値を指定することによって、新しいプロファイルで使用するポート値を定義します。
  • useOld

    ソース・プロファイルに定義されているポート値を再使用します。

  • generateNew

    ターゲット・プロファイル内の各ポートに対してカスタム値を設定します。

  • startingPort

    指定したポート値から増分して新しいポートを生成します。競合するポートは自動的に解決されます。

    zmbStartingPort
    新しいポートの生成を始める開始ポート値。
zmbSMPEHome
WebSphere Application Server バージョン 9.0 のインストール済み製品のファイル・システムがあるロケーション。
zmbTempDirectory
前の構成のバックアップとマイグレーション・トレースが書き込まれるディレクトリー。

マイグレーション中に、前バージョンの構成のバックアップ・コピーが必要になります。このバックアップのデフォルト・ロケーションは /tmp/migrate です。/tmp ファイル・システムに、バックアップ構成を保管するのに十分なスペースがない場合は、別のロケーションを指定することができます。 バックアップ・コピーのデフォルト・ロケーションの オーバーライドを選択する場合のベスト・プラクティスは、同じ命名規則を保持し、 /tmp 部分を /myTemp/migrate などの別のパスに 置き換えることです。

zmbTimestamp
一時ディレクトリーの下にディレクトリーを作成する際に使用される ID。 作成されるディレクトリーには、一時的なマイグレーション・データ・セットとバックアップ構成データが格納されます。
zmbToConfigRoot
マイグレーション先の構成のマウント・ポイント。

これは、zConfigMountPoint 変数に指定されている値と同じです。

zmbToWASHomeDir
マイグレーション先の構成のホーム・ディレクトリー。
zmbWorkspaceRootPreference
デフォルトのワークスペース・ユーザー・ルート・ロケーションに保存されている管理コンソール・カスタマイズの「マイ・タスク」設定をマイグレーションするか (D)、ユーザー定義のワークスペース・ルート・ロケーションに保存されている設定をマイグレーションするか (U)、そのいずれか。
zmbUserWorkspaceRoot
ユーザー定義のワークスペース・ルート・ロケーション。
intermediateSymlinkPreference
中間シンボリック・リンクをセットアップするかどうか。

中間シンボリック・リンクを指定すると、構成ファイル・システムから中間シンボリック・リンクへのシンボリック・リンクが作成されます。中間シンボリック・リンクを指定しない場合、製品ファイル・システムへのシンボリック・リンクが直接作成されます。

IntermediateSymlink
中間シンボリック・リンクのパス名

このリンクは、カスタマイズ・ジョブによって作成され、製品ファイル・システム・ディレクトリーを指します。

スタンドアロン・アプリケーション・サーバーのマイグレーションに使用される応答ファイルのサンプル

createEnableIntermediateSymlink=false
EnableJavaTmpDir=true
intermediateSymlinkPreference=N
profileName=default
profilePath=<root>/profiles/ZMigSASrv01
templatePath=<root>/profileTemplates/zos-migStandalone
zConfigHfsName=OMVS.WAS90.CONFIG.HFS
zConfigHfsPrimaryCylinders=420
zConfigHfsSecondaryCylinders=100
zConfigHfsVolume=*
zConfigMountPoint=/wasv9config
zFilesystemType=HFS
zJobStatement1=(ACCTNO,ROOM),'USERID',CLASS=A,REGION=0M
zJobStatement2=//*
zJobStatement3=//*
zJobStatement4=//*
zTargetHLQ=SAS
zmbAdjunctProcName=BBO9CRA
zmbAppInstallDirLine1=/wasv9config/AppServer/profiles/default/installedApps
zmbAppInstallDirLine2= 
zmbAppMigrationPreference=D
zmbControllerProcName=BBO9ACR
zmbDaemonProcName=BBO9DMN
zmbEnablePostUpgradeTrace=0
zmbEnablePreUpgradeTrace=0
zmbEnableProfileTrace=0
zmbEnableScriptingTrace=0
zmbFromConfigRoot=/WebSphere/V7R0
zmbFromWASHomeDir=AppServer
zmbInitialHeapSize=512
zmbInstallDefaultApp=false
zmbInstallSamples=false
zmbJavaTempDirectory=/tmp
zmbManagedBaseNode=true
zmbMaxHeapSize=768
zmbNewAdminAgentHostname=localhost
zmbNewAdminAgentProfilePath=/WebSphere/V9R0/AdminAgent
zmbNewAdminAgentSoapPort=8880
zmbOldAdminAgentHostname=localhost
zmbOldAdminAgentProfilePath=/WebSphere/V7R0/AdminAgent
zmbOldAdminAgentSoapPort=8879
zmbProclibName=SYS1.PROCLIB
zmbReplaceStartedProcedureNames=true
zmbResolvePortConflicts=incrementCurrent
zmbSMPEHome=/usr/lpp/WebSphere/AppServer/V9R0
zmbServantProcName=BBO9ASR
zmbSetPorts=useOld
zmbTempDirectory=/tmp/migrate
zmbTimestamp=05160419
zmbToConfigRoot=/wasv9config
zmbToWASHomeDir=AppServerzmbWorkspaceRootPreference=D

トピックのタイプを示すアイコン 概念トピック



タイム・スタンプ・アイコン 最終更新: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-zos&topic=cmig_zmmt_cmd_sappservar
ファイル名:cmig_zmmt_cmd_sappservar.html