メインフレーム コネクタは、MVS バッチジョブのコンテキスト内で Java 仮想マシン（JVM）プロセスとして起動されます。Mainframe Connector は通常、JVM に付属の IBM ライブラリ以外の必要な依存関係を含む JAR ファイルを使用してデプロイされます。 以降のセクションでは、Mainframe Connector のインストール プロセスについて詳しく説明します。
始める前に
- Mainframe Connector の初期設定を完了します。 初期設定には、サービス アカウントへの必要なロールの付与、アセットのセキュリティ設定、メインフレームと Google Cloud間のネットワーク接続の設定が含まれます。
- Java 8 または Java 17 を構成します。
- JZOS Batch Launcher と Toolkit（Java 8 または Java 17）をインストールします。
Mainframe Connector をインストールする
Mainframe Connector をインストールする手順は次のとおりです。
ユーザー アカウントに書き込み権限があるディレクトリに、ビルド済みの Mainframe Connector JAR ファイルをダウンロードします。
重要
Mainframe Connector は Google アナリティクスを使用して使用状況データを収集します。この情報は、ソフトウェアの改善とユーザー エクスペリエンスの向上に役立てられます。デフォルトでは、Google アナリティクスは有効になっています。ただし、Mainframe Connector の実行時に環境変数を構成することで、オプトアウトできます。
Google アナリティクスの使用には、Google アナリティクスの利用規約とプライバシー ポリシーが適用されます。Mainframe Connector をダウンロードすると、利用規約を読み、理解し、同意したことになります。ステップ 8 に示す BQSH ジョブ制御言語（JCL）プロシージャの Java Classpath セクションで指定されるパスに、mainframe-connector-shadow-VERSION-all.jar ファイルをコピーします。VERSION は Mainframe Connector のバージョンです。
メインフレームから Google Cloud サービスにアクセスするには、サービス アカウント キーを作成して JSON キーファイルとしてダウンロードする必要があります。JSON キーファイルの作成の詳細については、サービス アカウント キーを作成するをご覧ください。
バイナリ転送モードでファイル転送プロトコル（FTP）を使用して、JSON 鍵ファイルを Unix ファイル システムにコピーします。変更されていない JSON キーファイルを、元の UTF-8 エンコードでファイル システムに保存してください。
IBM z/OS Unix ファイル システムに JSON キーファイルを保存するためのデフォルトのパスはありません。サービス アカウントへのアクセス権を持つユーザーのみが読み取れるパスを選択する必要があります。JSON キーファイルが正しく転送された場合、UNIX System Services（USS）から読み取ることができません。
バイナリ モードで FTP を使用して、手順 1 でダウンロードした JAR ファイルをメインフレームの次の場所にアップロードします。
/opt/google/mainframe-connector/VERSION/
Version は、JAR ファイルのバージョンに置き換えます。
これは、JAR ファイルをデプロイするための推奨パスです。サイト管理者が選択したパスを使用することもできます。
次のコマンドを実行して、JAR ファイルが正しく転送されたことを検証します。
-tオプションは JAR ファイルの内容を一覧表示します。jar -tvf JAR_FILE_NAME
JAR_FILE_NAME は、JAR ファイルの名前に置き換えます。
次の BQSH JCL プロシージャのコピーを作成します。