5.8.6 サンプルシナリオテンプレートの利用
TP1/LiNKでは，スケールアウトのシナリオテンプレートのうち，新しいTP1/LiNKのノードを追加するシナリオのサンプルシナリオテンプレートを提供しています。
TP1/LiNKをインストールした状態でサンプルシナリオテンプレート（OpenTP1_ScenarioScaleout）を実行すると，新しいTP1/LiNKの環境構築をしたあとに，TP1/LiNKとサンプルユーザサーバ（SPP）を起動します。サンプルシナリオテンプレートをカスタマイズすると，使用する環境に合わせて，スケールアウトを簡単に実行できます。
(1) サンプルシナリオテンプレートの概要
サンプルシナリオテンプレートの概要について説明します。
サンプルシナリオテンプレートは，次の表に示す処理を実行します。
|
項番 |
処理内容 |
シナリオテンプレートの名称 |
参照する入力シナリオ変数 |
|---|---|---|---|
|
1 |
TP1/LiNKインストールフォルダ取得 |
OpenTP1_GetInstDir |
|
|
2 |
TP1/LiNKフォルダの作成 |
OpenTP1_MakeTP1Dir |
|
|
3 |
TP1/LiNKの定義設定 |
OpenTP1_SetConfig |
|
|
4 |
ノード識別子の設定 |
OpenTP1_ChangeNodeID |
|
|
5 |
TP1/LiNKの登録 |
OpenTP1_Deploy |
|
|
6 |
TP1/LiNKの起動 |
OpenTP1_Start |
|
|
7 |
UAP（サンプルプログラム）の起動 |
OpenTP1_StartUAP |
|
- 注※
-
シナリオ入力変数INST_DIRは，項番1の「TP1/LiNKインストールフォルダ取得」ジョブによって取得されます。そのあとのジョブに引き継がれるため，ユーザが入力する必要はありません。
シナリオテンプレートごとに詳細を説明します。
-
TP1/LiNKインストールフォルダ取得（OpenTP1_GetInstDir）
システム環境変数のDCDIRをTP1/LiNKのインストールフォルダとして取得します。また，得られたTP1/LiNKインストールフォルダを出力シナリオ変数OUT_INST_DIRに引き継ぎます。
-
TP1/LiNKフォルダの作成
TP1/LiNKフォルダを作成します。TP1/LiNKのフォルダ作成バッチファイル（TP1/LiNKインストールフォルダ\jp1_template\examples\tools\dcjmk_dcdir.bat）を使用して，次のTP1/LiNKフォルダを作成します。
フォルダ：入力シナリオ変数DCDIRの設定値
所有者：入力シナリオ変数USER_NAMEの設定値
-
TP1/LiNKの定義設定（OpenTP1_SetConfig）
TP1/LiNK環境設定バッチファイル（%DCDIR%\jp1_template\examples\tools\dcjset_conf.bat）を使用して，定義ファイルおよびロードモジュールを，次に示す順序で設定します。
-
%DCDIR%\jp1_template\examplesフォルダ下にあるaplib，confを%DCDIR%\フォルダ下のaplib，confにコピーする
-
定義ファイルのノード固有情報（ネームサービスのポート番号など）を設定する
-
-
ノード識別子の設定（OpenTP1_ChangeNodeID）
TP1/LiNKのノード識別子を入力シナリオ変数NODE_IDの設定値で設定します。
-
TP1/LiNKの登録
dcsetupmlコマンドを実行し，TP1/LiNKをOSに登録します。
-
TP1/LiNKの起動（OpenTP1_Start）
TP1/LiNKを起動します。
-
UAP（サンプルプログラム）の起動（OpenTP1_StartUAP）
入力シナリオ変数USER_SERVER_NAMEに設定されたユーザサーバのUAPを起動します。
(2) サンプルシナリオテンプレートの登録
サンプルシナリオテンプレートを実行するには，サンプルシナリオテンプレートを，JP1/AJS2 - Scenario Operation Viewの操作によってJP1/AJS - Managerに登録します。
サンプルシナリオテンプレートは，次の場所に格納されています。
/ScenarioLibrary/OpenTP1/TP1_LiNK/OpenTP1_ScenarioScaleout
サンプルシナリオテンプレートを登録するには，次の表に示す入力シナリオ変数を設定します。
|
入力シナリオ変数 |
内容 |
設定例 |
|---|---|---|
|
DCDIR |
TP1/LiNKインストールフォルダ |
C:\OpenTP1_Multi |
|
DCCONFPATH |
TP1/LiNKの定義ファイル格納フォルダ |
C:\OpenTP1_Multi\conf |
|
HOST_NAME※1 |
実行するTP1/LiNKのノードのホスト名 |
hostX |
|
USER_NAME※1 |
TP1/LiNKのユーザ名 |
Administrator |
|
USER_SERVER_NAME |
ユーザサーバ名 |
SPP（サンプルでは固定） |
|
NODE_ID |
TP1/LiNKのノード識別子（ノードごとに一意の4文字以内の文字列） |
smpl |
|
PORT_NUMBER |
TP1/LiNKのネームポート番号 |
10000 |
|
MULTI_ID※2 |
マルチOpenTP1の識別子（ノード内で一意の2文字以内の文字列） |
ml |
- 注※1
-
設定を省略できます。
- 注※2
-
オリジナルの場合は設定を省略できます。
表5-13の設定例の値をサンプルシナリオテンプレートに設定してシナリオを実行した場合，次の図に示すフォルダ構成のTP1/LiNK実行環境が作成されます。
|
|
![[図データ]](GRAPHICS/ZU032100.GIF)
(3) サンプルシナリオテンプレートのカスタマイズ
サンプルとして提供される定義ファイルやTP1/LiNK環境設定バッチファイルなどをカスタマイズすると，TP1/LiNKの構成を簡単に変更できます。また，使用する環境に合わせてカスタマイズしたファイルを，TP1/LiNKのインストール環境とともにDPMで作成するマスタディスクに格納すると，スケールアウトを簡単に実行できます。
ユーザがカスタマイズできるサンプルファイルを次に示します。
-
サンプルプログラムのロードモジュール
-
定義ファイル
-
TP1/LiNK環境設定バッチファイル
各ファイルのカスタマイズ方法を次に示します。
(a) サンプルプログラムのロードモジュールのカスタマイズ
業務に合わせたSUPおよびSPPを作成し，ロードモジュール（実行形式ファイル）を任意のフォルダに格納してください。
(b) 定義ファイルおよびTP1/LiNK環境設定バッチファイルのカスタマイズ
TP1/LiNKの定義をカスタマイズするには，定義ファイルおよびTP1/LiNK環境設定バッチファイルを変更します。
-
定義ファイルのカスタマイズ
TP1/LiNKの各定義ファイルの中で必要なものを，あらかじめTP1/LiNK環境設定GUIで設定しておきます。設定内容をノードごとに変えたい場合は，定義ファイルの内容にシナリオテンプレート用の文字列「@DCxxxxxx@」を設定してください。「@DCxxxxxx@」の値は，dcjchconfコマンドで設定できます。TP1/LiNK環境設定GUIの項目と定義ファイルの関連については，「付録C GUIと定義ファイルの関連」を参照してください。
-
TP1/LiNK環境設定バッチファイルのカスタマイズ
TP1/LiNK環境設定バッチファイルは，定義ファイルに設定された文字列「@DCxxxxxx@」を，dcjchconfコマンドを実行して設定します。サンプルシナリオテンプレートの場合，次の表に示すように設定されます。
表5‒14 サンプルシナリオテンプレートの文字列「@DCxxxxxx@」の設定値 ファイル名
オペランド名
定義ファイルの設定値
TP1/LiNK環境設定バッチファイルの設定値※1
betranrc
node_id※2
@DCNODE_ID@
?NODE_ID?
name_port
@DCport_number@
?PORT_NUMBER?
- 注※1
-
「?」で囲まれた文字列は，入力シナリオ変数に設定された値を示します。
- 注※2
-
サンプルシナリオテンプレートが実行する「ノード識別子の設定」シナリオを実行すると，自動的に設定されます。