2.5.1　実行エージェントの検討

■ 対象ユニット

ユニットの詳細定義で指定した実行エージェントが，実行エージェントプロファイルに設定されているかどうか確認されるように設定できるユニットは，次のとおりです。

• ルートジョブネット^※1

• ネストジョブネット^※1

• UNIXジョブ

• PCジョブ

• フレキシブルジョブ^※2

• HTTP接続ジョブ

• イベントジョブ

• アクションジョブ

• カスタムジョブ

注※1

JP1/AJS3 - Viewでユニット定義をする際に，実行エージェントを指定した場合だけ確認されます。

注※2

フレキシブルジョブの場合は中継エージェントが該当します。フレキシブルジョブの中継機能を利用しない場合，「@SYSTEM」を許可するか，フレキシブルジョブの中継エージェント用の実行エージェントを定義して許可してください。

■ 実行エージェントの確認方法

実行エージェント制限では，JP1/AJS3 - Viewでのユニット定義時，ajschkdefコマンドでの定義内容の事前チェック時，およびジョブ実行時に，実行エージェントの確認が実施されます。

それぞれの場合での確認方法について，次に説明します。

JP1/AJS3 - Viewでのユニット定義時

ユニットの詳細定義ダイアログボックスの［実行エージェント］コンボボックスに，実行エージェントプロファイルに設定されている実行エージェントだけが表示され，その中から実行エージェントを選択できるようになります。コンボボックスに直接入力することもできます。［OK］ボタンをクリックすると，指定した実行エージェントが実行エージェントプロファイルに設定されているかどうかが確認されます。

なお，ユニット定義時にだけ確認して，ジョブ実行時には確認しないように設定することもできます。

ただし，［詳細定義−［フレキシブルジョブ］］ダイアログボックスの［中継エージェント］には，実行エージェントプロファイルに設定されている実行エージェントはコンボボックスで表示されません。また，［OK］ボタンをクリックしたときに，実行エージェントプロファイルに設定されているかどうかも確認されません。

ajschkdefコマンドでの定義内容の事前チェック時

定義内容の事前チェックを実施するときに，実行エージェントが実行エージェントプロファイルに設定されているかどうかが確認されます。実行エージェントプロファイルに設定されていない実行エージェントを指定している場合は，チェック結果格納ファイルにチェック結果情報が出力されます。

なお，実行エージェントプロファイルの状態（有効／無効）に関係なく，ajschkdefコマンドの-Cおよび-pオプションを指定すると確認できます。

ジョブ実行時

ジョブ実行時に，実行エージェントが実行エージェントプロファイルに設定されているかどうかが確認されます。実行エージェントプロファイルに設定されていない実行エージェントでジョブを実行しようとした場合は，ジョブの状態が「起動失敗」状態になります。ただし，起動条件として複数のイベントジョブを定義している場合，起動条件として定義したイベントジョブの一つが実行エージェントの確認でエラーになったときは，次に示す状態になります。

• 起動条件付きジョブネットの監視世代

  「監視打ち切り終了」状態

• 実行エージェントの確認でエラーになったジョブ

  「起動失敗」状態

• 起動条件として定義したイベントジョブのうち，実行エージェントの確認でエラーになったジョブ以外のジョブ

  「未実行終了」状態

なお，ジョブ実行時にだけ確認して，ユニット定義時には確認しないように設定することもできます。

■ 自ホストでの実行を許可する場合

「@SYSTEM」を設定します。ただし，自ホスト名と同じ名前の実行エージェントを許可したいときは，その実行エージェント名を設定します。

キューレスジョブで自ホストでの実行を許可したいときは，自ホスト名を設定します。ここでいう自ホスト名とは，次の方法で確認できる名前です。

• 物理ホストの場合

  hostnameコマンドを実行して得られるホスト名

• 論理ホストの場合（Windows）

  JP1/AJS3を運用しているホスト上で［コントロールパネル］ウィンドウから［サービス］を選択するか，または［管理ツール］−［サービス］を選択し，［サービス］ウィンドウに表示される「JP1/AJS3_xxxxx」の「xxxxx」の部分に表示されるホスト名

• 論理ホストの場合（UNIX）

  psコマンドを実行し，jajs_spmdプロセスの後ろに表示されるホスト名

■ ユニットの実行エージェントに実行エージェントグループを指定する場合

ユニットの実行エージェントに実行エージェントグループを指定する場合，実行エージェントプロファイルに，実行を許可する実行エージェントグループ名を設定します。

実行エージェントプロファイルに実行エージェントグループを設定した場合の例を次の図に示します。

この図の例では，/Grp1/net1/配下のジョブの実行エージェントに，「AGTGRP1」を指定したときと「AGT1」を指定したときでは，どちらも実際の実行先は実行エージェントAGT1（実行ホストhost1）です。ただし，実行エージェントプロファイルには「AGT1」が設定されていないため，ジョブの実行エージェントに「AGT1」を指定した場合は実行エージェントの確認でエラーになります。

■ ユニットの実行エージェントにマクロ変数名を指定する場合

ユニットの実行エージェントにマクロ変数名を指定する場合，実行エージェント制限を確認するタイミングの設定に従って，許可する実行先として実行エージェントプロファイルに実行エージェント名またはマクロ変数名を設定します。

マクロ変数名を指定する場合に実行エージェントプロファイルに設定する内容を，次の表に示します。

なお，項番1または項番2の組み合わせで，実行エージェントプロファイルを設定することを推奨します。

■ キューレスジョブの場合

キューレスジョブに対して実行エージェント制限を使用する場合，実行エージェントプロファイルには，キューレスジョブの実行先となるホスト名を設定します。

なお，詳細定義の［実行エージェント］に，クラス名を含めて実行先ホストを指定している場合，「!クラス名」の部分を実行エージェントプロファイルに設定する必要はありません。

また，アタッチされていない論理ホストをキューレスジョブの実行先として指定している場合，次の条件を満たしていれば，論理ホストに対応する物理ホスト上でキューレスジョブが実行されます。

• キューレスジョブに指定している論理ホストが実行エージェントプロファイルに設定されている

• 環境設定パラメーターAJSQL_NOATTACHREQに「exec」が設定されている

このとき，物理ホストが実行エージェントプロファイルに設定されているかどうかは関係ありません。実行エージェントプロファイルに物理ホストを定義していなくても，物理ホスト上でキューレスジョブが実行されます。