Interstage Job Workload Server リファレンス

A.2.2 バッチ実行サービスの環境作成

バッチ実行サービスの環境作成は、バッチセットアップ情報ファイルのQUEUE要素の情報をもとに、バッチ実行サービスが動作に必要なセットアップを以下の順に行います。

1. バッチ実行サービス環境作成開始メッセージ出力

バッチ実行サービスの環境作成を開始するときに、以下のメッセージを標準出力に出力します。

***********************************************************************
Starts creating batch executor service environment.
***********************************************************************

2. Interstage起動

Interstageの起動を開始するときに、以下のメッセージを標準出力に出力します。

Starts Interstage.

isstartコマンドを使用して、Interstageを起動します。
Interstageの起動に失敗した場合は、バッチサーバのセットアップコマンドは異常終了してセットアップは中断します。
Interstageが起動済の場合は、セットアップコマンドは異常終了します。

isstartコマンドは、“Interstage Application Server リファレンスマニュアル(コマンド編)”を参照してください。

3. JMXサービス起動

JMXサービスが起動していない場合は、JMXサービスを開始します。サービス開始時に、以下のメッセージを標準出力に出力します。

Starts JMX service.

isjmxstartコマンドを使用して、JMXサービスを起動します。
JMXサービスの起動に失敗した場合は、バッチサーバのセットアップコマンドは異常終了してセットアップは中断します。

4. QueueConnectionFactory登録

“APFWQCF”という名前のQueueConnectionFactoryを登録します。登録時に以下のメッセージを標準出力に出力します。

Creates queue connection factory. :
   NAME=('APFWQCF')

jmsmkfactコマンドを使用して、QueueConnectionFactoryを登録します。
jmsmkfactコマンドで異常が発生した場合は、バッチサーバのセットアップコマンドは異常終了してセットアップは中断します。
ただし、すでにAPFWQCFという名前のQueueConnectionFactoryが登録されている場合は、メッセージラベルが“FSP_INS-JOB_BTFW”、メッセージ番号が“08004”のメッセージを標準出力に出力し、次の処理に遷移します。

jmsmkfactコマンドの詳細は、“Interstage Application Server リファレンスマニュアル(コマンド編)”を参照してください。

5. ジョブの実行環境単位のバッチ実行サービスの環境作成

ジョブの実行環境単位に必要な、バッチ実行サービスの環境を作成します。作成時に、ジョブキュー名、イニシエータ名を示すメッセージを標準出力に出力します。メッセージの出力例を以下に示します。

***********************************************************************
*     Queue/Initiator name : queue1
***********************************************************************

ジョブの実行環境単位に、5〜9 を繰り返します。

6. ジョブステップ用／エラー用／ジョブ終了用イベントチャネル作成

ジョブの実行環境の、ジョブステップ用イベントチャネル／エラー用イベントチャネル／ジョブ終了用イベントチャネルを作成します。作成時に、ジョブステップ用／エラー用／ジョブ終了イベントチャネルを作成することを示すメッセージを標準出力に出力します。メッセージの出力例を以下に示します。

Creates job step/error/completion event channel. :
   GROUP=('queue1_ChannelGR')
   NAME1=('queue1_CSTEPchnl')
   NAME2=('queue1_ERRORchnl')
   NAME3=('queue1_JobCOMPchnl')

ジョブステップ用／エラー用／ジョブ終了用イベントチャネルの作成は、esmkchnlコマンドを使用します。
ジョブステップ用／エラー用／ジョブ終了用イベントチャネルの設定項目を、以下に示します。

パラメタ		設定内容
設定項目	コマンド引数
イベントチャネルグループ名	-g	QUEUE要素の“Name”_JobChannelGr
イベントチャネル名	-c	QUEUE要素の“Name”_CSTEPchnl　と QUEUE要素の“Name”_ERRORchnl　と QUEUE要素の“Name”_JobCOMPchnl
イベントチャネルの通信経路であるホスト名	-host	省略
イベントチャネルの通信経路であるポート番号	-post	省略
ノーティフィケーションサービス機能	-notify	-notifyを指定 (機能を使用する)
コネクション自動回収機能	-autodiscon	省略 (機能を使用しない)
モデル	-ptp	-ptpを指定 (“Point-To-Point”)
不揮発チャネル運用	-persist	省略 (使用しない)
ユニットID	-unit	省略 (使用しない)
ローカルトランザクション	-tran	省略 (使用しない)
グローバルトランザクション	-ots	省略 (使用しない)
最大接続数	-m	{実行多重度(*)}×7 *：QUEUE要素の“Concurrency”
日本語コード系	-l	“EUC”を指定
SSL通信	-ssl	省略 (使用しない)
拡張システム	-M	省略 (使用しない)

