評価の作成と更新

このページでは、アプリケーションを Mainframe Assessment Tool にアップロードし、アップロードされたコードベースで Mainframe Assessment Tool が検出したアセットの評価を行う方法について説明します。

アセットの検出は、独自に行うことも、Google のカスタマー エンジニアに支援を依頼することもできます。

始める前に

評価の準備として、次の前提条件を満たしていることを確認してください。

• Mainframe Assessment Tool 用に Google Cloud プロジェクトを構成する
• Mainframe Assessment Tool を設定してアクセスする

メインフレーム アプリケーション ファイルを Mainframe Assessment Tool にアップロードする

アプリケーション ファイルを Mainframe Assessment Tool にアップロードする手順は次のとおりです。

1. 移行するすべてのアプリケーションを含む 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）

   バイナリやソース以外のファイルを ZIP ファイルに含めないでください。

2. zip ファイルを Mainframe Assessment Tool にアップロードする手順は次のとおりです。

   1. ローカルマシンで Mainframe Assessment Tool を開くには、ウェブブラウザ ウィンドウを開いて http://localhost:PORT に移動します。

      PORT は、Mainframe Assessment Tool へのトンネル接続用にローカルマシンで使用したポート番号に置き換えます。

   2. [ホーム] ページで、[評価を作成] をクリックします。

   3. [名前] に名前を入力します。

   4. 省略可: [説明] に、評価の説明を入力します。

   5. zip ファイルをアップロードするには、[ファイルを選択] をクリックします。ファイル ブラウザが開きます。アップロードする ZIP ファイルを選択します。一度にアップロードできるファイルは 1 つのみです。

   6. [次へ] をクリックします。

3. AI 生成の分析情報を構成する手順は次のとおりです。

   1. COBOL コードの段落レベルの要約を生成するには、[Detailed summaries] を選択します。デフォルトでは、このオプションが選択されています。

   2. Gemini によって生成された評価仕様のテストケースを生成するには、[テストケース] を選択します。デフォルトでは、このオプションは選択されていません。

   3. メインフレーム言語を Python、Java、C#、SQL に変換するコードサンプルを生成するには、[コード候補] を選択します。デフォルトでは、このオプションは選択されていません。

   4. [技術スタックのヒント] に、Gemini が特定の技術スタックのコードを生成するのに役立つテキストを入力します。たとえば、「Spring Boot and MySQL」と入力します。

   5. [次へ] をクリックします。

4. 省略可: 別の機能領域を表すドメインを 1 つ以上追加するには、[ドメインを追加] をクリックします。

   この情報は自動割り当てに使用され、評価の完了後に特定のコンテキストに基づいて結果をフィルタして確認できます。

5. [次へ] をクリックします。

6. [評価を作成] をクリックします。

zip ファイルをアップロードすると、Mainframe Assessment Tool はソースコードを解凍して処理します。[評価] ページには、検出されたアセットごとにテーブルに新しいエントリが表示され、評価ステータスが示されます。

• [保留中]: 評価は順番待ちです。
• 進行中: 分析が進行中です。
• 分析済み: 評価が完了しました。
• 失敗: 評価が完了しませんでした。

ファイルのインポート後にエラーが表示された場合は、Mainframe Assessment Tool でエラー メッセージを直接確認できます。

アイテムの評価の進行状況の詳細を表示するには、テーブル内のアイテムの横にある参照 ID をクリックします。すべてのステップとステータスが表示されるページが開きます。

既存の評価テストにファイルを追加する

評価を作成した後、追加の zip ファイルを追加できます。新しい ZIP ファイルのファイルは、評価の既存のファイルと統合されます。既存のファイルを置き換える場合は、置き換えるファイルとまったく同じパス構造のファイルが新しい zip ファイルに含まれている必要があります。

既存の評価にファイルを追加する手順は次のとおりです。

1. ウェブブラウザで Mainframe Assessment Tool を開きます。
2. ナビゲーション メニューで [評価] をクリックします。
3. [評価] ページで、変更する評価を見つけて、 [評価を開く] をクリックします。
4. [ファイルを追加] をクリックします。
5. [ファイルを選択] をクリックして、アップロードする ZIP ファイルを選択します。一度にアップロードできるファイルは 1 つのみです。
6. [追加] をクリックします。

ファイルをアップロードすると、Mainframe Assessment Tool が分析を再開します。ファイルを置き換えると、ファイルは完全に再評価され、これらのファイルに対する既存の分析が変更される可能性があります。再処理中は、再処理中のファイルの横に Stale インジケーターが表示されます。

評価の詳細と設定を更新する

評価を作成した後、名前と説明を更新し、AI 生成の分析情報の設定を変更できます。

評価の詳細または設定を更新する手順は次のとおりです。

1. ウェブブラウザで Mainframe Assessment Tool を開きます。
2. ナビゲーション メニューで [評価] をクリックします。
3. [評価] ページで、変更する評価を見つけて、 [評価を開く] をクリックします。
4. [設定] [評価の設定を編集] をクリックします。
5. [評価の詳細] ステップで、名前と説明を編集し、[次へ] をクリックします。
6. [AI 設定] ステップで、必要に応じて AI 設定を変更し、[次へ] をクリックします。
7. [ドメイン] ステップで、[次へ] をクリックします。評価を作成した後は、ドメインを編集できません。
8. [Update assessment] をクリックします。

設定を更新すると、Mainframe Assessment Tool は分析を再開します。

次のステップ

• 評価結果を表示して理解する方法を確認する。