翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
Amazon Q Developer は、メインフレームのモダナイゼーションアプリケーションの COBOL から Java への変換を加速します。次のドキュメントでは、Amazon Q Developer の生成 AI と変換機能の自動化を活用して、コードベースの分析、変換の計画、リファクタリングの迅速な実行を行うプロセスについて説明します。ミッションクリティカルなビジネスロジックを維持しながら、これらをすべて実行します。
注記
Amazon Q Developer の変換機能はプレビューリリースであり、変更される可能性があります。
トピック
ステップ 1: サインインとオンボーディング
Amazon Q Developer 変換ウェブエクスペリエンスにサインインするには、 ドキュメントの ワークスペースのセットアップセクションにあるすべての手順に従ってください。
（オプション) メインフレーム変換用にワークスペースを設定するときは、Amazon S3S3 バケットを設定します。バケットを作成し、必要な入力ファイルをバケットにアップロードしたら、後で使用するためにその S3 バケット ARN を保存します。
ステップ 2: ジョブを作成して開始する
ワークスペースで新しいジョブを開始するには、次の手順に従います。
-
ワークスペースのランディングページで、Q に質問を選択してジョブを作成します。
-
次に、メインフレームアプリケーションをモダナイズするためにメインフレームモダナイゼーション (z/OS から AWS) を実行するを選択します。
-
チャットウィンドウで、Q はジョブ名や、このジョブで実行するステップなど、ジョブの詳細を確認するよう求めます。
注記
Q に、「」に記載されている機能の任意の組み合わせを実行するように依頼できます大まかなチュートリアル。
-
確認したら、ジョブの作成と開始を選択します。
Q はジョブのモダナイゼーションを開始します。
ステップ 3: コネクタを設定する
このステップでは、Amazon Q Developer が リソースにアクセスし、連続する変換関数を実行できるようにする Amazon S3 バケットでコネクタを設定します。
-
ジョブプランで、キックオフモダナイゼーションを展開し、AWS アカウントへの接続を選択します。
注記
コネクタを既に作成し、ワークスペースの作成時に S3 バケットを追加している場合は、「リソースの場所を指定する」ページに直接スキップします。
-
メインフレームのモダナイゼーション機能の実行に使用する AWS アカウント ID を入力します。
-
[Next (次へ)] を選択します。
-
メインフレームアプリケーションの変換用にリソースが保存されている前の から Amazon S3 バケット ARN を入力します。
-
[コネクターを作成] をクリックします。
Amazon S3 バケット ARN を追加すると、検証リンクが表示されます。このリンクを AWS 管理者と共有し、 でリクエストを承認するように管理者に依頼する必要があります AWS Management Console。リクエストが承認されると、コネクタタイプとして Amazon S3 との接続の詳細が表示されます。
注記
別のコネクタを作成する必要がある場合は、接続プロセスを再起動することを選択できます。
コネクタがアクティブに設定されている場合、アセットの場所を指定ページで、メインフレームアプリケーション用に変換する入力リソースの Amazon S3 バケットパスを入力します。次に、承認を選択して Q に送信します。
ステップ 4: 変換の進行状況を追跡する
プロセス全体の変換の進行状況は、次の 2 つの方法で追跡できます。
-
作業ログ – これにより、Q が実行するアクションと、人間による入力リクエスト、およびそれらのリクエストに対するレスポンスの詳細なログが提供されます。
-
ダッシュボード – メインフレームアプリケーション変換の概要を提供します。変換されたジョブの数、適用された変換、メインフレームアプリケーションの変換完了までの推定時間に関するメトリクスが表示されます。必要に応じて、ファイルタイプ別のコード行、各ファイルタイプ別に生成されたドキュメント、分解されたコード、移行計画、リファクタリングされたコードなど、各ステップの詳細を確認することもできます。
ステップ 5: コード分析
Amazon S3 バケットパスを Q と共有すると、ファイル名、ファイルタイプ、コード行、パスなどの詳細を含む各ファイルのコードが分析されます。
左側のナビゲーションペインのコードの分析で、コード分析結果の表示を選択します。
コード分析の結果は、複数の方法で表示できます。
-
リストビュー – メインフレームに変換する Amazon S3 バケット内のすべてのファイル
-
ファイルタイプビュー – ファイルタイプごとに表示される Amazon S3 バケット内のすべてのファイル。現在サポートされているファイルタイプのリストについては、「サポートされているファイル」を参照してください。
-
フォルダビュー – フォルダ構造に表示される Amazon S3 バケット内のすべてのファイル。
-
欠落ファイルビュー – メインフレームモダナイゼーションコード分析の欠落ファイル。これらのファイルは、より良いまとまりのある結果を得るために、Amazon S3 バケットのソース入力の一部として追加することをお勧めします。
注記
現在、IBM 以外のメインフレームファイルは、コード分析のために Q による変換ではサポートされていません。
ステップ 6: ドキュメントを生成する
このステップでは、モダナイズ中のメインフレームアプリケーションのドキュメントを生成できます。コードを分析することで、Q はレガシーシステムに存在するビジネスロジック、フロー、統合、依存関係の説明など、アプリケーションプログラムの詳細なドキュメントを自動的に作成できます。このドキュメント機能は、知識のギャップを埋め、情報に基づいた意思決定を行い、アプリケーションを最新のクラウドアーキテクチャに移行するときに重要なビジネスロジックを維持するのに役立ちます。
ドキュメントを生成するには
-
左側のナビゲーションペインの「ドキュメントの生成」で、「ファイルの選択」を選択し、設定を行います。
-
ドキュメントを生成する Amazon S3 バケット内のファイルを選択し、コラボレーションタブで設定を行います。
注記
選択したファイルのエンコードタイプは同じである必要があります (つまり、すべて同じ CCSID - UTF8 または ASCII 内）。そうしないと、生成されたドキュメントに空のフィールドまたはセクションがある可能性があります。
-
ドキュメントの詳細レベルを選択します。
-
概要 – スコープ内の各ファイルの概要を提供します。また、 は各ファイルの 1 行の概要を提供します。
-
詳細な機能仕様 — メインフレームアプリケーション変換スコープ内の各ファイルの包括的な詳細を提供します。詳細には、ロジックとフロー、特定されたビジネスルール、データフロー、依存関係、入出力処理、およびさまざまなトランザクションの詳細が含まれます。
注記
-
現在、ドキュメントは COBOL、JCL、および Assembler ファイルに対してのみ生成できます。
-
ドキュメント生成の料金は、詳細レベルによって異なります。詳細については、「Amazon Q Developer の料金
」を参照してください。
-
-
「Q に送信」を選択します。
-
Q がドキュメントを生成したら、コンソールの Amazon S3 バケットパスに従ってドキュメントの結果を確認します。このパスでは、結果が生成および保存されます。
重要
Amazon Q Developer は、適切なアクセス許可を持たないユーザーからの質問を拒否します。たとえば、寄稿者はメインフレームアプリケーションのジョブ変換をキャンセルしたり、ジョブを削除したりすることはできません。これらの機能を実行できるのは管理者のみです。
ステップ 7: 分解
このステップでは、プログラムとコンポーネント間の依存関係を考慮するドメインにコードを分解します。これにより、関連するファイルとプログラムが同じドメイン内で適切にグループ化されます。また、分解プロセス中にアプリケーションロジックの整合性を維持するのにも役立ちます。
-
左側のナビゲーションペインから分解コードを展開します。
-
ドメインへの分解を選択します。
注記
2 つのドメイン (未割り当ておよび切断済み) は、アプリケーションによって最初に自動的に作成されます。未割り当てのドメインは厳密に分解制御されており、編集できません。
-
Q プロンプト (最初のドメインのみ) またはアクションメニューからドメインの作成を選択して、新しいドメインを作成します。
-
ドメイン名、オプションの説明を入力し、一部のファイルをシードとしてマークします。シードは、Q が関連コンポーネントをドメインにグループ化するためのビジネス機能または関数でラベル付けされた要素です。シードは、コード要素とそれに対応するビジネスドメイン間の接続を提供することで、テクニカルコードとビジネスコンテキストのセマンティックリンクとして機能します。
CICS 設定ファイル (CSD) とスケジューラ設定ファイル (SCL) は、自動シード検出に使用できます。
注記
1 つのドメインを共通のコンポーネントとしてのみ設定することもできます。このドメインのファイルは、複数のドメインに共通です。
-
[Create] (作成) を選択します。
注記
シードとして異なるファイルを持つ複数のドメインを作成できます。
-
すべてのドメインとシードを確認したら、分解を選択します。
-
Q はソースコードファイルをチェックし、同様のユースケースと高いプログラミング依存関係を持つプログラムとデータセットを使用してドメインに分解します。
Q は、分解されたドメインの表形式およびグラフビューを依存関係として提供します。グラフビューには 2 つのオプションがあります。
-
ドメインビュー – さまざまなドメインが互いにどのように関連しているかを視覚的に表示できます。
-
依存関係ビュー – 各ドメインのすべてのファイルを複雑な依存関係グラフとして表示できます。ドメインに追加されたノードが同じドメインのシードから情報を受信しなかった場合、このノードは未割り当て (ノードは情報を受信しなかった）、切断 (シード情報を受信しなかったサブグラフ内）、または別のドメイン (ノードは少なくともそのドメインから情報を受信した) のいずれかに予測されます。
現在のドメイン構造が気に入らない場合は、これらのステップを繰り返してドメインを追加したり、作成済みのドメインを別のシードセットで再設定したりします。
-
-
完了したら、承認を選択して Q に送信します。
ステップ 8: 移行ウェーブ計画
前のステップで作成したドメインに基づいて、Q は推奨されるモダナイゼーション順序で移行ウェーブプランを生成します。
-
計画結果を表示するには、移行ウェーブを計画を選択し、計画結果の確認を選択します。
-
ドメインウェーブプラン (テーブルビューまたはチャートビュー) を確認します。
-
Q によって生成された推奨移行ウェーブプランを使用するか、JSON ファイルをインポートして手動で設定を追加するかを選択できます。
注記
1 つのウェーブで複数のドメインを移行することを選択できます。
-
（オプション) 移行ウェーブプランを手動で調整する場合、Q は必要に応じて新しい移行ウェーブプランを生成します。設定を追加を選択し、追加して再生成を選択して、必要に応じて各ウェーブのドメインを調整することもできます。
-
確認後、承認を選択して Q に送信します。
この移行計画に満足したら、コードをリファクタリングするための次のステップに進むことができます。設定を調整する必要がある場合は、これらのステップを再度実行できます。
ステップ 9: コードをリファクタリングする
このステップでは、Q はすべてのドメインファイルまたは選択したドメインファイルのコードを Java コードにリファクタリングします。このステップの目標は、アプリケーションの重要なビジネスロジックを維持しながら、モダナイズされたクラウド最適化 Java アプリケーションにリファクタリングすることです。
-
左側のナビゲーションペインのリファクタリングコードに移動し、移行するドメインを選択します。
-
リファクタリングするドメインを選択します。
-
承認を選択して Q に送信します。 リファクタリングドメイン (およびその中のファイル) のステータスは、作業ログを使用して追跡できます。Q はメインフレームコードの変換を行い、手動入力なしで結果を生成します。
-
リファクタリングが完了すると、作業ログ
Completedのステータスが に変更されます。リファクタリングされたコードの結果は、結果が保存されている Amazon S3 バケットに移動することで表示できます。各ドメインは変換のステータス (各ファイルで) を提供し、生成と は としてマークされますDone。
Done with issues ステータスを持つ特定のドメインが表示される場合もあります。これらを展開すると、WarningステータスまたはErrorステータスを示すファイルが表示されます。Warning および Error ファイルの問題を表示し、リファクタリングの結果を改善するために修正することを選択できます。
すべてのステップが正常に完了すると、左側のナビゲーションペインの各ジョブタスクが緑色で表示されます。作業ログには、「Q プロジェクトが完了した」というメッセージも表示されます。