esmkchnlコマンドで異常が発生した場合は、バッチサーバのセットアップコマンドは異常終了してセットアップは中断します。
ただし、ジョブステップ用／エラー用／ジョブ終了用イベントチャネルが作成済の場合は、メッセージラベルが“FSP_INS-JOB_BTFW”、メッセージ番号が“08004”のメッセージを標準出力に出力し、次の処理に遷移します。

上でジョブステップ用イベントチャネルを作成した場合、そのイベントチャネルの設定を行います。
ジョブステップ用イベントチャネルの設定は、essetcnfchnlコマンドを使用します。
ジョブステップ用イベントチャネルの設定項目を、以下に示します。

パラメタ		設定内容
設定項目	コマンド引数
イベントチャネルグループ名	-g	QUEUE要素の“Name”_JobChannelGr
イベントチャネル名	-c	QUEUE要素の“Name”_CSTEPchnl
イベントチャネルの動作環境の設定項目	-s	-s
ローカルトランザクションのタイムアウト時間 (動作環境設定項目)	-ltrntime	1000000

essetcnfchnlコマンドで異常が発生した場合は、バッチサーバのセットアップコマンドは異常終了してセットアップは中断します。

esmkchnlコマンド、およびessetcnfchnlコマンドは、“Interstage Application Server リファレンスマニュアル(コマンド編)”を参照してください。

7. Destination定義登録

7.で作成した、ジョブ終了用イベントチャネル、ジョブステップ用イベントチャネル、およびエラー用イベントチャネルの、イベントチャネル単位に、Destination定義を登録します。
イベントチャネル単位に、Destination定義を登録することを示すメッセージを標準出力に出力します。メッセージの出力例を以下に示します。

Creates destination. :
   NAME=('queue1_JobCOMPdest')

apfwmkdstコマンドを使用して、イベントチャネル単位にDestination定義を登録します。
作成するジョブ終了用イベントチャネルの設定項目を、以下に示します。

パラメタ		設定内容
設定項目	コマンド引数
イベントチャネルグループ名	-g	QUEUE要素の“Name”_JobChannelGr
イベントチャネル名	-c	（ジョブ終了用イベントチャネル） QUEUE要素の“Name”_JobCOMPchnl （ジョブステップ用イベントチャネル） QUEUE要素の“Name”_CSTEPchnl （エラー用イベントチャネル） QUEUE要素の“Name”_ERRORchnl
Distination名		（ジョブ終了用イベントチャネル） QUEUE要素の“Name”_JobCOMPdest （ジョブステップ用イベントチャネル） QUEUE要素の“Name”_CSTEPdest （エラー用イベントチャネル） QUEUE要素の“Name”_ERRORdest

apfwmkdstコマンドで異常が発生した場合は、バッチサーバのセットアップコマンドは異常終了してセットアップは中断します。
ただし、Destination定義が登録済の場合は、メッセージラベルが“FSP_INS-JOB_BTFW”、メッセージ番号が“08004”のメッセージを標準出力に出力し、次の処理に遷移します。

apfwmkdstコマンドの詳細は、“Interstage Job Workload Server アプリケーション連携実行基盤リファレンス”を参照してください。

8. バッチワークユニット作成

バッチワークユニットを作成します。作成時に、バッチワークユニットを作成することを示すメッセージを、標準出力に出力します。メッセージの出力例を以下に示します。

Creates work unit. :
   NAME=('queue1_CWU')

isaddwudefコマンドを使用して、バッチワークユニットを登録します。
isaddwudefコマンドが作成するバッチワークユニットの設定項目を、以下に示します。

セクション	項目	意味	設定内容
Work Unit	Name	ワークユニット名	QUEUE要素の“Name”_CWU
	Kind	ワークユニット種別	“ASYNC”
	Batch Mode	バッチモード	“YES”
