AWS Mainframe Modernization Service (マネージドランタイム環境エクスペリエンス) は、新規のお客様に公開されなくなりました。 AWS Mainframe Modernization Service (マネージドランタイム環境エクスペリエンス) と同様の機能については、 AWS Mainframe Modernization Service (セルフマネージドエクスペリエンス) をご覧ください。既存のお客様は、通常どおりサービスを引き続き使用できます。詳細については、[AWS 「 Mainframe Modernization の可用性の変更](https://docs.aws.amazon.com/m2/latest/userguide/mainframe-modernization-availability-change.html)」を参照してください。
翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# Rocket Software (旧 Micro Focus) を使用したアプリケーションのリプラットフォーム
このガイドでは、 AWS Mainframe Modernization ソリューションを使用してメインフレームアプリケーションをリプラットフォームするend-to-endのプロセスについて説明します AWS。すべてのタスクについて説明し、初期セットアップと分析からモダナイズされたアプリケーションの構築、テスト、デプロイまで、Amazon EC2 での AWS Mainframe Modernization ランタイムの設定と運用に関する情報が含まれています AWS。また、レガシーデータ構造の使用、テンプレートと事前定義されたプロジェクトの使用、ストリーミングセッションの自動化の設定などの高度なトピックについても説明します。
**Topics**
+ [Rocket Software (旧 Micro Focus) (Amazon EC2) をセットアップする](mf-runtime-setup.md)
+ [Rocket Enterprise Analyzer (旧 Micro Focus) および Rocket Enterprise Developer Streaming Sessions のオートメーションを設定する](set-up-automation-m2.md)
+ [Rocket Enterprise Developer (旧 Micro Focus Enterprise Developer) でデータセットをテーブルと列として表示する](view-datasets-tables-m2.md)
+ [Enterprise Developer で Rocket Software (旧 Micro Focus) データファイルツールを使用してデータセットを編集する](edit-datasets-m2.md)
+ [Rocket Software (旧 Micro Focus) のチュートリアル](tutorials-mf.md)
+ [AWS Mainframe Modernization で利用可能なバッチユーティリティ](utilities-m2.md)
# Rocket Software (旧 Micro Focus) (Amazon EC2) をセットアップする
AWS Mainframe Modernization には、Rocket Software (AMIs) が用意されています。これらの AMIs を使用すると、Amazon Elastic Compute Cloud (Amazon EC2) インスタンスをすばやくプロビジョニングして、ユーザーが制御および管理する Rocket Software 環境をサポートできます。このトピックでは、これらの AMI にアクセスして起動するために必要な手順について説明します。これらの AMI の使用は完全に任意であり、このユーザーガイドのチュートリアルを完了するために必須ではありません。
**Topics**
+ [Rocket Software (旧 Micro Focus) (Amazon EC2) をセットアップするための前提条件](mf-runtime-setup-prereq.md)
+ [Amazon S3 用の Amazon VPC エンドポイントを作成する](mf-runtime-setup-vpc.md)
+ [アカウントの許可リスト更新のリクエスト](mf-runtime-setup-allowlist.md)
+ [AWS Identity and Access Management ロールを作成する](mf-runtime-setup-iam-role.md)
+ [License Manager への必要なアクセス許可の付与](mf-runtime-setup-lic.md)
+ [Amazon マシンイメージのサブスクライブ](mf-runtime-setup-ami.md)
+ [AWS Mainframe Modernization Rocket Software (旧 Micro Focus) インスタンスを起動する](mf-runtime-setup-mf-instance.md)
+ [インターネットにアクセスできないサブネットまたは VPC](mf-runtime-setup-no-access.md)
# Rocket Software (旧 Micro Focus) (Amazon EC2) をセットアップするための前提条件
Rocket Software (Amazon EC2) を設定するときは、次の前提条件を満たしていることを確認してください。
+ Amazon EC2 インスタンスを作成するアカウントへの管理者アクセス。
+ Amazon EC2 インスタンスが作成される AWS リージョン を特定し、 AWS Mainframe Modernization サービスが利用可能であることを確認します。「[AWS サービス (リージョン別)](https://aws.amazon.com/about-aws/global-infrastructure/regional-product-services/)」を参照してください。サービスを利用できるリージョンを必ず選択してください。
+ Amazon EC2 インスタンスを作成する Amazon Virtual Private Cloud (Amazon VPC) を特定します。
# Amazon S3 用の Amazon VPC エンドポイントを作成する
このセクションでは、Amazon S3 で使用する Amazon VPC エンドポイントを作成します。このエンドポイントを設定すると、後で VPC のインターネットアクセスを設定するのに役立ちます。
1. AWS マネジメントコンソールの Amazon VPC に移動します。
1. ナビゲーションペインで、**[エンドポイント]** を選択します。
1. **[エンドポイントの作成]** を選択します。
![\[[エンドポイントの作成] がアクティブな VPC エンドポイント。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/mf-create-s3-endpoint_1.jpg)
1. わかりやすい名前タグを入力します (例:「Micro-Focus-License-S3」)。
1. サービスカテゴリで、**[AWS サービス]** を選択します。
![\[サンプル名タグが入力されたエンドポイント設定。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/mf-create-s3-endpoint_2.png)
1. **[サービス]** で Amazon S3 ゲートウェイサービス **com.amazonaws.[region].s3** を検索します。
`us-west-1` の場合は、`com.amazonaws.us-west-1.s3` となります。
1. **[ゲートウェイ]** サービスを選択してください。
![\[Amazon S3 ゲートウェイサービスが選択された [サービス]。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/mf-create-s3-endpoint_3.png)
1. VPC の場合は、使用する VPC を選択します。
![\[VPC が入力された [VPC]。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/mf-create-s3-endpoint_4.png)
1. VPC のすべてのルートテーブルを選択します。
![\[すべてのルートテーブルが選択された [ルートテーブル]。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/mf-create-s3-endpoint_5.png)
1. **[ポリシー]** で **[フルアクセス]** を選択します。
![\[[フルアクセス] が選択された [ポリシー]。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/mf-create-s3-endpoint_6.png)
**注記**
カスタムポリシーを作成する場合は、Amazon S3 バケット `s3://aws-supernova-marketplace--prod` にアクセスできることを確認してください。
1. **[エンドポイントの作成]** を選択します。
# アカウントの許可リスト更新のリクエスト
AWS 担当者と協力して、アカウントが AWS Mainframe Modernization AMIs の許可リストに登録されるようにします。以下の情報を指定します。
+ AWS アカウント ID。
+ Amazon VPC エンドポイント AWS リージョン が作成された 。
+ 「[Amazon S3 用の Amazon VPC エンドポイントを作成する](mf-runtime-setup-vpc.md)」で作成した Amazon VPC Amazon S3 エンドポイント ID。これは **com.amazonaws.[region].s3 Gateway** エンドポイントの `vpce-xxxxxxxxxxxxxxxxx` ID です。
+ すべての Rocket Software Enterprise Suite AMI Amazon EC2 インスタンスで必要なライセンスの数。
CPU コアごと (ほとんどの Amazon EC2 インスタンスでは 2 つの vCPU ごと) に 1 つのライセンスが必要です。
詳細については、「[CPU オプションの最適化](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instance-optimize-cpu.html#cpu-options-compute-optimized)」を参照してください。
リクエストされた番号は、将来 によって調整できます AWS。
**注記**
AWS 担当者、またはユーザーに代わって許可リストリクエストのサポートチケットを開く AWS サポート 担当者にお問い合わせください。ユーザーが直接リクエストすることはできません。リクエストが完了するまでに数日かかる場合があります。
# AWS Identity and Access Management ロールを作成する
AWS Mainframe Modernization Amazon EC2 インスタンスで使用する AWS Identity and Access Management ポリシーとロールを作成します。IAM コンソールでロールを作成すると、同じ名前の関連するインスタンスプロファイルが作成されます。このインスタンスプロファイルを Amazon EC2 インスタンスに割り当てると、Rocket ソフトウェアライセンスを割り当てることができます。インスタンスプロファイルの詳細については、「[Amazon EC2 インスタンスで実行されるアプリケーションに IAM ロールを使用してアクセス許可を付与する](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_use_switch-role-ec2.html)」を参照してしてください。
## IAM ポリシーを作成する
IAM ポリシーが最初に作成され、次にロールにアタッチされます。
1. AWS Identity and Access Management で に移動します AWS マネジメントコンソール。
1. **[ポリシー]** を選択して、**[ポリシーの作成]** を選択します。
![\[フィルタが適用されていないポリシーページ。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/mf-create-iam-policy_1.png)
1. **JSON** タブを選択します。
![\[内容のない [JSON] タブ\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/mf-create-iam-policy_2.png)
1. 次の JSON `us-west-1`の を Amazon S3 エンドポイント AWS リージョン が定義された に置き換え、JSON をコピーしてポリシーエディタに貼り付けます。
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "S3WriteObject",
"Effect": "Allow",
"Action": [
"s3:PutObject"
],
"Resource": [
"arn:aws:s3:::aws-supernova-marketplace-us-west-1-prod/*"
]
},
{
"Sid": "OtherRequiredActions",
"Effect": "Allow",
"Action": [
"sts:GetCallerIdentity",
"ec2:DescribeInstances",
"license-manager:ListReceivedLicenses"
],
"Resource": [
"*"
]
}
]
}
```
------
**注記**
Sid `OtherRequiredActions` の下のアクションは、リソースレベルのアクセス許可をサポートしないため、リソース要素で `*` を指定する必要があります。
![\[ポリシーが入力され、us-west-1 が強調表示された [JSON] タブ。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/mf-create-iam-policy_3.png)
1. **[次へ: タグ]** を選択します。
![\[データが入力されていないタグ。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/mf-create-iam-policy_4.png)
1. 必要に応じてタグを入力し、**[次へ: 確認]** を選択します。
1. ポリシーの名前を入力します (例: 「Micro-Focus-Licensing-policy」)。必要に応じて、「このポリシーを含むロールを各 AWS Mainframe Modernization Amazon EC2 インスタンスにアタッチする必要があります」などの説明を入力します。
![\[名前と説明を入力してポリシーを確認します。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/mf-create-iam-policy_5.png)
1. **[ポリシーの作成]** を選択します。
## IAM ロールの作成
IAM ポリシーを作成後、IAM ロールを作成してそのポリシーをアタッチできます。
1. AWS マネジメントコンソールで IAM に移動します。
1. **[ロール]** を選択してから **[ロールの作成]** を選びます。
![\[フィルタが適用されていないロール。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/mf-create-iam-role_1.png)
1. **[信頼されたエンティティタイプ]** は **[AWS のサービス]** のままにしておき、一般的なユースケースは **[EC2]** を選択します。
![\[AWS サービスと EC2 が選択された信頼されたエンティティを選択する\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/mf-create-iam-role_2.png)
1. [**次へ**] を選択します。
1. フィルタに「Micro」と入力し、Enter キーを押してフィルタを適用します。
1. 作成したばかりのポリシーを選択します (例: 「Micro-Focus-Licensing-policy」)。
1. [**次へ**] を選択します。
![\[Micro Focus ポリシーを選択した状態でアクセス許可を追加します。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/mf-create-iam-role_3.png)
1. ロール名 (例: 「Micro-Focus-Licensing-role」) を入力します。
1. 説明を独自の説明に置き換えてください (例: 「このロールの Amazon EC2 インスタンスに Micro Focus ライセンスの取得を許可します」)。
![\[名前と説明が入力されたロールの詳細。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/mf-create-iam-role_4.png)
1. **[ステップ 1: 信頼されたエンティティを選択]** で JSON を確認し、次の値になっていることを確認します。
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"sts:AssumeRole"
],
"Principal": {
"Service": [
"ec2.amazonaws.com"
]
}
}
]
}
```
------
**注記**
Effect、Action、Principal の順序は重要ではありません。
1. **[ステップ 2: アクセス許可の追加]** にライセンスポリシーが表示されていることを確認します。
![\[[ステップ 2: アクセス許可の追加] でライセンスポリシーを選択します。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/mf-create-iam-role_6.png)
1. **[ロールの作成]** を選択します。
許可リストのリクエストが完了したら、次のステップに進みます。
# License Manager への必要なアクセス許可の付与
Rocket Software ランタイムエンジン (Amazon EC2 上) をセットアップ AWS License Manager するには、 にアクセス許可を付与する必要があります。
1. AWS License Manager で に移動します AWS マネジメントコンソール。
![\[AWS License Manager ホームページ。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/mf-license-manager_1.png)
1. **[AWS License Manager の使用を開始する]** を選択します。
1. 次のポップアップが表示されたら、詳細を確認してチェックボックスを選択し、**[アクセス許可を付与]** を選択します。
![\[IAM アクセス許可の 1 回限りの設定\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/mf-license-manager_2.png)
# Amazon マシンイメージのサブスクライブ
AWS Marketplace 製品をサブスクライブしたら、製品の AMI からインスタンスを起動できます。Rocket Software (旧 Micro Focus) ランタイムエンジン (Amazon EC2) を設定するときに、サブスクライブされた AMIs を管理することもできます。
1. で AWS Marketplace サブスクリプションに移動します AWS マネジメントコンソール。
1. **[サブスクリプションを管理する]** を選択します。
![\[AWS Marketplace ホームページ。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/mf-ami-subscription_1.png)
1. 以下のリンクをコピーしてブラウザのアドレスバーに貼り付けます。
**注記**
使用が許可されている製品の 1 つへのリンクのみを選択してください。
これらのリンクを使用するには、[アカウントの許可リスト更新のリクエスト](mf-runtime-setup-allowlist.md)ページに従ってアカウントが許可リストに登録されていることを確認してください。
+ Enterprise Server: [https://aws.amazon.com/marketplace/pp/prodview-g5emev63l7blc](https://aws.amazon.com/marketplace/pp/prodview-g5emev63l7blc)
+ Enterprise Server (Windows 用): [https://aws.amazon.com/marketplace/pp/prodview-lwybsiyikbhc2](https://aws.amazon.com/marketplace/pp/prodview-lwybsiyikbhc2)
+ Enterprise Developer: [https://aws.amazon.com/marketplace/pp/prodview-77qmpr42yzxwk](https://aws.amazon.com/marketplace/pp/prodview-77qmpr42yzxwk)
+ Enterprise Developer (Visual Studio 2022): [https://aws.amazon.com/marketplace/pp/prodview-m4l3lqiszo6cm](https://aws.amazon.com/marketplace/pp/prodview-m4l3lqiszo6cm)
+ Enterprise Analyzer: [https://aws.amazon.com/marketplace/pp/prodview-tttheylcmcihm](https://aws.amazon.com/marketplace/pp/prodview-tttheylcmcihm)
+ Enterprise Build ツール (Windows 用): [https://aws.amazon.com/marketplace/pp/prodview-2rw35bbt6uozi](https://aws.amazon.com/marketplace/pp/prodview-2rw35bbt6uozi)
+ Enterprise ストアドプロシージャ: [https://aws.amazon.com/marketplace/pp/prodview-zoeyqnsdsj6ha](https://aws.amazon.com/marketplace/pp/prodview-zoeyqnsdsj6ha)
+ Enterprise ストアドプロシージャ (SQL Server 2019): [https://aws.amazon.com/marketplace/pp/prodview-ynfklquwubnz4](https://aws.amazon.com/marketplace/pp/prodview-ynfklquwubnz4)
1. **[サブスクリプションを続行する]** を選択します。
![\[Enterprise Server の提供 AWS Marketplace。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/mf-ami-subscription_2.png)
1. 利用規約に同意できる場合は、**[規約の受諾]** を選択します。
![\[サブスクリプションの利用規約。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/mf-ami-subscription_3.png)
1. このサブスクリプションの処理には数分かかる場合があります。
![\[サブスクリプション保留中のメッセージ。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/mf-ami-subscription_4.png)
1. お礼のメッセージが表示されたら、ステップ 3 の次のリンクをコピーして貼り付け、サブスクリプションの追加を続行します。
![\[サブスクリプションのお礼のメッセージ。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/mf-ami-subscription_5.png)
1. サブスクライブしたすべての AMI が **[サブスクリプションを管理する]** に表示されたら停止します。
**注記**
パネルの詳細設定 (歯車アイコン) は、テーブルとして表示するように設定されています。
![\[サブスクライブしている AMI のリストでサブスクリプションを管理します。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/mf-ami-subscription_6.png)
# AWS Mainframe Modernization Rocket Software (旧 Micro Focus) インスタンスを起動する
エンドポイント、IAM ポリシー、IAM ロールを作成し、AMIs、 で AWS Mainframe Modernization Rocket Software (Micro Focus) インスタンスを起動する準備が整います AWS マネジメントコンソール。
1. で AWS Marketplace サブスクリプションに移動します AWS マネジメントコンソール。
1. 起動する AMI を見つけて、**[新規インスタンスの起動]** を選択します。
![\[Enterprise Server と Enterprise Analyzer を起動できる状態でサブスクリプションを管理します。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/mf-launch-instance_1.png)
1. [新規インスタンスの起動] ダイアログで、許可リストに登録されているリージョンが選択されていることを確認します。
1. **[EC2 経由で起動を続行する]** を選択します。
**注記**
次の例は Enterprise Developer AMI の起動を示していますが、プロセスはすべての AWS Mainframe Modernization AMIs で同じです。
![\[新規インスタンスの起動。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/mf-launch-instance_2.png)
1. サーバーの名前を入力します。
1. インスタンスタイプを選択します。
選択するインスタンスタイプは、プロジェクトのパフォーマンスとコスト要件によって決定する必要があります。出発点としては以下のものが推奨されます。
+ Enterprise Analyzer の場合、r6i.xlarge
+ Enterprise Developer の場合、r6i.large
+ Enterprise Server のスタンドアロンインスタンスの場合、r6i.xlarge
+ スケールアウトされた Rocket Software Performance Availability Cluster (PAC) の場合、r6i.large
**注記**
スクリーンショットでは、[アプリケーションと OS イメージ] セクションは折りたたまれています。
![\[名前とインスタンスタイプを入力してインスタンスを起動します。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/mf-launch-instance_3.png)
1. キーペアを選択または作成 (および保存) します (ここには表示されていません)。
キーペアと Linux インスタンスの詳細については、の「[Amazon EC2 のキーペアと Linux インスタンス](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-key-pairs.html)」を参照してください。
キーペアと Windows インスタンスの詳細については、「[Amazon EC2 のキーペアと Windows インスタンス](https://docs.aws.amazon.com/AWSEC2/latest/WindowsGuide/ec2-key-pairs.html)」を参照してください。
1. ネットワーク設定を編集し、**許可リストに登録された VPC** と適切なサブネットを選択します。
1. **セキュリティグループを選択または作成します**。これが Enterprise Server EC2 インスタンスの場合、ポート 86 および 10086 への TCP トラフィックに Rocket Software 設定の管理を許可するのが一般的です。
1. Amazon EC2 インスタンスのストレージをオプションで設定します。
1. 重要 - [高度な詳細] を展開し、[IAM インスタンスプロファイル] で、先ほど作成したライセンスロール (「Micro-Focus-Licensing-Role」など) を選択します。
**注記**
このステップを見逃した場合は、インスタンスの作成後に EC2 インスタンスの [アクション] メニューの [セキュリティ] オプションから IAM ロールを変更できます。
![\[IAM インスタンスプロファイルが入力された [高度な詳細]。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/mf-launch-instance_4.png)
1. 概要を確認し、**[インスタンスを起動]** を選択します。
![\[選択したオプションの概要。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/mf-launch-instance_5.png)
1. 無効な仮想サーバータイプを選択した場合、インスタンスの起動は失敗します。
その場合は、**[インスタンス設定を編集]** を選択し、インスタンスタイプを変更してください。
![\[インスタンス起動の進行状況メッセージ。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/mf-launch-instance_6.png)
1. 「成功」メッセージが表示されたら、**[インスタンスに接続]** を選択して接続の詳細を取得します。
![\[インスタンス起動成功メッセージ。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/mf-launch-instance_7.png)
1. または、 AWS マネジメントコンソールの **EC2** に移動します。
1. **[インスタンス]** を選択すると、新しいインスタンスの状態が表示されます。
![\[ステータスが表示されたインスタンスのリスト。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/mf-launch-instance_8.png)
# インターネットにアクセスできないサブネットまたは VPC
サブネットまたは VPC にアウトバウンドのインターネットアクセスがない場合は、これらの追加変更を行います。
ライセンスマネージャーは、次の AWS サービスにアクセスする必要があります。
+ com.amazonaws.*region*.s3
+ com.amazonaws.*region*.ec2
+ com.amazonaws.*region*.license-manager
+ com.amazonaws.*region*.sts
前のステップでは com.amazonaws.*region*.s3 サービスをゲートウェイエンドポイントとして定義しました。このエンドポイントには、インターネットにアクセスできないサブネットのルートテーブルエントリが必要です。
追加の 3 つのサービスはインターフェイスエンドポイントとして定義されます。
**Topics**
+ [Amazon S3 エンドポイントのルートテーブルエントリの追加](#mf-runtime-setup-no-access-route-table)
+ [必要なセキュリティグループの定義](#mf-runtime-setup-no-access-security-group)
+ [サービスエンドポイントの作成](#mf-runtime-setup-no-access-endpoints)
## Amazon S3 エンドポイントのルートテーブルエントリの追加
1. で **VPC** に移動 AWS マネジメントコンソール し、**サブネット**を選択します。
1. Amazon EC2 インスタンスを作成するサブネットを選択し、[ルートテーブル] タブを選択します。
1. ルートテーブル ID の末尾の数桁に注意してください。例えば、下の画像の 6b39 です。
![\[ルートテーブルの詳細。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/mf-no-internet_1.png)
1. ナビゲーションペインで、**[エンドポイント]** を選択します。
1. 先に作成したエンドポイントを選択し、エンドポイントの **[ルートテーブル]** タブまたは [アクション] ドロップダウンから [ルートテーブルを管理] を選択します。
1. 先ほど確認した数字を使用してルートテーブルを選択し、[ルートテーブルの変更] を選択します。
![\[選択されたルートテーブル。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/mf-no-internet_2.png)
## 必要なセキュリティグループの定義
Amazon EC2 AWS STS、、および License Manager サービスは、ポート 443 を介して HTTPS 経由で通信します。この通信は双方向であり、インスタンスがサービスと通信できるようにするにはインバウンドルールとアウトバウンドルールが必要です。
1. AWS マネジメントコンソールの Amazon VPC に移動します。
1. ナビゲーションバーで **[セキュリティグループ]** を選択して、**[セキュリティグループの作成]** を選択します。
1. セキュリティグループ名と説明 (「Inbound-Outbound HTTPS」など) を入力します。
1. VPC 選択エリアで [X] を選択して**デフォルト VPC を削除し**、S3 エンドポイントを含む VPC を選択します。
1. 任意の場所からの**ポート 443 の TCP トラフィックを許可**するインバウンドルールを追加します。
**注記**
送信元を制限すると、インバウンド (およびアウトバウンドルール) をさらに制限できます。詳細については、*「Amazon VPC ユーザーガイド*[」の「セキュリティグループを使用して AWS リソースへのトラフィックを制御する](https://docs.aws.amazon.com/vpc/latest/userguide/vpc-security-groups.html)」を参照してください。
![\[インバウンドルールが入力された基本情報。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/mf-no-internet_3.png)
1. **[セキュリティグループの作成]** を選択します。
## サービスエンドポイントの作成
このプロセスをサービスごとに 1 回ずつ、合計 3 回繰り返します。
1. で Amazon VPC に移動 AWS マネジメントコンソール し、**エンドポイント**を選択します。
1. **[エンドポイントの作成]** を選択します。
1. 「Micro-Focus-License-EC2」、「Micro-Focus-License-STS」、「Micro-Focus-License-Manager」などの名前を入力します。
1. **[AWS サービス]** サービスカテゴリを選択します。
![\[AWS サービスが選択されたエンドポイント設定。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/mf-no-internet_4.png)
1. [サービス] で、以下のいずれかと一致するインターフェイスサービスを検索します。
+ com.amazonaws.*region*.ec2
+ com.amazonaws.*region*.sts
+ com.amazonaws.*region*.license-manager
例えば、次のようになります。
+ com.amazonaws.us-west-1.ec2
+ com.amazonaws.us-west-1.sts
+ com.amazonaws.us-west-1.license-manager
1. 一致するインターフェイスサービスを選択します。
**com.amazonaws.*region*.ec2**:
![\[Amazon EC2 インターフェイスサービスが選択された [サービス]。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/mf-no-internet_5.png)
**com.amazonaws.*region*.sts:**
![\[AWS STS インターフェイスサービスが選択されたサービス。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/mf-no-internet_6.png)
**com.amazonaws.*region*.license-manager:**
![\[License Manager インターフェイスサービスが選択された [サービス]。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/mf-no-internet_7.png)
1. [VPC] で、インスタンスの VPC を選択します。
![\[インスタンスが選択された VPC を含む [VPC]。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/mf-no-internet_8.png)
1. VPC の **[アベイラビリティーゾーン]** と **[サブネット]** を選択します。
![\[VPC のアベイラビリティーゾーンとサブネットが選択された [サブネット]。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/mf-no-internet_9.png)
1. 前に作成したセキュリティグループを選択します。
![\[セキュリティグループが選択された [セキュリティグループ]。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/mf-no-internet_10.png)
1. [ポリシー] で **[フルアクセス]** を選択します。
![\[[フルアクセス] が選択された [ポリシー]。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/mf-no-internet_11.png)
1. **[エンドポイントの作成]** を選択します。
1. 残りのインターフェイスでこのプロセスを繰り返します。
# Rocket Enterprise Analyzer (旧 Micro Focus) および Rocket Enterprise Developer Streaming Sessions のオートメーションを設定する
セッションの開始時と終了時にスクリプトを自動的に実行し、お客様の状況に合わせた自動化を実現できます。この WorkSpaces アプリケーション機能の詳細については、Amazon WorkSpaces アプリケーション管理ガイドの[「セッションスクリプトを使用して AppStream 2.0 ユーザーのストリーミングエクスペリエンスを管理する](https://docs.aws.amazon.com/appstream2/latest/developerguide/use-session-scripts.html)」を参照してください。 *Amazon WorkSpaces *
この機能には、少なくとも以下のバージョンの Enterprise Analyzer イメージと Enterprise Developer イメージが必要です。
+ `m2-enterprise-analyzer-v8.0.4.R1`
+ `m2-enterprise-developer-v8.0.4.R1`
**Topics**
+ [セッション開始時にオートメーションをセットアップする](#set-up-automation-m2.start)
+ [セッション終了時にオートメーションをセットアップする](#set-up-automation-m2.end)
## セッション開始時にオートメーションをセットアップする
ユーザーが WorkSpaces アプリケーションに接続するときにオートメーションスクリプトを実行する場合は、スクリプトを作成して という名前を付けます`m2-user-setup.cmd`。スクリプトをユーザーの WorkSpaces Applications Home フォルダに保存します。 AWS Mainframe Modernization が提供する WorkSpaces Applications イメージは、その場所にその名前のスクリプトを探し、存在する場合は実行します。
**注記**
スクリプトの期間は、WorkSpaces Applications で現在 60 秒に設定されている制限を超えることはできません。詳細については、「Amazon [WorkSpaces アプリケーション管理ガイド」の「ストリーミングセッションを開始する前にスクリプトを実行する](https://docs.aws.amazon.com/appstream2/latest/developerguide/use-session-scripts.html#run-scripts-before-streaming-sessions-begin)」を参照してください。 *Amazon WorkSpaces *
## セッション終了時にオートメーションをセットアップする
ユーザーが WorkSpaces アプリケーションから切断したときにオートメーションスクリプトを実行する場合は、スクリプトを作成して という名前を付けます`m2-user-teardown.cmd`。スクリプトをユーザーの WorkSpaces Applications Home フォルダに保存します。 AWS Mainframe Modernization が提供する WorkSpaces Applications イメージは、その場所にその名前のスクリプトを探し、存在する場合は実行します。
**注記**
スクリプトの期間は、WorkSpaces Applications で現在 60 秒に設定されている制限を超えることはできません。詳細については、[「Amazon WorkSpaces アプリケーション管理ガイド」の「ストリーミングセッションが終了した後にスクリプトを実行する](https://docs.aws.amazon.com/appstream2/latest/developerguide/use-session-scripts.html#run-scripts-after-streaming-sessions-end)*Amazon WorkSpaces*」を参照してください。
# Rocket Enterprise Developer (旧 Micro Focus Enterprise Developer) でデータセットをテーブルと列として表示する
Rocket Software (旧 Micro Focus) ランタイムを使用して AWS 、 Mainframe Modernization にデプロイされたメインフレームデータセットにアクセスできます。移行されたデータセットは、Rocket Enterprise Developer インスタンスからテーブルと列として表示できます。この方法でデータセットを表示すると、次のことが可能になります。
+ 移行したデータファイルに対して `SQL SELECT` オペレーションを実行します。
+ アプリケーションを変更せずに、移行したメインフレームアプリケーションの外部にデータを公開します。
+ データを簡単にフィルタリングし、CSV またはその他のファイル形式で保存できます。
**注記**
ステップ 1 と 2 は 1 回限りのアクティビティです。データセットごとにステップ 3 と 4 を繰り返して、データベースビューを作成します。
**Topics**
+ [前提条件](#view-datasets-tables-m2.prereq)
+ [ステップ 1: Rocket Software データストアへの ODBC 接続を設定する (Amazon RDS データベース)](#view-datasets-tables-m2.odbc)
+ [ステップ 2: MFDBFH.cfg ファイルを作成する](#view-datasets-tables-m2.config)
+ [ステップ 3: コピーブックレイアウト用の構造 (STR) ファイルを作成する](#view-datasets-tables-m2.str)
+ [ステップ 4: 構造 (STR) ファイルを使用してデータベースビューを作成する](#view-datasets-tables-m2.dbview)
+ [ステップ 5: Rocket Software (旧 Micro Focus) データセットをテーブルと列として表示する](#view-datasets-tables-m2.cols)
## 前提条件
+ WorkSpaces アプリケーション経由で Rocket Enterprise Developer Desktop にアクセスできる必要があります。
+ Rocket Software ランタイムエンジンを使用して AWS Mainframe Modernization でアプリケーションをデプロイして実行する必要があります。
+ Aurora PostgreSQL 互換エディションにアプリケーションデータを保存しています。
## ステップ 1: Rocket Software データストアへの ODBC 接続を設定する (Amazon RDS データベース)
このステップでは、表示するデータをテーブルや列として格納しているデータベースへの ODBC 接続をセットアップします。これは 1 回限りのステップです。
1. WorkSpaces アプリケーションストリーミング URL を使用して Rocket Enterprise Developer Desktop にログインします。
1. **[ODBC データソースの管理者]** を開き、**[ユーザー DSN]** を選択し、**[追加]** を選択します。
1. **[新しいデータソースを作成]** で **[PostgreSQL ANSI]** を選択し、**[完了]** を選択します。
1. 以下のように必要なデータベース情報を指定して、`PG.POSTGRES` のデータソースを作成します。
```
Data Source : PG.POSTGRES
Database : postgres
Server : rds_endpoint.rds.amazonaws.com
Port : 5432
User Name : user_name
Password : user_password
```
![\[Enterprise Developer で Postgres ODBC 接続をセットアップする。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/view-data-tables-odbc.png)
1. **[テスト]** を選択し、接続が機能することを確認します。テストが成功すると、メッセージ `Connection successful` が表示されます。
テストが成功しなかった場合は、次の情報を確認してください。
+ [Amazon RDS のトラブルシューティング](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_Troubleshooting.html)
+ [Amazon RDS DB インスタンスに接続するときの問題を解決するにはどうすればよいですか?](https://repost.aws/knowledge-center/rds-cannot-connect)
1. データソースを保存します。
1. `PG.VSAM` のデータソースを作成し、接続をテストして、データソースを保存します。必要に応じて、次のデータベース情報を入力します:
```
Data Source : PG.VSAM
Database : MicroFocus$SEE$Files$VSAM
Server : rds_endpoint.rds.amazonaws.com
Port : 5432
User Name : user_name
Password : user_password
```
![\[Enterprise Developer で PG.VSAM ODBC データソースをセットアップします。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/view-data-tables-pg-vsam.png)
## ステップ 2: MFDBFH.cfg ファイルを作成する
このステップでは、Micro Focus データストアを記述する設定ファイルを作成します。これは 1 回限りの設定ステップです。
1. 例えば、`D:\PhotonUser\My Files\Home Folder\MFED\cfg\MFDBFH.cfg` のホームフォルダに、次の内容の MFDBFH.cfg ファイルを作成します。
```
```
1. 以下のコマンドを実行して Micro Focus データストアをクエリし、MFDBFH の設定を確認します。
```
*##*
*## Test the connection by running the following commands*
*##*
set MFDBFH_CONFIG="D:\PhotonUser\My Files\Home Folder\MFED\cfg\MFDBFH.cfg"
dbfhdeploy list sql://ESPACDatabase/VSAM?folder=/DATA
```
## ステップ 3: コピーブックレイアウト用の構造 (STR) ファイルを作成する
このステップでは、コピーブックレイアウト用の構造ファイルを作成し、後でデータセットからデータベースビューを作成する際に使用できるようにします。
1. コピーブックに関連するプログラムをコンパイルします。コピーブックを使用するプログラムがない場合は、コピーブック用の COPY ステートメントを使用して、次のような簡単なプログラムを作成してコンパイルします。
```
IDENTIFICATION DIVISION.
PROGRAM-ID. TESTPGM1.
ENVIRONMENT DIVISION.
CONFIGURATION SECTION.
DATA DIVISION.
WORKING-STORAGE SECTION.
COPY CVTRA05Y.
PROCEDURE DIVISION.
GOBACK.
```
1. コンパイルが成功したら、プログラムを右クリックし、**[レコードレイアウトファイルの作成]** を選択します。これにより、コンパイル中に生成された.idy ファイルを使用して Micro Focus データファイルツールが開きます。
![\[Enterprise Developer の Create Record Layout File コマンドの場所。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/view-data-tables-idy-file.png)
1. レコード構造を右クリックし、レイアウトに応じて **[デフォルトレイアウトを作成]** (単一構造) または **[条件付きレイアウトを作成]** (複数構造) を選択します。
詳細については、Micro Focus ドキュメンテーションの「[構造ファイルとレイアウトの作成](https://www.microfocus.com/documentation/enterprise-developer/ed60/ES-WIN/GUID-6EDDA4C3-F09E-4CEC-9CF8-281D9D7453C3.html)」を参照してください。
![\[Micro Focus データファイルツール内のレイアウトコマンドの場所。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/view-data-tables-mf-data-file-tools.png)
1. レイアウトを作成したら、メニューから **[ファイル]** を選択し、**[名前を付けて保存]** を選択します。ホームフォルダにあるファイルを参照し、コピーブックと同じ名前で保存します。`str` という名前のフォルダを作成し、そこにすべての構造ファイルを保存することができます。
![\[str ファイルを Enterprise Developer に保存する。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/view-data-tables-save-str.png)
## ステップ 4: 構造 (STR) ファイルを使用してデータベースビューを作成する
このステップでは、以前に作成した構造ファイルを使用して、データセットのデータベースビューを作成します。
+ 以下の例に示すように、`dbfhview` コマンドを使用して Micro Focus データストアに既に存在するデータセットのデータベースビューを作成します。
```
##
## The below command creates database view for VSAM file AWS.M2.CARDDEMO.TRANSACT.VSAM.KSDS
## using the STR file CVTRA05Y.str
##
dbfhview -create -struct:"D:\PhotonUser\My Files\Home Folder\MFED\str\CVTRA05Y.str" -name:V_AWS.M2.CARDDEMO.TRANSACT.VSAM.KSDS.DAT -file:sql://ESPACDatabase/VSAM/AWS.M2.CARDDEMO.TRANSACT.VSAM.KSDS.DAT?folder=/DATA
##
## Output:
##
Micro Focus Database File Handler - View Generation Tool Version 8.0.00
Copyright (C) 1984-2022 Micro Focus. All rights reserved.
VGN0017I Using structure definition 'TRAN-RECORD-DEFAULT'
VGN0022I View 'V_AWS.M2.CARDDEMO.TRANSACT.VSAM.KSDS.DAT' installed in datastore 'sql://espacdatabase/VSAM'
VGN0002I The operation completed successfully
```
## ステップ 5: Rocket Software (旧 Micro Focus) データセットをテーブルと列として表示する
このステップでは、`pgAdmin` を使用してデータベースに接続し、クエリを実行してテーブルや列などのデータセットを表示できます。
+ pgAdmin を使用してデータベース `MicroFocus$SEE$Files$VSAM` に接続し、ステップ 4 で作成したデータベースビューをクエリします。
```
SELECT * FROM public."V_AWS.M2.CARDDEMO.TRANSACT.VSAM.KSDS.DAT";
```
![\[pgAdmin のテーブルと列を表示する移行されたデータセット。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/view-data-tables-new-view-pgadmin.png)
# Enterprise Developer で Rocket Software (旧 Micro Focus) データファイルツールを使用してデータセットを編集する
移行されたデータセットの Rocket Software ランタイムを使用して AWS 、 Mainframe Modernization でデータセットを表示および編集できます。
このドキュメントのステップでは、データファイルツールを使用してデータセットにアクセスするプロセスについて説明します。
これにより、必要に応じて移行されたデータセットを表示および編集できます。
**Topics**
+ [前提条件](#edit-datasets-m2.prereq)
+ [Rocket ソフトウェア (旧 Micro Focus) データファイルツールを起動する](#edit-datasets-m2-launch)
+ [MFDBFH データベースに保存されている VSAM データセットを編集する](#edit-datasets-m2-vsam)
+ [MFDBFH データベースに保存されている VSAM 以外のデータセットを編集する](#edit-datasets-m2-nonvsam)
+ [ファイルシステムに保存されている VSAM および VSAM 以外のデータセットを編集する (EFS/FSx)](#edit-datasets-m2-open)
## 前提条件
開始する前に、データセットを使用してアプリケーションをデプロイする必要があります
Rocket Software エンジンを使用して AWS Mainframe Modernization サービスの下にインポートされます。
データセットの編集を続行するには、ステップ 1、ステップ 2、
および (オプション) [Rocket Enterprise Developer (旧 Micro Focus Enterprise Developer) でデータセットをテーブルと列として表示する](view-datasets-tables-m2.md)ページからのステップ 3
ODBC 接続と Micro Focus データストア (つまり、) を設定します`MFDBFH`。
**重要**
このガイドでは、Micro Focus データストア (`MFDBFH`) として Amazon Aurora Postgres を使用していることを前提としています。
アプリケーションデータを保存します。
## Rocket ソフトウェア (旧 Micro Focus) データファイルツールを起動する
前提条件を完了したら、データベースに保存されているデータセット () にアクセスする`MFDBFH_CONFIG`ように環境変数を設定して、Micro Focus データファイルツールを起動します`MFDBFH`。
以下の手順に従ってください。
1. Micro Focus Enterprise Developer デスクトップにログインし、**スタートメニューから** **Enterprise Developer コマンドプロンプト (64 ビット)** を起動します。
1. `MFDBCH.cfg` ファイルへのフルパスで`MFDBFH_CONFIG`環境変数を設定します。
```
set MFDBFH_CONFIG="C:\MicroFocus\config\MFDBFH.cfg"
```
1. 次のコマンドを使用して、Enterprise Developer コマンドラインから Micro Focus データファイルツールを起動します。
```
mfdatatools2
```
![\[Enterprise Developer コマンドプロンプト。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/edit-mfdbfh-launch.png)
これにより、Micro Focus データファイルツールが別のウィンドウで開きます。
## MFDBFH データベースに保存されている VSAM データセットを編集する
Micro Focus データファイルツールを起動したら、Micro Focus データストアに保存されている VSAM データセットを開きます。
以下の手順に従ってください。
1. Micro Focus Data File Tools ウィンドウのファイル**メニューから**、**Data Explorer** を選択します。
1. Data Explorer セクションで、**設定** (歯車アイコン) を選択して新しい接続を設定します。これにより、**データソース設定**ウィンドウが開きます。
![\[Micro Focus Data File Tools ウィンドウと Data Explorer セクション。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/edit-mfdbfh-data-source.png)
1. データソース設定ウィンドウで、**MFDBFH** タブを選択し、次の値を入力します。
+ サーバー: `ESPACDatabase`
+ データストア: `VSAM`
**適用** を選択して設定を保存します。
![\[Micro Focus Data File Tools ウィンドウ MFDBFH タブを使用したデータソース設定。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/edit-mfdbfh-data-source-settings.png)
Data Explorer に、 に保存されているすべてのデータセットが表示されるようになりました`MFDBFH`。
![\[Micro Focus Data File Tools ウィンドウと Data Explorer セクションには、すべてのデータセットが表示されます。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/edit-mfdbfh-datasets.png)
1. 相対パスを展開`DATA`し、開く VSAM データセットをダブルクリックします。
1. **Open Data File** ウィンドウで、**Open Shared** または **Open Exclusive** を選択してデータセットを開きます。
![\[Micro Focus Data File Tools window with Data Explorer section Open Data File section to open data sets。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/edit-mfdbfh-data-set.png)
開いているデータセットを表示または編集できるようになりました。
## MFDBFH データベースに保存されている VSAM 以外のデータセットを編集する
VSAM 以外のデータセットを編集する場合は、Micro Focus データストアに保存されている VSAM 以外のデータセットを開きます。
以下の手順に従ってください。
1. Enterprise Developer コマンドプロンプト (64 ビット) から `dbfhdeploy data extract` コマンドを実行して、VSAM 以外のデータセットをローカルファイルシステムにダウンロードします。
**注記**
このコマンドを実行する前に、 `MFDBFH.cfg` ファイルへのフルパスで `MFDBFH_CONFIG` 環境変数が設定されていることを確認してください。
```
dbfhdeploy data extract sql://ESPACDatabase/VSAM/AWS.M2.CARDDEMO.TRANSACT.BKUP.G0001V00.DAT?folder=/DATA C:\MicroFocus\data\AWS.M2.CARDDEMO.TRANSACT.BKUP.G0001V00.DAT
```
1. **スタートメニューから** Micro Focus データファイルツールを起動します。
1. Micro Focus データファイルツールのファイルメニューから、**開く**を選択し、**データファイル**を選択します。
1. Open Data File ウィンドウで、ローカルファイルシステムでダウンロードしたデータセットを参照します。必要に応じて**ファイルの詳細**を編集します。次に、**Open Shared** または **Open Exclusive** を選択して、データセットを開きます。
![\[データセットを参照するためにローカルタブが選択されたデータファイルウィンドウを開きます。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/edit-mfdbfh-browse.png)
開いているデータセットを表示または編集できるようになりました。
編集または更新されたデータセットは、 [AWS Mainframe Modernization アプリケーションのデータセットをインポートする](applications-m2-dataset.md)のステップまたは [dbfhdeploy コマンドラインユーティリティ](https://www.microfocus.com/documentation/enterprise-developer/ed90/ED-Eclipse/GUID-2A16851F-E475-42C9-B024-37567006B86D.html)を使用して Micro Focus データストアにインポートできます。
## ファイルシステムに保存されている VSAM および VSAM 以外のデータセットを編集する (EFS/FSx)
ファイルシステムに保存されているデータセットを開くこともできます。
以下の手順に従ってください。
1. Enterprise Developer EC2 インスタンスの にEFS/FSxファイルシステムをマウントします。
1. Micro Focus データファイルツールを使用して、ファイルシステムからデータセットを参照して開きます。
# Rocket Software (旧 Micro Focus) のチュートリアル
このセクションのチュートリアルは、 AWS Mainframe Modernization サービスの Rocket Software ランタイムエンジンでさまざまなタスクの設定を開始するのに役立ちます。これらのチュートリアルは、Rocket Enterprise Developer で テンプレートを使用してサンプルアプリケーションを設定し、Enterprise Analyzer を設定するためのものです。
**Topics**
+ [チュートリアル: BankDemo サンプルアプリケーションの Rocket Software (旧 Micro Focus) ビルドのセットアップ](tutorial-build-mf.md)
+ [チュートリアル: Rocket Enterprise Analyzer と Rocket Enterprise Developer で使用する WorkSpaces アプリケーションをセットアップする](set-up-appstream-mf.md)
+ [チュートリアル: Rocket Enterprise Developer (以前の Micro Focus Enterprise Developer) で テンプレートを使用する](tutorial-templates-ed.md)
+ [チュートリアル: WorkSpaces アプリケーションで Enterprise Analyzer をセットアップする](set-up-ea.md)
+ [チュートリアル: WorkSpaces アプリケーションで Rocket Enterprise Developer をセットアップする](set-up-ed.md)
# チュートリアル: BankDemo サンプルアプリケーションの Rocket Software (旧 Micro Focus) ビルドのセットアップ
AWS Mainframe Modernization では、移行したアプリケーションのビルドと継続的インテグレーション/継続的デリバリー (CI/CD) パイプラインを設定できます。これらのビルドとパイプラインは AWS CodeBuild AWS CodeCommit、 と AWS CodePipeline を使用してこれらの機能を提供します。CodeBuild は完全マネージド型の構築サービスです。ソースコードのコンパイル、ユニットテストの実行、すぐにデプロイできるアーティファクトの生成を行います。CodeCommit は、Git リポジトリを AWS クラウドにプライベートに保存および管理できるようにするバージョン管理サービスです。CodePipeline は、ソフトウェアをリリースするために必要な手順のモデル化、視覚化、および自動化ができる継続的なデリバリーサービスです。
このチュートリアルでは、 AWS CodeBuild を使用して Amazon S3 から BankDemo サンプルアプリケーションのソースコードをコンパイルし、コンパイルしたコードを Amazon S3 にエクスポートする方法を示します。 Amazon S3
AWS CodeBuild は、ソースコードをコンパイルし、テストを実行し、デプロイ可能なソフトウェアパッケージを生成するフルマネージドの継続的統合サービスです。CodeBuild では、パッケージ済みのビルド環境を使用するか、ご自分のビルドツールを使用するカスタムビルド環境を作成することができます。このデモシナリオでは 2 つ目のオプションを使用します。あらかじめパッケージ化された Docker イメージを使用する CodeBuild ビルド環境で構成されています。
**重要**
メインフレームモダナイゼーションプロジェクトを開始する前に、[AWS メインフレーム向け Migration Acceleration Program (MAP)](https://aws.amazon.com/migration-acceleration-program/mainframe/) について確認するか、メインフレームアプリケーションのモダナイズに必要な手順について [AWS メインフレームのスペシャリスト](mailto: mainframe@amazon.com)に問い合わせることをお勧めします。
**Topics**
+ [前提条件](#tutorial-build-mf-prerequisites)
+ [ステップ 1: ビルドアセットを AWS アカウントと共有する](#tutorial-build-mf-assets)
+ [ステップ 2: Amazon S3 バケットを作成する](#tutorial-build-mf-s3)
+ [ステップ 3: ビルド仕様ファイルを作成する](#tutorial-build-mf-spec)
+ [ステップ 4: ソースファイルをアップロードする](#tutorial-build-mf-upload)
+ [ステップ 5: IAM ポリシーを作成する](#tutorial-build-mf-IAM-policy)
+ [ステップ 6: IAM ロールを作成する](#tutorial-build-mf-IAM-role)
+ [ステップ 7: IAM ポリシーを IAM ロールにアタッチする](#tutorial-build-mf-attach)
+ [ステップ 8: CodeBuild プロジェクトを作成する](#tutorial-build-mf-create-project)
+ [ステップ 9: ビルドを開始する](#tutorial-build-mf-start)
+ [ステップ 10: 出力アーティファクトをダウンロードする](#tutorial-build-mf-download-output)
+ [リソースをクリーンアップする](#tutorial-build-mf-clean)
## 前提条件
このチュートリアルを開始する前に、次の前提条件を完了してください。
+ [BankDemo サンプルアプリケーション](https://d3lkpej5ajcpac.cloudfront.net/demo/mf/BANKDEMO-build.zip)をダウンロードし、フォルダに解凍します。ソースフォルダには、COBOL プログラム、コピーブック、定義が含まれています。JCL をビルドする必要はありませんが、参照用の JCL フォルダも含まれています。このフォルダには、ビルドに必要なメタファイルも含まれています。
+ AWS Mainframe Modernization コンソールで、**ツール** を選択します。**[分析、開発、およびアセットの構築]** で、**[ アカウントとアセットを共有する]** を選択します。
## ステップ 1: ビルドアセットを AWS アカウントと共有する
このステップでは、特にアセットが使用されているリージョンで、ビルドアセットを AWS アカウントと共有します。
1. [https://console.aws.amazon.com/m2/](https://us-west-2.console.aws.amazon.com/m2/home?region=us-west-2#/) で AWS Mainframe Modernization コンソールを開きます。
1. 左側のナビゲーションで、**[ツール]** を選択します。
1. **分析、開発、アセットの構築**で、**アセットを自分の AWS アカウントと共有**を選択します。
**重要**
ビルドを実行する予定のすべての AWS リージョンで、このステップを 1 回実行する必要があります。
## ステップ 2: Amazon S3 バケットを作成する
このステップでは、2 つの Amazon S3 バケットを作成します。1 つ目はソースコードを保持する入力バケットで、もう 1 つはビルド出力を保持する出力バケットです。詳細については、「*Amazon S3 ユーザーガイド*」の「[Amazon S3 バケットの作成、設定、操作](https://docs.aws.amazon.com/AmazonS3/latest/userguide/creating-buckets-s3.html)」を参照してください。
1. 入力バケットを作成するには、Amazon S3 コンソールにログインし、**[バケットの作成]** を選択します。
1. **全般設定**で、バケットの名前を指定し、バケットを作成する AWS リージョン を指定します。名前の例は で`codebuild-regionId-accountId-input-bucket`、 `regionId`はバケット AWS リージョン の 、 `accountId`は ID AWS アカウント です。
**注記**
米国東部 (バージニア北部) AWS リージョン とは異なる でバケットを作成する場合は、 `LocationConstraint`パラメータを指定します。詳細については、「*Amazon Simple Storage Service API リファレンス*」の「[バケットを作成](https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html)」を参照してください。
1. その他の設定はすべて保持し、**[バケットを作成]** を選択します。
1. ステップ 1～3 を繰り返し、出力バケットを作成します。名前の例は です。ここで`codebuild-regionId-accountId-output-bucket`、 `regionId`はバケット AWS リージョン の で、 `accountId`は AWS アカウント ID です。
これらのバケットにどの名前を選択する場合でも、このチュートリアル全体で、その名前を使用してください。
## ステップ 3: ビルド仕様ファイルを作成する
このステップでは、ビルド仕様ファイルを作成します。このファイルには、CodeBuild がビルドを実行するためのビルドコマンドと関連設定が含まれます。詳細については、「*AWS CodeBuild ユーザーガイド*」の「[CodeBuild のビルド仕様に関するリファレンス](https://docs.aws.amazon.com/codebuild/latest/userguide/build-spec-ref.html)」を参照してください。
1. 前提条件として解凍したディレクトリに、`buildspec.yml` という名前のファイルを作成します。
1. ファイルに以下の内容を追加して保存します。このファイルでは変更は必要ありません。
```
version: 0.2
env:
exported-variables:
- CODEBUILD_BUILD_ID
- CODEBUILD_BUILD_ARN
phases:
install:
runtime-versions:
python: 3.7
pre_build:
commands:
- echo Installing source dependencies...
- ls -lR $CODEBUILD_SRC_DIR/source
build:
commands:
- echo Build started on `date`
- /start-build.sh -Dbasedir=$CODEBUILD_SRC_DIR/source -Dloaddir=$CODEBUILD_SRC_DIR/target
post_build:
commands:
- ls -lR $CODEBUILD_SRC_DIR/target
- echo Build completed on `date`
artifacts:
files:
- $CODEBUILD_SRC_DIR/target/**
```
ここでは、`CODEBUILD_BUILD_ID`、`CODEBUILD_BUILD_ARN`、`$CODEBUILD_SRC_DIR/source`、`$CODEBUILD_SRC_DIR/target` は CodeBuild 内で使用できる環境変数を示します。詳細については、「[ビルド環境の環境変数](https://docs.aws.amazon.com/codebuild/latest/userguide/build-env-ref-env-vars.html)」を参照してください。
この時点で、ディレクトリは次のようになります。
```
(root directory name)
|-- build.xml
|-- buildspec.yml
|-- LICENSE.txt
|-- source
|... etc.
```
1. フォルダの内容を `BankDemo.zip` という名前のファイルに圧縮します。このチュートリアルでは、フォルダを圧縮することはできません。代わりに、フォルダの内容を `BankDemo.zip` ファイルに圧縮します。
## ステップ 4: ソースファイルをアップロードする
このステップでは、BankDemo サンプルアプリケーションのソースコードを Amazon S3 入力バケットにアップロードします。
1. Amazon S3 コンソールにログインし、ナビゲーションペインで、**[バケット]** を選択します。次に、以前に作成した入力バケットを選択します。
1. **[オブジェクト]** で **[アップロード]** を選択します。
1. **[ファイルとフォルダ]** セクションで、**[ファイルを追加]** を選択します。
1. `BankDemo.zip` ファイルに移動して、選択します。
1. **アップロード** を選択します。
## ステップ 5: IAM ポリシーを作成する
このステップでは、2 つの [IAM ポリシー](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html)を作成します。1 つのポリシーは、 AWS Mainframe Modernization が Rocket Software ビルドツールを含む Docker イメージにアクセスして使用するためのアクセス許可を付与します。このポリシーはお客様向けにカスタマイズされていません。もう 1 つのポリシーは、 AWS Mainframe Modernization が入力バケットと出力バケット、および CodeBuild が生成する [Amazon CloudWatch logs](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/WhatIsCloudWatchLogs.html)とやり取りするためのアクセス許可を付与します。
IAM ポリシーの作成については、「*IAM ユーザーガイド*」の「[IAM ポリシーの編集](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_create.html)」を参照してください。
**Docker イメージにアクセスするためのポリシーを作成するには**
1. IAM コンソールで、次のポリシー文書をコピーしてポリシーエディタに貼り付けます。
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"ecr:GetAuthorizationToken"
],
"Resource": "*"
},
{
"Effect": "Allow",
"Action": [
"ecr:BatchCheckLayerAvailability",
"ecr:GetDownloadUrlForLayer",
"ecr:BatchGetImage"
],
"Resource": "arn:aws:ecr:*:673918848628:repository/m2-enterprise-build-tools"
},
{
"Effect": "Allow",
"Action": [
"s3:PutObject"
],
"Resource": "arn:aws:s3:::aws-m2-repo-*--prod"
}
]
}
```
------
1. ポリシーの名前を指定します (`m2CodeBuildPolicy` など)。
**AWS Mainframe Modernization がバケットとログとやり取りできるようにするポリシーを作成するには**
1. IAM コンソールで、次のポリシー文書をコピーしてポリシーエディタに貼り付けます。を `regionId`に AWS リージョン、 を `accountId`に更新してください AWS アカウント。
1. ポリシーの名前を指定します (`BankdemoCodeBuildRolePolicy` など)。
## ステップ 6: IAM ロールを作成する
このステップでは、以前に作成した [IAM ポリシーをこの新しい IAM ロール](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles.html)に関連付けた後、CodeBuild が AWS リソースとやり取りできるようにする新しい IAM ロールを作成します。
サービスロールの作成の詳細については、*IAM ユーザーガイド*の[AWS 「 サービスにアクセス許可を委任するロールの作成](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create_for-service.html)」を参照してください。
1. IAM コンソールにログインし、左のナビゲーションペインで、**[ロール]** を選択します。
1. [**ロールの作成**] を選択してください。
1. **[信頼されたエンティティタイプ]** から、**[AWS サービス]** を選択します。
1. **[他の AWS サービスのユースケース]** で **[CodeBuild]** を選択し、もう一度 **[CodeBuild]** を選択します。
1. [**次へ**] を選択します。
1. **[アクセス許可を追加]** ページで **[次へ]** を選択してください。後でロールにポリシーを割り当てます。
1. **[ロールの詳細]** に、ロールの名前 (例: `BankdemoCodeBuildServiceRole`) を入力します。
1. **[信頼されたエンティティを選択]** で、ポリシードキュメントが以下のようになっていることを確認します。
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Principal": {
"Service": "codebuild.amazonaws.com"
},
"Action": "sts:AssumeRole"
}
]
}
```
------
1. [**ロールの作成**] を選択してください。
## ステップ 7: IAM ポリシーを IAM ロールにアタッチする
このステップでは、前に作成した IAM ポリシーを `BankdemoCodeBuildServiceRole` IAM ロールにアタッチします。
1. IAM コンソールにログインし、左のナビゲーションペインで、**[ロール]** を選択します。
1. **[ロール]** で、前に作成したロールを選択します (`BankdemoCodeBuildServiceRole` など)。
1. **[アクセス許可ポリシー]** で、**[アクセス許可を追加]**、**[ポリシーをアタッチします]** の順に選択します。
1. **[その他の許可ポリシー]** で、以前に作成したポリシー (例: `m2CodeBuildPolicy` と `BankdemoCodeBuildRolePolicy`) を選択します。
1. **ポリシーのアタッチ** を選択します。
## ステップ 8: CodeBuild プロジェクトを作成する
このステップでは、CodeBuild プロジェクトを作成します。
1. CodeBuild コンソールにログインして **[ビルドプロジェクトを作成する]** を選択します。
1. **[プロジェクトの設定]** セクションで、プロジェクトの名前 (例: `codebuild-bankdemo-project`) を入力します。
1. **[ソース]** セクションの **[ソースプロバイダー]** で **[Amazon S3]** を選択し、以前に作成した入力バケット (例: `codebuild-regionId-accountId-input-bucket`) を選択します。
1. **[S3 オブジェクトキーまたは S3 フォルダ]** フィールドに S3 バケットにアップロードした zip ファイルの名前を入力します。この場合、ファイル名は `bankdemo.zip` です。
1. **[環境]** セクションで、**[カスタムイメージ]** を選択します。
1. **[環境タイプ]** フィールドで **[Linux]** を選択します。
1. **[イメージレジストリ]** で、**[その他のレジストリ]** を選択します。
1. **[外部レジストリの URL]** フィールドで
+ Rocket Software v9 の場合: と入力します`673918848628.dkr.ecr.us-west-1.amazonaws.com/m2-enterprise-build-tools:9.0.7.R1`。Rocket Software v9 で別の AWS リージョンを使用している場合は、 を指定することもできます。 は ` 673918848628.dkr.ecr..amazonaws.com/m2-enterprise-build-tools:9.0.7.R1`Mainframe Modernization AWS サービスが利用可能な AWS リージョンです (例: `eu-west-3`)。
+ Rocket Software v8 の場合: Enter `673918848628.dkr.ecr.us-west-2.amazonaws.com/m2-enterprise-build-tools:8.0.9.R1`
+ Rocket Software v7 の場合: Enter `673918848628.dkr.ecr.us-west-2.amazonaws.com/m2-enterprise-build-tools:7.0.R10`
1. **[サービスロール]** で **[既存のサービスロール]** を選択し、**[ロール ARN]** フィールドで、以前に作成したサービスロール (例: `BankdemoCodeBuildServiceRole`) を選択します。
1. **[Buildspec]** セクションで **[buildspec ファイルを使用する]** を選択します。
1. **[アーティファクト]** セクションの **[タイプ]** で **[Amazon S3]** を選択し、次に出力バケット (例: `codebuild-regionId-accountId-output-bucket`) を選択します。
1. **[名前]** フィールドに、ビルド出力アーティファクトを格納するバケット内のフォルダの名前 (例: `bankdemo-output.zip`) を入力します。
1. **[アーティファクトのパッケージ化]** では、**[Zip]** を選択します。
1. **Create build project (ビルドプロジェクトの作成)**を選択します。
## ステップ 9: ビルドを開始する
このステップでは、ビルドを開始します。
1. CodeBuild コンソールにログインします。
1. ナビゲーションペインで、**[ビルドプロジェクト]** を選択します。
1. 以前に作成したビルドプロジェクト (例: `codebuild-bankdemo-project`) を選択します。
1. [**Start build**] を選択します。
このコマンドはビルドを開始します。ビルドは非同期で実行されます。コマンドの出力は、属性 ID を含む JSON です。この属性 ID は、開始したばかりのビルドの CodeBuild ビルド ID への参照です。コンソールで、ビルドのステータスを表示することができます。ビルド実行に関する詳細なログをコンソールで確認することもできます。詳細については、「*AWS CodeBuild ユーザーガイド*」の「[詳細なビルド情報を表示する](https://docs.aws.amazon.com/codebuild/latest/userguide/getting-started-build-log-console.html)」を参照してください。
現在のフェーズが完了すると、ビルドが正常に終了し、コンパイルされたアーティファクトが Amazon S3 で準備できたことを意味します。
## ステップ 10: 出力アーティファクトをダウンロードする
このステップでは、Amazon S3 から出力アーティファクトをダウンロードします。Rocket Software ビルドツールは、いくつかの異なる実行可能ファイルタイプを作成できます。このチュートリアルでは、共有オブジェクトを生成します。
1. Amazon S3 コンソールにログインします。
1. **[バケット]** role="bold"> セクションで、出力バケットの名前を選択します (例: `codebuild-regionId-accountId-output-bucket`)。
1. **[ダウンロード]** role="bold" を選択します。
1. ダウンロードした ファイルを解凍します。ターゲットフォルダに移動して、ビルドアーティファクトを確認します。これには `.so` Linux 共有オブジェクトが含まれます。
## リソースをクリーンアップする
このチュートリアルのために作成したリソースが不要になった場合は、追加料金が発生しないように削除します。そのためには、以下のステップを実行します。
+ このチュートリアル用に作成した S3 バケットを削除します。詳細については、「Amazon Simple Storage Service ユーザーガイド」の「[バケットの削除](https://docs.aws.amazon.com/AmazonS3/latest/userguide/delete-bucket.html)」を参照してください。
+ このチュートリアル用に作成した IAM ポリシーを削除します。詳細については、「*IAM ユーザーガイド*」の「[IAM ポリシーの削除](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_manage-delete.html)」を参照してください。
+ このチュートリアル用に作成した IAM ロールを削除します。詳細については、「IAM ユーザーガイド」の「[ロールまたはインスタンスプロファイルを削除する](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_manage_delete.html)」を参照してください。
+ このチュートリアル用に作成した CodeBuild プロジェクトを削除します。詳細については、「*AWS CodeBuild ユーザーガイド*」の「[Delete a build project in CodeBuild](https://docs.aws.amazon.com/codebuild/latest/userguide/delete-project.html)」を参照してください。
# チュートリアル: Rocket Enterprise Analyzer と Rocket Enterprise Developer で使用する WorkSpaces アプリケーションをセットアップする
AWS Mainframe Modernization は、Amazon WorkSpaces アプリケーションを通じていくつかのツールを提供します。WorkSpaces Applications は、フルマネージド型の安全なアプリケーションストリーミングサービスで、アプリケーションを書き換えることなくデスクトップアプリケーションをユーザーにストリーミングできます。WorkSpaces アプリケーションを使用すると、ユーザーは必要なアプリケーションにすぐにアクセスでき、選択したデバイスで応答性が高く滑らかなユーザーエクスペリエンスが得られます。WorkSpaces アプリケーションを使用してランタイムエンジン固有のツールをホストすると、お客様のアプリケーションチームはウェブブラウザから直接ツールを使用して、Amazon S3 バケットまたは CodeCommit リポジトリに保存されているアプリケーションファイルを操作できます。
WorkSpaces アプリケーションのブラウザサポートの詳細については、Amazon WorkSpaces アプリケーション管理ガイドの[「システム要件と機能サポート (Web ブラウザ)](https://docs.aws.amazon.com/appstream2/latest/developerguide/requirements-and-features-web-browser-admin.html)」を参照してください。 *Amazon WorkSpaces * WorkSpaces アプリケーションの使用中に問題が発生した場合は、「Amazon WorkSpaces アプリケーション管理ガイド」の[AppStream 2.0 ユーザーの問題のトラブルシューティング](https://docs.aws.amazon.com/appstream2/latest/developerguide/troubleshooting-user-issues.html)」を参照してください。 *Amazon WorkSpaces *
このドキュメントは、カスタマーオペレーションチームのメンバーを対象としています。 AWS Mainframe Modernization で使用される Rocket Enterprise Analyzer と Rocket Enterprise Developer ツールをホストするように Amazon WorkSpaces アプリケーションフリートとスタックを設定する方法について説明します。Rocket Enterprise Analyzer は通常、評価フェーズで使用され、Rocket Enterprise Developer は通常、 AWS Mainframe Modernization アプローチの移行とモダナイズフェーズで使用されます。Enterprise Analyzer と Enterprise Developer の両方を使用する予定がある場合は、ツールごとに別々のフリートとスタックを作成する必要があります。ライセンス条件が異なるため、ツールごとに独自のフリートとスタックが必要です。
**重要**
このチュートリアルの手順は、ダウンロード可能な CloudFormation テンプレート [cfn-m2-appstream-fleet-ea-ed.yml](https://drm0z31ua8gi7.cloudfront.net/tutorials/mf/appstream/cfn-m2-appstream-fleet-ea-ed.yml) に基づいています。
**Topics**
+ [前提条件](#tutorial-aas-prerequisites)
+ [ステップ 1: WorkSpaces アプリケーションイメージを取得する](#tutorial-aas-step1)
+ [ステップ 2: CloudFormation テンプレートを使用してスタックを作成する](#tutorial-aas-step2)
+ [ステップ 3: WorkSpaces アプリケーションでユーザーを作成する](#tutorial-aas-step3)
+ [ステップ 4: WorkSpaces アプリケーションにログインする](#tutorial-aas-step4)
+ [ステップ 5: Amazon S3 のバケットを確認する (オプション)](#tutorial-aas-step5)
+ [次の手順](#tutorial-aas-next-steps)
+ [リソースをクリーンアップする](#tutorial-aas-cleanup)
## 前提条件
+ テンプレート [cfn-m2-appstream-fleet-ea-ed.yml](https://drm0z31ua8gi7.cloudfront.net/tutorials/mf/appstream/cfn-m2-appstream-fleet-ea-ed.yml) をダウンロードしてください。
+ デフォルト VPC とセキュリティグループの ID を取得します。詳細については、「*Amazon VPC ユーザーガイド*」の「[デフォルト VPC とデフォルトサブネット](https://docs.aws.amazon.com/vpc/latest/userguide/default-vpc.html)」を参照してください。デフォルトのセキュリティグループの詳細については、「*Amazon EC2 ユーザーガイド*」の「[デフォルトセキュリティグループとカスタムセキュリティグループ](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/default-custom-security-groups.html)」を参照してください。
+ 次のアクセス許可があることを確認します。
+ WorkSpaces アプリケーションでスタック、フリート、ユーザーを作成します。
+ テンプレート CloudFormation を使用して でスタックを作成します。
+ バケットを作成し、Amazon S3 のバケットにファイルをアップロードします。
+ IAM から認証情報 (`access_key_id`と`secret_access_key`) をダウンロードします。
## ステップ 1: WorkSpaces アプリケーションイメージを取得する
このステップでは、Enterprise Analyzer および Enterprise Developer の WorkSpaces アプリケーションイメージを AWS アカウントと共有します。
1. [https://console.aws.amazon.com/m2/](https://us-west-2.console.aws.amazon.com/m2/home?region=us-west-2#/) で AWS Mainframe Modernization コンソールを開きます。
1. 左側のナビゲーションで、**[ツール]** を選択します。
1. **分析、開発、アセットの構築**で、**アセットを自分の AWS アカウントと共有**を選択します。
## ステップ 2: CloudFormation テンプレートを使用してスタックを作成する
このステップでは、ダウンロードした CloudFormation テンプレートを使用して、Rocket Enterprise Analyzer を実行するための WorkSpaces アプリケーションスタックとフリートを作成します。後でこのステップを繰り返して、Rocket Enterprise Developer を実行するための別の WorkSpaces アプリケーションスタックとフリートを作成できます。これは、各ツールが WorkSpaces アプリケーションに独自のフリートとスタックを必要とするためです。 CloudFormation スタックの詳細については、「 *AWS CloudFormation ユーザーガイド*」の[「スタックの使用](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacks.html)」を参照してください。
**注記**
AWS Mainframe Modernization は、Enterprise Analyzer と Enterprise Developer を使用するための標準の WorkSpaces アプリケーションの料金に追加料金を追加します。詳細については、「[AWS Mainframe Modernization pricing](https://aws.amazon.com/mainframe-modernization/pricing/)」を参照してください。
1. 必要に応じて、[cfn-m2-appstream-fleet-ea-ed.yml](https://drm0z31ua8gi7.cloudfront.net/tutorials/mf/appstream/cfn-m2-appstream-fleet-ea-ed.yml) テンプレートをダウンロードしてください。
1. CloudFormation コンソールを開き、**新しいリソース (標準) を使用して** **スタックの作成 **と を選択します。
1. **[前提条件 - テンプレートの準備]** で、**[テンプレートの準備完了]** を選択します。
1. **[テンプレートの指定]** で、**[テンプレートファイルのアップロード]** を選択します。
1. **[テンプレートファイルのアップロード]** で **[ファイルを選択]** を選択し、[cfn-m2-appstream-fleet-ea-ed.yml](https://drm0z31ua8gi7.cloudfront.net/tutorials/mf/appstream/cfn-m2-appstream-fleet-ea-ed.yml) テンプレートをアップロードします。
1. [**次へ**] を選択します。
![\[選択した cfn-m2-appstream-fleet-ea-ed.yml テンプレートを使用してスタック CloudFormation を作成するページ。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/cfn-create-stack.png)
1. **[スタックの詳細を指定]** で、次の情報を入力します。
+ **[スタック名]** で、希望する名前を入力します。例えば、**m2-ea**。
+ **[AppStreamApplication]** で、**[ea]** を選択します。
+ **[AppStreamFleetSecurityGroup]** で、デフォルトの VPC のデフォルトのセキュリティグループを選択します。
+ **[AppStreamFleetVpcSubnet]** で、デフォルトの VPC 内のサブネットを選択します。
+ **[AppStreamImageName]** で、`m2-enterprise-analyzer` で始まるイメージを選択します。このイメージには、現在サポートされているバージョンの Rocket Enterprise Analyzer ツールが含まれています。
+ 他のフィールドはデフォルトのままにし、**[次へ]** を選択します。
![\[Enterprise Analyzer オプションが入力されたスタックの詳細 CloudFormation の指定ページ。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/cfn-specify-stack-details.png)
1. すべてをデフォルトのままにし、**[次へ]** を選択します。
1. **[レビュー]** で、すべてのパラメータが意図したとおりであることを確認します。
1. 一番下までスクロールし、**[AWS CloudFormation によって IAM リソースが作成される場合があることを承認します]** を選択し、**[スタックの作成]** を選択します。
スタックとフリートが作成されるまで 20～30 分かかります。**更新**を選択すると、発生した CloudFormation イベントを表示できます。
## ステップ 3: WorkSpaces アプリケーションでユーザーを作成する
がスタックの作成を完了する CloudFormation のを待っている間に、WorkSpaces アプリケーションで 1 人以上のユーザーを作成できます。これらのユーザーは、WorkSpaces アプリケーションで Enterprise Analyzer を使用するユーザーです。各ユーザーの E メールアドレスを指定し、各ユーザーが Amazon S3 でバケットを作成し、バケットにファイルをアップロードし、バケットにリンクして内容をマッピングするための十分なアクセス許可を持っていることを確認する必要があります。
1. WorkSpaces アプリケーションコンソールを開きます。
1. 左側のナビゲーションで、**[ユーザープール]** を選択します。
1. **[ユーザーの作成]** を選択します。
1. ユーザーが WorkSpaces アプリケーションを使用するための招待メールを受信できる E メールアドレス、姓と名を入力し、**ユーザーの作成**を選択します。
1. 必要に応じて同じ手順を繰り返して、さらにユーザーを作成します。各メールアドレスは異なるメールアドレスでなければなりません。
WorkSpaces アプリケーションユーザーの作成の詳細については、Amazon [WorkSpaces アプリケーション管理ガイドの「WorkSpaces アプリケーションユーザープール](https://docs.aws.amazon.com/appstream2/latest/developerguide/user-pool.html)」を参照してください。 *Amazon WorkSpaces *
がスタックの作成 CloudFormation を完了すると、次のように、作成したユーザーをスタックに割り当てることができます。
1. WorkSpaces アプリケーションコンソールを開きます。
1. ユーザー名を選択します。
1. **[アクション]**、**[スタックを割り当てる]** の順に選択します。
1. **[スタックを割り当てる]** で、`m2-appstream-stack-ea` で始まるスタックを選択します。
1. [**Assign stack**] を選択します。
![\[ユーザーと割り当てられた Enterprise Analyzer スタックを示す WorkSpaces アプリケーション割り当てスタックページ。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/aas-assign-stack.png)
スタックにユーザーを割り当てると、WorkSpaces アプリケーションは指定したアドレスのユーザーに E メールを送信します。この E メールには、WorkSpaces アプリケーションログインページへのリンクが含まれています。
## ステップ 4: WorkSpaces アプリケーションにログインする
このステップでは、WorkSpaces アプリケーションから で作成したユーザーに送信される E メールのリンクを使用して WorkSpaces アプリケーションにログインします[ステップ 3: WorkSpaces アプリケーションでユーザーを作成する](#tutorial-aas-step3)。
1. WorkSpaces Applications から送信された E メールに記載されているリンクを使用して WorkSpaces アプリケーションにログインします。
1. プロンプトが表示されたら、パスワードを変更します。表示される WorkSpaces アプリケーション画面は次のようになります。
![\[デスクトップアイコンを示す WorkSpaces Applications ログイン画面の例。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/aas-login-screen.png)
1. **[デスクトップ]** を選択します。
1. タスクバーで **[検索]** を選択し、**D:** を入力してホームフォルダに移動します。
**注記**
このステップを省略すると、ホームフォルダにアクセスしようとしたときに `Device not ready` エラーが発生することがあります。
どの時点でも、WorkSpaces アプリケーションへのサインインに問題がある場合は、次の手順を使用して WorkSpaces アプリケーションフリートを再起動し、再度サインインを試みることができます。
1. WorkSpaces アプリケーションコンソールを開きます。
1. 左側のナビゲーションペインの **[フリート]** を選択します。
1. 使用するフリートを選択してください。
1. **[アクション]** を選択し、**[停止]** を選択します。
1. フリートが停止するのを待ちます。
1. **[アクション]** を選択してから、**[開始]** を選択します。
このプロセスには 10 分ほどかかる場合があります。
## ステップ 5: Amazon S3 のバケットを確認する (オプション)
スタックの作成に使用した CloudFormation テンプレートで完了したタスクの 1 つは、Amazon S3 に 2 つのバケットを作成することでした。これは、作業セッション全体でユーザーデータとアプリケーション設定を保存および復元するために必要です。これらのバケットは以下のとおりです。
+ 名前は `appstream2-` で始まります。このバケットは、WorkSpaces アプリケーション () のホームフォルダにデータをマッピングします`D:\PhotonUser\My Files\Home Folder`。
**注記**
ホームフォルダは、特定の E メールアドレスに対して一意であり、特定の AWS アカウントのすべてのフリートとスタックで共有されます。ホームフォルダの名前は、ユーザーのメールアドレスの SHA256 ハッシュで、そのハッシュに基づくパスに保存されます。
+ 名前は `appstream-app-settings-` で始まります。このバケットには、WorkSpaces アプリケーションのユーザーセッション情報が含まれており、ブラウザのお気に入り、IDE およびアプリケーション接続プロファイル、UI のカスタマイズなどの設定が含まれています。詳細については、*Amazon WorkSpaces * [アプリケーション管理ガイド」の「アプリケーション設定の永続化の仕組み](https://docs.aws.amazon.com/appstream2/latest/developerguide/how-it-works-app-settings-persistence.html)」を参照してください。
バケットが作成されたことを確認するには、次のステップに従います。
1. Amazon S3 コンソールを開きます。
1. 左側のナビゲーションペインで、**[バケット]** を選択します。
1. **[名前でバケットを検索]** に、「**appstream**」と入力してリストをフィルタリングします。
バケットが表示されている場合は、これ以外のアクションは必要ありません。バケットが存在することだけは覚えておいてください。バケットが表示されない場合は、 CloudFormation テンプレートの実行が完了していないか、エラーが発生しています。 CloudFormation コンソールに移動し、スタック作成メッセージを確認します。
## 次の手順
WorkSpaces アプリケーションインフラストラクチャがセットアップされたので、Enterprise Analyzer をセットアップして使用を開始できます。詳細については、「[チュートリアル: WorkSpaces アプリケーションで Enterprise Analyzer をセットアップする](set-up-ea.md)」を参照してください。Enterprise Developer をセットアップすることもできます。詳細については、「[チュートリアル: WorkSpaces アプリケーションで Rocket Enterprise Developer をセットアップする](set-up-ed.md)」を参照してください。
## リソースをクリーンアップする
作成されたスタックとフリートをクリーンアップする手順については、[WorkSpaces アプリケーションフリートとスタックの作成](https://docs.aws.amazon.com/appstream2/latest/developerguide/set-up-stacks-fleets.html)」を参照してください。
WorkSpaces アプリケーションオブジェクトが削除されると、アカウント管理者は、必要に応じて、アプリケーション設定とホームフォルダの Amazon S3 バケットをクリーンアップすることもできます。
**注記**
特定のユーザーのホームフォルダはすべてのフリートで一意であるため、他の WorkSpaces アプリケーションスタックが同じアカウントでアクティブになっている場合は、保持する必要がある場合があります。
最後に、WorkSpaces Applications では現在、コンソールを使用してユーザーを削除することはできません。代わりに、CLI でサービス API を使用する必要があります。詳細については、「Amazon WorkSpaces アプリケーション[管理ガイド」の「ユーザープール](https://docs.aws.amazon.com/appstream2/latest/developerguide/user-pool-admin.html)管理」を参照してください。 *Amazon WorkSpaces *
# チュートリアル: Rocket Enterprise Developer (以前の Micro Focus Enterprise Developer) で テンプレートを使用する
このチュートリアルでは、Rocket Enterprise Developer でテンプレートと事前定義されたプロジェクトを使用する方法について説明します。3 つのユースケースについて説明します。すべてのユースケースでは、BankDemo サンプルで提供されているサンプルコードを使用しています。サンプルをダウンロードするには、[https://d1vi4vxke6c2hu.cloudfront.net/demo/bankdemo.zip](https://d1vi4vxke6c2hu.cloudfront.net/demo/bankdemo.zip) を選択します。
**重要**
Enterprise Developer for Windows を使用している場合、コンパイラによって生成されたバイナリは、Enterprise Developer が提供する Enterprise Server でのみ実行できます。Linux に基づく AWS Mainframe Modernization ランタイムでは実行できません。
**Topics**
+ [ユースケース 1 - ソースコンポーネントを含む COBOL プロジェクトテンプレートの使用](#tutorial-templates-ed-step1)
+ [ユースケース 2 - ソースコンポーネントなしで COBOL プロジェクトテンプレートを使用](#tutorial-templates-ed-step2)
+ [ユースケース 3 - ソースフォルダにリンクする事前定義済みの COBOL プロジェクトを使用](#tutorial-templates-ed-step3)
+ [リージョン定義 JSON テンプレートを使用する](#tutorial-templates-ed-step4)
## ユースケース 1 - ソースコンポーネントを含む COBOL プロジェクトテンプレートの使用
このユースケースでは、デモの事前セットアップ手順の一環として、ソースコンポーネントをテンプレートのディレクトリ構造にコピーする必要があります。[https://d1vi4vxke6c2hu.cloudfront.net/demo/bankdemo.zip](https://d1vi4vxke6c2hu.cloudfront.net/demo/bankdemo.zip) では、ソースのコピーを 2 つ必要としないように、元の配布物 `AWSTemplates.zip` から変更されている箇所があります。
1. Enterprise Developer を起動し、選択済みのワークスペースを指定します。
![\[ワークスペースが選択された状態の Eclipse ランチャー。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/ed-uc1-step1.png)
1. **アプリケーションエクスプローラービュー** の **[Enterprise Development プロジェクト]** ツリービュー項目で、コンテキストメニューから **[テンプレートから新規プロジェクト]** を選択します。
![\[[Enterprise Development プロジェクト] ツリービュー項目のコンテキストメニュー。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/ed-uc1-step2.png)
1. 表示されているとおりに、テンプレートのパラメータを入力してください。
**注記**
テンプレートパスは ZIP が抽出された場所を参照します。
![\[[テンプレートパラメータの入力] ボックスに、パスとプロジェクト名を入力します。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/ed-uc1-step3.png)
1. [OK] を選択すると、提供されたテンプレートに基づき、ソースと実行環境構造が完全な、ローカル開発用 Eclipse プロジェクトが作成されます。
![\[ローカル開発用 Eclipse プロジェクトがこの構造を示しています。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/ed-uc1-step4.png)
この `System` 構造には、BANKDEMO に必要なエントリを含む完全なリソース定義ファイル、エントリが追加された必須カタログ、対応する ASCII データファイルが含まれています。
ソーステンプレート構造にはすべてのソース項目が含まれているため、これらのファイルはローカルプロジェクトにコピーされ、Enterprise Developer で自動的に構築されます。
## ユースケース 2 - ソースコンポーネントなしで COBOL プロジェクトテンプレートを使用
ステップ 1 から 3 は [ユースケース 1 - ソースコンポーネントを含む COBOL プロジェクトテンプレートの使用](#tutorial-templates-ed-step1) と同様です。
このユースケースにおける `System` 構造にも、BankDemo に必要なエントリを含む完全なリソース定義ファイル、エントリが追加された必須カタログ、対応する ASCII データファイルが含まれています。
ただし、テンプレートソース構造にはコンポーネントは含まれていません。使用しているソースリポジトリからこれらのコンポーネントをプロジェクトにインポートする必要があります。
1. プロジェクトの名前を選択します。関連するコンテキストメニューから **[インポート]** を選択します。
![\[[インポート] が選択された状態のプロジェクトのコンテキストメニュー。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/ed-uc2-step4.png)
1. ダイアログが表示されたら、**[一般]** セクションで **[ファイルシステム]** を選択し、[次へ] を選択します。
![\[ファイルシステムを選択した状態の [インポート] ボックス。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/ed-uc2-step5.png)
1. ファイルシステムを参照した状態でリポジトリフォルダを指定して、**[差出人ディレクトリ]** フィールドに入力します。`sources` などのインポート先フォルダをすべて選択します。`Into folder` フィールドは、事前入力されています。[**Finish**] を選択してください。
![\[BankDemo ディレクトリが展開された状態のファイルシステムボックス。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/ed-uc2-step6.png)
ソーステンプレート構造にすべてのソーステンプレートが含まれた後、これらの項目は Enterprise Developer で自動的に構築されます。
## ユースケース 3 - ソースフォルダにリンクする事前定義済みの COBOL プロジェクトを使用
1. Enterprise Developer を起動し、選択済みのワークスペースを指定します。
![\[ワークスペースが選択された状態の Eclipse ランチャー。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/ed-uc3-step1.png)
1. **[ファイル]** メニューから **[インポート]** を選択します。
![\[[インポート] を選択した状態の [ファイル] メニュー。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/ed-uc3-step2.png)
1. 表示されたダイアログの **[一般]** で、**[フォルダまたはアーカイブからのプロジェクト]** を選択し、**[次へ]** を選択します。
![\[[フォルダまたはアーカイブからのプロジェクト] を選択した状態の [インポート] ボックス。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/ed-uc3-step3.png)
1. **[ソースをインポート]** を選択し、**[ディレクトリ]** を選択し、ファイルシステムを参照して事前定義済みのプロジェクトフォルダを選択します。この中に含まれるプロジェクトには、同じリポジトリ内のソースフォルダへのリンクがあります。
![\[[ファイルシステムまたはアーカイブからプロジェクトをインポート] ボックスに、インポートソースへのパスが入力されています。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/ed-uc3-step4.png)
[**Finish**] を選択してください。
プロジェクトにはソースフォルダへのリンクが入力されるため、コードは自動的に構築されます。
## リージョン定義 JSON テンプレートを使用する
1. Server Explorer ビューに切り替えます。関連するコンテキストメニューから **[管理ページを開く]** を選択すると、デフォルトのブラウザが起動します。
![\[[管理ページを開く] を選択した状態の Server Explorer のコンテキストメニュー。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/ed-json-admin-page.png)
1. 表示された Server Explorer 共通 Web 管理 (ESCWA) 画面から、**[インポート]** を選択します。
![\[[インポート] を選択した状態の [Enterprise Server 共通 Web 管理] 画面。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/ed-json-import.png)
1. **JSON** インポートタイプを選択し、**[次へ]** を選択します。
![\[JSON を選択した状態の [インポートタイプの選択] ボックス。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/ed-json-import-type.png)
1. 指定した `BANKDEMO.JSON` ファイルをアップロードします。
![\[BANKDEMO ファイルを選択した状態の [アップロードするファイルを選択] ボックス。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/ed-json-upload.png)
選択したら、**[次へ]** を選択します。
![\[エンドポイントのクリアポートが表示された [リージョンの選択] ボックスは選択されていません。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/ed-json-next.png)
**[リージョンの選択]** パネルで、**[エンドポイントからポートをクリア]** オプションが未選択であることを確認してから、**[インポートの実行]** パネルが表示されるまで各パネルで **[次へ]** を選択します。左側のナビゲーションペインで、**[バケット]** を選択します。
最後に **[完了]** をクリックします。この流れで、BANKDEMO リージョンがサーバーリストに追加されます。
![\[BankDemo が追加されたリージョンとサーバーリスト。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/ed-json-server-list.png)
1. BANKDEMO リージョンの **[一般プロパティ]** に移動します。
1. **[設定]** セクションにスクロールします。
1. 前のステップで作成した Eclipse プロジェクトに関連する `System` フォルダに ESP 環境変数を設定する必要があります。これは `workspacefolder/projectname/System` に設定されている必要があります。
![\[ESP 変数が表示された状態の構成セクション。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/ed-json-ESP.png)
1. [**適用**] をクリックします。
これで、このリージョンが Eclipse COBOL プロジェクトと連携して動作するように設定が完了しました。
1. 最後に、Enterprise Developer に戻り、インポートしたリージョンをプロジェクトに関連付けます。
![\[[プロジェクトに関連付け] を選択した状態のプロジェクトのコンテキストメニュー。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/ed-json-associate.png)
これで、Enterprise Developer 環境が使用可能になり、BankDemo の完全版が完成しました。設定済みのリージョンにおいてコードを編集、コンパイル、デバッグできます。
**重要**
Enterprise Developer for Windows を使用している場合、コンパイラによって生成されたバイナリは、Enterprise Developer が提供する Enterprise Server でのみ実行できます。Linux に基づく AWS Mainframe Modernization ランタイムでは実行できません。
# チュートリアル: WorkSpaces アプリケーションで Enterprise Analyzer をセットアップする
このチュートリアルでは、1 つ以上のメインフレームアプリケーションを分析するために Rocket Enterprise Analyzer (以前の Micro Focus Enterprise Analyzer) を設定する方法について説明します。Enterprise Analyzer ツールは、アプリケーションのソースコードとシステム定義の分析に基づいて複数のレポートを提供します。
この設定は、チームのコラボレーションを促進するように設計されています。インストールでは Amazon S3 バケットを使用して、仮想ディスクとソースコードを共有します。これを行うには、Windows マシンの [Rclone](https://rclone.org/)) を利用します。[PostgreSQL](https://www.postgresql.org/) を実行する共通の Amazon RDS インスタンスでは、チームのどのメンバーもリクエストされたすべてのレポートにアクセスできます。
チームメンバーは、Amazon S3 でバックアップされた仮想ディスクを自分のパーソナルマシンにマウントし、ワークステーションからソースバケットを更新することもできます。他のオンプレミスの内部システムに接続していれば、自分のマシンでスクリプトやその他の自動化手段を使用できる可能性があります。
セットアップは、 AWS Mainframe Modernization が顧客 と共有している WorkSpaces Applications Windows イメージに基づいています。セットアップは、「」で説明されているように、WorkSpaces アプリケーションフリートとスタックの作成にも基づいています[チュートリアル: Rocket Enterprise Analyzer と Rocket Enterprise Developer で使用する WorkSpaces アプリケーションをセットアップする](set-up-appstream-mf.md)。
**重要**
このチュートリアルのステップでは、ダウンロード可能な CloudFormation テンプレート [cfn-m2-appstream-fleet-ea-ed.yml](https://drm0z31ua8gi7.cloudfront.net/tutorials/mf/appstream/cfn-m2-appstream-fleet-ea-ed.yml) を使用して WorkSpaces アプリケーションを設定することを前提としています。詳細については、「[チュートリアル: Rocket Enterprise Analyzer と Rocket Enterprise Developer で使用する WorkSpaces アプリケーションをセットアップする](set-up-appstream-mf.md)」を参照してください。
このチュートリアルのステップを実行するには、Enterprise Analyzer フリートとスタックを設定済みで、それらが実行中である必要があります。
Enterprise Analyzer の機能と成果物の詳細については、Rocket Software (旧 Micro Focus) ウェブサイトの [Enterprise Analyzer ドキュメント](https://www.microfocus.com/documentation/enterprise-analyzer/)を参照してください。
## イメージのコンテンツ
Enterprise Analyzer アプリケーション自体に加えて、イメージには次のツールとライブラリが含まれています。
サードパーティー製ツール
+ [Python](https://www.python.org/)
+ [Rclone](https://rclone.org/)
+ [pgAdmin](https://www.pgadmin.org/)
+ [git-scm](https://git-scm.com/)
+ [PostgreSQL ODBC ドライバー](https://odbc.postgresql.org/)
`C:\Users\Public` 内のライブラリ
+ Enterprise Developer 向けの BankDemo ソースコードとプロジェクト定義: `m2-bankdemo-template.zip`。
+ メインフレーム用の MFA インストールパッケージ: `mfa.zip`。詳細については、「*Micro Focus Enterprise Developer* ドキュメント」の「[Mainframe Access Overview](https://www.microfocus.com/documentation/enterprise-developer/30pu12/ED-VS2012/BKMMMMINTRS001.html)」を参照してください。
+ Rclone のコマンドファイルおよび設定ファイル (使用方法はチュートリアルに記載されています): `m2-rclone.cmd` と `m2-rclone.conf`。
**Topics**
+ [イメージのコンテンツ](#set-up-ea-image-contents)
+ [前提条件](#tutorial-ea-prerequisites)
+ [ステップ 1: セットアップ](#tutorial-ea-step1)
+ [ステップ 2: Windows 用の Amazon S3 ベースの仮想フォルダを作成する](#tutorial-ea-step2)
+ [ステップ 3: Amazon RDS インスタンス用の ODBC ソースを作成する](#tutorial-ea-step3)
+ [以降のセッション](#tutorial-ea-step4)
+ [ワークスペース接続のトラブルシューティング](#tutorial-ea-step5)
+ [リソースをクリーンアップする](#tutorial-ea-clean)
## 前提条件
+ 分析する顧客アプリケーションのソースコードとシステム定義を S3 バケットにアップロードします。システム定義には、CICS CSD、DB2 オブジェクト定義などが含まれます。バケット内には、アプリケーションのアーティファクトをどのように整理するかに合わせたフォルダ構造を作成できます。例えば、BankDemo サンプルを解凍すると、次の構造になります。
```
demo
|--> jcl
|--> RDEF
|--> transaction
|--> xa
```
+ PostgreSQL を実行している Amazon RDS インスタンスを作成して開始する このインスタンスには、Enterprise Analyzer によって生成されたデータと結果が保存されます。このインスタンスは、アプリケーションチームのすべてのメンバーと共有できます。また、`m2_ea` (またはその他の適切な名前) という名前の空のスキーマをデータベースに作成します。権限のあるユーザーがこのスキーマの項目を作成、挿入、更新、削除できるようにする認証情報を定義します。データベース名、サーバーエンドポイント URL、TCP ポートは Amazon RDS コンソールまたはアカウント管理者から取得できます。
+ へのプログラムによるアクセスが設定されていることを確認します AWS アカウント。詳細については、「*Amazon Web Services 全般のリファレンス*」の「[プログラム的なアクセス](https://docs.aws.amazon.com/general/latest/gr/aws-sec-cred-types.html#access-keys-and-secret-access-keys)」を参照してください。
## ステップ 1: セットアップ
1. WorkSpaces アプリケーションからのウェルカム E メールメッセージで受信した URL を使用して WorkSpaces アプリケーションとのセッションを開始します。
1. E メールをユーザー ID として使用し、永久パスワードを定義します。
1. Enterprise Analyzer スタックを選択します。
1. WorkSpaces アプリケーションメニューページで、**デスクトップ**を選択して、フリートがストリーミングしている Windows デスクトップにアクセスします。
## ステップ 2: Windows 用の Amazon S3 ベースの仮想フォルダを作成する
**注記**
AWS Mainframe Modernization プレビュー中に Rclone を既に使用している場合は、 にある新しいバージョン`m2-rclone.cmd`に更新する必要があります`C:\Users\Public`。
1. `C:\Users\Public` で提供されている `m2-rclone.conf` ファイルと `m2-rclone.cmd` ファイルを、ファイルエクスプローラーを使用してホームフォルダ `C:\Users\PhotonUser\My Files\Home Folder` にコピーします。
1. AWS アクセスキーと対応するシークレット、および `m2-rclone.conf` を使用して、設定パラメータを更新します AWS リージョン。
```
[m2-s3]
type = s3
provider = AWS
access_key_id = YOUR-ACCESS-KEY
secret_access_key = YOUR-SECRET-KEY
region = YOUR-REGION
acl = private
server_side_encryption = AES256
```
1. `m2-rclone.cmd` で、以下の変更を加えます。
+ `amzn-s3-demo-bucket` を Amazon S3 バケットの名前に変更します。例えば、`m2-s3-mybucket`。
+ `your-s3-folder-key` を Amazon S3 バケットキーに変更します。例えば、`myProject`。
+ `your-local-folder-path` を、アプリケーションファイルを含む Amazon S3 バケットから同期するディレクトリのパスに変更します。例えば、`D:\PhotonUser\My Files\Home Folder\m2-new`。WorkSpaces アプリケーションがセッションの開始と終了時に適切にバックアップおよび復元するには、この同期されたディレクトリがホームフォルダのサブディレクトリである必要があります。
```
:loop
timeout /T 10
"C:\Program Files\rclone\rclone.exe" sync m2-s3:amzn-s3-demo-bucket/your-s3-folder-key "D:\PhotonUser\My Files\Home Folder\your-local-folder-path" --config "D:\PhotonUser\My Files\Home Folder\m2-rclone.conf"
goto :loop
```
1. Windows コマンドプロンプトを開き、必要に応じて cd コマンドで `C:\Users\PhotonUser\My Files\Home Folder` に変更し、`m2-rclone.cmd` を実行します。このコマンドスクリプトは連続ループを実行し、Amazon S3 バケットとキーを 10 秒ごとにローカルフォルダに同期します。タイムアウトは、必要に応じて調整できます。Windows ファイルエクスプローラーの Amazon S3 バケットにあるアプリケーションのソースコードが表示されます。
作業中のセットに新しいファイルを追加したり、既存のファイルを更新したりするには、ファイルを Amazon S3 バケットにアップロードします。そうすれば、`m2-rclone.cmd` で定義した次のイテレーションでディレクトリに同期されます。同様に、ファイルを削除する場合は Amazon S3 バケットから削除します。次の同期オペレーションでは、ローカルディレクトリから削除されます。
## ステップ 3: Amazon RDS インスタンス用の ODBC ソースを作成する
1. EA\$1Admin ツールを開始するには、ブラウザウィンドウの左上隅にあるアプリケーションセレクタメニューに移動し、**[MF EA\$1Admin]** を選択します。
1. **[管理]** メニューから、**[ODBC データソース]** を選択し、**[ユーザー DSN]** タブから **[追加]** を選択します。
1. [新しいデータソースを作成] ダイアログボックスで、**[PostgreSQL Unicode]** ドライバーを選択し、**[終了]** を選択します。
1. **[PostgreSQL Unicode ODBC ドライバー (psqlODBC) のセットアップ]** ダイアログボックスで、目的のデータソース名を定義し、書き留めておきます。以前に作成した RDS インスタンスの値を使用して、次のパラメータを入力します。
**説明**
このデータベース接続をすばやく識別するのに役立つ説明 (オプション)。
**データベース**
以前に作成した Amazon RDS データベース。
**サーバー**
Amazon RDS エンドポイント。
**ポート**
Amazon RDS ポート。
**ユーザー名**
Amazon RDS インスタンスで定義されているとおり。
**[パスワード]**
Amazon RDS インスタンスで定義されているとおり。
1. **[テスト]** を選択して Amazon RDS への接続が成功したことを確認し、**[保存]** を選択して新しいユーザー DSN を保存します。
1. 適切なワークスペースが作成されたことを確認するメッセージが表示されるまで待ってから、**[OK]** を選択して ODBC データソースを終了し、EA\$1Admin ツールを閉じます。
1. アプリケーションセレクタメニューに再度移動し、[Enterprise Analyzer] を選択してツールを開始します。**[新規作成]** を選択します。
1. ワークスペース設定ウィンドウで、ワークスペース名を入力し、その場所を定義します。ワークスペースは、この設定で作業する場合は Amazon S3 ベースのディスクにすることも、必要に応じてホームフォルダにすることもできます。
1. **[他のデータベースを選択]** を選択して、Amazon RDS インスタンスに接続します。
1. オプションから **[Postgre]** アイコンを選択し、**[OK]** を選択します。
1. Windows 設定の **[オプション - 接続パラメータの定義]** に、作成したデータソースの名前を入力します。データベース名、スキーマ名、ユーザー名、パスワードも入力します。[**OK**] を選択してください。
1. Enterprise Analyzer が結果を保存するために必要なテーブル、インデックスなどをすべて作成するまでお待ちください。このステップには数分かかる場合があります。Enterprise Analyzer は、データベースとワークスペースが使用できる状態になったことを確認します。
1. アプリケーションセレクタメニューに再度移動し、[Enterprise Analyzer] を選択してツールを開始します。
1. Enterprise Analyzer のスタートアップウィンドウが、新しく選択したワークスペースの場所に表示されます。[**OK**] を選択してください。
1. 左ペインのリポジトリに移動し、リポジトリ名を選択し、**[ファイル/フォルダをワークスペースに追加]** を選択します。アプリケーションコードが保存されているフォルダを選択して、ワークスペースに追加します。必要であれば、以前の BankDemo サンプルコードを使用できます。Enterprise Analyzer からこれらのファイルの検証を求めるメッセージが表示されたら、**[検証]** を選択して最初の Enterprise Analyzer 検証レポートを開始します。アプリケーションのサイズによっては、完了するまで数分かかる場合があります。
1. ワークスペースを展開すると、ワークスペースに追加したファイルとフォルダが表示されます。オブジェクトタイプと循環的複雑度レポートは、**[チャートビューアー]** ペインの上部にも表示されます。
これで、必要なすべてのタスクに Enterprise Analyzer を使用できるようになりました。
## 以降のセッション
1. WorkSpaces アプリケーションからのウェルカム E メールメッセージで受信した URL を使用して WorkSpaces アプリケーションとのセッションを開始します。
1. E メールと永久パスワードを使用してログインします。
1. Enterprise Analyzer スタックを選択します。
1. このオプションを使用してワークスペースファイルを共有する場合は、`Rclone` を起動して Amazon S3 バックアップディスクに接続します。
1. Enterprise Analyzer を起動してタスクを行います。
## ワークスペース接続のトラブルシューティング
Enterprise Analyzer ワークスペースに再接続しようとすると、次のようなエラーが表示される場合があります。
```
Cannot access the workspace directory D:\PhotonUser\My Files\Home Folder\EA_BankDemo. The workspace has been created on a non-shared disk of the EC2AMAZ-E6LC33H computer. Would you like to correct the workspace directory location?
```
この問題を解決するには、**[OK]** を選択してメッセージをクリアし、次の手順を実行します。
1. WorkSpaces Applications で、ツールバーの**アプリケーション起動**アイコンを選択し、**EA\$1Admin** を選択して Enterprise Analyzer 管理ツールを起動します。
![\[Rocket Enterprise Developer 管理ツールが選択された WorkSpaces アプリケーション起動セレクタメニュー。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/aas-launch-selector.png)
1. **[管理]** メニューから **[ワークスペースパスを更新...]** を選択します。
![\[更新 Workspace パスを選択して、Rocket Enterprise Analyzer 管理ツールのメニューを管理します。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/ea_admin-administer-refresh.png)
1. **[ワークスペースを選択]** で、目的のワークスペースを選択し、**[OK]** を選択します。
![\[プロジェクトを選択した Rocket Enterprise Analyzer 管理ツールのワークスペースの選択ダイアログボックス。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/ea_admin-select-workspace.png)
1. **[OK]** を選択してエラーメッセージを確認します。
![\[Enterprise Analyzer エラーメッセージ。[OK] が選択されているワークスペースディレクトリにはアクセスできません。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/ea_admin-select-workspace-error.png)
1. **[ワークスペースディレクトリのネットワークパス]** に、ワークスペースへの正しいパス (例: `D:\PhotonUser\My Files\Home Folder\EA\MyWorkspace3`) を入力します。
![\[[Enterprise Analyzer] ダイアログボックス。サンプルパスが入力されたワークスペースディレクトリネットワークパス。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/ea_admin-workspace-directory-network-path.png)
1. Micro Focus Enterprise Analyzer 管理ツールを閉じます。
![\[[閉じる] ボタンが選択された Micro Focus Enterprise Analyzer 管理ツール。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/ea_admin-close.png)
1. WorkSpaces Applications で、ツールバーの**アプリケーション起動**アイコンを選択し、**EA** を選択して Micro Focus Enterprise Analyzer を起動します。
![\[WorkSpaces アプリケーションは、EA が選択された状態でアプリケーションを起動します。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/aas-launch-ea.png)
1. ステップ 3～5 を繰り返します。
これで、Micro Focus Enterprise Analyzer が既存のワークスペースで開かれるはずです。
## リソースをクリーンアップする
このチュートリアル用に作成したリソースが不要になった場合は、追加料金の発生を避けるため、それらを削除してください。以下のステップを実行します。
+ **[EA\$1Admin]** ツールを使用してワークスペースを削除します。
+ このチュートリアル用に作成した S3 バケットを削除します。詳細については、「*Amazon S3 ユーザーガイド*」の「[バケットの削除](https://docs.aws.amazon.com/AmazonS3/latest/userguide/delete-bucket.html)」を参照してください。
+ このチュートリアル用に作成したデータベースを削除します。詳細については、「[DB インスタンスの削除](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_GettingStarted.CreatingConnecting.PostgreSQL.html#CHAP_GettingStarted.Deleting.PostgreSQL)」を参照してください。
# チュートリアル: WorkSpaces アプリケーションで Rocket Enterprise Developer をセットアップする
このチュートリアルでは、1 つ以上のメインフレームアプリケーション用に Rocket Enterprise Developer (以前の Micro Focus Enterprise Developer) をセットアップして、Enterprise Developer 機能を使用してメンテナンス、コンパイル、テストする方法について説明します。セットアップは、 AWS Mainframe Modernization がお客様と共有する WorkSpaces Applications Windows イメージと、「」で説明されている WorkSpaces Applications フリートとスタックの作成に基づいています[チュートリアル: Rocket Enterprise Analyzer と Rocket Enterprise Developer で使用する WorkSpaces アプリケーションをセットアップする](set-up-appstream-mf.md)。
**重要**
このチュートリアルのステップでは、ダウンロード可能な CloudFormation テンプレート [cfn-m2-appstream-fleet-ea-ed.yaml](https://d1vi4vxke6c2hu.cloudfront.net/tutorial/cfn-m2-appstream-fleet-ea-ed.yaml) を使用して WorkSpaces アプリケーションを設定することを前提としています。詳細については、「[チュートリアル: Rocket Enterprise Analyzer と Rocket Enterprise Developer で使用する WorkSpaces アプリケーションをセットアップする](set-up-appstream-mf.md)」を参照してください。
このセットアップのステップは、Enterprise Developer フリートとスタックが稼働しているときに実行する必要があります。
Enterprise Developer v7 の機能と成果物の詳細については、Rocket Software [(旧 Micro Focus) サイトのup-to-dateオンラインドキュメント (v7.0](https://www.microfocus.com/documentation/enterprise-developer/ed70/ED-Eclipse/GUID-8D6B7358-AC35-4DAF-A445-607D8D97EBB2.html)) を参照してください。
## イメージのコンテンツ
イメージには、Enterprise Developer 自体に加えて、Rumba (TN3270 エミュレータ) を含むイメージが含まれています。次のツールとライブラリも含まれています。
サードパーティー製ツール
+ [Python](https://www.python.org/)
+ [Rclone](https://rclone.org/)
+ [pgAdmin](https://www.pgadmin.org/)
+ [git-scm](https://git-scm.com/)
+ [PostgreSQL ODBC ドライバー](https://odbc.postgresql.org/)
`C:\Users\Public` 内のライブラリ
+ Enterprise Developer 向けの BankDemo ソースコードとプロジェクト定義: `m2-bankdemo-template.zip`。
+ メインフレーム用の MFA インストールパッケージ: `mfa.zip`。詳細については、「*Micro Focus Enterprise Developer* ドキュメント」の「[Mainframe Access Overview](https://www.microfocus.com/documentation/enterprise-developer/30pu12/ED-VS2012/BKMMMMINTRS001.html)」を参照してください。
+ Rclone のコマンドファイルおよび設定ファイル (使用方法はチュートリアルに記載されています): `m2-rclone.cmd` と `m2-rclone.conf`。
CodeCommit リポジトリにまだロードされていないが、Amazon S3 バケットにあるソースコードにアクセスする必要がある場合 (例えば、ソースコードを Git に最初にロードする場合など) は、[チュートリアル: WorkSpaces アプリケーションで Enterprise Analyzer をセットアップする](set-up-ea.md) で説明されている手順に従って仮想 Windows ディスクを作成します。
**Topics**
+ [イメージのコンテンツ](#set-up-ed-image-contents)
+ [前提条件](#tutorial-ed-prerequisites)
+ [ステップ 1: 個々の Enterprise Developer ユーザーによる設定](#tutorial-ed-step1)
+ [ステップ 2: Windows で Amazon S3 ベースの仮想フォルダを作成する (オプション)](#tutorial-ed-step2)
+ [ステップ 3: リポジトリのクローンを作成する](#tutorial-ed-step3)
+ [以降のセッション](#tutorial-ed-step4)
+ [リソースをクリーンアップする](#tutorial-ed-clean)
## 前提条件
+ 保守対象のアプリケーションのソースコードがロードされた 1 つ以上の CodeCommit リポジトリ。リポジトリのセットアップは、両方のツールを組み合わせてシナジーを作成するために、上記のCI/CDパイプラインの要件と一致する必要があります。
+ 各ユーザーは、「[AWS CodeCommit の認証とアクセスコントロール](https://docs.aws.amazon.com/codecommit/latest/userguide/auth-and-access-control.html)」の情報に従って、アカウント管理者が定義した CodeCommit リポジトリまたはリポジトリへの認証情報を持っている必要があります。これらの認証情報の構造については、「[AWS CodeCommit の認証とアクセスコントロール](https://docs.aws.amazon.com/codecommit/latest/userguide/auth-and-access-control.html)」を参照してください。CodeCommit の IAM 承認に関する完全なリファレンスは、[CodeCommit アクセス許可リファレンス](https://docs.aws.amazon.com/codecommit/latest/userguide/auth-and-access-control-permissions-reference.html)にあります。管理者は、各リポジトリのロールに固有の認証情報を持ち、ユーザーの承認を特定のリポジトリで実行する必要がある特定のタスクセットに限定して、個別のロールに対して個別の IAM ポリシーを定義できます。そのため、アカウント管理者は CodeCommit リポジトリ管理者ごとにプライマリユーザーを生成し、適切な IAM ポリシーまたは CodeCommit アクセス用のポリシーを選択して、必要なリポジトリにアクセスするアクセス許可をこのユーザーに付与します。
## ステップ 1: 個々の Enterprise Developer ユーザーによる設定
1. IAM 認証情報の取得:
1. [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/) で AWS コンソールに接続します。
1. *AWS CodeCommit ユーザーガイド*の「[Git 認証情報を使用する HTTPS ユーザーのセットアップ](https://docs.aws.amazon.com/codecommit/latest/userguide/setting-up-gc.html)」のステップ 3 で説明されている手順に従います。
1. IAM が生成した CodeCommit 固有のサインイン認証情報をコピーするには、この情報を表示して、ローカルコンピュータ上の安全なファイルにコピーアンドペーストするか、**[認証情報のダウンロード]** を選択して .CSV ファイルとしてこの情報をダウンロードします。CodeCommit に接続するには、この情報が必要です。
1. ウェルカム E メールで受信した URL に基づいて WorkSpaces アプリケーションとのセッションを開始します。E メールをユーザー名として使用し、パスワードを作成します。
1. Enterprise Developer スタックを選択します。
1. メニューページで、左側のナビゲーションで **[デスクトップ]** を選択すると、フリートによってストリーミングされている Windows デスクトップに移動します。
## ステップ 2: Windows で Amazon S3 ベースの仮想フォルダを作成する (オプション)
Rclone (上を参照) が必要な場合は、Windows に Amazon S3 ベースの仮想フォルダを作成します (すべてのアプリケーションアーティファクトが CodeCommit アクセスからのみ取得される場合はオプション)。
**注記**
AWS Mainframe Modernization プレビュー中に Rclone を既に使用している場合は、 にある新しいバージョン`m2-rclone.cmd`に更新する必要があります`C:\Users\Public`。
1. `C:\Users\Public` で提供されている `m2-rclone.conf` ファイルと `m2-rclone.cmd` ファイルを、ファイルエクスプローラーを使用してホームフォルダ `C:\Users\PhotonUser\My Files\Home Folder` にコピーします。
1. AWS アクセスキーと対応するシークレット、および `m2-rclone.conf` を使用して、設定パラメータを更新します AWS リージョン。
```
[m2-s3]
type = s3
provider = AWS
access_key_id = YOUR-ACCESS-KEY
secret_access_key = YOUR-SECRET-KEY
region = YOUR-REGION
acl = private
server_side_encryption = AES256
```
1. `m2-rclone.cmd` で、以下の変更を加えます。
+ `amzn-s3-demo-bucket` を Amazon S3 バケットの名前に変更します。例えば、`m2-s3-mybucket`。
+ `your-s3-folder-key` を Amazon S3 バケットキーに変更します。例えば、`myProject`。
+ `your-local-folder-path` を、アプリケーションファイルを含む Amazon S3 バケットから同期するディレクトリのパスに変更します。例えば、`D:\PhotonUser\My Files\Home Folder\m2-new`。WorkSpaces アプリケーションがセッションの開始と終了時に適切にバックアップおよび復元するには、この同期されたディレクトリがホームフォルダのサブディレクトリである必要があります。
```
:loop
timeout /T 10
"C:\Program Files\rclone\rclone.exe" sync m2-s3:amzn-s3-demo-bucket/your-s3-folder-key "D:\PhotonUser\My Files\Home Folder\your-local-folder-path" --config "D:\PhotonUser\My Files\Home Folder\m2-rclone.conf"
goto :loop
```
1. Windows コマンドプロンプトを開き、必要に応じて cd コマンドで `C:\Users\PhotonUser\My Files\Home Folder` に変更し、`m2-rclone.cmd` を実行します。このコマンドスクリプトは連続ループを実行し、Amazon S3 バケットとキーを 10 秒ごとにローカルフォルダに同期します。タイムアウトは、必要に応じて調整できます。Windows ファイルエクスプローラーの Amazon S3 バケットにあるアプリケーションのソースコードが表示されます。
作業中のセットに新しいファイルを追加したり、既存のファイルを更新したりするには、ファイルを Amazon S3 バケットにアップロードします。そうすれば、`m2-rclone.cmd` で定義した次のイテレーションでディレクトリに同期されます。同様に、ファイルを削除する場合は Amazon S3 バケットから削除します。次の同期オペレーションでは、ローカルディレクトリから削除されます。
## ステップ 3: リポジトリのクローンを作成する
1. ブラウザウィンドウの左上隅にあるアプリケーションセレクタメニューに移動し、[Enterprise Developer] を選択します。
1. ワークスペースの場所として `C:\Users\PhotonUser\My Files\Home Folder` (別名`D: \PhotonUser\My Files\Home Folder`) を選択して、Enterprise Developer が必要とするワークスペースの作成をホームフォルダで完了します。
1. Enterprise Developer で、プロジェクトエクスプローラーに移動し、右クリックして **[インポート]**、**[インポート...]**、**[Git]**、**[Git]** **[クローン URI]** からの **[プロジェクト]** を選択して CodeCommit リポジトリのクローンを作成します。次に、CodeCommit 固有のサインイン認証情報を入力し、Eclipse ダイアログに入力してコードをインポートします。
これで、CodeCommit の git リポジトリがローカルワークスペースに複製されました。
これで、Enterprise Developer ワークスペースでアプリケーションのメンテナンス作業を開始する準備ができました。特に、Enterprise Developer と統合された Enterprise Server (ES) のローカルインスタンスを使用して、アプリケーションをインタラクティブにデバッグして実行し、変更をローカルで検証できます。
**注記**
ローカル Enterprise Server インスタンスを含むローカル Enterprise Developer 環境は Windows で実行され、 AWS Mainframe Modernization は Linux で実行されます。新しいアプリケーションを CodeCommit にコミットし、このターゲット用に再構築した後、新しいアプリケーションを本番環境にロールアウトする前に、 AWS Mainframe Modernization が提供する Linux 環境で補完テストを実行することをお勧めします。
## 以降のセッション
CodeCommit リポジトリのクローン作成用のホームフォルダなど、WorkSpaces アプリケーション管理下にあるフォルダを選択すると、セッション間で透過的に保存および復元されます。次回、アプリケーションを操作する必要が生じたときには、次のステップを実行してください。
1. ウェルカム E メールで受信した URL に基づいて WorkSpaces アプリケーションとのセッションを開始します。
1. E メールと永久パスワードを使用してログインします。
1. Enterprise Developer スタックを選択します。
1. このオプションを使用してワークスペースファイルを共有する場合は、`Rclone` を開始して Amazon S3 ベースのディスクに接続します (上を参照)。
1. Enterprise Developer を起動して作業を行います。
## リソースをクリーンアップする
このチュートリアルで作成したリソースが不要になった場合は、追加料金の発生を避けるため、それらを削除してください。以下のステップを実行します。
+ このチュートリアル用に作成した CodeCommit リポジトリを削除します。詳細については、「*AWS CodeCommit ユーザーガイド*」の「[CodeCommit リポジトリを削除する](https://docs.aws.amazon.com/codecommit/latest/userguide/how-to-delete-repository.html)」を参照してください。
+ このチュートリアル用に作成したデータベースを削除します。詳細については、「[DB インスタンスの削除](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_GettingStarted.CreatingConnecting.PostgreSQL.html#CHAP_GettingStarted.Deleting.PostgreSQL)」を参照してください。
# AWS Mainframe Modernization で利用可能なバッチユーティリティ
メインフレームアプリケーションでは、データのソート、FTP によるファイルの転送、DB2 などのデータベースへのデータのロード、データベースからのデータのアンロードなど、特定の機能を実行するためにバッチユーティリティプログラムを使用することがよくあります。
アプリケーションを AWS Mainframe Modernization に移行するときは、メインフレームで使用したものと同じタスクを実行できる機能的に同等の代替ユーティリティが必要です。これらのユーティリティの一部は Mainframe Modernization AWS ランタイムエンジンの一部として既に利用できる場合がありますが、以下の代替ユーティリティを提供しています。
+ M2SFTP - SFTP プロトコルを使用して安全なファイル転送を可能にします。
+ M2WAIT - 指定した時間待機してから、バッチジョブの次のステップに進みます。
+ TXT2PDF - テキストファイルを PDF 形式に変換します。
+ M2DFUTIL - メインフレームの ADRDSSU ユーティリティが提供するサポートと同様の、データセットをバックアップ、復元、削除、コピーする機能を提供します。
+ M2RUNCMD - Rocket Software (旧 Micro Focus) コマンド、スクリプト、システム呼び出しを JCL から直接実行できます。
これらのバッチユーティリティは、お客様からのフィードバックに基づいて開発され、メインフレームユーティリティと同じ機能を提供するように設計されました。目標は、メインフレームから AWS Mainframe Modernization への移行を可能な限りスムーズにすることです。
**Topics**
+ [バイナリロケーション](#location-utilities)
+ [M2SFTP バッチユーティリティ](m2sftp.md)
+ [M2WAIT バッチユーティリティ](m2wait.md)
+ [TXT2PDF Batch ユーティリティ](txt2pdf.md)
+ [M2DFUTIL バッチユーティリティ](m2dfutil.md)
+ [M2RUNCMD バッチユーティリティ](m2runcmd.md)
## バイナリロケーション
これらのユーティリティは、Rocket Enterprise Developer (ED) および Rocket Software (ES) 製品にプリインストールされています。ED および ES のすべてのバリアントについて、次の場所で入手できます。
+ Linux: `/opt/aws/m2/microfocus/utilities/64bit`
+ Windows (32 ビット): `C:\AWS\M2\MicroFocus\Utilities\32bit`
+ Windows (64 ビット): `C:\AWS\M2\MicroFocus\Utilities\64bit`
# M2SFTP バッチユーティリティ
M2SFTP は、Secure File Transfer Protocol (SFTP) を使用してシステム間で安全なファイル転送を実行するように設計された JCL ユーティリティプログラムです。このプログラムは PuTTY SFTP クライアント (`psftp`) を使用して実際のファイル転送を実行します。このプログラムはメインフレームの FTP ユーティリティプログラムと同様に機能し、ユーザー認証とパスワード認証を使用します。
**注記**
パブリックキー認証はサポートされていません。
メインフレームの FTP JCL を SFTP を使用するように変換するには、`PGM=FTP` を `PGM=M2SFTP` に変更してください。
**Topics**
+ [サポートされているプラットフォーム](#m2sftp-platforms)
+ [依存関係をインストールする](#m2sftp-dependencies)
+ [AWS Mainframe Modernization Managed の M2SFTP を設定する](#m2sftp-configure-managed)
+ [Amazon EC22 (WorkSpaces アプリケーションを含む) で Mainframe Modernization ランタイムに M2SFTP を設定する AWS WorkSpaces](#m2sftp-configure-customer-infra)
+ [サンプル JCL](#m2sftp-jcl)
+ [PuTTY SFTP (PSFTP) クライアントコマンドリファレンス](#m2sftp-cmd-ref)
+ [次の手順](#m2sftp-next)
## サポートされているプラットフォーム
M2SFTP は、以下のどのプラットフォームでも使用できます。
+ AWS Mainframe Modernization Rocket Software (旧 Micro Focus) マネージド
+ Rocket Software Runtime (Amazon EC2)
+ Rocket Software Enterprise Developer (ED) および Rocket Software Enterprise Server (ES) 製品のすべてのバリアント。
## 依存関係をインストールする
**PuTTY SFTP クライアントを Windows にインストールするには**
+ [PuTTY SFTP](https://www.putty.org/) クライアントをダウンロードしてインストールします。
**PuTTY SFTP クライアントを Linux にインストールするには**
+ PuTTY SFTP クライアントをインストールするには、以下のコマンドを実行します。
```
sudo yum -y install putty
```
## AWS Mainframe Modernization Managed の M2SFTP を設定する
移行したアプリケーションが AWS Mainframe Modernization Managed で実行されている場合は、次のように M2SFTP を設定する必要があります。
+ MFFTP に適した Rocket Enterprise Server 環境変数を設定します。ここにいくつか例を挙げます。
+ `MFFTP_TEMP_DIR`
+ `MFFTP_SENDEOL`
+ `MFFTP_TIME`
+ `MFFTP_ABEND`
これらの変数は必要な数だけ設定することも、多く設定することもできます。これらの変数は、`ENVAR DD` ステートメントを使用して JCL で設定できます。これらの変数の詳細については、「Micro Focus ドキュメント」の「[MFFTP Control Variables](https://www.microfocus.com/documentation/enterprise-developer/ed80/ED-Eclipse/GUID-3F94BBC8-CB97-4642-A4A7-4235C0C079E2.html)」を参照してください。
設定をテストするには、「[サンプル JCL](#m2sftp-jcl)」を参照してください。
## Amazon EC22 (WorkSpaces アプリケーションを含む) で Mainframe Modernization ランタイムに M2SFTP を設定する AWS WorkSpaces
移行したアプリケーションが Amazon EC2 の AWS Mainframe Modernization ランタイムで実行されている場合は、次のように M2SFTP を設定します。
1. [Micro Focus JES プログラムパス](https://www.microfocus.com/documentation/enterprise-developer/ed80/ED-Eclipse/GUID-BC8A1796-9EDE-48EB-8363-31C9BDE7F96B.html)をバッチユーティリティのバイナリロケーションが含まれるように変更します。複数のパスを指定する必要がある場合、Linux ではコロン (`:`) を使用してパスを区切り、Windows ではセミコロン (`;`) を使用してパスを区切ります。
+ Linux: `/opt/aws/m2/microfocus/utilities/64bit`
+ Windows (32 ビット): `C:\AWS\M2\MicroFocus\Utilities\32bit`
+ Windows (64 ビット): `C:\AWS\M2\MicroFocus\Utilities\64bit`
1. MFFTP に適した Rocket Enterprise Server 環境変数を設定します。ここにいくつか例を挙げます。
+ `MFFTP_TEMP_DIR`
+ `MFFTP_SENDEOL`
+ `MFFTP_TIME`
+ ``MFFTP\$1ABEND
これらの変数は必要な数だけ設定することも、多く設定することもできます。これらの変数は、`ENVAR DD` ステートメントを使用して JCL で設定できます。これらの変数の詳細については、「Micro Focus ドキュメント」の「[MFFTP Control Variables](https://www.microfocus.com/documentation/enterprise-developer/ed80/ED-Eclipse/GUID-3F94BBC8-CB97-4642-A4A7-4235C0C079E2.html)」を参照してください。
設定をテストするには、「[サンプル JCL](#m2sftp-jcl)」を参照してください。
## サンプル JCL
インストールのテストには、以下のサンプル JCL ファイルのいずれかを使用します。
**M2SFTP1.jcl**
この JCL は、M2SFTP を呼び出してリモート SFTP サーバーにファイルを送信する方法を示しています。`ENVVAR DD` ステートメントに設定されている環境変数に注目してください。
```
//M2SFTP1 JOB 'M2SFTP1',CLASS=A,MSGCLASS=X,TIME=1440
//*
//* Copyright Amazon.com, Inc. or its affiliates.*
//* All Rights Reserved.*
//*
//*-------------------------------------------------------------------**
//* Sample SFTP JCL step to send a file to SFTP server*
//*-------------------------------------------------------------------**
//*
//STEP01 EXEC PGM=M2SFTP,
// PARM='127.0.0.1 (EXIT=99 TIMEOUT 300'
//*
//SYSFTPD DD *
RECFM FB
LRECL 80
SBSENDEOL CRLF
MBSENDEOL CRLF
TRAILINGBLANKS FALSE
/*
//NETRC DD *
machine 127.0.0.1 login sftpuser password sftppass
/*
//SYSPRINT DD SYSOUT=*
//OUTPUT DD SYSOUT=*
//STDOUT DD SYSOUT=*
//INPUT DD *
type a
locsite notrailingblanks
cd files
put 'AWS.M2.TXT2PDF1.PDF' AWS.M2.TXT2PDF1.pdf
put 'AWS.M2.CARDDEMO.CARDDATA.PS' AWS.M2.CARDDEMO.CARDDATA.PS1.txt
quit
/*
//ENVVAR DD *
MFFTP_VERBOSE_OUTPUT=ON
MFFTP_KEEP=N
/*
//*
//
```
**M2SFTP2.jcl**
この JCL は、M2SFTP を呼び出してリモート SFTP サーバーからファイルを受信する方法を示しています。`ENVVAR DD` ステートメントに設定されている環境変数に注目してください。
```
//M2SFTP2 JOB 'M2SFTP2',CLASS=A,MSGCLASS=X,TIME=1440
//*
//* Copyright Amazon.com, Inc. or its affiliates.*
//* All Rights Reserved.*
//*
//*-------------------------------------------------------------------**
//* Sample SFTP JCL step to receive a file from SFTP server*
//*-------------------------------------------------------------------**
//*
//STEP01 EXEC PGM=M2SFTP
//*
//SYSPRINT DD SYSOUT=*
//OUTPUT DD SYSOUT=*
//STDOUT DD SYSOUT=*
//INPUT DD *
open 127.0.0.1
sftpuser
sftppass
cd files
locsite recfm=fb lrecl=150
get AWS.M2.CARDDEMO.CARDDATA.PS.txt +
'AWS.M2.CARDDEMO.CARDDATA.PS2' (replace
quit
/*
//ENVVAR DD *
MFFTP_VERBOSE_OUTPUT=ON
MFFTP_KEEP=N
/*
//*
//
```
**注記**
FTP 認証情報を NETRC ファイルに保存し、アクセスを許可されたユーザーのみに制限することを強くお勧めします。
## PuTTY SFTP (PSFTP) クライアントコマンドリファレンス
PSFTP クライアントはすべての FTP コマンドをサポートしているわけではありません。次のリストは、PSFTP がサポートするすべてのコマンドを示しています。
| コマンド | 説明 |
| --- | --- |
| \$1 | ローカルコマンドを実行します |
| bye | SFTP セッションを終了します |
| cd | リモート作業ディレクトリを変更します |
| chmod | ファイル権限とモードを変更します |
| close | SFTP セッションを終了しますが、PSFTP は終了しません |
| del | リモートサーバーのファイルを削除します |
| dir | リモートファイルを一覧表示します |
| exit | SFTP セッションを終了します |
| get | サーバーのファイルをローカルマシンにダウンロードします |
| help | ヘルプを表示します |
| lcd | ローカル作業ディレクトリを変更します |
| lpwd | ローカル作業ディレクトリを表示します |
| ls | リモートファイルを一覧表示します |
| mget | 複数のファイルを一度にダウンロードします |
| mkdir | リモートサーバーにディレクトリを作成します |
| mput | 複数のファイルを一度にアップロードします |
| mv | リモートサーバーのファイルを移動または名前変更します |
| 開放 | ホストに接続します |
| put | ローカルマシンのファイルをサーバーにアップロードします |
| pwd | リモート作業ディレクトリを表示します |
| quit | SFTP セッションを終了します |
| reget | ファイルのダウンロードを続けます |
| ren | リモートサーバーのファイルを移動または名前変更します |
| reput | ファイルのアップロードを続けます |
| rm | リモートサーバーのファイルを削除します |
| rmdir | リモートサーバーのディレクトリを削除します |
## 次の手順
SFTP を使用して Amazon Simple Storage Service にファイルをアップロードおよびダウンロードするには、次のブログ投稿で説明されているように AWS Transfer Family、M2SFTP を と組み合わせて使用できます。
+ [AWS SFTP 論理ディレクトリを使用してシンプルなデータ分散サービスを構築する](https://aws.amazon.com/blogs/storage/using-aws-sftp-logical-directories-to-build-a-simple-data-distribution-service/)
+ [AWS Transfer for SFTP を使用するためのパスワード認証を有効にする AWS Secrets Manager](https://aws.amazon.com/blogs/storage/enable-password-authentication-for-aws-transfer-for-sftp-using-aws-secrets-manager/)
# M2WAIT バッチユーティリティ
M2WAIT は、秒単位、分単位、または時間単位で時間を指定して JCL スクリプトに待機時間を導入できるメインフレームユーティリティプログラムです。待機する時間を入力パラメータとして渡すことにより、JCL から直接 M2WAIT を呼び出せます。M2WAIT プログラムでは内部的に、Rocket Software (旧 Micro Focus) が提供するモジュールを呼び出し`C$SLEEP`て、指定された時間待機します。
**注記**
Micro Focus エイリアスを使用して JCL スクリプトにあるものを置き換えられます。詳細については、「Micro Focus ドキュメント」の「[JES Alias](https://www.microfocus.com/documentation/enterprise-developer/ed80/ED-Eclipse/GUID-D4206FF9-32C4-43E7-9413-5E7E96AA8092.html)」を参照してください。
**Topics**
+ [サポートされているプラットフォーム](#m2wait-platforms)
+ [AWS Mainframe Modernization Managed の M2WAIT を設定する](#m2wait-configure-managed)
+ [Amazon EC22 (WorkSpaces アプリケーションを含む) で Mainframe Modernization ランタイムに M2WAIT を設定する AWS WorkSpaces](#m2wait-configure-customer-infra)
+ [サンプル JCL](#m2wait-jcl)
## サポートされているプラットフォーム
M2WAIT は以下のどのプラットフォームでも使用できます。
+ AWS Mainframe Modernization Rocket Software (旧 Micro Focus) マネージド
+ Rocket Software Runtime (Amazon EC2)
+ Rocket Software Enterprise Developer (ED) および Rocket Software Enterprise Server (ES) 製品のすべてのバリアント。
## AWS Mainframe Modernization Managed の M2WAIT を設定する
移行したアプリケーションが AWS Mainframe Modernization Managed で実行されている場合は、次のように M2WAIT を設定する必要があります。
+ 「[サンプル JCL](#m2wait-jcl)」に示すように、入力パラメータを渡して JCL で M2WAIT プログラムを使用します。
## Amazon EC22 (WorkSpaces アプリケーションを含む) で Mainframe Modernization ランタイムに M2WAIT を設定する AWS WorkSpaces
移行したアプリケーションが Amazon EC2 の AWS Mainframe Modernization ランタイムで実行されている場合は、次のように M2WAIT を設定します。
1. [Micro Focus JES プログラムパス](https://www.microfocus.com/documentation/enterprise-developer/ed80/ED-Eclipse/GUID-BC8A1796-9EDE-48EB-8363-31C9BDE7F96B.html)をバッチユーティリティのバイナリロケーションが含まれるように変更します。複数のパスを指定する必要がある場合、Linux ではコロン (`:`) を使用してパスを区切り、Windows ではセミコロン (`;`) を使用してパスを区切ります。
+ Linux: `/opt/aws/m2/microfocus/utilities/64bit`
+ Windows (32 ビット): `C:\AWS\M2\MicroFocus\Utilities\32bit`
+ Windows (64 ビット): `C:\AWS\M2\MicroFocus\Utilities\64bit`
1. 「[サンプル JCL](#m2wait-jcl)」に示すように、入力パラメータを渡して JCL で M2WAIT プログラムを使用します。
## サンプル JCL
インストールをテストするには、`M2WAIT1.jcl` プログラムを使用できます。
このサンプル JCL は、M2WAIT を呼び出して複数の異なる期間を渡す方法を示しています。
```
//M2WAIT1 JOB 'M2WAIT',CLASS=A,MSGCLASS=X,TIME=1440
//*
//* Copyright Amazon.com, Inc. or its affiliates.*
//* All Rights Reserved.*
//*
//*-------------------------------------------------------------------**
//* Wait for 12 Seconds*
//*-------------------------------------------------------------------**
//*
//STEP01 EXEC PGM=M2WAIT,PARM='S012'
//SYSOUT DD SYSOUT=*
//*
//*-------------------------------------------------------------------**
//* Wait for 0 Seconds (defaulted to 10 Seconds)*
//*-------------------------------------------------------------------**
//*
//STEP02 EXEC PGM=M2WAIT,PARM='S000'
//SYSOUT DD SYSOUT=*
//*
//*-------------------------------------------------------------------**
//* Wait for 1 Minute*
//*-------------------------------------------------------------------**
//*
//STEP03 EXEC PGM=M2WAIT,PARM='M001'
//SYSOUT DD SYSOUT=*
//*
//
```
# TXT2PDF Batch ユーティリティ
TXT2PDF とは、テキストファイルを PDF ファイルに変換するために一般的に使用されるメインフレームユーティリティプログラムです。このユーティリティは、TXT2PDF (z/OS フリーウェア) に同じソースコードを使用します。 AWS Mainframe Modernization Rocket Software (旧 Micro Focus) ランタイム環境で実行するように変更しました。
**Topics**
+ [サポートされているプラットフォーム](#txt2pdf-platforms)
+ [AWS Mainframe Modernization Managed の TXT2PDF を設定する](#txt2pdf-configure-managed)
+ [Amazon EC22 (WorkSpaces アプリケーションを含む) で Mainframe Modernization ランタイムに TXT2PDF を設定する AWS WorkSpaces](#txt2pdf-configure-customer-infra)
+ [サンプル JCL](#txt2pdf-jcl)
+ [変更](#txt2pdf-mods)
+ [リファレンス](#txt2pdf-ref)
## サポートされているプラットフォーム
以下のどのプラットフォームでも TXT2PDF を使用できます。
+ AWS Mainframe Modernization Rocket ソフトウェアマネージド
+ Rocket Software Runtime (Amazon EC2)
+ Rocket Enterprise Developer (ED) および Rocket Enterprise Server (ES) 製品のすべてのバリアント。
## AWS Mainframe Modernization Managed の TXT2PDF を設定する
移行したアプリケーションが AWS Mainframe Modernization Managed で実行されている場合は、次のように TXT2PDF を設定します。
+ `AWS.M2.REXX.EXEC` という名前の REXX EXEC ライブラリを作成します。これらの [REXX モジュール](https://drm0z31ua8gi7.cloudfront.net/utilities/mf/TXT2PDF/rexx/TXT2PDF_rexx.zip)をダウンロードし、ライブラリにコピーします。
+ `TXT2PDF.rex` - TXT2PDF z/OSフリーウェア (変更)
+ `TXT2PDFD.rex` - TXT2PDF z/OSフリーウェア (変更なし)
+ `TXT2PDFX.rex` - TXT2PDF z/OSフリーウェア (変更)
+ `M2GETOS.rex` - OS の種類の確認や (Windows または Linux)
設定をテストするには、「[サンプル JCL](#txt2pdf-jcl)」を参照してください。
## Amazon EC22 (WorkSpaces アプリケーションを含む) で Mainframe Modernization ランタイムに TXT2PDF を設定する AWS WorkSpaces
移行したアプリケーションが Amazon EC2 の AWS Mainframe Modernization ランタイムで実行されている場合は、次のように TXT2PDF を設定します。
1. Rocket Software 環境変数`MFREXX_CHARSET`を、ASCII データの`A`「」などの適切な値に設定します。
**重要**
正しくない値を入力すると、データ変換 (EBCDIC から ASCII) の問題が発生し、生成される PDF が読めなくなる可能性や、操作できなくなる可能性があります。`MFREXX_CHARSET` と `MF_CHARSET` が一致するように設定することをお勧めします。
1. [Micro Focus JES プログラムパス](https://www.microfocus.com/documentation/enterprise-developer/ed80/ED-Eclipse/GUID-BC8A1796-9EDE-48EB-8363-31C9BDE7F96B.html)をバッチユーティリティのバイナリロケーションが含まれるように変更します。複数のパスを指定する必要がある場合、Linux ではコロン (`:`) を使用してパスを区切り、Windows ではセミコロン (`;`) を使用してパスを区切ります。
+ Linux: `/opt/aws/m2/microfocus/utilities/64bit`
+ Windows (32 ビット): `C:\AWS\M2\MicroFocus\Utilities\32bit`
+ Windows (64 ビット): `C:\AWS\M2\MicroFocus\Utilities\64bit`
1. `AWS.M2.REXX.EXEC`` という名前の REXX EXEC ライブラリを作成します。これらの [REXX モジュール](https://drm0z31ua8gi7.cloudfront.net/utilities/mf/TXT2PDF/rexx/TXT2PDF_rexx.zip)をダウンロードし、ライブラリにコピーします。
+ `TXT2PDF.rex` - TXT2PDF z/OSフリーウェア (変更)
+ `TXT2PDFD.rex` - TXT2PDF z/OSフリーウェア (変更なし)
+ `TXT2PDFX.rex` - TXT2PDF z/OSフリーウェア (変更)
+ `M2GETOS.rex` - OS の種類の確認や (Windows または Linux)
設定をテストするには、「[サンプル JCL](#txt2pdf-jcl)」を参照してください。
## サンプル JCL
インストールのテストには、以下のサンプル JCL ファイルのいずれかを使用します。
**TXT2PDF1.jcl**
このサンプル JCL ファイルでは、TXT2PDF の変換に DD 名を使用しています。
```
//TXT2PDF1 JOB 'TXT2PDF1',CLASS=A,MSGCLASS=X,TIME=1440
//*
//* Copyright Amazon.com, Inc. or its affiliates.*
//* All Rights Reserved.*
//*
//*-------------------------------------------------------------------**
//* PRE DELETE*
//*-------------------------------------------------------------------**
//*
//PREDEL EXEC PGM=IEFBR14
//*
//DD01 DD DSN=AWS.M2.TXT2PDF1.PDF.VB,
// DISP=(MOD,DELETE,DELETE)
//*
//DD02 DD DSN=AWS.M2.TXT2PDF1.PDF,
// DISP=(MOD,DELETE,DELETE)
//*
//*-------------------------------------------------------------------**
//* CALL TXT2PDF TO CONVERT FROM TEXT TO PDF (VB)*
//*-------------------------------------------------------------------**
//*
//STEP01 EXEC PGM=IKJEFT1B
//*
//SYSEXEC DD DISP=SHR,DSN=AWS.M2.REXX.EXEC
//*
//INDD DD *
1THIS IS THE FIRST LINE ON THE PAGE 1
0THIS IS THE THIRD LINE ON THE PAGE 1
-THIS IS THE 6TH LINE ON THE PAGE 1
THIS IS THE 7TH LINE ON THE PAGE 1
+____________________________________ - OVERSTRIKE 7TH LINE
1THIS IS THE FIRST LINE ON THE PAGE 2
0THIS IS THE THIRD LINE ON THE PAGE 2
-THIS IS THE 6TH LINE ON THE PAGE 2
THIS IS THE 7TH LINE ON THE PAGE 2
+____________________________________ - OVERSTRIKE 7TH LINE
/*
//*
//OUTDD DD DSN=AWS.M2.TXT2PDF1.PDF.VB,
// DISP=(NEW,CATLG,DELETE),
// DCB=(LRECL=256,DSORG=PS,RECFM=VB,BLKSIZE=0)
//*
//SYSTSPRT DD SYSOUT=*
//SYSTSIN DD DDNAME=SYSIN
//*
//SYSIN DD *
%TXT2PDF BROWSE Y IN DD:INDD +
OUT DD:OUTDD +
CC YES
/*
//*
//*-------------------------------------------------------------------**
//* CONVERT PDF (VB) TO PDF (LSEQ - BYTE STREAM)*
//*-------------------------------------------------------------------**
//*
//STEP02 EXEC PGM=VB2LSEQ
//*
//INFILE DD DSN=AWS.M2.TXT2PDF1.PDF.VB,DISP=SHR
//*
//OUTFILE DD DSN=AWS.M2.TXT2PDF1.PDF,
// DISP=(NEW,CATLG,DELETE),
// DCB=(LRECL=256,DSORG=PS,RECFM=LSEQ,BLKSIZE=0)
//*
//SYSOUT DD SYSOUT=*
//*
//
```
**TXT2PDF2.jcl**
このサンプル JCL では、TXT2PDF の変換に DSN 名を使用しています。
```
//TXT2PDF2 JOB 'TXT2PDF2',CLASS=A,MSGCLASS=X,TIME=1440
//*
//* Copyright Amazon.com, Inc. or its affiliates.*
//* All Rights Reserved.*
//*
//*-------------------------------------------------------------------**
//* PRE DELETE*
//*-------------------------------------------------------------------**
//*
//PREDEL EXEC PGM=IEFBR14
//*
//DD01 DD DSN=AWS.M2.TXT2PDF2.PDF.VB,
// DISP=(MOD,DELETE,DELETE)
//*
//DD02 DD DSN=AWS.M2.TXT2PDF2.PDF,
// DISP=(MOD,DELETE,DELETE)
//*
//*-------------------------------------------------------------------**
//* CALL TXT2PDF TO CONVERT FROM TEXT TO PDF (VB)*
//*-------------------------------------------------------------------**
//*
//STEP01 EXEC PGM=IKJEFT1B
//*
//SYSEXEC DD DISP=SHR,DSN=AWS.M2.REXX.EXEC
//*
//INDD DD *
1THIS IS THE FIRST LINE ON THE PAGE 1
0THIS IS THE THIRD LINE ON THE PAGE 1
-THIS IS THE 6TH LINE ON THE PAGE 1
THIS IS THE 7TH LINE ON THE PAGE 1
+____________________________________ - OVERSTRIKE 7TH LINE
1THIS IS THE FIRST LINE ON THE PAGE 2
0THIS IS THE THIRD LINE ON THE PAGE 2
-THIS IS THE 6TH LINE ON THE PAGE 2
THIS IS THE 7TH LINE ON THE PAGE 2
+____________________________________ - OVERSTRIKE 7TH LINE
/*
//*
//SYSTSPRT DD SYSOUT=*
//SYSTSIN DD DDNAME=SYSIN
//*
//SYSIN DD *
%TXT2PDF BROWSE Y IN DD:INDD +
OUT 'AWS.M2.TXT2PDF2.PDF.VB' +
CC YES
/*
//*
//*-------------------------------------------------------------------**
//* CONVERT PDF (VB) TO PDF (LSEQ - BYTE STREAM)*
//*-------------------------------------------------------------------**
//*
//STEP02 EXEC PGM=VB2LSEQ
//*
//INFILE DD DSN=AWS.M2.TXT2PDF2.PDF.VB,DISP=SHR
//*
//OUTFILE DD DSN=AWS.M2.TXT2PDF2.PDF,
// DISP=(NEW,CATLG,DELETE),
// DCB=(LRECL=256,DSORG=PS,RECFM=LSEQ,BLKSIZE=0)
//*
//SYSOUT DD SYSOUT=*
//*
//
```
## 変更
TXT2PDF プログラムを AWS Mainframe Modernization Rocket Software ランタイム環境で実行するために、次の変更を行いました。
+ Rocket Software REXX ランタイムとの互換性を確保するためのソースコードの変更
+ Windows と Linux 両方のオペレーティングシステムでプログラムを実行できるようにするための変更
+ EBCDIC と ASCII ランタイム両方をサポートするための変更
## リファレンス
TXT2PDF リファレンスとソースコード:
+ [テキストから PDF へのコンバータ](https://homerow.net/rexx/txt2pdf/)
+ [z/OS Freeware TCP/IP およびメールツール](http://www.lbdsoftware.com/tcpip.html)
+ [TXT2PDF ユーザーリファレンスガイド](http://www.lbdsoftware.com/TXT2PDF-User-Guide.pdf)
# M2DFUTIL バッチユーティリティ
M2DFUTIL は、メインフレーム ADRDSSU ユーティリティが提供するサポートと同様に、データセットのバックアップ、復元、削除、コピー機能を提供する JCL ユーティリティプログラムです。このプログラムは ADRDSSU の SYSIN パラメータの多くを保持するため、この新しいユーティリティへの移行プロセスが効率化されます。
**Topics**
+ [サポートされているプラットフォーム](#m2dfutil-platforms)
+ [プラットフォームの要件](#m2dfutil-platform)
+ [今後のサポートの予定](#m2udfutil-future-support)
+ [アセットの場所](#mdfutil-assets)
+ [Amazon EC22 で M2DFUTIL または AWS Mainframe Modernization ランタイムを設定する (AppStream 2.0 を含む)](#mdfutil-dependencies)
+ [一般的な構文](#mdfutil-syntax)
+ [サンプル JCL](#mdfutil-sample-jcls)
## サポートされているプラットフォーム
M2DFUTIL は、以下のどのプラットフォームでも使用できます。
+ Windows 上の Rocket Software (旧 Micro Focus) ES (64 ビットと 32 ビット)
+ Linux での Rocket Software ES (64 ビット)
## プラットフォームの要件
M2DFUTIL は、正規表現テストを実行するスクリプトの呼び出しに依存します。Windows では、このスクリプトを実行するには Windows Services for Linux (WSL) をインストールする必要があります。
## 今後のサポートの予定
以下を含む機能は、現在メインフレームの ADRDSSU ユーティリティでは使用できませんが、今後サポートを予定しています。
+ M2 Managed
+ VSAM
+ ファイルの名前変更での COPY のサポート
+ RESTORE での RENAME のサポート
+ 複数の INCLUDE と EXCLUDE
+ DSORG、CREDT、EXPDT による副選択のための BY 句
+ エンキュー失敗を再試行するための MWAIT 句
+ DUMP/RESTORE での S3 ストレージのサポート
## アセットの場所
このユーティリティのロードモジュールは、Linux では `M2DFUTIL.dll`、Windows では `M2DFUTIL.so` と呼ばれます。このロードモジュールは、次のいずれかの場所にあります。
+ Linux: `/opt/aws/m2/microfocus/utilities/64bit`
+ Windows (32 ビット): `C:\AWS\M2\MicroFocus\Utilities\32bit`
+ Windows (64 ビット): `C:\AWS\M2\MicroFocus\Utilities\64bit`
正規表現のテストに使用されるスクリプトは `compare.sh` と呼ばれます。このスクリプトは、次のいずれかの場所にあります。
+ Linux: `/opt/aws/m2/microfocus/utilities/scripts`
+ Windows (32 ビット): `C:\AWS\M2\MicroFocus\Utilities\scripts`
## Amazon EC22 で M2DFUTIL または AWS Mainframe Modernization ランタイムを設定する (AppStream 2.0 を含む)
Enterprise Server のリージョンを次のように設定します。
+ **[ES 環境]** に以下の変数を追加します。
+ `M2DFUTILS_BASE_LOC` - DUMP 出力のデフォルト場所
+ `M2DFUTILS_SCRIPTPATH` - 「**アセットの場所**」に記載されている `compare.sh` スクリプトの場所
+ `M2DFUTILS_VERBOSE` - [冗長または標準]。これは `SYSPRINT ` 出力の詳細レベルを制御します。
+ ロードモジュールパスが `JES\Configuration\JES Program Path` 設定に追加されていることを確認します。
+ ユーティリティディレクトリ内のスクリプトに実行権限があることを確認します。Linux 環境では、`chmod + x