

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)」を参照してください。

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# AWS NTT データを使用した Mainframe Modernization の再プラットフォーム
<a name="unikix"></a>

AWS Mainframe Modernization には、さまざまな Amazon マシンイメージ (AMIs。これらの AMIs Amazon EC2 インスタンスの迅速なプロビジョニングを容易にし、NTT データ AWS を使用して でメインフレームアプリケーションをリホストおよびリプラットフォームするためのカスタマイズされた環境を作成します。このガイドでは、これらの AMI にアクセスして使用するために必要な手順について説明します。

## 前提条件
<a name="prereqs-unikix"></a>
+ Amazon EC2 インスタンスを作成できる AWS アカウントへの管理者アクセス権があることを確認します。
+ Amazon EC2 インスタンスを作成する予定のリージョンで AWS Mainframe Modernization サービスが使用可能であることを確認します。「[リージョン別に利用可能な AWS サービスのリスト](https://aws.amazon.com/about-aws/global-infrastructure/regional-product-services/)」を参照してください。
+ Amazon EC2 インスタンスを作成する Amazon VPC を特定します。

## Amazon マシンイメージのサブスクライブ
<a name="subscribe-to-images-unikix"></a>

AWS Marketplace 製品をサブスクライブすると、その製品の AMI からインスタンスを起動できるようになります。

1. にサインイン AWS マネジメントコンソール し、[https://console.aws.amazon.com/marketplace](https://console.aws.amazon.com/marketplace) で AWS Marketplace コンソールを開きます。

1. **[サブスクリプションを管理する]** を選択します。

1. 次のリンクをコピーしてブラウザのアドレスバーに貼り付けます。[https://aws.amazon.com/marketplace/pp/prodview-eg227ymldsnx2](https://aws.amazon.com/marketplace/pp/prodview-eg227ymldsnx2)

1. **[サブスクリプションを続行する]** を選択します。

1. 利用規約に同意できる場合は、**[規約の受諾]** を選択します。このサブスクリプションの処理には数分かかる場合があります。

1. お礼のメッセージが表示されるまで待ちます。このメッセージは、製品へのサブスクリプションが完了したことを確認するものです。

1. 左のナビゲーションペインで、**[サブスクリプションの管理]** をクリックします。このビューには、すべてのサブスクリプションが表示されます。

## NTT DATA インスタンスを使用して AWS Mainframe Modernization リプラットフォームを起動する
<a name="launch-data-replatform-unikix"></a>

1. [https://console.aws.amazon.com/marketplace](https://console.aws.amazon.com/marketplace) で AWS Marketplace コンソールを開きます。

1. 左のナビゲーションペインで、**[サブスクリプションの管理]** をクリックします。

1. 起動する AMI を見つけて、**[新規インスタンスを起動]** をクリックします。

1. **[リージョン]** で、許可リストに登録されているリージョンを選択します。

1. **[EC2 経由で起動を続行する]** を選択します。これにより、Amazon EC2 コンソールに移動します。

1. サーバーの名前を入力します。

1. プロジェクトのパフォーマンスとコスト要件に合ったインスタンスタイプを選択します。インスタンスサイズの推奨開始点は `c5.2xLarge` です。

1. 既存のキーペアを選択するか、新しいキーペアを作成して保存します。キーペアの詳細については、「Amazon EC2 ユーザーガイド」の「[Amazon EC2 のキーペアと Linux インスタンス](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-key-pairs.html)」を参照してください。

1. ネットワーク設定を編集し、許可リストに登録された VPC と適切なサブネットを選択します。

1. 既存のセキュリティグループを選択するか、新しいセキュリティグループを作成します。これが Enterprise Server Amazon EC2 インスタンスの場合、ポート 86 および 10086 への TCP トラフィックを許可して、Rocket Software (旧 Micro Focus) 設定を管理するのが一般的です。

1. Amazon EC2 インスタンスのストレージを設定します。

1. 概要を確認し、**[インスタンスを起動]** をクリックします。起動を成功させるには、インスタンスタイプが有効である必要があります。起動に失敗した場合は、**[インスタンス設定を編集]** をクリックし、別のインスタンスタイプを選択します。

1. 成功メッセージが表示されたら、**[インスタンスに接続]** をクリックします。

1. Amazon EC2 コンソールの [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/) を開いてください。

1. 左側のナビゲーションペインの **[インスタンス]** メニューで、**[インスタンス]** をクリックします。

1. メインペインで、インスタンスのステータスをチェックします。

## NTT Data の使用開始
<a name="unikix-getting-started"></a>

Amazon EC2 インスタンスをプロビジョニングしたら、ユーザー名 `ec2-user` を使用してそのインスタンスに SSH 接続します。画面は次の画像のようになります。

![\[提供された Amazon EC2 インスタンスとユーザー名を含む SSH 画面です。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/unikix-start-screen.png)


以下の画像に示すように、この `/opt/software/` フォルダの下には `UniKix_Product_Guides` という名前のフォルダがあります。

![\[/opt/software/ フォルダの詳細を含む SSH 画面です。フォルダ「UniKix_Product_Guides」を見つけます。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/unikix-product-guides.png)


`UniKix_Product_Guides` フォルダには、この Amazon EC2 インスタンスにインストールされている以下のコンポーネントのドキュメントが含まれています。
+ NTT DATA TPE
+ NTT DATA BPE
+ NTT DATA Enterprise COBOL
+ NTT DATA UniKix Secure
+ NTT DATA UniKix Central Manager

前の画像に表示されている `software` フォルダーには、上記のコンポーネントのバイナリが格納されています。

Amazon EC2 インスタンスを正常に検証したら、NTT データドキュメントに従って、NTT DATA で AWS Mainframe Modernization Replatform の使用を開始します。

# チュートリアル: CardDemo アプリケーションを NTT DATA にデプロイする
<a name="tutorial-unikix-runtime"></a>

このページでは、NTT DATA Unikix ランタイムを使用した AWS Mainframe Modernization リプラットフォームに CardDemo サンプルアプリケーションをデプロイするstep-by-stepのプロセスについて説明します。

CardDemo サンプルアプリケーションは、メインフレーム移行とモダナイゼーションのユースケース向けに AWS とパートナーテクノロジーをテストおよび紹介するために設計および開発された、簡素化されたメインフレームアプリケーションです。

このアプリケーションの詳細については、「[CardDemo の GitHub リポジトリ](https://github.com/aws-samples/aws-mainframe-modernization-carddemo)」を参照してください。

**Topics**
+ [デプロイフロー図](#tutorial-unikix-workflow)
+ [前提条件](#tutorial-unikix-prerequisites)
+ [ステップ 1: 環境を準備する](#tutorial-unikix-prepare)
+ [ステップ 2: TPE リージョンを作成する](#tutorial-unikix-tpe)
+ [ステップ 3: BPE ノードとサブシステムを作成する](#tutorial-unikix-bpe)
+ [ステップ 4: CardDemo アプリケーションをコンパイルしてデプロイする](#tutorial-unikix-compile)
+ [ステップ 5: BPE と TPE カタログをインポートする](#tutorial-unikix-import)
+ [ステップ 6: TPE を起動して BPE に接続する](#unikix-tutorial-connect)
+ [ステップ 7: CardDemo アプリケーションを実行する](#unikix-tutorial-run-application)
+ [トラブルシューティング](#tutorial-unikix-troubleshoot)

## デプロイフロー図
<a name="tutorial-unikix-workflow"></a>

次の図は、NTT DATA Unikix ランタイムにアプリケーションをデプロイするためのワークフローの各ステップを示しています。

![\[NTT DATA Unikix ランタイムにアプリケーションをデプロイする全体的なワークフローです。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/unikix-process.png)


## 前提条件
<a name="tutorial-unikix-prerequisites"></a>
+ [NTT DATA UniKix Marketplace AMI](https://aws.amazon.com/marketplace/pp/prodview-eg227ymldsnx2) を使用して、[AWS NTT データを使用した Mainframe Modernization の再プラットフォーム](unikix.md) に記載されている手順に従ってください。
+ 「*Amazon EC2 ユーザーガイド*」の「[IMDSv1 の使用を復旧する](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/configuring-IMDS-existing-instances.html)」に記載されているように、インスタンスのメタデータオプション **IMDSv2** を **[任意]** に変更します。
+ NTT DATA UniKix の CardDemo ランタイムコンポーネントを次の場所からダウンロード: 

  [GitHub リポジトリ](https://github.com/aws-samples/aws-mainframe-modernization-carddemo/blob/main/samples/m2/unikix/UniKix_CardDemo_runtime_v1.zip)
+ UniKix ランタイム EC2 インスタンスに `ec2-user` としてログインします。
+ ダウンロードした CardDemo ランタイムコンポーネントを、次のリンクを使用して抽出します: [UniKix \$1CardDemo \$1runtime\$1v1.zip](https://github.com/aws-samples/aws-mainframe-modernization-carddemo/blob/main/samples/m2/unikix/UniKix_CardDemo_runtime_v1.zip)
  + 抽出されたディレクトリには、「`bin`」および「`migrated_app`」ディレクトリが含まれている必要があります。
  + 「`$HOME`」ディレクトリの下に「`bin`」と「`migrated_app`」ディレクトリの両方を移動します。パスは「`/home/ec2-user`」のようになります。
  + 次の `$HOME` のディレクトリ内には次の項目が格納されているはずです。
    + `/home/ec2-user/bin`
    + `/home/ec2-user/migrated_app`
  + 次のコマンドを使用して、\$1HOME/bin ディレクトリ内のすべてのファイルを移動します。
  + 
    + `chmod +x $HOME/bin/*`

## ステップ 1: 環境を準備する
<a name="tutorial-unikix-prepare"></a>

前提条件を完了した後の最初のステップは、CardDemo アプリケーションをデプロイする環境を準備することです。

1. UniKix ランタイム EC2 インスタンスに「`ec2-user`」としてログインします。

1. EC2 インスタンスで次のコマンドを使用し、TPE、BPE、COBOL など、AMI 内で事前にパッケージ化された UniKix ソフトウェアの一覧と、NTT DATA UniKix 製品ロケーションの他のソフトウェアの一覧を確認します。

   ```
   ls -l /opt/software/
   ```

1. 移行された CardDemo アプリケーションを確認します。BMS マップ、COBOL プログラム、COBOL コピーブック、JCLs など、すべてのソースコードが表示されます。また、BPE および TPE カタログ、CICS リソース定義、シーケンシャルファイルや VSAM ファイルなどの移行されたデータのエクスポートも、次の方法で確認できます。

   ```
   ls  $HOME/migrated_app/*/*
   ```

1. 次のコマンドを使用して `create_project` スクリプトを実行して、フォルダ構造を作成します。

   ```
   sh $HOME/bin/create_project
   ```

1. CardDemo 環境をアクティブ化するには、以下を使用して `carddemo.env` セットアップファイルを取得します。

   ```
   source $HOME/bin/carddemo.env
   ```

## ステップ 2: TPE リージョンを作成する
<a name="tutorial-unikix-tpe"></a>

アプリケーションをデプロイする環境をアクティブ化したら、TPE リージョンを作成する必要があります。

1. `$KIXSYS`、`$JAVA_HOME`、`$KIXLICDIR` などの入力を必要とする `kixregion createRegion` コマンドを使用して TPE リージョンを作成します。これらの環境変数は、`carddemo.env` セットアップファイルに既に設定されています。

   ```
   kixregion createRegion $KIXSYS $JAVA_HOME $KIXLICDIR
   ```

1. `kixregion setAttr` コマンドを使用して TPE リージョンを設定します。

   ```
   kixregion setAttr $KIXSYS server.tx.languages.cobol.enabled true
   kixregion setAttr $KIXSYS server.tx.languages.cobol.flavor vcobol
   kixregion setAttr $KIXSYS server.tx.languages.cobol.home $VCOBOL
   kixregion setAttr $KIXSYS maps.location $PROJECT_ROOT/maps
   kixregion setAttr $KIXSYS programs.location $PROJECT_ROOT/loadlib
   kixregion setAttr $KIXSYS environment.KIXDATA $KIXDATA
   kixregion setAttr $KIXSYS td.jobq.submission.node $EBMHOME
   kixregion setAttr $KIXSYS td.jobq.submission.subsys $EBMSYS
   ```

1. `kixregion createScript` コマンドを実行して、この TPE リージョンに固有のユーザー環境ファイルを生成します。このコマンドは、TPE リージョン設定に基づいて `$KIXSYS/bin/userenv` を作成または更新します。

   ```
   kixregion createScript $KIXSYS
   ```

1. ユーザー環境ファイル (`$KIXSYS/bin/userenv`) を調達して TPE リージョンを有効にします。

   ```
   source $KIXSYS/bin/userenv
   ```

1. `kixinstall2` コマンドを実行して TPE リージョンをビルドします。

   ```
   kixinstall2
   ```

## ステップ 3: BPE ノードとサブシステムを作成する
<a name="tutorial-unikix-bpe"></a>

TPE リージョンを作成したら、次のステップに従って BPE ノードとサブシステムを作成する必要があります。

1. `INSTEBM` の所有権とアクセス許可を変更します。

   ```
   sudo chown root $INSTEBM 
   sudo chmod 4755 $INSTEBM
   ```

1. `INSTEBM` コマンドを使用して BPE ノードを作成します。BPE ノードディレクトリは入力パラメータとして提供されます。

   ```
   $INSTEBM $EBMHOME
   ```

1. 新しく作成された BPE ノードから `batchenv` ファイルを取得して、バッチ環境を有効にします。

   ```
   source $EBMHOME/batchenv
   ```

1. Batch Administration Manager (bam) を使用して、このノード内に BPE サブシステムを作成します。`bam` コマンドは Batch Administration Manager インターフェイスを開きます。

   ```
   bam
   ```

   1. BAM インターフェイスを使用して BPE ノードを起動します。メインメニューからオプション 2、**[システム環境]** を選択します。  
![\[Batch Administrator Manager で、オプション 2 のシステム環境を選択します。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/unikix-bpe-1.png)

   1. オプション 2、**[開始/(停止) バッチノード]** を選択して BPE ノードを起動します。  
![\[[System Environments] で、オプション 2 バッチノードの開始/停止を選択します。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/unikix-bpe-2.png)

   1. 開始したら、**[Return キー]**を 2 回押して BAM メインメニューに戻ります。  
![\[バッチノードの起動が完了した画面です。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/unikix-bpe-3.png)

   1. BPE サブシステムを作成するには、オプション 3、**[アプリケーションとサブシステム]** を選択します。  
![\[オプション 3 バッチ管理者マネージャーページで選択したアプリケーションとサブシステムです。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/unikix-bpe-4.png)

   1. 次に、オプション 3、**[サブシステムの作成]** を選択します。  
![\[オプション 3: アプリケーションとサブシステム画面で選択したサブシステムを作成します。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/unikix-bpe-5.png)

   1. サブシステム名を「`sys1`」として入力します。  
![\[作成画面で sys1 を入力しました。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/unikix-bpe-6.png)

   1. オプション 3、**[データ管理]** を選択します。  
![\[アプリケーションとサブシステムの作成画面でオプション 3 データ管理を選択します。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/unikix-bpe-7.png)

   1. CardDemo アプリケーションにはシーケンシャルファイルと VSAM ファイルの両方が含まれるため、オプション 5 を選択します。  
![\[オプション 5 を選択して、シーケンシャルファイルと VSAM ファイルを含めます。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/unikix-bpe-8.png)

   1. (任意) 「R」を押して **[メニューを作成]** ページに戻り、使用可能な各種設定オプションを確認します。

   1. **[作成]** ページで「C」と入力するとサブシステム「`sys1`」を作成します。  
![\[キーボードの「C」を押してサブシステム「sys1」を作成します。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/unikix-bpe-9.png)

   1. 設定を確認し、「C」を入力して残りの環境設定を続行します。これらの環境設定は、`carddemo.env` セットアップファイルで定義されている必要な環境変数と、推奨されるフォルダ構造が整っているため、事前に入力されています。

   1. 「y」と入力して、現在の環境設定を確認して保存します。  
![\[サブシステム「sys1」の環境設定が完了しましたを表示します。また、「y」と入力して、現在の設定を保存します。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/unikix-bpe-10.png)

   1. 「y」と入力して、サブシステムの構築時にログを表示します。  
![\[sys1 の NTT DATA COBOL ランタイムシステムの構築を画面に表示します。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/unikix-bpe-11.png)

   1. メインメニューに戻り、**[終了]** オプションを選択して BAM インターフェイスを終了するまで、**[Return キー]** を押します。  
![\[作成された COBOL ランタイムシステムを表示します。また、[戻る] を押して続行するように求められます。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/unikix-bpe-12.png)  
![\[作成メニューに戻り、サブシステム「sys1」が作成されたことを示します。また、設定も更新されます。続行するには、[戻る] を押すように求められます。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/unikix-bpe-13.png)  
![\[バッチ管理者のメインメニューです。このメニューを終了するには、「Q」を入力するように求められます。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/unikix-bpe-14.png)

1. サブシステム名「`sys1`」で「`batchenv`」を調達し、BPE サブシステムを有効にします。

   ```
   source $EBMHOME/batchenv sys1
   ```

## ステップ 4: CardDemo アプリケーションをコンパイルしてデプロイする
<a name="tutorial-unikix-compile"></a>

このステップでは、COBOL プログラムをコンパイルし、JCL、プロシージャ、データファイル、CICS リソース定義などのアプリケーションアーティファクトをデプロイします。

1. `carddemo.env` セットアップファイルを取得して、CardDemo 環境をアクティブ化します。

   ```
   source $HOME/bin/carddemo.env
   ```

1. COBOL ソースディレクトリに移動します。

   ```
   cd $MIGAPP_DIR/cbl
   ```

1. `compile` スクリプトを使用して Cobol プログラム `CBACT01C.cbl` をコンパイルします。

   ```
   compile CBACT01C.cbl
   ```

1. `compile.all` スクリプトを使用してすべての Cobol プログラムをコンパイルします。

   ```
   compile.all
   ```

1. BMS Maps ソースディレクトリに移動します。

   ```
   cd $MIGAPP_DIR/bms
   ```

1. `compbms` スクリプトを使用して BMS マップ `COACTUP.bms` をコンパイルします。

   ```
   compbms COACTUP.bms
   ```

1. `compbms.all` スクリプトを使用して、すべての BMS マップをコンパイルします。

   ```
   compbms.all
   ```

1. COBOL マップと BMS マップのコンパイルされたバイナリを検証します。

   ```
   ls $PROJECT_ROOT/loadlib
   ls $PROJECT_ROOT/maps
   ```

1. `deploy_app` スクリプトを使用して、JCL、プロシージャ、データファイル、CICS リソース定義などの他のアプリケーションアーティファクトをデプロイします。

   ```
   deploy_app
   ```

1. プロジェクト JCL ディレクトリに移動します。

   ```
   cd $PROJECT_ROOT/jcl
   ```

1. JCL ACCTFILE を BPE JCL マクロに変換します。`mvstrans` コマンドを使用し、JCL 検証に「-v」オプションと「-f」オプションを使用してマクロを作成します。

   ```
   mvstrans ACCTFILE -v
   mvstrans ACCTFILE -f
   ```

1. JCL プロシージャ REPROC を BPE JCL プロシージャ Macro に変換します。検証に「-v」オプションを、マクロの作成に「-f」オプションを使用し、`mvstrans` コマンドを「-p」オプションで使用します。

   ```
   mvstrans REPROC -v -p
   mvstrans REPROC -f -p
   ```

1. すべての JCL と JCL プロシージャを変換します。。

   ```
   for file in "./jmvs/*"; do mvstrans $file -f; done > jmvs.out
   for file in "./mvsp/*"; do mvstrans $file -p -f; done > mvsp.out
   ```

## ステップ 5: BPE と TPE カタログをインポートする
<a name="tutorial-unikix-import"></a>

このステップでは、さまざまなコマンドを使用して BPE カタログと TPE カタログをインポートします。

1. `loadcat` コマンドを使用して BPE カタログをインポートします。

   ```
   loadcat $MIGAPP_DIR/catlg/bpe/BPECAT*
   ```

1. \$1KIXSYS ディレクトリに移動します。

   ```
   cd $KIXSYS
   ```

1. `kiximpcat` コマンドを使用して TPE カタログをインポートします。

   ```
   kiximpcat -c CATALOG -l CATALOG.lst
   ```

1. kiximptbl コマンドを使用して CICS リソース定義をインポートします。

   ```
   kiximptbl
   ```

## ステップ 6: TPE を起動して BPE に接続する
<a name="unikix-tutorial-connect"></a>

このステップでは、以前に作成した TPE リージョンを BPE マネージャーとともに起動し、それらを接続して、サンプル CardDemo アプリケーションを実行できるようにする必要があります。

1. すべての VSAM ファイルに対して `kixverify` コマンドを実行して、リセットされ、以前に開いたファイルがすべて閉じていることを確認します。

   ```
   kixverify -r ALL
   ```

1. TPE リージョンを開始します。

   ```
   kixregion start $KIXSYS
   ```

1. BPE と TPE の両方が接続されていることを確認します。VSAM ファイルは TPE によって所有されるため、これは重要です。VSAM にアクセスするバッチ操作には TPE への接続が必要です。

   ```
   ebmsys -t
   ```  
![\[サブシステム名を sys1 として表示します。TPE が接続され、TPE ユーザーは ec2 ユーザーです。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/unikix-start-1.png)

## ステップ 7: CardDemo アプリケーションを実行する
<a name="unikix-tutorial-run-application"></a>

このステップでは、TN3270 ターミナルエミュレータで CardDemo アプリケーションを実行します。

UniKix ランタイム AMI には、UniKix EC2 インスタンスから直接起動できる TN3270 ターミナルエミュレータが付属しています。

**TN3270 ターミナルエミュレータを使用して TPE に接続する**
+ `kixterm` コマンドを使用して TN3270 ターミナルを起動します。

  ```
  kixterm
  ```  
![\[メインフレーム用の TPE UniKix CardDemo サンプルアプリケーションのメイン画面です。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/unikix-carddemo-00.png)

(任意) 独自のターミナルエミュレータを使用する場合:

1. Amazon EC2 コンソールから UniKix ランタイムインスタンスの IP アドレスを取得します。

1. TN3270 ターミナルエミュレータを使用して TPE リージョンに接続するためのポート番号を取得します。これは、unikixrc.cfg ファイルから TNServer ListenPort で確認できます。

   ```
   cat $KIXSYS/unikixrc.cfg
   ```  
![\[リスナーポートを 15440 として UniKix unikixrc.cfg ファイルの詳細を表示します。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/unikix-carddemo-1.png)

1. UniKix ランタイムインスタンスの IP アドレスとポート番号 15440 を使用するように TN3270 ターミナルエミュレータを設定します。

**オンライントランザクション**

このセクションでは、 `kixterm` コマンドを使用して TN3270 ターミナルエミュレータに接続していることを前提としています。

1. TN3270 ターミナルエミュレータから接続したら、「Enter」キーを押して TPE 画面をクリアし、最初のトランザクションを入力します。

1. 最初のトランザクション CC00 (ログオン画面) で、ユーザー名「`USER001`」とパスワード「`PASSWORD`」を入力します。  
![\[CardDemo のメイン画面です。これが Mainframe Modernization の Credit CardDemo アプリケーションであることを示します。ユーザー ID とパスワードの入力を求めます。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/unikix-carddemo-2.png)

1. アカウントを表示するには、**[メインメニュー]** から「01」を選択します。  
![\[オプションを 1 として選択したエミュレータの CardDemo アプリケーションのメインメニューです。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/unikix-carddemo-3.png)

1. **[アカウントを表示]** 画面で、アカウント番号 (例: 00000000010) を入力します。移行されたデータから入力されたアカウント情報が表示されます。  
![\[アカウント番号が「00000000010」と入力された CardDemo アプリケーションの詳細です。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/unikix-carddemo-4.png)

1. 「PF03」キーを 2 回押すとログイン画面に戻ります。また、「Ctrl\$1C」 (Windows) または「Cmd\$1C」 (Macbook) を押して TN3270 ターミナルを終了します。

**バッチジョブ**

1. JCL ディレクトリに移動します。

   ```
   cd $MBMSUB
   ```

1. ジョブ「`MFCATGL1`」を送信し、ジョブログの出力を確認します。

   ```
   BPESUB READCARD
   ```

1. 必要に応じて、`$SUBSYS_OUTDIR` ディレクトリからジョブログを表示できます。

   ```
   ls -lrt $SUBSYS_OUTDIR/*
   ```

これで、CardDemo アプリケーションを NTT DATA UniKix ランタイムにデプロイし、いくつかの CICS オンライン画面とバッチジョブをナビゲートして実行中のアプリケーションを検証できました。

## トラブルシューティング
<a name="tutorial-unikix-troubleshoot"></a>

CardDemo アプリケーションを設定するときに発生する一般的なエラーを次に示します。

### エラー: ライセンスエラー
<a name="tutorial-unikix-troubleshoot-license-issue"></a>

このチュートリアルの実行中にライセンス障害エラーが発生した場合、EC2 で **[IMDSv2]** が有効になっている可能性があります。「*Amazon EC2 ユーザーガイド*」の「[IMDSv1 の使用を復旧する](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/configuring-IMDS-existing-instances.html)」に記載されているように、インスタンスのメタデータオプション **IMDSv2** を **[任意]** に変更することで、この問題を解決できます。

### エラー: TPE が BPE に接続されていません
<a name="tutorial-unikix-troubleshoot-tpe-connection"></a>

TPE が BPE に接続されていない場合は、**[VSAM 設定テーブル]** が BPE Node ディレクトリで正しく設定されていることを確認してください。VSAM 設定テーブルにアクセスするには、次のコマンドを使用して TN3270 ターミナルエミュレータを起動します。

```
kixterm
```

1. トランザクション名を「`CTBL`」として入力します。

1. **[テーブルマネージャー]** メニューで、**[スタンダードテーブル]** オプションを選択します。

1. 標準テーブル画面で、オプション **[VSAM 設定テーブル]** を選択します。

1. **[バッチノードに接続しますか?]** が **[Y]** に設定されており、ノードディレクトリが正しいかどうかを確認します。

![\[TN3270 ターミナルエミュレータの VSAM 設定テーブルです。テーブル内の各フィールドの値を表示します。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/unikix-troubleshoot.png)
