Interstage Application Server OLTPサーバ運用ガイド

4.4 ユーティリティワークユニットでの運用

　Interstage配下外である一般アプリケーションをワークユニット上で動作させる場合の環境作成、および運用手順は以下のとおりです。

　一般アプリケーションをワークユニットで動作させる場合、1.〜4の作業が必要になります。

1)一般アプリケーションの開発

　ワークユニットで動作させる一般アプリケーションの作成を行います。また、ワークユニットで使用する前に単独で起動を行い、テストを行っておく必要があります。

2)ワークユニット定義の設定/登録

　ワークユニットの操作に必要な一般アプリケーションの情報を設定し、登録する必要があります。

• ワークユニット定義の設定
  　ワークユニット定義に一般アプリケーションをワークユニットで動作させるための情報を設定する必要があります。以下にユーティリティワークユニットを使用する場合に必要なワークユニット定義について説明します。

セクション名	定義項目名	設定内容
WORK UNIT	Name(ワークユニット名)	ワークユニット名を設定します。
	Kind(ワークユニット種別)	ワークユニット上でInterstage配下外の一般アプリケーションを動作させる場合に“UTY”と設定します。
Control Option	Path(アプリケーションライブラリパス)	一般アプリケーションが存在するパスを設定します。
	Current Directory(カレントディレクトリ)	アプリケーションが動作するディレクトリを指定します。アプリケーションは“当項目で指定されたディレクトリ/ワークユニット名/プロセスID”ディレクトリの配下で動作します。
	Application Retry Count(連続異常終了回数)	自動再起動不可となるまでのアプリケーションの連続異常終了回数を設定します。“WorkUnit Automatic Stop Mode:”ステートメントに“YES”が設定されている場合は、当項目は無視されます。
	Path for Application(アプリケーション使用パス)	アプリケーションが動作時に使用するパス(環境変数PATH)を設定します。
	Library for Application(アプリケーション使用ライブラリパス)	アプリケーションが動作時に使用するライブラリパス(環境変数LD_LIBRARY_PATH)を設定します。
	Environment Variable(環境変数)	アプリケーションが動作時に使用する環境変数を設定します。
	Maximum Processing Time For Exit Program(出口プログラム最大処理時間)	出口プログラム(プロセス停止出口)の最大処理時間の監視値を設定します。[Control Option]セクションに設定した場合、ワークユニット配下のアプリケーションに対しては有効になります。ただし、[Application Program]セクションにも設定されている場合、当該アプリケーションに関しては、[Application Program]セクションに設定された値が有効になります。
	Executable File of Exit Program for Salvage(回収出口プログラム実行ファイル名)	プロセス停止出口を使用する場合、プロセス停止出口プログラムが設定されている実行ファイルを設定します。[Control Option]セクションか[Application Program]セクションに設定します。[Application Program]セクションに設定されていない場合、[Control Option]セクションに設定された実行ファイルが有効になります。
	WorkUnit Automatic Stop Mode(自動停止モード)	ワークユニット自動停止を行う場合に設定します。
Application Program	Executable File(実行ファイル名)	ワークユニットで動作させる一般アプリケーションを指定します。
	Concurrency(プロセス多重度)	起動するアプリケーションの多重度を設定します。
	Environment Variable(環境変数)	アプリケーションが動作時に使用する環境変数を設定します。[Control Option]セクションの“Environment Variable:”ステートメントで同一名の環境変数が設定された場合、当該[Application Program]セクションに設定されたアプリケーションに関しては、当項目が有効となります。
	Param for Executable File(起動パラメタ)	アプリケーション起動時に渡すパラメタを設定します。 当項目は10個まで指定可能です。定義された上から順にパラメタとして設定されます。
	Reset Time for Application Retry Count(リトライカウントリセット時間)	現在の異常終了回数をリセットするまでの連続無停止時間を設定します。
	Exit Program for Terminating Process(プロセス停止出口プログラム名)	起動したアプリケーションプロセスを停止するプログラム名を設定します。
	Executable File of Exit Program for Salvage(回収出口プログラム実行ファイル名)	プロセス停止出口を使用する場合、プロセス停止出口プログラムが設定されている実行ファイルを設定します。[Control Option]セクションか[Application Program]セクションに設定します。[Control Option]セクションにも設定されている場合、[Application Program]セクションに設定されたアプリケーションに関しては、当項目で設定した実行ファイルが有効になります。
	Maximum Processing Time For Exit Program(出口プログラム最大処理時間)	出口プログラム(プロセス停止出口)の最大処理時間の監視値を設定します。[Control Option]セクションにも登録されている場合、こちらの値が当該出口プログラムに対しては有効になります。

• ワークユニット定義の登録
  　一般アプリケーションの情報を設定したワークユニット定義をInterstageに登録します。登録はisaddwudefコマンドを使用します

3)ワークユニットの起動

　ワークユニット定義で設定した一般アプリケーションの起動を行います。起動はisstartwuコマンドでワークユニット名を指定して行います。

4)ワークユニットの停止

　起動中のワークユニットの停止を行います。
　停止にはコマンドによる停止と、アプリケーションがすべて停止したのを待ってワークユニット停止とする２パターンがあります。
　コマンドによる停止には以下の2つがあります。通常停止はisstopwuコマンドでワークユニット名を指定して行います。強制停止の場合は、-cも指定します。

• 通常停止
  　ワークユニット上で起動したアプリケーションプロセスを監視対処から解除します。つまり、ワークユニットによる一般アプリケーションの監視解除を行い、コマンドは復帰します。そのため、ワークユニット停止コマンド復帰後も一般アプリケーションのプロセスは残ったままとなります。使用者は独自でプロセスの停止を行う必要があります。
  　また、使用者がアプリケーションプロセスを停止するプロセス停止出口プログラムを作成し、ワークユニット定義に設定することで、ワークユニット停止時に呼び出すことも可能です。この出口プログラムには通常停止の旨を通知するため、強制停止時と区別した停止を行いたい場合に有効です。
  　プロセス停止出口の詳細については、“アプリケーション作成ガイド(コンポーネントトランザクションサービス編)”を参照してください。
  
• 強制停止
  　ワークユニット上で起動したアプリケーションプロセスを監視対処から解除します。つまり、ワークユニットによる一般アプリケーションの監視解除を行い、コマンドは復帰します。そのため、ワークユニット停止コマンド復帰後も一般アプリケーションのプロセスは残ったままとなります。使用者は独自でプロセスの停止を行う必要があります。
  　また、使用者がアプリケーションプロセスを停止するプロセス停止出口プログラムを作成し、ワークユニット定義に設定することで、ワークユニット停止時に呼び出すことも可能です。この出口プログラムには強制停止の旨を通知するため、通常停止時と区別した停止を行いたい場合に有効です。
  　プロセス停止出口の詳細については、“アプリケーション作成ガイド(コンポーネントトランザクションサービス編)”を参照してください。
  

　すべてのアプリケーションの停止を契機としたワークユニット停止は以下のとおりです。

• ワークユニット自動停止
  　コマンドやバッチのように、プロセスとして常駐せず、実行後停止するアプリケーションがあります。そのようなアプリケーションの場合、プロセスが停止した場合でも、プロセスの再起動を行わず、ワークユニット内のプロセスがすべて停止したのを待って、ワークユニット停止の状態にする必要があります。ワークユニット自動停止はコマンドやバッチに有効な機能です。ワークユニット自動停止の設定については、ワークユニット定義で行います。