このページでは、アプリケーションを Mainframe Assessment Tool にアップロードし、アップロードされたコードベースで Mainframe Assessment Tool が検出したアセットの評価を行う方法について説明します。
アセットの検出は、独自に行うことも、Google のカスタマー エンジニアに支援を依頼することもできます。
始める前に
評価の準備として、次の前提条件を満たしていることを確認してください。
メインフレーム アプリケーション ファイルを Mainframe Assessment Tool にアップロードする
アプリケーション ファイルを Mainframe Assessment Tool にアップロードする手順は次のとおりです。
移行するすべてのアプリケーションを含む ZIP ファイルを作成します。
Mainframe Assessment Tool でサポートされているのは、最大サイズが 400 MB の ZIP ファイルのみです。 アプリケーションの ZIP ファイルが 400 MB を超える場合は、ビジネス ドメインに基づいてファイルを小さな ZIP ファイルに分割し、ドメインごとに ZIP ファイルをアップロードすることを検討してください。
アプリケーションにプログラムやテーブルなどの外部アーティファクトへの参照が含まれている場合は、これらの依存関係も含めることをおすすめします。可能であれば、次のタイプのソースコードを提供してください。
- COBOL プログラム（
cob、cbl） - COBOL コピーブック（
inc、cpy） - Easytrieve プログラム（
ezt） - HLASM プログラム（
asm） - JCL ジョブ（
jcl） - JCL プロシージャ（
proc） - JCL インクルード
- JCL カードデータ（
ctl） - PL/I プログラム（
pli、pl1） - RPG/RPGLE プログラム（
rpg、rpgle） - RPG/RPGLE インクルード ファイル（
rpginc、rpgleinc） - BMC Control-M のスケジューラ構成
ZIP ファイルにバイナリやソース以外のファイルを含めないでください。
- COBOL プログラム（
ZIP ファイルを Mainframe Assessment Tool にアップロードする手順は次のとおりです。
ローカルマシンで Mainframe Assessment Tool を開くには、ウェブ ブラウザ ウィンドウを開き、
http://localhost:PORTに移動します。PORTは、ローカルマシンで Mainframe Assessment Tool へのトンネル接続に使用したポート番号に置き換えます。[ホーム] ページで [評価を作成] をクリックします。
[名前] に名前を入力します。
省略可: [説明] に評価の説明を入力します。
ZIP ファイルをアップロードするには、[ファイルを選択] をクリックします。ファイル ブラウザが開きます。アップロードする ZIP ファイルを選択します。一度にアップロードできるファイルは 1 つだけです。
[次へ] をクリックします。
AI によって生成された分析情報を構成する手順は次のとおりです。
COBOL コードの段落レベルの要約を生成するには、[詳細な要約] を選択します。デフォルトでは、このオプションが選択されています。
Gemini によって生成された評価仕様のテストケースを生成するには、[テストケース] を選択します。デフォルトでは、このオプションは選択されていません。
[**追加の生成ガイダンス**] に、AI 生成時に Gemini プロンプトに追加するテキストを入力します。
[次へ] をクリックします。
評価の Gemini モデルと品質レベルを構成するには、[モデルと品質] ステップを構成して、[次へ] をクリックします。
デフォルトでは、Mainframe Assessment Tool は推奨されるバランス重視 の品質レベルを使用します。 品質レベル、特定のモデルの選択、 リージョン内でのデータの保持について詳しくは、 モデルと品質を選択するをご覧ください。
省略可: 異なる機能領域を表す 1 つ以上のドメインを追加するには、[ドメインを追加] をクリックします。
ドメインを使用すると、評価が完了した後、特定のコンテキストに基づいて結果をフィルタして確認できます。
[次へ] をクリックします。
[評価を作成] をクリックします。
ZIP ファイルをアップロードすると、Mainframe Assessment Tool はソースコードを解凍して処理します。[評価] ページには、検出されたアセットごとに新しいエントリがテーブルに表示され、評価ステータスが表示されます。
- 保留中: 評価の順番待ちです。
- 処理中: 分析が進行中です。
- 分析済み: 評価が完了しました。
- 失敗: 評価が完了しませんでした。
ファイルをインポートした後にエラーが表示された場合は、Mainframe Assessment Tool でエラー メッセージを直接確認できます。
アイテムの評価の進捗状況の詳細を表示するには、テーブル内のアイテムの横にある参照 ID をクリックします。ステータスとともにすべてのステップが表示されるページが開きます。
モデルと品質を選択する
評価を作成または編集するときに、評価の Gemini モデルを構成します。これらの設定はその評価にのみ適用されます。
デフォルトでは、Mainframe Assessment Tool は、選択した品質レベルに基づいて各評価ステップのモデルを最適化します。このツールは、複雑な推論ステップをより重いモデルに、単純なステップをより軽いモデルにルーティングします。
品質レベルを選択する
[最適化対象] で、次のいずれかの品質レベルを選択します。
- バランス重視 （推奨）: ほとんどの評価で速度と深さのバランスを取ります。 これがデフォルトのレベルです。
- 高速: より軽いモデルを使用して、最も迅速に結果を返します。
- 拡張: より重いモデルを使用して、分析の深さを最大化します。
各品質レベルには、各ステップで使用される Gemini モデルが一覧表示されます。
単一のモデルを指定する
レベルごとに最適化するのではなく、単一のモデルですべての評価ステップを実行するには、[特定のモデルを使用する] を選択し、リストからモデルを選択します。各モデルには、 [**一般提供**] または [**プレビュー**]のラベルが付いています。
Mainframe Assessment Tool は、利用可能な Agent Platform リージョン内のすべてのゾーンをサポートしています。
データ所在地を適用する
デフォルトでは、Mainframe Assessment Tool は、評価リージョン、マルチリージョン、グローバル Agent Platform エンドポイントなど、選択したモデルに最適なロケーションにモデル呼び出しをルーティングします。
モデル呼び出しを評価リージョンとその関連するマルチリージョンに制限するには、[リージョン内にデータを保持する] を有効にします。この設定を有効にすると、Mainframe Assessment Tool は次の処理を行います。
- 評価リージョンで使用できない Gemini モデルを必要とする品質レベルを無効にします。これらのレベルには [このリージョンでは利用できません] というラベルが付いています。
- 評価リージョンで使用できないモデルを、特定のモデルリストから非表示にします。
評価リージョンで使用可能なサポート対象モデルがない場合、[リージョン内にデータを保持する] を有効にすると評価を実行できません。評価を進めるには、[リージョン内にデータを保持する] を無効にして、リージョン外でのモデル呼び出しを許可します。
既存の評価にファイルを追加する
評価を作成した後、ZIP ファイルを追加できます。 新しい ZIP ファイルのファイルは、評価内の既存のファイルとマージされます。 既存のファイルを置き換える 場合は、新しい ZIP ファイルに、置き換えるファイルとまったく同じパス構造のファイルを含める必要があります。
既存の評価にファイルを追加する手順は次のとおりです。
- ウェブブラウザで Mainframe Assessment Tool を開きます。
- ナビゲーション メニューで [評価] をクリックします。
- [評価] ページで、変更する評価を見つけて、 [評価を開く] をクリックします。
- [**ファイルを追加**] をクリックします。
- [ファイルを選択] をクリックして、アップロードする ZIP ファイルを選択します。 一度にアップロードできるファイルは 1 つだけです。
- [追加] をクリックします。
ファイルをアップロードすると、Mainframe Assessment Tool は分析を再開します。 ファイルを置き換えると、ファイルが完全に再評価され、これらのファイルの既存の分析が変更される可能性があります。再処理中、再処理中のファイルの横に [古い] インジケーターが表示されます。
評価の詳細と設定を更新する
評価を作成した後、名前と説明を更新し、AI によって生成された分析情報の設定を変更できます。
評価の詳細または設定を更新する手順は次のとおりです。
- ウェブブラウザで Mainframe Assessment Tool を開きます。
- ナビゲーション メニューで [評価] をクリックします。
- [評価] ページで、変更する評価を見つけて、 [評価を開く] をクリックします。
- [settings][**評価設定を編集**] をクリックします。
- 省略可: [評価の詳細] ステップで、名前と説明を編集して [次へ] をクリックします。
- 省略可: [AI 設定] ステップで、必要に応じて AI 設定を変更して [次へ] をクリックします。
- 省略可: [モデルと品質] ステップで、モデルまたは品質レベルを構成して [次へ] をクリックします。詳細については、モデルと品質を選択するをご覧ください。
- [ドメイン] ステップで [次へ] をクリックします。評価を作成した後は、ドメインを編集できません。
- [評価を更新] をクリックします。
設定を更新すると、Mainframe Assessment Tool は分析を再開します。
次のステップ
- 評価結果を確認して理解する方法を学習する。