Control Option	Current Directory	カレントディレクトリ	QUEUE要素の“WUCurrent”
	Application Retry Count	プロセス再起動リトライカウント数	{実行多重度(*)} + 1（ただし、255を超える場合は255） *：QUEUE要素の“Concurrency”
	Path for Application	アプリケーション使用パス	省略
	Library for Application	アプリケーション使用ライブラリパス	省略
	Environment Variable	環境変数	省略
	Startup Time	ワークユニット起動待ち時間	省略 (“180秒”)
	Shutdown Time	プロセス強制停止時間	省略 (“180秒”)
	Start Log	プロセス起動ログ採取	省略 (“NO”)
	Process Degeneracy	プロセス縮退運用	“YES”
	Number of Revision Directories	カレントディレクトリの退避世代数	省略 (1世代)
Application Program	Destination	あて先名	QUEUE要素の“Name”_CSTEPdest
	Concurrency	プロセス多重度	{実行多重度(*)} *：QUEUE要素の“Concurrency”
	CLASSPATH for Application	アプリケーション使用CLASSPATH	省略
	Process Mode	プロセスモード	省略 (スレッドモード)

バッチワークユニットを作成するために、必要なワークユニット定義ファイルは、セットアップコマンドで、自動的に生成して、以下のディレクトリ配下に格納します。
バッチワークユニット作成後も、バッチワークユニットの環境の設定変更などするときに必要になるので、退避して管理してください。

/var/opt/FJSVibsbc/local/def/ワークユニット名.wu

また、上記ディレクトリに格納したときに、メッセージを標準出力に出力します。メッセージの出力例を以下に示します。

Saved work unit definition file. :
   DATA=('/var/opt/FJSVibsbc/local/def/queue3_CWU.wu')

isaddwudefコマンドで異常が発生した場合には、バッチサーバのセットアップコマンドは異常終了してセットアップは中断します。
ただし、バッチワークユニットが作成済の場合は、メッセージラベルが“FSP_INS-JOB_BTFW”、メッセージ番号が“08004”のメッセージを標準出力に出力し、次の処理に遷移します。

isaddwudefコマンドは、“Interstage Application Server リファレンスマニュアル(コマンド編)”を参照してください。
バッチワークユニットの設定項目については、“Interstage Job Workload Server セットアップガイド”の“バッチワークユニットの設定”を参照してください。

9. イニシエータ作成

バッチの実行環境の、イニシエータを作成します。作成時に、イニシエータを作成することを示すメッセージを、標準出力に出力します。メッセージの出力例を以下に示します。

Creates initiator. :
   NAME=('queue1')

イニシエータの作成を使用して、バッチ実行サービスのイニシエータを登録します。
作成するイニシエータの設定項目を以下に示します。

設定項目	設定内容
イニシエータ名	QUEUE要素の“Name”
ジョブキュー名	QUEUE要素の“Name”
エラー用イベントチャネルのDistination名	QUEUE要素の“Name”_ERRORdest
ジョブ終了用イベントチャネルのDistination名	QUEUE要素の“Name”_JobCOMPdest
バッチWU名	QUEUE要素の“Name”_CWU
イニシエータの開始方法	省略（auto：自動）

イニシエータの作成で異常が発生した場合は、バッチサーバのセットアップコマンドは異常終了してセットアップは中断します。
ただし、イニシエータが作成済の場合は、メッセージラベルが“FSP_INS-JOB_BTFW”、メッセージ番号が“08004”のメッセージを標準出力に出力し、次の処理に遷移します。

10. JMXサービス停止

セットアップコマンドがJMXサービスの起動を行った場合は、JMXサービスを停止します。停止始時に、以下のメッセージを標準出力に出力します。

Stops JMX service.

isjmxstopコマンドを使用して、JMXサービスを停止します。
JMXサービスの停止に失敗した場合は、バッチサーバのセットアップコマンドは異常終了してセットアップは中断します。

11. Interstage強制停止

Interstageを全停止するときに、以下のメッセージを標準出力に出力します。

Stops all interstage services.

isstopコマンドを使用して、Interstageをすべて停止します。
Interstageの停止に失敗した場合は、バッチサーバのセットアップコマンドは異常終了してセットアップは中断します。

isstopコマンドは、“Interstage Application Server リファレンスマニュアル(コマンド編)”を参照してください。