JP1 Version 8

JP1/Automatic Job Management System 2 セットアップガイド

手引・文法・操作書

3020-3-K23-43

目　　次

前書き

変更内容

はじめに

第1編　Windowsホスト編

1.　システム構成の種類とセットアップの手順

1.1　JP1/AJS2シリーズプログラムと適用OS

1.2　JP1/AJS2のセットアップ手順の概要

1.2.1　JP1/AJS2 - ManagerとJP1/AJS2 - Viewでシステムを構築する場合のセットアップ手順

1.2.2　1台のJP1/AJS2 - Managerホストを使ったマネージャー・エージェント構成にする場合のセットアップ手順

1.2.3　複数のJP1/AJS2 - Managerを使ったマネージャー・エージェント構成にする場合のセットアップ手順

2.　インストール

2.1　JP1/AJS2シリーズプログラムのインストール前に必要な作業

2.1.1　JP1/Baseをインストールする

2.2　JP1/AJS2シリーズプログラムのインストール

2.2.1　インストール時の注意事項

2.2.2　JP1/AJS2シリーズプログラムをインストールする

2.3　組み込みDBのインストール

3.　セットアップ

3.1　JP1/AJS2 - Managerで必要なセットアップ

3.1.1　JP1/Baseのセットアップ

3.1.2　JP1/AJS2 - Managerのセットアップ

3.2　JP1/AJS2 - Agentで必要なセットアップ

3.2.1　JP1/Baseのセットアップ

3.2.2　JP1/AJS2 - Agentのセットアップ

3.3　JP1/AJS2 - Viewで必要なセットアップ

3.4　JP1/AJS2 Consoleで必要なセットアップ

3.4.1　JP1/AJS2 Console Managerのセットアップ

3.4.2　JP1/AJS2 Console Agentのセットアップ

3.4.3　JP1/AJS2 Console Viewのセットアップ

3.5　システムおよびユーザー環境で必要なセットアップ

3.5.1　トレースログファイルの拡張

3.5.2　通信環境の設定

3.5.3　ジョブ実行環境の構成定義情報を変更する

4.　環境設定

4.1　スケジューラーサービス環境の設定

4.1.1　論理ホスト共通の情報を定義する

4.1.2　スケジューラーサービスの制御を定義する

4.1.3　スケジューラーファイルの構成を定義する

4.1.4　スケジューラーログを定義する

4.1.5　スケジューラーオプションを定義する

4.1.6　環境設定パラメーターで定義する

4.2　ジョブ実行環境の設定

4.2.1　マネージャー環境の設定

4.2.2　エージェント環境の設定

4.3　イベント起動の設定

4.3.1　マネージャー環境の設定

4.3.2　エージェント環境の設定

4.4　キューレスジョブ実行環境の設定

4.4.1　マネージャー環境の設定

4.4.2　エージェント環境の設定

4.5　その他のオプションの設定

4.5.1　マネージャー環境の設定

4.5.2　エージェント環境の設定

4.6　JP1/AJS2 Console環境の設定

4.6.1　JP1/AJS2 Console Manager環境の設定

4.6.2　JP1/AJS2 Console Agent環境の設定

4.7　そのほかの設定

4.7.1　スケジューラーサービスの多重起動の設定

4.7.2　ISAMファイル自動再編成機能の設定

4.7.3　スケジューラーサービスの統合トレースログ出力レベルの変更

4.7.4　ネストジョブネット定義パラメーター出力時のスケジュールルールの出力方法の変更

4.7.5　スケジューラートレースログファイルの名称変更

4.7.6　JP1/AJS2 - Managerの運用方法をサブミットジョブの登録や操作に限定するときの設定

4.7.7　サスペンド機能の設定

4.7.8　登録解除や保存世代数管理による世代削除処理方式の変更

4.7.9　スケジューラーサービスをウォームスタートで起動させたときに，実行中であったジョブまたはジョブネットの終了メッセージ，および終了イベントの出力有無の設定

4.7.10　JP1/AJS2定義内容の事前チェック機能の設定

4.7.11　ジョブネットコネクタで異なるスケジューラーサービス間のルートジョブネットの実行順序を制御するための設定

5.　スケジューラーデータベースに組み込みDBを使用する場合のセットアップ

5.1　組み込みDBを使用する場合の準備

5.1.1　前提条件

5.1.2　組み込みDBのセットアップ手順

5.1.3　組み込みDB稼働環境と運用方法の検討

5.2　組み込みDBのセットアップ

5.2.1　組み込みDBのインストール

5.2.2　組み込みDB環境の構築

5.2.3　組み込みDBへの移行

5.2.4　複数スケジューラーデータベースの組み込みDBへの移行

5.2.5　組み込みDBの再セットアップ

5.3　クラスタ構成時の実行系組み込みDBのセットアップ

5.3.1　組み込みDBのインストール

5.3.2　組み込みDB環境の構築

5.3.3　組み込みDBへの移行

5.3.4　複数スケジューラーデータベースの組み込みDBへの移行

5.3.5　組み込みDBの再セットアップ

5.4　クラスタ構成時の待機系組み込みDBのセットアップ

5.4.1　組み込みDBのインストール

5.4.2　組み込みDB環境の構築

5.4.3　組み込みDBへの移行

5.4.4　複数スケジューラーデータベースの組み込みDBへの移行

5.4.5　組み込みDBの再セットアップ

5.5　クラスタ構成時の組み込みDBの設定変更

5.6　組み込みDBのクラスタソフトへの登録

6.　JP1/AJS2 - Viewの環境設定

6.1　JP1/AJS2 - Viewの環境設定を変更する手順

6.2　JP1/AJS2 Console Viewの環境設定を変更する手順

7.　運用形態に合わせた各種設定

7.1　ジョブ実行時のワークパスを変数として定義する

7.2　ジョブをロングファイル名で実行するための設定

7.3　転送元ファイルの検索パスを定義する

7.4　JP1ユーザー仮定機能の設定

7.4.1　JP1ユーザー仮定機能の設定手順

7.4.2　JP1ユーザー仮定機能の注意事項

7.5　エージェント自動定義機能で作成されるキュー属性値をカスタマイズする設定

7.6　ユーザープロファイルを必要とするジョブを実行するための設定

7.7　ジョブ情報削除処理に関する設定

7.7.1　ジョブ情報削除処理非同期オプションの設定

7.7.2　ジョブ情報の保存時間の設定

7.7.3　JP1/AJS2起動時にジョブ情報削除処理を抑止する設定

7.8　イベントジョブのログサイズの設定の変更

7.9　イベント順序保証オプションの設定

7.10　キューレスジョブ環境でユーザープロファイルを必要とするジョブを実行するための設定

7.11　ジョブの標準出力と標準エラー出力を同時に確認する設定

7.12　ファイル監視ジョブの状態引き継ぎオプションの設定

7.13　「"（ダブルクォーテーションマーク）」を含むデータをイベントジョブの引き継ぎ情報に使用するための設定

7.14　イベントジョブを使用したDNS運用時にFQDN形式で運用するための設定

7.15　キューレスジョブ環境でクラスを指定したジョブを実行するための設定

7.16　ファイル受信制限をするための設定

7.17　ジョブの結果ファイルの再送間隔・再送回数の変更

7.18　ジョブ結果ファイルの二重受信防止の設定

7.19　TCP/IP通信接続エラーのリトライ間隔・回数の変更

7.20　ジョブを配信するエージェントホストの決定方式の設定

7.21　マクロ変数の展開失敗時の動作の設定

7.22　マクロ変数の引き継ぎ情報がNULL文字列の場合の置き換え方法の設定

7.23　ファイルおよびフォルダの変更方法

7.24　エージェントの障害回復待ち時間を短縮する設定方法

7.25　新規インストール後に以前のバージョンの設定に戻す方法

7.25.1　JP1/AJS2 - Managerの設定を以前のバージョンの設定に戻す

7.25.2　JP1/AJS2 - Agentの設定を以前のバージョンの設定に戻す

7.26　ジョブ実行時にアクセストークンを再利用するための設定

7.27　ジョブ実行多重度到達を確認するメッセージを出力する設定

7.28　WOW64環境でジョブを実行する際にファイルシステムリダイレクトを無効にする設定

7.29　キューレスジョブが戻り値128で異常検出終了となる問題を回避するための設定

7.30　サブミットジョブの実行順序の入れ替わりを防止する設定

7.31　ジョブ情報列挙時にジョブ実行制御マネージャー（jpqman）のメモリー消費量を少なくする設定

7.32　ジョブ実行制御のマネージャープロセスに対する通信タイムアウト時間の変更

7.33　JP1/AJS2のサービスが停止してもイベントジョブの実行を継続させる設定

7.34　サービスの依存関係の解除・再設定

7.35　イベント・アクション制御エージェント起動通知の送信に失敗した場合に再送を行う設定

7.36　拡張子が4バイト以上の実行ファイルのジョブを実行するための設定

7.37　エージェントホスト名の名前解決オプションの設定

7.38　イベント・アクション制御のプロセス間通信でのデータ到着待ちタイムアウト化オプションの設定

7.39　ジョブ実行時のログオンリトライを変更する設定

7.40　イベントジョブを実行する場合のマネージャーホスト名を固定化する設定

7.41　システム環境変数とジョブ定義の環境変数が重複した場合にジョブ定義の環境変数を有効にするための設定

8.　ログ情報の採取

8.1　ログ情報の採取方法

9.　クラスタシステム運用時のセットアップ

9.1　クラスタ運用の前提

9.2　クラスタ運用の概要

9.2.1　基本的な運用方法

9.3　クラスタシステム運用時のインストールとセットアップ

9.3.1　クラスタ運用時のインストール

9.3.2　クラスタ運用時のセットアップ

9.3.3　クラスタ運用時の組み込みDBのインストール（JP1/AJS2 - Manager）

9.3.4　クラスタ運用時の組み込みDBのセットアップ（JP1/AJS2 - Manager）

9.3.5　クラスタ運用時の監視方法

9.4　クラスタ運用の環境設定

9.4.1　クラスタシステムの環境設定の項目

9.4.2　クラスタシステムの環境設定の手順

9.4.3　共通定義情報変更時の作業

9.4.4　クラスタソフトへの登録

9.4.5　キューレスジョブ実行環境の設定

9.4.6　論理ホストの削除

9.4.7　論理ホストのスケジューラーサービスの多重起動の設定

9.5　クラスタ運用時の注意事項

10.　アンインストール

10.1　JP1/Baseのアンインストール

10.2　JP1/AJS2シリーズプログラムのアンインストール

10.3　組み込みDBのアンインストール

第2編　UNIXホスト編

11.　システム構成の種類とセットアップの手順

11.1　JP1/AJS2シリーズプログラムと適用OS

11.2　JP1/AJS2のセットアップ手順の概要

11.2.1　JP1/AJS2 - ManagerとJP1/AJS2 - Viewでシステムを構築する場合のセットアップ手順

11.2.2　1台のJP1/AJS2 - Managerホストを使ったマネージャー・エージェント構成にする場合のセットアップ手順

11.2.3　複数のJP1/AJS2 - Managerを使ったマネージャー・エージェント構成にする場合のセットアップ手順

12.　インストール

12.1　JP1/AJS2シリーズプログラムのインストール前に必要な作業

12.1.1　JP1/Baseをインストールする

12.2　JP1/AJS2シリーズプログラムのインストール

12.2.1　インストール時の注意事項

12.2.2　HP-UXの場合のインストール

12.2.3　Solarisの場合のインストール

12.2.4　AIXの場合のインストール

12.2.5　Linuxの場合のインストール

12.3　組み込みDBのインストール

13.　セットアップ

13.1　JP1/AJS2 - Managerで必要なセットアップ

13.1.1　JP1/Baseのセットアップ

13.1.2　JP1/AJS2 - Managerのセットアップ

13.2　JP1/AJS2 - Agentで必要なセットアップ

13.2.1　JP1/Baseのセットアップ

13.2.2　JP1/AJS2 - Agentのセットアップ

13.3　JP1/AJS2 Consoleで必要なセットアップ

13.3.1　JP1/AJS2 Console Managerのセットアップ

13.3.2　JP1/AJS2 Console Agentのセットアップ

13.4　システムおよびユーザー環境で必要なセットアップ

13.4.1　言語環境の設定

13.4.2　ログインスクリプトの変更

13.4.3　カーネルパラメーターの調整

13.4.4　トレースログファイルの拡張

13.4.5　通信環境の設定

13.4.6　ジョブ実行環境の構成定義情報を変更する

13.5　そのほかの注意事項

13.5.1　ジョブ実行制御で使用する共有メモリーについて

14.　環境設定

14.1　スケジューラーサービス環境の設定

14.1.1　スケジューラーサービス環境の設定手順

14.1.2　スケジューラーサービス環境設定ファイルの環境設定パラメーター一覧

14.1.3　スケジューラーサービス環境設定パラメーターの定義内容

14.2　ジョブ実行環境の設定

14.2.1　ジョブ実行環境の設定手順

14.2.2　マネージャー環境（JP1/AJS2 - Manager）で設定する内容

14.2.3　エージェント環境（JP1/AJS2 - Agent）で設定する内容

14.3　イベント起動に関する環境の設定

14.3.1　イベントジョブ起動に関する環境の設定手順

14.3.2　マネージャー環境（JP1/AJS2 - Manager）で設定する内容

14.3.3　エージェント環境（JP1/AJS2 - Agent）で設定する内容

14.4　キューレスジョブ実行環境の設定

14.4.1　キューレスジョブ実行環境の設定手順

14.4.2　キューレスジョブ実行環境設定ファイルの環境設定パラメーター一覧

14.4.3　キューレスジョブ実行環境設定ファイルの環境設定パラメーターの定義内容

14.5　JP1/AJS2 Console環境の設定

14.5.1　JP1/AJS2 Console Manager環境の設定

14.5.2　JP1/AJS2 Console Agent環境の設定

14.6　JP1/AJS2共通情報の設定

14.7　そのほかの設定

14.7.1　スケジューラーサービスの多重起動の設定

14.7.2　JP1/AJS2サービスの自動起動および自動終了の設定

14.7.3　ISAMファイル自動再編成機能の設定

14.7.4　スケジューラーサービスの統合トレースログ出力レベルの変更

14.7.5　ネストジョブネット定義パラメーター出力時のスケジュールルールの出力方法の変更

14.7.6　スケジューラートレースログファイルの名称変更

14.7.7　JP1/AJS2 - Managerの運用方法をサブミットジョブの登録や操作に限定するときの設定

14.7.8　サスペンド機能の設定

14.7.9　登録解除や保存世代数管理による世代削除処理方式の変更

14.7.10　スケジューラーサービスをウォームスタートで起動させたときに，実行中であったジョブまたはジョブネットの終了メッセージ，および終了イベントの出力有無の設定

14.7.11　JP1/AJS2定義内容の事前チェック機能の設定

14.7.12　ジョブネットコネクタで異なるスケジューラーサービス間のルートジョブネットの実行順序を制御するための設定

15.　スケジューラーデータベースに組み込みDBを使用する場合のセットアップ

15.1　組み込みDBを使用する場合の準備

15.1.1　前提条件

15.1.2　組み込みDBのセットアップ手順

15.1.3　組み込みDB稼働環境と運用方法の検討

15.2　組み込みDBのセットアップ

15.2.1　組み込みDBのインストール

15.2.2　組み込みDB環境の構築

15.2.3　組み込みDBへの移行

15.2.4　複数スケジューラーデータベースの組み込みDBへの移行

15.2.5　組み込みDBの再セットアップ

15.3　クラスタ構成時の実行系組み込みDBのセットアップ

15.3.1　組み込みDBのインストール

15.3.2　組み込みDB環境の構築

15.3.3　組み込みDBへの移行

15.3.4　複数スケジューラーデータベースの組み込みDBへの移行

15.3.5　組み込みDBの再セットアップ

15.4　クラスタ構成時の待機系組み込みDBのセットアップ

15.4.1　組み込みDBのインストール

15.4.2　組み込みDB環境の構築

15.4.3　組み込みDBへの移行

15.4.4　複数スケジューラーデータベースの組み込みDBへの移行

15.4.5　組み込みDBの再セットアップ

15.5　クラスタ構成時の組み込みDBの設定変更

15.6　組み込みDBのクラスタソフトへの登録

16.　運用形態に合わせた各種設定

16.1　ジョブ実行時のワークパスを変数として定義する

16.2　転送元ファイルの検索パスを定義する

16.3　JP1ユーザー仮定機能の設定

16.3.1　JP1ユーザー仮定機能の設定手順

16.3.2　JP1ユーザー仮定機能の注意事項

16.4　エージェントのパイプ通信タイムアウト値の変更

16.5　ジョブプロセス実行準備完了通知時のタイムアウト値の設定

16.6　イベントジョブのログサイズの設定の変更

16.7　イベント順序保証オプションの設定

16.8　ファイル監視ジョブの状態引き継ぎオプションの設定

16.9　「"（ダブルクォーテーションマーク）」を含むデータをイベントジョブの引き継ぎ情報に使用するための設定

16.10　ジョブの標準出力と標準エラー出力を同時に確認する設定

16.11　イベントジョブを使用したDNS運用時にFQDN形式で運用するための設定

16.12　キューレスジョブ環境でクラスを指定したジョブを実行するための設定

16.13　ファイル受信制限をするための設定

16.14　ジョブ・イベントジョブのエラーメッセージをsyslogに出力するための設定

16.15　ジョブの結果ファイルの再送間隔・再送回数の変更

16.16　ジョブ結果ファイルの二重受信防止の設定

16.17　TCP/IP通信接続エラーのリトライ間隔・回数の変更

16.18　ジョブを配信するエージェントホストの決定方式の設定

16.19　マクロ変数の展開失敗時の動作の設定

16.20　マクロ変数の引き継ぎ情報がNULL文字列の場合の置き換え方法の設定

16.21　ラージファイルを監視するための設定

16.22　エージェントの障害回復待ち時間を短縮する設定方法

16.23　ジョブ情報削除処理に関する設定

16.23.1　ジョブ情報削除処理非同期オプションの設定

16.23.2　ジョブ情報の保存時間の設定

16.23.3　JP1/AJS2起動時にジョブ情報削除処理を抑止する設定

16.24　新規インストール後に以前のバージョンの設定に戻す方法

16.24.1　JP1/AJS2 - Managerの設定を以前のバージョンの設定に戻す

16.24.2　JP1/AJS2 - Agentの設定を以前のバージョンの設定に戻す

16.25　ジョブ実行多重度到達を確認するメッセージを出力する設定

16.26　JP1/AJS2から起動される子プロセスを，SIGCHLDシグナルを受信する設定（SIG_DFL）に変更する方法

16.27　サブミットジョブの実行順序の入れ替わりを防止する設定

16.28　ジョブ情報列挙時にジョブ実行制御マネージャー（jpqman）のメモリー消費量を少なくする設定

16.29　ジョブ実行制御のマネージャープロセスに対する通信タイムアウト時間の変更

16.30　JP1/AJS2のサービスが停止してもイベントジョブの実行を継続させる設定

16.31　イベント・アクション制御エージェント起動通知の送信に失敗した場合に再送を行う設定

16.32　ジョブ実行時のファイル権限チェックでアクセス制御リストやセカンダリーグループの設定を有効にする

16.33　エージェントホスト名の名前解決オプションの設定

16.34　イベント・アクション制御のプロセス間通信でのデータ到着待ちタイムアウト化オプションの設定

16.35　イベントジョブを実行する場合のマネージャーホスト名を固定化する設定

16.36　エージェント自動定義機能で作成されるキュー属性値をカスタマイズする設定

16.37　ユーザー情報取得時のリトライを変更する設定

17.　ログ情報の採取

17.1　ログ情報の採取方法

18.　クラスタシステム運用時のセットアップ

18.1　クラスタ運用の前提

18.2　クラスタ運用の概要

18.2.1　基本的な運用方法

18.3　クラスタシステム運用時のインストールとセットアップ

18.3.1　クラスタ運用時のインストール

18.3.2　クラスタ運用時のセットアップ

18.3.3　クラスタ運用時の組み込みDBのインストール（JP1/AJS2 - Manager）

18.3.4　クラスタ運用時の組み込みDBのセットアップ（JP1/AJS2 - Manager）

18.3.5　クラスタ運用時の監視方法

18.4　クラスタ運用の環境設定

18.4.1　クラスタシステムの環境設定の項目

18.4.2　クラスタシステムの環境設定の手順

18.4.3　共通定義情報変更時の作業

18.4.4　クラスタソフトへの登録

18.4.5　キューレスジョブ実行環境の設定

18.4.6　論理ホストの削除

18.4.7　論理ホストのスケジューラーサービスの多重起動の設定

18.4.8　論理ホスト環境のJP1/AJS2の起動および終了を制御する設定

18.5　クラスタ運用時の注意事項

19.　アンインストール

19.1　JP1/Baseのアンインストール

19.2　JP1/AJS2シリーズプログラムのアンインストール

19.2.1　HP-UXの場合のアンインストール

19.2.2　Solarisの場合のアンインストール

19.2.3　AIXの場合のアンインストール

19.2.4　Linuxの場合のアンインストール

19.3　組み込みDBのアンインストール

第3編　セットアップコマンド編

20.　セットアップ時に使用するコマンド

コマンドの記述形式

環境変数一覧

セットアップ時に使用するコマンド一覧

ajs_adapter_setup

ajscasetup（Windows限定）

ajschksetup

ajscmsetup（Windows限定）

ajscvsetup

ajsembdbbuild

ajsembdbrpsetup

ajsembdbidlist

ajsembdbsetup

ajsembdbunset

ajsembdbvrupd

ajsovsetup

ajsqlsetup

ajssetup

ajssosetup

ajswoarelsetup

jp1ajs2_setup（UNIX限定）

jp1ajs2_setup_cluster（UNIX限定）

jp1ajs2casetup（UNIX限定）

jp1ajs2cmsetup（UNIX限定）

jpomailrecv（UNIX限定）

jpqexport

jpqimport

jpqregguestuser

jpqreguser

jpqshmake（UNIX限定）

付録

付録A　インストールおよびセットアップ時の作業チェック

付録A.1　インストールおよびセットアップ時のチェックリスト（Windowsホストの場合）

付録A.2　インストールおよびセットアップ時のチェックリスト（UNIXホストの場合）

付録B　環境変数および環境変数ファイルを定義する場合の注意事項

付録B.1　環境変数を定義するときの注意事項

付録B.2　環境変数ファイルを定義するときの注意事項

付録C　Oracleデータベースの移行

付録D　HiRDBからのデータベースの移行

付録D.1　HiRDBデータベース移行ツールの内容

付録D.2　HiRDBデータベース移行ツールを使用したHiRDBデータベースの移行手順

付録D.3　HiRDBから組み込みDBに移行する場合に注意すること

付録E　誤った環境設定パラメーターを設定したときの回復方法

付録E.1　Windowsの場合

付録E.2　UNIXの場合

付録F　08-00以降で設定する環境設定項目の推奨値

付録G　各バージョンの変更内容

付録G.1　08-50の変更内容

付録G.2　08-10の変更内容

付録G.3　08-00の変更内容

付録G.4　07-50の変更内容

付録G.5　07-11の変更内容

付録G.6　07-10の変更内容

付録G.7　07-00の変更内容

付録H　（3020-3-K23-43）の変更内容

付録I　用語解説

索引

[他社商品名称に関する表示]

Copyright (C) 2006, 2010, Hitachi, Ltd.
Copyright (C) 2006, 2010, Hitachi Software Engineering Co., Ltd.

前書き

■ 対象製品

適用OSのバージョン，JP1/Automatic Job Management System 2が前提とするサービスパックやパッチなどの詳細については，リリースノートで確認してください。

適用OS：Windows Server 2003，Windows Server 2003（x64）

P-2412-3K84　 JP1/Automatic Job Management System 2 - Manager　 08-50

適用OS：Windows 2000，Windows Server 2003，Windows Server 2003（x64）

P-2412-3384　 JP1/Automatic Job Management System 2 - Agent　 08-50

適用OS：Windows XP Professional，Windows Server 2003，Windows Server 2003（x64）

P-2412-3484　 JP1/Automatic Job Management System 2 - View　 08-50

適用OS：Windows XP Professional，Windows Server 2003，Windows Server 2003（x64）

P-242C-6L84　 JP1/Base　 08-50

適用OS：Windows Server 2003（IPF）

P-2812-3K84　 JP1/Automatic Job Management System 2 - Manager　 08-50
P-2812-3384　 JP1/Automatic Job Management System 2 - Agent　 08-50
P-282C-6L84　 JP1/Base　 08-50

適用OS：Windows Server 2008

P-2A12-3K84　 JP1/Automatic Job Management System 2 - Manager　 08-50
P-2A12-3384　 JP1/Automatic Job Management System 2 - Agent　 08-50

適用OS：Windows Vista，Windows Server 2008

P-2A12-3484　 JP1/Automatic Job Management System 2 - View　 08-50
P-2A2C-6L84　 JP1/Base　 08-50

適用OS：Windows Server 2008（IPF）

P-2D12-3K84　 JP1/Automatic Job Management System 2 - Manager　 08-50
P-2D12-3384　 JP1/Automatic Job Management System 2 - Agent　 08-50
P-2D2C-6L84　 JP1/Base　 08-50

適用OS：HP-UX（PA-RISC）

P-1B12-2781　 JP1/Automatic Job Management System 2 - Manager　 08-50
P-1B12-2981　 JP1/Automatic Job Management System 2 - Agent　 08-50
P-1B2C-6L81　 JP1/Base　 08-50

適用OS：HP-UX（IPF）

P-1J12-2781　 JP1/Automatic Job Management System 2 - Manager　 08-50
P-1J12-2981　 JP1/Automatic Job Management System 2 - Agent　 08-50
P-1J2C-6L81　 JP1/Base　 08-50

適用OS：Solaris

P-9312-2781　 JP1/Automatic Job Management System 2 - Manager　 08-50
P-9312-2981　 JP1/Automatic Job Management System 2 - Agent　 08-50
P-9D2C-6L81　 JP1/Base　 08-50

適用OS：AIX

P-1M12-2781　 JP1/Automatic Job Management System 2 - Manager　 08-50
P-1M12-2981　 JP1/Automatic Job Management System 2 - Agent　 08-50
P-1M2C-6L81　 JP1/Base　 08-50

適用OS：Linux 5（x86），Linux AS 4（x86），Linux ES 4（x86），Linux 5（AMD64 & Intel EM64T），Linux AS 4（AMD64 & Intel EM64T），Linux ES 4（AMD64 & Intel EM64T）

P-9S12-3781　 JP1/Automatic Job Management System 2 - Manager　 08-50
P-9S12-3981　 JP1/Automatic Job Management System 2 - Agent　 08-50
P-9S2C-7L81　 JP1/Base　 08-50

適用OS：Linux 5（IPF），Linux AS 4（IPF）

P-9V12-2781　 JP1/Automatic Job Management System 2 - Manager　 08-50
P-9V12-2981　 JP1/Automatic Job Management System 2 - Agent　 08-50
P-9V2C-6L81　 JP1/Base　 08-50

■ 輸出時の注意

本製品を輸出される場合には，外国為替および外国貿易法ならびに米国の輸出管理関連法規などの規制をご確認の上，必要な手続きをお取りください。
なお，ご不明な場合は，弊社担当営業にお問い合わせください。

■ 商標類

400は，米国およびその他の国におけるInternational Business Machines Corporationの商標です。
Active Directoryは，米国Microsoft Corporationの，米国およびその他の国における登録商標または商標です。
Adobeは，Adobe Systems Incorporated（アドビシステムズ社）の米国ならびに他の国における商標または登録商標です。
AIXは，米国およびその他の国におけるInternational Business Machines Corporationの商標です。
AS/400は，米国およびその他の国におけるInternational Business Machines Corporationの商標です。
CONNECT：Queueは，米国でのSterling Commerce,Inc.の登録商標です。
GIFは，米国CompuServe Inc.が開発したフォーマットの名称です。
HP NonStop Serverは，ヒューレット・パッカード社の商標です。
HP-UXは，米国Hewlett-Packard Companyのオペレーティングシステムの名称です。
INS-Cは，日本電信電話（株）のサービス名称です。
INS-Pは，日本電信電話（株）のサービス名称です。
Internet Explorerは，米国Microsoft Corporationの米国及びその他の国における登録商標または商標です。
Itaniumは，アメリカ合衆国およびその他の国におけるIntel Corporationの商標です。
Javaは，Oracle Corporation 及びその子会社，関連会社の米国 及びその他の国における登録商標または商標です。
Linuxは，Linus Torvalds氏の日本およびその他の国における登録商標または商標です。
Lotus Notesは，IBM Corporationの登録商標です。
Microsoftは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
Microsoft Excelは，米国Microsoft Corp.の商品名称です。
Microsoft Exchange Serverは，米国Microsoft Corp.の商品名称です。
Microsoft Mailは，米国Microsoft Corp.の商品名称です。
Microsoft Office Excelは，米国 Microsoft Corporation の商品名称です。
Microsoft SQL Serverは，米国Microsoft Corp.の商品名称です。
MQSeriesは，米国およびその他の国におけるInternational Business Machines Corporationの商標です。
MSPは，富士通株式会社の登録商標です。
MVSは，米国およびその他の国におけるInternational Business Machines Corporationの商標です。
Netscapeは，米国およびその他の国におけるNetscape Communications Corporationの登録商標です。
Netscape Navigatorは，米国およびその他の国におけるNetscape Communications Corporationの登録商標です。
OpenViewは，ヒューレット・パッカード社の商標です。
ORACLEは，Oracle Corporation 及びその子会社，関連会社の米国 及びその他の国における登録商標または商標です。
Outlookは，米国およびその他の国における米国Microsoft Corp.の登録商標です。
PA-RISCは，米国Hewlett-Packard Companyの商標です。
Pentiumは，アメリカ合衆国およびその他の国におけるIntel Corporationの商標です。
R/3は，SAP AGのドイツ及びその他の国における登録商標または商標です。
Red Hatは，米国およびその他の国でRed Hat,Inc. の登録商標若しくは商標です。
SAPは，SAP AGのドイツ及びその他の国における登録商標または商標です。
Solarisは，Oracle Corporation 及びその子会社，関連会社の米国 及びその他の国における登録商標または商標です。
SQL*Plusは，Oracle Corporation 及びその子会社，関連会社の米国 及びその他の国における登録商標または商標です。
UNIXは，The Open Groupの米国ならびに他の国における登録商標です。
Windowsは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
Windows Serverは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
Windows Vistaは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
活文，PDFstaffは，日立ソフトウェアエンジニアリング株式会社の登録商標です。
プログラムプロダクト「P-9312-2781」，「P-9312-2981」，「P-9D2C-6L81」には，米国Sun Microsystems, Inc.が著作権を有している部分が含まれています。
プログラムプロダクト「P-9312-2781」，「P-9312-2981」，「P-9D2C-6L81」には，UNIX System Laboratories, Inc.が著作権を有している部分が含まれています。

■ ［スコープ］ウィンドウの背景として添付している日本地図データの著作権等についての注意

この地図の作成に当たっては，国土地理院の承認を得て，同院発行の数値地図25000（行政界・海岸線）を使用したものです。（承認番号 平21業使，第124号）
国土地理院の承認は，統合システム運用管理プログラム（JP1）（以下「本製品」という。）における使用に限られています。この地図の画像を本製品とは別に利用すること等この地図を本製品以外に利用することを禁じます。
また，地図を含む本製品は，著作権法により保護されています。
地図を翻案・改変等著作権を侵害する行為を行なうことを禁じます。
地図著作・制作者 株式会社 日立製作所 ソフトウェア事業部
All Rights Reserved. Copyright (C) 2009, Hitachi, Ltd.

■ 発行

2006年6月（第1.1版）3020-3-K23-01
2010年9月（第3.3版）3020-3-K23-43

■ 著作権

Copyright (C) 2006, 2010, Hitachi, Ltd.
Copyright (C) 2006, 2010, Hitachi Software Engineering Co., Ltd.

変更内容

変更内容（3020-3-K23-43）

追加・変更内容 | 変更個所
記載内容を変更した。詳細は，付録Hを参照のこと。 | 付録H

単なる誤字・脱字などはお断りなく訂正しました。

はじめに

このマニュアルは，JP1/Automatic Job Management System 2（以降，JP1/AJS2と省略します）のインストールおよびセットアップの方法を説明したものです。

対象読者

JP1/AJS2をインストールおよびセットアップしたい方を対象としています。

マニュアルの構成

このマニュアルは，次に示す三つの編から構成されています。なお，このマニュアルは各OS（Operating System）に共通のマニュアルです。OSごとに差異がある場合は，本文中でそのつど内容を書き分けています。

第1編 Windowsホスト編

WindowsホストでのJP1/AJS2のインストールとセットアップについて説明しています。

第2編 UNIXホスト編

UNIXホストでのJP1/AJS2のインストールとセットアップについて説明しています。

第3編 セットアップコマンド編

JP1/AJS2のセットアップ時に使用するコマンドを説明しています。

関連マニュアル

このマニュアルの関連マニュアルを次に示します。必要に応じてお読みください。

JP1/AJS2関連

JP1 Version 8 JP1/Automatic Job Management System 2 解説（3020-3-K21）

JP1 Version 8 JP1/Automatic Job Management System 2 設計・運用ガイド（3020-3-K22）

JP1 Version 8 JP1/Automatic Job Management System 2 操作ガイド（3020-3-K24）

JP1 Version 8 JP1/Automatic Job Management System 2 コマンドリファレンス（3020-3-K25）

JP1 Version 8 JP1/Automatic Job Management System 2 連携ガイド（3020-3-K27）

JP1 Version 8 JP1/Automatic Job Management System 2 メッセージ（3020-3-K28）

JP1 Version 8 JP1/Automatic Job Management System 2 - Print Option（3020-3-K36）

JP1 Version 8 JP1/Automatic Job Management System 2 - Definition Assistant（3020-3-K37）

JP1 Version 8 JP1/Automatic Job Management System 2 - Web Operation Assistant（3020-3-K38）

JP1 Version 8 JP1/Automatic Job Management System 2 - Datareplicator（3020-3-K39）

JP1 Version 8 JP1/Automatic Job Management System 2 - Configuration（3020-3-K41）

JP1 Version 8 JP1/Automatic Job Management System 2 - Scenario Operation（3020-3-K42）

JP1 Version 8 JP1/Automatic Job Management System 2 for Web Service（3020-3-K43）

JP1 Version 8 JP1/Automatic Job Management System 2 for 活文PDFstaff Option（3020-3-K44）

JP1 Version 8 JP1/Automatic Job Management System 2 for Enterprise Applications（3020-3-K51）

JP1 Version 7i JP1/Automatic Job Management System 2 for Oracle E-Business Suite（3020-3-F27）

JP1 Version 8 JP1/Automatic Job Management System 2 メインフレーム 運用・操作編（3020-3-K52）

JP1 Version 8 JP1/Automatic Job Management System 2 メインフレーム リファレンス編（3020-3-K53）

JP1関連

JP1 Version 8 JP1/Base 運用ガイド（3020-3-K06）

JP1 Version 8 JP1/Base メッセージ（3020-3-K07）

JP1 Version 8 JP1/Base 機能拡張（3020-3-K08）

JP1 Version 8 JP1/Integrated Management - Manager システム構築・運用ガイド（3020-3-K01）

JP1 Version 8 JP1/Integrated Management - Manager リファレンス（3020-3-K02）

JP1 Version 8 JP1/Integrated Management - Manager 機能拡張編（3020-3-K03）

JP1 Version 8 JP1/Integrated Management - Planning Operation（3020-3-K13）

JP1 Version 8 JP1/Power Monitor（3020-3-K54）

JP1 Version 8 JP1/NETM/DM　導入・設計ガイド(Windows(R)用)（3020-3-L36）

JP1 Version 8 JP1/NETM/DM　構築ガイド(Windows(R)用)（3020-3-L37）

JP1 Version 8 JP1/NETM/DM　運用ガイド1(Windows(R)用)（3020-3-L38）

JP1 Version 8 JP1/NETM/DM　運用ガイド2(Windows(R)用)（3020-3-L39）

JP1 Version 8 JP1/NETM/DM Automatic Installation Toolガイド(Windows(R)用)（3020-3-L40）

JP1 Version 8 JP1/NETM/DM Administrator Kit（3020-3-L41）

JP1 Version 8 JP1/NETM/DM SubManager(UNIX(R)用)（3020-3-L42）

JP1 Version 8 JP1/NETM/DM Client(UNIX(R)用)（3020-3-L43）

JP1 Version 8 JP1/NETM/DM APIリファレンス(UNIX(R)用)（3020-3-L44）

JP1 Version 6 JP1/NETM/DM Manager（3000-3-841）

JP1 Version 8 JP1/Performance Management - Agent Option for JP1/AJS2（3020-3-K75）

JP1 Version 8 JP1/Cm2/Network Node Manager ネットワーク管理ガイド（3020-3-L01）

JP1 Version 8 JP1/Cm2/Extensible SNMP Agent（3020-3-L04）

JP1 Version 7i JP1/NQSEXEC システム管理者ガイド（3020-3-F30）

JP1 Version 7i JP1/NQSEXEC ユーザーズガイド（3020-3-F31）

JP1 Version 8 JP1/Script（Windows(R)用） （3020-3-K55）

JP1 Version 8 JP1/File Transmission Server/FTP（Windows(R)用）（3020-3-K57）

JP1 Version 8 JP1/File Transmission Server/FTP（UNIX(R)用）（3020-3-K58）

VOS3 オープンジョブウェイ支援 JP1/Open Job Entry（6190-3-365）

VOS1/FS オープンジョブウェイ支援 for VOS1（6150-3-377）

VOSK/FS オープンジョブウェイ支援 for VOSK（650-3-416）

MVS オープンジョブウェイ支援 JP1/Open Job Entry（9000-3-365）

OSIV/MSP オープンジョブウェイ支援 JP1/Open Job Entry（9000-3-366）

JP1 Version 6 JP1/Open Job Entry for Midrange Computer（9000-3-367）

メッセージキュー連携関連

OpenTP1 Version 5 分散アプリケーションサーバ TP1/LiNK 使用の手引（3000-3-390）

OpenTP1 Version 5 分散トランザクション処理機能 OpenTP1 プログラム作成の手引（3000-3-361）

OpenTP1 Version 5 分散トランザクション処理機能 OpenTP1 システム定義（3000-3-362）

OpenTP1 Version 5 分散トランザクション処理機能 OpenTP1 運用と操作（3000-3-363）

OpenTP1 Version 5 分散トランザクション処理機能 OpenTP1 プログラム作成リファレンス C言語編（3000-3-365）

OpenTP1 Version 5 分散トランザクション処理機能 OpenTP1 メッセージキューイング機能 TP1/Message Queue 使用の手引（3000-3-711）

OpenTP1 Version 5 分散トランザクション処理機能 OpenTP1 メッセージキューイング機能 TP1/Message Queue MQI解説・文法編（3000-3-712）

読書手順

このマニュアルは，利用目的に合わせて章を選択して読むことができます。利用目的別にお読み頂くことをお勧めします。

マニュアルを読む目的 | 記述個所
インストールとセットアップの全体的な流れを知りたい。 | 1章，11章，付録
インストール作業の内容や手順を知りたい。 | 2章，12章
セットアップ時の作業内容や手順を知りたい。 | 3章，13章
環境設定に必要な手順や設定する内容について知りたい。 | 4章，14章，6章，付録
組み込みDBをセットアップする手順を知りたい。 | 5章，15章
運用形態に合わせた各種設定方法について知りたい。 | 3章～7章，13章～16章，付録
ログ情報を採取する方法を知りたい。 | 8章，17章
クラスタシステム運用をするときのセットアップについて知りたい。 | 9章，18章
アンインストール作業の手順を知りたい。 | 10章，19章
セットアップ時に使用するコマンドの内容を知りたい。 | 20章

このマニュアルでの表記

このマニュアルでは，日立製品およびその他の製品の名称を省略して表記しています。また，英略語を使用しています。正式名称と，このマニュアルでの表記を次の表に示します。

正 式 名 称 | このマニュアルでの表記
JP1/Automatic Job Management System 2 - Manager | JP1/AJS2 - Manager | JP1/AJS2
JP1/Automatic Job Management System 2 - Agent | JP1/AJS2 - Agent
JP1/Automatic Job Management System 2 - View | JP1/AJS2 - View
JP1/Automatic Job Management System 2 - Advanced Manager※1 | JP1/AJS2 - Advanced Manager
JP1/Automatic Job Management System 2 - Light Edition※1 | JP1/AJS2 - Light Edition
JP1/Automatic Job Management System 2 - Client Toolkit※1 | JP1/AJS2 - Client Toolkit
JP1/Automatic Job Management System 2 - Datareplicator | JP1/AJS2 - Datareplicator
JP1/Automatic Job Management System 2 - Configuration | JP1/AJS2 - Configuration
JP1/Automatic Job Management System 2 - Definition Assistant | JP1/AJS2 - Definition Assistant
JP1/Automatic Job Management System 2 - Web Operation Assistant | JP1/AJS2 - Web Operation Assistant
JP1/Automatic Job Management System 2 - Scenario Operation Manager | JP1/AJS2 - Scenario Operation Manager | JP1/AJS2 - Scenario Operation
JP1/Automatic Job Management System 2 - Scenario Operation View | JP1/AJS2 - Scenario Operation View
JP1/Automatic Job Management System 2 - Manager for Mainframe | JP1/AJS2 - Manager for Mainframe | JP1/AJS2 for Mainframe
JP1/Automatic Job Management System 2 - Agent for Mainframe | JP1/AJS2 - Agent for Mainframe
JP1/Automatic Job Management System 2 - View for Mainframe | JP1/AJS2 - View for Mainframe
JP1/Automatic Job Management System 2 for Enterprise Applications | JP1/AJS2 for Enterprise Applications
JP1/Automatic Job Management System 2 for Oracle E-Business Suite | JP1/AJS2 for Oracle E-Business Suite
JP1/Automatic Job Management System 2 for Web Service | JP1/AJS2 for Web Service | JP1/AJS2 for Web Service
JP1/Automatic Job Management System 2 - View for Web Service※2 | JP1/AJS2 - View for Web Service
JP1/Automatic Job Management System 2 for 活文PDFstaff Option | JP1/AJS2 for 活文PDFstaff
JP1/Cm2/Network Node Manager | JP1/Cm2/NNM | NNM
hp OpenView Network Node Manager | hp OpenView NNM
JP1/File Transmission Server/FTP | JP1/FTP
JP1/Integrated Management - Manager | JP1/IM - Manager | JP1/IM
JP1/Integrated Management - View | JP1/IM - View
JP1/Integrated Manager - View※1
JP1/Integrated Manager - Central Console※1 | JP1/IM - Central Console
JP1/Integrated Manager - Central Scope※1 | JP1/IM - Central Scope
JP1/Integrated Management - Planning Operation | JP1/IM - Planning Operation
JP1/Open Job Entry | JP1/OJE
JP1/Open Job Entry for Midrange Computer | JP1/OJE for Midrange Computer
JP1/System Event Service | JP1/SES
VOS3 JP1/Open Job Entry | JP1/OJE for VOS3
JP1/Automatic Job Management System 2 - SDK | JP1/AJS2 - SDK | JP1/AJS2
JP1/Automatic Job Management System 2 - Console | JP1/AJS2 - Console
Microsoft(R) Cluster Server | MSCS
Microsoft(R) Excel | Excel
Microsoft(R) Office Excel
Microsoft(R) Exchange 2000 Enterprise Server | Exchange Server
Microsoft(R) Exchange 2000 Server
Microsoft(R) Exchange Server
Microsoft(R) Internet Explorer(R) | IE
Microsoft(R) Mail | Microsoft Mail
Microsoft(R) Message Queue Server | MSMQ
Microsoft(R) Outlook(R) 2000 | Outlook 2000 | Outlook
Microsoft(R) Outlook(R) 2002 | Outlook 2002
Microsoft(R) Outlook(R) 2003 | Outlook 2003
Microsoft(R) Outlook(R) 2007 | Outlook 2007
Microsoft(R) Outlook(R) Express | Outlook Express
Microsoft(R) SQL Server | Microsoft SQL Server
Microsoft(R) SQL Server Enterprise Edition
Microsoft(R) Windows(R) 2000 Advanced Server Operating System | Windows 2000
Microsoft(R) Windows(R) 2000 Professional Operating System
Microsoft(R) Windows(R) 2000 Server Operating System
Microsoft(R) Windows Server(R) 2003, Enterprise Edition | Windows Server 2003 | Windows Server 2003
Microsoft(R) Windows Server(R) 2003, Standard Edition
Microsoft(R) Windows Server(R) 2003, Enterprise Edition for Itanium(R)-based Systems | Windows Server 2003（IPF）
Microsoft(R) Windows Server(R) 2003, Enterprise x64 Edition | Windows Server 2003（x64）
Microsoft(R) Windows Server(R) 2003, Standard x64 Edition
Microsoft(R) Windows Server(R) 2008 Enterprise | Windows Server 2008 | Windows Server 2008
Microsoft(R) Windows Server(R) 2008 Standard
Microsoft(R) Windows Server(R) 2008 for Itanium(R)-based Systems | Windows Server 2008（IPF）
Microsoft(R) Windows Vista(R) Business | Windows Vista
Microsoft(R) Windows Vista(R) Enterprise
Microsoft(R) Windows Vista(R) Ultimate
Microsoft(R) Windows(R) XP Professional Operating System | Windows XP Professional
AIX 5L 5.3 | AIX
AIX V6.1
HP-UX 11i V2 (PA-RISC) | HP-UX（PA-RISC） | HP-UX
HP-UX 11i V2 (IPF) | HP-UX（IPF）
HP-UX 11i V3 (IPF)
Red Hat Enterprise Linux 5 (AMD64 & Intel EM64T) | Linux 5（AMD64 & Intel EM64T） | Linux
Red Hat Enterprise Linux 5 (IPF) | Linux 5（IPF）
Red Hat Enterprise Linux 5 (x86) | Linux 5（x86）
Red Hat Enterprise Linux AS 4 (AMD64 & Intel EM64T) | Linux AS 4（AMD64 & Intel EM64T）
Red Hat Enterprise Linux ES 4 (AMD64 & Intel EM64T) | Linux ES 4（AMD64 & Intel EM64T）
Red Hat Enterprise Linux AS 4 (IPF) | Linux AS 4（IPF）
Red Hat Enterprise Linux AS 4 (x86) | Linux AS 4（x86）
Red Hat Enterprise Linux ES 4 (x86) | Linux ES 4（x86）
Solaris 9 | Solaris
Solaris 10
SAP Business Information Warehouse | SAP BW
SAP R/3(R) | SAP R/3

注※1

バージョン7の製品です。

注※2

JP1/AJS2 for Web Serviceに含まれるコンポーネントです。JP1/AJS2 - Viewと連携して動作します。

Windows 2000，Windows XP Professional，Windows Server 2003，Windows Server 2008，およびWindows Vistaを総称してWindowsと表記することがあります。

Linux 5（IPF），およびLinux AS 4（IPF）を総称してLinux（IPF）と表記することがあります。

HP-UX，Solaris，AIX，およびLinuxを総称して，UNIXと表記することがあります。

このマニュアルで使用する英略語

このマニュアルで使用する英略語を次に示します。

英略語 | 正式名称
ACL | Access Control List
DB | Database
DBMS | Database Management System
DNS | Domain Name System
EUC | Extended UNIX Code
FQDN | Fully Qualified Domain Name
FTP | File Transfer Protocol
GUI | Graphical User Interface
IPF | Itanium(R) Processor Family
ISAM | Indexed Sequential Access Method
JIS | Japanese Industrial Standard code
LAN | Local Area Network
MAPI | Messaging Application Programming Interface
MIB | Management Information Base
MIME | Multipurpose Internet Mail Extensions
NAT | Network Address Translator
NFS | Network File System
NIC | Network Interface Card
PDF | Portable Document Format
RDB | Relational Database
SNMP | Simple Network Management Protocol
SMTP | Simple Mail Transfer Protocol
SUP | Service Using Program
TCP/IP | Transmission Control Protocol/Internet Protocol
UAC | User Account Control
UNC | Universal Naming Convention
WAN | Wide Area Network
WOW64 | Windows On Windows 64
WSDL | Web Services Description Language

JP1 Version 8での製品体系変更について

JP1 Version 8では，JP1/AJS2の製品体系に次の変更がありました。

JP1/AJS2 - Advanced Managerは廃止されました。JP1/AJS2 - Advanced Managerが提供していた組み込みデータベースは，JP1 Version 8では，JP1/AJS2 - Managerに同梱されています。

JP1/AJS2 - Light Editionは廃止されました。

JP1/AJS2 - Client Toolkitは廃止されました。

JP1/AJS2 - Viewは，Windows版だけの提供となりました。

JP1 Version 7iでの製品体系変更について

JP1 Version 7iでは，JP1/AJS2の製品体系に次の変更がありました。

JP1/AJS2 - SDKはJP1/AJS2 - Managerに統合されました。JP1/AJS2 - SDKが提供していた関数は，JP1Version 7iでは，JP1/AJS2 - Managerが提供しています。

JP1/AJS2 - ConsoleはJP1/AJS2 - Managerに統合されました。JP1/AJS2 - Consoleで使用できた機能は，JP1/AJS2 - Managerで使用できます。

JP1/AJS2 - Light Editionは，Windows版だけの提供となりました。

マニュアルで使用する記号

このマニュアルで使用する記号を次の表に示します。

記号
意味

［　］
メニュー項目，ダイアログボックス，ダイアログボックスのボタンなどを示します。

（例）

［ファイル］－［新規作成］を選択する。

上記の例では，メニューバーの［ファイル］を選んで，プルダウンメニューの［新規作成］を選択することを示します。

コマンドの文法に使用する記号

コマンド，およびパラメーターの説明で使用する記号を次の表に示します。

記号
意味と例

|
（ストローク）
複数の項目に対して項目間の区切りを示し，「または」の意味を示します。
（例）
「A|B|C」は，「A，B，またはC」を示します。

{　}
（波括弧）
この記号で囲まれている複数の項目の中から，一組の項目を必ず選択します。項目と項目の区切りは「|」で示します。
（例）
「{A|B|C}」は，「A，B，またはCのどれかを必ず指定する」ことを示します。

[　]
（角括弧）
この記号で囲まれている項目は，任意に指定できます（省略できます）。
（例）
「[A]」は，「必要に応じてAを指定する」ことを示します（必要でない場合は，Aを省略できます）。
「[B|C]」は，「必要に応じてB，またはCを指定する」ことを示します（必要でない場合は，BおよびCを省略できます）。

...
（点線）
この記号の直前に示された項目を繰り返して複数指定できます。なお，項目を複数指定する場合は，項目の区切りに1バイトの空白文字（半角スペース）を使用します。
（例）
「A B...」は，「Aのあとに，Bを複数指定できる」ことを示します。

_
（下線）
括弧で囲まれているすべての項目を省略したときに，システムが採用する値を示します。
（例）
「[A|B]」は，「AおよびBを指定しなかった場合，システムはAを採用する」ことを示します。

数式で使用する記号

このマニュアルの数式中で使用する記号を，次の表に示します。

記号
意味

＊
乗算記号を示します。

/
除算記号を示します。

↑　　↑
計算結果の値を小数点以下で切り上げることを示します。
（例）
↑34 / 3 ↑の計算結果は12となります。

MAX
計算結果のうち，最も大きい値を選ぶことを示しています。
（例）
MAX(3＊6，4+7)の計算結果は，18となります。

図中で使用する記号

このマニュアルの図中で使用する記号を次の図に示します。

Windows版JP1/AJS2のデフォルトのインストール先フォルダ

Windows版JP1/AJS2のデフォルトのインストール先フォルダは，次のとおりです。

JP1/AJS2 - Managerのデフォルトのインストール先フォルダ

システムドライブ¥Program Files※1¥HITACHI¥JP1AJS2

および

システムドライブ¥Program Files※1¥HITACHI¥JP1AJS2CM

JP1/AJS2 - Agentのデフォルトのインストール先フォルダ

システムドライブ¥Program Files※1¥HITACHI¥JP1AJS2

JP1/AJS2 - Viewのデフォルトのインストール先フォルダ

システムドライブ¥Program Files※2¥HITACHI¥JP1AJS2V

注※1

64ビット版のWindows Server 2008およびWindows Server 2003（x64）の場合は，「Program Files」を「Program Files (x86)」と読み替えてください。

注※2

64ビット版のWindows Server 2008，Windows Vista，およびWindows Server 2003（x64）の場合は，「Program Files」を「Program Files (x86)」と読み替えてください。

このマニュアルで使用する「Administrators権限」について

このマニュアルで表記している「Administrators権限」とは，ローカルPCに対してAdministrators権限を持つユーザーを指します。ローカルPCに対してAdministrators権限を持つユーザーであれば，ローカルユーザー，ドメインユーザー，およびActiveDirectory環境で動作に違いはありません。

オンラインマニュアルについて

JP1/AJS2 - Viewでは，WWW（World Wide Web）ブラウザーで参照できるHTMLマニュアルを提供しています。HTMLマニュアルは下記ブラウザーで参照できます。

Microsoft Internet Explorer 3.02以降

Netscape Navigator 3.01以降

HTMLマニュアルの内容は，下記の紙マニュアルと同じです。

JP1 Version 8 JP1/Automatic Job Management System 2 解説

JP1 Version 8 JP1/Automatic Job Management System 2 設計・運用ガイド

JP1 Version 8 JP1/Automatic Job Management System 2 セットアップガイド

JP1 Version 8 JP1/Automatic Job Management System 2 操作ガイド

JP1 Version 8 JP1/Automatic Job Management System 2 コマンドリファレンス

JP1 Version 8 JP1/Automatic Job Management System 2 連携ガイド

JP1 Version 8 JP1/Automatic Job Management System 2 メッセージ

JP1/AJS2 - Viewでは，［ヘルプ］－［目次］を選択すると目次が表示されます。また，［F1］キーを押して目次を表示することもできます。ただし，拡張子htmのファイルにWWWブラウザーが関連づけられていない場合，HTMLマニュアルが正しく表示されません。その場合は，htmファイルとWWWブラウザーを関連づけてください。

WWWブラウザーでの文字の表示に関する注意事項

Windowsの場合，スタートメニューからオンラインマニュアルを表示させると，すでに表示されているブラウザーの画面上にHTMLマニュアルが表示されます。

また，Microsoft Internet Explorer 5をご使用の場合，文字が不正に表示されることがあります。この場合，次のように設定してください。

［表示］－［エンコード］の［自動選択］のチェックを外す。

［表示］－［エンコード］の日本語で［日本語（シフトJIS）］を選択する。

JP1/AJS2マニュアルの使い分けについて

JP1/AJS2のマニュアルは，7冊に分かれています。次に示す表で各マニュアルの記載内容をご確認の上，利用目的に合わせてマニュアルをお読みください。

マニュアル名
記載内容

JP1/Automatic Job Management System 2
解説

JP1/AJS2の特長

各機能の解説

JP1/Automatic Job Management System 2
設計・運用ガイド

システムの設計時に検討する情報

システムの運用時に知っておくべき情報

トラブルシューティング

JP1/Automatic Job Management System 2
セットアップガイド

インストール・セットアップの操作手順

JP1/Automatic Job Management System 2
操作ガイド

GUIを使った操作方法

JP1/Automatic Job Management System 2
コマンドリファレンス

コマンドの文法

JP1/Automatic Job Management System 2
連携ガイド

他製品と連携してできる機能

JP1/Automatic Job Management System 2
メッセージ

JP1/AJS2が出力するメッセージ

注

バージョン8では，マニュアル「JP1/Automatic Job Management System 2 関数」は提供していません。

このマニュアルで使用するフォルダ名またはディレクトリ名

このマニュアルでは，Windowsのフォルダ名とUNIXのディレクトリ名とが同じ場合，原則として，フォルダ名と表記しています。

JP1/AJS2で使用できる正規表現について

ダイアログボックスやコマンドでの定義で，正規表現が使用できる項目があります。Windowsでの正規表現については，マニュアル「JP1/Base 運用ガイド」を参照してください。また，UNIXでの正規表現については，UNIXのドキュメントを参照してください。

Windowsのホスト上でイベントジョブを実行する場合，JP1/Baseの設定によって使用できる正規表現が異なります。使用できる正規表現の設定方法については，マニュアル「JP1/Base 運用ガイド」の，使用する正規表現の拡張に関する説明を参照してください。

なお，正規表現で，すべての文字に一致する「.*」を多数使用すると，検索に時間が掛かることがあります。長いメッセージなどに対しては，必要な個所に対してだけ「.*」を使用するようにしてください。また，UNIXでは，空白以外の文字に一致させたい場合など，「.*」の代わりに「[^ ]*（空白以外の文字の繰り返し）」を使用すると，検索時間を短縮できます。

JIS 2004（JIS X 0213:2004）で追加された第3水準，第4水準漢字について

JP1/AJS2では，JIS 2004で追加された第3水準漢字，第4水準漢字を使用できません。これらの文字を使用した場合，正常に動作しないおそれがあります。

常用漢字以外の漢字の使用について

このマニュアルでは，常用漢字を使用することを基本としていますが，次の用語については，常用漢字以外の漢字を使用しています。

宛先（あてさき）

個所（かしょ）

栗（くり）色

毎（ごと）

進捗（しんちょく）

橙（だいだい）

同梱（どうこん）

貼（は）り付け

必須（ひっす）

閉塞（へいそく）

捕捉（ほそく）

KB（キロバイト）などの単位表記について

1KB（キロバイト），1MB（メガバイト），1GB（ギガバイト），1TB（テラバイト）はそれぞれ1,024バイト，1,024²バイト，1,024³バイト，1,024⁴バイトです。

1.　システム構成の種類とセットアップの手順

JP1/AJS2は，1台でジョブを定義・実行するシステムから，何台ものホストを使って大量のジョブを実行させる大規模なシステムまで，いろいろなシステム構成で使用できます。また，ほかの製品と連携していろいろな機能を使うこともできます。この章では，JP1/AJS2でできるシステム構成とそのセットアップの手順の概要を説明します。

＜この章の構成＞

1.1　JP1/AJS2シリーズプログラムと適用OS

1.2　JP1/AJS2のセットアップ手順の概要

1.1　JP1/AJS2シリーズプログラムと適用OS

JP1/AJS2シリーズのプログラムについて次に説明します。

JP1/AJS2 - Manager
業務の定義，管理および実行をします。1台のJP1/AJS2 - Managerに最大1,024のエージェントを接続できます。JP1/AJS2 - Manager同士を接続して使うこともできます。

JP1/AJS2 - Agent
JP1/AJS2 - Managerから実行依頼を受けた処理を実行します。JP1/AJS2 - Agentは，ジョブの実行機能のエージェントおよびイベントジョブのエージェントだけで構成されています。

JP1/AJS2 - View
JP1/AJS2 - ManagerをGUIで操作したい場合に使います。1台のJP1/AJS2 - Managerには最大128台のJP1/AJS2 - Viewを接続できます。なお，JP1/AJS2 - ViewとJP1/AJS2 - Managerを接続するときには，LANを利用することをお勧めします。

JP1/AJS2シリーズプログラムが動作するOS一覧を次の表に示します。

表1-1　JP1/AJS2シリーズプログラムが動作するOS一覧

OS名 | JP1/AJS2 - Manager | JP1/AJS2 - Agent | JP1/AJS2 - View
Windows Server 2008 | ○ | ○ | ○
Windows Server 2008（IPF） | ○ | ○ | －
Windows Vista | － | － | ○
Windows XP Professional | － | － | ○
Windows Server 2003 | ○ | ○ | ○
Windows Server 2003（IPF） | ○ | ○ | －
Windows 2000 | － | ○ | －

（凡例）

○：動作する。

－：動作しない。

JP1/AJS2 - ManagerおよびJP1/AJS2 - AgentにはJP1/Baseが必要です。

1.2　JP1/AJS2のセットアップ手順の概要

JP1/AJS2でできるシステム構成とそのセットアップの手順を次に示します。

＜この節の構成＞

1.2.1　JP1/AJS2 - ManagerとJP1/AJS2 - Viewでシステムを構築する場合のセットアップ手順

1.2.2　1台のJP1/AJS2 - Managerホストを使ったマネージャー・エージェント構成にする場合のセットアップ手順

1.2.3　複数のJP1/AJS2 - Managerを使ったマネージャー・エージェント構成にする場合のセットアップ手順

1.2.1　JP1/AJS2 - ManagerとJP1/AJS2 - Viewでシステムを構築する場合のセットアップ手順

ホストを1台用意し，JP1/AJS2 - Managerをインストールします。また，必要に応じてJP1/AJS2 - View用のホストを用意し，インストールします。複数のJP1/AJS2 - Viewを接続して使うこともできます。

JP1/AJS2 - ManagerとJP1/AJS2 - Viewでシステムを構築する場合のセットアップ手順を次の図に示します。

図1-1　セットアップ手順（JP1/AJS2 - ManagerとJP1/AJS2 - Viewでシステムを構築する場合）

1.2.2　1台のJP1/AJS2 - Managerホストを使ったマネージャー・エージェント構成にする場合のセットアップ手順

JP1/AJS2 - Manager用ホストを1台用意し，JP1/AJS2 - Agent用ホストを複数台用意します。また，必要に応じてJP1/AJS2 - View用のホストを用意します。

1台のJP1/AJS2 - Managerホストを使ったマネージャー・エージェント構成にする場合のセットアップ手順を次の図に示します。

図1-2　セットアップ手順（1台のJP1/AJS2 - Managerホストを使ったマネージャー・エージェント構成の場合）

1.2.3　複数のJP1/AJS2 - Managerを使ったマネージャー・エージェント構成にする場合のセットアップ手順

JP1/AJS2 - Manager用ホストとJP1/AJS2 - Agent用ホストを複数台用意します。また，必要に応じてJP1/AJS2 - View用ホストを用意します。

複数のJP1/AJS2 - Managerを使ったマネージャー・エージェント構成のセットアップ手順は，JP1/AJS2 - Managerホスト1台のときと同様です。図1-2の作業を，JP1/AJS2 - Managerの数だけ繰り返します。

業務の運用を開始したあと，マネージャージョブグループやマネージャージョブネットを定義して，複数のマネージャーを統括して管理できるようにします。

2.　インストール

この章では，JP1/AJS2のインストール方法について説明します。

＜この章の構成＞

2.1　JP1/AJS2シリーズプログラムのインストール前に必要な作業

2.2　JP1/AJS2シリーズプログラムのインストール

2.3　組み込みDBのインストール

2.1　JP1/AJS2シリーズプログラムのインストール前に必要な作業

この節では，WindowsホストにJP1/AJS2をインストールする前に必要な次の作業について説明します。

JP1/Baseのインストール

注意

新規インストールの場合は，JP1/Baseを先にインストールしてください。また，バージョンアップインストールの場合は，JP1/Baseを先にバージョンアップしてください。

＜この節の構成＞

2.1.1　JP1/Baseをインストールする

2.1.1　JP1/Baseをインストールする

JP1/AJS2シリーズプログラム（JP1/AJS2 - ManagerおよびJP1/AJS2 - Agent）をインストールするホストに，JP1/Baseをインストールしておきます。JP1/AJS2 - Viewの場合は，JP1/Baseのインストールは不要です。

なお，JP1/Baseを新規導入した場合，インストール時に自動セットアップを選択すると，ユーザー情報が次のように設定されます。この情報をそのまま使用する場合，ユーザー情報の設定は不要です。

認証サーバ：自ホスト

JP1ユーザー：jp1admin

JP1ユーザーのパスワード：jp1admin

JP1ユーザーをマッピングするOSユーザーとパスワード：インストール時に入力したもの

サーバホスト名：*

JP1/Baseのインストールの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

2.2　JP1/AJS2シリーズプログラムのインストール

この節では，JP1/AJS2シリーズプログラム（JP1/AJS2 - Manager，JP1/AJS2 - Agent，JP1/AJS2 - View）のインストール方法を説明します。組み込みDBを使用する場合のJP1組み込みデータベースのインストール方法については，「2.3 組み込みDBのインストール」を参照してください。

なお，JP1/AJS2 - ManagerおよびJP1/AJS2 - Agentをインストールする前に，JP1/Baseがインストールされていることを確認してください。また，JP1/BaseのバージョンがJP1/AJS2の前提バージョンとなっているか確認してください。

JP1/Baseのインストールについては，マニュアル「JP1/Base 運用ガイド」を参照してください。

＜この節の構成＞

2.2.1　インストール時の注意事項

2.2.2　JP1/AJS2シリーズプログラムをインストールする

2.2.1　インストール時の注意事項

ここでは，JP1/AJS2シリーズプログラムのインストール時の注意事項について説明します。

＜この項の構成＞

(1)　JP1/AJS2 - Managerをインストールするホストについての注意事項

(2)　上書きインストールについての注意事項

(3)　JP1/NETM/DMを使ったリモートインストール（ソフトウェアの配布）

(1)　JP1/AJS2 - Managerをインストールするホストについての注意事項

JP1/AJS2 - Managerをインストールしたホストには，JP1/AJS2 - Agentはインストールできません。

(2)　上書きインストールについての注意事項

(a)　カスタマイズできるファイルの扱い

JP1/AJS2で提供しているファイルには，ユーザーがカスタマイズできるファイルがあります。ユーザーによるカスタマイズを考慮し，バージョンアップインストール後も，これらのファイルは置き換えられません。

また，カスタマイズ前のファイルは，モデルファイルとして同一ディレクトリに格納されています（ファイル名の末尾に，「.model」が付いています）。

アップデートはJP1/AJS2の「インストール先フォルダ¥conf」のモデルファイルに対して行われます。このため，バージョンアップ後は次に示すファイルのカスタマイズ状況を確認し，カスタマイズしている場合は，モデルファイルをコピーし，再度カスタマイズしてください。カスタマイズしていない場合は，コピーだけしてください。

JP1/AJS2のインストール先フォルダ¥conf¥ajs2ca.conf

JP1/AJS2のインストール先フォルダ¥conf¥ajs2cfa.conf

JP1/AJS2のインストール先フォルダ¥conf¥ajs2cm.conf

JP1/AJS2のインストール先フォルダ¥conf¥jp1ajs_param_V7.conf

JP1/AJS2のインストール先フォルダ¥conf¥jp1ajs_service_0700.conf

JP1/AJS2のインストール先フォルダ¥conf¥jp1ajs_spmd.conf

JP1/AJS2のインストール先フォルダ¥conf¥jpqsetup.conf

注意事項

モデルファイルのアップデートは共有フォルダのjp1ajs2の下にあるモデルファイルに対しては行われません。

論理ホストのconfファイルは，共有フォルダのjp1ajs2の下にあるconfディレクトリのファイルになります。

(b)　JP1/AJS2 - Manager，JP1/AJS2 - Agentを上書きインストールする場合

JP1/AJS2のすべてのサービス，およびプロセスを停止させてからインストールしてください。必要に応じて，定義ファイルをバックアップしてから製品をバージョンアップすることをお勧めします。バックアップの対象については，マニュアル「JP1/Automatic Job Management System 2 設計・運用ガイド　6.1.2 バックアップ対象と時期」を参照してください。

(c)　JP1/AJS2 - Light Editionを使用している場合

Version 6またはVersion 7iのJP1/AJS2 - Light EditionにJP1/AJS2 - Managerを上書きインストールすることはできません。JP1/AJS2 - Light Editionをアンインストールしてから，JP1/AJS2 - Managerをインストールしてください。また，JP1/AJS2 - Light Editionをアンインストールする前に，必要に応じて定義ファイルをバックアップしてください。

バックアップの手順については，マニュアル「JP1/Automatic Job Management System 2 設計・運用ガイド　11. バックアップとリカバリー」を参照してください。

(d)　JP1/AJS2 - Viewを使用している場合

JP1/AJS2 - View画面を閉じてからインストールしてください。

インストール後，再起動が必要な場合があります。再起動が必要な場合は，インストール後に再起動を要求するメッセージが表示されますので，メッセージに従ってホストを再起動してください。

(e)　JP1/AJS2 - Consoleを使用している場合

07-00以降のJP1/AJS2 - Managerでは，06-71では別製品だったJP1/AJS2 - Consoleを統合し，JP1/AJS2 - Managerの一機能（コンポーネント名：JP1/AJS2 Console）として提供しています。このため，06-71のJP1/AJS2 Consoleがインストールされている場合は，07-00以降のJP1/AJS2 - Managerを上書きインストールした時点で，JP1/AJS2 ConsoleがJP1/AJS2に統合されます。JP1/AJS2 Console機能もバージョンアップされますので，JP1/AJS2 - Consoleは個別にアンインストールする必要はありません。

(3)　JP1/NETM/DMを使ったリモートインストール（ソフトウェアの配布）

JP1/AJS2は，JP1/NETM/DMを使ったリモートインストールに対応しています。

JP1/AJS2の場合，次に示すインストールに対応しています。

新規インストール
インストール対象ホストにJP1/AJS2を新規にインストールできます。

上書きインストール
リモートインストールすることで，JP1/AJS2インストール済みホストのJP1/AJS2をバージョンアップできます。

JP1/NETM/DMを使った実際のリモートインストール方法については，マニュアル「JP1/NETM/DM 運用ガイド1 (Windows(R)用)」，または「JP1/NETM/DM 運用ガイド2 (Windows(R)用)」を参照してください。

2.2.2　JP1/AJS2シリーズプログラムをインストールする

WindowsホストにJP1/AJS2シリーズプログラムをインストールする手順を説明します。

＜この項の構成＞

(1)　新規インストールの場合

(2)　上書きインストールの場合

(3)　クラスタ構成で上書きインストールする場合

(1)　新規インストールの場合

WindowsホストにJP1/AJS2シリーズプログラムを新規でインストールする手順を次に示します。

JP1/AJS2シリーズプログラムをインストールするホストに，Administrators権限でログインする。

すべてのプログラムを終了する。
既存のJP1シリーズのプログラムが動作している場合，必ず停止しておいてください。

JP1/AJS2シリーズプログラムの媒体をセットする。
HITACHI総合インストーラーの画面が表示されます。

HITACHI総合インストーラーの指示に従って必要な情報を入力し，インストールする。
インストール時に定義する情報を次に示します。

ユーザー情報
ユーザー名などを入力します。

インストール先フォルダ
JP1/AJS2シリーズプログラムをインストールするフォルダを指定します。

プログラムフォルダ
プログラムメニュー名を指定します。
JP1/AJS2 - Managerの場合には，JP1/AJS2 Consoleのインストール先フォルダも指定します。

なお，JP1/AJS2 - Viewをインストールすると，統合トレースログ機能（HNTRLib2）もインストールされます。HNTRLib2のインストール先は，「システムドライブ¥Program Files※¥Hitachi¥HNTRLib2¥」です。1台のホストにJP1/AJS2 - Viewだけをインストールする場合は，Windowsの「管理ツール」のサービス一覧から［Hitachi Network Objectplaza Trace Monitor 2］を選択し，起動してください。

注※

64ビット版環境の場合は，「Program Files」を「Program Files (x86)」と読み替えてください。

インストールが終了したら，ホストを再起動する。

JP1/AJS2シリーズプログラムのセットアップについては，「3. セットアップ」を参照してください。

(2)　上書きインストールの場合

WindowsホストにJP1/AJS2シリーズプログラムをバージョンアップでインストールする手順を次に示します。

JP1/AJS2シリーズプログラムをインストールするホストに，Administrators権限でログインする。

すべてのプログラムを終了する。
既存のJP1シリーズのプログラムが動作している場合，必ず停止しておいてください。

JP1/AJS2シリーズプログラムの媒体をセットする。
上書きインストールの確認のダイアログボックスが表示されます。

上書きインストールの確認のダイアログボックスに回答する。
必ず「修正」を選択してください。
なお，JP1/AJS2 - Viewをインストールすると，統合トレースログ機能（HNTRLib2）もインストールされます。HNTRLib2のインストール先は，「システムドライブ¥Program Files※¥Hitachi¥HNTRLib2¥」です。1台のホストにJP1/AJS2 - Viewだけをインストールする場合は，Windowsの「管理ツール」のサービス一覧から［Hitachi Network Objectplaza Trace Monitor 2］を選択し，起動してください。

注※

64ビット版環境の場合は，「Program Files」を「Program Files (x86)」と読み替えてください。

注意

06-71以前のJP1/AJS2 - ViewまたはJP1/AJS2 - Client Toolkitに，07-00以降のJP1/AJS2 - ViewまたはJP1/AJS2 - Client Toolkitを上書きインストールするとHNTRLib2がインストールされますが，HNTRLibが残ったままになります。HNTRLibを利用するプログラムがない場合は，Windowsの「管理ツール」のサービス一覧から［Hitachi Network Objectplaza Trace Monitor］を選択し，サービスを停止するか，Windowsの「コントロールパネル」の［アプリケーションの追加と削除］の一覧から［Hitachi Network Objectplaza Trace Library］を選択し，削除してください。

次のファイルが上書きインストール時に更新されます。下記ファイルを変更している場合は，バックアップを採ってからバージョンアップしてください。
・JP1/AJS2のインストール先フォルダ¥conf配下の拡張子.modelファイル
・JP1/AJS2のインストール先フォルダ¥tool配下の拡張子.batファイル

インストールが終了したら，ホストを再起動する。

JP1/AJS2シリーズプログラムのセットアップについては，「3. セットアップ」を参照してください。

(3)　クラスタ構成で上書きインストールする場合

クラスタ構成のWindowsホストにJP1/AJS2シリーズプログラムをバージョンアップでインストールする手順を次に示します。

なお，この手順では，論理ホストが通常動作している系を実行系，論理ホストが通常動作していないで待機している系を待機系と呼びます。

待機系で論理ホストが動作していないことを確認する。
待機系で論理ホストのJP1/AJS2が動作していないことを確認してください。
なお，実行系で論理ホストのJP1/AJS2が動作していても問題ありません。

待機系で上書きインストールを実施する。
JP1/AJS2シリーズプログラムの上書きインストールについては，「(2) 上書きインストールの場合」を参照してください。

実行系で論理ホストが動作していないことを確認する。
実行系から待機系にフェールオーバーする，または論理ホストを停止して，実行系で論理ホストのJP1/AJS2が動作していないことを確認してください。
なお，2でバージョンアップした待機系に論理ホストをフェールオーバーしても問題ありません。

実行系で上書きインストールを実施する。
JP1/AJS2シリーズプログラムの上書きインストールについては，「(2) 上書きインストールの場合」を参照してください。

注意

待機系をバージョンアップしたあと，待機系で論理ホストを稼働させている場合，実行系のバージョンアップが完了するまでは実行系にフェールオーバーさせないでください。

2.3　組み込みDBのインストール

組み込みDB（JP1/AJS2 - Database option）のインストール方法については，「5. スケジューラーデータベースに組み込みDBを使用する場合のセットアップ」を参照してください。

3.　セットアップ

この章では，JP1/AJS2シリーズプログラムで必要なセットアップ，システムおよびユーザー環境で必要なセットアップについて説明します。

＜この章の構成＞

3.1　JP1/AJS2 - Managerで必要なセットアップ

3.2　JP1/AJS2 - Agentで必要なセットアップ

3.3　JP1/AJS2 - Viewで必要なセットアップ

3.4　JP1/AJS2 Consoleで必要なセットアップ

3.5　システムおよびユーザー環境で必要なセットアップ

3.1　JP1/AJS2 - Managerで必要なセットアップ

JP1/AJS2 - Managerを使用するには，JP1/Baseのセットアップと，JP1/AJS2 - Managerのセットアップが必要です。

まず，JP1/Baseをセットアップし，次にJP1/AJS2 - Managerをセットアップしてください。

＜この節の構成＞

3.1.1　JP1/Baseのセットアップ

3.1.2　JP1/AJS2 - Managerのセットアップ

3.1.1　JP1/Baseのセットアップ

この項では，JP1/Baseのセットアップについて説明します。

なお，ここでは，設定の流れと大まかな設定内容を説明します。設定方法，設定項目，コマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/Baseは，次の流れでセットアップします。

ユーザー情報を設定する。
ユーザー情報の設定では，JP1/Baseのユーザー管理機能を使って，ユーザー認証やユーザーマッピングなどを設定します。
ユーザー認証の設定では，JP1/AJS2のユーザーや，JP1/AJS2を使うために必要な権限などを設定します。
ユーザーマッピングは，ジョブを実行したり，JP1/AJS2 - Viewからログインしたりするために必要な設定です。JP1ユーザーに，各ホストに登録されているOSユーザーをマッピングします。
設定方法については，「(1) ユーザー情報を設定する」を参照してください。

イベントサービス環境を設定する。
イベントサービス環境の設定は，JP1イベントを送受信するために必要です。
JP1/Baseのイベントサービス環境の設定で，API設定ファイルのパラメーターserverの通信タイプに「keep-alive」を設定してください。「close」を設定すると，次の問題が発生するおそれがあります。

JP1/AJS2が起動時に発行するJP1イベントが発行できない。

統合トレースログにメッセージKAVT1040-Eが出力されて，JP1イベント受信監視ジョブ，ログファイル監視ジョブ，およびWindowsイベントログ監視ジョブがイベントを検知できない。

JP1イベント送信ジョブが異常検出終了する。

設定方法およびAPI設定ファイルについては，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/Baseのセットアップの手順と定義内容を次に示します。

＜この項の構成＞

(1)　ユーザー情報を設定する

(2)　JP1/AJS2に必要なJP1権限レベル一覧

(1)　ユーザー情報を設定する

ユーザー情報は，次の流れで設定してください。

使用する認証サーバを指定する。

JP1ユーザーを登録する。

JP1権限レベルを設定する。

ユーザーマッピングを設定する（JP1/AJS2 - Viewからログインする場合にも，この設定は必要です）。

なお，他ホストに認証サーバを設定している場合は，2と3の作業は不要です。他ホストの認証サーバであらかじめ設定しておいてください。

Windows版JP1/Baseでは，GUIまたはコマンドでユーザー情報を設定します。ここでは，GUIで設定する方法を説明します。コマンドで設定する方法については，マニュアル「JP1/Base 運用ガイド」を参照してください。

次に，ユーザー情報の設定手順を設定内容ごとに説明します。

(a)　使用する認証サーバを指定する

認証サーバの指定手順を次に示します。

Windowsの［スタート］メニューから［プログラム］－［JP1_Base］－［環境設定］を選択する。
［JP1/Base 環境設定］ダイアログボックスが表示されます。

［認証サーバ］タブをクリックする。

［認証サーバの検索順序］の［追加］ボタンをクリックする。
［認証サーバ］ダイアログボックスが表示されます。

認証サーバとして使用するホスト名を入力し，［OK］ボタンをクリックする。
認証サーバとしてどのホストを使用するのかを指定します。認証サーバは自ホストでも，他ホストでもかまいません。
セカンダリー認証サーバを設置する場合は，認証サーバを二つ指定します。
セカンダリー認証サーバを設置しない場合は，認証サーバを一つだけ指定します。
指定した認証サーバは，［JP1/Base 環境設定］ダイアログボックスの［認証サーバ名］フィールドに表示されます。認証サーバを二つ指定した場合，フィールドの上方に表示されるのがプライマリー認証サーバ，下方に表示されるのがセカンダリー認証サーバです。

これで認証サーバの指定は終了です。

注意

［認証サーバの検索順序］の設定で，自ホストを認証サーバ（プライマリー認証サーバまたはセカンダリー認証サーバ）に指定する場合は，JP1/Baseサービスを停止してから設定してください。

(b)　JP1ユーザーを登録する

JP1ユーザーの登録手順を次に示します。

［JP1/Base 環境設定］ダイアログボックスの［認証サーバ］タブをクリックする。

［JP1ユーザー］の［追加］ボタンをクリックする。
［JP1ユーザー］ダイアログボックスが表示されます。

JP1ユーザー名と，JP1/AJS2 - Managerにログインするためのパスワードを入力し，［OK］ボタンをクリックする。
登録したユーザー名が，［JP1/Base 環境設定］ダイアログボックスの［JP1ユーザー］フィールドに表示されます。
さらにJP1ユーザーを登録したい場合は，手順2と3を繰り返します。

これでJP1ユーザーの登録は終了です。

他ホストを認証サーバとして指定した場合は，その認証サーバでJP1ユーザーを登録しておいてください。

(c)　JP1権限レベルを設定する

登録したJP1ユーザーに対して，JP1/AJS2で処理を定義・実行するための権限レベルを設定します。権限レベルを設定するには，JP1ユーザーに対して「JP1資源グループ」と「JP1権限レベル」を定義します。

JP1権限レベルの設定手順を次に示します。

［JP1/Base 環境設定］ダイアログボックスの［認証サーバ］タブをクリックする。

［JP1ユーザー］フィールドで，権限を設定したいJP1ユーザー名を選択する。

［JP1資源グループ別権限レベル］の［追加］ボタンをクリックする。
［JP1資源グループ詳細］ダイアログボックスが表示されます。

［JP1資源グループ］に，JP1資源グループ名を入力する。
資源グループ名は，ジョブネットワーク要素をグループ分けして管理するための，任意の名称です。
ほかのJP1ユーザーが所属している資源グループ名を指定するか，または新規に資源グループ名を決めて指定します。資源グループ名は半角英数字で指定します。

［所有しない権限］から，JP1ユーザーに対して設定したい権限レベル名を選択し，［<-追加］ボタンをクリックする。
選択した権限レベル名が［所有する権限］フィールドに表示されます。
複数の権限レベルを設定したい場合は，この操作を繰り返します。
［所有する権限］フィールドから権限レベル名を削除したい場合は，権限レベル名を選択し，［削除->］ボタンをクリックします。
なお，JP1/AJS2で必要な権限レベルの詳細については「(2) JP1/AJS2に必要なJP1権限レベル一覧」を参照してください。

［OK］ボタンをクリックする。
設定したJP1資源グループ名と権限レベル名が，［JP1/Base 環境設定］ダイアログボックスの［JP1資源グループ別権限レベル］フィールドに表示されます。
ほかのJP1ユーザーにJP1権限レベルを設定したい場合は，手順2～5を繰り返します。

これでJP1権限レベルの設定は終了です。

他ホストを認証サーバとして指定した場合は，その認証サーバでJP1権限レベルを設定しておいてください。

(d)　ユーザーマッピングを設定する

登録したJP1ユーザーに対して，OSユーザーをマッピングします。

ユーザーマッピングの設定手順を次に示します。

［JP1/Base 環境設定］ダイアログボックスの［ユーザーマッピング］タブをクリックする。

［パスワード管理］の［設定］ボタンをクリックする。
［パスワード管理］ダイアログボックスが表示されます。

［新規登録］ボタンをクリックする。
［新規登録］ダイアログボックスが表示されます。

OSユーザー名とパスワードの情報を定義し，［OK］ボタンをクリックする。
OSユーザー情報が設定され，［パスワード管理］ダイアログボックスに戻ります。なお，［パスワード管理］ダイアログボックスでは，OSユーザーとそのOSユーザーのパスワード情報を，登録，変更および削除できます。
なお，OSユーザーは，「ドメイン名¥ユーザー名」または「ユーザー名」の形式で定義します。JP1/AJS2では，ドメイン名付きのOSユーザー名とドメイン名なしのOSユーザーを区別しますので，OSユーザーは次の形式で定義してください。

ドメインユーザーの場合は，「ドメイン名¥ユーザー名」の形式で定義してください。

ドメインコントローラー上のユーザーの場合は，「ドメイン名¥ユーザー名」の形式で定義してください。

ローカルユーザー（ドメイン名とコンピュータ名が同じユーザー）の場合は，「ユーザー名」の形式で定義してください。「コンピュータ名」は付けません。

［終了］ボタンをクリックする。
［パスワード管理］ダイアログボックスが閉じ，［JP1/Base 環境設定］ダイアログボックスの［ユーザーマッピング］タブに戻ります。

［JP1ユーザー］の［追加］ボタンをクリックする。
［JP1ユーザー］ダイアログボックスが表示されます。

JP1ユーザー名と，ジョブの実行要求元およびJP1/AJS2 - Viewのログイン先ホスト名を入力し，［OK］ボタンをクリックする。
［マッピングOSユーザー詳細］ダイアログボックスが表示されます。なお，［サーバホスト名］に特定のホストを設定しておくと，特定のホストのユーザー以外からのジョブ実行要求を受け付けないようにしておけます。また，［サーバホスト名］に「*（アスタリスク）」を入力すると，すべてのホストからのジョブ実行要求を受け付けます。JP1/AJS2 - Viewからのログインを受け付ける場合は，［サーバホスト名］に自ホスト名，または「*（アスタリスク）」を設定してください。

表示されているJP1ユーザーに対して，マッピングするOSユーザーを選択する。
［マッピングしないOSユーザー］フィールドに，［パスワード管理］ダイアログボックスで設定したOSユーザーが表示されます。そこからマッピングするOSユーザーを選択し，［<-追加］ボタンをクリックすると，選択したOSユーザーが［マッピングするOSユーザー］フィールドに移動します。
OSユーザーは複数マッピングできます。

マッピングするOSユーザーをすべて設定したら，［OK］ボタンをクリックする。
JP1ユーザー名とマッピングしたOSユーザー名が，［JP1/Base 環境設定］ダイアログボックスの［マッピングOSユーザー一覧］フィールドに表示されます。

これでユーザーマッピングの設定は終了です。

注意

マッピングされるOSユーザーには，ジョブ実行ホストでローカルログオンできる権限が必要です。

この権限は，Windowsの［管理ツール］の［ローカルセキュリティポリシー］などで設定します。

また，JP1ユーザーにマッピングするOSユーザーは，正常にOSにログインできるOSユーザーをJP1ユーザーにマッピングしてください。

(2)　JP1/AJS2に必要なJP1権限レベル一覧

JP1/AJS2のJP1権限レベルには次の2種類があります。

ジョブネット定義・実行時のJP1権限レベル

ジョブの実行・操作時のJP1権限レベル

それぞれの権限レベル名と操作できる内容について説明します。

(a)　ジョブネット定義・実行時のJP1権限レベル

ジョブネット定義・実行時のJP1権限レベルには，次の5種類があります。

JP1_AJS_Admin
管理者権限です。ユニットの所有者や資源グループの操作権限，ジョブネットの定義・実行・編集権限などを持っています。

JP1_AJS_Manager
ジョブネットの定義・実行・編集権限などを持っています。

JP1_AJS_Editor
ジョブネットの定義・編集権限などを持っています。

JP1_AJS_Operator
ジョブネットの実行・参照権限などを持っています。

JP1_AJS_Guest
ジョブネットの参照権限などを持っています。

ジョブネット定義・実行時のJP1権限レベル名と詳細な操作内容を次の表に示します。

表3-1　ジョブネット定義・実行時のJP1権限レベル名と操作できる内容

操作内容
JP1_AJS_
Admin
JP1_AJS_
Manager
JP1_AJS_
Editor
JP1_AJS_
Operator
JP1_AJS_
Guest

他ユーザーが所有権を持つユニットに対して，所有者，JP1資源グループ名，またはジョブの実行ユーザー種別を変更する
○※1
－
－
－
－

ジョブネットワーク要素を定義する
○
○
○
－
－

ジョブネットに定義したジョブネットワーク要素の定義内容を変更する
○
○※2
○※2
－
－

ジョブネットの定義内容を変更する
○
○
○
－
－

ジョブネットワーク要素を複写・移動したり，名称を変更したりする
○
○
○
－
－

ジョブネットワーク要素を削除する
○
○
○
－
－

ジョブネットワーク要素名を標準出力ファイルに出力する
○
○
○
○
○

ジョブネットワーク要素の定義内容を標準出力ファイルに出力する
○
○
○
○
○

ジョブネットワーク要素を退避する
○
○
○
○
○

ジョブネットワーク要素を回復する
○
○
○
－
－

ジョブグループにカレンダー情報を定義する
○
○
○
－
－

特定期間について，ジョブネットの実行スケジュールを定義する
○
○
－
○
－

定義済みのジョブネットを実行登録する
○
○
－
○
－

ジョブネットの実行登録を解除する
○
○
－
○
－

ジョブネットやジョブの実行履歴，現在の状態，次回実行予定などを標準出力ファイルに出力する
○
○
○
○
○

ジョブネットに定義されたスケジュールを一時的に変更する
○
○
－
○
－

ジョブの状態を一時的に変更する
○
○
－
○
－

ジョブの状態を変更する
○
○
－
○
－

ジョブネットの実行を中断する
○
○
－
○
－

ジョブネットを再実行する
○
○
－
○
－

ジョブやジョブネットの実行を強制終了させる
○
○
－
○
－

ジョブネットワーク要素をエクスポートする
○
○
○
○
○

ジョブネットワーク要素をインポートする
○
○
○
－
－

（凡例）

○：操作できる。

－：操作できない。

注1

OSのAdministrators権限を持つユーザーは，JP1権限レベルに関係なく，すべての操作を実行できます。

また，ユニットにJP1資源グループが設定されていない場合，そのユニットに対して，JP1権限レベルに関係なく，あらゆるユーザーはすべての操作ができます。

注2

マネージャージョブグループ，マネージャージョブネットでは，参照先のJP1/AJS2 - Managerのアクセス権限の定義が適用されます。

注※1

ユニットの所有者であれば，JP1_AJS_Admin権限が与えられていなくても操作ができます。

ただし，ユニット所有者であっても，そのユニットに設定されているJP1資源グループに対して参照する権限が与えられていない場合，JP1/AJS2 - ViewからJP1資源グループ名，所有者，ジョブの実行ユーザーの種別を変更できません。JP1/AJS2 - ViewからJP1資源グループ名，所有者，ジョブの実行ユーザーの種別を変更したい場合は，「ajschange -g JP1資源グループ名 ユニット名」で，JP1資源グループ名を参照する権限が与えられているJP1資源グループに変更してください。

また，ユニットに所有者が設定されていない場合，すべてのユーザーが，JP1資源グループ名，所有者，またはジョブの実行ユーザーの種別を変更できます。

なお，ユニットの実行ユーザーの種別が所有ユーザーに設定されている場合，次に示すユーザー以外のユーザーが，ユニットの所有者を別のJP1ユーザーに変更すると，ユニットの実行ユーザーの種別が登録ユーザーになります。ユニットの実行ユーザーの種別が登録ユーザーになると，ジョブはジョブネットを実行登録したユーザーでの実行として扱われます。これは，次に示すユーザー以外のユーザーが，任意のユーザー権限でジョブを実行することを防ぐためです。

Administrators権限が与えられているユーザー

ユニットに設定されているJP1資源グループに対してJP1_AJS_Admin権限が与えられているJP1ユーザー

注※2

ユニットの実行ユーザーの種別が所有ユーザーになっている場合，JP1_AJS_Admin権限以外のJP1ユーザーは，自分が所有するユニットでなければ変更操作ができません。これは，JP1_AJS_Admin権限が与えられていない一般ユーザーが，任意のジョブを実行することを防ぐためです。

なお，ユニットの実行ユーザーの種別が登録ユーザーになっている場合は，操作ができるJP1権限レベルを与えられているだけで変更操作ができます。

(b)　ジョブの実行・操作時のJP1権限レベル

ジョブの実行・操作時のJP1権限レベルには，次の3種類があります。

JP1_JPQ_Admin
管理者権限です。ジョブ実行環境の設定権限，キューやジョブ実行先エージェントの操作権限，ほかのユーザーがキューイングしたジョブの操作権限を持っています。

JP1_JPQ_Operator
キューの操作権限，ほかのユーザーがキューイングしたジョブの操作権限を持っています。

JP1_JPQ_User
サブミットジョブの登録や，自分がキューイングしたジョブの操作権限を持っています。

ジョブの実行・操作時のアクセス権限の設定では，資源グループ「JP1_Queue」に対して，これらの権限レベルを持たせるように設定します。「JP1_Queue」は，大文字・小文字を間違えないように入力してください。

ジョブの実行・操作時のJP1権限レベル名と詳細な操作内容を次の表に示します。

表3-2　ジョブの実行・操作時のJP1権限レベル名と詳細な操作内容

操作内容
JP1_JPQ_
Admin
JP1_JPQ_
Operator
JP1_JPQ_
User

サブミットジョブを登録する
○
○
○

ジョブの実行をキャンセル，または強制終了する
○
○
△

ジョブの実行を保留，または保留解除する
○
○
△

ジョブを移動する
○
○
△

ジョブ情報を出力する
○
○
△

終了ジョブ情報を出力する
○
○
△

データベースから終了ジョブ情報を削除する
○
○
－

キューを開く
○
○
－

キューを閉じる
○
○
－

キューを追加する
○
－
－

キューを削除する
○
－
－

キュー情報を出力する
○
○
○

キューの定義を変更する
○
－
－

キューをエージェントに接続する
○
－
－

キューとエージェントの接続を解除する
○
－
－

ジョブ実行多重度を変更する
○
－
－

エージェントを追加する
○
－
－

エージェントを削除する
○
－
－

エージェントホスト情報を出力する
○
－
－

排他実行リソースを追加する
○
－
－

排他実行リソースを削除する
○
－
－

排他実行リソース情報を出力する
○
○
○

（凡例）

○：操作できる。

△：操作できるが，ほかのユーザーが実行したジョブは操作できない。

－：操作できない。

注意

ジョブの実行・操作時は，処理要求先マネージャーが使用する認証サーバのアクセス権限の定義が適用されます。

ジョブ実行制御のコマンドを使用してジョブの実行・操作を行う場合，コマンドを実行するOSユーザーと同名のJP1ユーザーを登録しておく必要があります。

また，コマンドを実行するOSユーザーと同名のJP1ユーザーに対して，ジョブの実行・操作を行うのに必要なJP1権限レベルを設定してください。

jpqjobsubコマンドを実行する場合は，ジョブ実行ホスト側でジョブを実行するJP1ユーザー（コマンドを実行したOSユーザーと同名のJP1ユーザー）と実行ホストのOSユーザーをマッピングしておく必要があります。

jpqjobsubコマンドで-euを指定する場合は，-euに指定したOSユーザーとJP1ユーザー（コマンドを実行したOSユーザーと同名のJP1ユーザー）をジョブ実行ホスト側でマッピングしておく必要があります。

3.1.2　JP1/AJS2 - Managerのセットアップ

この節では，JP1/AJS2 - Managerのセットアップについて説明します。JP1/AJS2 - Managerのセットアップには，Administratorsの実行権限が必要です。

JP1/Baseのセットアップが完了してから，JP1/AJS2 - Managerのセットアップをしてください。

なお，ここでは，JP1/AJS2を動作させるために，基本となるセットアップ方法を説明します。業務に合わせて設定を変更したい場合は，必要に応じて次に示す個所を参照してください。

設定または変更したい内容 | 参照個所
スケジューラーサービス環境の設定手順および設定内容 | 4.1節
ジョブ実行環境の設定手順および設定内容 | 4.2節
イベント起動の設定手順および設定内容 | 4.3節
キューレスジョブ実行環境の設定 | 4.4節
その他のオプションの設定 | 4.5節
JP1/AJS2 Console環境の設定手順および設定内容 | 4.6節
スケジューラーサービスの多重起動の設定 | 4.7.1
ISAMファイル自動再編成機能の設定 | 4.7.2
スケジューラーサービスの統合トレースログ出力レベルの変更 | 4.7.3
ネストジョブネット定義パラメーター出力時のスケジュールルールの出力方法の変更 | 4.7.4
スケジューラートレースログファイルの名称変更 | 4.7.5
JP1/AJS2 - Managerの運用方法をサブミットジョブの登録や操作に限定するときの設定 | 4.7.6
実行登録中にルートジョブネットの下位定義を編集する場合に必要なサスペンド機能の設定変更 | 4.7.7
JP1/AJS2定義内容の事前チェック機能の設定 | 4.7.10
ジョブネットコネクタで異なるスケジューラーサービス間のルートジョブネットの実行順序を制御するための設定 | 4.7.11
スケジューラーデータベースに組み込みDBを使用する場合の設定 | 5章
ジョブ実行時のワークパスを変数として定義する | 7.1節
ジョブをロングファイル名で実行するための設定 | 7.2節
転送元ファイルの検索パスを定義する | 7.3節
JP1ユーザー仮定機能 | 7.4節
エージェント自動定義機能で作成されるキュー属性値をカスタマイズする設定 | 7.5節
ユーザープロファイルを必要とするジョブを実行するための設定 | 7.6節
ジョブ情報削除処理に関する設定 | 7.7節
イベントジョブのログサイズ設定の変更 | 7.8節
イベント順序保証オプションの設定 | 7.9節
キューレスジョブ環境でユーザープロファイルを必要とするジョブを実行するための設定 | 7.10節
ジョブの標準出力と標準エラー出力を同時に確認する設定 | 7.11節
ファイル監視ジョブの状態引き継ぎオプションの設定 | 7.12節
「"（ダブルクォーテーションマーク）」を含むデータをイベントジョブの引き継ぎ情報に使用するための設定 | 7.13節
ファイル受信制限をするための設定 | 7.16節
ジョブの結果ファイルの再送間隔・再送回数の変更 | 7.17節
ジョブ結果ファイルの二重受信防止の設定 | 7.18節
TCP/IP通信接続エラーのリトライ間隔・回数の変更 | 7.19節
ジョブを配信するエージェントホストの決定方式の設定 | 7.20節
マクロ変数の展開失敗時の動作の設定 | 7.21節
マクロ変数の引き継ぎ情報がNULL文字列の場合の置き換え方法の設定 | 7.22節
JP1/AJS2のサービスが停止してもイベントジョブの実行を継続させる設定 | 7.33節
ログ情報の採取 | 8章
クラスタシステムのセットアップ | 9章

＜この項の構成＞

(1)　セットアップの手順

(1)　セットアップの手順

JP1/AJS2 - Managerのセットアップ手順を次に示します。

必要に応じて，JP1/AJS2サービスのアカウントを変更する。
JP1/AJS2サービスのアカウントの設定内容を変更する必要がなければ，操作は不要です。サービスのアカウントを変更が必要な運用形態については，マニュアル「JP1/Automatic Job Management System 2 設計・運用ガイド　5.2.3(1) JP1/AJS2が提供するサービスのアカウントの変更について」を参照してください。

Windowsの［スタート］メニューから［プログラム］－［JP1_Automatic Job Management System 2 - Manager］－［環境設定］を選択する。
環境設定をする論理ホスト名を指定するダイアログボックスが表示されます。論理ホスト名を指定するダイアログボックスを次に示します。

図3-1　論理ホスト名を指定するダイアログボックス（JP1/AJS2 - Manager）

論理ホストが設定されている場合は論理ホスト名を指定し，［設定］ボタンをクリックする。設定されていない場合は，「デフォルト」のまま［設定］ボタンをクリックする。
［マネージャー環境設定］ダイアログボックスが表示されます。

ダイアログボックスに必要な情報を設定する。
すべてデフォルト値のままで使用する場合は，情報の変更などは不要です。
設定する内容については，「4.1 スケジューラーサービス環境の設定」，「4.2.1(1) ジョブ実行環境を定義する」および「4.3.1(1) イベント起動を定義する」を参照してください。
また，各タブで情報を入力したら，［適用］ボタンをクリックしてください。［適用］ボタンをクリックしない場合は，入力した情報が保存されません。

すべての情報を定義したら，［OK］ボタンをクリックする。
［マネージャー環境設定］ダイアログボックスが閉じ，定義した情報で環境設定されます。
なお，各項目の推奨値と設定が有効になる時期については，マニュアル「JP1/Automatic Job Management System 2 設計・運用ガイド　5.3 JP1/AJS2 - Managerのセットアップについて検討する」を参照してください。

07-50と同様のオプションで運用する場合， 07-50互換オプションを適用する。
次の手順に従ってください。

ajs2_0750.conf.modelをajs2_0750.confにコピーする。

ajs2_0750.confを必要に応じて編集する。

jbssetcnfコマンドを実行する。

（例）

jbssetcnf ajs2_0750.conf

必要に応じて，ISAMファイル自動再編成機能を有効にする。
ISAMファイルの自動再編成機能を有効にすると，JP1/AJS2サービスの起動時にISAMファイルを自動的に再編成できます。設定方法については，「4.7.2 ISAMファイル自動再編成機能の設定」を参照してください。

これでセットアップは終了です。

3.2　JP1/AJS2 - Agentで必要なセットアップ

JP1/AJS2 - Agentを使うには，JP1/Baseのセットアップと，JP1/AJS2 - Agentのセットアップが必要です。

まず，JP1/Baseをセットアップし，次にJP1/AJS2 - Agentをセットアップします。

＜この節の構成＞

3.2.1　JP1/Baseのセットアップ

3.2.2　JP1/AJS2 - Agentのセットアップ

3.2.1　JP1/Baseのセットアップ

この項では，JP1/Baseのセットアップについて説明します。

なお，ここでは，設定の流れと大まかな設定内容を説明します。設定方法，設定項目，コマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/Baseは，次の流れでセットアップします。

ユーザー情報を設定する。
ユーザー情報の設定では，JP1/Baseのユーザー管理機能を使って，ユーザーマッピングを設定します。
ユーザーマッピングは，他ホストから自ホストに対してジョブ実行を依頼される場合に必要な設定です。JP1ユーザーに，各ホストに登録されているOSユーザーをマッピングします。
設定方法については，「(1) ユーザー情報を設定する」を参照してください。

イベントサービス環境を設定する。
イベントサービス環境の設定は，JP1イベントを送受信するために必要です。
JP1/Baseのイベントサービス環境の設定で，API設定ファイルのパラメーターserverの通信タイプに「keep-alive」を設定してください。「close」を設定すると，JP1/AJS2が起動時に発行するJP1イベントが発行できなくなったり，統合トレースログにKAVT1040-Eのメッセージが出力されて，JP1イベント受信監視ジョブ，ログファイル監視ジョブ，およびWindowsイベントログ監視ジョブがイベントを検知できなくなったり，JP1イベント送信ジョブが異常検出終了したりするなど，正常に動作しない問題が発生することがあります。
設定方法およびAPI設定ファイルについては，マニュアル「JP1/Base 運用ガイド」を参照してください。

起動順序制御機能を設定する。
JP1/AJS2 - Agentには「JP1/AJS2 Monitorサービス」はありません。
JP1/AJS2 - Agentを使用する場合は，JP1/Baseで標準提供されている起動順序定義ファイル（JP1SVPRM.DAT）のうち次の部分をコメントアウトするか，または削除してください。

[Jp1AJS2MONITOR]
Name=JP1/AJS2 Monitor
ServiceName=JP1_AJS2_Monitor
Parallel=YES

JP1/Baseのセットアップの手順と定義内容を次に示します。

＜この項の構成＞

(1)　ユーザー情報を設定する

(1)　ユーザー情報を設定する

Windows版JP1/Baseでは，GUIまたはコマンドでユーザー情報を設定します。ここでは，GUIで設定する方法を説明します。コマンドで設定する方法については，マニュアル「JP1/Base 運用ガイド」を参照してください。

なお，JP1/AJS2 - Agent 07-00-/C以降では，JP1/AJS2 - Agentの起動時に認証サーバへのアクセスを行わなくなりました。

JP1/AJS2 - Agentで認証サーバを指定する必要はありません。

次に，ユーザー情報の設定手順を設定内容ごとに説明します。

(a)　ユーザーマッピングを設定する

認証サーバに登録されているJP1ユーザーに対して，OSユーザーをマッピングします。

ユーザーマッピングの設定手順を次に示します。

［JP1/Base 環境設定］ダイアログボックスの［ユーザーマッピング］タブをクリックする。

［パスワード管理］の［設定］ボタンをクリックする。
［パスワード管理］ダイアログボックスが表示されます。

［新規登録］ボタンをクリックする。
［新規登録］ダイアログボックスが表示されます。

OSユーザー名とパスワードの情報を定義し，［OK］ボタンをクリックする。
OSユーザー情報が設定され，［パスワード管理］ダイアログボックスに戻ります。［パスワード管理］ダイアログボックスでは，OSユーザーとそのOSユーザーのパスワード情報を，登録，変更および削除できます。
なお，OSユーザーは，「ドメイン名¥ユーザー名」または「ユーザー名」の形式で定義します。JP1/AJS2では，ドメイン名付きのOSユーザー名とドメイン名なしのOSユーザーを区別するため，OSユーザーは次の形式で定義してください。

ドメインユーザーの場合は，「ドメイン名¥ユーザー名」の形式

ドメインコントローラー上のユーザーの場合は，「ドメイン名¥ユーザー名」の形式

ローカルユーザー（ドメイン名とコンピュータ名が同じユーザー）の場合は，「ユーザー名」の形式（コンピュータ名は付けない）

［終了］ボタンをクリックする。
［パスワード管理］ダイアログボックスが閉じ，［JP1/Base 環境設定］ダイアログボックスの［ユーザーマッピング］タブに戻ります。

［JP1ユーザー］の［追加］ボタンをクリックする。
［JP1ユーザー］ダイアログボックスが表示されます。

JP1ユーザー名と，ジョブの依頼元ホスト名を入力し，［OK］ボタンをクリックする。
［マッピングOSユーザー詳細］ダイアログボックスが表示されます。なお，［サーバホスト名］に「*（アスタリスク）」を入力すると，すべてのサーバホストからのジョブ実行要求を受け付けられます。

表示されているJP1ユーザーに対して，マッピングするOSユーザーを選択する。
［マッピングしないOSユーザー］フィールドに，［パスワード管理］ダイアログボックスで設定したOSユーザーが表示されます。そこからマッピングするOSユーザーを選択し，［<-追加］ボタンをクリックすると，選択したOSユーザーが［マッピングするOSユーザー］フィールドに移動します。
OSユーザーは複数マッピングできます。

マッピングするOSユーザーをすべて設定したら，［OK］ボタンをクリックする。
JP1ユーザー名とマッピングしたOSユーザー名が，［JP1/Base 環境設定］ダイアログボックスの［マッピングOSユーザー一覧］フィールドに表示されます。

これでユーザーマッピングの設定は終了です。

注意

マッピングされるOSユーザーには，ジョブ実行ホストでローカルログオンできる権限が必要です。

この権限は，Windows の［管理ツール］の［ローカルセキュリティポリシー］などで設定します。

また，JP1ユーザーにマッピングするOSユーザーは，正常にOSにログインできるOSユーザーをJP1ユーザーにマッピングしてください。

3.2.2　JP1/AJS2 - Agentのセットアップ

この項では，JP1/AJS2 - Agentのセットアップについて説明します。JP1/AJS2 - Agentのセットアップには，Administratorsの実行権限が必要です。

JP1/Baseのセットアップが完了したら，JP1/AJS2 - Agentをセットアップする前に，接続先のJP1/AJS2 - Managerが正常に動作することを確認しておいてください。

なお，ここでは，JP1/AJS2を動作させるために，基本となるセットアップ方法を説明します。業務に合わせて設定を変更したい場合は，必要に応じて次に示す個所を参照してください。

設定または変更したい内容 | 参照個所
ジョブ実行環境の設定手順および設定内容 | 4.2節
キューレスジョブ実行環境の設定 | 4.4節
その他のオプションの設定 | 4.5節
JP1/AJS2定義内容の事前チェック機能の設定 | 4.7.10
ジョブ実行時のワークパスを変数として定義する | 7.1節
ジョブをロングファイル名で実行するための設定 | 7.2節
ユーザープロファイルを必要とするジョブを実行するための設定 | 7.6節
イベントジョブのログサイズ設定の変更 | 7.8節
キューレスジョブ環境でユーザープロファイルを必要とするジョブを実行するための設定 | 7.10節
ファイル監視ジョブの状態引き継ぎオプションの設定 | 7.12節
ログ情報の採取 | 8章
クラスタシステムのセットアップ | 9章

＜この項の構成＞

(1)　セットアップの手順

(1)　セットアップの手順

JP1/AJS2 - Agentのセットアップの手順を次に示します。

必要に応じて，JP1/AJS2サービスのアカウントを変更する。
JP1/AJS2サービスのアカウントの設定内容を変更する必要がなければ，操作は不要です。サービスのアカウントを変更が必要な運用形態については，マニュアル「JP1/Automatic Job Management System 2 設計・運用ガイド　5.2.3(1) JP1/AJS2が提供するサービスのアカウントの変更について」を参照してください。

Windowsの［スタート］メニューから［プログラム］－［JP1_Automatic Job Management System 2 - Agent］－［環境設定］を選択する。
環境設定をする論理ホスト名を指定するダイアログボックスが表示されます。
論理ホスト名を指定するダイアログボックスを次に示します。

図3-2　論理ホスト名を指定するダイアログボックス（JP1/AJS2 - Agent）

論理ホストが設定されている場合は論理ホスト名を指定し，［設定］ボタンをクリックする。設定されていない場合は，「デフォルト」のまま［設定］ボタンをクリックする。
［エージェント環境設定］ダイアログボックスが表示されます。

ダイアログボックスで，必要な情報を設定する。
すべてデフォルト値のままで使用する場合は，情報の変更などは不要です。
設定する内容については，「4.2.2(1) ジョブ実行環境を定義する」および「4.3.2(1) イベント起動を定義する」を参照してください。
また，各タブで情報を入力したら，［適用］ボタンをクリックしてください。［適用］ボタンをクリックしない場合は，入力した情報が保存されません。

すべての情報を定義したら，［OK］ボタンをクリックする。
［エージェント環境設定］ダイアログボックスが閉じ，定義した情報で環境設定されます。
なお，各項目の推奨値と設定が有効になる時期については，マニュアル「JP1/Automatic Job Management System 2 設計・運用ガイド　5.4 JP1/AJS2 - Agentのセットアップについて検討する」を参照してください。

07-50と同様のオプションで運用する場合， 07-50互換オプションを適用する。
次の手順に従ってください。

ajs2_0750.conf.modelをajs2_0750.confにコピーする。

ajs2_0750.confを必要に応じて編集する。

jbssetcnfコマンドを実行する。

（例）

jbssetcnf ajs2_0750.conf

これでセットアップは終了です。

3.3　JP1/AJS2 - Viewで必要なセットアップ

JP1/AJS2 - Viewは，インストール後に特別なセットアップは不要です。デフォルト値のままで使用できます。

実行・障害ログを採取するために，JP1/AJS2 - Viewを使う前にWindowsの「管理ツール」のサービス一覧から［Hitachi Network Objectplaza Trace Monitor 2］を選択し，統合トレースログ機能（HNTRLib2）を起動しておいてください。

統合トレースログ機能の起動は，1台のホストにJP1/AJS2 - Viewだけをインストールしている場合にだけ必要です。JP1/AJS2 - ManagerやJP1/AJS2 - Agentと同じホストにインストールしている場合，統合トレースログ機能の起動は不要です。

JP1/AJS2 - Viewの環境設定を変更する手順については，「6. JP1/AJS2 - Viewの環境設定」を参照してください。

3.4　JP1/AJS2 Consoleで必要なセットアップ

JP1/AJS2 Console機能を使用する場合には，JP1/AJS2 Console Manager，JP1/AJS2 Console Agent，JP1/AJS2 Console Viewのそれぞれで，セットアップが必要です。

＜この節の構成＞

3.4.1　JP1/AJS2 Console Managerのセットアップ

3.4.2　JP1/AJS2 Console Agentのセットアップ

3.4.3　JP1/AJS2 Console Viewのセットアップ

3.4.1　JP1/AJS2 Console Managerのセットアップ

JP1/AJS2 Console Managerを使用するためには，JP1/AJS2 - ManagerをインストールしたホストでJP1/AJS2 Console Managerのセットアップをする必要があります。

JP1/AJS2 Console Managerのセットアップは，JP1/AJS2 Consoleインストール先フォルダ¥bin¥ajscmsetup.exeを実行し，JP1/AJS2 Console Managerサービスを作成します。ajscmsetupコマンドの詳細については，「20. セットアップ時に使用するコマンド　ajscmsetup（Windows限定）」を参照してください。

補足事項

JP1/AJS2 Console Managerサービスの起動や終了方法については，マニュアル「JP1/Automatic Job Management System 2 設計・運用ガイド　15.2 JP1/AJS2のサービスを起動または終了する」を参照してください。

JP1/AJS2 Console Managerサービスは，物理ホストおよびすべての論理ホストへの接続を受け付けるため，マシンに一つだけあります。

JP1/AJS2 Console Managerの構成定義内容を変更する場合は，「4.6.1 JP1/AJS2 Console Manager環境の設定」を参照してください。

3.4.2　JP1/AJS2 Console Agentのセットアップ

JP1/AJS2 Console Agentを使用するためには，JP1/AJS2 - ManagerをインストールしたホストでJP1/AJS2 Console Agentのセットアップをする必要があります。

JP1/AJS2 Console Agentのセットアップは，JP1/AJS2のインストール先フォルダ¥bin¥ajscasetup.exeを実行し，JP1/AJS2 Console Agentサービスを作成します。ajscasetupコマンドの詳細については，「20. セットアップ時に使用するコマンド　ajscasetup（Windows限定）」を参照してください。

補足事項

JP1/AJS2 Console Agentサービスの起動や終了方法については，マニュアル「JP1/Automatic Job Management System 2 設計・運用ガイド　15.2 JP1/AJS2のサービスを起動または終了する」を参照してください。

JP1/AJS2 Console Agentサービスは，物理ホストおよびすべての論理ホストへの接続を受け付けるため，マシンに一つだけあります。

JP1/AJS2 Console Agentの構成定義内容を変更する場合は，「4.6.2 JP1/AJS2 Console Agent環境の設定」を参照してください。

3.4.3　JP1/AJS2 Console Viewのセットアップ

JP1/AJS2 Console Viewを使用するためには，JP1/AJS2 - ViewをインストールしたホストでJP1/AJS2 Console Viewのセットアップをする必要があります。セットアップをしないでJP1/AJS2 Console Viewを起動しようとするとエラーになります。

JP1/AJS2 Console Viewのセットアップは，JP1/AJS2 - Viewのインストール先フォルダ¥bin¥ajscvsetup.exeを実行します。ajscvsetupコマンドの詳細については，「20. セットアップ時に使用するコマンド　ajscvsetup」を参照してください。

Windowsの［スタート］メニュー（［スタート］－［プログラム］－［JP1_Automatic Job Management System 2 - View］の下）に［業務監視］という名称で，JP1/AJS2 Console Viewを起動するメニューが追加されます。

補足事項

JP1/IM - Viewがインストールされている場合は，JP1/AJS2 Console ViewをセットアップするとJP1/IM - Viewの［統合機能メニュー］画面のツリーエリアの［統合管理］－［ジョブシステム運用］の下に［業務監視］が追加されます。JP1/AJS2 Console Viewのセットアップ後にJP1/IM - Viewをインストールする場合は，JP1/IM - Viewのインストール後，再度セットアップコマンドを実行してください。

3.5　システムおよびユーザー環境で必要なセットアップ

システム環境およびユーザー環境のセットアップについて説明します。

＜この節の構成＞

3.5.1　トレースログファイルの拡張

3.5.2　通信環境の設定

3.5.3　ジョブ実行環境の構成定義情報を変更する

3.5.1　トレースログファイルの拡張

次に示すWindows版トレースログファイルの拡張手順を説明します。

JP1/AJS2のトレースログファイル

JP1/AJS2 Consoleのトレースログファイル

キューレストレースログファイル

キューレスジョブ実行内部ログファイル

＜この項の構成＞

(1)　JP1/AJS2のトレースログファイルの拡張

(2)　JP1/AJS2 Consoleのトレースログファイルの拡張

(3)　キューレストレースログファイルの拡張

(4)　キューレスジョブ実行内部ログファイルの拡張

(1)　JP1/AJS2のトレースログファイルの拡張

JP1/AJS2のトレースログファイルは，初期状態では次のように設定されています。

格納先
インストール先フォルダ¥log¥tracelog

サイズ
約2,000個のジョブを実行したときのトレースログを保存できるサイズ（具体的には，20メガバイト（20,480キロバイト））

トレースログファイルの容量は，ジョブネットの構造やJP1/AJS2 - Viewの接続数，操作内容によって大きく異なるため，必要に応じてトレースログファイルのサイズを拡張する必要があります。

トレースログファイルの適切な容量を見積もる方法については，マニュアル「JP1/Automatic Job Management System 2 設計・運用ガイド　4.4.2 トレースログファイルのサイズを見積もる」を参照してください。

トレースログファイルのサイズを拡張する手順を次に示します。

次のコマンドを実行する。

ajstrsetsz -s 適切なトレースログファイル容量

（例）

トレースログファイルのサイズを20メガバイト（20,480キロバイト）から30メガバイト（30,720キロバイト）に拡張する場合

ajstrsetsz -s 30720

(2)　JP1/AJS2 Consoleのトレースログファイルの拡張

JP1/AJS2 Consoleのトレースログファイルの拡張は，JP1/AJS2 Console ManagerとJP1/AJS2 Console Agentではそれぞれ設定が必要です。JP1/AJS2 Consoleのトレースログファイルは，初期状態では次のように設計されています。

格納先
JP1/AJS2 Console Managerの場合：JP1/AJS2 Consoleのインストール先フォルダ¥log¥tracelog.cm
JP1/AJS2 Console Agentの場合：JP1/AJS2 - Managerのインストール先フォルダ¥log¥tracelog.ca

サイズ
JP1/AJS2 Console Managerの場合：3,072キロバイト
JP1/AJS2 Console Agentの場合：3,072キロバイト

必要となるトレースログファイルの容量は，業務の監視状況などによって大きく異なります。必要に応じて，トレースログファイルの適切な容量を見積もり，拡張してください。

トレースログファイルの適切な容量を見積もる方法については，マニュアル「JP1/Automatic Job Management System 2 設計・運用ガイド　4.4.8 JP1/AJS2 Consoleのトレースログファイルのサイズを見積もる」を参照してください。

トレースログファイルのサイズを拡張する手順を次に示します。

(a)　JP1/AJS2 Console Managerの場合

次のコマンドを実行する。

ajscmtrsetsz -s 適切なトレースログファイル容量

（例）

トレースログファイルのサイズを3メガバイト（3,072キロバイト）から10倍の30メガバイト（30,720キロバイト）に拡張する場合

ajscmtrsetsz -s 30720

(b)　JP1/AJS2 Console Agentの場合

次のコマンドを実行する。

ajscatrsetsz -s 適切なトレースログファイル容量

（例）

トレースログファイルのサイズを3メガバイト（3,072キロバイト）から10倍の30メガバイト（30,720キロバイト）に拡張する場合

ajscatrsetsz -s 30720

(3)　キューレストレースログファイルの拡張

キューレストレースログファイルは，初期状態では次のように設計されています。

格納先
JP1/AJS2のインストール先フォルダ¥log¥tracelog.ql

サイズ
約10,000個のジョブを実行したときのトレースログを保存できるサイズ（具体的には，15メガバイト（15,360キロバイト））

必要となるキューレストレースログファイルの容量は，ジョブのファイル転送の有無やエラー出力結果の有無によって大きく異なります。必要に応じてトレースログファイルの適切な容量を見積もり，拡張してください。

トレースログファイルの適切な容量を見積もる方法については，マニュアル「JP1/Automatic Job Management System 2 設計・運用ガイド　4.4.6 キューレストレースログファイルのサイズを見積もる」を参照してください。

トレースログファイルのサイズを拡張する手順を次に示します。

次のコマンドを実行する。

ajsqltrsetsz -s 適切なトレースログファイル容量

（例）

トレースログファイルのサイズを15メガバイト（15,360キロバイト）から30メガバイト（30,720キロバイト）に拡張する場合

ajsqltrsetsz -s 30720

(4)　キューレスジョブ実行内部ログファイルの拡張

キューレスジョブ実行内部ログファイルは，初期状態では次のように設定されています。

格納先
JP1/AJS2インストール先フォルダ¥log¥ajsqlexeclog※1
JP1/AJS2インストール先フォルダ¥log¥ajsqlexeclog_ftpd※2

注※1

クラスタ運用時は，名称が次のようになります。

JP1/AJS2インストール先フォルダ¥log¥ajsqlexeclog-[論理ホスト名]

なお，名称が256バイト以上である場合は，ファイル名に論理ホスト名として30バイトまで付加します。

注※2

JP1/AJS2 - Managerの場合だけ作成します。

サイズ

ajsqlexeclogファイルの場合

約40,000個のキューレスジョブを実行したときに，キューレスエージェントサービスが出力する実行内部ログを保存できるサイズ（具体的には，24メガバイト（24,576キロバイト））

ajsqlexeclog_ftpdファイルの場合

約20,000個のファイル転送を伴うキューレスジョブを実行したときに，キューレスファイル転送サービスが出力する実行内部ログを保存できるサイズ（具体的には，10メガバイト（10,240キロバイト））

必要となるキューレスジョブ実行内部ログファイルのサイズは，実行するキューレスジョブの個数，およびキューレスジョブ実行時のファイル転送の有無などによって大きく異なります。必要に応じて，キューレスジョブ実行内部ログファイルの適切なサイズを見積もり，拡張してください。

キューレスジョブ実行内部ログファイルの適切なサイズを見積もる方法については，マニュアル「JP1/Automatic Job Management System 2 設計・運用ガイド　4.4.7 キューレスジョブ実行内部ログファイルのサイズを見積もる」を参照してください。また，キューレスジョブ実行内部ログファイルのサイズを拡張する方法については，マニュアル「JP1/Automatic Job Management System 2 コマンドリファレンス　1. コマンド　ajsqlexecsetsz」を参照してください。

3.5.2　通信環境の設定

DNSの構成や，ファイアウォールを使用した環境でJP1/AJS2を構築する場合には，取得できるホスト名やファイアウォール上での通信設定が必要です。

次の個所を参照し，通信環境を設定してください。

マニュアル「JP1/Automatic Job Management System 2 設計・運用ガイド　3.3.3 DNS環境で運用する場合の注意事項」

マニュアル「JP1/Automatic Job Management System 2 設計・運用ガイド　3.4.5 ファイアウォールを設定した環境の構成例と通信設定」

3.5.3　ジョブ実行環境の構成定義情報を変更する

ジョブ実行環境は，デフォルトで実行ホスト（エージェント）が一つ，ローカルホストに作成されます。しかし，システムによってはジョブの実行環境を変更する（ジョブ実行環境に構成定義情報を追加する）必要があります。

例として，次の場合があります。

実行ホストが複数台ある場合

他システム（JP1/NQSEXECやJP1/OJEなど）と連携する場合

ジョブを複数の実行ホストで分散実行する場合

特定ジョブ同士を排他実行する場合

設定が必要な場合は，「4.2.1(2) ジョブ実行環境を変更する」を参照し，ジョブ実行環境の構成定義情報を変更してください。

4.　環境設定

この章では，JP1/AJS2の環境設定について説明します。

＜この章の構成＞

4.1　スケジューラーサービス環境の設定

4.2　ジョブ実行環境の設定

4.3　イベント起動の設定

4.4　キューレスジョブ実行環境の設定

4.5　その他のオプションの設定

4.6　JP1/AJS2 Console環境の設定

4.7　そのほかの設定

4.1　スケジューラーサービス環境の設定

スケジューラーサービス環境の設定は，マネージャー環境（JP1/AJS2 - Manager）で作業します。エージェント環境（JP1/AJS2 - Agent）で設定する作業はありません。

スケジューラーサービス環境を設定する場合に，［マネージャー環境設定］ダイアログボックスで定義する項目および環境設定パラメーターでの設定方法を説明します。

各項目の推奨値と設定が有効になる時期については，マニュアル「JP1/Automatic Job Management System 2 設計・運用ガイド　5.3.1 スケジューラーサービスに関する環境設定について検討する」を参照してください。

＜この節の構成＞

4.1.1　論理ホスト共通の情報を定義する

4.1.2　スケジューラーサービスの制御を定義する

4.1.3　スケジューラーファイルの構成を定義する

4.1.4　スケジューラーログを定義する

4.1.5　スケジューラーオプションを定義する

4.1.6　環境設定パラメーターで定義する

4.1.1　論理ホスト共通の情報を定義する

論理ホスト共通の情報は，［マネージャー環境設定］ダイアログボックスの［論理ホスト共通］タブで定義してください。

マネージャー環境で設定する［論理ホスト共通］タブを次に示します。

図4-1　［論理ホスト共通］タブ（［マネージャー環境設定］ダイアログボックス）

各項目の定義内容を説明します。

デフォルトスケジューラーサービス名

デフォルトとなるスケジューラーサービスの名称を30バイト以内で指定します。この項目は必ず指定してください。デフォルトは「AJSROOT1」です。

ジョブ実行時などで，対象となるスケジューラーサービス名が指定されていない場合は，ここで指定したスケジューラーサービスを対象としてジョブが実行されます。

リモートジョブネットスケジューラーサービス名

リモートジョブネットを実行するスケジューラーサービスの名称を30バイト以内で指定します。この項目を設定しない場合は，リモートジョブネットの実行を他ホストから依頼されても，実行できません。

文字コード種別

ユニット名称や定義内容で使う文字コードを次の三つから選択します。

［Shift-JIS］
シフトJISコード

［C］
7ビットASCII文字コード

［EUC］
EUC文字コード

デフォルトは［Shift-JIS］です。

なお，JP1/AJS2で業務を定義・実行しているときに文字コードを変更しないでください。JP1/AJS2運用中に文字コードを変更する場合は，ジョブネットをすべて登録解除し，ユニットを退避させてから変更してください。変更後は，JP1/AJS2サービスを再起動し，ユニットを回復し，ジョブネットを実行登録します。

スケジューラーサービスの再起動回数

スケジューラーサービスを構成するプロセスが異常終了した場合に，異常終了したプロセスを自動的に再起動する回数を指定します。指定した数の分だけスケジューラーサービスを再起動するため，0～3の間の指定をお勧めします。デフォルトは「3」です。

「0」を指定した場合，スケジューラーサービスは再起動されません。「1」を指定した場合，スケジューラーサービスは1回だけ再起動されます。

再起動回数をクリアするまでの時間

スケジューラーサービスを構成するプロセスが異常終了し，再起動された場合，再起動から再停止するまでの時間が一定時間を超えると，正常動作できたものとみなし，再起動回数をクリアーします。正常動作とみなす稼働時間を180（単位：秒）以上で指定します。デフォルトは「180」です。

スケジューラーサービス異常時の処理

一つのスケジューラーサービスが異常終了した場合に，すべてのスケジューラーサービスを停止し，ajsmasterdプロセスを異常終了させるかどうかを次のどちらかから選択します。

［スケジューラーサービスを終了する］
すべてのスケジューラーサービスが終了し，ajsmasterdプロセスが異常終了します。この場合，ajsstartコマンドでスケジューラーサービスを再起動できません。JP1/AJS2サービスを再起動して，スケジューラーサービスを起動してください。

［スケジューラーサービスを終了しない］
スケジューラーサービス全体は終了しません。この場合，ajsstartコマンドで異常終了したスケジューラーサービスを再起動できます。

デフォルトは［スケジューラーサービスを終了しない］です。

クラスタ運用時の論理ホストでは，論理ホストのスケジューラーサービスが異常終了した場合，次の動作となります。

［スケジューラーサービスを終了する］を指定した場合，スケジューラーサービスが異常終了した論理ホストのJP1/AJS2サービスを終了します。

［スケジューラーサービスを終了しない］を指定した場合，スケジューラーサービスが異常終了した論理ホストのJP1/AJS2サービスは終了しません。

なお，［スケジューラーサービスを終了する］を指定した場合でも，スケジューラーサービスの再起動回数で指定した回数の再起動を行います。指定した再起動回数に達したあとに異常終了した場合，すべてのスケジューラーサービスは終了します。

JP1/AJS2 - Monitorサービスの開始・終了ログ出力

JP1/AJS2 Monitorサービスの開始・終了メッセージを，イベントログおよびスケジューラーログに出力するかどうかについて設定します。

イベントログ

JP1/AJS2 Monitorサービスの開始・終了メッセージ，JP1/AJS2 Monitorサービスの受付処理開始・終了メッセージおよびモニターサーバの起動・終了メッセージを，Windowsイベントログおよび統合トレースログに出力するかどうかを次のどちらかから選択します。

［しない］
JP1/AJS2 Monitorサービスおよびモニターサーバに関するメッセージを出力しません。

［すべて］
JP1/AJS2 Monitorサービスの開始メッセージ（KAVS0530-I），終了メッセージ（KAVS0531-I），JP1/AJS2 Monitorサービスの受付処理開始メッセージ（KAVS0532-I），受付処理終了メッセージ（KAVS0533-I），モニターサーバの起動メッセージ（KAVS0534-I）および終了メッセージ（KAVS0535-I）を出力します。

デフォルトは［しない］です。

この項目は，JP1/AJS2の新規のインストール時および新規のセットアップ時に「すべて」が設定されます。

スケジューラーログ

スケジューラーサービスへの接続開始・終了メッセージをスケジューラーログに出力するかどうかを次のどちらかから選択します。

［しない］
スケジューラーサービスへの接続開始・終了メッセージを出力しません。

［すべて］
スケジューラーサービスへの接続開始・終了メッセージを出力します。

デフォルトは［しない］です。

JP1/AJS2 - Monitorサービスの認証ログ出力

ユーザー認証に関するメッセージを，イベントログおよびスケジューラーログに出力するかどうかについて設定します。

イベントログ

ユーザー認証に関するメッセージを，Windowsイベントログおよび統合トレースログに出力するかどうかを選択します。

［しない］
ユーザー認証に関するメッセージを出力しません。

［すべて］
ユーザー認証に関するメッセージを出力します。

デフォルトは［しない］です。

スケジューラーログ

ユーザー認証に関するメッセージを，スケジューラーログに出力するかどうかを選択します。

［しない］
ユーザー認証に関するメッセージを出力しません。

［すべて］
ユーザー認証に関するログを出力します。

デフォルトは［しない］です。

最大同時セション数

JP1/AJS2 - Viewの最大接続数を0～128の間で指定します。

デフォルトは「50」です。

この項目で指定した数を超えてJP1/AJS2 - Viewから接続しようとした場合，接続できません。

ログオンセションのプロセス起動方法

OSのユーザーアカウントでログオンして実行されるセションのプロセス起動方法を次のどちらかから選択します。

［ログオンの再利用を行う］
同一のOSユーザーへマッピングし実行されるセションのログオン情報を保存して再利用します。この指定を行うことによって，同一のOSユーザーへマッピングし実行されるセションがデスクトップヒープを共有するようになり，デスクトップヒープ領域の消費を抑えることができます。
同一のOSユーザーへマッピングし実行されるセションが同時に多数あり，デスクトップヒープ領域の不足によってプロセスが起動できない場合に指定してください。なお，この指定を行った場合，OSのユーザー情報を変更したときには，JP1/AJS2 Monitorサービスの再起動が必要になります。

［ログオンの再利用を行わない］
同一のOSユーザーへマッピングし実行されるセションのログオン情報を再利用しません。

デフォルトは［ログオンの再利用を行わない］です。

この項目は，JP1/AJS2 Monitorサービスの起動時に有効になります。

この項目は，次に示す操作に伴うセションのプロセス起動に適用されます。

JP1/AJS2 - Viewの接続

コマンドのリモート実行

リモートジョブネットの実行

JP1/AJS2 - Definition Assistantからの操作

JP1/AJS2 - Scenario Operationからの操作

ログオン共有セション数

ログオンの再利用を行うとき，ログオン情報を共有するセションの数を1～128の間で指定します。

同一OSユーザーのセション数が，ここで指定する数を超えた場合，新たにデスクトップヒープを割り当てます。

デフォルトは「50」です。

［ユーザーアカウントセション起動方法］で［ログオンの再利用を行う］を選択した場合だけ指定できます。

この項目は，JP1/AJS2 Monitorサービスの起動時に有効になります。

［ログオン共有セション数］の見積もり方法

デスクトップヒープ領域が不足した場合は，［ログオン共有セション数］を次に示す範囲で調整してください。なお，非対話型プロセスに割り当てられるデスクトップヒープの大きさについては，OSのドキュメントを参照してください。

ログオン共有セション数 <
非対話型プロセスに割り当てられるデスクトップヒープの大きさ(キロバイト) ／ 10(キロバイト)

4.1.2　スケジューラーサービスの制御を定義する

スケジューラーサービスの制御については，［マネージャー環境設定］ダイアログボックスの［スケジューラーサービスの制御］タブで定義してください。

マネージャー環境で設定する［スケジューラーサービスの制御］タブを次に示します。

図4-2　［スケジューラーサービスの制御］タブ（［マネージャー環境設定］ダイアログボックス）

各項目の定義内容を説明します。

スケジューラーサービス

作成されているスケジューラーサービスが表示されます。リスト中の［識別番号］はスケジューラーサービスの識別番号を表しています。また，［論理ホスト名］の「－」は，環境設定開始時に選択した論理ホスト名が「デフォルト」であることを表しています。図4-2の場合，スケジューラーサービス「AJSROOT1」（識別番号は「1」）が，論理ホスト「デフォルト」に作成されています。

［追加］ボタンをクリックすると，新規にスケジューラーサービスを作成するためのウィザード形式のダイアログボックスが表示されます。スケジューラーサービスを多重起動させたい場合，サービスを追加します。

スケジューラーサービスは，1台のマシンにつき物理ホストと論理ホストを合わせて20個まで作成できます。サービス名は，自ホストの物理ホストおよびすべての論理ホストで名称が重複しないように指定してください。サービス名は30バイト以内で指定し，半角英数字および次の記号が使用できます。

「!」，「#」，「$」，「%」，「+」，「-（ハイフン）」，「.（ピリオド）」，「_（アンダーバー）」

全角文字や半角カナおよび上記以外の記号は使用しないでください。

また，Windowsの場合は，「CON」，「PRN」，「AUX」，「CLOCK$」，「NUL」，「COMm（m：1～9の任意の整数）」および「LPTn（n：1～9の間の任意の整数）」なども使用できません。

推奨しない文字を使用すると，コマンドインタープリターがコマンドラインを解析する際にスケジューラーサービス名を正しく認識できず，誤動作することがあります。

注意

スケジューラーサービスの追加を行う場合，スケジューラーサービス追加後に［OK］ボタンを押してください。

（スケジューラーサービス名）の設定

スケジューラーサービスの設定内容を変更したい場合，変更するスケジューラーサービス名を選択します。リストには，環境設定開始時に指定した論理ホストに登録されているスケジューラーサービスがすべて表示されます。

JP1/AJS2 - Manager起動時の自動起動

選択したスケジューラーサービスを，JP1/AJS2 - Manager起動時に自動起動するかどうかを選択します。

［いいえ］を選択した場合は，選択したスケジューラーサービスをajsstartコマンドで起動します。

デフォルトは［はい］です。なお，［いいえ］を選択した場合でもajsmaster.exeプロセスは起動します。

スケジューラーサービスの識別番号

選択したスケジューラーサービスの識別番号を1～20の間で指定します。

識別番号は，自ホスト内の物理ホストおよびすべての論理ホストで使用している識別番号と重複しない番号を指定してください。

デフォルトは「1」です。

ここで指定した識別番号は，テンポラリーファイルの名称や，プロセス間通信用のキーなど，内部的にスケジューラーサービスを識別するために使われます。そのため，一度指定した識別番号はできるだけ変更しないでください。変更した場合は，スケジューラーサービスをコールドスタートしてください。

ジョブ状態通知ポートのサービス名

ジョブ状態の情報を取得するために使用する通信ポートのポート番号を指定します。servicesファイルに定義されているサービス名で，かつ，30バイト以内で指定します。デフォルトは「jp1ajs2report」です。

スケジューラーサービスを多重起動する場合は，スケジューラーサービスごとに異なるサービス名を指定し，servicesファイルに重複しないポート番号を設定してください。

キューレスジョブリクエスト多重度

キューレスジョブリクエスト多重度は，キューレスジョブを実行するときに，キューレスエージェントと通信するプロセスの多重度です。スケジューラーサービス当たりに起動するキューレスジョブリクエストプロセス（ajsreqd.exe）数を指定します。

キューレスジョブリクエスト多重度を1～8の間で指定します。

デフォルトは「1」です。

現状のキューレスジョブシステムでは，キューレスジョブの配送が，性能ネックとなることはありませんので，デフォルトの「1」のまま使用してください。

4.1.3　スケジューラーファイルの構成を定義する

スケジューラーファイルの構成は，［マネージャー環境設定］ダイアログボックスの［スケジューラーファイルの構成］タブ，および［スケジューラーファイルの構成2］タブで定義してください。

マネージャー環境で設定する［スケジューラーファイルの構成］タブを図4-3に，［スケジューラーファイルの構成2］タブを図4-4に示します。

図4-3　［スケジューラーファイルの構成］タブ（［マネージャー環境設定］ダイアログボックス）

各項目の定義内容を説明します。

（スケジューラーサービス名）の設定

スケジューラーファイルの構成を設定したいスケジューラーサービスの名称を選択します。リストには，環境設定開始時に指定した論理ホストに登録されているスケジューラーサービスがすべて表示されます。

データベースディレクトリ名

JP1/AJS2のユニット情報を格納するフォルダの名称を180バイト以内で指定します。フォルダ名はフルパスで指定します。デフォルトは「JP1/AJS2 - Managerのインストール先フォルダ¥database¥schedule¥AJSROOT1」です。ジョブネットの定義，実行および参照するユーザーには，このフォルダに対して「読み取り」および「書き込み」権限を設定しておいてください。

ここで指定したフォルダには，ユニットに対して排他編集をする際に必要なファイルや，ISAMのデータファイルやキーファイル（JP1/AJS2データベースにISAMを指定した場合）が保存されます。これらのファイルは削除しないでください。

データベース種別

使用するデータベースを次の二つから選択します。

［ISAM］
ISAMは，JP1/AJS2 - Manager中に標準提供されています。

［EmbedDB］
組み込みDBを選択した場合は，JP1/AJS2 - Managerホストに組み込みDBが設定されている必要があります。
デフォルトは［ISAM］です。

テーブル名プリフィックス

スケジューラーサービスのスキーマ内に保持される，テーブル名称の先頭に付けられる文字列を4バイト以内の半角英数字で指定します。テーブル名称は，大文字・小文字が区別されず，すべて大文字として扱われます。デフォルトは「AJS」です。

なお，RDBを使用して複数のスケジューラーサービスを同一スキーマ内に作成する場合，それぞれのサービスで異なる名称を指定してください。

ISAMの設定

［データベース種別］で［ISAM］を選択した場合に定義します。

データファイル更新モード

ISAMファイルの更新時に，同期書き込みを許可するかどうかを次の三つから選択します。

［同期］
ファイル更新時に，常に同期書き込みを実行します。この方法で書き込みを実行した場合，信頼性は向上しますが，性能は低下します。なお，同期書き込みは，ジョブ・ジョブネットの状態管理ファイルに対してだけ実行します。ユニット定義情報を保存するファイルに対しては，フラッシュモードで書き込みます。

［非同期］
JP1/AJS2の処理とは同期を取らないで，OSのバッファーリングによってディスクに書き込みます。

［フラッシュ］
書き込み処理を終了するたびに，メモリーにある内容をディスクに書き込みます。

デフォルトは［フラッシュ］です。

RDBの設定

［データベース種別］で［EmbedDB］を選択した場合に定義します。

なお，指定する文字列の長さや数値はDBMSによって異なるので，使用するDBMSの制限値を参考にして設定してください。

RDB認可識別子

データベースをセットアップおよび運用する際に使う認可識別子を130バイト以内の半角英数字で指定します。組み込みDBを使う場合は8バイト以内で指定し，必ず設定してください。

データベースの各テーブルは，ここで指定したスキーマ内に作成され，運用されます。

RDBアクセスユーザー

データベースにアクセスするときのユーザーの名称を130バイト以内の半角英数字で指定します。RDB認可識別子とは異なる名称を指定してください。

組み込みDBを使う場合，8バイト以内で指定し，必ず設定してください。

パスワード

データベースにアクセスするときのパスワードを130バイト以内の半角英数字で指定します。

パスワードは省略できます。省略した場合，パスワードは自動生成されます。

このパラメーターはクリアーテキストで保存されます。

組み込みDBの場合，通常，パスワードは大文字・小文字が区別されません。区別したい場合には，パスワード文字列を「!」で囲んでください。組み込みDBで，この項目を設定する場合は，30バイト以内で指定してください。

（例）　!password!

切断検知する間隔

データベースサーバが停止したなどの理由でスケジューラーサービスが処理を続行できなくなる場合に備えて，データベースサーバとの接続を確認し，切断を検知したときにスケジューラーサービスを自動的に停止させる機能を使用する場合に指定します。

1～86,400の範囲内の値を指定した場合だけこの機能は有効になります。この機能を使用する場合には，この範囲内の値を指定してください。

1～86,400の範囲外の値を指定した場合にはこの機能は無効となり，データベースサーバとの接続確認およびスケジューラーサービスの自動停止は行いません。

デフォルトは「0」です。

この項目は，JP1/AJS2の新規のインストール時および新規のセットアップ時に「300」が設定されます。

この機能を使用しない場合には，1～86,400の範囲外の値を指定するか，またはこの項目の指定を省略してください。

RDB接続先ホスト

データベースが設定されているホストの名称を511バイト以内で指定します。

この項目は［データベース種別］で［EmbedDB］を選択した場合に指定できます。

接続ポート番号

データベースに接続するポートの番号を1～65,535の間で指定します。

この項目は［データベース種別］で［EmbedDB］を選択した場合に指定できます。

ローカルRDBサーバとの通信方式

RDBサーバとの通信方式を次のどちらかから選択します。

［TCP/IP］
RDBサーバとの通信に，TCP/IP通信を使用します。

［プロセス間メモリ通信］
RDBサーバとの通信に，プロセス間メモリー通信を使用します。このパラメーターは，スケジューラーサービスからRDBに接続する際に，環境変数PDIPCに設定されます。

デフォルトは［TCP/IP］です。このオプションを「プロセス間メモリ通信」にするとスケジューラーデータベースのアクセス性能が向上しますので，設定することを強く推奨します。

この項目は［データベース種別］で，［EmbedDB］を選択した場合に指定できます。

送信用メモリサイズ

RDBサーバとの通信にプロセス間メモリー通信を使用する際に，送信データを格納するメモリーサイズを指定します。指定できる値は任意ですが，JP1/AJS2でRDBのプロセス間メモリー通信を使用する場合は，少なくとも「8」以上の値を指定してください。

この項目は，［ローカルRDBサーバとの通信方式］に［プロセス間メモリ通信］を指定した場合にだけ有効です。

この項目を省略した場合や，「0」を指定した場合は，RDBの既定値が使用されます。

受信用メモリサイズ

RDBサーバとの通信にプロセス間メモリー通信を使用する際に，受信データを格納するメモリーサイズを指定します。指定できる値は任意ですが，JP1/AJS2でRDBのプロセス間メモリー通信を使用する場合は，少なくとも「64」以上の値を指定してください。

この項目は，［ローカルRDBサーバとの通信方式］に［プロセス間メモリ通信］を指定した場合にだけ有効です。

このパラメーターを省略した場合や，「0」を指定した場合は，RDBの既定値が使用されます。

最大待ち合わせ時間（RDB接続待ち合わせ機能）

RDB接続待ち合わせを打ち切る時間を，0～60（単位：分）の範囲の値で指定します。

デフォルトは「1」です。「0」を指定した場合は，RDB接続待ち合わせ機能が無効になります。

スケジューラーサービスが起動するたびにここで指定した時間だけRDBとの接続を待ち合わせるので，［論理ホスト共通］タブの「スケジューラーサービスの再起動回数」の値を変更している場合には，注意が必要です。

図4-4　［スケジューラーファイルの構成2］タブ（［マネージャー環境設定］ダイアログボックス）

各項目の定義内容を説明します。

一時ファイル用ディレクトリ名

JP1/AJS2のテンポラリーファイルを作成するフォルダの名称を180バイト以内で指定します。フォルダ名はフルパスで指定します。「;（セミコロン）」は指定しないでください。デフォルトは「JP1/AJS2 - Managerのインストール先フォルダ¥tmp¥schedule」です。

ジョブネットを操作および参照するユーザーには，このフォルダに対して更新権限を定義しておいてください。

なお，運用中に障害が発生した場合は，指定したフォルダ下に作業用のファイルが残ることがあります。そのため，システム起動時などですべてのJP1/AJS2のサービスが起動していないときにファイルを削除し，フォルダを定期的にメンテナンスしてください。

ただし，組み込みDBを使用している場合は，pdで始まるファイル（pderr1.trc，pderr2.trcなど）を削除しないでください。

ジョブエラー情報ディレクトリ名

ジョブ定義時に標準エラー出力ファイルを指定していない場合に，ジョブ実行時に標準エラー出力ファイルを格納するフォルダの名称を180バイト以内で指定します。フォルダ名はフルパスで指定します。「;（セミコロン）」は指定しないでください。デフォルトは「JP1/AJS2 - Managerのインストール先フォルダ¥jobinf」です。

ジョブネットを実行および参照するユーザーには，このフォルダに対して更新権限を定義しておいてください。また，ジョブネットを参照するユーザーには，操作権限を定義しておいてください。

退避情報ディレクトリ名

ジョブネットワーク要素を退避させるときのフォルダの名称を180バイト以内で指定します。フォルダ名はフルパスで指定します。「;（セミコロン）」は指定しないでください。デフォルトは「JP1/AJS2 - Managerのインストール先フォルダ¥backup¥schedule」です。

ジョブネットを退避するユーザーには，このフォルダに対して更新権限を定義しておいてください。また，ジョブネットを回復するユーザーには，操作権限を定義しておいてください。

4.1.4　スケジューラーログを定義する

ジョブネット定義およびスケジュール定義に関するログについては，［マネージャー環境設定］ダイアログボックスの［スケジューラーログの設定］タブで定義してください。

マネージャー環境で設定する［スケジューラーログの設定］タブを次に示します。

図4-5　［スケジューラーログの設定］タブ（［マネージャー環境設定］ダイアログボックス）

各項目の定義内容を説明します。

ログファイルの設定

スケジューラーログファイルのサイズや名称を設定します。

スケジューラーログファイルのサイズ

ログファイルのサイズを0または4～2,000,000（単位：キロバイト）の間で指定します。デフォルトは「5120」です。

この項目は，JP1/AJS2の新規のインストール時および新規のセットアップ時に「10240」が設定されます。

「0」を指定した場合，ログファイルは作成されません。

ジョブやジョブネットの実行状況を確認するためのログであるため，最低でも1日分のログを保存できるサイズを指定してください。

スケジューラーログファイルのサイズの見積もり手順については，マニュアル「JP1/Automatic Job Management System 2 設計・運用ガイド　4.4.1 スケジューラーログファイルのサイズを見積もる」を参照してください。

JP1/AJS2 - Managerをエージェントとして使用するなどスケジューラーログが不要な場合は，「0」を指定してスケジューラーログ出力プロセス（ajslogd.exe）を起動しないようにしてください。

スケジューラーログファイル1の名称

ログファイルの名称を255バイト以内で指定します。ファイル名はフルパスで指定します。デフォルトは「JP1/AJS2 - Managerのインストール先フォルダ¥log¥ajs-log1.log」です。

スケジューラーログファイル2とは異なるファイル名を指定してください。

このログファイルに指定したサイズ以上の情報が書き込まれると，それ以降はログファイル2に情報が書き込まれるようになります。

別の論理ホストに指定したファイル名と重複しない名称を指定してください。

スケジューラーログファイル2の名称

ログファイルの名称を255バイト以内で指定します。ファイル名はフルパスで指定します。デフォルトは「JP1/AJS2 - Managerのインストール先フォルダ¥log¥ajs-log2.log」です。

別の論理ホストに指定したファイル名と重複しない名称を指定してください。

スケジューラーログの年号出力

スケジューラーログの日付に「年」を出力するかどうかを選択します。

スケジューラーログを，年号を含めて管理したい場合に変更します。

［しない］
「年」を出力しません。日付には「月日」が表示されます。

［する］
「年」を出力します。日付には「年月日」が表示されます。

デフォルトは［しない］です。

スケジューラーログの拡張出力

スケジューラーログに出力する，ユニットの実行ログや操作ログを出力する場合の出力形式を選択します。

［しない］
操作ユーザー種別などの詳細な情報がない形式で出力します。

［する］
［しない］選択時に出力されるメッセージに，操作ユーザー種別などの詳細な情報を追加した形式で出力します。
メッセージに追加される情報を次に示します。
・操作ユーザー種別
・要求元ホストIPアドレス
・要求元識別情報
・コマンド操作のオプション
・ユニット名

デフォルトは［しない］です。

この項目に［する］を設定すると，ユニットの実行や操作時にスケジューラーログに詳細な情報が出力され，操作の正当性を検証できます。機能および追加される情報の詳細については，マニュアル「JP1/Automatic Job Management System 2 設計・運用ガイド　付録F.1 JP1/AJS2での操作の正当性を検証するための機能」を参照してください。

また，ログが出力される条件および出力されるときに追加される情報は，ログ種別によって異なります。詳細については，マニュアル「JP1/Automatic Job Management System 2 設計・運用ガイド　付録E.1 スケジューラーサービスが出力するログ」を参照してください。

スケジューラーログ出力プロセスの開始・終了ログ出力

スケジューラーログ出力プロセス（ajslogd.exe）の開始・終了メッセージを，Windowsイベントログ，統合トレースログ，およびスケジューラーログに出力するかどうかについて設定します。

イベントログ

スケジューラーログ出力プロセスの開始・終了メッセージを，Windowsイベントログおよび統合トレースログに出力するかどうかを選択します。

［しない］
スケジューラーログ出力プロセスの開始・終了メッセージを出力しません。

［すべて］
スケジューラーログ出力プロセスの開始（KAVS0220-I）・終了メッセージ（KAVS0221-I）を出力します。

デフォルトは［しない］です。

スケジューラーログ

スケジューラーログ出力プロセスの開始・終了メッセージを，スケジューラーログに出力するかどうかを選択します。

［しない］
スケジューラーログ出力プロセスの開始・終了メッセージを出力しません。

［すべて］
スケジューラーログ出力プロセスの開始・終了メッセージを出力します。

デフォルトは［しない］です。

（スケジューラーサービス名）の設定

スケジューラーログを設定したいスケジューラーサービス名を選択します。リストには，環境設定開始時に指定した論理ホストに登録されているスケジューラーサービスがすべて表示されます。

スケジューラーログとイベントログの出力情報

スケジューラーログファイルやWindowsイベントログに出力するメッセージの出力形式を次のどちらかから選択します。

［通常］
実行IDやジョブ番号などの情報がない形式でメッセージを出力します。

［完全］
［通常］選択時に出力されるメッセージに，実行IDやジョブ番号などの詳細な情報を追加した形式でメッセージを出力します。
メッセージに追加される情報を次に示します。
・ジョブネットやジョブの開始・終了などのログに「実行ID」が追加されます。
・ジョブの開始・終了のログに「ジョブ番号」が追加されます。
・Windowsイベントログのジョブの開始のログに「ホスト名」が追加されます。ジョブの終了のログには，設定に関係なく「ホスト名」が出力されます。
・ジョブの正常終了ログに「戻り値」が追加されます。

デフォルトは［通常］です。

この項目は，JP1/AJS2の新規のインストール時および新規のセットアップ時に［完全］が設定されます。スケジューラーログファイルに出力されるログの詳細については，マニュアル「JP1/Automatic Job Management System 2 設計・運用ガイド　付録E.1 スケジューラーサービスが出力するログ」を参照してください。

スケジューラーログの情報用ログ出力

スケジューラーサービスの情報用履歴を出力するかどうかを選択します。

［しない］
コマンドの実行開始履歴（ログ種別：I001）およびサービス要求履歴（ログ種別：I002）を出力しません。

［開始］
コマンドの実行開始履歴（ログ種別：I001）を出力します。

［処理要求］
コマンドからサービスへの処理要求開始履歴（ログ種別：I002）を出力します。

［すべて］
コマンドの実行開始履歴（ログ種別：I001）およびサービス要求履歴（ログ種別：I002）を出力します。

デフォルトは［しない］です。

この項目は，JP1/AJS2の新規のインストール時および新規のセットアップ時に［すべて］が設定されます。

スケジューラーログのプロセスID出力

スケジューラーサービスの履歴情報にプロセスIDを付加して出力するかどうかを指定します。

［しない］
履歴にプロセスIDを付加して出力しません。

［する］
履歴にプロセスIDを付加して出力します。

デフォルトは［しない］です。

この項目は，JP1/AJS2の新規のインストール時および新規のセットアップ時に［する］が設定されます。

スケジューラーサービスログのイベントログ出力

スケジューラーサービスの開始（KAVS0200-I）・終了メッセージ（KAVS0201-I）をWindowsイベントログに出力するかどうかを選択します。デフォルトは［しない］です。

ジョブネットログのイベントログ出力

ジョブネットの開始・終了に関するメッセージをWindowsイベントログに出力するかどうかを次の三つから選択します。

［しない］
ジョブネットの開始・終了に関するメッセージを出力しません。

［すべて］
ジョブネットの開始・終了に関するメッセージを出力します（開始（KAVS0260-I），正常終了（KAVS0261-I）および［選択］で選択できるすべての状態のメッセージを出力します）。

［選択］
ジョブネットの開始・終了に関するメッセージを出力します。ジョブネットの終了状態名を次の中から選択します。状態名は複数選択できます。
・異常終了（KAVS0262-E）
・警告終了（KAVS0268-W）
・保留通知（KAVS0270-I）
・開始遅延（KAVS0275-I）
・終了遅延（KAVS0276-I）
・起動条件監視開始・終了（KAVS0240-IおよびKAVS0241-I）
・繰り越し未実行（KAVS0279-E）
・ジョブネットコネクタ接続エラー（KAVS0243-E，KAVS0244-E，およびKAVS4700-E～KAVS4707-E）

デフォルトは［しない］です。

なお，［すべて］以外を指定した場合は，ジョブネットの開始メッセージ（KAVS0260-I）・正常終了メッセージ（KAVS0261-I）は出力されません。

ジョブログのイベントログ出力

ジョブネット中のジョブの開始・終了に関するメッセージをWindowsイベントログに出力するかどうかを次の三つから選択します。

［しない］
ジョブの開始・終了に関するメッセージを出力しません。

［すべて］
ジョブの開始・終了に関するメッセージを出力します（開始（KAVS0263-I），正常終了（KAVS0264-I）および［選択］で選択できる四つの状態のメッセージを出力します）。

［選択］
ジョブの終了に関するメッセージを出力します。ジョブの終了状態名を次の中から選択します。状態名は複数選択できます。
・異常終了（KAVS0265-E）
・警告終了（KAVS0269-W）
・保留通知（KAVS0271-I）
・終了遅延（KAVS0248-I）

デフォルトは［しない］です。

なお，［すべて］以外を指定した場合は，ジョブの開始メッセージ（KAVS0263-I）・正常終了メッセージ（KAVS0264-I）は出力されません。

4.1.5　スケジューラーオプションを定義する

スケジューラーサービスの起動方法やスケジュールのオプション情報は，［マネージャー環境設定］ダイアログボックスの［スケジューラーオプション］タブで定義してください。

マネージャー環境で設定する［スケジューラーオプション］タブを次に示します。

図4-6　［スケジューラーオプション］タブ（［マネージャー環境設定］ダイアログボックス）

各項目の定義内容を説明します。

（スケジューラーサービス名）の設定

スケジューラーオプションを設定したいスケジューラーサービス名を選択します。リストには，環境設定開始時に指定した論理ホストに登録されているスケジューラーサービスがすべて表示されます。

サービス起動モード

JP1/AJS2サービス起動時に起動されるスケジューラーサービスの起動モードを次の三つから選択します。

なお，起動モード別のジョブネットおよびジョブの状態については，マニュアル「JP1/Automatic Job Management System 2 設計・運用ガイド　15.4.1(3) 起動モード別のジョブネットおよびジョブの状態」を参照してください。

［コールド］
スケジューラーサービスが前回終了したときの登録状態を解除して，スケジューラーサービスが起動します。

［ウォーム］
スケジューラーサービスが前回終了したときの登録状態を保持したまま，スケジューラーサービスが起動します。ただし，スケジューラーサービス終了時に実行中だったジョブネットは終了状態になり，スケジューラーサービスを起動した日の予定に従って実行されます。

［自動継続］
スケジューラーサービスが前回終了したときの登録状態を保持したまま，スケジューラーサービスが起動します。

デフォルトは［ウォーム］です。

ジョブネットのスキップ

スケジューラーサービスを起動した日に実行予定があるジョブネットの，スケジューラーサービス起動時に，すでに実行開始予定時刻を過ぎていた場合の実行方法を次の三つから選択します。なお，上記の［サービス起動モード］が［自動継続］の場合，このオプションおよび実行登録時のオプションに関係なく，すべてのジョブネットが実行されます。

［しない］
当日実行予定があるジョブネットを実行します。スケジューラーサービスの起動時より前に実行を予定していたジョブネットは，スケジューラーサービスの起動と同時に開始されます。ただし，次の場合は実行されません。
・実行登録時に，JP1/AJS2 - Viewの［実行登録］ダイアログボックスで［デーモン起動時に予定時刻超過］に［次回から実行する］を選択したジョブネットの実行予定時刻が過ぎていたとき。
・実行登録時に，ajsentryコマンドに-oオプションを指定したジョブネットの実行予定時刻が過ぎていたとき。

［予定時刻超過］
当日実行予定があるジョブネットを実行します。ただし，スケジューラーサービスの起動時より前に実行を予定していたジョブネットは，繰り越し未実行状態になり実行されません。また，次の場合も実行されません。
・実行登録時に，JP1/AJS2 - Viewの［実行登録］ダイアログボックスで［デーモン起動時に予定時刻超過］に［すぐに実行する］を選択したジョブネットの実行予定時刻が過ぎていたとき。
・実行登録時に，ajsentryコマンドに-oオプションを指定しなかったジョブネットの実行予定時刻が過ぎていたとき。

［当日予定］
当日実行予定があるジョブネットは，すべて繰り越し未実行状態になり実行されません。実行登録時のオプションにも関係なく，スケジューラーサービスの起動日に実行予定のあるジョブネットは，すべて実行されません。

デフォルトは［しない］です。

抑止機能の設定

ジョブネット中のジョブおよびジョブネットの実行を抑止するかどうかを選択します。

［実行抑止］を選択すると，サービスの起動と同時にジョブおよびジョブネットは実行されません。

デフォルトは［抑止しない］です。

繰り越し方法

実行登録したルートジョブネットが開始予定日時を過ぎても実行されなかった場合，いつまで待って繰り越し未実行状態にするのかを次の三つから選択します。この項目は，実行登録の方法に関係なく有効です。

［1日］
予定日を1日超えた場合，ジョブネットを繰り越し未実行状態にします。

［2日］
予定日を2日超えた場合，ジョブネットを繰り越し未実行状態にします。

［繰り越さない］
予定日を過ぎても，ジョブネットを開始時刻待ちまたは保留中のままとします。

デフォルトは［1日］です。

即時実行登録の場合は，登録した日時を開始予定日時として扱います。

ルートジョブネットのスケジュール

ルートジョブネットのスケジュールの有効範囲を次のどちらかから選択します。

なお，一度指定した内容を変更する場合，変更前と変更後ではルートジョブネットの実行スケジュールが異なるため，コールドスタートおよびジョブネットのスケジュールを見直す必要があります。

［24時間］
ルートジョブネットのスケジュールの有効範囲を24時間とします。

［48時間］
ルートジョブネットのスケジュールの有効範囲を48時間とします。
なお，［48時間］は，［Viewの状態取得範囲］に［すべての情報から］を指定している場合だけ選択できます。

デフォルトは［24時間］です。

Viewの状態取得範囲

JP1/AJS2 - Viewに状態を表示する場合に，状態取得の基にする世代情報の範囲を次のどちらかから選択します。

［当日分の情報だけ］
基準時刻の範囲で，当日分の世代情報から表示する状態を決定します。
［当日分の情報だけ］は，［ルートジョブネットのスケジュール］に［24時間］を指定している場合だけ選択できます。［48時間］を指定している場合，［当日分の情報だけ］は選択できません。

［すべての情報から］
当日分に限らず，すべての日にちを範囲として，実行中の世代または予定世代の情報から表示する状態を決定します。

デフォルトは［すべての情報から］です。

ユニット定義変更の即時適用

実行登録後にジョブおよびジョブネットの定義内容を変更した場合，変更した定義内容を実行直前に再読み込みし，変更内容を即時に有効にするかしないかを選択します。

［しない］
ジョブおよびジョブネットの実行直前に定義を再読み込みしません（JP1/AJS2 06-51以前と同じ動作です）。
この場合，定義変更時に実行中であった世代については，変更した最新の定義内容が有効になりません。

［する］
ジョブおよびジョブネットの実行直前に定義を再読み込みします。
この場合，定義変更時に実行中であった世代についても，変更した最新の定義内容が有効になります。

デフォルトは［しない］です。

この項目は，JP1/AJS2の新規のインストール時および新規のセットアップ時に［する］が設定されます。

注意

JP1/AJS2では，実行ファイル名，実行ホスト，保留属性などのユニットの実行に影響するユニット定義情報については実行登録中に変更できます。ただし，定義変更時に実行中であった世代については，変更した最新の定義内容が，有効になるユニット定義情報と，有効にならないユニット定義情報があります。詳細については，マニュアル「JP1/Automatic Job Management System 2 設計・運用ガイド　15.12 実行登録中にユニット定義情報を変更する」を参照してください。

起動条件付きジョブネットの保留属性を引き継がない

起動条件付きジョブネット保留属性の実行世代への引き継ぎをするかどうかを指定します。

起動条件付きジョブネット保留属性の実行世代への引き継ぎをする場合，起動条件付きジョブネット実行世代の保留が，監視中世代の保留属性や起動条件成立タイミングの影響を受けます。

起動条件付きジョブネット保留属性の実行世代への引き継ぎをしない場合，起動条件付きジョブネット実行世代の保留が，保留中世代の保留属性や起動条件成立タイミングの影響を受けません。実行世代に対する保留属性変更に従って，保留状態に遷移します。

起動条件を使用する場合の保留動作を制御するためには，この項目にチェックを付けることをお勧めします。

この項目は，JP1/AJS2の新規のインストール時および新規のセットアップ時にチェックが付きます。

注意

JP1/AJS2 - Viewの保留属性表示機能と実際の動作を一致させるためには，ユニット定義変更の即時適用を「する」に設定し，起動条件付きジョブネットの保留属性を引き継がない設定にする必要があります。

Viewのスケジューラーサービス表示

論理ホスト対応のJP1/AJS2サービスを構築している環境で，JP1/AJS2 - Viewからログインしたときに表示されるスケジューラーサービスの範囲を次のどちらかから選択します。

［この論理ホストのスケジューラーサービスのみ］
JP1/AJS2 - Viewからログインしたときに，指定したホスト名に対応するスケジューラーサービスだけが表示されます。

［すべてのスケジューラーサービス］
ログインしたJP1ユーザーにマッピングされているOSユーザーが，Administrators権限を持つ場合，ログインしたマシンに構築されている定義済みのスケジューラーサービスがすべて表示されます。
それ以外のJP1ユーザーでログインした場合，ログインしたマシンに構築されている定義済みのスケジューラーサービスのうち，ログインしたホストと同一のユーザー認証圏に属するホストのスケジューラーサービスがすべて表示されます。
ただし，ログインした論理ホスト以外のスケジューラーサービスがフェールオーバーしてログインした物理ホスト上にない場合は，該当するスケジューラーサービスへアクセスしないようにしてください。

デフォルトは［この論理ホストのスケジューラーサービスのみ］です。

4.1.6　環境設定パラメーターで定義する

スケジューラーサービス環境は，環境設定パラメーターを設定して定義することもできます。

＜この項の構成＞

(1)　設定手順

(2)　環境設定パラメーター

(1)　設定手順

Windowsの［コントロールパネル］の［管理ツール］から［サービス］を選択し，次に示すサービスを停止する。

JP1/AJS2サービス

JP1/AJS2 Monitorサービス

メモ帳などのテキストエディターで，（2）の環境設定パラメーターを記述した設定ファイルを作成する。

ファイルを保存し，次のコマンドを実行する。

jbssetcnf 設定ファイル名

jbssetcnfコマンドのパスは，「JP1/Baseのインストール先フォルダ¥bin¥jbssetcnf」です。
jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/AJS2を再起動する。
設定ファイルの内容が構成定義に反映されます。

(2)　環境設定パラメーター

スケジューラーサービス環境で設定できる環境設定パラメーターの一覧を次の表に示します。なお，環境設定パラメーターの詳細については，「14.1.3 スケジューラーサービス環境設定パラメーターの定義内容」を参照してください。

表4-1　スケジューラーサービス環境で設定できる環境設定パラメーターの一覧（Windows）

定義キー | 環境設定パラメーター | 定義内容
[JP1_DEFAULT¥JP1AJSMANAGER] | "MAXSESSION"=※1 | 最大同時セション数
"IPC_TIMEOUT"=※1 | リモート通信タイムアウト時間
"IPC_LOCALTIMEOUT"=※1 | ローカル通信タイムアウト時間
"IPCRETRYINTERVAL"=※1 | リトライ間隔
"IPCRETRYCOUNT"=※1 | リトライ回数
"DEFAULTSERVICENAME"=※1 | デフォルトスケジューラーサービス名
"REMNETSERVICENAME"=※1 | リモートジョブネットを実行するスケジューラーサービス名
"AUTORESTARTCOUNT"=※1 | スケジューラーサービスの再起動回数
"RESTARTCLRTIME"=※1 | 再起動回数をクリアーするまでの時間
"MASTERDABEND"=※1 | スケジューラーサービス異常時の処理
"TRACELOGFILE"=※1 | スケジューラートレースログファイルの名称
"EVENTRETRY"=※1 | イベントサービス接続失敗時の処理
"VRSHIFT_IMMINT"=※1 | ジョブネット中断・強制終了時の即時停止の可否
"VRSHIFT_INTRERUN"=※1 | 中断したジョブネットの，後続ユニットの再実行の可否
"AJSINETDLOGSIZE"=※1 | ajsinetd内部ログサイズ
"MONLOG"=※1 | JP1/AJS2 - ViewおよびJP1/AJS2 - Scenario Operationからスケジューラーサービスへの接続開始・終了メッセージの，スケジューラーログへの出力
"MONSYSLOG"=※1 | JP1/AJS2 Monitorサービスおよびモニターサーバの開始・終了メッセージの，Windowsイベントログへの出力
"AUTHLOG"=※1 | ユーザー認証に関するメッセージをスケジューラーログに出力するかしないかの設定
"AUTHSYSLOG"=※1 | ユーザー認証に関するメッセージをWindowsイベントログおよび統合トレースログに出力するかしないかの設定
"REUSELOGON"=※1，※2 | ログオンセッションのプロセス起動方法
"LOGONSHMAX"=※1，※2 | ログオン共有セション数
[{JP1_DEFAULT|論理ホスト名}¥JP1AJSMANAGER]※3 | "LOGSIZE"= | スケジューラーログファイルのサイズ
"AJSLOGFILE1"= | スケジューラーログファイル1の名称
"AJSLOGFILE2"= | スケジューラーログファイル2の名称
"HIDEOTHERLHOST"= | JP1/AJS2 - Viewのスケジューラーサービス表示
"LOGDLOG"= | スケジューラーログ出力プロセス（ajslogd）の起動・停止の履歴をスケジューラーログに出力するかどうかの設定
"LOGDSYSLOG"= | スケジューラーログ出力プロセス（ajslogd）の起動・停止の履歴をWindowsイベントログおよび統合トレースログに出力するかどうかの設定
"AJSLOGOUTPUTYEAR"= | スケジューラーログの日付に「年」を出力するかしないかの設定
"AJSLOGOUTPUTEXTEND"= | スケジューラーログの拡張出力の設定
[{JP1_DEFAULT|論理ホスト名}¥JP1AJSMANAGER¥スケジューラーサービス名]※3 | "AUTOSTART"= | スケジューラーサービスの自動起動
"SESSIONTIMEOUT"= | 接続打ち切り時間
"AJSSERVICEID"= | スケジューラーサービスの識別番号
"AJSDBTYPE"= | データベース種別
"AJSDBDIRECTORY"= | データベースディレクトリ名
"ISAMWRITEMODE"= | ISAMファイル更新時の書き込み方法
"TABLENAMEPREFIX"= | テーブル名プリフィックス
"TABLENAMEPOSTFIX"= | テーブルID
"RDBAUTHID"= | RDB認可識別子
"RDBUSER"= | RDBアクセスユーザー名
"RDBPASSWORD"= | RDBユーザーパスワード
"RDBCHECKINTERVAL"= | RDBサーバ接続確認の間隔
"RDBHOST"= | RDB接続先ホスト名
"RDBPORT"= | RDB接続ポート番号
"RDBIPC"= | HiRDBサーバとの通信方式
"RDBSENDMEMSIZE"= | HiRDBプロセス間メモリー通信使用時の，送信用メモリーサイズ
"RDBRECVMEMSIZE"= | HiRDBプロセス間メモリー通信使用時の，受信用メモリーサイズ
"RDBCONNECTWAITTIME"= | RDBへの接続の最大待ち合わせ時間
"AJSCHARCODE"= | 文字コード
"AJSTMPDIR"= | テンポラリーファイル用ディレクトリ名
"JOBINFDIR"= | ジョブエラー情報ディレクトリ名
"AJSBKUROOT"= | 退避情報ディレクトリ名
"HNTRLOGLEVEL"= | 統合トレースログに出力するメッセージレベル
"AJSSYSLOG"= | スケジューラーサービスの起動・終了メッセージの，Windowsイベントログへの出力
"NETSYSLOG"= | ジョブネット起動・終了メッセージの，Windowsイベントログへの出力
"JOBSYSLOG"= | ジョブネット中のジョブの開始・終了メッセージの，Windowsイベントログへの出力
"AJSLOG"= | スケジューラーサービスの起動・終了メッセージの，スケジューラーログファイルへの出力
"NETLOG"= | ジョブネット起動・終了メッセージの，スケジューラーログファイルへの出力
"JOBLOG"= | ジョブネット中のジョブの開始・終了メッセージの，スケジューラーログファイルへの出力
"OPELOG"= | 操作履歴の出力
"LOGINFOALL"= | ログの出力形式
"REFLOG"= | 参照履歴の出力
"LOGHEADER"= | 履歴情報にプロセスIDを付加して出力
"INFOLOG"= | 情報用履歴の出力
"ROOTJOBNETSCHEDULERANGE"= | ルートジョブネットのスケジュールの有効範囲
"VIEWSTATUSRANGE"= | 状態取得の基にする世代情報の範囲（JP1/AJS2 - Viewの状態表示ための定義）
"STARTMODE"= | サービスの起動方法
"OVERSCHEDULE"= | ジョブネットのスキップ方法
"SUPPRESS"= | ジョブネット中のジョブ・ジョブネットの実行抑止方法
"EXECDEFER"= | ジョブネットの繰り越し方法
"JOBSTATUSPORT"= | ジョブ状態取得ポートのサービス名
"QUEUELESSMULTIREQ"= | キューレスジョブリクエスト多重度
"MFPOLLINTERVAL"= | JP1/AJS2 for Mainframeに状態を問い合わせるポーリング間隔
"MFUSERNAME"= | JP1/AJS2 for Mainframeと連携する際に使用するJP1ユーザー名
"UNITDEFINERELOAD"= | ジョブネット定義変更の即時反映の有無
"INHERITCONDHOLD"= | 起動条件付きジョブネット保留属性の実行世代への引き継ぎ動作
"MAXSAVEGEN"= | 最大保存世代数
"AJSPRINTNETSCHPRF"= | ネストジョブネットの，スケジュールルールの扱い方
"SUBMITRETRYINTERVAL"= | サブミット処理でのリトライ処理間隔
"CONDEXECDEFER"= | 起動条件待ち世代の繰り越し未実行への遷移の可否
"JOBEXECIPCBUFSIZE"= | スケジューラーサービスのジョブ実行情報通信バッファサイズ
"BACKGROUNDLEAVE"= | 登録解除や保存世代数管理による世代削除の処理方式
"WARMSTARTMSG"= | スケジューラーサービスをウォームスタートで起動させたときに，実行中であったジョブまたはジョブネットの終了メッセージ，および終了イベントの出力有無の設定
"MONITORINGINVALIDHOLD"= | 起動条件監視中世代に対する保留操作時の動作
"REQDAGTREQCONNECTTIMEOUT"= | キューレスエージェントへの通信タイムアウト時間
"REQDAGTRECONNECTTIMEOUT"= | キューレスエージェントとの通信回復処理の通信タイムアウト時間
"COMMANDEVENT"= | コマンドまたはJP1/AJS2 - Viewからの操作時のJP1イベント発行有無の設定
"NONRELOADHOLDING"= | 保留中状態のユニット定義再読み込み動作設定
"RJCUSE"=※4 | ジョブネットコネクタで異なるスケジューラーサービス間のルートジョブネットの実行順序を制御するかどうかの設定
"JOBDELAYWARNMSG"= | スケジューラーサービスの停止中に，実行所要時間によって終了遅延を監視しているジョブがエージェントで実行開始した場合のメッセージを，スケジューラーサービス起動時に統合トレースログに出力するかどうかの設定
"FGRECONLMT"=※4 | フロー制御プロセスとスケジューラーサービス間通信制御プロセスが通信接続できなかった場合の再接続回数

注※1

この項目は必ず「[JP1_DEFAULT¥JP1AJSMANAGER]」キーの直下に指定してください。

注※2

この環境設定パラメーターはWindows版だけで指定できます。定義内容の詳細については，以降の説明を参照してください。

注※3

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

注※4

定義内容の詳細については，「4.7.11 ジョブネットコネクタで異なるスケジューラーサービス間のルートジョブネットの実行順序を制御するための設定」を参照してください。

注意

スケジューラーサービスは，1台のマシンにつき物理ホストと論理ホストを合わせて20個まで作成できます。サービス名は，自ホストの物理ホストおよびすべての論理ホストで名称が重複しないように指定してください。サービス名は30バイト以内で指定し，半角英数字および次の記号が使用できます。

「!」，「#」，「$」，「%」，「+」，「-（ハイフン）」，「.（ピリオド）」，「_（アンダーバー）」

全角文字や半角カナ，および上記以外の記号は使用しないでください。

推奨しない文字を使用すると，コマンドインタープリターがコマンドラインを解析する際にスケジューラーサービス名を正しく認識できず，誤動作することがあります。

Windowsだけで使用できる環境設定パラメーターを次に説明します。

"REUSELOGON"={"yes"|"no"}

OSのユーザーアカウントでログオンして実行されるセションのプロセス起動方法を次のどちらかから選択します。

yes
同一のOSユーザーへマッピングし実行されるセションのログオン情報を保存して再利用します。
この指定を行うことによって，同一のOSユーザーへマッピングし実行されるセションがデスクトップヒープを共有するようになり，デスクトップヒープ領域の消費を抑えることができます。
同一のOSユーザーへマッピングし実行されるセションが同時に多数あり，デスクトップヒープ領域の不足によってプロセスが起動できない場合に指定してください。なお，この指定を行った場合，OSのユーザー情報を変更したときには，JP1/AJS2 Monitorサービスの再起動が必要になります。

no
同一のOSユーザーへマッピングし実行されるセションのログオン情報を再利用しません。
デフォルトは「no」です。
この項目は，JP1/AJS2 Monitorサービスの起動時に有効になります。
この項目は，次に示す操作に伴うセションのプロセス起動に適用されます。
・JP1/AJS2 - Viewの接続
・コマンドのリモート実行
・リモートジョブネットの実行
・JP1/AJS2 - Definition Assistantからの操作
・JP1/AJS2 - Scenario Operationからの操作

"LOGONSHMAX"=dword:ログオン共有セション数

ログオンの再利用を行うとき，ログオン情報を共有するセションの数を1～128の間で指定します。

同一OSユーザーのセション数が，ここで指定する数を超えた場合，新たにデスクトップヒープを割り当てます。

デフォルトは「dword:00000032」です。

環境設定パラメーターREUSELOGONを「yes」にした場合だけ指定できます。

この項目は，JP1/AJS2 Monitorサービスの起動時に有効になります。

「ログオン共有セション数」の見積もり方法

デスクトップヒープ領域が不足した場合は，「ログオン共有セション数」を次に示す範囲で調整してください。

なお，非対話型プロセスに割り当てられるデスクトップヒープの大きさについては，OSのドキュメントを参照してください。

ログオン共有セション数 <
非対話型プロセスに割り当てられるデスクトップヒープの大きさ(キロバイト) / 10(キロバイト)

4.2　ジョブ実行環境の設定

ジョブ実行環境の設定は，マネージャー環境とエージェント環境では異なります。

それぞれの環境で設定する内容を次に示します。

＜この節の構成＞

4.2.1　マネージャー環境の設定

4.2.2　エージェント環境の設定

4.2.1　マネージャー環境の設定

ジョブ実行環境を設定する場合に，［マネージャー環境設定］ダイアログボックスで定義する項目および環境設定パラメーターでの設定方法を説明します。

各項目の推奨値と設定が有効になる時期については，マニュアル「JP1/Automatic Job Management System 2 設計・運用ガイド　5.3.2 ジョブ実行環境に関する環境設定について検討する」を参照してください。

＜この項の構成＞

(1)　ジョブ実行環境を定義する

(2)　ジョブ実行環境を変更する

(3)　環境設定パラメーターで定義する

(1)　ジョブ実行環境を定義する

ジョブ実行時に必要な情報は，［マネージャー環境設定］ダイアログボックスの［ジョブ実行環境］タブで定義してください。

マネージャー環境で設定する［ジョブ実行環境］タブを次に示します。

図4-7　［ジョブ実行環境］タブ（［マネージャー環境設定］ダイアログボックス）

各項目の定義内容を説明します。

マネージャープロセス実行時のワークディレクトリ名

ジョブ実行管理用のワークフォルダの名称を180バイト以内で指定します。フォルダ名はフルパスで指定します。デフォルトは「JP1/AJS2 - Managerのインストール先フォルダ¥tmp」です。

エージェントプロセス実行時のワークディレクトリ名

このホストでジョブを実行する場合のワークフォルダの名称を180バイト以内で指定します。フォルダ名はフルパスで指定します。デフォルトは「JP1/AJS2 - Managerのインストール先フォルダ¥tmp」です。

データベース格納ディレクトリ名

ジョブ実行環境情報やジョブ情報が書き込まれるISAMファイルを格納するフォルダの名称を180バイト以内で指定します。フォルダ名はフルパスで指定します。デフォルトは「JP1/AJS2 - Managerのインストール先フォルダ¥database¥queue」です。

データファイル更新モード

ISAMファイルの更新時に，同期書き込みを許可するかどうかを次のどちらかから選択します。

［同期］
ファイル更新時に，常に同期書き込みを実行します。この方法で書き込みを実行した場合，信頼性は向上しますが，性能は低下します。

［非同期］
JP1/AJS2の処理とは同期を取らないで，OSのバッファーリングによってディスクに書き込みます。

デフォルトは［同期］です。

システム内の最大ジョブ数

システム内の作業領域上に保持できる最大ジョブ数を1～81,920の間で指定します。デフォルトは「2000」です。

JP1/AJS2サービス起動時に，ここで設定した値分のジョブ情報領域がメモリーに確保されます。運用時のキューイングジョブのピーク数を十分に補える値を設定してください。

ジョブ情報領域がすべて使用されていると（この項目の設定値と同数のジョブがキュー中に残っていると），サブミットが失敗してしまいます。

なお，この指定で対象となるジョブは，キューイング中（時間待ち，保留中を含む）および実行中のジョブです。終了したジョブ，イベントジョブ，判定ジョブは対象外です。

システム内の警告ジョブ数

システム内に保持されている作業領域上のジョブ情報領域の使用状況によって警告メッセージを出力するためのしきい値を1～81,920の間で指定します。デフォルトは「1600」です。

なお，この指定で対象となるジョブは，キューイング中（時間待ち，保留中を含む）および実行中のジョブです。終了したジョブ，イベントジョブ，判定ジョブは対象外です。

キューの最大定義数

キューを定義できる最大数を1～8,192の間で指定します。JP1/AJS2サービス起動時に，ここで設定した値分のキュー情報領域がメモリーに確保されます。デフォルトは「100」です。

注意

1台のマネージャーで使用できるキューの最大数は，エージェントで使用するデフォルトキューの数を含みます。ただし，［キューの最大定義数］には，デフォルトキューの数を除いた値を指定してください。ここで指定するキューの最大定義数と，1台のマネージャーで使用できるキューの最大数は次のような関係です。

［キューの最大定義数］で指定する値+［エージェントの最大定義数］で指定する値=1台のマネージャーで使用できるキューの最大数

ただし，UNIXホストでキューの最大定義数を指定する場合，ジョブ実行環境設定ファイル（Queue.conf）のMaximumQueueパラメーターには，デフォルトキューの数を含めた値を指定してください。

キューの最大定義数の指定方法は，Windowsホストの場合とUNIXホストの場合とで異なるので，注意してください。

エージェントの最大定義数

1台のJP1/AJS2 - Managerに対して，ジョブを実行するJP1/AJS2 - Agentの最大数を1～1,024の間で指定します。JP1/AJS2サービス起動時に，ここで設定した値分のエージェント情報領域がメモリーに確保されます。デフォルトは「50」です。

ここで指定した数を超えてJP1/AJS2 - Agentと接続しようとした場合，接続できなくなります。

エージェント監視インターバル

ジョブ実行先のエージェントを監視する間隔を60～86,400（単位：秒）の間で指定します。デフォルトは「300」です。

排他実行リソースの最大定義数

ジョブの同時実行を抑止するために使用する排他実行リソースの最大数を1～8,192の間で指定します。ここで設定した値分の排他実行リソース情報領域が，サービス起動時にメモリー確保されます。デフォルトは「50」です。

なお，この指定で対象となるジョブにイベントジョブは含まれません。

排他実行リソースは，ジョブネットに定義されたジョブでは使用できません。一方，jpqjobsubコマンドに定義されたサブミットジョブでは使用できます。

コマンドの詳細については，マニュアル「JP1/Automatic Job Management System 2 コマンドリファレンス　1. コマンド」を参照してください。

ジョブ情報保存日数

ジョブの実行結果情報を何日前のものまで保存しておくのかを0～999（単位：日）の間で指定します。デフォルトは「7」です。

この項目は，JP1/AJS2の新規のインストール時および新規のセットアップ時に「1」が設定されます。

ジョブ情報の保存日数は，ジョブ情報の件数が20万件を超えないように設定してください。例えば，1日当たりのジョブ件数が2万件の場合は，保存日数を10日以内に設定してください。「0」を指定した場合，実行結果情報はジョブの実行終了時に削除されます。

ジョブ情報の保存日数を0日とした場合の，保存時間の設定方法については，マニュアル「JP1/Automatic Job Management System 2 設計・運用ガイド　8.1.7(2) ジョブ情報の保存日数を0日にした場合の効果およびジョブ情報の保存時間の設定」も参照してください。

なお，この指定で対象となるジョブにイベントジョブは含まれません。

注意事項

ジョブ情報保存日数は，ジョブ実行環境データベースに格納されたジョブ情報を保存する日数です。この指定で保存日数の値を小さくしても，スケジューラーデータベースが管理するジョブネットの世代保存数には影響しません。

また，ジョブ情報保存日数の値を小さく変更したあと，次のジョブ情報削除基準時刻またはJP1/AJS2サービス再起動時に，削除対象のジョブ情報が大量にあると，ジョブ情報の削除処理と競合してジョブの実行性能が低下したり，システムへの負荷が高くなったりすることがあります。

ジョブの実行数が少ない時間帯に変更したり，段階的に保存日数の値を小さくしたりするなど，設定の変更には十分に注意してください。

ジョブ情報削除の基準時刻

ジョブの実行結果情報を削除する時刻を0:00～23:59の間で指定します。

デフォルトは「0:00」です。

ただし，JP1/AJS2サービス起動時にもジョブの実行結果情報が削除されます。その際，サービス起動時刻を基準時刻として，保存日数以前のジョブ実行結果情報が削除されます。その後は，この設定値の時刻にジョブの実行結果情報を削除するようになります。

なお，サービス起動時にジョブ情報を削除しない設定もできます。

詳細については，「7.7 ジョブ情報削除処理に関する設定」を参照してください。

また，この指定で対象となるジョブにイベントジョブは含まれません。

エージェントを自動定義する

ジョブをサブミットしたときにエージェントを自動定義するかどうかを指定します。

自動定義する場合，この項目が指定されたマネージャーホストを使用するすべてのジョブのサブミットに対して，エージェントの自動定義機能が有効になります。

この機能を使用できるのは，ジョブネットに定義されたPCジョブ，UNIXジョブ，アクションジョブ，jpqjobsubコマンドに定義されたサブミットジョブを実行するときです。QUEUEジョブ，イベントジョブは対象外です。

エージェントは，ジョブのサブミット時に作成されます。例えジョブの実行に失敗しても，エージェントは作成されたままとなります。いったん作成されたエージェントは，JP1/AJS2再起動後も有効です。

作成されるエージェントのデフォルトキューの属性は次のとおりです。

　ジョブの実行多重度：24時間，実行多重度は5

　最大ジョブ数：100

　最大警告数：80

　キュー受付口状態：open

　キュー取出口状態：open

　接続エージェント：自エージェントホスト

　エージェントの優先順位：1

なお，デフォルトキューの属性は，あらかじめ構成定義情報でカスタマイズできます。

詳細については，「7.5 エージェント自動定義機能で作成されるキュー属性値をカスタマイズする設定」を参照してください。この設定をすると，エージェント自動定義機能を使用して作成されるすべてのエージェントの属性値に対して有効になります。また，デフォルトキューの属性は，jpqagtalt，jpqquealt，jpqqueopen，jpqqueclose，jpqagtlinkおよびjpqagtunlinkコマンドでも変更できます。

コマンドの詳細については，マニュアル「JP1/Automatic Job Management System 2 コマンドリファレンス　1. コマンド」を参照してください。

注意

この機能は，既存のエージェント（ジョブ実行環境）に障害が発生したため，緊急に代替エージェントを作成し，ジョブを実行しなければならなくなった場合など，やむを得ない場合にだけ使用してください。通常の運用では，エージェントはジョブ実行前に作成しておいてください。運用途中でエージェントを追加する必要が生じた場合は，jpqimportコマンドやjpqagtaddコマンドを使用してエージェントを追加してください。

コールドスタート時のデータベースの初期化

JP1/AJS2サービスのコールドスタート時に，ジョブ実行環境データベースのジョブ情報を初期化するかどうかを指定します。

［しない］
JP1/AJS2サービスのコールドスタート時に，ジョブ実行環境データベースのジョブ情報を初期化しません（06-71以前の動作と同じです）。

［する］
JP1/AJS2サービスのコールドスタート時に，ジョブ実行環境データベースのジョブ情報を初期化します。ただし，自動起動しない設定のスケジューラーサービスが存在する場合は初期化しません。

デフォルトは「する」です。

(2)　ジョブ実行環境を変更する

ジョブ実行環境は，デフォルトで実行ホスト（エージェント）が一つ，ローカルホストに作成されます。しかし，システムによっては，ジョブの実行環境を変更する（ジョブ実行環境に構成定義情報を追加する）必要があります。例として次の場合があります。

実行ホストが複数台ある場合

他システム（JP1/NQSEXECやJP1/OJEなど）と連携する場合

ジョブを複数の実行ホストで分散実行する場合

特定ジョブ同士を排他実行する場合

ジョブの実行環境を変更する（ジョブ実行環境に構成定義情報を追加する）必要がある場合は，次に示すどちらかの方法で，新たに実行ホスト（エージェント），キュー，または排他実行リソースの構成定義情報を追加する必要があります。

ジョブ実行環境に構成定義情報を一括で追加する

運用中にジョブ実行環境の構成定義情報を動的に追加する

ジョブの実行環境を一括で定義したい場合は，jpqimportコマンドを使用してください。このコマンドを使用すると，ジョブ実行環境のデータベースが再作成され，ジョブ実行環境を一括定義できます。

また，jpqagtadd，jpqqueaddなどのコマンドを使用して，データベース作成後にエージェントやキューなどを追加，削除，変更することもできます。

jpqimportコマンドの詳細については，「20. セットアップ時に使用するコマンド　jpqimport」を参照してください。その他のコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 2 コマンドリファレンス　1. コマンド」を参照してください。

運用中にジョブ実行環境を変更したい場合は，jpqagtadd，jpqqueadd，jpqresaddなどのコマンドを使用してください。

(a)　ジョブ実行環境に構成定義情報を一括で追加する

ここでは，jpqimportコマンドを使用して,ジョブの実行環境を一括定義する方法を説明します。

ジョブ実行環境構成定義ファイル（jpqsetup.conf）をコピーしてエディターで開き，使用するキューとエージェントを設定する。
構成定義ファイルのパスは，「JP1/AJS2 - Managerのインストール先フォルダ¥conf¥jpqsetup.conf」です。
ファイルに書き込む内容の詳細については，「20. セットアップ時に使用するコマンド　jpqimport」の説明を参照してください。
ファイルの記述例を次に示します。

図4-8　ジョブ実行環境構成定義ファイルの記述例

編集した構成定義ファイルを保存する。

ジョブ実行環境のデータベースフォルダにあるファイルをすべて削除する。
JP1/AJS2サービスを必ず停止してから，ファイルを削除してください。
ジョブ実行環境のデータベースフォルダは，［マネージャー環境設定］ダイアログボックスの［ジョブ実行環境］タブの［データベース格納ディレクトリ名］で指定したフォルダです。インストール時の物理ホストでは，「JP1/AJS2 - Managerのインストール先フォルダ¥database¥queue」です。

jpqimportコマンドを実行する。
ジョブ実行環境のデータベースが再作成され，ジョブ実行環境が設定されます。
jpqimportコマンドの文法および注意事項については，「20. セットアップ時に使用するコマンド　jpqimport」の説明を参照してください。

(b)　運用中にジョブ実行環境の構成定義情報を動的に追加する

jpqagtadd，jpqqueaddなどのコマンドを使用してJP1/AJS2の運用中にエージェントやキューなどを追加，削除，または変更できます。運用中に，ジョブ実行環境に構成定義情報を追加する場合は，jpqagtadd，jpqqueadd，jpqresaddなどのコマンドを使用してください。また，運用中にジョブ実行環境の構成定義情報を変更する場合は，jpqagtalt，jpqquealtなどのコマンドを使用してください。各コマンドの詳細については，マニュアル「JP1/Automatic Job Management System 2 コマンドリファレンス　1. コマンド」を参照してください。

jpqagtaddコマンドで実行ホスト（エージェント）を追加する手順を次に示します。

エージェントを追加し，ジョブ実行多重度を設定する。
追加するエージェントのホスト名はIPアドレス解決できることを確認しておく必要があります。ジョブ実行多重度を省略すると，24時間，実行多重度は0が仮定されます。ジョブ実行多重度が0の場合，ジョブは実行できません。ジョブを実行する場合は1以上を指定するか，jpqagtaltコマンドでジョブ実行多重度を変更してください。ジョブ実行多重度の指定例については，マニュアル「JP1/Automatic Job Management System 2 コマンドリファレンス　1. コマンド　jpqagtalt」の補足事項も参照してください。

jpqagtadd -ah エージェント名 -cp ジョブ実行多重度の設定

デフォルトキューの受付口を開く。
エージェントを作成すると同時に同名のデフォルトキューが作成されます。jpqagtaddコマンドでエージェントを追加した直後は，キューの受付口が閉じているのでジョブを登録できません。jpqqueopenコマンドを使用してキューの受付口を開いてください。

jpqqueopen -ah エージェント名 -en

デフォルトキューのジョブ数の最大値および警告値を変更する。
ジョブ数の最大値および警告値は，デフォルトで最大値（4,294,967,295）が設定されています。特に制限する必要がない場合，変更する必要はありません。

jpqquealt -ah エージェント名 -mj ジョブ数の最大値 -wj ジョブ数の警告値

接続するエージェントを追加したり，接続先エージェントの優先順位を設定したりする。
jpqagtaddコマンドで追加したエージェントは，デフォルトキューと接続されています。このデフォルトキューにエージェントを複数台接続して，ジョブの実行を分散させる場合などに変更してください。優先順位を指定して複数のエージェントを接続すると，指定された優先順位に従ってエージェントへジョブを配信します。

jpqagtlink -ah エージェント名 -lh エージェント名 -clp 接続先エージェントの優先順位

設定内容を確認する。
jpqagtshowコマンド，jpqqueshowコマンドを実行して，手順1～4の設定内容が正しいことを確認してください。

jpqagtshow -ah エージェント名

jpqqueshow -ah エージェント名

(3)　環境設定パラメーターで定義する

ジョブ実行環境は，環境設定パラメーターを設定して定義することもできます。

(a)　設定手順

JP1/AJS2のサービスを停止する。
Windowsの［コントロールパネル］の［管理ツール］から［サービス］を選択し，次に示すサービスを停止します。

JP1/AJS2サービス

注意事項

クラスタシステムの場合は，クラスタの設定を確認し，論理ホストのJP1/AJS2サービスも停止してください。

メモ帳などのテキストエディターで，（2）の定義パラメーターを記述した設定ファイルを作成する。
設定ファイルのファイル名は任意です。

ファイルを保存し，次のコマンドを実行する。

jbssetcnf 設定ファイル名

jbssetcnfコマンドのパスは，「JP1/Baseのインストール先フォルダ¥bin¥jbssetcnf」です。
jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/AJS2を再起動する。
設定ファイルに記述した内容が反映されます。

(b)　環境設定パラメーター

ジョブ実行環境で設定できる環境設定パラメーターの一覧を次の表に示します。なお，環境設定パラメーターの詳細については，「14.2.2 マネージャー環境（JP1/AJS2 - Manager）で設定する内容」を参照してください。

表4-2　環境設定パラメーター一覧（JP1/AJS2 - Manager）（Windows）

定義キー | 環境設定パラメーター | 定義内容
[{JP1_DEFAULT|論理ホスト名}¥JP1NBQMANAGER¥Process]※1 | "WorkPath"= | マネージャープロセス実行時のワークディレクトリ名
"IsHA"= | マネージャープロセスのクラスタ環境設定の定義
[{JP1_DEFAULT|論理ホスト名}¥JP1NBQMANAGER¥Database]※1 | "DatabasePath"= | データベース格納ディレクトリ名
"PreserveTerm"= | ジョブ情報の保存日数
"StandardTime"= | ジョブ情報削除の基準時刻
"FlashOption"= | データファイル更新モード
"DeleteFlashOption"= | ジョブ情報削除処理非同期オプション
"PreserveMinute"= | ジョブ情報保存日数0日指定時のジョブ情報の保存時間
"StartUpDelete"= | JP1/AJS2サービス起動時のジョブ情報削除処理抑止オプション
"ColdStartMode"= | JP1/AJS2サービスのコールドスタート時のデータベース初期化
[{JP1_DEFAULT|論理ホスト名}¥JP1NBQMANAGER¥Queue]※1 | "MaximumQueue"= | キューの最大定義数
[{JP1_DEFAULT|論理ホスト名}¥JP1NBQMANAGER¥Job]※1 | "MaximumContentJob"= | システム内の最大ジョブ数
"AlartContentJob"= | システム内の警告ジョブ数
"ReceiveFileSizeStatus"= | ファイルサイズが上限値に達したときの動作
"LimitReceiveFileSize"= | ファイルサイズの上限値
"ReceiveFileOption"= | ジョブ結果ファイルの二重受信防止の定義
"QueuingJobRecoveryTime"= | キューイング中のジョブに対するエージェントの障害回復待ち時間
"ExecutingJobRecoveryTime"= | 実行中のジョブに対するエージェントの障害回復待ち時間
"MaximumExecJobLogOption"= | ジョブ実行多重度到達を確認するメッセージを出力する設定
"MaximumExecJobLogInterval"= | ジョブ実行多重度到達を確認するメッセージを出力する間隔
"PreventChangeJobOrder"= | サブミットジョブの実行順序の入れ替わりを防止する設定
"EnumJobSaveMemory"= | ジョブ情報列挙時にジョブ実行制御マネージャーのメモリー消費量を少なくする設定
[{JP1_DEFAULT|論理ホスト名}¥JP1NBQMANAGER¥Network]※1 | "ConnectTimeout"=※2 | ジョブ実行制御マネージャーのTCP/IP通信接続タイムアウト値の定義
"CommunicateRetryCount"=※2 | ジョブ実行制御マネージャーのTCP/IP通信接続エラーのリトライ回数の定義
"CommunicateRetryInterval"=※2 | ジョブ実行制御マネージャーのTCP/IP通信接続エラーのリトライ間隔の定義
[{JP1_DEFAULT|論理ホスト名}¥JP1NBQMANAGER¥Agent]※1 | "MaximumAgent"= | エージェントの最大定義数
"ObserveInterval"= | エージェント監視インターバル
"AutoCreate"= | ジョブサブミット時のエージェント自動定義の制御フラグ
"AutoCreateExecJobs"= | エージェント自動定義時のジョブの実行多重度
"AutoCreateMaxJobs"= | エージェント自動定義時のジョブ数の最大値
"AutoCreateWarnJobs"= | エージェント自動定義時のジョブ数の警告値
"AutoCreatePriority"= | エージェント自動定義時のエージェント優先順位
"LeastRecentlyUsed"= | ジョブを配信するエージェントホストの決定方式
[{JP1_DEFAULT|論理ホスト名}¥JP1NBQMANAGER¥Resource]※1 | "MaximumResource"= | 排他実行リソースの最大定義数
[{JP1_DEFAULT|論理ホスト名}¥JP1NBQAGENT¥Process]※1 | "WorkPath"= | エージェントプロセス実行時のワークディレクトリ名
"IsHA"= | エージェントプロセスのクラスタ環境設定の定義
[{JP1_DEFAULT|論理ホスト名}¥JP1NBQAGENT¥Job]※1 | "IsExecFindExecutable"=※3 | ジョブをロングファイル名で実行するための定義
"LoadUserProfile"=※3 | ユーザープロファイルを読み込むかどうかの定義
"IsAccessTokenCache"=※3 | ジョブ実行時にアクセストークンを再利用するための設定
"DISABLE_FS_REDIRECTION"=※3 | ジョブの実行先サービスに［JP1/AJS2］を指定している場合に，WOW64環境でジョブを実行する際にファイルシステムリダイレクトを無効にする設定
"MergeEnvMode"= | システム環境変数とジョブ定義の環境変数が重複した場合に，ジョブ定義の環境変数を有効にするかどうかの設定
[{JP1_DEFAULT|論理ホスト名}¥JP1NBQAGENT¥Network]※1 | "NotfyJobStateInterval"= | ジョブの結果ファイルの再送間隔
"NotfyJobStateCount"= | ジョブの結果ファイルの再送回数
"ConnectTimeout"=※2 | ジョブ実行制御エージェントのTCP/IP通信接続タイムアウト値の定義
"CommunicateRetryCount"=※2 | ジョブ実行制御エージェントのTCP/IP通信接続エラーのリトライ回数の定義
"CommunicateRetryInterval"=※2 | ジョブ実行制御エージェントのTCP/IP通信接続エラーのリトライ間隔の定義
[{JP1_DEFAULT|論理ホスト名}¥JP1NBQAGENT¥Variable]※1 | "変数名"=※4 | 変数名に対応した実行プログラムの，そのホストでのインストールディレクトリ。
[{JP1_DEFAULT|論理ホスト名}¥JP1NBQCLIENT¥PathEnv]※1 | "All Users"=※5 | 転送元ファイルの検索パス
"JP1ユーザー名"=※5 | 転送元ファイルの検索パス
[{JP1_DEFAULT|論理ホスト名}¥JP1NBQCLIENT¥Network]※1 | "ConnectTimeout"=※2 | ジョブ実行に使用するコマンドおよびスケジュール制御のTCP/IP通信接続タイムアウト値の定義
"CommunicateRetryCount"=※2 | ジョブ実行に使用するコマンドおよびスケジュール制御のTCP/IP通信接続エラーのリトライ回数の定義
"CommunicateRetryInterval"=※2 | ジョブ実行に使用するコマンドおよびスケジュール制御のTCP/IP通信接続エラーのリトライ間隔の定義
"CommunicateTimeout"=※6 | ジョブ実行制御のマネージャープロセスに対する通信タイムアウト時間
[{JP1_DEFAULT|論理ホスト名}¥JP1NBQCLIENT¥Process]※1 | "MacroOptionReplaceMode"= | マクロ変数の引き継ぎ情報がNULL文字列の場合の置き換え方法の設定
"IsHA"= | ジョブ実行に使用するコマンドおよびスケジュール制御のクラスタ環境設定の定義
[{JP1_DEFAULT|論理ホスト名}¥JP1NBQNOTIFY¥Network]※1 | "ConnectTimeout"=※2 | ジョブ実行制御状態通知プロセスのTCP/IP通信接続タイムアウト値の定義
"CommunicateRetryCount"=※2 | ジョブ実行制御状態通知プロセスのTCP/IP通信接続エラーのリトライ回数の定義
"CommunicateRetryInterval"=※2 | ジョブ実行制御状態通知プロセスのTCP/IP通信接続エラーのリトライ間隔の定義
[{JP1_DEFAULT|論理ホスト名}¥JP1NBQNOTIFY¥Process]※1 | "IsHA"= | ジョブ実行制御状態通知プロセスのクラスタ環境設定の定義

注※1

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

注※2

定義内容の詳細については，「7.19 TCP/IP通信接続エラーのリトライ間隔・回数の変更」を参照してください。

注※3

この環境設定パラメーターはWindows版だけで指定できます。定義内容の詳細については，以降の説明を参照してください。

注※4

定義内容の詳細については，「7.1 ジョブ実行時のワークパスを変数として定義する」を参照してください。

注※5

定義内容の詳細については，「7.3 転送元ファイルの検索パスを定義する」を参照してください。

注※6

定義内容の詳細については，

「7.32 ジョブ実行制御のマネージャープロセスに対する通信タイムアウト時間の変更」を参照してください。

Windowsだけで使用できる環境設定パラメーターを次に説明します。

"IsExecFindExecutable"=dword:設定値

ジョブの実行ファイルをショートファイル名に変換しないでロングファイル名で実行するかどうかを指定します。

0

変換してショートファイル名で実行します。

1

変換しないでロングファイル名で実行します。

デフォルトは「0」です。

詳細については「7.2 ジョブをロングファイル名で実行するための設定」を参照してください。

"LoadUserProfile"=dword:設定値

ジョブを実行するOSユーザーのユーザープロファイル情報をジョブ実行時に読み込むかどうかを指定します。

0

ユーザープロファイルを読み込みません。

1

ユーザープロファイルを読み込みます。

デフォルトは「0」です。

「1」を指定する場合は，IsAccessTokenCacheにも「1」を設定してください。

詳細については「7.6 ユーザープロファイルを必要とするジョブを実行するための設定」を参照してください。

"IsAccessTokenCache"=dword:設定値

ジョブ実行時にアクセストークンを再利用するかどうかを指定します。

0

ジョブを実行するごとにアクセストークンを取得し，実行終了後に解放します。

1

ジョブ実行時に「ユーザー名」「ドメイン名」「パスワード」が同一のアクセストークンが保存されている場合，アクセストークンを再利用してジョブを実行します。

デフォルトは「0」です。

LoadUserProfileに「1」を設定し，ユーザープロファイル情報を読み込む場合は，この値にも「1」を設定してください。

詳細については「7.26 ジョブ実行時にアクセストークンを再利用するための設定」を参照してください。

"DISABLE_FS_REDIRECTION"=dword:設定値

ジョブの実行先サービスに［JP1/AJS2］を指定している場合に，WOW64環境でジョブを実行する際にファイルシステムリダイレクトを無効にするかどうかを指定します。

0

WOW64環境でジョブを実行する際に，ファイルシステムリダイレクトが有効になります。

1

WOW64環境でジョブを実行する際に，ファイルシステムリダイレクトが無効になります。

デフォルトは「0」です。

詳細については「7.28 WOW64環境でジョブを実行する際にファイルシステムリダイレクトを無効にする設定」を参照してください。

"MergeEnvMode"=dword:設定値

システム環境変数とジョブ定義の環境変数が重複した場合に，ジョブ定義の環境変数を有効にするかどうかを指定します。

0

システム環境変数と重複するジョブ定義の環境変数を有効にしない場合に指定します。

1

システム環境変数と重複するジョブ定義の環境変数を有効にする場合に指定します。

デフォルトは「0」です。

詳細については「7.41 システム環境変数とジョブ定義の環境変数が重複した場合にジョブ定義の環境変数を有効にするための設定」を参照してください。

4.2.2　エージェント環境の設定

ジョブ実行環境を設定する場合に，［エージェント環境設定］ダイアログボックスで定義する項目および環境設定パラメーターでの設定方法を説明します。

各項目の推奨値と設定が有効になる時期については，マニュアル「JP1/Automatic Job Management System 2 設計・運用ガイド　5.4.1 ジョブ実行環境に関する環境設定について検討する」を参照してください。

＜この項の構成＞

(1)　ジョブ実行環境を定義する

(2)　環境設定パラメーターで定義する

(1)　ジョブ実行環境を定義する

ジョブ実行時に必要な情報は，［エージェント環境設定］ダイアログボックスの［ジョブ実行環境］タブで定義してください。

エージェント環境で設定する［ジョブ実行環境］タブを次に示します。

図4-9　［ジョブ実行環境］タブ（［エージェント環境設定］ダイアログボックス）

各項目の定義内容を説明します。

エージェントプロセス実行時のワークディレクトリ名

このホストでジョブを実行する場合のワークフォルダの名称を180バイト以内で指定します。フォルダ名はフルパスで指定します。デフォルトは「JP1/AJS2 - Agentのインストール先フォルダ¥tmp」です。

(2)　環境設定パラメーターで定義する

ジョブ実行環境は，環境設定パラメーターを設定して定義することもできます。

(a)　設定手順

JP1/AJS2のサービスを停止する。
Windowsの［コントロールパネル］の［管理ツール］から［サービス］を選択し，次に示すサービスを停止します。

JP1/AJS2サービス

注意事項

クラスタシステムの場合は，クラスタの設定を確認し，論理ホストのJP1/AJS2サービスも停止してください。

メモ帳などのテキストエディターで，（2）の定義パラメーターを記述した設定ファイルを作成する。
設定ファイルのファイル名は任意です。

ファイルを保存し，次のコマンドを実行する。

jbssetcnf 設定ファイル名

jbssetcnfコマンドのパスは，「JP1/Baseのインストール先フォルダ¥bin¥jbssetcnf」です。
jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/AJS2を再起動する。
設定ファイルに記述した内容が反映されます。

(b)　環境設定パラメーター

ジョブ実行環境で設定できる環境設定パラメーターの一覧を次の表に示します。なお，環境設定パラメーターの詳細については，「14.2.3 エージェント環境（JP1/AJS2 - Agent）で設定する内容」を参照してください。

表4-3　環境設定パラメーター一覧（JP1/AJS2 - Agent）（Windows）

定義キー | 環境設定パラメーター | 定義内容
[{JP1_DEFAULT|論理ホスト名}¥JP1NBQAGENT¥Process]※1 | "WorkPath"= | エージェントプロセス実行時のワークディレクトリ名
"IsHA"= | エージェントプロセスのクラスタ環境設定の定義
[{JP1_DEFAULT|論理ホスト名}¥JP1NBQAGENT¥Job]※1 | "IsExecFindExecutable"=※2 | ジョブをロングファイル名で実行するための定義
"LoadUserProfile"=※2 | ユーザープロファイルを読み込むかどうかの定義
"IsAccessTokenCache"=※2 | ジョブ実行時にアクセストークンを再利用するための設定
"DISABLE_FS_REDIRECTION"=※² | WOW64環境でジョブを実行する際にファイルシステムリダイレクトを無効にする設定
"MergeEnvMode"= | システム環境変数とジョブ定義の環境変数が重複した場合に，ジョブ定義の環境変数を有効にするかどうかの設定
[{JP1_DEFAULT|論理ホスト名}¥JP1NBQAGENT¥Network]※¹ | "NotfyJobStateInterval"= | ジョブの結果ファイルの再送間隔
"NotfyJobStateCount"= | ジョブの結果ファイルの再送回数
"ConnectTimeout"=※3 | ジョブ実行制御エージェントのTCP/IP通信接続タイムアウト値の定義
"CommunicateRetryCount"=※3 | ジョブ実行制御エージェントのTCP/IP通信接続エラーのリトライ回数の定義
"CommunicateRetryInterval"=※3 | ジョブ実行制御エージェントのTCP/IP通信接続エラーのリトライ間隔の定義
[{JP1_DEFAULT|論理ホスト名}¥JP1NBQAGENT¥Variable]※1 | "変数名"=※4 | 変数名に対応した実行プログラムの，そのホストでのインストールディレクトリ。
[{JP1_DEFAULT|論理ホスト名}¥JP1NBQCLIENT¥PathEnv]※1 | "All Users"=※5 | 転送元ファイルの検索パス
"JP1ユーザー名"=※5 | 転送元ファイルの検索パス
[{JP1_DEFAULT|論理ホスト名}¥JP1NBQCLIENT¥Network]※1 | "ConnectTimeout"=※3 | ジョブ実行に使用するコマンドおよびスケジュール制御のTCP/IP通信接続タイムアウト値の定義
"CommunicateRetryCount"=※3 | ジョブ実行に使用するコマンドおよびスケジュール制御のTCP/IP通信接続エラーのリトライ回数の定義
"CommunicateRetryInterval"=※3 | ジョブ実行に使用するコマンドおよびスケジュール制御のTCP/IP通信接続エラーのリトライ間隔の定義
"CommunicateTimeout"=※6 | ジョブ実行制御のマネージャープロセスに対する通信タイムアウト時間
[{JP1_DEFAULT|論理ホスト名}¥JP1NBQCLIENT¥Process]※1 | "MacroOptionReplaceMode"= | マクロ変数の引き継ぎ情報がNULL文字列の場合の置き換え方法の設定
"IsHA"= | ジョブ実行に使用するコマンドのクラスタ環境設定の定義

注※1

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

注※2

この環境設定パラメーターはWindows版だけで指定できます。定義内容の詳細については，以降の説明を参照してください。

注※3

定義内容の詳細については，「7.19 TCP/IP通信接続エラーのリトライ間隔・回数の変更」を参照してください。

注※4

定義内容の詳細については，「7.1 ジョブ実行時のワークパスを変数として定義する」を参照してください。

注※5

定義内容の詳細については，「7.3 転送元ファイルの検索パスを定義する」を参照してください。

注※6

定義内容の詳細については，「7.32 ジョブ実行制御のマネージャープロセスに対する通信タイムアウト時間の変更」を参照してください。

Windowsだけで使用できる環境設定パラメーターを次に説明します。

"IsExecFindExecutable"=dword:設定値

ジョブの実行ファイルをショートファイル名に変換しないでロングファイル名で実行するかどうかを指定します。

0

変換してショートファイル名で実行します。

1

変換しないでロングファイル名で実行します。

デフォルトは「0」です。

詳細については「7.2 ジョブをロングファイル名で実行するための設定」を参照してください。

"LoadUserProfile"=dword:設定値

ジョブを実行するOSユーザーのユーザープロファイル情報をジョブ実行時に読み込むかどうかを指定します。

0

ユーザープロファイルを読み込みません。

1

ユーザープロファイルを読み込みます。

デフォルトは「0」です。

「1」を指定する場合は，IsAccessTokenCacheにも「1」を設定してください。

詳細については「7.6 ユーザープロファイルを必要とするジョブを実行するための設定」を参照してください。

"IsAccessTokenCache"=dword:設定値

ジョブ実行時にアクセストークンを再利用するかどうかを指定します。

0

ジョブを実行するごとにアクセストークンを取得し，実行終了後に解放します。

1

ジョブ実行時に「ユーザー名」「ドメイン名」「パスワード」が同一のアクセストークンが保存されている場合，アクセストークンを再利用してジョブを実行します。

デフォルトは「0」です。

LoadUserProfileに「1」を設定し，ユーザープロファイル情報を読み込む場合は，この値にも「1」を設定してください。

詳細については「7.26 ジョブ実行時にアクセストークンを再利用するための設定」を参照してください。

"DISABLE_FS_REDIRECTION"=dword:設定値

WOW64環境でジョブを実行する際にファイルシステムリダイレクトを無効にするかどうかを指定します。

0

WOW64環境でジョブを実行する際に，ファイルシステムリダイレクトが有効になります。

1

WOW64環境でジョブを実行する際に，ファイルシステムリダイレクトが無効になります。

デフォルトは「0」です。

詳細については「7.28 WOW64環境でジョブを実行する際にファイルシステムリダイレクトを無効にする設定」を参照してください。

"MergeEnvMode"=dword:設定値

システム環境変数とジョブ定義の環境変数が重複した場合に，ジョブ定義の環境変数を有効にするかどうかを指定します。

0

システム環境変数と重複するジョブ定義の環境変数を有効にしない場合に指定します。

1

システム環境変数と重複するジョブ定義の環境変数を有効にする場合に指定します。

デフォルトは「0」です。

詳細については「7.41 システム環境変数とジョブ定義の環境変数が重複した場合にジョブ定義の環境変数を有効にするための設定」を参照してください。

4.3　イベント起動の設定

イベント起動の設定は，マネージャー環境とエージェント環境では異なります。

それぞれの環境で設定する内容を次に示します。

＜この節の構成＞

4.3.1　マネージャー環境の設定

4.3.2　エージェント環境の設定

4.3.1　マネージャー環境の設定

イベント起動を設定する場合に，［マネージャー環境設定］ダイアログボックスで定義する項目および環境設定パラメーターでの設定方法を説明します。

各項目の推奨値と設定が有効になる時期については，マニュアル「JP1/Automatic Job Management System 2 設計・運用ガイド　5.3.3 イベントジョブ起動に関する環境設定について検討する」を参照してください。

＜この項の構成＞

(1)　イベント起動を定義する

(2)　環境設定パラメーターで定義する

(1)　イベント起動を定義する

起動条件またはイベントジョブ実行時の情報引き継ぎは，［マネージャー環境設定］ダイアログボックスの［イベント起動］タブで定義してください。

マネージャー環境で設定する［イベント起動］タブを次に示します。

図4-10　［イベント起動］タブ（［マネージャー環境設定］ダイアログボックス）

各項目の定義内容を説明します。

マネージャープロセスの設定

JP1/AJS2 - Managerホストでのイベント起動について設定します。

待機情報ファイル出力ディレクトリ名

イベントジョブの詳細情報や，起動条件で監視しているイベントの受信状態などの情報（待機情報）を出力するフォルダの名称を180バイト以内で指定します。フォルダ名はフルパスで指定します。ただし，標準のフォルダを変更したい場合以外は指定する必要はありません。デフォルトは「空白」です。デフォルトを使用した場合，実行時に「JP1/AJS2 - Managerのインストール先フォルダ」が仮定されます。

なお，待機情報は，この項目で指定したフォルダまたは仮定されたフォルダ下の「sys¥infodir」に出力されます。

注意

［参照］ボタンでドライブを選択すると，末尾に「¥」が入った状態で表示されます。ドライブ直下を指定する場合は，「¥」を削除してください。また，［参照］ボタンを使用しないで入力する場合でも，末尾に「¥」を付けないようにしてください。

ファイル更新モード

待機情報ファイルの更新時に，同期書き込みを実行するかどうかを次のどちらかから選択します。

［同期］
ファイル更新時に，常に同期書き込みを実行します。この方法で書き込みを実行した場合，信頼性は向上しますが，性能は低下します。

［非同期］
JP1/AJS2 の処理とは同期を取らないで，OS のバッファーリングによってディスクに書き込みます。［同期］に比べて性能は向上しますが，システムダウンなどが発生した場合，情報の不整合が発生しイベントが消失するおそれがあります。

デフォルトは［非同期］です。

注意

ファイル更新モードは，マネージャープロセスとエージェントプロセスで同じ値を設定してください。特に，マネージャープロセスを［非同期］，エージェントプロセスを［同期］に設定した場合，イベントジョブを使用したジョブネットや起動条件付きジョブネットの実行登録時，強制終了時，または先行ジョブに大量のイベントジョブを使用したORジョブが実行された場合などでは，JP1/AJS2の動作が極端に遅くなることがあります。また，同じ理由から，マネージャー・エージェント構成のシステムでも，マネージャーとエージェントで同じ設定にしてください。

エージェントプロセスの設定

JP1/AJS2 - Managerホストで発生したイベントについての情報引き継ぎを設定します。

イベント・ジョブ情報引継ぎディレクトリ名

メール受信監視ジョブやメッセージキュー受信監視ジョブで受信した情報をファイルで引き継ぐ場合，そのファイルを保存しておくフォルダの名称180バイト以内で指定します。フォルダ名はフルパスで指定します。ただし，標準のフォルダを変更したい場合以外は指定する必要はありません。デフォルトは「空白」です。この項目を指定しなかった場合，次のフォルダに保存されます。

Windows Server 2008の場合
%ALLUSERSPROFILE%¥Hitachi¥JP1¥JP1_DEFAULT¥JP1AJS2¥tmp¥infodir
「%ALLUSERSPROFILE%」のデフォルトは「システムドライブ¥ProgramData」です。

Windows Server 2008以外の場合
JP1/AJS2 - Managerのインストール先フォルダ¥tmp¥infodir

このフォルダに保存されるファイルは，JP1/AJS2では使用されません。また，自動的に削除されないので，不要になった場合は手動で削除してください。

注意

［参照］ボタンでドライブを選択すると，末尾に「¥」が入った状態で表示されます。ドライブ直下を指定する場合は，「¥」を削除してください。また，［参照］ボタンを使用しないで入力する場合でも，末尾に「¥」を付けないようにしてください。

待機情報ファイル出力ディレクトリ名

イベント受信監視でのイベント発生状態や，起動条件で監視しているイベントの受信状態などの情報（待機情報）を出力するフォルダの名称を180バイト以内で指定します。フォルダ名はフルパスで指定します。デフォルトは「空白」です。デフォルトを使用した場合，実行時に「JP1/AJS2 - Managerのインストール先フォルダ」が仮定されます。

なお，待機情報は，この項目で指定したフォルダまたは仮定されたフォルダ下の「sys¥infoagt」に出力されます。

注意

［参照］ボタンでドライブを選択すると，末尾に「¥」が入った状態で表示されます。ドライブ直下を指定する場合は，「¥」を削除してください。また，［参照］ボタンを使用しないで入力する場合でも，末尾に「¥」を付けないようにしてください。

系切り替え時の情報の引き継ぎ

JP1/AJS2 - Managerにフェールオーバーが発生したときに，フェールオーバー先のJP1/AJS2 - Managerに情報を引き継ぐかどうかを次のどちらかから選択します。

［使用する］
フェールオーバー発生時の状態を，切り替え後のJP1/AJS2 - Managerに引き継ぎます。例えば，フェールオーバー発生前にJP1/AJS2 - Managerに通知できなかったイベントを，切り替え後に再通知します。

［使用しない］
フェールオーバー発生時の状態を，切り替え後のJP1/AJS2 - Managerに引き継ぎません。例えば，フェールオーバー発生前にJP1/AJS2 - Managerに通知できなかったイベントは破棄されます。

デフォルトは［使用する］です。通常はデフォルトを使用してください。また，クラスタ運用をしない場合でもデフォルトを使用してください。

シャットダウン時の情報引継ぎ方法

JP1/AJS2 - Managerホストがシャットダウン（停止処理を伴う終了）されたときに，次回起動時にどのように情報を引き継ぐのかを次のどちらかから選択します。

［保持する］
シャットダウン後にJP1/AJS2 - Managerを起動したときに，シャットダウン前にJP1/AJS2 - Managerへ通知できなかったイベントを再通知します。例えば，シャットダウン前に発生していたイベントを，起動後にJP1/AJS2 - Managerに通知します（ただし，有効時間内に起動した場合に限ります）。

［破棄する］
シャットダウン後にJP1/AJS2 - Managerを起動したときに，シャットダウン前にJP1/AJS2 - Managerへ通知できなかったイベントを通知しません。例えば，シャットダウン前に発生していたイベントは破棄されます。電源ダウンの障害時だけ，情報を引き継ぎたいような場合に使用します。

デフォルトは［保持する］です。通常はデフォルトを使用してください。

ファイル監視ジョブの情報の引き継ぎ

ファイル監視ジョブ実行中にJP1/AJS2 - Managerがシャットダウン（停止処理を伴う終了）し，その後JP1/AJS2 - Managerを起動したときに，シャットダウン前のファイル監視ジョブの情報を引き継ぐかどうかを次のどちらかから選択します。

［行う］
シャットダウン前のファイル監視ジョブの監視状態を引き継いで監視を行います。

［行わない］
シャットダウン前のファイル監視ジョブの監視状態は引き継ぎません。JP1/AJS2 - Managerを起動したときのファイル状態に対して監視を行います。

デフォルトは［行わない］です。

この項目は，JP1/AJS2の新規のインストール時および新規のセットアップ時に［行う］が設定されます。

ファイル更新モード

イベントジョブ情報，待機情報ファイルの更新時に，同期書き込みを実行するかどうかを次のどちらかから選択します。

［同期］
ファイル更新時に，常に同期書き込みを実行します。この方法で書き込みを実行した場合，信頼性は向上しますが，性能は低下します。

［非同期］
JP1/AJS2 の処理とは同期を取らないで，OS のバッファーリングによってディスクに書き込みます。［同期］に比べて性能は向上しますが，システムダウンなどが発生した場合，情報の不整合が発生しイベントが消失するおそれがあります。

デフォルトは［非同期］です。

注意

ファイル更新モードは，マネージャープロセスとエージェントプロセスで同じ値を設定してください。特に，マネージャープロセスを［非同期］，エージェントプロセスを［同期］に設定した場合，イベントジョブを使用したジョブネットや起動条件付きジョブネットの実行登録時，強制終了時，または先行ジョブに大量のイベントジョブを使用したORジョブが実行された場合などでは，JP1/AJS2の動作が極端に遅くなることがあります。また，同じ理由から，マネージャー・エージェント構成のシステムでも，マネージャーとエージェントで同じ設定にしてください。

詳細プロセス終了時の処理

イベント・アクション制御の詳細プロセスがシグナル終了した場合，イベント・アクション制御のエージェントプロセスを終了しないで縮退運転するか，すべての詳細プロセスを停止して終了するかどうかを次のどちらかから選択します。

［終了する］
すべての詳細プロセスを停止してイベント・アクション制御のエージェントプロセスを終了します。

［終了しない］
イベント・アクション制御のエージェントプロセスを終了せず縮退運転します。
シグナルなどによって詳細プロセスの一部が終了した場合，終了した詳細プロセスで動作するイベントジョブ以外は使用できます。

デフォルトは［終了しない］です。

この項目は，JP1/AJS2の新規のインストール時および新規のセットアップ時に［終了する］が設定されます。

このオプションはJP1/AJS2の再起動後に有効となります。

注意

異常終了したJP1/AJS2のプロセスを再起動させる設定を行っている場合，詳細プロセス終了時の処理に［終了する］を設定しても，エージェントプロセスと詳細プロセスはJP1/AJS2のプロセスの再起動に伴って再起動されます。異常終了したJP1/AJS2のプロセスを再起動させる設定については，マニュアル「JP1/Automatic Job Management System 2 設計・運用ガイド　15.15.1 異常終了したJP1/AJS2のプロセスを再起動する」を参照してください。

イベント起動の定義の補足事項

イベント起動で定義する内容と，情報引き継ぎの実行について次の表に示します。

表4-4　定義する内容と情報引き継ぎの実行（JP1/AJS2 - Manager）

JP1/AJS2 - Manager環境設定の内容
シャットダウン時の
情報引き継ぎ
強制電源オフ時※の
情報引き継ぎ

系切り替え時の
情報引き継ぎ
シャットダウン時の
情報引き継ぎ

使用する
保持する
実行する
実行する

使用する
保持しない
実行しない
実行する

使用しない
保持する
実行しない
実行しない

使用しない
保持しない
実行しない
実行しない

注※

ハングアップなどによって，強制的に電源オフを実行した場合のことです。

なお，このほかに［メール連携］タブ，［MQ連携］タブ，［MSMQ連携］タブがあります。［メール連携］タブについては，マニュアル「JP1/Automatic Job Management System 2 連携ガイド　2.2 メールシステム連携のセットアップ（Windowsホストの場合）」を参照してください。［MQ連携］タブと［MSMQ連携］タブについては，マニュアル「JP1/Automatic Job Management System 2 連携ガイド　3.2 メッセージキューシステム連携時のセットアップ（Windowsホストの場合）」を参照してください。

(2)　環境設定パラメーターで定義する

イベント起動の設定は，環境設定パラメーターを設定して定義することもできます。

(a)　設定手順

Windowsの［コントロールパネル］の［管理ツール］から［サービス］を選択し，次に示すサービスを停止する。

JP1/AJS2サービス

JP1/AJS2 Monitorサービス

メモ帳などのテキストエディターで，（2）の環境設定パラメーターを記述した設定ファイルを作成する。

ファイルを保存し，次のコマンドを実行する。

jbssetcnf 設定ファイル名

jbssetcnfコマンドのパスは，「JP1/Baseのインストール先フォルダ¥bin¥jbssetcnf」です。
jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/AJS2を再起動する。
設定ファイルの内容が構成定義に反映されます。

(b)　環境設定パラメーター

イベント起動の設定で定義できる環境設定パラメーターの一覧を次の表に示します。なお，環境設定パラメーターの詳細については，「14.3.2 マネージャー環境（JP1/AJS2 - Manager）で設定する内容」を参照してください。

表4-5　環境設定パラメーター一覧（JP1/AJS2 - Manager）（Windows）

定義キー | 環境設定パラメーター | 定義内容
[{JP1_DEFAULT|論理ホスト名}¥JP1AOMMANAGER]※1 | "WaitInfFileOutDir"= | 待機情報ファイル出力ディレクトリ名（マネージャープロセスの設定）
"FileWriteMode"= | ファイル更新モード
"EvJobExecContinue"=※2 | イベントジョブ実行継続オプション
[{JP1_DEFAULT|論理ホスト名}¥JP1AOMAGENT]※1 | "WaitInfFileOutDir"= | 待機情報ファイル出力ディレクトリ名（エージェントプロセスの設定）
"EvjobInfFile"= | イベント・ジョブ情報引き継ぎディレクトリ名
"HowUseInfWhenHA"= | フェールオーバー時の情報引き継ぎ
"InformationWhenShutDown"= | シャットダウン時の情報引き継ぎ方法
"FilewatchinfContinue"= | ファイル監視ジョブの情報の引き継ぎ
"FileWriteMode"= | ファイル更新モード
"EVProcessHA"= | 詳細プロセス終了時オプション

注※1

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

注※2

定義内容の詳細については，「7.33 JP1/AJS2のサービスが停止してもイベントジョブの実行を継続させる設定」を参照してください。

4.3.2　エージェント環境の設定

イベント起動を設定する場合に，［エージェント環境設定］ダイアログボックスで定義する項目および環境設定パラメーターでの設定方法を説明します。

各項目の推奨値と設定が有効になる時期については，マニュアル「JP1/Automatic Job Management System 2 設計・運用ガイド　5.4.2 イベントジョブ起動に関する環境設定について検討する」を参照してください。

＜この項の構成＞

(1)　イベント起動を定義する

(2)　環境設定パラメーターで定義する

(1)　イベント起動を定義する

起動条件またはイベントジョブ実行時の情報引き継ぎは，［エージェント環境設定］ダイアログボックスの［イベント起動］タブで定義してください。

エージェント環境で設定する［イベント起動］タブを次に示します。

図4-11　［イベント起動］タブ（［エージェント環境設定］ダイアログボックス）

各項目の定義内容を説明します。

イベント・ジョブ情報引継ぎディレクトリ名

メール受信監視ジョブやメッセージキュー受信監視ジョブで受信した情報をファイルで引き継ぐ場合に，そのファイルを保存しておくフォルダの名称を180バイト以内で指定します。フォルダ名はフルパスで指定します。ただし，標準のフォルダを変更したい場合以外は指定する必要はありません。デフォルトは「空白」です。

この項目を指定しなかった場合は，次のフォルダに保存されます。

Windows Server 2008の場合
%ALLUSERSPROFILE%¥Hitachi¥JP1¥JP1_DEFAULT¥JP1AJS2¥tmp¥infodir
「%ALLUSERSPROFILE%」のデフォルトは「システムドライブ¥ProgramData」です。

Windows Server 2008以外の場合
JP1/AJS2 - Agentのインストール先フォルダ¥tmp¥infodir

このフォルダに保存されるファイルは，JP1/AJS2では使用されません。また，自動的に削除されませんので，不要になった場合は後続のジョブなどで削除してください。

注意

［参照］ボタンでドライブを選択すると，末尾に「¥」が入った状態で表示されます。ドライブ直下を指定する場合は，「¥」を削除してください。また，［参照］ボタンを使用しないで入力する場合でも，末尾に「¥」を付けないようにしてください。

待機情報ファイル出力ディレクトリ名

イベントジョブでのイベント発生状態や，起動条件で監視しているイベントの受信状態などの情報（待機情報）を出力するフォルダの名称を180バイト以内で指定します。フォルダ名はフルパスで指定します。デフォルトは「空白」です。デフォルトを使用した場合，実行時に「JP1/AJS2 - Agentのインストール先フォルダ」が仮定されます。

なお，待機情報は，この項目で指定したフォルダまたは仮定されたフォルダ下の「sys¥infoagt」に出力されます。

注意

［参照］ボタンでドライブを選択すると，末尾に「¥」が入った状態で表示されます。ドライブ直下を指定する場合は，「¥」を削除してください。また，［参照］ボタンを使用しないで入力する場合でも，末尾に「¥」を付けないようにしてください。

系切り替え時の情報の引き継ぎ

JP1/AJS2 - Agentにフェールオーバーが発生したときに，フェールオーバー先のJP1/AJS2 - Agentに情報を引き継ぐかどうかを次のどちらかから選択します。

［使用する］
フェールオーバー発生時の状態を，切り替え後のJP1/AJS2 - Agentに引き継ぎます。例えば，フェールオーバー発生前にJP1/AJS2 - Managerに通知できなかったイベントを，切り替え後に再通知します。

［使用しない］
フェールオーバー発生時の状態を，切り替え後のJP1/AJS2 - Agentに引き継ぎません。例えば，フェールオーバー発生前にJP1/AJS2 - Managerに通知できなかったイベントは破棄されます。

デフォルトは［使用する］です。通常はデフォルトを使用してください。また，クラスタ運用をしない場合でもデフォルトを使用してください。

シャットダウン時の情報引継ぎ方法

JP1/AJS2 - Agentホストがシャットダウン（停止処理を伴う終了）されたときに，次回起動時にどのように情報を引き継ぐのかを次のどちらかから選択します。

［保持する］
シャットダウン後にJP1/AJS2 - Agentを起動したときに，シャットダウン前にJP1/AJS2 - Managerへ通知できなかったイベントを再通知します。例えば，シャットダウン前に発生していたイベントを，起動後にJP1/AJS2 - Agentに通知します（ただし，有効時間内に起動した場合に限ります）。

［破棄する］
シャットダウン後にJP1/AJS2 - Agentを起動したときに，シャットダウン前にJP1/AJS2 - Managerへ通知できなかったイベントを通知しません。例えば，シャットダウン前に発生していたイベントは破棄されます。電源ダウン障害時だけ，情報を引き継ぎたいような場合に使用します。

デフォルトは［保持する］です。通常はデフォルトを使用してください。

ファイル監視ジョブの情報の引き継ぎ

ファイル監視ジョブ実行中にJP1/AJS2 - Agentがシャットダウン（停止処理を伴う終了）し，その後にJP1/AJS2 - Agentを起動したときに，シャットダウン前のファイル監視ジョブの情報を引き継ぐかどうかを次のどちらかから選択します。

［行う］
シャットダウン前のファイル監視ジョブの監視状態を引き継いで監視を行います。

［行わない］
シャットダウン前のファイル監視ジョブの監視状態は引き継ぎません。JP1/AJS2 - Agentを起動したときのファイル状態に対して監視を行います。

デフォルトは［行わない］です。

この項目は，JP1/AJS2の新規のインストール時および新規のセットアップ時に［行う］が設定されます。

ファイル更新モード

イベントジョブ情報，待機情報ファイルの更新時に，同期書き込みを実行するかどうかを次のどちらかから選択します。

［同期］
ファイル更新時に，常に同期書き込みを実行します。この方法で書き込みを実行した場合，信頼性は向上しますが，性能は低下します。

［非同期］
JP1/AJS2 の処理とは同期を取らないで，OS のバッファーリングによってディスクに書き込みます。［同期］に比べて性能は向上しますが，システムダウンなどが発生した場合，情報の不整合が発生しイベントが消失するおそれがあります。

デフォルトは［非同期］です。

注意

ファイル更新モードは，マネージャープロセスとエージェントプロセスで同じ値を設定してください。特に，マネージャープロセスを［非同期］，エージェントプロセスを［同期］に設定した場合，イベントジョブを使用したジョブネットや起動条件付きジョブネットの実行登録時，強制終了時，または先行ジョブに大量のイベントジョブを使用したORジョブが実行された場合などでは，JP1/AJS2の動作が極端に遅くなることがあります。また，同じ理由から，マネージャー・エージェント構成のシステムでも，マネージャーとエージェントで同じ設定にしてください。

詳細プロセス終了時の処理

イベント・アクション制御の詳細プロセスがシグナル終了した場合，イベント・アクション制御のエージェントプロセスを終了しないで縮退運転するか，すべての詳細プロセスを停止して終了するかどうかを次のどちらかから選択します。

［終了する］
すべての詳細プロセスを停止してイベント・アクション制御のエージェントプロセスを終了します。

［終了しない］
イベント・アクション制御のエージェントプロセスを終了せず縮退運転します。
シグナルなどによって詳細プロセスの一部が終了した場合，終了した詳細プロセスで動作するイベントジョブ以外は使用できます。

デフォルトは［終了しない］です。

この項目は，JP1/AJS2の新規のインストール時および新規のセットアップ時に［終了する］が設定されます。

このオプションはJP1/AJS2の再起動後に有効となります。

注意

異常終了したJP1/AJS2のプロセスを再起動させる設定を行っている場合，詳細プロセス終了時の処理に［終了する］を設定しても，エージェントプロセスと詳細プロセスはJP1/AJS2のプロセスの再起動に伴って再起動されます。異常終了したJP1/AJS2のプロセスを再起動させる設定については，マニュアル「JP1/Automatic Job Management System 2 設計・運用ガイド　15.15.1 異常終了したJP1/AJS2のプロセスを再起動する」を参照してください。

イベント起動の定義の補足事項

イベント起動で定義する内容と，JP1/AJS2 - Agentでの情報引き継ぎの実行について次の表に示します。

表4-6　定義する内容と情報引き継ぎの実行（JP1/AJS2 - Agent）

JP1/AJS2 - Agent環境設定の内容
シャットダウン時の情報引き継ぎ
強制電源オフ時※の情報引き継ぎ

系切り替え時の
情報引き継ぎ
シャットダウン時の
情報引き継ぎ

使用する
保持する
実行する
実行する

使用する
保持しない
実行しない
実行する

使用しない
保持する
実行しない
実行しない

使用しない
保持しない
実行しない
実行しない

注※

ハングアップなどによって，強制的に電源オフを実行した場合のことです。

なお，このほかに［メール連携］タブ，［MQ連携］タブ，［MSMQ連携］タブがあります。［メール連携］タブについては，マニュアル「JP1/Automatic Job Management System 2 連携ガイド　2.2 メールシステム連携のセットアップ（Windowsホストの場合）」を参照してください。［MQ連携］タブと［MSMQ連携］タブについては，マニュアル「JP1/Automatic Job Management System 2 連携ガイド　3.2 メッセージキューシステム連携時のセットアップ（Windowsホストの場合）」を参照してください。

また，起動条件イベントからの発生順序オプションについては，「7.9 イベント順序保証オプションの設定」を参照してください。

(2)　環境設定パラメーターで定義する

イベント起動の設定は，環境設定パラメーターを設定して定義することもできます。

(a)　設定手順

Windowsの［コントロールパネル］の［管理ツール］から［サービス］を選択し，次に示すサービスを停止する。

JP1/AJS2サービス

JP1/AJS2 Monitorサービス

メモ帳などのテキストエディターで，（2）の環境設定パラメーターを記述した設定ファイルを作成する。

ファイルを保存し，次のコマンドを実行する。

jbssetcnf 設定ファイル名

jbssetcnfコマンドのパスは，「JP1/Baseのインストール先フォルダ¥bin¥jbssetcnf」です。
jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/AJS2を再起動する。
設定ファイルの内容が構成定義に反映されます。

(b)　環境設定パラメーター

イベント起動の設定で定義できる環境設定パラメーターの一覧を次の表に示します。なお，環境設定パラメーターの詳細については，「14.3.3 エージェント環境（JP1/AJS2 - Agent）で設定する内容」を参照してください。

表4-7　環境設定パラメーター一覧（JP1/AJS2 - Manager）（Windows）

定義キー | 環境設定パラメーター | 定義内容
[{JP1_DEFAULT|論理ホスト名}¥JP1AOMAGENT]※ | "WaitInfFileOutDir"= | 待機情報ファイル出力ディレクトリ名（エージェントプロセスの設定）
"EvjobInfFile"= | イベント・ジョブ情報引き継ぎディレクトリ名
"HowUseInfWhenHA"= | フェールオーバー時の情報引き継ぎ
"InformationWhenShutDown"= | シャットダウン時の情報引き継ぎ方法
"FilewatchinfContinue"= | ファイル監視ジョブの情報の引き継ぎ
"FileWriteMode"= | ファイル更新モード
"EVProcessHA"= | 詳細プロセス終了時オプション

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

4.4　キューレスジョブ実行環境の設定

キューレスジョブ実行環境の設定は，マネージャー環境とエージェント環境では異なります。

それぞれの環境で設定する内容を次に示します。

＜この節の構成＞

4.4.1　マネージャー環境の設定

4.4.2　エージェント環境の設定

4.4.1　マネージャー環境の設定

キューレスジョブ実行環境を新規で設定する場合，ajsqlsetupコマンドを実行してキューレスジョブ実行環境をセットアップしたあと，［マネージャー環境設定］ダイアログボックスで定義します。

ajsqlsetupコマンドの詳細については，「20. セットアップ時に使用するコマンド　ajsqlsetup」を参照してください。

キューレスジョブ実行環境を設定する場合に，［マネージャー環境設定］ダイアログボックスで定義する項目および環境設定パラメーターでの設定方法を説明します。

各項目の推奨値と設定が有効になる時期については，マニュアル「JP1/Automatic Job Management System 2 設計・運用ガイド　5.3.4 キューレスジョブ実行環境に関する環境設定について検討する」を参照してください。

＜この項の構成＞

(1)　キューレスジョブ実行環境を定義する

(2)　環境設定パラメーターで定義する

(1)　キューレスジョブ実行環境を定義する

キューレスジョブ実行時に必要な情報は，［マネージャー環境設定］ダイアログボックスの［キューレスジョブ実行環境］タブで定義してください。

マネージャー環境で設定する［キューレスジョブ実行環境］タブを次に示します。

図4-12　［キューレスジョブ実行環境］タブ（［マネージャー環境設定］ダイアログボックス）

各項目の定義内容を説明します。

ログ出力の設定

ログフォルダの名称やログファイルのサイズを設定します。

ログフォルダ名

実行したジョブの開始・終了メッセージを出力するログフォルダの名称を180バイト以内の文字列で指定します。

ログフォルダの名称はフルパスで指定します。

デフォルト，および項目を設定しない場合は「JP1/AJS2のインストール先フォルダ¥log」です。

ログファイルのサイズ

ログファイルのサイズを0または4～2,000,000（単位：キロバイト）の間で指定します。

「0」を指定した場合は，メッセージは出力されません。

デフォルトは「8,192」です。

ログファイルとして，ここで指定したサイズのファイルを2面（ファイル1，ファイル2）使用します。

ここで指定したサイズの上限までファイル1に情報が書き込まれると，それ以上の情報はファイル2に書き込まれます。さらにファイル2でもサイズの上限まで情報が書き込まれると，再びファイル1に戻って情報を書き込みます。ファイル1→ファイル2→ファイル1→ファイル2を繰り返し，古い情報から上書きされていきますので，サイズの指定には注意が必要です。

ジョブ情報の保存

実行中のジョブ情報を記憶するステータスファイルの名称やサイズを設定します。

ステータスファイル名

実行中のジョブ情報を記憶するステータスファイルの名称を255バイト以内の文字列で指定します。

ログフォルダの名称はフルパスで指定します。

デフォルト，および項目を設定しない場合は「JP1/AJS2のインストール先フォルダ¥log¥ajsqlstat.dat」です。

ステータスファイルサイズ

実行中のジョブ情報を記憶するステータスファイルのサイズを0～2,000,000（単位：キロバイト）の間で指定します。

1キロバイト当たり，約12ジョブの情報を保持します。

デフォルトは「2,048」です。

「0」を指定した場合（この項目を設定しない場合を含む）は，実行中のジョブ情報が記憶されないため，ジョブ実行中にマネージャーホストおよびキューレスエージェントサービスで系切り替えが発生すると，ジョブの状態が不明となります。

「0」以外を指定した場合，該当ジョブ自体は正常終了していても，ジョブの状態が「異常検出終了」となることがあります。これは，該当ジョブが標準エラー出力へ出力した内容を，エージェントホストからマネージャーホストへ転送する処理に失敗しているためです。この現象を避けるためには，エラー発生時以外での標準エラー出力への出力を行わないようにしてください。

キューレスサービス内での最大同時ジョブ実行数

キューレスエージェントサービス内での最大同時ジョブ実行数を0～1,024の間で指定します。

デフォルトは「5」です。

ここで指定した値を超えた場合，超えた分については待ち状態になります（キューレスエージェントのメモリーに貯められます）。待ち状態にできるジョブの数については，「キューレスサービス内での最大待ちジョブ数」で指定してください。

なお，この項目は，論理ホスト名を指定するダイアログボックスで「デフォルト」のまま「設定」ボタンを押した場合だけ指定できます。

キューレスサービス内での最大待ちジョブ数

キューレスエージェントサービス内での最大待ちジョブ数を0～102,400の間で指定します。

デフォルトは「2,048」です。

ここで指定した値を超えた場合，キューレスエージェントサービスは起動失敗になります。

なお，この項目は，論理ホスト名を指定するダイアログボックスで「デフォルト」のまま「設定」ボタンを押した場合だけ指定できます。

(2)　環境設定パラメーターで定義する

キューレスジョブ実行環境の設定は，環境設定パラメーターを設定して定義することもできます。

(a)　設定手順

Windowsの［コントロールパネル］の［管理ツール］から［サービス］を選択し，次に示すサービスを停止する。

JP1/AJS2 Queueless Agentサービス

メモ帳などのテキストエディターで，（b）の環境設定パラメーターを記述した設定ファイルを作成する。

ファイルを保存し，次のコマンドを実行する。

jbssetcnf 設定ファイル名

jbssetcnfコマンドのパスは，「JP1/Baseのインストール先フォルダ¥bin¥jbssetcnf」です。
jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

手順1で停止したサービスを再起動する。
設定ファイルの内容が構成定義に反映されます。

(b)　環境設定パラメーター

キューレスジョブ実行環境で設定できる環境設定パラメーターの一覧を次の表に示します。なお，環境設定パラメーターの詳細については，「14.4.3 キューレスジョブ実行環境設定ファイルの環境設定パラメーターの定義内容」を参照してください。

表4-8　環境設定パラメーター一覧（Windows）

定義キー | 環境設定パラメーター | 定義内容
[JP1_DEFAULT¥JP1QLAGENT] | "AJSQL_JOBMAX"= | キューレスエージェントサービス内での最大同時ジョブ実行数
"AJSQL_CHARCODE"= | ジョブ情報およびジョブ出力結果の文字コード
"AJSQL_JOBWAITMAX"= | キューレスエージェントサービス内での最大待ちジョブ数
"AJSQL_NOATTACHREQ"= | アタッチされていない論理ホストへの実行要求時の処理
"AJSQL_TRACELOGFILE"= | トレースログファイル名
"AJSQL_VARDQUOTEADD"= | 「$JP1AJS2_JPQTEMPxx$」変数変換時の処理
"AJSQL_CONNECTTIMEOUT"= | キューレスファイル転送サービスへの通信接続タイムアウト時間
"AJSQL_CONNECTCOUNT"= | キューレスファイル転送サービスへの通信接続リトライ回数
"AJSQL_CONNECTINT"= | キューレスファイル転送サービスへの通信接続リトライ間隔
"DISABLE_FS_REDIRECTION"= | WOW64環境でジョブを実行する際にファイルシステムリダイレクトを無効にする設定
"AJSQL_CREATEWINDOWSTATION"= | キューレスジョブが戻り値128で異常検出終了となる問題を回避する設定
"AJSQL_EXECLOG"= | キューレスジョブ実行内部ログ出力機能を有効にするかどうかの設定
"AJSQL_EXECLOG_FTPPATH"= | キューレスファイル転送サービスが出力するキューレスジョブ実行内部ログを格納するフォルダ名
[{JP1_DEFAULT|論理ホスト名}¥JP1QLAGENT]※ | "AJSQL_LOGFILE"= | ログフォルダ名
"AJSQL_LOGSIZE"= | ログファイルサイズ
"AJSQL_STATFILE"= | ステータスファイル名
"AJSQL_STATSIZE"= | ステータスファイルサイズ
"AJSQL_ATTACH"= | キューレスエージェントサービス起動時に設定されている論理ホストのアタッチの可否
"AJSQL_EXECLOG_AGTPATH"= | キューレスエージェントサービスが出力するキューレスジョブ実行内部ログを格納するフォルダ名
"AJSQL_LOADUSERPROFILE"= | ユーザープロファイルを読み込むかどうかの定義
[論理ホスト名¥JP1QLAGENT] | "AJSQL_CLUSTERREQ"= | キューレスクラスタプロセスで論理ホストのアタッチに失敗した場合の処理

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

Windowsだけで使用できる環境設定パラメーターを次に説明します。

"DISABLE_FS_REDIRECTION"=dword:設定値

WOW64環境でジョブを実行する際にファイルシステムリダイレクトを無効にするかどうかを指定します。

0

WOW64環境でジョブを実行する際にファイルシステムリダイレクトが有効になります。

1

WOW64環境でジョブを実行する際にファイルシステムリダイレクトが無効になります。

デフォルトは「0」です。

詳細については「7.28 WOW64環境でジョブを実行する際にファイルシステムリダイレクトを無効にする設定」を参照してください。

"AJSQL_CREATEWINDOWSTATION="{yes|no}"

ジョブが戻り値128で異常検出終了となる問題を回避するかどうかを指定します。

yes

ジョブが戻り値128で異常検出終了となる問題を回避します。

no

ジョブが戻り値128で異常検出終了となる問題を回避しません。

デフォルトは「no」です。

詳細については「7.29 キューレスジョブが戻り値128で異常検出終了となる問題を回避するための設定」を参照してください。

"AJSQL_LOADUSERPROFILE"="{yes|no}"

ジョブを実行するOSユーザーのユーザープロファイル情報をジョブ実行時に読み込むかどうかを指定します。

yes

ユーザープロファイルを読み込む場合に指定します。

no

ユーザープロファイルを読み込まない場合に指定します。

デフォルトは「no」です。

詳細については「7.10 キューレスジョブ環境でユーザープロファイルを必要とするジョブを実行するための設定」を参照してください。

"AJSQL_CLUSTERREQ"="{exec|error}"

キューレスクラスタプロセスで論理ホストのアタッチに失敗した場合に，キューレスクラスタプロセスを異常終了させるかどうかを指定します。

exec

キューレスクラスタプロセスを異常終了させないでプロセス起動処理を続行します。JP1/AJS2のサービスの起動処理も続行されます。

error

キューレスクラスタプロセスを異常終了させます。JP1/AJS2のサービスの起動処理も異常終了されます。

デフォルトは「exec」です。

「exec」を指定した場合，論理ホストのアタッチに失敗してもプロセス起動処理を続行します。そのため，系切り替え完了後にajsqlstatusコマンドを実行してアタッチの成否を確認してください。アタッチに失敗していた場合は，統合トレースログからエラー要因を確認し，エラー要因を取り除いたあとにajsqlattachコマンドを実行して，論理ホストをアタッチしてください。

4.4.2　エージェント環境の設定

キューレスジョブ実行環境を新規で設定する場合，ajsqlsetupコマンドを実行してキューレスジョブ実行環境をセットアップしたあと，［エージェント環境設定］ダイアログボックスで定義します。

ajsqlsetupコマンドの詳細については，「20. セットアップ時に使用するコマンド　ajsqlsetup」を参照してください。

キューレスジョブ実行環境を設定する場合に，［エージェント環境設定］ダイアログボックスで定義する項目および環境設定パラメーターでの設定方法を説明します。

各項目の推奨値と設定が有効になる時期については，マニュアル「JP1/Automatic Job Management System 2 設計・運用ガイド　5.4.3 キューレスジョブ実行環境に関する環境設定について検討する」を参照してください。

＜この項の構成＞

(1)　キューレスジョブ実行環境を定義する

(2)　環境設定パラメーターで定義する

(1)　キューレスジョブ実行環境を定義する

キューレスジョブ実行時に必要な情報は，［エージェント環境設定］ダイアログボックスの［キューレスジョブ実行環境］タブで定義してください。

エージェント環境で設定する［キューレスジョブ実行環境］タブを次に示します。

図4-13　［キューレスジョブ実行環境］タブ（［エージェント環境設定］ダイアログボックス）

各項目の定義内容を説明します。

ログ出力の設定

ログフォルダの名称やログファイルのサイズを設定します。

ログフォルダ名

実行したジョブの開始・終了メッセージを出力するログフォルダの名称を180バイト以内の文字列で指定します。

ログフォルダの名称はフルパスで指定します。

デフォルト，および項目を設定しない場合は「JP1/AJS2インストール先フォルダ¥log」です。

ログファイルのサイズ

ログファイルのサイズを0または4～2,000,000（単位：キロバイト）の間で指定します。

デフォルトは「8,192」です。

ログファイルとして，ここで指定したサイズのファイルを2面（ファイル1，ファイル2）使用します。

ここで指定したサイズの上限までファイル1に情報が書き込まれると，それ以上の情報はファイル2に書き込まれます。さらにファイル2でもサイズの上限まで情報が書き込まれると，再びファイル1に戻って情報を書き込みます。ファイル1→ファイル2→ファイル1→ファイル2を繰り返し，古い情報から上書きされていきますので，サイズの指定には注意が必要です。

ジョブ情報の保存

実行中のジョブ情報を記憶するステータスファイルの名称やサイズを設定します。

ステータスファイル名

実行中のジョブ情報を記憶するステータスファイルの名称を255バイト以内の文字列で指定します。

ログフォルダの名称はフルパスで指定します。

デフォルト，および項目を設定しない場合は「JP1/AJS2インストール先フォルダ¥log¥ajsqlstat.dat」です。

ステータスファイルサイズ

実行中のジョブ情報を記憶するステータスファイルのサイズを0～2,000,000（単位：キロバイト）の間で指定します。

1キロバイト当たり，約12ジョブの情報を保持します。

デフォルトは「2,048」です。

「0」を指定した場合（この項目を設定しない場合を含む）は，実行中のジョブ情報が記憶されないため，ジョブ実行中にマネージャーホストおよびキューレスエージェントサービスで系切り替えが発生すると，ジョブの状態が不明となります。

「0」以外を指定した場合，該当ジョブ自体は正常終了していても，ジョブの状態が「異常検出終了」となることがあります。これは，該当ジョブが標準エラー出力へ出力した内容を，エージェントホストからマネージャーホストへ転送する処理に失敗しているためです。この現象を避けるためには，エラー発生時以外での標準エラー出力への出力を行わないようにしてください。

キューレスサービス内での最大同時ジョブ実行数

キューレスエージェントサービス内での最大同時ジョブ実行数を0～1,024の間で指定します。

デフォルトは「5」です。

ここで指定した値を超えた場合，超えた分については待ち状態になります（キューレスエージェントのメモリーに貯められます）。待ち状態にできるジョブの数については，「キューレスサービス内での最大待ちジョブ数」で指定してください。

なお，この項目は，論理ホスト名を指定するダイアログボックスで「デフォルト」のまま「設定」ボタンを押した場合だけ指定できます。

キューレスサービス内での最大待ちジョブ数

キューレスエージェントサービス内での最大待ちジョブ数を0～102,400の間で指定します。

デフォルトは「2,048」です。

なお，この項目は，論理ホスト名を指定するダイアログボックスで「デフォルト」のまま「設定」ボタンを押した場合だけ指定できます。

(2)　環境設定パラメーターで定義する

キューレスジョブ実行環境の設定は，環境設定パラメーターを設定して定義することもできます。

(a)　設定手順

Windowsの［コントロールパネル］の［管理ツール］から［サービス］を選択し，次に示すサービスを停止する。

JP1/AJS2 Queueless Agentサービス

メモ帳などのテキストエディターで，（b）の環境設定パラメーターを記述した設定ファイルを作成する。

ファイルを保存し，次のコマンドを実行する。

jbssetcnf 設定ファイル名

jbssetcnfコマンドのパスは，「JP1/Baseのインストール先フォルダ¥bin¥jbssetcnf」です。
jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

手順1で停止したサービスを再起動する。
設定ファイルの内容が構成定義に反映されます。

(b)　環境設定パラメーター

キューレスジョブ実行環境で設定できる環境設定パラメーターの一覧を次の表に示します。なお，環境設定パラメーターの詳細については，「14.4.3 キューレスジョブ実行環境設定ファイルの環境設定パラメーターの定義内容」を参照してください。

表4-9　環境設定パラメーター一覧（Windows）

定義キー | 環境設定パラメーター | 定義内容
[JP1_DEFAULT¥JP1QLAGENT] | "AJSQL_JOBMAX"= | キューレスエージェントサービス内での最大同時ジョブ実行数
"AJSQL_CHARCODE"= | ジョブ情報およびジョブ出力結果の文字コード
"AJSQL_JOBWAITMAX"= | キューレスエージェントサービス内での最大待ちジョブ数
"AJSQL_NOATTACHREQ"= | アタッチされていない論理ホストへの実行要求時の処理
"AJSQL_TRACELOGFILE"= | トレースログファイル名
"AJSQL_VARDQUOTEADD"= | 「$JP1AJS2_JPQTEMPxx$」変数変換時の処理
"AJSQL_CONNECTTIMEOUT"= | キューレスファイル転送サービスへの通信接続タイムアウト時間
"AJSQL_CONNECTCOUNT"= | キューレスファイル転送サービスへの通信接続リトライ回数
"AJSQL_CONNECTINT"= | キューレスファイル転送サービスへの通信接続リトライ間隔
"DISABLE_FS_REDIRECTION"= | WOW64環境でジョブを実行する際にファイルシステムリダイレクトを無効にする設定
"AJSQL_CREATEWINDOWSTATION"= | キューレスジョブが戻り値128で異常検出終了となる問題を回避する設定
"AJSQL_EXECLOG"= | キューレスジョブ実行内部ログ出力機能を有効にするかどうかの設定
[{JP1_DEFAULT|論理ホスト名}¥JP1QLAGENT]※ | "AJSQL_LOGFILE"= | ログフォルダ名
"AJSQL_LOGSIZE"= | ログファイルサイズ
"AJSQL_STATFILE"= | ステータスファイル名
"AJSQL_STATSIZE"= | ステータスファイルサイズ
"AJSQL_ATTACH"= | キューレスエージェントサービス起動時に設定されている論理ホストのアタッチの可否
"AJSQL_EXECLOG_AGTPATH"= | キューレスエージェントサービスが出力するキューレスジョブ実行内部ログを格納するフォルダ名
"AJSQL_LOADUSERPROFILE"= | ユーザープロファイルを読み込むかどうかの定義
[論理ホスト名¥JP1QLAGENT] | "AJSQL_CLUSTERREQ"= | キューレスクラスタプロセスで論理ホストのアタッチに失敗した場合の処理

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

Windowsだけで使用できる環境設定パラメーターを次に説明します。

"DISABLE_FS_REDIRECTION"=dword:設定値

WOW64環境でジョブを実行する際にファイルシステムリダイレクトを無効にするかどうかを指定します。

0

WOW64環境でジョブを実行する際にファイルシステムリダイレクトが有効になります。

1

WOW64環境でジョブを実行する際にファイルシステムリダイレクトが無効になります。

デフォルトは「0」です。

詳細については「7.28 WOW64環境でジョブを実行する際にファイルシステムリダイレクトを無効にする設定」を参照してください。

"AJSQL_CREATEWINDOWSTATION="{yes|no}"

ジョブが戻り値128で異常検出終了となる問題を回避するかどうかを指定します。

yes

ジョブが戻り値128で異常検出終了となる問題を回避します。

no

ジョブが戻り値128で異常検出終了となる問題を回避しません。

デフォルトは「no」です。

詳細については「7.29 キューレスジョブが戻り値128で異常検出終了となる問題を回避するための設定」を参照してください。

"AJSQL_LOADUSERPROFILE"="{yes|no}"

ジョブを実行するOSユーザーのユーザープロファイル情報をジョブ実行時に読み込むかどうかを指定します。

yes

ユーザープロファイルを読み込む場合に指定します。

no

ユーザープロファイルを読み込まない場合に指定します。

デフォルトは「no」です。

詳細については「7.10 キューレスジョブ環境でユーザープロファイルを必要とするジョブを実行するための設定」を参照してください。

"AJSQL_CLUSTERREQ"="{exec|error}"

キューレスクラスタプロセスで論理ホストのアタッチに失敗した場合に，キューレスクラスタプロセスを異常終了させるかどうかを指定します。

exec

キューレスクラスタプロセスを異常終了させないでプロセス起動処理を続行します。JP1/AJS2のサービスの起動処理も続行されます。

error

キューレスクラスタプロセスを異常終了させます。JP1/AJS2のサービスの起動処理も異常終了されます。

デフォルトは「exec」です。

「exec」を指定した場合，論理ホストのアタッチに失敗してもプロセス起動処理を続行します。そのため，系切り替え完了後にajsqlstatusコマンドを実行してアタッチの成否を確認してください。アタッチに失敗していた場合は，統合トレースログからエラー要因を確認し，エラー要因を取り除いたあとにajsqlattachコマンドを実行して，論理ホストをアタッチしてください。

4.5　その他のオプションの設定

その他のオプションの設定は，マネージャー環境とエージェント環境では異なります。

それぞれの環境で設定する内容を次に示します。

＜この節の構成＞

4.5.1　マネージャー環境の設定

4.5.2　エージェント環境の設定

4.5.1　マネージャー環境の設定

その他のオプションを設定する場合に，［マネージャー環境設定］ダイアログボックスで定義する項目および環境設定パラメーターでの設定方法を説明します。

各項目の推奨値と設定が有効になる時期については，マニュアル「JP1/Automatic Job Management System 2 設計・運用ガイド　5.3.10 その他のオプションに関する環境設定について検討する」を参照してください。

＜この項の構成＞

(1)　その他のオプションを定義する

(2)　環境設定パラメーターで定義する

(1)　その他のオプションを定義する

その他のオプションの情報は，［マネージャー環境設定］ダイアログボックスの［その他のオプション］タブで定義してください。

マネージャー環境で設定する［その他のオプション］タブを次に示します。

図4-14　［その他のオプション］タブ（［マネージャー環境設定］ダイアログボックス）

項目の定義内容を説明します。

ラージファイル対応

ファイル監視ジョブ，判定ジョブでラージファイルに対応するかどうかを次のどちらかから選択します。

［する］
ファイル監視ジョブでサイズが2ギガバイト以上のファイルを監視，判定ジョブでサイズが2ギガバイト以上のファイルの有無を判定できます。

［しない］
ファイル監視ジョブでサイズが2ギガバイト以上のファイルを監視できません。［しない］を指定して2ギガバイト以上のファイルを監視対象にした場合，ファイル変更の誤検知などの不正な動作をするおそれがあります。このため，監視対象ファイルには2ギガバイト以上のファイルを指定しないでください。
また，判定ジョブでサイズが2ギガバイト以上のファイルの有無を判定できません。［しない］を指定した状態で2ギガバイト以上のファイルを判定条件で指定した場合，OSがLinux（IPF）以外の場合は，常にファイルがないものとして判定されます。

デフォルトは［しない］です。

(2)　環境設定パラメーターで定義する

その他のオプションの設定は，環境設定パラメーターを設定して定義することもできます。

(a)　設定手順

Windowsの［コントロールパネル］の［管理ツール］で［サービス］を選択し，次のサービスを停止する。

JP1/AJS2サービス

JP1/AJS2 Monitorサービス

メモ帳などのテキストエディターで，「(b) 環境設定パラメーター」を記述した設定ファイルを作成する。
設定ファイルのファイル名は任意です。

ファイルを保存し，次のコマンドを実行する。

jbssetcnf 設定ファイル名

jbssetcnfコマンドのパスは，「JP1/Baseのインストール先フォルダ¥bin¥jbssetcnf」です。
jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

次のサービスを再起動する。

JP1/AJS2サービス

JP1/AJS2 Monitorサービス

設定ファイルに記述した内容が反映されます。

(b)　環境設定パラメーター

その他のオプションで設定できる環境設定パラメーターの一覧を次の表に示します。なお，環境設定パラメーターの詳細については，「14.6(2) 共通情報環境設定ファイルの環境設定パラメーター一覧」を参照してください。

表4-10　環境設定パラメーター一覧（Windows）

定義キー | 環境設定パラメーター | 定義内容
[{JP1_DEFAULT|論理ホスト名}¥JP1AJS2COMMON]※ | "LARGEFILEUSE"= | ラージファイル対応の動作

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

4.5.2　エージェント環境の設定

その他のオプションを設定する場合に，［エージェント環境設定］ダイアログボックスで定義する項目および環境設定パラメーターでの設定方法を説明します。

各項目の推奨値と設定が有効になる時期については，マニュアル「JP1/Automatic Job Management System 2 設計・運用ガイド　5.4.6 その他のオプションに関する環境設定について検討する」を参照してください。

＜この項の構成＞

(1)　その他のオプションを定義する

(2)　環境設定パラメーターで定義する

(1)　その他のオプションを定義する

その他のオプションの情報は，［エージェント環境設定］ダイアログボックスの［その他のオプション］タブで定義してください。

エージェント環境で設定する［その他のオプション］タブを次に示します。

図4-15　［その他のオプション］タブ（［エージェント環境設定］ダイアログボックス）

項目の定義内容を説明します。

ラージファイル対応

ファイル監視ジョブでラージファイルに対応するかどうかを次のどちらかから選択します。

［する］
ファイル監視ジョブでサイズが2ギガバイト以上のファイルを監視できます。

［しない］
ファイル監視ジョブでサイズが2ギガバイト以上のファイルを監視できません。［しない］を指定して2ギガバイト以上のファイルを監視対象にした場合，ファイル変更の誤検知などの不正な動作をするおそれがあります。このため，監視対象ファイルには2ギガバイト以上のファイルを指定しないでください。

デフォルトは［しない］です。

補足事項

判定ジョブはマネージャーホストで実行するため，［エージェント環境設定］ダイアログボックスの値で影響を受けることはありません。

(2)　環境設定パラメーターで定義する

その他のオプションの設定は，環境設定パラメーターを設定して定義することもできます。

(a)　設定手順

Windowsの［コントロールパネル］の［管理ツール］で［サービス］を選択し，次のサービスを停止する。

JP1/AJS2サービス

メモ帳などのテキストエディターで，「(b) 環境設定パラメーター」を記述した設定ファイルを作成する。
設定ファイルのファイル名は任意です。

ファイルを保存し，次のコマンドを実行する。

jbssetcnf 設定ファイル名

jbssetcnfコマンドのパスは，「JP1/Baseのインストール先フォルダ¥bin¥jbssetcnf」です。
jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/AJS2サービスを再起動する。
設定ファイルに記述した内容が反映されます。

(b)　環境設定パラメーター

その他のオプションで設定できる環境設定パラメーターの一覧を次の表に示します。なお，環境設定パラメーターの詳細については，「14.6(2) 共通情報環境設定ファイルの環境設定パラメーター一覧」を参照してください。

表4-11　環境設定パラメーター一覧（Windows）

定義キー | 環境設定パラメーター | 定義内容
[{JP1_DEFAULT|論理ホスト名}¥JP1AJS2COMMON]※ | "LARGEFILEUSE"= | ラージファイル対応の動作

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

4.6　JP1/AJS2 Console環境の設定

自動運用している業務を集中監視するJP1/AJS2 Consoleの環境設定は，JP1/AJS2 Console Manager環境とJP1/AJS2 Console Agent環境では異なります。

それぞれの環境で設定する内容を次に示します。

＜この節の構成＞

4.6.1　JP1/AJS2 Console Manager環境の設定

4.6.2　JP1/AJS2 Console Agent環境の設定

4.6.1　JP1/AJS2 Console Manager環境の設定

JP1/AJS2 Console Manager環境のセットアップに使用する構成定義ファイル（JP1/AJS2 Console Manager環境設定ファイル（ajs2cm.conf））には，環境設定に必要な情報が定義されています。情報を変更したい場合は，構成定義ファイルの内容（環境設定パラメーターの定義内容）を書き換えてください。

各項目の推奨値と設定が有効になる時期については，マニュアル「JP1/Automatic Job Management System 2 設計・運用ガイド　5.3.5(1) JP1/AJS2 Console Managerの環境設定」を参照してください。

この項では，JP1/AJS2 Console Manager環境の設定手順および設定内容を説明します。

＜この項の構成＞

(1)　JP1/AJS2 Console Manager環境の設定手順

(2)　JP1/AJS2 Console Manager環境で設定する内容

(1)　JP1/AJS2 Console Manager環境の設定手順

構成定義ファイル（環境設定パラメーター）は，初期状態では推奨値で定義されています。必要に応じて，JP1/AJS2 Console Managerの環境を設定し直してください。

JP1/AJS2 Console Manager環境の設定手順を次に示します。

Windowsの［コントロールパネル］の［サービス］で，次に示すサービスを停止する。

JP1/AJS2 Console Managerサービス

次のファイルをメモ帳などのテキストエディターで開く。

JP1/AJS2 Consoleのインストール先フォルダ¥conf¥ajs2cm.conf

必要に応じて，JP1/AJS2 Console Managerの環境を変更する。

ファイルを保存し，次のコマンドを実行する。

jbssetcnf ファイル名

jbssetcnfコマンドのパスは，「JP1/Baseのインストール先フォルダ¥bin¥jbssetcnf」です。
jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/AJS2 Console Managerを再起動する。
設定ファイルの内容が構成定義に反映されます。

注意

JP1/Baseを前提製品とするJP1シリーズのプログラムが稼働中の場合には，jbssetcnfコマンドを実行する前に，JP1シリーズのプログラムを終了させてください。

(2)　JP1/AJS2 Console Manager環境で設定する内容

(a)　JP1/AJS2 Console Manager環境設定ファイルの環境設定パラメーター一覧

JP1/AJS2 Console Managerは，定義キー［JP1_DEFAULT¥JP1AJS2CONSOLEMANAGER］に構成定義情報を設定できます。論理ホストを使用する場合でも，DATADIRECTORYキー以外の構成定義パラメーターは，JP1_DEFAULTホストキーの値が使用されます。

JP1/AJS2 Console Manager環境設定ファイルで定義する環境設定パラメーターの一覧を次の表に示します。

表4-12　環境設定パラメーター一覧（ajs2cm.conf）

環境設定パラメーター
内容およびデフォルト値

"MAXSESSION"=
最大同時セション数
デフォルトは「dword:00000010」（10進数で16）。

"IPC_TIMEOUT"=
リモート通信タイムアウト時間
デフォルトは「dword:00000000」。

"IPCRETRYINTERVAL"=
リトライ間隔
デフォルトは「dword:00000001」。

"IPCRETRYCOUNT"=
リトライ回数
デフォルトは「dword:00000003」。

"SESSIONTIMEOUT"=
接続打ち切り時間
デフォルトは「dword:00000078」（10進数で120）。

"CHARCODE"=
ユーザー定義データに格納される情報の文字コード
セットアップを実行すると，「SJIS」が設定されます。

"HNTRLOGLEVEL"=
統合トレースログに出力するメッセージレベル
デフォルトは「error」。

"DATADIRECTORY"=
ルートスコープ用データディレクトリ名
デフォルトは「JP1/AJS2 Consoleのインストール先フォルダ¥database」。

"RECONNECTINTERVAL"=
JP1/AJS2 Console Agentへの再接続間隔
デフォルトは「dword:0000012C」（10進数で300）。

"TRACELOGFILE"=
JP1/AJS2 Console Managerのトレースログファイル名
デフォルトは「JP1/AJS2 Consoleのインストール先フォルダ¥log¥tracelog.cm」。

"IPC_CONNECTTIMEOUT"=
リモート通信接続タイムアウト値
デフォルトは「dword:00000014」（10進数で20）。

注意

構成定義パラメーターのDATADIRECTORYの指定に誤りがある場合は，JP1/AJS2 Console Viewでのログイン時にエラーになります。DATADIRECTORY以外の構成定義パラメーターの指定に誤りがある場合は，JP1/AJS2 Console Managerの標準設定で動作します。

(b)　JP1/AJS2 Console Managerの環境設定パラメーターの定義内容

環境設定パラメーターの定義内容の詳細を次に示します。

なお，詳細の記載がないパラメーターは値を変更しないでください。

"MAXSESSION"=dword:最大同時セション数

JP1/AJS2 Console Viewの最大接続数を16進数で指定します。

指定できる範囲は，0～40（10進数で0～64）です。

デフォルトは「dword:00000010」（10進数で16）です。

JP1/AJS2 Console Viewの接続数がここで指定した値を超える場合は，エラーになります。

"IPC_TIMEOUT"=dword:通信タイムアウト時間

JP1/AJS2 Console Agentと通信するときのタイムアウト時間（秒）を16進数で指定します。

指定できる範囲は，0～258（10進数で0～600）です。

デフォルトは「dword:00000000」（10進数で0）です。

ここで指定した時間（秒）待っても通信できない場合は，エラーになります。なお，この場合OSのタイムアウト時間に依存して制御されます。

"IPCRETRYINTERVAL"=dword:リトライ間隔

通信エラー時のリトライ間隔（秒）を16進数で指定します。

指定できる範囲は，0～A（10進数で0～10）です。

デフォルトは「dword:00000001」（10進数で1）です。

リトライが発生するたびに，ここで指定した値分が加算されます。

"IPCRETRYCOUNT"=dword:リトライ回数

通信エラー時のリトライ回数を16進数で指定します。

指定できる範囲は，0～64（10進数で0～100）です。

デフォルトは「dword:00000003」（10進数で3）です。

"SESSIONTIMEOUT"=dword:接続打ち切り時間

JP1/AJS2 Console Viewとの通信が切れた場合にどのくらい待って（分）接続を打ち切るのかを16進数で指定します。

指定できる範囲は，0～78（10進数で0～120）です。

デフォルトは「dword:00000078」（10進数で120）です。

"CHARCODE"="{C|SJIS|EUC}"

ネスト業務スコープ・監視オブジェクトの名称や定義内容で使用する文字コードを指定します。

SJIS

シフトJISコード

C

7ビットASCII文字コード

EUC

EUC文字コード

文字コードは一つだけ定義してください。何も指定しなかった場合は，「C」が仮定されます。

"HNTRLOGLEVEL"="{none|error|warn|info}"

統合トレースログに出力するメッセージレベルを次の中から選択して指定します。

none

どのメッセージも出力されません。

error

エラーメッセージが出力されます。

warn

警告メッセージが出力されます。

info

情報メッセージが出力されます。

デフォルトは「error」です。

"DATADIRECTORY"="データディレクトリパス"

ルートスコープの定義情報を格納するディレクトリ名を191バイト以内で指定します。

ディレクトリ名は，完全名で指定します。

デフォルトは「JP1/AJS2 Consoleのインストール先フォルダ¥database」です。

変更する場合は，その時点ですでに存在するディレクトリを指定してください。新たなデータディレクトリを指定する場合は，先にディレクトリを作成してから指定してください。存在しないディレクトリを指定した場合は，JP1/AJS2 Console Viewのログイン時にエラーになります。

なお，ここで指定したディレクトリ内のファイルは，削除しないでください。

"RECONNECTINTERVAL"=dword:JP1/AJS2 Console Agentとの再接続間隔

JP1/AJS2 Console Agentと接続できなかった場合に再接続するまでの間隔（秒）を16進数で指定します。

指定できる範囲は，1E～E10（10進数で30～3,600）です。

デフォルトは「dword:0000012C」（10進数で300）です。

"TRACELOGFILE"="トレースログファイル名称"

トレースログファイル名称を完全名，かつ255バイト以内で指定します。

トレース情報を確実に記録できるように必ずローカルディスク上のファイル名として指定してください。

デフォルトは，「JP1/AJS2 Consoleのインストール先フォルダ¥log¥tracelog.cm」です。

なお，ファイルはトレース情報が出力されたときに新規作成されます。したがって，既存のファイル名と同じ名称は指定しないでください。

"IPC_CONNECTTIMEOUT"=dword:リモート通信接続タイムアウト値

JP1/AJS2 Console Agentに接続する場合などのリモート通信接続タイムアウト値を16進数で指定します。0～258（10進数で0～600）（単位：秒）の値を指定します。デフォルトは「dword:00000014」（10進数で20）です。

なお，OSで設定されているTCP/IPの接続タイムアウト値がこの値より短い場合，OSの設定が有効になります。

4.6.2　JP1/AJS2 Console Agent環境の設定

JP1/AJS2 Console Agent環境のセットアップに使用する構成定義ファイル（JP1/AJS2 Console Agent環境設定ファイル（ajs2ca.conf））には，環境設定に必要な情報が定義されています。情報を変更したい場合は，構成定義ファイルの内容（環境設定パラメーターの定義内容）を書き換えてください。

項目の推奨値と設定が有効になる時期については，マニュアル「JP1/Automatic Job Management System 2 設計・運用ガイド　5.3.5(2) JP1/AJS2 Console Agentの環境設定」を参照してください。

この項では，JP1/AJS2 Console Agent環境の設定手順および設定内容を説明します。

＜この項の構成＞

(1)　JP1/AJS2 Console Agent環境の設定手順

(2)　JP1/AJS2 Console Agent環境で設定する内容

(1)　JP1/AJS2 Console Agent環境の設定手順

構成定義ファイル（環境設定パラメーター）は，初期状態では推奨値で定義されています。必要に応じて，JP1/AJS2 Console Agentの環境を設定し直してください。

JP1/AJS2 Console Agent環境の設定手順を次に示します。

Windowsの［コントロールパネル］の［サービス］で，次に示すサービスを停止する。

JP1/AJS2 Console Agentサービス

次のファイルをメモ帳などのテキストエディターで開く。

JP1/AJS2 - Managerのインストール先フォルダ¥conf¥ajs2ca.conf

必要に応じて，JP1/AJS2 Console Agentの環境を変更する。

ファイルを保存し，次のコマンドを実行する。

jbssetcnf ファイル名

jbssetcnfコマンドのパスは，「JP1/Baseのインストール先フォルダ¥bin¥jbssetcnf」です。
jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/AJS2 Console Agentを再起動する。
設定ファイルの内容が構成定義に反映されます。

注意

JP1/Baseを前提製品とするJP1シリーズのプログラムが稼働中の場合には，jbssetcnfコマンドを実行する前に，JP1シリーズのプログラムを終了させてください。

(2)　JP1/AJS2 Console Agent環境で設定する内容

(a)　JP1/AJS2 Console Agentの環境設定パラメーター一覧

JP1/AJS2 Console Agentは，定義キー［JP1_DEFAULT¥JP1AJS2CONSOLEAGENT］に構成定義情報を設定できます。論理ホストのオブジェクトを監視する場合でも，構成定義パラメーターはJP1_DEFAULTホストキーの下に設定してください。

JP1/AJS2 Console Agent環境設定ファイルで定義する環境設定パラメーターの一覧を次の表に示します。

表4-13　環境設定パラメーター一覧（ajs2ca.conf）

環境設定パラメーター
内容およびデフォルト値

"MAXSESSION"=
最大同時セション数
デフォルトは「dword：00000010」（10進数で16）。

"HNTRLOGLEVEL"=
統合トレースログに出力するメッセージレベル
デフォルトは「error」。

"TRACELOGFILE"=
JP1/AJS2 Console Agentのトレースログファイル名
デフォルトは「JP1/AJS2 - Managerのインストール先フォルダ¥log¥tracelog.ca」。

"ENABLEOPERATION"=
操作機能の許可
デフォルトは「yes」。

注意

構成定義パラメーターの指定に誤りがある場合は，JP1/AJS2 Console Agentの標準設定で動作します。

(b)　JP1/AJS2 Console Agentの環境設定パラメーターの定義内容

環境設定パラメーターの定義内容の詳細を次に示します。

なお，詳細の記載がないパラメーターは値を変更しないでください。

"MAXSESSION"=dword:最大同時セション数

JP1/AJS2 Console Managerの最大接続数を16進数で指定します。

指定できる範囲は，0～40（10進数で0～64）です。

デフォルトは「dword：00000010」（10進数で16）です。

JP1/AJS2 Console Managerからの接続数がここで指定した値を超える場合は，エラーになります。

"HNTRLOGLEVEL"="{none|error|warn|info}"

JP1/AJS2 Console Agentサービスが統合トレースログに出力するメッセージレベルを次の中から選択して指定します。

none

どのメッセージも出力されません。

error

エラーメッセージが出力されます。

warn

警告メッセージが出力されます。

info

情報メッセージが出力されます。

デフォルトは「error」です。

"TRACELOGFILE"="トレースログファイル名称"

トレースログファイル名称を255バイト以内で指定します。

トレースログファイル名称，完全名で指定します。

トレース情報を確実に記録できるように必ずローカルディスク上のファイル名として指定してください。

なお，ファイルはトレース情報が出力されたときに新規作成されます。したがって，既存のファイル名と同じ名称は指定しないでください。

デフォルトは「JP1/AJS2 - Managerのインストール先フォルダ¥log¥tracelog.ca」です。

"ENABLEOPERATION"="{yes|no}"

JP1/AJS2 Console Viewによる操作機能を許可するかどうかを指定します。

yes

JP1/AJS2 Console Viewによる操作機能を許可します。

no

JP1/AJS2 Console Viewによる操作機能を許可しません。

デフォルトは「yes」です。

4.7　そのほかの設定

ここでは，次に示す設定手順について説明します。

スケジューラーサービスの多重起動の設定
ルートジョブグループを管理するスケジューラーサービスの多重起動ができます。多重起動させると，ルートジョブグループをサービスごとに管理できるようになります。

ISAMファイル自動再編成機能の設定
JP1/AJS2サービスの起動時に，該当する物理ホストおよび論理ホストで使用するISAMデータファイルを自動的に再編成できます。

スケジューラーサービスの統合トレースログ出力レベルの変更
スケジューラーサービスが，統合トレースログに出力するメッセージのレベルを指定できます。

ネストジョブネット定義パラメーター出力時のスケジュールルールの出力方法の変更
スケジュールルールを有効にして上位ジョブネットのスケジュールに依存しないようにするのか，またはスケジュールルールを削除して上位ジョブネットのスケジュールに依存するようにするのかを指定できます。

スケジューラートレースログファイルの名称変更
スケジューラーサービスのトレースログファイル名をデフォルトから任意のファイル名に変更できます。

JP1/AJS2 - Managerの運用方法をサブミットジョブの登録や操作に限定するときの設定
JP1/AJS2 - Managerでジョブネットによるジョブの操作をしない場合，ジョブ実行制御のコマンドを使用したサブミットジョブの登録や操作に限定できます。

サスペンド機能の設定
実行登録中にルートジョブネットの下位定義を編集する場合に必要なサスペンド機能を有効にします。

登録解除や保存世代数管理による世代削除処理方式の変更
保存世代数に大きい値を設定しているジョブネットに対して登録解除の操作をすると，登録が解除されるまでに時間が掛かってしまうことがあります。これを回避するため登録解除の処理を非同期型に設定できます。

スケジューラーサービスをウォームスタートで起動させたときに，実行中であったジョブまたはジョブネットの終了メッセージ，および終了イベントの出力有無の設定

JP1/AJS2定義内容の事前チェック機能の設定
JP1/AJS2定義内容の事前チェックを行う場合に必要な事前チェック機能を有効にします。

ジョブネットコネクタで異なるスケジューラーサービス間のルートジョブネットの実行順序を制御するための設定
ジョブネットコネクタで異なるスケジューラーサービス間のルートジョブネットの実行順序を制御できるようにします。

＜この節の構成＞

4.7.1　スケジューラーサービスの多重起動の設定

4.7.2　ISAMファイル自動再編成機能の設定

4.7.3　スケジューラーサービスの統合トレースログ出力レベルの変更

4.7.4　ネストジョブネット定義パラメーター出力時のスケジュールルールの出力方法の変更

4.7.5　スケジューラートレースログファイルの名称変更

4.7.6　JP1/AJS2 - Managerの運用方法をサブミットジョブの登録や操作に限定するときの設定

4.7.7　サスペンド機能の設定

4.7.8　登録解除や保存世代数管理による世代削除処理方式の変更

4.7.9　スケジューラーサービスをウォームスタートで起動させたときに，実行中であったジョブまたはジョブネットの終了メッセージ，および終了イベントの出力有無の設定

4.7.10　JP1/AJS2定義内容の事前チェック機能の設定

4.7.11　ジョブネットコネクタで異なるスケジューラーサービス間のルートジョブネットの実行順序を制御するための設定

4.7.1　スケジューラーサービスの多重起動の設定

スケジューラーサービスの多重起動を設定するためには，まず，追加するサービスの名称などの情報を設定します。次に，そのサービス用のデータベースを新規に作成します。

スケジューラーサービスの多重起動の設定手順および追加したスケジューラーサービスの削除手順を次に示します。

論理ホストへのスケジューラーサービスの追加，および論理ホストに追加したスケジューラーサービスの削除については，「9.4.7 論理ホストのスケジューラーサービスの多重起動の設定」を参照してください。

＜この項の構成＞

(1)　スケジューラーサービスを多重起動する

(2)　追加したスケジューラーサービスを削除する

(1)　スケジューラーサービスを多重起動する

スケジューラーサービスの多重起動の設定手順を次に示します。

Windowsの［コントロールパネル］の［サービス］で，次に示すサービスを停止する。

JP1/AJS2サービス

JP1/AJS2 Monitorサービス

JP1/Baseサービス

JP1/Base Control Serviceサービス

JP1/Base Eventサービス

JP1/Base LogTrapサービス

エクスプローラなどで，次に示すフォルダを作成する。

データベースフォルダ

一時ファイル用フォルダ

ジョブエラー情報フォルダ

退避情報フォルダ

なお，退避情報フォルダ以外は，自ホスト内（物理ホストとすべての論理ホスト）に設定されている，ほかのスケジューラーサービスが使用するフォルダと重複しないようにしてください。また，ほかのスケジューラーサービスが使用するフォルダの配下にも作成しないでください。

Windowsの［スタート］メニューから［プログラム］－［JP1_Automatic Job Management System 2 - Manager］－［環境設定］を選択する。
［マネージャー環境設定］ダイアログボックスが表示されます。このダイアログボックスの定義項目の詳細については，「4.1 スケジューラーサービス環境の設定」，「4.2.1(1) ジョブ実行環境を定義する」および「4.3.1(1) イベント起動を定義する」を参照してください。

［スケジューラーサービスの制御］タブで，［追加］ボタンをクリックする。
［サービスの設定］ダイアログボックスが表示されます。

スケジューラーサービスの多重起動のために必要な項目を入力する。

（例）

「AJSROOT2」というサービスを追加する場合

　スケジューラーサービスの追加

「AJSROOT2」と入力します。

　スケジューラーサービスの識別番号

「2」と入力します。スケジューラーサービスの識別番号は，自ホスト内の物理ホストおよびすべての論理ホストで使用している識別番号と重複しない番号を指定してください。

　ジョブ状態通知ポートのサービス名

「jp1ajs2report2」と入力します。ジョブ状態通知ポートのサービス名には，現在作成中の論理ホスト内の，ほかのスケジューラーサービスで使用しているサービス名と重複しない名称を指定してください。

［次へ］ボタンをクリックする。
［ディレクトリ名の設定］ダイアログボックスが表示されます。

各項目に，手順2で作成したフォルダを指定する。

［次へ］ボタンをクリックする。
［ログの設定］ダイアログボックスが表示されます。

ログの設定内容に問題がないことを確認する。

［完了］ボタンをクリックする。
［ログの設定］ダイアログボックスが閉じます。

［マネージャー環境設定］ダイアログボックスで，［OK］ボタンをクリックする。
［マネージャー環境設定］ダイアログボックスが閉じます。

次のファイルをメモ帳などのエディターで開く。

システムフォルダ¥system32¥drivers¥etc¥Services

手順5で指定したジョブ状態通知ポートのサービス名に対するポート番号を設定する。

（例）

ポート番号を「20248」として設定する場合

jp1ajs2report2 20248/tcp

注意

設定するポート番号は既存の番号と重ならないようにしてください。また，Windowsファイアウォールを設定した環境で運用する場合は，設定したポート番号（上記の例ではサービス名：jp1ajs2report2，ポート番号：20248）をWindowsファイアウォールの規則へ登録して，ファイアウォールを透過できるようにしてください。

次のコマンドを実行して，追加したスケジューラーサービス用のJP1/AJS2データベースを作成する。

ajssetup -F [スケジューラーサービス名]

（例）

「AJSROOT2」サービス用のJP1/AJS2データベースを作成する場合

ajssetup -F AJSROOT2

キューレスジョブを利用する場合は，キューレスジョブのセットアップをする。
次のコマンドを実行します。

ajsqlsetup -F [スケジューラーサービス名]

組み込みDBを使用する場合は組み込みDBに移行する。
組み込みDBセットアップツール（ajsembdbsetupスクリプト）を使用して，標準データベースを組み込みDBに移行します。
組み込みDBの移行手順については「5. スケジューラーデータベースに組み込みDBを使用する場合のセットアップ」を参照してください。

JP1/BaseおよびJP1/AJS2サービスを再起動する。
設定した内容でスケジューラーサービスが追加され，起動します。
再起動後，JP1/AJS2 - Viewなどで，追加したサービス名が付けられたマネージャージョブグループが表示されていることを確認してください。

多重起動時のコマンド実行についての補足事項

スケジューラーサービスを多重起動している場合，「-F サービス名」オプションを指定しないでコマンドを実行すると，デフォルトのスケジューラーサービスに対する操作となります。

環境変数AJSCONFにサービス名を指定しておくと，-Fオプションを省略できます。

(2)　追加したスケジューラーサービスを削除する

追加したスケジューラーサービスの削除手順を次に示します。

JP1/AJS2サービスおよびJP1/AJS2 Monitorサービスを停止する。
論理ホストのJP1/AJS2 - Managerも含め，すべてのJP1/AJS2サービスを停止してください。

スケジューラーサービスを追加したときに作成したフォルダを削除する。

［マネージャー環境設定］ダイアログボックスの［スケジューラーサービスの制御］タブで，削除したいサービスを選択し，［削除］ボタンをクリックする。
追加したスケジューラーサービスが削除されます。

4.7.2　ISAMファイル自動再編成機能の設定

JP1/AJS2サービスの起動時に，該当する物理ホストおよび論理ホストで使用するISAMデータファイルを自動的に再編成できます。JP1/AJS2 - Managerのインストール時には，この機能は無効になっています。有効にするには，「JP1/AJS2 - Managerのインストール先フォルダ¥conf¥jp1ajs_spmd_pre.conf.model」ファイルを，サービス構成ファイル格納フォルダのjp1ajs_spmd_pre.confファイルにコピーし，JP1/AJS2サービスのアカウントで読み込みができる権限を与えてください。サービス構成ファイル格納フォルダは，物理ホスト環境では「JP1/AJS2 - Managerのインストール先フォルダ¥conf」，論理ホスト環境では「jp1ajs2hasetup.exeで指定した共有ディスク上のファイルフォルダ¥jp1ajs2¥conf」です。

ISAMファイル自動再編成機能を有効にすると，JP1/AJS2サービスの起動時に，「JP1/AJS2 - Managerのインストール先フォルダ¥bin」フォルダに格納されている，jpqautocond.batおよびajsautocond.batが起動されます。jpqautocond.batは，ジョブ実行環境のデータファイルを再編成します。ajsautocond.batは，ISAMで運用されているすべてのスケジューラーサービスのデータベースを再編成します。

ajsautocond.batは次の処理を行います。

JP1/AJS2 - Viewから，再編成の対象となるホストにあるデータベースへの接続を切り離す。
データベースへの接続を切り離す場合で，すでにデータベースへの処理要求があったときは，その要求が終了するまで接続の切り離しを待ちます。
データベースへの接続を切り離したあとに，JP1/AJS2 - Viewから再接続すると，「KAVV461-E 指定したスケジューラーサービスはメンテナンス中のため接続できません。」メッセージが出力されます。その場合は，時間を置いて（再編成の終了を待って）再接続してください。
また，ジョブネットワーク要素を操作するコマンドが，再編成の対象となるホストで実行中の場合も，該当するコマンドの実行が終了するまで接続の切り離しを待ちます。再編成中にジョブネットワーク要素を操作するコマンドを実行した場合は，「KAVS1717-E メンテナンス中のため実行できません」メッセージが出力されます。
これらの切断状況監視時間は，環境変数AJSAUTOCONDWAITで指定できます。指定できる値は，0～86,400（単位：秒）です。デフォルトは20秒です。切断状況監視時間内に切断が完了しない場合は，再編成は行いません。自動再編成を行う場合，環境変数AJSAUTOCONDWAITはJP1/AJS2サービスの起動環境に設定してください。
なお，ajsautocond.batは内部でjajs_maintainコマンドを呼び出します。環境変数AJSAUTOCONDWAITの値は，jajs_maintainコマンドの-cオプションに設定されます。この値が不正な場合は，jajs_maintainコマンドのエラーメッセージが下記補足事項に示すログファイルに出力され，再編成は行いません。
また，JP1/AJS2 Console機能を使用している場合，監視対象ホストが再編成中の間は，AJS2ユニット監視オブジェクトの状態が「状態不明」になります。

該当する物理ホストおよび論理ホストのすべてのスケジューラーサービスのデータベースを再編成する。

JP1/AJS2 - Viewおよびジョブネットワーク要素を操作するコマンドの，データベースへの接続抑止を解除する。

注意

再編成時には，対象の物理ホストまたは論理ホストの作業ディレクトリ（ジョブ実行環境のマネージャープロセス実行時のワークディレクトリおよび各スケジューラーサービスの一時ファイル用ディレクトリ）があるドライブに再編成対象のスケジューラーおよびジョブ実行環境のISAMファイルの中で最もサイズが大きいファイルの2倍程度の空き容量が必要です。

また，スケジューラーサービスおよびジョブ実行環境データベースディレクトリがあるドライブに，再編成対象のISAMファイルの中で最もサイズが大きいファイルと同程度の空き容量が必要です。

補足事項

06-71以前のJP1/AJS2では，スクリプトの処理方式にJP1/BaseのISAMデータベース再編成コマンドJiscondを使用していましたが，JP1/AJS2 07-00では自動再編成スクリプトajsautocondおよびjpqautocondスクリプトで再編成前のファイルの検証と再編成失敗時の自動修復ができるようにするため，スクリプトの処理方式を変更しています。できるだけマスターISAMファイルが不正になる状態を少なくするためにISAMファイルの状態を検証（Jischk）し，データを一度作業ファイルに抽出（Jisext）して再作成（Jisconv）した上でマスターファイルにリネームする方式になっています。それぞれの処理でエラーになった場合には，エラーメッセージが次に示す再編成ログファイルに出力されますので，オペレーターのとる処置を参照して対処してください。

・物理ホストの場合

次の二つのログファイルにエラーメッセージを出力します。

JP1/AJS2 - Managerのインストール先フォルダ¥log¥ajsautocond[面数番号].log

JP1/AJS2 - Managerのインストール先フォルダ¥log¥jpqautocond[面数番号].log

[面数番号]はログファイル名を表し，1から4の数字になります。

四つのログファイルをすべて使い切ると，古いログファイルから再利用します。

・論理ホストの場合

次の二つのログファイルにエラーメッセージを出力します。

JP1/AJS2 - Managerのインストール先フォルダ¥log¥ajsautocond_[論理ホスト名][面数番号].log

JP1/AJS2 - Managerのインストール先フォルダ¥log¥jpqautocond_[論理ホスト名][面数番号].log

[面数番号]はログファイル名を表し，1から4の数字になります。

四つのログファイルをすべて使い切ると，古いログファイルから再利用します。

4.7.3　スケジューラーサービスの統合トレースログ出力レベルの変更

スケジューラーサービスが，統合トレースログに出力するメッセージのレベルを指定できます。指定手順を次に示します。

Windowsの［コントロールパネル］の［管理ツール］から［サービス］を選択し，次に示すサービスを停止する。

JP1/AJS2サービス

JP1/AJS2 Monitorサービス

メモ帳などのテキストエディターで，次に示す内容を記述した設定ファイルを作成する。

[{JP1_DEFAULT|論理ホスト名}¥JP1AJSMANAGER¥スケジューラーサービス名]
"HNTRLOGLEVEL"="設定値"

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。
「設定値」には，出力レベルとして次の四つのどれかを指定します。

none
どのメッセージも出力しません。

error
エラーメッセージを出力します。

warn
エラーおよび警告メッセージを出力します。

info
エラー，警告および情報メッセージを出力します。

デフォルトは「error」です。
設定ファイルのファイル名は任意です。

ファイルを保存し，次のコマンドを実行する。

jbssetcnf 設定ファイル名

jbssetcnfコマンドのパスは，「JP1/Baseのインストール先フォルダ¥bin¥jbssetcnf」です。
jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/AJS2を再起動する。
設定ファイルの内容が構成定義に反映されます。

4.7.4　ネストジョブネット定義パラメーター出力時のスケジュールルールの出力方法の変更

スケジュールルールを有効にして上位ジョブネットのスケジュールに依存しないようにするのか，またはスケジュールルールを削除して上位ジョブネットのスケジュールに依存するようにするのかを指定できます。

このオプションは，スケジュールルールを持ったルートジョブネットをネストジョブネットにコピーして作成したジョブネットに対して，ajsprint，ajsbackup，ajsexportコマンドおよびJP1/AJS2 - Viewで「退避」を行った場合に有効です。

Windowsの［コントロールパネル］の［管理ツール］から［サービス］を選択し，次に示すサービスを停止する。

JP1/AJS2サービス

JP1/AJS2 Monitorサービス

メモ帳などのテキストエディターで，次に示す内容を記述した設定ファイルを作成する。

[{JP1_DEFAULT|論理ホスト名}¥JP1AJSMANAGER¥スケジューラーサービス名]
"AJSPRINTNETSCHPRF"="設定値"

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。
「設定値」には，次のどちらかを指定します。

yes
スケジュールルールを有効にして，上位ジョブネットのスケジュールに依存しない。

no
スケジュールルールを削除して，上位ジョブネットのスケジュールに依存する。

デフォルトは「yes」です。
この項目は，JP1/AJS2の新規のインストール時および新規のセットアップ時に「no」が設定されます。
設定ファイルのファイル名は任意です。

ファイルを保存し，次のコマンドを実行する。

jbssetcnf 設定ファイル名

jbssetcnfコマンドのパスは，「JP1/Baseのインストール先フォルダ¥bin¥jbssetcnf」です。
jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/AJS2を再起動する。
変更した構成定義の内容が反映されます。

4.7.5　スケジューラートレースログファイルの名称変更

スケジューラーサービスのトレースログファイル名のデフォルトは「JP1/AJS2 - Managerのインストール先フォルダ¥log¥tracelog」です。このファイル名を任意のファイル名に変更できます。ファイル名の変更手順を次に示します。

Windowsの［コントロールパネル］の［管理ツール］から［サービス］を選択し，次に示すサービスを停止する。

JP1/AJS2サービス

JP1/AJS2 Monitorサービス

メモ帳などのテキストエディターで，次の内容を記述した設定ファイルを作成する。

[JP1_DEFAULT¥JP1AJSMANAGER]
"TRACELOGFILE"="ファイル名"

「ファイル名」には，スケジューラーサービスのトレースログファイルの名称をフルパスで，かつ255バイト以内で指定します。
物理ホストおよびすべての論理ホストのスケジューラートレース情報が，ここで指定したファイルに記録されます。トレース情報を確実に記録できるように，必ずローカルディスク上のファイル名として指定してください。
なお，ファイルは，トレース情報が出力されたときに新規作成されます。したがって，既存のファイル名は指定しないでください。
設定ファイルのファイル名は任意です。

ファイルを保存し，次のコマンドを実行する。

jbssetcnf 設定ファイル名

jbssetcnfコマンドのパスは，「JP1/Baseのインストール先フォルダ¥bin¥jbssetcnf」です。
jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/AJS2を再起動する。
設定ファイルの内容が構成定義に反映されます。

4.7.6　JP1/AJS2 - Managerの運用方法をサブミットジョブの登録や操作に限定するときの設定

JP1/AJS2 - Managerでジョブネットによるジョブの操作をしないで，ジョブ実行制御のコマンドを使用してサブミットジョブの登録や操作だけをするような運用をしたい場合は，JP1/AJS2 - Managerプロセス管理定義の変更が必要です。

プロセス管理定義の変更手順を次に示します。

Windowsの［コントロールパネル］の［管理ツール］から［サービス］を選択し，次に示すサービスを停止する。

JP1/AJS2サービス

JP1/AJS2 Monitorサービス

次のファイルをメモ帳などのテキストエディターで開く。

JP1/AJS2のインストール先フォルダ¥conf¥jp1ajs_spmd.conf

プロセス管理定義を次の行だけに変更して保存する。

queue|jpqmon.exe|||1800|

注意事項

このパラメーターを記述するときには，空行（スペースだけの行も含みます）を作成しないでください。

JP1/AJS2を再起動する。

4.7.7　サスペンド機能の設定

実行登録中にルートジョブネットの下位定義を編集する場合，対象のルートジョブネットをサスペンドするため，サスペンド機能を有効にしておく必要があります。

JP1/AJS2のサスペンド機能は，初期状態では無効になっているため，ajssetupコマンドで有効にしてください。

サスペンド機能を有効にする手順を次に示します。

Windowsの［コントロールパネル］の［管理ツール］から［サービス］を選択し，次に示すサービスを停止する。

JP1/AJS2サービス

JP1/AJS2 Monitorサービス

次のコマンドを実行して，サスペンド機能を使用するための環境を設定する。

ajssetup -F [スケジューラーサービス名] -m

ajssetupコマンドの文法および注意事項については，「20. セットアップ時に使用するコマンド　ajssetup」を参照してください。

JP1/AJS2サービスを再起動する。

実行登録中のルートジョブネットの下位定義変更の詳細については，マニュアル「JP1/Automatic Job Management System 2 解説　10.2.14 ジョブネットの実行登録を解除しないでジョブネットやジョブの定義を変更する」を参照してください。

4.7.8　登録解除や保存世代数管理による世代削除処理方式の変更

ルートジョブネットおよびルートリモートジョブネットの保存世代数の設定には，1～99（保存世代数の拡張機能を使用した場合は1～999）を指定できます。この保存世代数に関して，次に示す条件のジョブネットに対して登録解除の操作をすると，登録が解除されるのに長い時間が掛かってしまいます。

保存世代数に30以上を指定しているジョブネット

保存世代数が10以上で，かつ起動条件を使用しているジョブネット

そのため，ほかのジョブネットの起動条件監視が，「監視打ち切り終了」状態になったり，ジョブネットが正しく実行されなくなったりする場合があります。

この現象は，スケジューラーサービスの登録解除処理の設定が，「同期型」に設定されているのが原因です。登録解除処理の設定が「同期型」だと，登録解除対象の世代数が大量であればあるほど登録解除に多大な時間を必要とします。その登録解除に掛かる多大な時間が，ほかのジョブネットの実行動作に影響を与えてしまいます。

この現象を回避するには，登録解除処理の設定を「非同期型」にすることで対処してください。非同期型に変更する場合，設定変更前に実行していたジョブネットの登録情報を必要とする場合と必要としない場合とで手順が異なります。

JP1/AJS2 08-00以降で新規インストールした場合は，環境設定パラメーターBACKGROUNDLEAVEに「非同期型（yes）」が設定されるため，変更は不要です。ただし，バージョンアップインストールした場合は，「同期型（no）」が設定されていることがあります。

環境設定パラメーターBACKGROUNDLEAVEに「同期型（no）」が設定されている，またはBACKGROUNDLEAVEが設定されていない場合は，登録解除に掛かる時間を考慮し，登録解除処理の設定を「非同期型（yes）」に変更することをお勧めします。設定を「同期型（no）」に変更する場合，設定変更前に実行していたジョブネットの登録情報は削除されるため注意してください。

登録解除処理の設定を変更する場合，設定変更が必要なスケジューラーサービスがあるJP1/AJS2のサービスを停止する必要があります。

スケジューラーサービス（AJSROOT1）の登録解除処理を変更する例を挙げて，設定方法を次に示します。

＜この項の構成＞

(1)　登録解除処理の設定を「同期型」から「非同期型」にする手順

(2)　登録解除処理の設定を「非同期型」から「同期型」にする手順

(1)　登録解除処理の設定を「同期型」から「非同期型」にする手順

環境設定パラメーターBACKGROUNDLEAVEの設定値がすでに「非同期型（yes）」に設定されている場合は，ここに示す操作の必要はありません。

(a)　実行していたジョブネットの登録情報を必要としない場合

実行していたジョブネットの登録情報を必要としない場合の手順を次に示します。

Windowsの［コントロールパネル］の［管理ツール］から［サービス］を選択し，次に示すサービスを停止する。

JP1/AJS2サービス

JP1/AJS2 Monitorサービス

メモ帳などのテキストエディターで，次の内容を記述したテキストファイルを作成する。

[{JP1_DEFAULT|論理ホスト名}¥JP1AJSMANAGER¥スケジューラーサービス名]
"BACKGROUNDLEAVE"="yes"

（例）スケジューラーサービス名が「AJSROOT1」の場合

[{JP1_DEFAULT|論理ホスト名}¥JP1AJSMANAGER¥AJSROOT1]
"BACKGROUNDLEAVE"="yes"

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

ファイルを保存し，次のコマンドを実行する。

jbssetcnf テキストファイル名

jbssetcnfコマンドのパスは，「JP1/Baseのインストール先フォルダ¥bin¥jbssetcnf」です。
jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/AJS2 Monitorサービスを起動する。
Windowsの［コントロールパネル］の［管理ツール］から［サービス］を選択し，JP1/AJS2 Monitorサービスを起動します。

JP1/AJS2サービスをコールドスタートする。
Windowsの［コントロールパネル］の［管理ツール］から［サービス］を選択し，［開始パラメータ］に-coldを指定して，JP1/AJS2サービスを開始します。

(b)　実行していたジョブネットの登録情報を必要とする場合

実行登録情報が必要な場合は，次に示す手順に従って移行作業を実施してください。

Windowsの［コントロールパネル］の［管理ツール］から［サービス］を選択し，次に示すサービスを停止する。

JP1/AJS2サービス

JP1/AJS2 Monitorサービス

メモ帳などのテキストエディターで，次の内容を記述したテキストファイルを作成する。

[{JP1_DEFAULT|論理ホスト名}¥JP1AJSMANAGER¥スケジューラーサービス名]
"BACKGROUNDLEAVE"="yes"

（例）スケジューラーサービス名が「AJSROOT1」の場合

[{JP1_DEFAULT|論理ホスト名}¥JP1AJSMANAGER¥AJSROOT1]
"BACKGROUNDLEAVE"="yes"

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

ファイルを保存し，次のコマンドを実行する。

jbssetcnf テキストファイル名

jbssetcnfコマンドのパスは，「JP1/Baseのインストール先フォルダ¥bin¥jbssetcnf」です。
jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/AJS2 Monitorサービスを起動する。
Windowsの［コントロールパネル］の［管理ツール］から［サービス］を選択し，JP1/AJS2 Monitorサービスを起動します。

実行登録情報を非同期型に変換する。
次に示すコマンドを実行します。
JP1/AJS2のインストール先フォルダ¥tools¥ajsregcnv -F スケジューラーサービス名
（例）スケジューラーサービス名が「AJSROOT1」の場合

JP1/AJS2のインストール先フォルダ¥tools¥ajsregcnv -F AJSROOT1

JP1/AJS2サービスを起動する。
Windowsの［コントロールパネル］の［管理ツール］から［サービス］を選択し，JP1/AJS2サービスを開始します。

(2)　登録解除処理の設定を「非同期型」から「同期型」にする手順

登録解除処理の設定を「非同期型」から「同期型」に変更する場合の手順を次に示します。

Windowsの［コントロールパネル］の［管理ツール］から［サービス］を選択し，次に示すサービスを停止する。

JP1/AJS2サービス

JP1/AJS2 Monitorサービス

メモ帳などのテキストエディターで，次の内容を記述したテキストファイルを作成する。

[{JP1_DEFAULT|論理ホスト名}¥JP1AJSMANAGER¥スケジューラーサービス名]
"BACKGROUNDLEAVE"="no"

（例）スケジューラーサービス名が「AJSROOT1」の場合

[{JP1_DEFAULT|論理ホスト名}¥JP1AJSMANAGER¥AJSROOT1]
"BACKGROUNDLEAVE"="no"

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

ファイルを保存し，次のコマンドを実行する。

jbssetcnf テキストファイル名

jbssetcnfコマンドのパスは，「JP1/Baseのインストール先フォルダ¥bin¥jbssetcnf」です。
jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/AJS2 Monitorサービスを起動する。
Windowsの［コントロールパネル］の［管理ツール］から［サービス］を選択し，JP1/AJS2 Monitorサービスを起動します。

JP1/AJS2サービスをコールドスタートする。
Windowsの［コントロールパネル］の［管理ツール］から［サービス］を選択し，［開始パラメータ］に-coldを指定して，JP1/AJS2サービスを開始します。

4.7.9　スケジューラーサービスをウォームスタートで起動させたときに，実行中であったジョブまたはジョブネットの終了メッセージ，および終了イベントの出力有無の設定

スケジューラーサービスをウォームスタートで起動させたときに，実行中であったジョブまたはジョブネットの終了メッセージ，および終了イベントの出力有無を選択できます。設定手順を次に示します。

Windowsの［コントロールパネル］の［管理ツール］から［サービス］を選択し，次に示すサービスを停止する。

JP1/AJS2サービス

JP1/AJS2 Monitorサービス

メモ帳などのテキストエディターで，次に示す内容を記述した設定ファイルを作成する。

[{JP1_DEFAULT|論理ホスト名}¥JP1AJSMANAGER¥スケジューラーサービス名]
"WARMSTARTMSG"="設定値"

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。
「設定値」には，次のどちらかを指定します。

yes
終了メッセージ，および終了イベントを出力します。

no
終了メッセージ，および終了イベントを出力しません。

デフォルトは「no」です。
設定ファイルのファイル名は任意です。

ファイルを保存し，次のコマンドを実行する。

jbssetcnf 設定ファイル名

jbssetcnfコマンドのパスは，「JP1/Baseのインストール先フォルダ¥bin¥jbssetcnf」です。
jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/AJS2サービス，およびJP1/AJS2 Monitorサービスを再起動する。
設定ファイルの内容が構成定義に反映されます。

4.7.10　JP1/AJS2定義内容の事前チェック機能の設定

JP1/AJS2では，本番運用時に障害の発生を抑えるため，ジョブの定義内容に不正がないかどうかを本番運用の開始前にチェックできます。このチェック機能を使用できるように設定します。

＜この項の構成＞

(1)　JP1/AJS2定義内容の事前チェック機能の設定手順

(2)　JP1/AJS2定義内容の事前チェック機能の設定変更

(3)　定義パラメーター一覧

(4)　定義内容

(1)　JP1/AJS2定義内容の事前チェック機能の設定手順

JP1/AJS2定義内容の事前チェック機能を使用するための手順を次に示します。

次のコマンドを実行する。
JP1/AJS2 - Managerの場合

　ajschksetup -m -a

JP1/AJS2 - Agentの場合

　ajschksetup -a

ajschksetupコマンドの詳細については，「20. セットアップ時に使用するコマンド　ajschksetup」を参照してください。

Windowsの［コントロールパネル］の［管理ツール］から［サービス］を選択し，次に示すサービスを起動する。

JP1/AJS2 Check Managerサービス

JP1/AJS2 Check Agentサービス

(2)　JP1/AJS2定義内容の事前チェック機能の設定変更

JP1/AJS2定義内容の事前チェック機能の設定を変更する手順を次に示します。

Windowsの［コントロールパネル］の管理ツールから［サービス］を選択し，次に示すサービスを停止する。

JP1/AJS2 Check Managerサービス

JP1/AJS2 Check Agentサービス

メモ帳などのテキストエディターで，「(3) 定義パラメーター一覧」に示したパラメーターを記述した設定ファイルを作成する。

ファイルを保存し，次のコマンドを実行する。

jbssetcnf 設定ファイル名

jbssetcnfコマンドのパスは，「JP1/Baseのインストール先フォルダ¥bin¥jbssetcnf」です。
jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

手順1で停止したサービスを再起動します。
設定ファイルに記述した内容が反映されます。

(3)　定義パラメーター一覧

表4-14　JP1/AJS2定義内容の事前チェック機能の設定するための定義パラメーター一覧

定義キー | 定義パラメーター | 定義内容
[JP1_DEFAULT¥JP1AJS2¥CHECK] | "AJSCHK_CHECKFILE"※= | 定義内容の事前チェック結果格納ファイル名
"AJSCHK_LOGDIR"= | 定義チェックログフォルダ名
"AJSCHK_LOGSIZE"= | 定義チェックログファイルのサイズ
"AJSCHK_TRACELOGFILE"= | 定義内容の事前チェック機能のトレースログファイル名
"AJSCHK_CHARCODE"= | ジョブ情報や定義内容の事前チェック結果を表示する文字コードを指定

注※

JP1/AJS2 - Managerでだけ設定できます。

(4)　定義内容

"AJSCHK_CHECKFILE"="定義内容の事前チェック結果格納ファイル名"

定義内容の事前チェック結果を格納するファイル名を255バイト以内で指定します。

ファイル名はフルパスで指定します。

デフォルトは「JP1/AJS2 - Managerのインストール先フォルダ¥log¥ajscheckfile.txt」です。

"AJSCHK_LOGDIR"="定義チェックログフォルダ名"

定義内容の事前チェックプロセスがログ出力するログフォルダ名を180バイト以内で指定します。

フォルダ名はフルパスで指定します。

デフォルトは「JP1/AJS2 - ManagerまたはJP1/AJS2 - Agentのインストール先フォルダ¥log」です。

このフォルダ配下のajscheck1.logにログが書き込まれます。ajscheck1.logにAJSCHK_LOGSIZEで指定したサイズまでログが書き込まれるとajscheck2.logにログが書き込まれるようになります。

"AJSCHK_LOGSIZE"=dword:ログファイルサイズ

定義内容の事前チェックプロセスがログ出力するファイルのサイズを16進数で指定します。

0または4～1E8480（10進数で0または4～2,000,000）（単位：キロバイト）の間で指定します。

デフォルトは「dword:00001000」（10進数で4,096）です。

指定したサイズが，定義チェックログファイル1（ajscheck1.log），および2（ajscheck2.log）のファイルサイズになります。

注意事項

ここで指定したサイズの上限までファイル1に情報が書き込まれると，それ以上の情報はファイル2に書き込まれます。さらに，ファイル2でもサイズの上限まで情報が書き込まれると，再びファイル1に戻って情報を書き込みます。ファイル1→ファイル2→ファイル1→ファイル2を繰り返し，古い情報から上書きされるため，サイズの指定には注意が必要です。

"AJSCHK_TRACELOGFILE"="トレースログファイル名"

定義内容の事前チェック機能のトレースログファイルの名称を指定します。

ファイル名はフルパスで指定します。

ファイル名を省略した場合，トレースログは出力されません。

セットアップ時には，次のファイル名が仮定されます。

「JP1/AJS2 - ManagerまたはJP1/AJS2 - Agentのインストール先フォルダ¥log¥tracelog.ch」です。

"AJSCHK_CHARCODE"="{none|C|SJIS|EUC|UTF-8}"

ジョブ情報や定義内容の事前チェック結果を表示する文字コードを指定します。

none

7ビットASCII文字コードを指定します。JP1/AJS2 - Manager，JP1/AJS2 - Agent間で文字コード変換をしません。

C

7ビットASCII文字コードを指定します。JP1/AJS2 - Manager，JP1/AJS2 - Agent間で文字コード変換をしません。

SJIS

シフトJISコードを指定します。

EUC

EUC文字コードを指定します。

UTF-8

UTF-8文字コードを指定します。

デフォルトは「none」です。

なお，定義内容の事前チェック時の環境変数LANGは，JP1/AJS2 Check Agentサービス起動時の環境変数LANGとなります。

注意事項

次の場合，ジョブ情報や定義内容の事前チェック結果は，AJSCHARCODEに指定された文字コードで表示されます。

AJSCHARCODEに「SJIS」または「EUC」を指定していて，AJSCHK_CHARCODEに「none」または「C」を指定している。

AJSCHARCODEに「C」を指定している。

4.7.11　ジョブネットコネクタで異なるスケジューラーサービス間のルートジョブネットの実行順序を制御するための設定

異なるスケジューラーサービス間のルートジョブネットの実行順序を制御する場合，ジョブネットコネクタおよび接続先のジョブネットの各ホストでセットアップが必要です。次に示す設定手順に従ってセットアップしてください。

なお，このセットアップはマネージャー環境（JP1/AJS2 - Manager）で作業します。エージェント環境（JP1/AJS2 - Agent）で設定する作業はありません。

＜この項の構成＞

(1)　スケジューラーサービス間通信制御プロセスの設定手順

(2)　スケジューラーサービス間通信制御プロセスの設定変更

(3)　定義パラメーター一覧

(4)　定義内容

(1)　スケジューラーサービス間通信制御プロセスの設定手順

スケジューラーサービス間通信制御プロセス（ajsgwd.exe）の設定手順を次に示します。

jp1ajs_spmd.confファイルを編集する。
jp1ajs_spmd起動時にスケジューラーサービス間通信制御プロセス（ajsgwd.exe）を起動させるため，jp1ajs_spmd.confファイルを編集します。
スケジューラーの状態監視の設定，またはキューレスジョブ使用時に論理ホストを自動でアタッチ・デタッチする場合の設定をしていないときは，jp1ajs_spmd.confファイルのバックアップを作成し，jp1ajs_spmd_gw.conf.modelファイルをjp1ajs_spmd.confにリネームしてください。
スケジューラーの状態監視の設定またはキューレスジョブ使用時に論理ホストを自動でアタッチ・デタッチする場合の設定をしているときは，jp1ajs_spmd.confファイルのバックアップを作成し，スケジューラーの状態監視の設定またはキューレスジョブ使用時に論理ホストを自動でアタッチ・デタッチする場合の設定をしているときは，jp1ajs_spmd.confファイルのバックアップを作成し，jp1ajs_spmd_gw.conf.modelファイルの内容を参照してjp1ajs_spmd.confファイルに次の下線部分を追加します。

queue|jpqmon.exe|||1800|
evactionm|jpomanager.exe||queue|1800|
evactiona|jpoagent.exe||evactionm|1800|
ajsovstatd|ajsovstatd.exe||evactiona|1800|
schedule|ajsmasterd.exe||evactiona|1800|
gatewayd|ajsgwmasterd.exe|||1800|

なお，論理ホストのjp1ajs_spmd_gw.conf.modelファイルは上書きインストールの対象ではありませんので，物理ホストのjp1ajs_spmd_gw.conf.modelを参照してjp1ajs_spmd.confファイルを編集してください。
jp1ajs_spmd.confファイルおよびjp1ajs_spmd_gw.conf.modelファイルの格納フォルダは，次のとおりです。

物理ホストの場合

JP1/AJS2 - Managerのインストール先フォルダ¥conf

論理ホストの場合

共有フォルダ¥jp1ajs2¥conf

スケジューラーサービス間通信制御プロセスが使用する通信ポートのサービス名（jp1ajs2gw）とポート番号（23160/tcp）をservicesファイルに設定する。

jp1ajs2gw 23160/tcp

jp1ajs_service_0700.confファイルを編集する。
JP1/AJS2 - Managerを08-50より前のバージョンから上書きインストールして環境を構築する場合，次のようにjp1ajs_service_0700.confファイルを編集します。
jp1ajs_service_0700.confの設定を変更していないときは，jp1ajs_service_0700.confファイルのバックアップを作成し，jp1ajs_service_0700.conf.modelファイルをjp1ajs_service_0700.confにリネームしてください。
jp1ajs_service_0700.confの設定を変更しているときは，jp1ajs_service_0700.confファイルのバックアップを作成し，jp1ajs_service_0700.conf.modelファイルの内容を参照してjp1ajs_service_0700.confファイルに次の下線部分を追加します。

qlcltd|ajsqlcltd.exe||0|3|3|21600|
queue|jpqmon.exe||0|3|3|21600|
evactionm|jpomanager.exe||0|3|3|21600|
evactiona|jpoagent.exe||0|3|3|21600|
ajsovstatd|ajsovstatd.exe||0|3|3|21600|
schedule|ajsmasterd.exe||0|3|3|21600|
gatewayd|ajsgwmasterd.exe||0|3|3|21600|

なお，論理ホストのjp1ajs_service_0700.conf.modelファイルは上書きインストールの対象ではありませんので，物理ホストのjp1ajs_service_0700.conf.modelを参照してjp1ajs_service_0700.confファイルを編集してください。
jp1ajs_service_0700.conf.modelファイルおよびjp1ajs_service_0700.confファイルの格納フォルダは，次のとおりです。

物理ホストの場合

JP1/AJS2 - Managerのインストール先フォルダ¥conf

論理ホストの場合

共有フォルダ¥jp1ajs2¥conf

メモ帳などのテキストエディターで，次のパラメーターを記述した設定ファイルを作成する。
異なるスケジューラーサービス間のルートジョブネットの実行順序を制御するスケジューラーサービスに対して次の内容を設定してください。

[{JP1_DEFAULT|論理ホスト名}¥JP1AJSMANAGER¥スケジューラーサービス名]
"RJCUSE"="yes"

{JP1_DEFAULT|論理ホスト名}の部分には，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

ファイルを保存し，次のコマンドを実行する。

jbssetcnf 設定ファイル名

jbssetcnfコマンドのパスは，「JP1/Baseのインストール先フォルダ¥bin¥jbssetcnf」です。
jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。
なお，論理ホストで設定する場合は，実行系および待機系の両系のホストでこの設定が必要です。論理ホストでの設定方法については，「9.4.3 共通定義情報変更時の作業」を参照してください。

JP1/AJS2のサービスを起動する。
設定した内容が反映されます。

(2)　スケジューラーサービス間通信制御プロセスの設定変更

スケジューラーサービス間通信制御プロセスについての設定を変更する手順を次に示します。

Windowsの［コントロールパネル］の管理ツールから［サービス］を選択し，JP1/AJS2のサービスを停止する。

メモ帳などのテキストエディターで，「(3) 定義パラメーター一覧」に示したパラメーターを記述した設定ファイルを作成する。

ファイルを保存し，次のコマンドを実行する。

jbssetcnf 設定ファイル名

jbssetcnfコマンドのパスは，「JP1/Baseのインストール先フォルダ¥bin¥jbssetcnf」です。
jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。
なお，論理ホストで設定する場合は，実行系および待機系の両系のホストでこの設定が必要です。論理ホストでの設定方法については，「9.4.3 共通定義情報変更時の作業」を参照してください。

JP1/AJS2のサービスを再起動します。
変更した内容が反映されます。

(3)　定義パラメーター一覧

表4-15　異なるスケジューラーサービス間のルートジョブネットの実行順序を制御するための定義パラメーター一覧

定義キー | 定義パラメーター | 定義内容
[{JP1_DEFAULT|論理ホスト名}¥JP1AJSMANAGER¥スケジューラーサービス名]※ | "RJCUSE"= | 異なるスケジューラーサービス間のルートジョブネットの実行順序を制御するかどうかの設定
"FGRECONLMT"= | フロー制御プロセスとスケジューラーサービス間通信制御プロセスが通信接続できなかった場合の再接続回数
[{JP1_DEFAULT|論理ホスト名}¥JP1AJS2¥GATEWAY]※ | "GWMAXCONNECTION"= | スケジューラーサービス間通信制御プロセス（ajsgwd.exe）が通信する際の最大同時接続数
"GWPROCESSHA"= | スケジューラーサービス間通信制御プロセス（ajsgwd.exe）が異常終了した場合に，スケジューラーサービス間通信制御プロセスを管理するプロセス（ajsgwmasterd.exe）を終了するかどうかの設定
"GWRESTARTCOUNT"= | スケジューラーサービス間通信制御プロセスが異常終了した場合に，自動的に再起動する回数

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

(4)　定義内容

"RJCUSE"="{yes|no}"

異なるスケジューラーサービス間のルートジョブネットの実行順序を制御するかどうかを設定します。

yes

異なるスケジューラーサービス間のルートジョブネットの実行順序を制御する場合に指定します。

no

異なるスケジューラーサービス間のルートジョブネットの実行順序を制御しない場合に指定します。

デフォルトは「no」です。

"FGRECONLMT"=dword:再接続回数

フロー制御プロセスとスケジューラーサービス間通信制御プロセスが通信接続できなかった場合の再接続回数を16進数で指定します。

指定できる範囲は，0～64（10進数で0～100）です。

デフォルトは「dword:00000003」（10進数で3）です。

"GWMAXCONNECTION"=dword:最大同時コネクション数

スケジューラーサービス間通信制御プロセス（ajsgwd.exe）が通信する際の，最大同時接続数を16進数で指定します。

指定できる範囲は，a～400（10進数で10～1,024）です。

デフォルトは「dword:a」（10進数で10）です。

システム内の，スケジューラーサービス間通信制御プロセスをセットアップしたJP1/AJS2 - Managerホストの数を指定してください（物理ホスト・論理ホストの両方を含む）。指定した値が実際の値より少ない場合，スケジューラーサービス間通信制御プロセスの通信に失敗する場合があります。

"GWPROCESSHA"="{yes|no}"

スケジューラーサービス間通信制御プロセス（ajsgwd.exe）が異常終了した場合に，スケジューラーサービス間通信制御プロセスを管理するプロセス（ajsgwmasterd.exe）を終了するかどうかを設定します。

yes

スケジューラーサービス間通信制御プロセスを管理するプロセス（ajsgwmasterd.exe）を終了します。

クラスタ構成時の論理ホストの場合は，JP1/AJS2サービス全体が停止します。

no

スケジューラーサービス間通信制御プロセスを管理するプロセス（ajsgwmasterd.exe）を終了しません。

クラスタ構成時の論理ホストの場合でもJP1/AJS2サービスを停止させないで，スケジューラーサービス間のルートジョブネットの実行順序制御以外の機能を使用できます。

デフォルトは「no」です。

"GWRESTARTCOUNT"=dword:スケジューラーサービス間通信制御プロセス再起動回数

スケジューラーサービス間通信制御プロセスが異常終了した場合に，自動的に再起動する回数を16進数で指定します。

指定できる範囲は，0～3（10進数で0～3）です。

デフォルトは「dword:00000003」（10進数で3）です。

5.　スケジューラーデータベースに組み込みDBを使用する場合のセットアップ

この章では，スケジューラーデータベースに組み込みDBを使用する場合のセットアップについて説明します。

＜この章の構成＞

5.1　組み込みDBを使用する場合の準備

5.2　組み込みDBのセットアップ

5.3　クラスタ構成時の実行系組み込みDBのセットアップ

5.4　クラスタ構成時の待機系組み込みDBのセットアップ

5.5　クラスタ構成時の組み込みDBの設定変更

5.6　組み込みDBのクラスタソフトへの登録

5.1　組み込みDBを使用する場合の準備

この節では，JP1/AJS2 - Managerのスケジューラーデータベースとして組み込みDBを使用する場合の準備について説明します。

＜この節の構成＞

5.1.1　前提条件

5.1.2　組み込みDBのセットアップ手順

5.1.3　組み込みDB稼働環境と運用方法の検討

5.1.1　前提条件

スケジューラーサービスが設定されていて，スケジューラーデータベースがISAMで作成済みである必要があります。

クラスタ構成の場合は，論理ホスト環境でスケジューラーサービスの設定およびスケジューラーデータベースがISAMで作成済みである必要があります。

5.1.2　組み込みDBのセットアップ手順

組み込みDBのセットアップ手順を次に示します。

図5-1　組み込みDBのセットアップ手順

5.1.3　組み込みDB稼働環境と運用方法の検討

＜この項の構成＞

(1)　稼働環境

(2)　運用方法

(1)　稼働環境

組み込みDBが稼働する環境条件として，次の項目について検討および確認します。

システム構成

環境構築規模

システムファイル領域

(a)　システム構成

非クラスタ構成（物理ホスト）とするか，またはクラスタ構成（論理ホスト）とするかを検討します。組み込みDBだけでなく，JP1/AJS2サービスの全体構成としての環境条件となります。

(b)　環境構築規模

JP1/AJS2の運用規模に合わせて，組み込みDB環境を構築する規模を三つ（小規模，中規模，大規模）の中から選択します。それぞれの規模の目安について，次の表に示します。

表5-1　組み込みDB環境構築規模の目安

規模
ユニット数
1日に実行される
ジョブ・ジョブネット数

小規模
10,000以下
10,000以下

中規模
10,000～40,000
10,000～25,000

大規模
40,000～100,000
25,000～50,000

運用規模が大規模を超える場合は，組み込みDB環境を大規模で構築し，そのあと環境の拡張を実施してください。

組み込みDB環境の拡張については，マニュアル「JP1/Automatic Job Management System 2 コマンドリファレンス　1. コマンド　ajsembdbaddarea」を参照してください。

(c)　システムファイル領域

組み込みDBで使用するシステムファイルの二重化実施の有無について検討します。システムファイルを二重化すると，必要なディスク容量は増加しますが，ディスク障害などによって組み込みDBシステムが停止する可能性を低くすることができます。

組み込みDBの稼働環境ごとに必要なディスク容量を次の表に示します。項番1～12から一つを選択してください。

表5-2　組み込みDB稼働環境ごとの必要ディスク容量

項番 | 組み込みDB稼働環境 | 必要ディスク容量（単位：メガバイト）
システム構成 | 環境構築規模 | システムファイルの二重化 | データ領域 | システムファイル領域 | 作業領域 | 合計
1 | 非クラスタ | 小規模 | なし | 300 | 702 | － | 1,002
2 | あり | 1,404 | 1,704
3 | 中規模 | なし | 800 | 1,200 | － | 2,000
4 | あり | 2,400 | 3,200
5 | 大規模 | なし | 1,600 | 3,402 | － | 5,002
6 | あり | 6,804 | 8,404
7 | クラスタ | 小規模 | なし | 300 | 702 | 40＊2※ | 1,082
8 | あり | 1,404 | 1,784
9 | 中規模 | なし | 800 | 1,200 | 2,080
10 | あり | 2,400 | 3,280
11 | 大規模 | なし | 1,600 | 3,402 | 5,082
12 | あり | 6,804 | 8,484

（凡例）

－：作成先は指定できません。

注※

クラスタ構成時の作業領域は，共有ディスク上ではなくローカルディスク上に作成する必要があるため，実行系および待機系それぞれに必要です。

(2)　運用方法

組み込みDBの具体的な運用方法として，次の項目について検討します。

システムログの運用

バックアップの取得タイミング

バックアップからの回復点

バックアップからの回復方法

(a)　システムログの運用

システムログを使用して回復する場合は，次に示す二とおりの運用方法のどちらかを選択する必要があります。システムログを使用して回復しない場合，考慮する必要はありません。

システムログ運用（アンロードレス運用）
組み込みDB環境構築時に作成されるシステムファイル（システムログファイル）上にデータを保持する運用方法です。システムログファイルをすべて使い切ると組み込みDBシステムが停止してしまうため，システムログファイルの状態を定期的に監視する必要があります。

アンロードログ運用
システムログファイルに出力されたデータを別ファイルに退避（アンロード）する運用方法です。アンロードは組み込みDBによって自動的に実行され，同時にシステムログファイルも再利用できる状態になります。しかし，アンロードログファイルを保存するためのディスク容量が必要となり，ディスクの空き容量については監視する必要があるほか，回復時には使用するアンロードログファイルを正しい順序で指定する必要があります。

(b)　バックアップの取得タイミング

組み込みDBのバックアップを取得するタイミングには，次の二つがあります。

JP1/AJS2サービス停止中（ジョブ，ジョブネットを運用していないとき）
組み込みDBのバックアップを取得する際に，JP1/AJS2の運用を停止する必要があります。取得したバックアップデータだけでバックアップ時点へ回復できる，基本的なバックアップ方法です。

JP1/AJS2サービス稼働中（ジョブ，ジョブネットを運用しているとき）
組み込みDBのバックアップを取得する際に，JP1/AJS2の運用を停止する必要はありません。しかし，回復する際には取得したバックアップデータと共に，組み込みDBが出力しているシステムログまたはアンロードログが必要です。

(c)　バックアップからの回復点

組み込みDBのバックアップからの回復点は，次の二つです。

バックアップ取得時点
バックアップを取得した時点の状態へ回復します。バックアップ取得時点以降の運用内容は反映されません。

バックアップ取得後の最新の同期点
バックアップを取得した時点の状態に加えて，バックアップ時点以降の運用によるデータベースの更新内容も反映されるため，最新の状態まで回復できます。

(d)　バックアップからの回復方法

バックアップからの回復方法を次に説明します。

バックアップデータだけ
バックアップ時に取得したバックアップデータだけで回復します。バックアップ取得時点の状態に回復できます。

バックアップデータとシステムログ
バックアップ時に取得したバックアップデータと共に，バックアップ時点以降に出力されたシステムログの情報を使用して回復します。バックアップ時点以降の運用によるデータベースの更新内容も反映されます。JP1/AJS2運用中に取得したバックアップからの回復は，この方法で回復します。

組み込みDBの運用方法を次の表に示します。

表5-3　組み込みDBの運用方法

項番
運用方法

システムログの運用
バックアップ取得タイミング
バックアップからの回復点
バックアップからの回復方法

A
システムログ運用しない
JP1/AJS2サービス停止中
バックアップ取得時点
バックアップデータのみ

B
B-1
システムログ運用
（アンロードレス運用）
JP1/AJS2サービス停止中
バックアップ取得時点
バックアップデータのみ

B-2
最新の同期点
バックアップデータとシステムログ

B-3
JP1/AJS2サービス稼働中

C
C-1
アンロードログ運用
JP1/AJS2サービス停止中
バックアップ取得時点
バックアップデータのみ

C-2
最新の同期点
バックアップデータとアンロードログ

C-3
JP1/AJS2サービス稼働中

運用方法の特徴を次の表に示します。この表に示す運用方法の特徴を考慮して表5-3から運用方法を選択してください。

表5-4　各運用方法の特徴

項番※
特徴

長所
短所

A
システムログファイルの状態を監視する必要がありません。

バックアップからの回復点はバックアップ時点だけです。

バックアップ取得時にはJP1/AJS2サービスを停止する必要があります。

B
共通
アンロードログ運用と比較した場合，回復するときの手順が容易です。

システムログファイルの状態を監視する必要があります。

バックアップの必要がなくても頻繁に取得する必要があります。

B-1
システムログファイルに障害が発生しても，バックアップデータだけで回復できます。

バックアップからの回復点はバックアップ時点だけです。

バックアップ取得時にはJP1/AJS2サービスを停止する必要があります。

B-2

システムログファイルに障害が発生しても，バックアップデータだけで回復できます。

バックアップ取得時点以降の運用を反映した最新の状態に回復できます。

バックアップ取得時にはJP1/AJS2サービスを停止する必要があります。

B-3

バックアップ取得時にJP1/AJS2サービスを停止する必要がありません。

バックアップ取得時点以降の運用を反映した最新の状態に回復できます。

システムログファイルに障害が発生すると，該当するバックアップデータからの回復は一切できません。

C
共通

システムログファイルの状態を監視する必要がありません。

システムログ運用と比較した場合，バックアップを必要以上に取得する必要がありません。

自動ログアンロード機能の動作状態を監視する必要があります。

アンロードログファイル作成ディレクトリを準備する必要があります。

システムログ運用と比較した場合，回復するときの手順が繁雑です。

C-1

システムログファイルに障害が発生しても，バックアップデータだけで回復できます。

バックアップからの回復点はバックアップ時点だけです。

バックアップ取得時にはJP1/AJS2サービスを停止する必要があります。

C-2

システムログファイルに障害が発生しても，バックアップデータだけで回復できます。

バックアップ取得時点以降の運用を反映した最新の状態に回復できます。

バックアップ取得時にはJP1/AJS2サービスを停止する必要があります。

C-3

バックアップ取得時にJP1/AJS2サービスを停止する必要がありません。

バックアップ取得時点以降の運用を反映した最新の状態に回復できます。

アンロードログファイルを失うと，該当するバックアップデータからの回復は一切できません。

注※

表5-3の項番に対応します。

バックアップおよびバックアップからの回復方法の詳細については，次に示す個所を参照してください。

マニュアル「JP1/Automatic Job Management System 2 設計・運用ガイド　3.5.5 システムログを使用しない運用」

マニュアル「JP1/Automatic Job Management System 2 設計・運用ガイド　3.5.6 システムログ運用」

マニュアル「JP1/Automatic Job Management System 2 設計・運用ガイド　3.5.7 アンロードログ運用」

表5-3で選択した運用をする場合，組み込みDBの環境構築，組み込みDBのバックアップおよびバックアップからの回復で必要となるコマンドを次に示します。

ajsembdbbuildコマンド（組み込みDBの環境を構築する）

ajsembdbbackupコマンド（バックアップする）

ajsembdbrstrコマンド（バックアップから回復する）

これらコマンドの実行時に必要となるオプションを次の表に示します。

表5-5　コマンドの指定オプション

項番※
システムファイルの二重化
システムログの運用方法および回復方法に関するオプション

ajsembdbbuild
（-bs，-br，-bl）
ajsembdbbackup
（-s，-z）
ajsembdbrstr
（-lr，-l）

A
なし
なし
なし
なし

B
B-1
-bs
なし
なし

-z
なし

B-2
-lr

B-3
-s -z
-lr

C
C-1
-bs -bl
なし
なし

C-2
-l

C-3
-s
-l

A
あり
－
－
－

B
B-1
-br
なし
なし

-z
なし

B-2
-lr

B-3
-s -z
-lr

C
C-1
-br -bl
なし
なし

C-2
-l

C-3
-s
-l

（凡例）

－：該当しない。

注※

表5-3の項番に対応します。

ajsembdbbuildコマンドについては，「20. セットアップ時に使用するコマンド　ajsembdbbuild」を参照してください。

ajsembdbbackupコマンドおよびajsembdbrstrコマンドについては，マニュアル「JP1/Automatic Job Management System 2 コマンドリファレンス　1. コマンド」を参照してください。

5.2　組み込みDBのセットアップ

この節では，非クラスタ構成時に組み込みDBを使用する場合のインストール，環境構築および移行方法について説明します。

＜この節の構成＞

5.2.1　組み込みDBのインストール

5.2.2　組み込みDB環境の構築

5.2.3　組み込みDBへの移行

5.2.4　複数スケジューラーデータベースの組み込みDBへの移行

5.2.5　組み込みDBの再セットアップ

5.2.1　組み込みDBのインストール

ここでは，組み込みDB（JP1/AJS2 - Database option）のインストール方法を説明します。

組み込みDBをインストールするホストについての注意事項

組み込みDBは，JP1/AJS2 - Managerに付属します。同梱されるJP1/AJS2 - Managerと同一のマシンにインストールして使用してください。組み込みDBを単体で，別のマシンにインストールしたり，外部のクライアントソフトウェアから接続したりすることはできません。

＜この項の構成＞

(1)　組み込みDBインストール前の作業

(2)　組み込みDBを新規にインストールする

(3)　組み込みDBを上書きインストールする

(1)　組み込みDBインストール前の作業

ここでは，組み込みDBインストール前の作業について説明します。

(a)　ディスク容量の確認

インストールする前にディスクの空き容量が十分かどうかを確認してください。組み込みDBの場合は240メガバイト程度の容量が必要です。

(b)　仮想メモリーの確認

仮想メモリーは同じドライブに連続した領域を作成するように，初期サイズと最大サイズを同じ値（固定値）にしてください。仮想メモリーを連続で使えない場合，組み込みDBがメモリー不足で異常終了することがあります。

仮想メモリーは次の手順で確認できます。

スタートメニューから［コントロールパネル］を選択し，［システム］をクリックする。
［システムのプロパティ］ダイアログボックスが表示されます。

［詳細設定］タブをクリックする。

［パフォーマンス］ボックスの［設定］をクリックする。
［パフォーマンス オプション］ウィンドウが表示されます。

［詳細設定］タブをクリックする。

［仮想メモリ］ボックスの［変更］をクリックする。

必要な仮想メモリーを次に示します。また，実際に指定する値には，Windowsやほかのプログラムが使う容量を加えてください。仮想メモリーを変更した場合には，必ずWindowsを再起動してください。

ページングファイルサイズ＝130メガバイト

注意事項

JP1/AJS2 - Viewの接続数や設定されているスケジューラーサービスの数によって値は増加することがあります。

(c)　ファイルシステムの確認

組み込みDBをNTFSにインストールする場合，組み込みDB運用ディレクトリ下のファイルを圧縮しないでください。このディレクトリを圧縮すると，組み込みDBは正常に動作しません。

(2)　組み込みDBを新規にインストールする

JP1/AJS2 - Managerのスケジューラーデータベースとして，組み込みDBを使用する場合のインストール手順を次に示します。

(a)　インストール前の注意事項

組み込みDBのインストールは，Administrators権限があるユーザーが実行してください。Administrators権限がないユーザーがインストールを実行すると，エラーメッセージが表示され，インストールが中止されます。

ネットワークドライブにはインストールしないでください。

アンインストール後にインストールする場合は，アンインストールを実行したあとに必ずWindowsを再起動してください。

(b)　組み込みDBのインストール手順

組み込みDBのインストール手順を次に示します。

組み込みDBをインストールするホストに，Administrators権限でログオンする。

すべてのプログラムを終了する。
既存のJP1シリーズのプログラムが動作している場合，必ず停止しておいてください。

媒体をセットする。
HITACHI総合インストーラーの画面が表示されます。

セットアップ識別子を設定する。
セットアップ識別子に_JAn（n：0～9，A～Zの任意の文字）を指定します。
なお，組み込みDBを追加でインストールする場合は，組み込みDBのセットアップ識別子が重複しないように指定してください。

注意事項

一度インストールしたら，セットアップ識別子を途中で変更することはできません。セットアップ識別子を変更したい場合は，インストール済みの組み込みDBをアンインストールして，別のセットアップ識別子で再度インストールしてください。

HITACHI総合インストーラーの指示に従って必要な情報を入力し，インストールする。
インストール時に定義する情報を次に示します。

ユーザー情報
ユーザー名などを入力します。

インストール先フォルダ
組み込みDBをインストールするフォルダを指定します。
インストールするフォルダを変更する場合，次のことに注意してください。
・ドライブで始まり，次の要素で構成される文字列を指定してください。
　英数字
　_（下線）
　.（ピリオド）
　　（空白）
　（ （左括弧）
　） （右括弧）
　パス区切りの¥
・ドライブだけの指定はできません。
・全角文字，および特殊記号はディレクトリ名に使用できません。
・パス名の長さは200文字（バイト）以内にしてください。

プログラムフォルダ
プログラムメニュー名を指定します。

システム環境変数にTZを追加する。
環境変数TZに設定するタイムゾーンは，［日付と時刻のプロパティ］ダイアログボックスの［タイムゾーン］タブで設定したタイムゾーンと合わせてください。
（例）　TZ=JST-9

これで組み込みDBのインストールは終了です。

(c)　インストール後の注意事項

組み込みDBをインストールすると，インストールドライブの直下にtmpディレクトリが作成されます。このディレクトリは組み込みDBが使うので，削除しないでください。

組み込みDBで使う文字コードは，シフトJISコード（SJIS）です。

(3)　組み込みDBを上書きインストールする

ここでは組み込みDBのバージョンアップインストールについて説明します。

(a)　バージョンアップ前にすること

バージョンアップをする前に，次に示すことを必ず実施してください。

組み込みDBのデータベースのバックアップを取得する
ajsembdbbackupコマンドで，組み込みDBのバックアップを取得してください。

組み込みDBをインストールするホストに，Administrators権限でログオンする。

すべてのプログラムを終了する。
既存のJP1シリーズのプログラムが動作している場合，必ず停止しておいてください。

ajsembdbbackupコマンドで組み込みDBのバックアップを取得する。
ajsembdbbackupコマンド実行時，-sオプションを指定しないでください。指定した場合，ajsembdbrstrコマンドの実行時にエラーとなり回復できなくなります。ajsembdbbackupコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 2 コマンドリファレンス　1. コマンド　ajsembdbbackup」を参照してください。

組み込みDBが稼働中かを確認する
組み込みDBの稼働状態をajsembdbstatusコマンドで確認してください。
ajsembdbstatusコマンドの実行例を次に示します。この例では，_JA0の組み込みDB識別子でセットアップした環境が構築されているものと仮定します。

ajsembdbstatus -s ust

HOSTNAME  : hostname(154313)
SYSTEMID  : ajs2
UNITID    : unt1
ENTRYHOST : hostname
PAIRHOST  :
UNIT-STAT FES-STAT SETUP-STAT
ONLINE    ******** SETUP

ajsembdbstatusコマンドの実行結果のUNIT-STATを参照してください。ONLINEと表示されている場合，組み込みDBは稼働中です。この場合，ajsembdbstopコマンドで組み込みDBを正常終了させてください。

組み込みDBが正常終了しているかを確認する
バージョンアップをする場合，組み込みDBが正常終了している必要があります。組み込みDBが稼働中かどうかを確認した結果，組み込みDBがすでに停止しているか，ajsembdbstopコマンドで停止した場合，組み込みDBが正常終了しているかを確認してください。
次に示すファイルに出力されるKFPS01850-Iメッセージを参照してください。このメッセージに表示されている終了モードがNORMALの場合，組み込みDBは正常終了しています。

組み込みDB運用ディレクトリ¥spool¥pdlog1

組み込みDB運用ディレクトリ¥spool¥pdlog2

（例）　KFPS01850-I HiRDB system terminated. mode=NORMAL
組み込みDBが正常終了していない場合は，次に示す手順で組み込みDBを正常終了させてください。

ajsembdbstartコマンドで組み込みDBを開始する。

ajsembdbstopコマンドで組み込みDBを正常終了する。

組み込みDB運用ディレクトリ下のファイルのバックアップを取得する
バージョンアップの失敗に備えて，次に示すファイルのバックアップをOSの機能（コマンド）で取得してください。

組み込みDB運用ディレクトリ下のconf下にある全ファイル

組み込みDB運用ディレクトリ下にあるユーザーが作成したファイル

なお，取得したバックアップは，新バージョンの動作確認後に削除してください。

組み込みDBのサービスを停止する
［サービス］を起動し，［サービス］ウィンドウから組み込みDBのサービスを選択して停止してください。

(b)　バージョンアップ手順

組み込みDBをバージョンアップする手順を次に示します。

組み込みDBを上書きインストールする。
新しいバージョンの組み込みDBを上書きインストールします。組み込みDBのインストール方法については，「(2) 組み込みDBを新規にインストールする」を参照してください。インストールの際，セットアップ識別子には，上書きする組み込みDBのセットアップ識別子を指定してください。
なお，組み込みDBを複数のセットアップ識別子を指定してセットアップしている場合は，該当する組み込みDBをすべてバージョンアップしてください。

組み込みDBを開始する。
非クラスタ環境の場合は，組み込みDBは自動的に開始しますが，クラスタ環境の場合は，ajsembdbstartコマンドを実行して組み込みDBを開始してください。
なお，システム共通定義のpd_mode_confオペランド指定値を変更すると組み込みDBの開始方法が変わります。

組み込みDB環境が複数ある場合，ほかの組み込みDB環境に対しても，上記作業を実施してください。

(c)　バージョンアップに失敗した場合

ここでは，次に示す現象が発生した場合の対処方法について説明します。

組み込みDBの開始時にリターンコードが5以上のKFPX24404-Iメッセージがメッセージログおよびイベントログに出力された。

メッセージログとは，次に示すファイルのことです。

組み込みDB運用ディレクトリ¥spool¥pdlog1

組み込みDB運用ディレクトリ¥spool¥pdlog2

この場合，一緒に出力されたメッセージを参照し，バージョンアップ失敗の原因を取り除いてください。

(d)　組み込みDBを旧バージョンに戻す場合

組み込みDBを旧バージョンに戻す手順を次に示します。

組み込みDBが自動起動しないように設定を変更する。
システム共通定義のpd_mode_confオペランドの設定値をMANUAL2に変更してください。なお，手順4でpd_mode_confオペランドの設定値を元に戻すため，変更前の設定値を忘れないようにしてください。

組み込みDBをアンインストールする。
組み込みDBをアンインストールしてWindowsを再起動します。組み込みDBのアンインストール方法については，「10.3 組み込みDBのアンインストール」を参照してください。

旧バージョンの組み込みDBをインストールする。
旧バージョンの組み込みDBを同じ組み込みDB運用ディレクトリにインストールします。組み込みDBのインストール方法については，「(2) 組み込みDBを新規にインストールする」を参照してください。

組み込みDB運用ディレクトリ下のファイルを回復する。
「(a) バージョンアップ前にすること」の「組み込みDB運用ディレクトリ下のファイルのバックアップを取得する」で取得したバックアップから，旧バージョンの組み込みDB運用ディレクトリ下のファイルを回復します。
また，手順1で変更したシステム共通定義のpd_mode_confオペランドを変更前の設定値に戻してください。

システムファイルを初期化する。
システムログファイル，シンクポイントダンプファイル，およびステータスファイルを初期化します。次に示すコマンドラインを実行してください。

cmd /c 組み込みDB運用ディレクトリ¥conf¥fmkfs.bat
cmd /c 組み込みDB運用ディレクトリ¥conf¥sysfint.bat

また，旧バージョンでシステムログファイル，またはシンクポイントダンプファイルを追加した場合は，追加したファイルについても初期化します。
次に示すどちらかの操作で，システムログファイル，シンクポイントダンプファイルを初期化してください。

ajsembdbaddlogコマンドを使用して追加した場合
次に示すファイルの拡張子を「.bat」に変更して実行してください。
組み込みDB運用ディレクトリ¥conf¥embrm¥addlog
なお，バージョンアップ後に，ajsembdbaddlogコマンドでシステムログファイル，またはシンクポイントダンプファイルを追加した場合は，バージョンアップ後に追加した領域も初期化します。

pdfmkfsコマンドおよびpdloginitコマンドを使用して追加した場合
追加時に実施した操作を再度実行してください。この作業は，JP1 Version 7iで構築した組み込みDB環境に戻す場合が該当します。

組み込みDBを回復する。
「(a) バージョンアップ前にすること」の「組み込みDBのデータベースのバックアップを取得する」で取得したバックアップから，旧バージョンの組み込みDBを回復します。
組み込みDBの回復手順を次に示します。

1. -rオプションを指定したajsembdbstartコマンドを実行して組み込みDBを開始する。

2. -Mオプションを指定したajsembdbrstrコマンドで，バックアップから組み込みDBのシステム領域を回復する。

3. ajsembdbstopコマンドで組み込みDBを正常終了する。

4. ajsembdbstartコマンドで組み込みDBを開始する。

5. ajsembdbrstrコマンドで，バックアップから組み込みDBのデータ領域を回復する。

コマンドの詳細については，マニュアル「JP1/Automatic Job Management System 2 コマンドリファレンス　1. コマンド」を参照してください。

5.2.2　組み込みDB環境の構築

組み込みDBの環境構築手順について次に示します。

各サービスを停止する。
物理ホストおよびすべての論理ホストで，JP1/AJS2サービス，JP1/AJS2 MonitorサービスおよびJP1/AJS2 Console Agentサービスを含め，スケジューラーデータベースにアクセスするサービスはすべて停止してください。

組み込みDB環境構築コマンドを実行する。
ajsembdbbuildコマンドを使用して，組み込みDBの環境を構築します。
ajsembdbbuildコマンドを実行すると，次に示す処理が実行されます。

組み込みDBの定義情報作成

組み込みDBの領域作成

組み込みDBシステムの起動

大規模の組み込みDB環境を構築する場合のajsembdbbuildコマンドの指定例を次に説明します。表5-2および表5-3の項番の組み合わせについても示します。

指定例では次に示す設定値が設定，およびディレクトリが存在することと仮定します。

データ領域作成ディレクトリ：d:¥EmbDB¥RDArea

システムファイル領域作成ディレクトリ1：e:¥EmbDB¥SYSArea1

システムファイル領域作成ディレクトリ2：f:¥EmbDB¥SYSArea2

アンロードログファイル作成ディレクトリ：g:¥EmbDB¥Unload_Log

組み込みDBインストールフォルダ：c:¥win32app¥hitachi¥hirdb_e_JA0

組み込みDBセットアップ識別子：_JA0

システムファイルを二重化しないで，システムログを使用した運用をしない場合（表5-2，表5-3の組み合わせが5-A）

ajsembdbbuild -l
-d "d:¥EmbDB¥RDArea,e:¥EmbDB¥SYSArea1"
-i c:¥win32app¥hitachi¥hirdb_e_JA0 -id _JA0

システムファイルを二重化しないで，システムログ運用（アンロードレス運用）をする場合（表5-2，表5-3の組み合わせが5-B）

ajsembdbbuild -l
-d "d:¥EmbDB¥RDArea,e:¥EmbDB¥SYSArea1" -bs
-i c:¥win32app¥hitachi¥hirdb_e_JA0 -id _JA0

システムファイルを二重化しないで，アンロードログ運用をする場合（表5-2，表5-3の組み合わせが5-C）

ajsembdbbuild -l
-d "d:¥EmbDB¥RDArea,e:¥EmbDB¥SYSArea1" -bs
-bl g:¥EmbDB¥Unload_Log -i c:¥win32app¥hitachi¥hirdb_e_JA0
-id _JA0

システムファイルを二重化し，システムログ運用（アンロードレス運用）をする場合（表5-2，表5-3の組み合わせが6-B）

ajsembdbbuild -l
-d "d:¥EmbDB¥RDArea,e:¥EmbDB¥SYSArea1,f:¥EmbDB¥SYSArea2"
-br -i c:¥win32app¥hitachi¥hirdb_e_JA0 -id _JA0

システムファイルを二重化し，アンロードログ運用をする場合（表5-2，表5-3の組み合わせが6-C）

ajsembdbbuild -l
-d "d:¥EmbDB¥RDArea,e:¥EmbDB¥SYSArea1,f:¥EmbDB¥SYSArea2"
-br -bl g:¥EmbDB¥Unload_Log -i c:¥win32app¥hitachi¥hirdb_e_JA0
-id _JA0

ajsembdbbuildコマンドの詳細については，「20. セットアップ時に使用するコマンド　ajsembdbbuild」を参照してください。

補足事項

システムファイルを二重化し，システムログを使用した運用をしない（表5-2，表5-3の組み合わせが2-A，4-A，6-A）場合，環境を構築できません。

注意事項

組み込みDB環境を構築するホストのホスト名を，hostsファイルまたはDNSに登録してください。

組み込みDB環境を構築するホストのホスト名をjp1hosts定義ファイルに登録しても，組み込みDBで使用するホスト名として有効になりません。

組み込みDB環境を構築するホストのホスト名には，エイリアス名を使用しないでください。

組み込みDBが稼働できるホストのホスト名は，最大32バイトです。したがって，組み込みDB環境を構築するホストの物理ホスト名を1～32バイトで設定してください。

5.2.3　組み込みDBへの移行

ajsembdbsetupコマンドを使用して，ISAMで作成されているスケジューラーデータベースの内容を組み込みDBに移行します。

ajsembdbsetupコマンドを実行すると，次に示す処理が実行されます。

組み込みDBのデータベース情報の設定（スキーマ，テーブル）

組み込みDBへのスケジューラーデータベース情報の格納

JP1/AJS2環境設定パラメーターの設定

ISAMファイルの退避

大規模の組み込みDB環境で実行するajsembdbsetupコマンドの指定例を次に説明します。指定例では，次に示す設定値が設定されていることとします。

スケジューラーサービス名：AJSROOT1

組み込みDBセットアップ識別子：_JA0

ajsembdbsetup -F AJSROOT1 -ru l -id _JA0

補足事項

ajsembdbsetupコマンドを実行すると，次の表に示す環境設定パラメーターが設定されます。表に示す環境設定パラメーターについては設定値を変更しないでください。各環境設定パラメーターの詳細については，「14.1.3 スケジューラーサービス環境設定パラメーターの定義内容」を参照してください。

表5-6　ajsembdbsetupコマンド実行時に設定される環境設定パラメーター

環境設定パラメーター
定義内容
ajsembdbsetupコマンドで設定する内容※

AJSDBTYPE
データベース種別
EmbedDB

TABLENAMEPREFIX
テーブル名プリフィックス
次のどちらかが設定される。

-tpオプション指定値

AJS

TABLENAMEPOSTFIX
テーブルID
－

RDBAUTHID
RDB認可識別子
root

RDBUSER
RDBアクセスユーザー名
ajs2

RDBPASSWORD
RDBユーザーパスワード
－

RDBHOST
RDB接続先ホスト名
次のどれかが設定される。

物理ホスト名

-mhオプション指定値

環境変数JP1_HOSTNAMEの設定値

RDBPORT
RDB接続ポート番号
次のどちらかが設定される。

-pオプション指定値

22200

RDBIPC
RDBサーバとの通信方式
MEMORY

RDBSENDMEMSIZE
RDBプロセス間メモリ通信使用時の送信用メモリサイズ
次のどちらかが設定される。

-sオプション指定値

100

RDBRECVMEMSIZE
RDBプロセス間メモリ通信使用時の受信用メモリサイズ
次のどちらかが設定される。

-rオプション指定値

100

注※

設定内容が数値の場合は，10進数で表記しています。

5.2.4　複数スケジューラーデータベースの組み込みDBへの移行

ここでは，複数のスケジューラーデータベースを組み込みDBへ移行する方法について説明します。

＜この項の構成＞

(1)　スケジューラーサービスごとに異なる組み込みDB環境を構築する

(2)　一つの組み込みDB環境に複数のスケジューラーデータベースを移行する

(1)　スケジューラーサービスごとに異なる組み込みDB環境を構築する

複数のスケジューラーサービスが定義されていて，スケジューラーサービスごとに異なる組み込みDB環境を構築する場合，次に示す領域を別に準備してください。

なお，次に示す領域のうちシステムファイル領域，組み込みDB作業領域，アンロードログファイル作成ディレクトリについては，必要に応じて準備してください。

組み込みDB運用ディレクトリ

データ領域

システムファイル領域

組み込みDB作業領域

アンロードログファイル作成ディレクトリ

組み込みDB環境構築の際，使用するポート番号および組み込みDBセットアップ識別子が組み込みDB間で重複しないように指定する必要があります。そのため，ajsembdbbuildコマンドおよびajsembdbsetupコマンド実行時には，ポート番号を指定するオプション（-p）および組み込みDBセットアップ識別子を指定するオプション（-id）に，異なる値を指定してください。

セットアップの実施例を次に示します。

なお，この実施例は，「5.2.2 組み込みDB環境の構築」で示した環境がすでに構築されていることを前提に記載します。

組み込みDBの環境内容

データ領域作成ディレクトリ：h:¥EmbDB¥RDArea

システムファイル領域作成ディレクトリ1：i:¥EmbDB¥SYSArea1

システムファイル領域作成ディレクトリ2：j:¥EmbDB¥SYSArea2

アンロードログファイル作成ディレクトリ：k:¥EmbDB¥Unload_Log

組み込みDBインストールフォルダ：c:¥win32app¥hitachi¥hirdb_e_JA1

スケジューラーサービス名：AJSROOT2

組み込みDBポート番号：22201

組み込みDBセットアップ識別子：_JA1

ajsembdbbuildコマンドの指定内容

ajsembdbbuild -l
-d "h:¥EmbDB¥RDArea,i:¥EmbDB¥SYSArea1,
j:¥EmbDB¥SYSArea2" -br -bl k:¥EmbDB¥Unload_Log
-i c:¥win32app¥hitachi¥hirdb_e_JA1 -p 22201 -id _JA1

ajsembdbsetupコマンドの指定内容

ajsembdbsetup -F AJSROOT2 -ru l -id _JA1 -p 22201

ajsembdbbuildコマンドおよびajsembdbsetupコマンドの詳細については，「20. セットアップ時に使用するコマンド」を参照してください。

(2)　一つの組み込みDB環境に複数のスケジューラーデータベースを移行する

一つの組み込みDB環境に複数のスケジューラーデータベースを移行する場合，組み込みDB内にはスケジューラーサービスごとに異なるテーブルを作成して管理する必要があります。そのため，ajsembdbsetupコマンド実行時のテーブル名プリフィックスを変更する必要があります。

また，該当する組み込みDBに対して二つ目以降のスケジューラーデータベースを移行する際には，一つ目のスケジューラーデータベースを移行した際にスキーマは作成済みとなっているため，ajsembdbsetupコマンドのスキーマ作成をスキップするオプション（-q）を指定します。

同じ組み込みDBに対して二つ目のスケジューラーデータベースを移行する際のajsembdbsetupコマンドの指定例を次に示します。

スケジューラーサービス名：AJSROOT3

テーブル名プリフィックス：AJS3

組み込みDBセットアップ識別子：_JA0

ajsembdbsetup -F AJSROOT3 -tp AJS3 -q -ru l -id _JA0

ajsembdbsetupコマンドの詳細については，「20. セットアップ時に使用するコマンド　ajsembdbsetup」を参照してください。

注意事項

一つの組み込みDB環境に複数のスケジューラーデータベースを移行した環境で，特定のスケジューラーデータベースだけを再構築することはできません。組み込みDB環境に移行したすべてのスケジューラーデータベースの再構築が必要となります。特定のスケジューラーデータベースだけを再構築したい場合は，スケジューラーサービスごとに組み込みDBを用意してください。構築方法については「(1) スケジューラーサービスごとに異なる組み込みDB環境を構築する」を参照してください。

一つの組み込みDB環境に複数のスケジューラーデータベースを移行した環境で，ajsembdbbackupコマンドを使用してバックアップする場合，特定のスケジューラーデータベースだけを対象にすることはできません。ajsembdbbackupコマンドでのバックアップは，該当する組み込みDB環境に移行したすべてのスケジューラーデータベースをバックアップ対象とし，そのバックアップを使用して回復すると，すべてのスケジューラーデータベースが回復されます。そのため，ajsembdbbackupコマンドおよびajsembdbrstrコマンドでバックアップ・リストアをする場合，該当する組み込みDBにアクセスするすべてのスケジューラーサービスを停止する必要があります。なお，ajsprintコマンドでユニット定義だけをバックアップする場合は，スケジューラーサービスを停止しないで，スケジューラーデータベースごとに取得できます。
また，ajsembdbbackupコマンドで特定のスケジューラーデータベースだけをバックアップ対象としたい場合は，スケジューラーサービスごとに組み込みDBを用意してください。構築方法については「(1) スケジューラーサービスごとに異なる組み込みDB環境を構築する」を参照してください。

5.2.5　組み込みDBの再セットアップ

組み込みDBを再セットアップする場合の，セットアップ手順を次に示します。

ajsprintコマンドで，ジョブネットの定義をバックアップする。
バックアップの方法については，マニュアル「JP1/Automatic Job Management System 2 設計・運用ガイド　11.2.2 JP1/AJS2 - Managerの設定情報のバックアップ」を参照してください。

物理ホストおよびすべての論理ホストで，JP1/AJS2サービス，JP1/AJS2 Monitorサービス，およびJP1/AJS2 Console Agentサービスを含め，スケジューラーデータベースにアクセスするサービスをすべて停止する。

ajsembdbunsetコマンドで，組み込みDB環境のデータを削除する。

組み込みDB運用ディレクトリを変更する場合は，組み込みDBのアンインストール後に，再度インストールする。

ajsembdbbuildコマンドで，組み込みDBを構築する。

ISAM環境で構築する。
マネージャー環境設定で，データベース種別を「ISAM」にし，次のコマンドを実行してISAMファイルでセットアップします。

ajssetup -F スケジューラーサービス名 -mh 論理ホスト名※

注※　物理ホストの場合は「-mh 論理ホスト名」を指定しないでください。

ajsembdbsetupコマンドで，組み込みDBにスケジューラーデータベースを移行する。

JP1/AJS2サービスおよびJP1/AJS2 Monitorサービスを起動する。

手順1でバックアップした，ジョブネット定義を回復する。
マニュアル「JP1/Automatic Job Management System 2 設計・運用ガイド　11.3.3 JP1/AJS2 - Managerの設定情報のリカバリー」を参照してください。

運用に必要なジョブネットの実行登録を実施する。

上記の手順に記載したコマンドの詳細については，「20. セットアップ時に使用するコマンド」を参照してください。

補足事項

一つの組み込みDB環境で，複数のスケジューラーデータベースがセットアップされている場合にajsembdbunsetコマンドを実行すると，すべてのスケジューラーデータベースの情報が削除されます。この場合，この項に示した手順のうち，手順1，6，7，9，10については，組み込みDB環境にセットアップされているすべてのスケジューラーデータベースに対して実施してください。

5.3　クラスタ構成時の実行系組み込みDBのセットアップ

この節では，クラスタ構成時の実行系組み込みDBを使用する場合のインストール，環境構築，および移行方法について説明します。

＜この節の構成＞

5.3.1　組み込みDBのインストール

5.3.2　組み込みDB環境の構築

5.3.3　組み込みDBへの移行

5.3.4　複数スケジューラーデータベースの組み込みDBへの移行

5.3.5　組み込みDBの再セットアップ

5.3.1　組み込みDBのインストール

組み込みDBのインストールは，「5.2.1 組み込みDBのインストール」で記載した手順で実施する必要があります。ただし，クラスタ構成で，実行系の組み込みDBをインストールする場合は，次の注意事項を考慮してインストールしてください。

注意事項

組み込みDBをインストールする際は，実行系のローカルディスクにインストールしてください。また，実行系・待機系とも，同じ名称となるようにドライブおよびフォルダを指定してください。

物理ホストおよび複数の論理ホストを同一マシン内に共存し，異なる組み込みDBを使用する場合は，セットアップ識別子が重複しないように指定してください。

インストールの詳細については，「5.2.1 組み込みDBのインストール」を参照してください。

5.3.2　組み込みDB環境の構築

組み込みDBの環境構築手順について次に示します。

各サービスを停止する。
物理ホストおよびすべての論理ホストで，JP1/AJS2サービス，JP1/AJS2 Monitorサービス，およびJP1/AJS2 Console Agentサービスを含め，スケジューラーデータベースにアクセスするサービスをすべて停止します。

組み込みDB環境構築コマンドを実行する。
ajsembdbbuildコマンドを使用して，組み込みDBの環境を構築します。
ajsembdbbuildコマンドを実行すると，次の処理が実行されます。

組み込みDBの定義情報作成

組み込みDBの領域作成

組み込みDBシステムの起動

ajsembdbbuildコマンドの-dオプションに指定するデータ領域およびシステムファイル領域は，共有ディスク上の領域を指定して，-ldオプションに指定する組み込みDB作業領域は，ローカルディスク上の領域を指定してください。

大規模の組み込みDB環境を構築する場合のajsembdbbuildコマンドの指定例を示します。表5-2および表5-3の項番の組み合わせについても示します。

指定例では次の設定値を設定，またはディレクトリが存在することとします。

データ領域作成ディレクトリ：l:¥EmbDB¥RDArea

システムファイル領域作成ディレクトリ1：m:¥EmbDB¥SYSArea1

システムファイル領域作成ディレクトリ2：n:¥EmbDB¥SYSArea2

アンロードログファイル作成ディレクトリ：o:¥EmbDB¥Unload_Log

組み込みDB作業領域ディレクトリ：p:¥EmbDB¥WorkArea

組み込みDBインストールフォルダ：c:¥win32app¥hitachi¥hirdb_e_JAA

スケジューラーサービス名：AJSROOT4

組み込みDBポート番号：22202

組み込みDBセットアップ識別子：_JAA

実行系物理ホスト名：physical_host

論理ホスト名：logical_host

システムファイルを二重化しないで，システムログを使用した運用をしない場合（表5-2，表5-3の組み合わせが11-A）

ajsembdbbuild -l
-d "l:¥EmbDB¥RDArea,m:¥EmbDB¥SYSArea1"
-ld p:¥EmbDB¥WorkArea
-i c:¥win32app¥hitachi¥hirdb_e_JAA -p 22202
-id _JAA -r -mh logical_host -eh physical_host

システムファイルを二重化しないで，システムログ運用（アンロードレス運用）をする場合（表5-2，表5-3の組み合わせが11-B）

ajsembdbbuild -l
-d "l:¥EmbDB¥RDArea,m:¥EmbDB¥SYSArea1"
-ld p:¥EmbDB¥WorkArea -bs
-i c:¥win32app¥hitachi¥hirdb_e_JAA
-p 22202 -id _JAA -r -mh logical_host -eh physical_host

システムファイルを二重化しないで，アンロードログ運用をする場合（表5-2，表5-3の組み合わせが11-C）

ajsembdbbuild -l
-d "l:¥EmbDB¥RDArea,m:¥EmbDB¥SYSArea1"
-ld p:¥EmbDB¥WorkArea -bs -bl o:¥EmbDB¥Unload_Log
-i c:¥win32app¥hitachi¥hirdb_e_JAA -p 22202 -id _JAA
-r -mh logical_host -eh physical_host

システムファイルを二重化し，システムログ運用（アンロードレス運用）をする場合（表5-2，表5-3の組み合わせが12-B）

ajsembdbbuild -l
-d "l:¥EmbDB¥RDArea,m:¥EmbDB¥SYSArea1,n:¥EmbDB¥SYSArea2"
-ld p:¥EmbDB¥WorkArea -br
-i c:¥win32app¥hitachi¥hirdb_e_JAA -p 22202 -id _JAA
-r -mh logical_host -eh physical_host

システムファイルを二重化し，アンロードログ運用をする場合（表5-2，表5-3の組み合わせが12-C）

ajsembdbbuild -l
-d "l:¥EmbDB¥RDArea,m:¥EmbDB¥SYSArea1,n:¥EmbDB¥SYSArea2"
-ld p:¥EmbDB¥WorkArea -br -bl o:¥EmbDB¥Unload_Log
-i c:¥win32app¥hitachi¥hirdb_e_JAA -p 22202 -id _JAA
-r -mh logical_host -eh physical_host

ajsembdbbuildコマンドの詳細については，「20. セットアップ時に使用するコマンド　ajsembdbbuild」を参照してください。

補足事項

システムファイルを二重化し，システムログを使用した運用をしない（表5-2，表5-3の組み合わせが8-A，10-A，12-Aとなる）場合の環境は構築できません。

注意事項

組み込みDB環境を構築するホストは，実行系の物理ホスト名および論理ホスト名共にhostsファイルまたはDNSに登録してください。

組み込みDB環境を構築するホストのホスト名をjp1hosts定義ファイルに登録しても，組み込みDBで使用するホスト名として有効になりません。

組み込みDB環境を構築するホストのホスト名には，エイリアス名を使用しないでください。

組み込みDBが稼働できるホストのホスト名は，最大32バイトです。したがって，組み込みDB環境を構築するホストは，実行系の物理ホスト名および論理ホスト名共に1～32バイトで設定してください。

5.3.3　組み込みDBへの移行

ajsembdbsetupコマンドを使用して，ISAMで作成されているスケジューラーデータベースの内容を組み込みDBに移行します。ただし，移行作業を開始する前に，論理ホスト環境でスケジューラーサービスの設定およびスケジューラーデータベースがISAMで作成済みである必要があります。これらの設定が完了していることを確認してから，ajsembdbsetupコマンドを実行してください。

ajsembdbsetupコマンドを実行することで次の処理が実行されます。

組み込みDBのデータベース情報の設定（スキーマ，テーブル）

組み込みDBへのスケジューラーデータベース情報の格納

JP1/AJS2環境設定パラメーターの設定

ISAMファイルの退避

大規模の組み込みDB環境で実行するajsembdbsetupコマンドの指定例を次に示します。なお，次の設定値を仮定します。

スケジューラーサービス名：AJSROOT4

組み込みDBセットアップ識別子：_JAA

論理ホスト名：logical_host

ajsembdbsetup -F AJSROOT4 -ru l -id _JAA -mh logical_host

補足事項

ajsembdbsetupコマンドを実行することで次の環境設定パラメーターが設定されます。これらの環境設定パラメーターについては設定値を変更しないでください。また，それぞれの環境設定パラメーターの詳細については，「14.1.3 スケジューラーサービス環境設定パラメーターの定義内容」を参照してください。

表5-7　ajsembdbsetupコマンド実行時に設定される環境設定パラメーター

環境設定パラメーター
定義内容
ajsembdbsetupコマンドで
設定する内容※

AJSDBTYPE
データベース種別
EmbedDB

TABLENAMEPREFIX
テーブル名プリフィックス
次のどちらかが設定される。

-tpオプション指定値

AJS

TABLENAMEPOSTFIX
テーブルID
－

RDBAUTHID
RDB認可識別子
root

RDBUSER
RDBアクセスユーザー名
ajs2

RDBPASSWORD
RDBユーザーパスワード
－

RDBHOST
RDB接続先ホスト名
次のどちらかが設定される。

-mhオプション指定値

環境変数JP1_HOSTNAMEの設定値

RDBPORT
RDB接続ポート番号
次のどちらかが設定される。

-pオプション指定値

22200

RDBIPC
RDBサーバとの通信方式
MEMORY

RDBSENDMEMSIZE
RDBプロセス間メモリー通信使用時の送信用メモリーサイズ
次のどちらかが設定される。

-sオプション指定値

100

RDBRECVMEMSIZE
RDBプロセス間メモリー通信使用時の受信用メモリーサイズ
次のどちらかが設定される。

-rオプション指定値

100

注※

設定内容が数値の場合は，10進数で表記しています。

5.3.4　複数スケジューラーデータベースの組み込みDBへの移行

この節では，複数のスケジューラーデータベースを組み込みDBへ移行する方法について説明します。

＜この項の構成＞

(1)　スケジューラーサービスごとに異なる組み込みDB環境を構築する

(2)　一つの組み込みDB環境に複数のスケジューラーデータベースを移行する

(1)　スケジューラーサービスごとに異なる組み込みDB環境を構築する

複数のスケジューラーサービスが定義されていて，スケジューラーサービスごとに異なる組み込みDB環境を構築する場合，次に示す領域を別に準備してください。

組み込みDB運用ディレクトリ

データ領域

システムファイル領域

組み込みDB作業領域

アンロードログファイル作成ディレクトリ

上記に示す領域のうち，システムファイル領域，アンロードログファイル作成ディレクトリについては，必要に応じて準備してください。また，データ領域およびシステムファイル領域は，共有ディスク上の領域を指定してください。

組み込みDB環境構築の際，使用するポート番号および組み込みDBセットアップ識別子が組み込みDB間で重複しないように指定する必要があります。そのため，ajsembdbbuildコマンドおよびajsembdbsetupコマンドの実行時には，ポート番号を指定するオプション（-p）および組み込みDBセットアップ識別子を指定するオプション（-id）に異なる値を指定してください。

セットアップ例を次に示します。なお，この例は，「5.3.2 組み込みDB環境の構築」で示した環境がすでに構築されていることを前提に記載します。

組み込みDBの環境内容

追加する組み込みDBの環境内容を次に示します。

データ領域作成ディレクトリ：q:¥EmbDB¥RDArea

システムファイル領域作成ディレクトリ1：r:¥EmbDB¥SYSArea1

システムファイル領域作成ディレクトリ2：s:¥EmbDB¥SYSArea2

アンロードログファイル作成ディレクトリ：t:¥EmbDB¥Unload_Log

組み込みDB作業領域：u:¥ EmbDB¥WorkArea

組み込みDBインストールフォルダ：c:¥win32app¥hitachi¥hirdb_e_JAB

スケジューラーサービス名：AJSROOT5

組み込みDBポート番号：22203

組み込みDBセットアップ識別子：_JAB

実行系物理ホスト名：physical_host

論理ホスト名：logical_host

ajsembdbbuildコマンドの指定内容

ajsembdbbuildコマンドの指定内容を次に示します。

ajsembdbbuild -l
-d "q:¥EmbDB¥RDArea,r:¥EmbDB¥SYSArea1,s:¥EmbDB¥SYSArea2"
-ld u:¥ EmbDB¥WorkArea -br -bl t:¥EmbDB¥Unload_Log
-i c:¥win32app¥hitachi¥hirdb_e_JAB
-p 22203 -id _JAB -r -mh logical_host -eh physical_host

ajsembdbsetupコマンドの指定内容

ajsembdbsetupコマンドの指定内容を次に示します。

ajsembdbsetup -F AJSROOT5 -ru l -id _JAB -p 22203 -mh logical_host

ajsembdbbuildコマンドおよびajsembdbsetupコマンドの詳細については，「20. セットアップ時に使用するコマンド」を参照してください。

(2)　一つの組み込みDB環境に複数のスケジューラーデータベースを移行する

一つの組み込みDB環境に複数のスケジューラーデータベースを移行する場合，組み込みDB内にはスケジューラーサービスごとに異なるテーブルを作成して管理する必要があります。そのため，ajsembdbsetupコマンド実行時のテーブル名プリフィックスを変更する必要があります。

また，該当する組み込みDBに対して二つ目以降のスケジューラーデータベースを移行する際には，一つ目のスケジューラーデータベースを移行した際にスキーマが作成済みとなっているため，ajsembdbsetupコマンドのスキーマ作成をスキップするオプション（-q）を指定します。

同じ組み込みDBに対して二つ目のスケジューラーデータベースを移行する際のajsembdbsetupコマンドの指定例を次に示します。なお，次の設定値を仮定します。

スケジューラーサービス名：AJSROOT6

テーブル名プリフィックス：AJS2

組み込みDBセットアップ識別子：_JAA

論理ホスト名：logical_host

ajsembdbsetup -F AJSROOT6 -tp AJS2 -q -ru l -id _JAA -mh logical_host

ajsembdbsetupコマンドの詳細については，「20. セットアップ時に使用するコマンド　ajsembdbsetup」を参照してください。

注意事項

一つの組み込みDB環境に複数のスケジューラーデータベースを移行した環境で，特定のスケジューラーデータベースだけを再構築することはできません。組み込みDB環境に移行したすべてのスケジューラーデータベースの再構築が必要となります。特定のスケジューラーデータベースだけを再構築したい場合は，スケジューラーサービスごとに組み込みDBを用意してください。構築方法については「(1) スケジューラーサービスごとに異なる組み込みDB環境を構築する」を参照してください。

一つの組み込みDB環境に複数のスケジューラーデータベースを移行した環境で，ajsembdbbackupコマンドを使用してバックアップする場合，特定のスケジューラーデータベースだけを対象にはできません。ajsembdbbackupコマンドでのバックアップは，該当する組み込みDB環境に移行したすべてのスケジューラーデータベースをバックアップ対象とし，そのバックアップを使用して回復すると，すべてのスケジューラーデータベースを回復します。そのため，ajsembdbbackupコマンドおよびajsembdbrstrコマンドでバックアップ・リストアをする場合，該当する組み込みDBにアクセスするすべてのスケジューラーサービスを停止する必要があります。
なお，ajsprintコマンドでユニット定義だけをバックアップする場合は，スケジューラーサービスを停止しないで，スケジューラーデータベースごとに取得できます。
ajsembdbbackupコマンドで特定のスケジューラーデータベースだけをバックアップ対象としたい場合は，スケジューラーサービスごとに組み込みDBを用意してください。構築方法については「(1) スケジューラーサービスごとに異なる組み込みDB環境を構築する」を参照してください。

一つの組み込みDB環境に論理ホストのスケジューラーデータベース，および物理ホストのスケジューラーデータベースを混在して移行できません。

5.3.5　組み込みDBの再セットアップ

組み込みDBの再セットアップについては，「5.2.5 組み込みDBの再セットアップ」を参照してください。

5.4　クラスタ構成時の待機系組み込みDBのセットアップ

この節では，クラスタ構成時に待機系組み込みDBを使用する場合のインストール，環境構築，および移行方法について説明します。

＜この節の構成＞

5.4.1　組み込みDBのインストール

5.4.2　組み込みDB環境の構築

5.4.3　組み込みDBへの移行

5.4.4　複数スケジューラーデータベースの組み込みDBへの移行

5.4.5　組み込みDBの再セットアップ

5.4.1　組み込みDBのインストール

組み込みDBのインストールは，「5.2.1 組み込みDBのインストール」で記載した手順で実施する必要があります。ただし，クラスタ構成で，待機系に組み込みDBをインストールする場合は，次の注意事項を考慮してインストールしてください。

注意事項

組み込みDBをインストールする際は，待機系のローカルディスクにインストールしてください。また，実行系・待機系とも，同じ名称となるようにドライブおよびフォルダを指定してください。

物理ホストおよび複数の論理ホストを同一マシン内に共存し，異なる組み込みDBを使用する場合は，セットアップ識別子が重複しないように指定してください。

インストールの詳細については，「5.2.1 組み込みDBのインストール」を参照してください。

5.4.2　組み込みDB環境の構築

組み込みDBの環境構築手順について次に示します。

各サービスを停止する。
物理ホストおよびすべての論理ホストで，JP1/AJS2サービス，JP1/AJS2 Monitorサービス，およびJP1/AJS2 Console Agentサービスを含め，スケジューラーデータベースにアクセスするサービスをすべて停止します。

組み込みDB環境構築コマンドを実行する。
ajsembdbbuildコマンドを使用して，組み込みDBの環境を構築します。
ajsembdbbuildコマンドを実行すると，次の処理が実行されます。

組み込みDBの定義情報作成

組み込みDB作業領域の作成

待機系でajsembdbbuildコマンドを実行する場合は，-rオプションではなく，-fオプションを指定してください。その他の引数については，実行系で指定した内容と同じ内容を指定してください。

大規模の組み込みDB環境を構築する場合のajsembdbbuildコマンドの指定例を示します。表5-2および表5-3の項番の組み合わせについても示します。

指定例では次に示す設定値が設定，およびディレクトリが存在することと仮定します。

データ領域作成ディレクトリ：l:¥EmbDB¥RDArea

システムファイル領域作成ディレクトリ1：m:¥EmbDB¥SYSArea1

システムファイル領域作成ディレクトリ2：n:¥EmbDB¥SYSArea2

アンロードログファイル作成ディレクトリ：o:¥EmbDB¥Unload_Log

組み込みDB作業領域ディレクトリ：p:¥ EmbDB¥WorkArea

組み込みDBインストールフォルダ：c:¥win32app¥hitachi¥hirdb_e_JAA

スケジューラーサービス名：AJSROOT4

組み込みDBポート番号：22202

組み込みDBセットアップ識別子：_JAA

実行系物理ホスト名※：physical_host

論理ホスト名：logical_host

注※

待機系の組み込みDBの環境構築についても，実行系の物理ホスト名をajsembdbbuildコマンドの-ehオプションに指定する必要があります。

システムファイルを二重化しないで，システムログを使用した運用をしない場合（表5-2，表5-3の組み合わせが11-A）

ajsembdbbuild -l
-d "l:¥EmbDB¥RDArea,m:¥EmbDB¥SYSArea1"
-ld p:¥ EmbDB¥WorkArea -i c:¥win32app¥hitachi¥hirdb_e_JAA
-p 22202 -id _JAA -f -mh logical_host -eh physical_host

システムファイルを二重化しないで，システムログ運用（アンロードレス運用）をする場合（表5-2，表5-3の組み合わせが11-B）

ajsembdbbuild -l
-d "l:¥EmbDB¥RDArea,m:¥EmbDB¥SYSArea1"
-ld p:¥ EmbDB¥WorkArea -bs -i c:¥win32app¥hitachi¥hirdb_e_JAA
-p 22202 -id _JAA -f -mh logical_host -eh physical_host

システムファイルを二重化しないで，アンロードログ運用をする場合（表5-2，表5-3の組み合わせが11-C）

ajsembdbbuild -l
-d "l:¥EmbDB¥RDArea,m:¥EmbDB¥SYSArea1"
-ld p:¥ EmbDB¥WorkArea -bs -bl o:¥EmbDB¥Unload_Log
-i c:¥win32app¥hitachi¥hirdb_e_JAA -p 22202 -id _JAA
-f -mh logical_host -eh physical_host

システムファイルを二重化し，システムログ運用（アンロードレス運用）をする場合（表5-2，表5-3の組み合わせが12-B）

ajsembdbbuild -l
-d "l:¥EmbDB¥RDArea,m:¥EmbDB¥SYSArea1,
n:¥EmbDB¥SYSArea2" -ld p:¥ EmbDB¥WorkArea
-br -i c:¥win32app¥hitachi¥hirdb_e_JAA -p 22202 -id _JAA
-f -mh logical_host -eh physical_host

システムファイルを二重化し，アンロードログ運用をする場合（表5-2，表5-3の組み合わせが12-C）

ajsembdbbuild -l
-d "l:¥EmbDB¥RDArea,m:¥EmbDB¥SYSArea1,
n:¥EmbDB¥SYSArea2" -ld p:¥ EmbDB¥WorkArea -br
-bl o:¥EmbDB¥Unload_Log -i c:¥win32app¥hitachi¥hirdb_e_JAA
-p 22202 -id _JAA -f -mh logical_host -eh physical_host

ajsembdbbuildコマンドの詳細については，「20. セットアップ時に使用するコマンド　ajsembdbbuild」を参照してください。

補足事項

システムファイルの二重化をして，システムログを使用した運用をしない（表5-2，表5-3の組み合わせが8-A，10-A，12-Aとなる）場合，環境は構築できません。

注意事項

組み込みDB環境を構築するホストは，実行系の物理ホスト名および論理ホスト名共にhostsファイルまたはDNSに登録してください。

組み込みDB環境を構築するホストのホスト名をjp1hosts定義ファイルに登録しても，組み込みDBで使用するホスト名として有効になりません。

組み込みDB環境を構築するホストのホスト名には，エイリアス名を使用しないでください。

組み込みDBが稼働できるホストのホスト名は，最大32バイトです。したがって，組み込みDB環境を構築するホストは，実行系の物理ホスト名および論理ホスト名共に1～32バイトで設定してください。

5.4.3　組み込みDBへの移行

待機系での作業は実行系での移行作業とは異なり，ajsembdbsetupコマンドを実行する必要はありませんが，実行系と待機系で共通定義情報の設定内容を合わせる必要があります。

共通定義情報の設定手順を次に示します。

実行系で組み込みDBのセットアップを実施する。

手順1の作業完了後，実行系でjbsgetcnfコマンドを実行して共通定義情報をファイルに退避する。
実行するコマンドを次に示します。

jbsgetcnf -h 論理ホスト名 > 退避ファイル名

手順2で作成したファイルを待機系にコピーする。

手順3の作業完了後，待機系でjbssetcnfコマンドを実行して共通定義情報を設定する。
実行するコマンドを次に示します。

jbssetcnf 退避ファイル名

以上で待機系での移行作業は完了です。

実行系でのセットアップについては，「5.3.3 組み込みDBへの移行」または「5.3.4 複数スケジューラーデータベースの組み込みDBへの移行」を参照してください。

jbsgetcnfコマンドおよびjbssetcnfコマンドについては，マニュアル「JP1/Base 運用ガイド」を参照してください。

5.4.4　複数スケジューラーデータベースの組み込みDBへの移行

ここでは，複数のスケジューラーデータベースを組み込みDBへ移行する方法について説明します。

＜この項の構成＞

(1)　スケジューラーサービスごとに異なる組み込みDB環境を構築する

(2)　一つの組み込みDB環境に複数のスケジューラーデータベースを移行する

(1)　スケジューラーサービスごとに異なる組み込みDB環境を構築する

複数のスケジューラーサービスが定義されていて，スケジューラーサービスごとに異なる組み込みDB環境を構築する場合，次に示す領域を別に準備してください。

組み込みDB運用ディレクトリ

組み込みDB作業領域

アンロードログファイル作成ディレクトリ

上記の領域のうち，アンロードログファイル作成ディレクトリについては，必要に応じて準備してください。

待機系の環境構築時は，データ領域およびシステムファイル領域は作成しません。データ領域およびシステムファイル領域は，実行系の環境構築時，共有ディスク上に作成します。

組み込みDB環境構築の際，使用するポート番号および組み込みDBセットアップ識別子が組み込みDB間で重複しないように指定する必要があります。そのため，ajsembdbbuildコマンド実行時には，ポート番号を指定するオプション（-p）および組み込みDBセットアップ識別子を指定するオプション（-id）に，異なる値を指定してください。

セットアップ例を次に示します。なお，この例は「5.4.2 組み込みDB環境の構築」で示した環境がすでに構築されていることを前提に記載します。

組み込みDBの環境内容

追加する組み込みDBの環境内容を次に示します。

データ領域作成ディレクトリ：q:¥EmbDB¥RDArea

システムファイル領域作成ディレクトリ1：r:¥EmbDB¥SYSArea1

システムファイル領域作成ディレクトリ2：s:¥EmbDB¥SYSArea2

アンロードログファイル作成ディレクトリ：t:¥EmbDB¥Unload_Log

組み込みDB作業領域：u:¥ EmbDB¥WorkArea

組み込みDBインストールフォルダ：c:¥win32app¥hitachi¥hirdb_e_JAB

スケジューラーサービス名：AJSROOT5

組み込みDBポート番号：22203

組み込みDBセットアップ識別子：_JAB

実行系物理ホスト名：physical_host

論理ホスト名：logical_host

ajsembdbbuildコマンドの指定内容

ajsembdbbuildコマンドの指定内容を次に示します。

ajsembdbbuild -l
-d "q:¥EmbDB¥RDArea,r:¥EmbDB¥SYSArea1,s:¥EmbDB¥SYSArea2"
-ld u:¥ EmbDB¥WorkArea -br -bl t:¥EmbDB¥Unload_Log
-i c:¥win32app¥hitachi¥hirdb_e_JAB -p 22203
-id _JAB -f -mh logical_host -eh physical_host

組み込みDBへの移行方法

組み込みDBへの移行方法については，「5.4.3 組み込みDBへの移行」で示した指定例を参照してください。

ajsembdbbuildコマンドおよびajsembdbsetupコマンドの詳細については，「20. セットアップ時に使用するコマンド」を参照してください。

(2)　一つの組み込みDB環境に複数のスケジューラーデータベースを移行する

「5.4.3 組み込みDBへの移行」を参照してください。

5.4.5　組み込みDBの再セットアップ

組み込みDBを再セットアップする場合の，セットアップ手順を次に示します。

ajsembdbunsetコマンドで，組み込みDB環境のデータを削除する。

組み込みDB運用ディレクトリを変更する場合は，組み込みDBのアンインストール後に，再度インストールする。

ajsembdbbuildコマンドで，組み込みDBを構築する。

実行系の共通定義情報を待機系に設定する。
実行系でのセットアップ完了後，実行系でjbsgetcnfコマンドを実行し，共通定義情報をファイルに退避します。
その退避したファイルを待機系にコピーし，jbssetcnfコマンドに指定して実行します。実行するコマンドを次に示します。

実行系で実行するコマンド
jbsgetcnf -h 論理ホスト名 > 退避ファイル名

待機系で実行するコマンド
jbssetcnf 退避ファイル名

ajsembdbunsetコマンドおよびajsembdbbuildコマンドの詳細については，「20. セットアップ時に使用するコマンド」を参照してください。また，jbsgetcnfコマンドおよびjbssetcnfコマンドについては，マニュアル「JP1/Base 運用ガイド」を参照してください。

5.5　クラスタ構成時の組み込みDBの設定変更

クラスタに関するシステム定義のうち，変更できる定義について説明します。

この節で説明するシステム定義は，システム共通定義ファイルに設定する定義です。システム共通定義ファイルとは，次に示すファイルのことです。

組み込みDB運用ディレクトリ¥conf¥pdsys

システム共通定義ファイルは，ajsembdbbuildコマンドを実行することで作成されます。そのため，システム共通定義ファイルは，ajsembdbbuildコマンドの実行後に編集してください。

クラスタに関するシステム定義のうち，変更できる定義を次に示します。

pd_mode_conf = 組み込みDBの開始方法
pd_mode_confの設定値を次に示します。

MANUAL1
組み込みDBを手動開始します。ただし，組み込みDBが異常終了した場合に限り，組み込みDBの再開始は自動開始になります。

MANUAL2
組み込みDBを手動開始します。MANUAL1とは異なり，自動開始することはありません。

AUTO
組み込みDBを自動開始します。OSを起動すると，自動的に組み込みDBを開始します。また，組み込みDB異常終了後の再開始についても自動開始します。

ajsembdbbuildコマンド実行時に，-rオプションまたは-fオプションを指定して環境構築した場合の，pd_mode_confの初期値はMANUAL1です。

クラスタ構成時は，MANUAL1またはMANUAL2を設定してください。構築する環境に応じて設定値を変更してください。

システム共通定義ファイルの編集は，次の手順で行ってください。

実行系

組み込みDBを使用しているスケジューラーサービスを停止する。

組み込みDBを停止する。

システム共通定義ファイルを編集する。

組み込みDBを起動する。

組み込みDBを使用しているスケジューラーサービスを起動する。

待機系
実行系での作業後，次のどちらかの方法でシステム共通定義ファイルを変更してください。

実行系で編集したシステム共通定義ファイルを，待機系の環境にコピーする。

実行系の手順3と同じ内容で編集する。

5.6　組み込みDBのクラスタソフトへの登録

JP1/AJS2の同一論理ホスト（同一グループ）に，組み込みDBの「HiRDB/ClusterService _JAn※」を設定してください。

「HiRDB/ClusterService _JAn」を起動する前に，組み込みDBが停止されていることを確認してください。組み込みDBが起動している場合は，ajsembdbstopコマンドで停止したあとに，「HiRDB/ClusterService _JAn」を起動してください。

また，JP1/AJS2を起動する前に「HiRDB/ClusterService _JAn」を起動させる必要があります。

クラスタソフトへの登録については，各クラスタソフトのマニュアルを参照してください。

注※

組み込みDBセットアップ識別子

6.　JP1/AJS2 - Viewの環境設定

この章では，JP1/AJS2 - Viewの環境設定を変更する手順について説明します。

＜この章の構成＞

6.1　JP1/AJS2 - Viewの環境設定を変更する手順

6.2　JP1/AJS2 Console Viewの環境設定を変更する手順

6.1　JP1/AJS2 - Viewの環境設定を変更する手順

JP1/AJS2 - Viewの環境設定を変更する手順を次に示します。

なお，JP1/AJS2 - Viewの環境設定で設定する内容については，マニュアル「JP1/Automatic Job Management System 2 操作ガイド　10. JP1/AJS2 - Viewで使用するウィンドウおよびダイアログボックスのカスタマイズ」を，表示されるダイアログボックスで設定できる内容については，マニュアル「JP1/Automatic Job Management System 2 操作ガイド　13. ウィンドウとダイアログボックス」を参照してください。

Windowsの［スタート］メニューから［プログラム］－［JP1_Automatic Job Management System 2 - View］－［ジョブシステム運用］を選択する。
［ログイン］画面が表示されます。

JP1ユーザー名，パスワードおよび接続先JP1/AJS2 - Managerのホスト名を入力し，［OK］ボタンをクリックする。
JP1/AJS2 - Viewの［JP1/AJS2 - View］ウィンドウが表示されます。

［オプション］－［環境設定］を選択する。
［環境設定］ダイアログボックスが表示されます。

必要な情報を定義し，［OK］ボタンをクリックする。
JP1/AJS2 - Viewを使用中でも，JP1/AJS2 - Viewの環境設定を変更できます。
設定が有効になるタイミングについては，マニュアル「JP1/Automatic Job Management System 2 操作ガイド　13.3.27 ［環境設定］ダイアログボックス」を参照してください。

6.2　JP1/AJS2 Console Viewの環境設定を変更する手順

JP1/AJS2 Console Viewの環境設定を変更する手順を次に示します。

なお，JP1/AJS2 Console Viewの環境設定で設定する内容については，マニュアル「JP1/Automatic Job Management System 2 操作ガイド　12. JP1/AJS2 Console画面のカスタマイズ」を，表示されるダイアログボックスで設定できる内容については，マニュアル「JP1/Automatic Job Management System 2 操作ガイド　14. JP1/AJS2 Consoleの画面」を参照してください。

Windowsの［スタート］メニューから［プログラム］－［JP1_Automatic Job Management System 2 - View］－［業務監視］を選択する。
［ログイン］画面が表示されます。

JP1ユーザー名，パスワードおよび接続先JP1/AJS2 Console Managerのホスト名を入力し，［OK］ボタンをクリックする。
JP1/AJS2 Console Viewの［メインスコープ］ウィンドウが表示されます。

［オプション］－［環境設定］を選択する。
［環境設定］ダイアログボックスが表示されます。

必要な情報を定義し，［OK］ボタンをクリックする。
JP1/AJS2 Console Viewを使用中でも，JP1/AJS2 Console Viewの環境設定を変更できます。
設定が有効になるタイミングについては，マニュアル「JP1/Automatic Job Management System 2 操作ガイド　14.3.10 ［環境設定］ダイアログボックス」を参照してください。

7.　運用形態に合わせた各種設定

この章では，JP1/AJS2の運用形態に合わせた設定について説明します。

＜この章の構成＞

7.1　ジョブ実行時のワークパスを変数として定義する

7.2　ジョブをロングファイル名で実行するための設定

7.3　転送元ファイルの検索パスを定義する

7.4　JP1ユーザー仮定機能の設定

7.5　エージェント自動定義機能で作成されるキュー属性値をカスタマイズする設定

7.6　ユーザープロファイルを必要とするジョブを実行するための設定

7.7　ジョブ情報削除処理に関する設定

7.8　イベントジョブのログサイズの設定の変更

7.9　イベント順序保証オプションの設定

7.10　キューレスジョブ環境でユーザープロファイルを必要とするジョブを実行するための設定

7.11　ジョブの標準出力と標準エラー出力を同時に確認する設定

7.12　ファイル監視ジョブの状態引き継ぎオプションの設定

7.13　「"（ダブルクォーテーションマーク）」を含むデータをイベントジョブの引き継ぎ情報に使用するための設定

7.14　イベントジョブを使用したDNS運用時にFQDN形式で運用するための設定

7.15　キューレスジョブ環境でクラスを指定したジョブを実行するための設定

7.16　ファイル受信制限をするための設定

7.17　ジョブの結果ファイルの再送間隔・再送回数の変更

7.18　ジョブ結果ファイルの二重受信防止の設定

7.19　TCP/IP通信接続エラーのリトライ間隔・回数の変更

7.20　ジョブを配信するエージェントホストの決定方式の設定

7.21　マクロ変数の展開失敗時の動作の設定

7.22　マクロ変数の引き継ぎ情報がNULL文字列の場合の置き換え方法の設定

7.23　ファイルおよびフォルダの変更方法

7.24　エージェントの障害回復待ち時間を短縮する設定方法

7.25　新規インストール後に以前のバージョンの設定に戻す方法

7.26　ジョブ実行時にアクセストークンを再利用するための設定

7.27　ジョブ実行多重度到達を確認するメッセージを出力する設定

7.28　WOW64環境でジョブを実行する際にファイルシステムリダイレクトを無効にする設定

7.29　キューレスジョブが戻り値128で異常検出終了となる問題を回避するための設定

7.30　サブミットジョブの実行順序の入れ替わりを防止する設定

7.31　ジョブ情報列挙時にジョブ実行制御マネージャー（jpqman）のメモリー消費量を少なくする設定

7.32　ジョブ実行制御のマネージャープロセスに対する通信タイムアウト時間の変更

7.33　JP1/AJS2のサービスが停止してもイベントジョブの実行を継続させる設定

7.34　サービスの依存関係の解除・再設定

7.35　イベント・アクション制御エージェント起動通知の送信に失敗した場合に再送を行う設定

7.36　拡張子が4バイト以上の実行ファイルのジョブを実行するための設定

7.37　エージェントホスト名の名前解決オプションの設定

7.38　イベント・アクション制御のプロセス間通信でのデータ到着待ちタイムアウト化オプションの設定

7.39　ジョブ実行時のログオンリトライを変更する設定

7.40　イベントジョブを実行する場合のマネージャーホスト名を固定化する設定

7.41　システム環境変数とジョブ定義の環境変数が重複した場合にジョブ定義の環境変数を有効にするための設定

7.1　ジョブ実行時のワークパスを変数として定義する

PCジョブ，UNIXジョブ，およびQUEUEジョブのジョブの詳細定義では，次の項目のワークパスを変数で定義できます。この変数はエージェントホストごとに異なる値を定義できるため，エージェントホストごとに異なるワークパスでジョブが実行できます。

表7-1　ジョブ定義の変数指定可能項目一覧

ジョブ定義時の指定項目 | 使用可否
コマンド文（UNIX限定） | ○
実行ファイル名（Windows限定） | ○
スクリプトファイル名（UNIX限定）※ | ○
パラメーター | ○
環境変数 | ×
環境変数ファイル名 | ×
ワークパス | ×
標準入力ファイル名 | ○
標準出力ファイル名 | ○
標準エラー出力ファイル名 | ○
転送元ファイル名 | ×
転送先ファイル名 | ×

（凡例）

○：指定できる。

×：指定できない。

注※

スクリプトファイルの中身は対象外。

ジョブ実行時のワークパスを変数として定義する手順を次に示します。

＜この節の構成＞

(1)　定義手順

(2)　定義パラメーター一覧

(3)　定義内容

(4)　定義例

(5)　注意事項

(1)　定義手順

Windowsの［コントロールパネル］の［管理ツール］で［サービス］を選択し，次に示すサービスを停止する。

ジョブの実行先サービスに［JP1/AJS2］を指定している場合

JP1/AJS2サービス

ジョブの実行先サービスに［JP1/AJS2 Queueless Agent］を指定している場合

JP1/AJS2 Queueless Agentサービス

メモ帳などのテキストエディターで，「(2) 定義パラメーター一覧」の定義パラメーターを記述した設定ファイルを作成する。
設定ファイルのファイル名は任意です。

ファイルを保存し，次のコマンドを実行する。

jbssetcnf 設定ファイル名

jbssetcnfコマンドのパスは，「JP1/Baseのインストール先フォルダ¥bin¥jbssetcnf」です。
jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

手順1で停止したサービスを再起動する。
設定ファイルに記述した内容が反映されます。

(2)　定義パラメーター一覧

表7-2　ジョブ実行時のワークパス変数定義パラメーター一覧

定義キー | 環境設定パラメーター | 定義内容
[{JP1_DEFAULT|論理ホスト名}¥JP1NBQAGENT¥Variable]※ | "変数名"= | 変数名に対応したワークパス

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

(3)　定義内容

"変数名"="値"

変数名

「$変数名$」で指定する文字列を入力します。なお，ここで定義した変数名は，ファイルパス名やパラメーターで使用できます。

値

変数名に対応した実行プログラムの，そのホストでのインストールパスを入力します。

注意事項

環境設定パラメーターを誤って設定した場合は，「付録E 誤った環境設定パラメーターを設定したときの回復方法」を参照し，手順に従って回復してください。

(4)　定義例

「prog1.exe」という名称のジョブプログラムのインストールディレクトリがホストごとに異なっていて，Agent1ホストでは「c:¥pp1¥bin」に，Agent2ホストでは「d:¥pp1¥bin」に，それぞれインストールされているとします。その場合，次のように定義します。

ジョブの定義

ファイル名=$pp1_inst$¥prog1.exe

Agent1ホストでの設定

[{JP1_DEFAULT|論理ホスト名}¥JP1NBQAGENT¥Variable]
"pp1_inst"="c:¥pp1¥bin"

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

Agent2ホストでの設定

[{JP1_DEFAULT|論理ホスト名}¥JP1NBQAGENT¥Variable]
"pp1_inst"="d:¥pp1¥bin"

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

この定義によって，Agent1ホストでは「c:¥pp1¥bin¥prog1.exe」が実行され，Agent2ホストでは「d:¥pp1¥bin¥prog1.exe」が実行されます。

(5)　注意事項

「JP1」から始まる文字列はシステムで使用するため，指定しないでください。

7.2　ジョブをロングファイル名で実行するための設定

ジョブ※1の実行ファイルの名称は，通常，NTFS（NT File System）およびFAT（File Allocation Table）ボリューム上のファイル用に生成されたショートファイル名に変換されます。ジョブの実行ファイルをショートファイル名に変換しないでロングファイル名で実行したい場合は，次に示す手順でオプションを有効にしてください。

なお，キューレスジョブの場合は，ショートファイル名に変換しないでロングファイル名のまま実行されます。※2

注※1

ジョブはPCジョブ，JP1/AJS2上で実行するQUEUEジョブが該当します。また，jpqjobsubコマンドで実行するサブミットジョブも含まれます。

注※2

キューレスジョブの場合，条件によってはショートファイル名で実行されることがあります。詳細については，「(5) 注意事項」参照してください。

＜この節の構成＞

(1)　定義手順

(2)　定義パラメーター一覧

(3)　定義内容

(4)　実行ファイル名の指定方法

(5)　注意事項

(1)　定義手順

Windowsの［コントロールパネル］の［管理ツール］で［サービス］を選択し，次に示すサービスを停止する。

JP1/AJS2サービス

JP1/AJS2 Monitorサービス

メモ帳などのテキストエディターで，「(2) 定義パラメーター一覧」の定義パラメーターを記述した設定ファイルを作成する。
設定ファイルのファイル名は任意です。

ファイルを保存し，次のコマンドを実行する。

jbssetcnf 設定ファイル名

jbssetcnfコマンドのパスは，「JP1/Baseのインストール先フォルダ¥bin¥jbssetcnf」です。
jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/AJS2を再起動する。
設定ファイルに記述した内容が反映されます。

(2)　定義パラメーター一覧

表7-3　ジョブをロングファイル名で実行するための定義パラメーター

定義キー | 環境設定パラメーター | 定義内容
[{JP1_DEFAULT|論理ホスト名}¥JP1NBQAGENT¥Job]※ | "IsExecFindExecutable"= | ジョブをロングファイル名で実行するための定義

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

(3)　定義内容

"IsExecFindExecutable"=dword:設定値

実行ファイルをショートファイル名に変換するかどうかを指定します。

0

変換してショートファイル名で実行したい場合。

1

変換しないでロングファイル名で実行したい場合。

デフォルトは「0」です。

(4)　実行ファイル名の指定方法

拡張子が「.exe」，「.bat」，「.cmd」，「.com」または「.pif」である実行ファイルの名称は，A～Zのドライブ名付きの絶対パスで指定してください。

実行ファイルの名称に空白文字が含まれる場合は，名称全体（ドライブ名から拡張子まで）を「"（ダブルクォーテーションマーク）」で囲んでください。
なお，jpqjobsubコマンドを使用するときは名称全体を「"」および「¥"」で囲んでください。実行ファイル名が「C:¥Program Files¥test.exe」の場合のjpqjobsubコマンドの指定例を次に示します。

　jpqjobsub -ah 論理ホスト名 -sc "¥"C:¥Program Files¥test.exe¥""

実行ファイル名に続けて，実行ファイルに対する引数を指定することはできません。

(5)　注意事項

次の条件が重なるジョブを実行した場合は，環境設定パラメーターIsExecFindExecutableに「1」を設定していても，実行ファイルをショートファイル名に変換して実行します。キューレスジョブの場合でも，この条件によって実行ファイルをショートファイル名に変換して実行します。

［実行ファイル名］に指定したファイル名が相対パス指定で，ファイル名の拡張子が「.exe」，「.bat」，「.cmd」，「.com」または「.pif」である

1のファイルパスをジョブ定義の［ワークパス］で指定している

ジョブをロングファイル名で実行したい場合は，次のどちらかの操作を行ってください。

［実行ファイル名］に絶対パスでファイル名を指定する

システム環境変数にファイルパスを指定し，［ワークパス］にファイルパスを指定しない

7.3　転送元ファイルの検索パスを定義する

転送元ファイルの検索パスを定義すると，相対パス指定でもパス解決ができます。

検索パスの定義方法を次に示します。

＜この節の構成＞

(1)　定義手順

(2)　定義パラメーター一覧

(3)　定義内容

(4)　定義例

(1)　定義手順

Windowsの［コントロールパネル］の［管理ツール］で［サービス］を選択し，次に示すサービスを停止する。

JP1/AJS2サービス

JP1/AJS2 Monitorサービス

JP1/AJS2 Queueless File Transferサービス※

注※

キューレスジョブを使用している場合だけ停止する必要があります。

メモ帳などのテキストエディターで，「(2) 定義パラメーター一覧」の定義パラメーターを記述した検索パス定義ファイルを作成する。

ファイルを保存し，次のコマンドを実行する。

jbssetcnf 検索パス定義ファイル名

jbssetcnfコマンドのパスは，「JP1/Baseのインストール先フォルダ¥bin¥jbssetcnf」です。
jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

手順1で停止したサービスを再起動する。
設定した内容が反映されます。

(2)　定義パラメーター一覧

表7-4　転送元ファイルの検索パスの定義パラメーター一覧

定義キー | 環境設定パラメーター | 定義内容
[{JP1_DEFAULT|論理ホスト名}¥JP1NBQCLIENT¥PathEnv]※ | "All Users"= | 転送元ファイルの検索パス
"JP1ユーザー名"= | 転送元ファイルの検索パス

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

(3)　定義内容

"JP1ユーザー名"=検索パス名

ジョブを実行するJP1ユーザーごとに検索パス名を指定します。

"All Users"=検索パス名

すべてのJP1ユーザーに対して検索パス名を指定します。

JP1ユーザーごとの設定と，すべてのJP1ユーザーに対する設定の順序は任意です。

検索パス名を複数記述するときは，パス間を「::（コロン二つ）」で区切ります。また，「=」より後ろのパス名全体を「"」で囲みます。

設定が重複した場合の優先度は次のとおりです。

すべてのJP1ユーザーに対する設定より，JP1ユーザーごとの設定が優先されます。JP1ユーザーごとに設定された検索パスで転送ファイルが見付かった場合，すべてのJP1ユーザーに対して設定された検索パスでは検索されません。

JP1ユーザー名が重複している場合，あとに定義されている方が優先されます。

(4)　定義例

条件

ジョブを実行するJP1ユーザーの名称：user1

user1専用の検索パス：¥home¥user1¥trans1，¥home¥user1¥trans2

JP1ユーザー共通の検索パス：¥tmp，¥usr¥tmp

転送元ファイル名：¥home¥user1¥trans1¥TransFile1

定義例

ジョブ中の転送元ファイルの定義

転送元ファイル名=TransFile1

サブミット要求元での検索パスの定義

[{JP1_DEFAULT|論理ホスト名}¥JP1NBQCLIENT¥PathEnv]
"user1"="¥home¥user1¥trans1::¥home¥user1¥trans2"
"All Users"="¥tmp::¥usr¥tmp"

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

この定義によって，サブミット要求元ホストでは，転送元ファイルとして「¥home¥user1¥trans1¥TransFile1」が設定されます。

7.4　JP1ユーザー仮定機能の設定

JP1/AJS2では，JP1ユーザーというユーザー名を使って権限を管理しています。OSユーザー（実行ユーザー）をJP1ユーザーにマッピングすることによって，ユーザーマッピングに設定されているホスト以外からの要求を受け付けないようにしています。

JP1/AJS2のこのユーザー管理では，OSユーザーごとにOSユーザーをJP1ユーザーにマッピングしなければならないため，不特定のOSユーザーがJP1/AJS2を使用することを目的とした場合，運用に負荷が掛かる場合があります。

このような運用負荷を軽減するために，一つのJP1ユーザーを不特定のOSユーザーで使用できるように設定しておきます（JP1仮定ユーザーに設定しておきます）。こうしておくと，JP1ユーザーにマッピングされていないOSユーザーでも，JP1仮定ユーザーの権限を使ってJP1/AJS2を操作できるようになります。これをJP1ユーザー仮定機能と呼びます（実行するOSユーザーがJP1ユーザーとして登録されている場合は，そのJP1ユーザーを使用します）。JP1ユーザー仮定機能は，JP1/AJS2のジョブ実行制御で提供しているコマンドを実行する際に利用できます。ジョブ実行制御で提供しているコマンドについては，マニュアル「JP1/Automatic Job Management System 2 コマンドリファレンス　1. コマンド」を参照してください。

ここでは，JP1ユーザー仮定機能の設定手順，注意事項について説明します。

＜この節の構成＞

7.4.1　JP1ユーザー仮定機能の設定手順

7.4.2　JP1ユーザー仮定機能の注意事項

7.4.1　JP1ユーザー仮定機能の設定手順

JP1ユーザー仮定機能の設定手順を次に示します。

JP1/Baseでユーザー情報を設定する。
ユーザー情報の設定手順については，「3.1.1(1) ユーザー情報を設定する」を参照してください。

jpqregguestuserコマンドを実行する。
手順1で登録したJP1ユーザーを，JP1仮定ユーザーに設定します。
jpqregguestuserコマンドの詳細については，「20. セットアップ時に使用するコマンド　jpqregguestuser」を参照してください。

JP1/AJS2を再起動する。
設定した内容が反映されます。

これでJP1ユーザー仮定機能の設定は終了です。

JP1ユーザー仮定機能の設定を解除したい場合も，jpqregguestuserコマンドを使用してください。

7.4.2　JP1ユーザー仮定機能の注意事項

JP1ユーザー仮定機能の注意事項を次に示します。

JP1仮定ユーザーに設定できるJP1ユーザーの数は，1台のJP1/AJS2 - Managerホストが管理する範囲につき，一つです。

JP1仮定ユーザーとして利用するJP1ユーザーにも，通常のJP1ユーザーと同様に，JP1権限レベルおよびユーザーマッピングを設定してください。
JP1権限レベルを設定する際は，次の点を考慮してください。

不特定のユーザーの実行要求を満たすことができること。

ユーザーの誤操作によって，運用環境が壊されるおそれがないこと。

クラスタシステムで運用する場合は，実行系ホストおよび待機系ホストの両方でjpqregguestuserコマンドを実行してください。
jpqregguestuserコマンドの詳細については，「20. セットアップ時に使用するコマンド　jpqregguestuser」

7.5　エージェント自動定義機能で作成されるキュー属性値をカスタマイズする設定

エージェント自動定義機能で作成されるエージェントの属性値を，あらかじめ構成定義情報でカスタマイズできます。この設定をすると，エージェント自動定義機能を使用して作成されるすべてのエージェントの属性値に対して有効になります。

エージェント自動定義機能で作成されるエージェントの属性値を，あらかじめ構成定義情報でカスタマイズするには，構成定義ファイルを作成します。エージェント自動定義機能で作成されるエージェントの属性値を，あらかじめ構成定義情報でカスタマイズするための構成定義ファイルとして，次のような書式に従ったテキストファイルを作成します。

エージェント自動定義機能で作成されるエージェントの属性値を，あらかじめ構成定義情報でカスタマイズする手順を次に示します。

＜この節の構成＞

(1)　定義手順

(2)　定義パラメーター一覧

(3)　定義内容

(1)　定義手順

Windowsの［コントロールパネル］の［管理ツール］で［サービス］を選択し，次に示すサービスを停止する。

JP1/AJS2 サービス

JP1/AJS2 Monitor サービス

メモ帳などのテキストエディターで，「(2) 定義パラメーター一覧」の定義パラメーターを記述した設定ファイルを作成する。

ファイルを保存し，次のコマンドを実行する。

jbssetcnf 設定ファイル名

jbssetcnfコマンドのパスは，「JP1/Baseのインストール先フォルダ¥bin¥jbssetcnf」です。
jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/AJS2を再起動する。
設定ファイルに記述した内容が反映されます。

(2)　定義パラメーター一覧

表7-5　エージェント自動定義時のキュー属性値カスタマイズ定義パラメーター一覧

定義キー | 環境設定パラメーター | 定義内容
[{JP1_DEFAULT|論理ホスト名}¥JP1NBQMANAGER¥Agent]※ | "AutoCreateExecJobs"= | エージェント自動定義時のジョブの実行多重度
"AutoCreateMaxJobs"= | エージェント自動定義時のジョブ数の最大値
"AutoCreateWarnJobs"= | エージェント自動定義時のジョブ数の警告値
"AutoCreatePriority"= | エージェント自動定義時のエージェント優先順位

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

(3)　定義内容

"AutoCreateExecJobs"=dword:エージェント自動定義時のジョブの実行多重度

エージェント自動定義時に作成されるエージェントのジョブ実行多重度を16進数で指定します。

指定できる範囲は1～00000400（10進数で1～1,024）です。

デフォルトは「dword:00000005」（10進数で5）です。

ここで指定した多重度は24時間共通の設定となります。30分単位で設定したい場合は，jpqagtaltコマンドを使用して変更してください。

"AutoCreateMaxJobs"=dword:エージェント自動定義時のジョブ数の最大値

エージェント自動定義時に作成されるデフォルトキューのジョブの最大数を16進数で指定します。

指定できる範囲は1～FFFFFFFF（10進数で1～4,294,967,295）です。

デフォルトは「dword:00000064」（10進数で100）です。

"AutoCreateWarnJobs"=dword:エージェント自動定義時のジョブ数の警告値

エージェント自動定義時に作成されるデフォルトキューのジョブの警告数を16進数で指定します。

指定できる範囲は1～FFFFFFFF（10進数で1～4,294,967,295）です。

デフォルトは「dword:00000050」（10進数で80）です。

"AutoCreatePriority"=dword:エージェント自動定義時のエージェント優先順位

エージェント自動定義時に作成されるデフォルトキューのエージェント優先順位を16進数で指定します。

指定できる範囲は1～00000010（10進数で1～16）です。

デフォルトは「dword:00000001」（10進数で1）です。

7.6　ユーザープロファイルを必要とするジョブを実行するための設定

ジョブを実行する際に有効となるプロセス実行環境は，システム環境で設定されているものを使用しています。ただし，ジョブによってはOSユーザーのログオンセッションに設定されているユーザー情報を読み込まないと正しく実行できないものもあります。

次に示すオプションを有効にすると，このようなユーザープロファイル情報を必要とするジョブを正しく実行することができるようになります。また，このオプションを有効にすると，指定先のエージェントホストで実行するすべてのPCジョブ※についてユーザープロファイルを読み込みます。

注※

ジョブの実行先サービスに［JP1/AJS2 Queueless Agent］を指定した場合を除きます。

ユーザープロファイルを必要とするジョブを実行するための設定手順を次に示します。ジョブの実行先となるエージェントホストに設定してください。

なお，キューレスジョブ環境でユーザープロファイルを必要とするジョブを実行するための設定方法については「7.10 キューレスジョブ環境でユーザープロファイルを必要とするジョブを実行するための設定」を参照してください。

＜この節の構成＞

(1)　定義手順

(2)　定義パラメーター一覧

(3)　定義内容

(4)　注意事項

(1)　定義手順

Windowsの［コントロールパネル］の［管理ツール］で［サービス］を選択し，次に示すサービスを停止する。

JP1/AJS2サービス

JP1/AJS2 Monitorサービス

メモ帳などのテキストエディターで，「(2) 定義パラメーター一覧」の定義パラメーターを記述した設定ファイルを作成する。
設定ファイルのファイル名は任意です。

ファイルを保存し，次のコマンドを実行する。

jbssetcnf 設定ファイル名

jbssetcnfコマンドのパスは，「JP1/Baseのインストール先フォルダ¥bin¥jbssetcnf」です。
jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/AJS2を再起動する。
設定ファイルに記述した内容が反映されます。

注意

このオプションを無効にする設定を行った場合にはOSを再起動してください。

(2)　定義パラメーター一覧

表7-6　ユーザープロファイルを必要とするジョブを実行するための定義パラメーター

定義キー | 環境設定パラメーター | 定義内容
[{JP1_DEFAULT|論理ホスト名}¥JP1NBQAGENT¥Job]※ | "LoadUserProfile"= | ユーザープロファイルを読み込むかどうかの定義

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

(3)　定義内容

"LoadUserProfile"=dword:設定値

ユーザープロファイルを読み込むかどうかを指定します。

0

ユーザープロファイルを読み込まない場合。

1

ユーザープロファイルを読み込む場合。

デフォルトは「0」です。

(4)　注意事項

このオプションを有効にすると，ジョブ実行時に次に示すどちらかのメッセージを統合トレースログに出力してジョブが異常終了することがあります。このオプションを有効にした場合は，これらのエラーの発生を抑えるために，「7.26 ジョブ実行時にアクセストークンを再利用するための設定」を有効にしてください。

KAVU3549-E ジョブ実行処理でシステムコール（関数名）でエラーが発生しました（要因番号）

KAVU3577-W ジョブ実行処理でシステムコール（関数名）でエラーが発生しました（要因番号）

ジョブ実行時にアクセストークンを再利用する設定の詳細については，マニュアル「JP1/Automatic Job Management System 2 設計・運用ガイド　8.2.3 ジョブ実行時のユーザーアカウント」を参照してください。

なお，このオプションを有効にしても，ユーザー環境変数は読み込まれません。ジョブ実行時に設定される環境変数の詳細については，マニュアル「JP1/Automatic Job Management System 2 コマンドリファレンス　1.コマンド　環境変数一覧」の，JP1/AJS2から実行されるジョブ実行時に設定される環境変数について記載している個所を参照してください。

7.7　ジョブ情報削除処理に関する設定

JP1/AJS2では，ジョブ情報削除基準時刻，およびJP1/AJS2起動時にジョブ実行環境で使用するISAMデータベースからジョブ情報保存日数を経過したジョブを削除します。

ジョブ情報削除処理に関して，運用形態に合わせて設定を選択してください。

ジョブ情報削除処理非同期オプションの設定
ジョブ情報の削除処理を非同期で行う場合に指定します。

ジョブ情報の保存時間の設定
ジョブの保存日数を0日にしている場合に，ジョブが終了してから削除するまでの時間を指定します。

JP1/AJS2起動時にジョブ情報削除処理を抑止する設定
ジョブ情報の保存日数を1日以上設定している場合に，JP1/AJS2サービス起動時にジョブ情報の削除処理を抑止するように設定します。

詳細については，マニュアル「JP1/Automatic Job Management System 2 設計・運用ガイド　8.1.7 ジョブ情報削除処理の注意事項」を参照してください。

＜この節の構成＞

7.7.1　ジョブ情報削除処理非同期オプションの設定

7.7.2　ジョブ情報の保存時間の設定

7.7.3　JP1/AJS2起動時にジョブ情報削除処理を抑止する設定

7.7.1　ジョブ情報削除処理非同期オプションの設定

ジョブ情報の削除処理を非同期で行う場合の設定手順を次に示します。

＜この項の構成＞

(1)　定義手順

(2)　定義パラメーター一覧

(3)　定義内容

(1)　定義手順

Windowsの［コントロールパネル］の［管理ツール］で［サービス］を選択し，次に示すサービスを停止する。

JP1/AJS2 サービス

JP1/AJS2 Monitor サービス

メモ帳などのテキストエディターで，「(2) 定義パラメーター一覧」の定義パラメーターを記述した設定ファイルを作成する。
設定ファイルのファイル名は任意です。

ファイルを保存し，次のコマンドを実行する。

jbssetcnf 設定ファイル名

jbssetcnfコマンドのパスは，「JP1/Baseのインストール先フォルダ¥bin¥jbssetcnf」です。
jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/AJS2を再起動する。
設定ファイルに記述した内容が反映されます。

(2)　定義パラメーター一覧

表7-7　ジョブ情報削除処理非同期オプション設定の定義パラメーター

定義キー | 環境設定パラメーター | 定義内容
[{JP1_DEFAULT|論理ホスト名}¥JP1NBQMANAGER¥Database]※ | "DeleteFlashOption"= | ジョブ情報削除処理非同期オプション

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

(3)　定義内容

"DeleteFlashOption"=dword:設定値

ジョブ情報の削除について非同期で実行するかどうかを指定します。

0

ジョブ情報の削除について非同期で実行する場合。

1

ジョブ情報の削除について同期で実行する場合。

デフォルトは「1」です。

このパラメーターは，JP1/AJS2の新規のインストール時および新規のセットアップ時に「0」が設定されます。

7.7.2　ジョブ情報の保存時間の設定

ジョブの保存日数を0日にしている場合に，ジョブが終了してから削除するまでの時間を設定する手順を次に示します。

＜この項の構成＞

(1)　定義手順

(2)　定義パラメーター一覧

(3)　定義内容

(1)　定義手順

Windowsの［コントロールパネル］の［管理ツール］で［サービス］を選択し，次に示すサービスを停止する。

JP1/AJS2 サービス

JP1/AJS2 Monitor サービス

メモ帳などのテキストエディターで，「(2) 定義パラメーター一覧」の定義パラメーターを記述した設定ファイルを作成する。
設定ファイルのファイル名は任意です。

ファイルを保存し，次のコマンドを実行する。

jbssetcnf 設定ファイル名

jbssetcnfコマンドのパスは，「JP1/Baseのインストール先フォルダ¥bin¥jbssetcnf」です。
jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/AJS2を再起動する。
設定ファイルに記述した内容が反映されます。

(2)　定義パラメーター一覧

表7-8　ジョブ情報の保存時間設定の定義パラメーター

定義キー | 環境設定パラメーター | 定義内容
[{JP1_DEFAULT|論理ホスト名}¥JP1NBQMANAGER¥Database]※ | "PreserveMinute"= | ジョブ情報の保存時間

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

(3)　定義内容

"PreserveMinute"=dword:設定値

ジョブ情報の保存時間を16進数で指定します。

指定できる範囲は0000000A～000005A0（10進数で10～1440）（単位：分）です。

デフォルトは「dword:0000000A」（10進数で10）です。

7.7.3　JP1/AJS2起動時にジョブ情報削除処理を抑止する設定

ジョブ情報の保存日数を1日以上設定している場合に，JP1/AJS2サービス起動時にジョブ情報の削除処理を抑止するように設定します。

＜この項の構成＞

(1)　定義手順

(2)　定義パラメーター一覧

(3)　定義内容

(4)　JP1/AJS2起動時にジョブ情報削除処理を抑止する設定と動作

(1)　定義手順

Windowsの［コントロールパネル］の［管理ツール］で［サービス］を選択し，次に示すサービスを停止する。

JP1/AJS2サービス

JP1/AJS2 Monitorサービス

メモ帳などのテキストエディターで，「(2) 定義パラメーター一覧」の定義パラメーターを記述した設定ファイルを作成する。
設定ファイルのファイル名は任意です。

ファイルを保存し，次のコマンドを実行する。

jbssetcnf 設定ファイル名

jbssetcnfコマンドのパスは，「JP1/Baseのインストール先フォルダ¥bin¥jbssetcnf」です。
jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/AJS2を再起動する。
設定ファイルに記述した内容が反映されます。

(2)　定義パラメーター一覧

表7-9　JP1/AJS2起動時にジョブ情報削除処理を抑止する設定の定義パラメーター

定義キー | 環境設定パラメーター | 定義内容
[{JP1_DEFAULT|論理ホスト名}¥JP1NBQMANAGER¥Database]※ | "StartUpDelete"= | JP1/AJS2起動時にジョブ情報削除処理を抑止する定義

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

(3)　定義内容

"StartUpDelete"=dword:設定値

JP1/AJS2起動時にジョブ情報削除処理を抑止するかどうかを指定します。

0

JP1/AJS2サービス起動時に，ジョブ情報削除の基準時刻を基点として保存日数を超えているジョブ情報だけを削除する場合に指定します。

JP1/AJS2サービス起動時，ジョブ情報削除の基準時刻からJP1/AJS2サービス起動時刻までの間に保存日数を超えたジョブ情報については削除しません。

前回のジョブ情報削除の基準時刻にJP1/AJS2サービスが停止していてジョブ情報削除処理が実施されなかった場合に，ジョブ情報削除の基準時刻を基点として保存日数を超えているジョブ情報が残っていることがあります。その場合は，JP1/AJS2サービス起動時に，これらのジョブ情報だけを削除します。

1

JP1/AJS2サービス起動時にJP1/AJS2サービス起動時刻を基点として，保存日数を超えているジョブ情報をジョブ情報削除処理で削除する場合に指定します。

JP1/AJS2サービス起動時，ジョブ情報削除の基準時刻からJP1/AJS2サービス起動時刻までの間に保存日数を超えたジョブ情報がある場合，これらのジョブ情報を削除します。

前回のジョブ情報削除の基準時刻にJP1/AJS2サービスが停止していてジョブ情報削除処理が実施されなかった場合に，ジョブ情報削除の基準時刻を基点として保存日数を超えているジョブ情報が残っていることがあります。その場合は，JP1/AJS2サービス起動時に，これらのジョブ情報も削除します。

2

JP1/AJS2サービス起動時のジョブ情報削除処理を抑止する場合に指定します。

ただし，ジョブ情報削除の基準時刻にJP1/AJS2サービスを停止する運用の場合はこの設定をしないでください。

ジョブ情報削除の基準時刻にJP1/AJS2サービスが停止していると，ジョブ情報削除の基準時刻を基点として保存日数を超えているジョブ情報が削除されません。そのため，ジョブ実行環境データベースのディスク占有量が増加しつづけます。ジョブ実行環境データベースのディスク占有量が増加すると，JP1/AJS2サービスの起動に失敗したり，ジョブが実行できなくなったりするといった影響が出るおそれがあります。

デフォルトは「1」です。

このパラメーターは，JP1/AJS2の新規のインストール時および新規のセットアップ時に「0」が設定されます。

(4)　JP1/AJS2起動時にジョブ情報削除処理を抑止する設定と動作

JP1/AJS2起動時にジョブ情報削除処理を抑止する設定と，削除処理を行うかどうかの関係について次に示します。

表7-10　JP1/AJS2起動時にジョブ情報削除処理を抑止する設定と削除処理を行うかどうかの関係

JP1/AJS2起動時にジョブ情報削除処理を抑止する設定 | JP1/AJS2起動時のジョブ情報削除処理 | 削除対象のジョブ情報の基点となる時刻
0 | ○※ | 基準時刻
1 | ○ | JP1/AJS2サービス起動時刻
2 | × | －

（凡例）

○：削除処理を行う

×：削除処理を行わない

－：該当なし

注※

前回のジョブ情報削除の基準時刻にジョブ情報が削除されていれば，JP1/AJS2サービス起動時のジョブ情報削除処理ではジョブ情報を削除しません。

7.8　イベントジョブのログサイズの設定の変更

運用の形態に合わせてイベントジョブのログサイズの設定変更を行います。最低でも24時間分のログが保持できることを目安とし，2，3日分のログを保持できるように設定することをお勧めします。（Windowsホストの場合）

ログサイズの見積もりについては，マニュアル「JP1/Automatic Job Management System 2 設計・運用ガイド　4.4.4 イベントジョブが出力するログのサイズを見積もる」を参照してください。

イベントジョブのログ設定を変更する手順を次に示します。

＜この節の構成＞

(1)　定義手順

(1)　定義手順

Windowsの［コントロールパネル］の［管理ツール］で［サービス］を選択し，次に示すサービスを停止する。

JP1/AJS2サービス

JP1/AJS2 Monitorサービス

メモ帳などのテキストエディターで，定義パラメーターの記述を設定に合わせて変更してください。
定義パラメーターについてはマニュアル「JP1/Automatic Job Management System 2 設計・運用ガイド　4.4.4 イベントジョブが出力するログのサイズを見積もる」を参照してください。
ログ設定構成定義ファイルのファイル名は任意です。

ファイルを保存し，次のコマンドを実行する。

jbssetcnf ログ設定構成定義ファイル名

jbssetcnfコマンドのパスは，「JP1/Baseのインストール先フォルダ¥bin¥jbssetcnf」です。
jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/AJS2を再起動する。
設定ファイルに記述した内容が反映されます。

7.9　イベント順序保証オプションの設定

起動条件で監視している一つのイベントジョブのイベントが連続して発生する場合，通信の状態によって，イベントの成立順序が実際に発生した順序とは異なってしまうことがあります。引き継ぎ情報を使用しているなどで，成立するイベントの順序をイベントが実際に発生した順にしたい場合は，イベント順序保証オプションを使用してください。イベント順序保証オプションを有効にする方法を次に示します。なお，イベント順序保証オプションは，イベントジョブを実行するすべてのエージェントホストで設定してください。

＜この節の構成＞

(1)　定義手順

(2)　定義パラメーター一覧

(3)　定義内容

(1)　定義手順

Windowsの［コントロールパネル］の［管理ツール］で［サービス］を選択し，次に示すサービスを停止する。

JP1/AJS2サービス

JP1/AJS2 Monitorサービス

メモ帳などのテキストエディターで，「(2) 定義パラメーター一覧」の定義パラメーターを記述した設定ファイルを作成する。

ファイルを保存し，次のコマンドを実行する。

jbssetcnf 設定ファイル名

jbssetcnfコマンドのパスは，「JP1/Baseのインストール先フォルダ¥bin¥jbssetcnf」です。
jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/AJS2を再起動する。
設定ファイルに記述した内容が反映されます。

(2)　定義パラメーター一覧

表7-11　イベント順序保証オプション設定の定義パラメーター

定義キー | 環境設定パラメーター | 定義内容
[{JP1_DEFAULT|論理ホスト名}¥JP1AOMAGENT]※ | "EventSequential"= | イベント順序保証オプション

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

(3)　定義内容

"EventSequential"="{Y|N}"

イベント順序保証オプションを使用するかどうかを指定します。

Y

イベント順序保証オプションを使用する場合に指定します。

N

イベント順序保証オプションを使用しない場合に指定します。

デフォルトは「N」です。

7.10　キューレスジョブ環境でユーザープロファイルを必要とするジョブを実行するための設定

ジョブを実行する際に有効となるプロセス実行環境はシステム環境で設定されているものを使用しています。ただし，ジョブによってはOSユーザーのログオンセッションに設定されているユーザー情報を読み込まないと正しく実行できないものもあります。ユーザープロファイルを使用するオプションを有効にすると，このようなユーザープロファイル情報を必要とするジョブを正しく実行することができるようになります。また，このオプションを有効にすると指定先のエージェントホストで実行するすべてのPCジョブについてユーザープロファイルの読み込みを行います。設定の変更手順を次に示します。

＜この節の構成＞

(1)　定義手順

(2)　定義パラメーター一覧

(3)　定義内容

(1)　定義手順

Windowsの［コントロールパネル］の［管理ツール］で［サービス］を選択し，次に示すサービスを停止する。

JP1/AJS2 Queueless Agentサービス

メモ帳などのテキストエディターで，「(2) 定義パラメーター一覧」の定義パラメーターを記述した設定ファイルを作成する。
設定ファイルのファイル名は任意です。

ファイルを保存し，次のコマンドを実行する。

jbssetcnf 設定ファイル名

jbssetcnfコマンドのパスは，「JP1/Baseのインストール先フォルダ¥bin¥jbssetcnf」です。
jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

手順1で停止した次のサービスを再起動する。

JP1/AJS2 Queueless Agentサービス

設定ファイルに記述した内容が反映されます。

(2)　定義パラメーター一覧

表7-12　キューレスジョブ環境でユーザープロファイルを必要とするジョブを実行する設定の定義パラメーター

定義キー | 環境設定パラメーター | 定義内容
[{JP1_DEFAULT|論理ホスト名}¥JP1QLAGENT]※ | "AJSQL_LOADUSERPROFILE"= | ユーザープロファイルを読み込むかどうかの定義

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

(3)　定義内容

"AJSQL_LOADUSERPROFILE"="{yes|no}"

ユーザープロファイルを読み込むかどうかを指定します。

yes

読み込む場合に指定します。

no

読み込まない場合に指定します。

デフォルトは「no」です。

7.11　ジョブの標準出力と標準エラー出力を同時に確認する設定

JP1/AJS2 - Viewの［実行結果詳細］ダイアログに表示される内容は，ジョブが標準エラー出力に出力した内容です。ジョブが標準出力に出力した内容も同時に［実行結果詳細］ダイアログボックスで確認するためには，次の設定が必要です。

PCジョブ，UNIXジョブの場合
［詳細定義－［PC Job］］ダイアログボックスまたは，［詳細定義－［UNIX Job］］ダイアログボックスの［標準出力ファイル名］と［標準エラー出力ファイル名］に同じファイル名を指定します。

注意事項

［標準出力ファイル名］と［標準エラー出力ファイル名］に同じファイル名を指定する場合は，追加書きオプションの設定を合わせてください。片方が新規作成で，もう片方を追加書きに設定した定義のジョブを実行すると，次のメッセージを統合トレースログに出力して，ジョブの状態が起動失敗となります。
・ジョブの実行先サービスに［JP1/AJS2］を指定している場合
　KAVU0201-E パラメーターに誤りがあります
・ジョブの実行先サービスに［JP1/AJS2 Queueless Agent］を指定している場合（キューレスジョブの場合）
　KAVS1846-E ジョブ定義文（ジョブ名）に誤りがあります

キューレスジョブに同一ファイル名を指定した場合，標準出力と標準エラー出力にジョブが出力する内容はいったん一時ファイルに保存されます。このため，ジョブの実行中は，指定したファイルは更新されません。ジョブが終了した時点で更新されます。

7.12　ファイル監視ジョブの状態引き継ぎオプションの設定

ファイル監視ジョブが監視対象ファイルを監視している間の情報を随時退避しておき，JP1/AJS2サービスが一時的に停止した場合でもジョブの状態を引き継ぐことができます。

なお，監視状態を引き継ぐには，ファイル監視ジョブが継続して動作している必要があります。ファイル監視ジョブが継続して動作するか，終了するかによって監視状態が引き継がれるかどうかが異なります。

監視状態が引き継がれる条件については，マニュアル「JP1/Automatic Job Management System 2 設計・運用ガイド　8.3.2 ファイル監視ジョブの注意事項」を参照してください。

ファイル監視ジョブの状態を引き継ぐ機能は，デフォルトでは無効になっていますが，JP1/AJS2の新規のインストール時および新規のセットアップ時に有効になります。オプションを変更する手順を次に示します。

Windowsの［スタート］メニューから［プログラム］－［JP1_Automatic Job Management System 2 - Manager］または［JP1_Automatic Job Management System 2 - Agent］－［環境設定］を選択する。
［マネージャー環境設定］または［エージェント環境設定］ダイアログボックスが表示されます。

［マネージャー環境設定］または［エージェント環境設定］ダイアログボックスの［イベント起動］タブにある，［ファイル監視ジョブの情報の引継ぎ］のラジオボタンを変更する。

［適用］ボタンをクリックする。

［OK］ボタンをクリックする。

JP1/AJS2を再起動する。
変更した構成定義の内容が反映されます。

7.13　「"（ダブルクォーテーションマーク）」を含むデータをイベントジョブの引き継ぎ情報に使用するための設定

「"（ダブルクォーテーションマーク）」を含むデータを指定したとおりに引き継ぎ情報として引き継がせることができます。詳細については，マニュアル「JP1/Automatic Job Management System 2 設計・運用ガイド　5.3.8(4) 「"（ダブルクォーテーションマーク）」を含むデータをイベントジョブの引き継ぎ情報に使用する」を参照してください。

「"（ダブルクォーテーションマーク）」を含むデータを指定したとおりに引き継ぎ情報として引き継がせるオプションを有効にするための設定をするには，設定ファイルを作成します。

設定手順を次に示します。

＜この節の構成＞

(1)　定義手順

(2)　定義パラメーター一覧

(3)　定義内容

(1)　定義手順

Windowsの［コントロールパネル］の［管理ツール］で［サービス］を選択し，次に示すサービスを停止する。

JP1/AJS2サービス

JP1/AJS2 Monitorサービス

メモ帳などのテキストエディターで，「(2) 定義パラメーター一覧」の定義パラメーターを記述した設定ファイルを作成する。
ファイルには変更したい定義内容だけを定義します。ファイルに定義しなかったものについては，デフォルト値が仮定されます。
設定ファイルのファイル名は任意です。

ファイルを保存し，次のコマンドを実行する。

jbssetcnf 設定ファイル名

jbssetcnfコマンドのパスは，「JP1/Baseのインストール先フォルダ¥bin¥jbssetcnf」です。
jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/AJS2を再起動する。
設定ファイルに記述した内容が反映されます。

(2)　定義パラメーター一覧

表7-13　引き継ぎ情報における「"（ダブルクォーテーションマーク）」有効オプション設定の定義パラメーター

定義キー | 環境設定パラメーター | 定義内容
[{JP1_DEFAULT|論理ホスト名}¥JP1AOMMANAGER]※ | "MacVarDQuotation"= | 引き継ぎ情報における「"（ダブルクォーテーションマーク）」有効オプション

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

(3)　定義内容

"MacVarDQuotation"="{Y|N}"

引き継ぎ情報における「"（ダブルクォーテーションマーク）」有効オプションを使用するかしないかを指定します。

Y

使用する場合に指定します。

N

使用しない場合に指定します。

デフォルトは「N」です。

このパラメーターは，JP1/AJS2の新規のインストール時および新規のセットアップ時に「Y」が設定されます。

7.14　イベントジョブを使用したDNS運用時にFQDN形式で運用するための設定

イベントジョブを使用する場合，かつDNS運用時にFQDN形式のホスト名で運用する場合の設定について説明します。ここでは，JP1/AJS2 07-00を新規に導入するの場合の設定手順を次に示します。イベントジョブを使用する場合の設定であり，標準ジョブ・アクションジョブ・カスタムジョブはすでに対応しています。JP1/AJS2 06-71以前の運用環境からバージョンアップする場合の設定の流れと手順については，「JP1/Automatic Job Management System 2 設計・運用ガイド　9.5 イベントジョブをDNS環境で運用する場合の設定方法（バージョンアップ時）」を参照してください。

なお，この設定はマネージャーホスト上で実施します。

＜この節の構成＞

(1)　定義手順

(2)　定義パラメーター一覧

(3)　定義内容

(1)　定義手順

Windowsの［コントロールパネル］の［管理ツール］で［サービス］を選択し，次に示すサービスを停止する。

JP1/AJS2サービス

メモ帳などのテキストエディターで，「(2) 定義パラメーター一覧」の定義パラメーターを記述した設定ファイルを作成する。
設定ファイルのファイル名は任意です。

ファイルを保存し，次のコマンドを実行する。

jbssetcnf 設定ファイル名

jbssetcnfコマンドのパスは，「JP1/Baseのインストール先フォルダ¥bin¥jbssetcnf」です。
jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/AJS2を再起動する。
設定ファイルに記述した内容が反映されます。

(2)　定義パラメーター一覧

表7-14　イベントジョブを使用してDNS運用時にFQDN形式で運用する設定の定義パラメーター

定義キー | 環境設定パラメーター | 定義内容
[{JP1_DEFAULT|論理ホスト名}¥JP1AOMMANAGER]※ | "DNSEstablish"= | イベントジョブを使用してDNS運用時にFQDN形式で運用するための定義

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

(3)　定義内容

"DNSEstablish"="{Y|N}"

DNS運用時にFQDN形式のホスト名で運用するかどうかを指定します。

Y

DNS運用時にFQDN形式のホスト名で運用する場合に指定します。

N

DNS運用時にFQDN形式のホスト名で運用しない場合に指定します。エージェントへはFQDN形式のホスト名ではなく，ホスト名を送ります。

デフォルトは「N」です。

7.15　キューレスジョブ環境でクラスを指定したジョブを実行するための設定

キューレスジョブ環境では，クラスを定義し，クラスごとに最大同時ジョブ実行数と最大待ちジョブ数を制限できます。クラスは複数定義できます。

クラス内での最大同時ジョブ実行数を超えて同時にジョブを実行しようとすると，実行できなかったジョブはキューレスエージェントのメモリーに貯えられます。クラス内での最大待ちジョブ数を超えてジョブを同時に実行しようとすると，そのジョブの実行は失敗し，状態は「起動失敗」となります。

例えば，あるクラスでの最大同時ジョブ実行数が10であり，最大待ちジョブ数が5のとき，同時に15個のジョブが実行中の状態でさらにジョブを実行しようとすると，16個目以降のジョブの状態は「起動失敗」となります。

キューレスエージェント全体の最大同時実行ジョブ数を超える場合，クラスごとの最大同時ジョブ実行数の制限値以内であっても，そのジョブはキューレスエージェントのメモリーに貯えられます。キューレスエージェント全体の最大待ちジョブ数を超える場合，クラスごとの最大待ちジョブ数の制限値以内であっても，そのジョブの状態は「起動失敗」になります。

クラスを指定してジョブを実行するためには，区切り文字「!」を使用して，ジョブの［実行ホスト］に次の形式で実行ホスト名とクラス名を指定します。

実行ホスト名!クラス名

ジョブの実行ホスト名を省略して，区切り文字とクラス名だけを指定した場合は，自ホストに対するクラス名が仮定されます。

ジョブの実行ホスト名，クラス名を共に省略した場合は，ジョブが属するジョブネットの［実行ホスト］に指定された実行ホスト名が仮定されます。

ジョブネットの［実行ホスト］にクラス名は指定できません。このようなジョブネットを実行しようとすると，ジョブネット中に含まれるジョブの状態は「起動失敗」になります。

存在しないクラスを指定してジョブを実行しようとすると，そのジョブの状態は「起動失敗」になります。

クラスを設定する手順を次に示します。

＜この節の構成＞

(1)　定義手順

(2)　定義パラメーター一覧

(3)　定義内容

(4)　定義例

(5)　注意事項

(1)　定義手順

Windowsの［コントロールパネル］の［管理ツール］で［サービス］を選択し，次に示すサービスを停止する。

JP1/AJS2 Queueless Agentサービス

メモ帳などのテキストエディターで，「(2) 定義パラメーター一覧」の定義パラメーターを記述した設定ファイルを作成する。
設定ファイルのファイル名は任意です。

ファイルを保存し，次のコマンドを実行する。

jbssetcnf 設定ファイル名

jbssetcnfコマンドのパスは，「JP1/Baseのインストール先フォルダ¥bin¥jbssetcnf」です。
jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

手順1で停止した次のサービスを再起動する。

JP1/AJS2 Queueless Agentサービス

設定ファイルに記述した内容が反映されます。

(2)　定義パラメーター一覧

表7-15　キューレスジョブ環境でクラスを指定したジョブを実行する設定の定義パラメーター一覧

定義キー | 環境設定パラメーター | 定義内容
[{JP1_DEFAULT|論理ホスト名}¥JP1QLAGENT¥AJSQL_CLASS¥クラス名]※ | "AJSQL_CJOBMAX"= | クラス内での最大同時ジョブ実行数
"AJSQL_CJOBWAITMAX"= | クラス内での最大待ちジョブ数

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

(3)　定義内容

"AJSQL_CJOBMAX"=dword:クラス内での最大同時ジョブ実行数

そのクラスで同時実行を許すジョブの最大数を16進数で指定します。

指定できる範囲は0～400（10進数で0～1,024）です。

デフォルトは「5」（10進数で5）です。

"AJSQL_CJOBWAITMAX"=dword:クラス内での最大待ちジョブ数

そのクラスでの最大同時ジョブ実行数を超えたときに，キューレスエージェントサービス上のメモリーに貯えておくキューレスジョブの最大数を16進数で指定します。

指定できる範囲は0～19000（10進数で0～102,400）です。

デフォルトは「800」（10進数で2,048）です。

(4)　定義例

ジョブの[実行先ホスト]の定義

実行先ホスト=agent1!class1

ジョブ実行先(agent1)でのクラスの定義

[JP1_DEFAULT¥JP1QLAGENT¥AJSQL_CLASS¥class1]
"AJSQL_CJOBMAX"=dword:3
"AJSQL_CJOBWAITMAX"=dword:1000

この定義では，ジョブ実行先ホストagent1のクラスclass1上で同時に実行できるジョブ数は3個です。ジョブ実行先ホストagent1のクラスclass1上での最大待ちジョブ数は4,096個です。

3個を超えて同時にジョブを実行しようとした場合，4,096個まではエージェント上のメモリーに貯えられます。さらにジョブを実行しようとした場合，以降のジョブは「起動失敗」となります。

(5)　注意事項

クラス名にマルチバイト文字は使用できません。

［実行先ホスト］に指定できるクラス名の最大長は63バイトまでです。64バイト以上を指定した場合，64バイト以降の文字は切り捨てられます。

環境設定パラメーターを定義しないでクラスを定義している場合，ajsqlsetupコマンドの実行によって定義済みクラスの環境設定パラメーターが自動生成され，デフォルト値が設定されます。

7.16　ファイル受信制限をするための設定

JP1/AJS2では，ジョブ※実行時に結果ファイル（標準出力ファイル，および標準エラー出力ファイル）や転送ファイルをマネージャーホストとエージェントホスト間，またはクライアントホストとマネージャーホスト間で送受信します。これらのファイルのサイズが数メガバイトを超えるような場合，ファイルのデータ解析処理，またはファイルのデータ転送で負荷が掛かり，CPU使用率の増加や，メモリー使用量の増加など，ジョブの実行が遅延するだけでなく，システム全体の処理に影響を与えるおそれがあります。

注※

ジョブは，QUEUEジョブ，イベントジョブを除きます。また，キューレスジョブは対象外です。

ファイル受信制限をするための設定を行うと，ジョブ実行時にマネージャーホスト側で受信する結果ファイルのサイズ（標準出力ファイルと標準エラー出力ファイルを合わせた合計のサイズ），またはエージェントホストが受信する転送ファイルのサイズ（転送ファイルを複数指定した場合はその合計サイズ）の上限値を設定できます。

また，上限値を超えた場合の動作（ジョブの終了状態）や出力するメッセージを指定できます。

ファイル受信サイズの上限値を超えた場合の動作と上限値を超えたファイルデータの扱いについて次に示します。

表7-16　ファイル受信サイズの上限値を超えた場合の動作と上限値を超えたファイルデータの扱い

上限値を超えたファイルの種類 | 動作内容 | ReceiveFileSizeStatus環境設定パラメーターの指定
0 | 1 | 2 | 3
結果ファイル | ジョブの状態 | 実際の終了状態を引き継ぐ | 異常検出終了 | 警告検出終了※ | 実際の終了状態を引き継ぐ
出力するメッセージの種別 | 情報 | 異常 | 警告 | 情報
ファイルデータの扱い | すべてのファイルデータを受信する | 上限値を超えたデータを破棄する | 上限値を超えたデータを破棄する | 上限値を超えたデータを破棄する
転送ファイル | ジョブの状態 | 実際の終了状態を引き継ぐ | 起動失敗 | 起動失敗 | 実際の終了状態を引き継ぐ
出力するメッセージの種別 | 情報 | 異常 | 異常 | 情報
ファイルデータの扱い | すべてのファイルデータを受信する | すべてのファイルデータを受信しない | すべてのファイルデータを受信しない | すべてのファイルデータを受信しない

注※

エージェントホストでジョブの状態が「異常検出終了」だった場合はその状態を引き継ぎます。

＜この節の構成＞

(1)　定義手順

(2)　定義パラメーター一覧

(3)　定義内容

(4)　ファイル受信サイズが上限値を超えた場合の動作

(5)　注意事項

(1)　定義手順

メモ帳などのテキストエディターで，「(2) 定義パラメーター一覧」の定義パラメーターを指定した設定ファイルを作成する。
ファイルには変更したい定義内容だけを定義します。ファイルに定義しなかったものについては，デフォルト値が仮定されます。
設定ファイルのファイル名は任意です。

ファイルを保存し，次のコマンドを実行する。

jbssetcnf 設定ファイル名

jbssetcnfコマンドのパスは，「JP1/Baseのインストール先フォルダ¥bin¥jbssetcnf」です。
jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/AJS2を再起動する。
変更した構成定義の内容が反映されます。

(2)　定義パラメーター一覧

表7-17　ファイル受信制限をする設定の定義パラメーター一覧

定義キー | 環境設定パラメーター | 定義内容
[{JP1_DEFAULT|論理ホスト名}¥JP1NBQMANAGER¥Job]※ | "ReceiveFileSizeStatus"= | ファイルサイズが上限値に達したときの動作
"LimitReceiveFileSize"= | ファイルサイズの上限値

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

(3)　定義内容

"ReceiveFileSizeStatus"=dword:ファイルサイズが上限値に達したときの動作

ファイル受信サイズが上限値に達したときの動作を指定します。

デフォルトは「0」です。

0

ファイル受信サイズの上限値をチェックし，上限値に達した場合は次のメッセージを出力しますが，すべてのファイルデータを受信します。ファイル受信サイズが上限値を超えてもジョブの状態は変更しないで，エージェントホストでのジョブの終了状態を引き継ぎます。

結果ファイルの場合
KAVU4294-Iメッセージ

転送ファイルの場合
KAVU2243-Iメッセージ

1

ファイル受信サイズの上限値をチェックし，上限値に達した場合はファイルの受信処理を中止して，ジョブの状態を変更します。

結果ファイルは，ファイルサイズの上限値（LimitReceiveFileSize）まで受信し，上限値を超えたデータを破棄して，終了状態を「異常検出終了」にします。転送ファイルはすべてのファイルデータを受信しないで，終了状態を「起動失敗」にします。終了コードと状態については，「(4) ファイル受信サイズが上限値を超えた場合の動作」を参照してください。

上限値に達した場合は次のメッセージを出力します。

結果ファイルの場合
KAVU4296-Eメッセージ

転送ファイルの場合
KAVU2244-Eメッセージ

2

ファイル受信サイズの上限値をチェックし，上限値に達した場合はファイルの受信処理を中止して，ジョブの状態を変更します。

結果ファイルは，ファイルサイズの上限値（LimitReceiveFileSize）まで受信し，上限値を超えたデータを破棄して，終了状態を「警告検出終了」にします。ただし，エージェントホストでのジョブの状態が「異常検出終了」だった場合はその状態を引き継ぎます。転送ファイルはすべてのファイルデータを受信しないで，終了状態を「起動失敗」にします。終了コードと状態については，「(4) ファイル受信サイズが上限値を超えた場合の動作」を参照してください。

上限値に達した場合は次のメッセージを出力します。

結果ファイルの場合
KAVU4295-Wメッセージ

転送ファイルの場合
KAVU2244-Eメッセージ

3

ファイル受信サイズの上限値をチェックし，上限値に達した場合はファイルの受信処理を中止します。

結果ファイルは，ファイルサイズの上限値（LimitReceiveFileSize）まで受信し，上限値を超えたデータを破棄します。転送ファイルはすべてのファイルデータを破棄します。ジョブの終了状態は，エージェントホストでの終了状態を引き継ぎます。終了コードと状態については，「(4) ファイル受信サイズが上限値を超えた場合の動作」を参照してください。

上限値に達した場合は次のメッセージを出力します。

結果ファイルの場合
KAVU4294-Iメッセージ

転送ファイルの場合
KAVU2243-Iメッセージ

この指定をした場合，制限を超えてもジョブは正常に終了します。しかし，ファイルが完全に作成された状態ではないため，後続ジョブなどでファイルを参照する場合は，不完全なファイルでも問題ないことを確認して使用してください。

"LimitReceiveFileSize"=dword:ファイルサイズの上限値

ファイル受信サイズの上限値を16進数で指定します。

指定できる範囲は80000～40000000（10進数で524,288～1,073,741,824）（単位：バイト）です。

デフォルトは「500000」（10進数で5,242,880）です。

ジョブ実行時に使用する転送ファイルや結果ファイルのサイズが運用上の見積もり値を超えたときに，マネージャーホスト側で受信するファイルのサイズを制限します。運用に合わせて5メガバイト程度で上限値を設定することをお勧めします。

この設定は，一回に送信する転送ファイルが複数ある場合，それらのファイルサイズを合計した値に対して上限値をチェックします。結果ファイルの場合は，標準出力ファイルと標準エラー出力ファイルのサイズを合計した値でチェックします。

なお，上限値に対して±数百バイト程度の範囲で誤差が生じることがあります。

ファイルサイズの見積もり方法を次に示します（単位：バイト）

ファイル数
　Σ（ファイル名長＋ファイルサイズ＋（12＊ファイル行数）＋100）

注

この設定は8000単位（10進数で32,768）で切り上げて設定されます。例えば，80001（10進数で524,289）を指定した場合，有効になる値は88000（10進数で557,056）になります。

アクションジョブについては，JP1/AJS2が出力する情報としては指定できる範囲の下限値（524,288バイト）を超えて出力されません。ただし，UNIX上で実行したときに，システムやジョブ実行OSユーザーのログインスクリプトで標準エラー出力を出力した場合は，下限値を超えることがあります。

(4)　ファイル受信サイズが上限値を超えた場合の動作

ファイル受信サイズが上限値を超えたときの動作を次に示します。

結果ファイル

環境設定パラメーターReceiveFileSizeStatusの値を1，2，3のどれかで指定しているときに，受信サイズの上限値に達した場合，標準出力ファイル，標準エラー出力ファイルは上限値のサイズまでマネージャーホスト側に残ります。結果ファイルは完全に作成された状態ではないため，後続ジョブなどで結果ファイルを参照する場合は，不完全なファイルでも問題がないことを確認して使用してください。

結果ファイルのサイズが上限値を超えた場合のジョブの終了コードおよび終了状態を次の表に示します。

表7-18　結果ファイルサイズが上限値を超えた場合の終了状態と終了コードの関係

実際のジョブの状態
設定項目
ReceiveFileSizeStatus定義パラメーターの指定

1
2
0または3

正常終了
（常に正常を指定した場合も含む）
状態
異常検出終了
警告検出終了
正常終了

終了コード
ジョブの戻り値※
ジョブの戻り値※
ジョブの戻り値※

警告検出終了
状態
異常検出終了
警告検出終了
警告検出終了

終了コード
ジョブの戻り値※
ジョブの戻り値※
ジョブの戻り値※

異常検出終了
状態
異常検出終了
異常検出終了
異常検出終了

終了コード
ジョブの戻り値※
ジョブの戻り値※
ジョブの戻り値※

強制終了
状態
強制終了
強制終了
強制終了

終了コード
PCジョブ（-1），
UNIXジョブ（255）
PCジョブ（-1），
UNIXジョブ（255）
PCジョブ（-1），
UNIXジョブ（255）

起動失敗
状態
起動失敗
起動失敗
起動失敗

注※

ジョブとして実行したジョブプロセスの終了コードです。

転送ファイル

環境設定パラメーターReceiveFileSizeStatusの値を1，2，3のどれかで指定しているときに，受信サイズの上限値に達した場合，転送ファイルは受信しません。複数指定している場合はすべての転送ファイルのデータを破棄します。

転送ファイルのサイズが上限値を超えた場合のジョブの終了コードおよび終了状態を次の表に示します。

表7-19　転送ファイルサイズが上限値を超えた場合の終了状態と終了コードの関係

実際のジョブの状態
設定項目
ReceiveFileSizeStatus定義パラメーターの指定

1
2
0または3

なし※1
状態
起動失敗
起動失敗
実際のジョブの終了状態

終了コード
PCジョブ（-1），
UNIXジョブ（-1）
PCジョブ（-1），
UNIXジョブ（-1）
ジョブの戻り値※2

注※1

転送ファイルの処理はジョブが登録される際に行うため，ジョブがキューイング状態になる前のジョブの状態で「なし」となっています。

注※2

ジョブとして実行したジョブプロセスの終了コードです。

(5)　注意事項

ファイルを送受信するホストがシフトJIS以外の日本語環境の場合に，ファイル受信制限を使用すると，実際のファイルサイズと上限値として指定したサイズが異なる場合があります。

結果ファイルの受信時および転送ファイルの転送時の，ファイルサイズのチェックは，ファイルデータがシフトJISの状態で行われます。サイズチェック後に，結果ファイル受信ホストおよび転送ファイル転送先ホストで，各ホストに対応した文字コードに変換してファイルを作成します。

転送ファイルおよび結果ファイルは，対象ファイルの文字コードをシフトJISに変換してからサイズをチェックします。そのため，ファイル送信元ホストがシフトJIS以外の日本語環境の場合，シフトJISに文字コード変換を行った際に，変換後のファイルサイズが変換前のファイルサイズより小さくなる場合があります。この場合，ファイル送信元ホスト上ではファイルサイズが上限値より大きなファイルでも，ファイル受信制限が動作しません。

また，ファイルが作成されるホストがシフトJIS以外の日本語環境の場合，サイズチェック後にシフトJISからホスト上の文字コードに変換するため，チェック時のサイズより実際のファイルサイズが大きくなる場合があります。この場合，ファイル受信制限を使用し，上限値を超えるファイルを受信しないように設定しても，上限値より大きなサイズのファイルが作成されます。このように，上限値より大きなサイズのファイルが作成されることで，ディスク領域を予想以上に消費するおそれがありますので注意してください。

7.17　ジョブの結果ファイルの再送間隔・再送回数の変更

エージェントホストはジョブが終了したとき，マネージャーホストに対してジョブの結果ファイルを転送し，結果ファイルの転送が成功すると終了通知を行います。エージェントホストでは結果ファイルの転送時に一時的な通信障害などでファイルの転送に失敗したときでも，確実に終了状態を通知するために，このファイルの転送を通常は5分おきにリトライしています。一方でこの結果ファイルのサイズが大きいと，マネージャーホストではファイルの解析を行うのに非常に負荷が掛かります。通常，ファイルの転送を行ったとき，エージェントホスト側では10分間マネージャーホストからの応答がないと，タイムアウトエラーが発生したものとして結果ファイルを再送します。マネージャーホストでは結果ファイルの再送が繰り返されることによって負荷の掛かるファイル解析処理を多重に行うことになり，結果としてCPUの使用率が非常に高くなりほかの要求を受け付けられなくなるといった問題が発生します。

次の設定を行うと，結果ファイルの転送に失敗したときの，再送までの間隔を変更したり，再送する回数を制限したりすることができ，マネージャーホストに掛かる負荷を抑えることができます。

ジョブの結果ファイルの再送間隔・再送回数の設定手順を次に示します。

＜この節の構成＞

(1)　定義手順

(2)　定義パラメーター一覧

(3)　定義内容

(1)　定義手順

Windowsの［コントロールパネル］の［管理ツール］で［サービス］を選択し，次に示すサービスを停止する。

JP1/AJS2サービス

JP1/AJS2 Monitorサービス

メモ帳などのテキストエディターで，「(2) 定義パラメーター一覧」の定義パラメーターを記述した設定ファイルを作成する。
設定ファイルのファイル名は任意です。

ファイルを保存し，次のコマンドを実行する。

jbssetcnf 設定ファイル名

jbssetcnfコマンドのパスは，「JP1/Baseのインストール先フォルダ¥bin¥jbssetcnf」です。
jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/AJS2を再起動する。
設定ファイルに記述した内容が反映されます。

(2)　定義パラメーター一覧

表7-20　ジョブの結果ファイルの再送間隔・再送回数定義パラメーター一覧

定義キー | 環境設定パラメーター | 定義内容
[{JP1_DEFAULT|論理ホスト名}¥JP1NBQAGENT¥Network]※ | "NotfyJobStateInterval"= | ジョブの結果ファイルの再送間隔
"NotfyJobStateCount"= | ジョブの結果ファイルの再送回数

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

(3)　定義内容

"NotfyJobStateInterval"=dword:設定値

ジョブの結果ファイルの再送間隔を16進数で指定します。

指定できる範囲は0～0x00015180（10進数で0～86,400）（単位：秒）です。最大値の0x00015180（10進数で86,400秒）は1日の秒数です。

デフォルトは「dword:0000012C」（10進数で300）で5分です。結果ファイルの再送を行わないようにするには0を指定してください。

"NotfyJobStateCount"=dword:設定値

ジョブの結果ファイルの再送回数を16進数で指定します。

指定できる範囲は1～0x00000800（10進数で1～2,048）です。

デフォルトは「dword:00000120」（10進数で288）で288回です（デフォルトでは5分間隔で24時間再送します）。

注意事項

NotfyJobStateIntervalに0を指定した場合は，結果ファイルの再送は行いません。このため，結果ファイルの転送に失敗するとジョブの終了通知を行わなくなり，マネージャーホスト側からのジョブ状態監視処理によってジョブの終了を検知します。ジョブ状態監視処理は通常5分間隔のポーリングで行っているため，ジョブの終了検知が遅れることがあります。

また次の場合は，エージェントホスト上のジョブの終了情報が削除されるため，マネージャーホスト上の統合トレースログに「KAVU4597-W　エージェント（エージェントホスト名）で消失したジョブを強制終了します」メッセージが出力されて，ジョブの状態は強制終了となります。

NotfyJobStateCountの上限値まで再送を繰り返し，最終的に結果ファイルの転送が失敗したとき

マネージャーホストからのジョブの状態確認が行われる前にエージェントホストのJP1/AJS2サービスが停止したとき

7.18　ジョブ結果ファイルの二重受信防止の設定

標準ジョブまたはアクションジョブを実行する際，ジョブの終了時にエージェントホストからマネージャーホストに対して結果ファイル（標準出力・標準エラー出力ファイル）を転送します。エージェントホストからファイルの転送を行う際は，通常，マネージャーホストからの応答を10分間待ちますが，ファイルサイズが大きい場合は，マネージャーホストでのファイル解析に時間が掛かり，応答のタイムアウトが発生します。この場合，エージェントホストでは結果ファイルの転送が成功するまで再送を繰り返します。マネージャーホストでは結果ファイルの再送を受け付けると，負荷の掛かる解析処理を多重に行うことになりCPUの使用率が非常に高くなり，他の要求を受け付けられなくなるといった問題が発生します。

次のオプションを指定すると，エージェントホストからの結果ファイルの再送を受け付けなくなり，マネージャーホストに掛かる負荷を抑えることができます。また，結果ファイルの再送を行うかどうかはエージェントホスト側でも設定することもできます。その場合はエージェントホストごとに設定する必要があり，エージェント台数が多数あるような大規模な運用には向きません。エージェントホスト側での設定に関しては，「7.17 ジョブの結果ファイルの再送間隔・再送回数の変更」も参照してください。

次のオプションでは，マネージャーホスト側だけの設定で一括して再送を防止できます。ジョブ結果ファイルの二重受信防止の設定手順を次に示します。

＜この節の構成＞

(1)　定義手順

(2)　定義パラメーター一覧

(3)　定義内容

(1)　定義手順

Windowsの［コントロールパネル］の［管理ツール］で［サービス］を選択し，次に示すサービスを停止する。

JP1/AJS2サービス

JP1/AJS2 Monitorサービス

メモ帳などのテキストエディターで，「(2) 定義パラメーター一覧」の定義パラメーターを記述した設定ファイルを作成する。
設定ファイルのファイル名は任意です。

ファイルを保存し，次のコマンドを実行する。

jbssetcnf 設定ファイル名

jbssetcnfコマンドのパスは，「JP1/Baseのインストール先フォルダ¥bin¥jbssetcnf」です。
jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/AJS2を再起動する。
設定ファイルに記述した内容が反映されます。

(2)　定義パラメーター一覧

表7-21　ジョブ結果ファイルの二重受信防止定義パラメーター一覧

定義キー | 環境設定パラメーター | 定義内容
[{JP1_DEFAULT|論理ホスト名}¥JP1NBQMANAGER¥Job]※ | "ReceiveFileOption"= | ジョブ結果ファイルの二重受信防止の定義

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

(3)　定義内容

"ReceiveFileOption"=dword:00000000|00000001

ジョブ結果ファイルの二重受信防止を行うかどうかを指定します。

0

ジョブ結果ファイルの二重受信防止を行いません。

1

ジョブ結果ファイルの二重受信防止を行います。

デフォルトは「0」です。

7.19　TCP/IP通信接続エラーのリトライ間隔・回数の変更

ジョブ実行制御ではジョブの登録，ジョブの配信，ジョブの状態通知，ジョブの状態確認またはエージェントホストの状態確認を行う際，プロセス間で情報を受け渡すためにTCP/IP通信を使用しています。接続先のマシンが起動していない場合やネットワーク障害が発生している場合，TCP/IP通信の接続エラーが発生します。

このとき，ジョブ実行制御のTCP/IP通信処理では，最初の接続要求に対して通信相手から応答がなかった場合に最大で90秒待ち，そのあと，20秒の間隔を置いて再接続を試みるリトライを2回行います。このため，リトライがすべて失敗し最終的に接続エラーとなるまでにおよそ4～5分が掛かることがあります。

ジョブの登録，ジョブの配信，ジョブの状態通知，ジョブの状態確認またはエージェントホストの状態確認を行う際に通信障害が発生すると，その検知に遅れが生じることがあります。障害の検知が遅れることによって，結果的にジョブの状態を変更するまでの時間が遅れることになります。

TCP/IP通信の接続エラーが頻繁に発生する場合は，接続タイムアウト時間，リトライ回数，リトライ間隔を短く設定変更することで，障害状態をより早く検知できます。

表7-22　値を変更する定義キー

定義キー | 使用目的
JP1NBQMANAGER¥Network | ジョブの配信，ジョブの状態確認，ジョブの状態通知，エージェントホストの状態確認（障害回復の検知）
JP1NBQAGENT¥Network | ジョブの状態通知
JP1NBQCLIENT¥Network | スケジュール制御からのジョブの登録，ジョブ実行に使用するコマンド
JP1NBQNOTIFY¥Network | 他システム（JP1/NQSEXECやJP1/OJEなど）のジョブの状態確認，および状態通知

ジョブ実行制御の接続タイムアウト，リトライ間隔・回数の設定手順を次に示します。

＜この節の構成＞

(1)　定義手順

(2)　定義パラメーター一覧

(3)　定義内容

(1)　定義手順

Windowsの［コントロールパネル］の［管理ツール］で［サービス］を選択し，次に示すサービスを停止する。

JP1/AJS2サービス

メモ帳などのテキストエディターで，「(2) 定義パラメーター一覧」の定義パラメーターを記述した設定ファイルを作成する。
設定ファイルのファイル名は任意です。

ファイルを保存し，次のコマンドを実行する。

jbssetcnf 設定ファイル名

jbssetcnfコマンドのパスは，「JP1/Baseのインストール先フォルダ¥bin¥jbssetcnf」です。
jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/AJS2を再起動する。
設定ファイルに記述した内容が反映されます。

(2)　定義パラメーター一覧

表7-23　ジョブ実行制御のTCP/IP通信定義パラメーター一覧

定義キー | 環境設定パラメーター | 定義内容
[{JP1_DEFAULT|論理ホスト名}¥JP1NBQMANAGER¥Network]※ | "ConnectTimeout"= | ジョブ実行制御マネージャーのTCP/IP通信接続タイムアウト値の定義（単位：ミリ秒）
"CommunicateRetryCount"= | ジョブ実行制御マネージャーのTCP/IP通信接続エラーのリトライ回数の定義
"CommunicateRetryInterval"= | ジョブ実行制御マネージャーのTCP/IP通信接続エラーのリトライ間隔の定義（単位：秒）
[{JP1_DEFAULT|論理ホスト名}¥JP1NBQAGENT¥Network]※ | "ConnectTimeout"= | ジョブ実行制御エージェントのTCP/IP通信接続タイムアウト値の定義（単位：ミリ秒）
"CommunicateRetryCount"= | ジョブ実行制御エージェントのTCP/IP通信接続エラーのリトライ回数の定義
"CommunicateRetryInterval"= | ジョブ実行制御エージェントのTCP/IP通信接続エラーのリトライ間隔の定義（単位：秒）
[{JP1_DEFAULT|論理ホスト名}¥JP1NBQCLIENT¥Network]※ | "ConnectTimeout"= | ジョブ実行に使用するコマンドおよびスケジュール制御のTCP/IP通信接続タイムアウト値の定義（単位：ミリ秒）
"CommunicateRetryCount"= | ジョブ実行に使用するコマンドおよびスケジュール制御のTCP/IP通信接続エラーのリトライ回数の定義
"CommunicateRetryInterval"= | ジョブ実行に使用するコマンドおよびスケジュール制御のTCP/IP通信接続エラーのリトライ間隔の定義（単位：秒）
[{JP1_DEFAULT|論理ホスト名}¥JP1NBQNOTIFY¥Network]※ | "ConnectTimeout"= | ジョブ実行制御状態通知プロセスのTCP/IP通信接続タイムアウト値の定義（単位：ミリ秒）
"CommunicateRetryCount"= | ジョブ実行制御状態通知プロセスのTCP/IP通信接続エラーのリトライ回数の定義
"CommunicateRetryInterval"= | ジョブ実行制御状態通知プロセスのTCP/IP通信接続エラーのリトライ間隔の定義（単位：秒）

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

(3)　定義内容

"ConnectTimeout"=dword:設定値

TCP/IP通信の接続タイムアウト値を16進数で指定します。

指定できる範囲は00002710～000927C0（10進数で10,000～600,000）（単位：ミリ秒）です。

デフォルトは「dword:00015F90」（10進数で90,000）で90秒です。

"CommunicateRetryCount"=dword:設定値

TCP/IP通信の接続エラーのリトライ回数を16進数で指定します。

指定できる範囲は00000000～00000064（10進数で0～100）です。

デフォルトは「dword:00000002」（10進数で2）です。

"CommunicateRetryInterval"=dword:設定値

TCP/IP通信の接続エラーのリトライ間隔を16進数で指定します。

指定できる範囲は00000001～0000012C（10進数で1～300）（単位：秒）です。

デフォルトは「dword:00000014」（10進数で20）です。

注意事項

接続タイムアウト，リトライ回数，リトライ間隔の値を小さくし過ぎると，通信のリトライ間隔が短くなるため，通信障害が回避できなくなり，TCP/IP通信の接続エラーが頻繁に発生することがありますので注意してください。

また，オペレーティングシステムの接続タイムアウト仕様とその設定によって，ConnectTimeoutに設定した値より前に接続のタイムアウトが発生することがあります。

7.20　ジョブを配信するエージェントホストの決定方式の設定

ジョブを配信する際に，優先順位とエージェント使用率が同一のエージェントホストが複数ある場合，デフォルトではエージェントID※の大きいエージェントホストを選択してジョブを配信します。

例えば，実行時間が非常に短いジョブを複数実行する場合，ジョブはすぐに終了するためエージェント使用率はなかなか上昇せず，ジョブが配信されていないエージェントホストとエージェント使用率を比較した際に差異が出にくくなります。結果として，エージェントIDの大きい方に偏ってジョブを配信するため，エージェントIDの大きいエージェントで実行するジョブ数が多くなり，システムの使用率に偏りが生じることになります。

このような場合に，エージェントIDの代わりに未使用時間が最も長いエージェントホストを選択してジョブを配信する方式を設定することで，均等に負荷分散を行うことができます。

注※

エージェントIDはjpqimportコマンドでジョブ実行環境構成定義ファイル（jpqsetup.conf）に指定したものです。また，jpqagtaddコマンドでエージェントを追加した場合は，使用していない番号から昇順に付加されます。jpqagtshowコマンドでエージェントの一覧を表示するとエージェントIDの昇順で表示されます。

ジョブを配信するエージェントホストの決定方式を設定するための手順を次に示します。

＜この節の構成＞

(1)　定義手順

(2)　定義パラメーター一覧

(3)　定義内容

(1)　定義手順

Windowsの［コントロールパネル］の［管理ツール］で［サービス］を選択し，次に示すサービスを停止する。

JP1/AJS2サービス

メモ帳などのテキストエディターで，「(2) 定義パラメーター一覧」の定義パラメーターを記述した設定ファイルを作成する。
設定ファイルのファイル名は任意です。

ファイルを保存し，次のコマンドを実行する。

jbssetcnf 設定ファイル名

jbssetcnfコマンドのパスは，「JP1/Baseのインストール先フォルダ¥bin¥jbssetcnf」です。
jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/AJS2を再起動する。
設定ファイルに記述した内容が反映されます。

(2)　定義パラメーター一覧

表7-24　ジョブを配信するエージェントホストの決定方式定義パラメーター一覧

定義キー | 環境設定パラメーター | 定義内容
[{JP1_DEFAULT|論理ホスト名}¥JP1NBQMANAGER¥Agent]※ | "LeastRecentlyUsed"= | ジョブを配信するエージェントホストの決定方式の定義

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

(3)　定義内容

"LeastRecentlyUsed"=dword:設定値

ジョブを配信するエージェントホストの決定方式を指定します。

0

複数の接続エージェントが同じ優先順位で，さらにエージェント使用率が同じであった場合に，エージェントIDが大きいものをジョブの配信先エージェントホストに決定します。

1

複数の接続エージェントが同じ優先順位で，さらにエージェント使用率が同じであった場合に，ジョブを最後に配信してから最も未使用時間が長いエージェントホストをジョブの配信先エージェントホストに決定します。

デフォルトは「0」です。

7.21　マクロ変数の展開失敗時の動作の設定

ジョブの実行時にマクロ変数の引き継ぎ情報の展開が失敗した場合，そのジョブネットの状態を「起動失敗」にするか，マクロ変数を文字列として扱いそのままジョブネットを実行させるかを設定できます。

ジョブ実行時にマクロ変数の引き継ぎに失敗した場合の動作を設定するための方法を次に示します。

＜この節の構成＞

(1)　定義手順

(2)　定義パラメーター一覧

(3)　定義内容

(1)　定義手順

Windowsの［コントロールパネル］の［管理ツール］で［サービス］を選択し，次に示すサービスを停止する。

JP1/AJS2 サービス

JP1/AJS2 Monitor サービス

メモ帳などのテキストエディターで，「(2) 定義パラメーター一覧」の定義パラメーターを記述した設定ファイルを作成する。
設定ファイルのファイル名は任意です。

ファイルを保存し，次のコマンドを実行する。

jbssetcnf 設定ファイル名

jbssetcnfコマンドのパスは，「JP1/Baseのインストール先フォルダ¥bin¥jbssetcnf」です。
jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/AJS2を再起動する。
設定ファイルに記述した内容が反映されます。

(2)　定義パラメーター一覧

表7-25　実行登録時にマクロ変数値を指定するための定義パラメーター

定義キー | 環境設定パラメーター | 定義内容
[{JP1_DEFAULT|論理ホスト名}¥JP1AJS2COMMON]※ | "MACROCHANGEFAIL"= | イベントジョブ，および実行登録時に指定したマクロ変数の展開失敗時の動作

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

(3)　定義内容

"MACROCHANGEFAIL"="{yes|no}"

ジョブ実行時，マクロ変数の引き継ぎ情報の展開に失敗した場合に，状態を「起動失敗」にするかどうかを指定します。

yes

ジョブ実行時，マクロ変数の引き継ぎ情報の展開に失敗した場合に，状態を「起動失敗」にし，展開に失敗したマクロ変数が確認できるエラーメッセージを日立統合ログおよび実行結果詳細に出力します。

no

ジョブ実行時，マクロ変数の引き継ぎ情報の展開に失敗しても，マクロ変数に定義した情報をそのまま文字列として扱い，処理を続行します。

デフォルトは「no」です。

7.22　マクロ変数の引き継ぎ情報がNULL文字列の場合の置き換え方法の設定

マクロ変数の引き継ぎ情報は，イベントジョブで受信したイベント情報やJP1/AJS2 - Scenario Operationとの連携機能を使用している場合の定義情報として使用します。マクロ変数の詳細については，マニュアル「JP1/Automatic Job Management System 2 解説　4.1.2 実行登録時のマクロ変数値の指定」を参照してください。また，イベントジョブでのマクロ変数の定義例については，マニュアル「JP1/Automatic Job Management System 2 解説　3.2.4(6) イベントジョブの受信情報の引き継ぎ」を参照してください。

マクロ変数として引き継いだ情報がNULL文字列のときに，マクロ変数の前後に文字列がなくマクロ変数だけを指定している場合，次に示す2種類の動作が選択できます。

マクロ変数名をそのまま文字列として扱う（デフォルトの動作）

NULL文字列に置き換える

それぞれの動作を次に示します。

マクロ変数名を文字列として扱う場合

引き継ぎ情報がNULL文字列でマクロ変数の前後に文字列がない場合
［?AJS2（マクロ変数名）?］→［?AJS2（マクロ変数名）?］

引き継ぎ情報がNULL文字列でマクロ変数の前後に文字列がある場合
［aaa?AJS2（マクロ変数名）?bbb］→［aaabbb］
［ccc?AJS2（マクロ変数名）?］→［ccc］
［?AJS2（マクロ変数名）?ddd］→［ddd］

NULL文字列に置き換える場合

引き継ぎ情報がNULL文字列でマクロ変数の前後に文字列がない場合
［?AJS2（マクロ変数名）?］→［］

引き継ぎ情報がNULL文字列でマクロ変数の前後に文字列がある場合
［aaa?AJS2（マクロ変数名）?bbb］→［aaabbb］
［ccc?AJS2（マクロ変数名）?］→［ccc］
［?AJS2（マクロ変数名）?ddd］→［ddd］

この設定は，実行先サービスに「JP1/AJS2」を指定したジョブが対象です。実行先サービスに「JP1/AJS2 Queueless Agent」を指定した場合，オプションの設定とは関係なくマクロ変数名をNULL文字列に置き換えます。また，この設定は，JP1/AJS2 07-11以前からマクロ変数を指定できる次の定義項目にだけ有効です。

UNIXジョブ

コマンド文

スクリプトファイル名

パラメーター

環境変数

PCジョブ

実行ファイル名

パラメーター

環境変数

JP1/AJS2 07-50以降で，JP1/AJS2 - Scenario Operationと連携するために新たに指定できる項目となった定義項目では，オプションの設定とは関係なくマクロ変数名をNULL文字列に置き換えます。マクロ変数名を文字列として扱う設定（デフォルトの動作）の場合，07-11以前からの定義項目と07-50以降で追加された定義項目とでは，置き換えたあとの結果が異なります。

文字列として扱う指定（デフォルトの動作）の場合の例

07-11以前からの定義項目：［?AJS2AAA?］→［?AJS2AAA?］

07-50以降で追加された定義項目：［?AJS2AAA?］→［］

JP1/AJS2 - Scenario Operationとの連携機能を使用している場合に，07-11以前からの定義項目と，07-50以降で追加された定義項目の動作を合わせる必要がある場合は，マクロ変数名をNULL文字列に置き換えるように設定してください。

なお，マクロ変数の前後に必ず文字列を指定する運用の場合，またはマクロ変数名がそのまま文字列に置き換わることを期待する運用の場合，設定の必要はありません。

マクロ変数の引き継ぎ情報がNULL文字列の場合の置き換え方法の設定手順を次に示します。

＜この節の構成＞

(1)　定義手順

(2)　定義パラメーター一覧

(3)　定義内容

(1)　定義手順

Windowsの［コントロールパネル］の［管理ツール］で［サービス］を選択し，次に示すサービスを停止する。

JP1/AJS2サービス

メモ帳などのテキストエディターで，「(2) 定義パラメーター一覧」の定義パラメーターを記述した設定ファイルを作成する。
設定ファイルのファイル名は任意です。

ファイルを保存し，次のコマンドを実行する。

jbssetcnf 設定ファイル名

jbssetcnfコマンドのパスは，「JP1/Baseのインストール先フォルダ¥bin¥jbssetcnf」です。
jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/AJS2を再起動する。
設定ファイルに記述した内容が反映されます。

(2)　定義パラメーター一覧

表7-26　マクロ変数の引き継ぎ情報がNULL文字列の場合の置き換え方法の定義パラメーター

定義キー | 環境設定パラメーター | 定義内容
[{JP1_DEFAULT|論理ホスト名}¥JP1NBQCLIENT¥Process]※ | "MacroOptionReplaceMode"= | マクロ変数の引き継ぎ情報がNULL文字列の場合の置き換え方法の設定

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

(3)　定義内容

"MacroOptionReplaceMode"=dword:設定値

前後に文字列がないマクロ変数の引き継ぎ情報がNULL文字列の場合に，マクロ変数名をNULL文字列に置き換えるかどうかを指定します。

0

マクロ変数名をNULL文字列に置き換えないで，指定されたマクロ変数名をそのままの文字列として使用する場合に指定します。JP1/AJS2 07-11以前からの動作と同じです。

1

マクロ変数名をNULL文字列に置き換える場合に指定します。

デフォルトは「0」です。

7.23　ファイルおよびフォルダの変更方法

JP1/AJS2が使用するファイルおよびフォルダのうち，環境設定パラメーターに定義内容を公開しているものは，すべて変更できます。

変更手順を次に示します。

＜この節の構成＞

(1)　変更手順

(2)　定義パラメーターおよび定義内容

(1)　変更手順

JP1/AJS2サービスをいったん停止し，コールドスタートする。
なお，新規構築時のパラメーター変更の場合は，JP1/AJS2サービスのコールドスタートは不要です。

JP1/AJS2サービス，JP1/AJS2 MonitorサービスおよびJP1/AJS2 Console Agentサービスを停止する。

jbsgetcnfコマンドで，現在の定義情報を出力する。

出力したファイル中の必要なファイルおよびフォルダ定義について，環境設定パラメーターをエディターで変更する。

変更例

"AJSLOGFILE1"="c:¥home1¥jp1ajs2¥log¥ajs-log1.log"

"AJSLOGFILE2"="c:¥home1¥jp1ajs2¥log¥ajs-log2.log"

"AJSDBDIRECTORY"="c:¥home2¥jp1ajs2¥database¥schedule¥AJSROOT1"

"DatabasePath"="c:¥home2¥jp1ajs2¥database¥queue"

jbssetcnfコマンドで編集したファイルを指定し，変更内容を反映させる。

手順4で環境設定パラメーターに設定したフォルダを作成する。

変更前のフォルダにあったファイルを手順6で作成したフォルダへそれぞれ移動させる。

手順2で停止したサービスを起動する。

なお，作成したフォルダと移動したファイルの所有者や権限は，移動前のものと同じ状態にしてください。

(2)　定義パラメーターおよび定義内容

変更できる定義パラメーターと定義内容については，「14. 環境設定」を参照してください。

7.24　エージェントの障害回復待ち時間を短縮する設定方法

JP1/AJS2では，ジョブ（キューレスジョブを除くPCジョブ・UNIXジョブ，JP1/AJS2上で実行するQUEUEジョブ，アクションジョブ，およびカスタムジョブ）の実行ホスト（エージェントホスト）が障害状態になった場合や通信障害が発生した場合，即時に異常検知とはしないで，ある程度の待ち時間を設けて通信リトライすることで，エージェントホスト上のシステム障害や通信障害状態が回復するのを待ちます。これによって，一時的な障害による，回復可能な業務停止を防止しています。通常，障害回復待ち時間はデフォルトで10分です。

ただし，運用によっては障害が発生した場合は回復を待つことよりも，直ちに異常を検知して早急なリカバリーを優先させる場合があります。その場合は障害回復待ち時間を短縮することで，早急な障害検知ができます。

エージェントホストの障害回復待ち時間を短縮する設定方法について次に説明します。

＜この節の構成＞

(1)　定義手順

(2)　定義パラメーター一覧

(3)　定義内容

(1)　定義手順

Windowsの［コントロールパネル］の［管理ツール］で［サービス］を選択し，次に示すサービスを停止する。

JP1/AJS2サービス

メモ帳などのテキストエディターで，「(2) 定義パラメーター一覧」の定義パラメーターを記述した設定ファイルを作成する。
設定ファイルのファイル名は任意です。

ファイルを保存し，次のコマンドを実行する。

jbssetcnf 設定ファイル名

jbssetcnfコマンドのパスは，「JP1/Baseのインストール先フォルダ¥bin¥jbssetcnf」です。
jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/AJS2を再起動する。
設定ファイルに記述した内容が反映されます。

(2)　定義パラメーター一覧

表7-27　エージェントの障害回復待ち時間の設定のための定義パラメーター一覧

定義キー | 環境設定パラメーター | 定義内容
[{JP1_DEFAULT|論理ホスト名}¥JP1NBQMANAGER¥Job]※ | "QueuingJobRecoveryTime"= | キューイング中のジョブに対するエージェントの障害回復待ち時間（単位：秒）
[{JP1_DEFAULT|論理ホスト名}¥JP1NBQMANAGER¥Job]※ | "ExecutingJobRecoveryTime"= | 実行中のジョブに対するエージェントの障害回復待ち時間（単位：秒）

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

(3)　定義内容

"QueuingJobRecoveryTime"=dword:設定値

キューイング中のジョブに対するエージェントの障害回復待ち時間を16進数で指定します。

指定できる範囲は0000001E～00000E10（10進数で30～3600）（単位：秒）です。※

デフォルトは「00000258」（10進数で600）で10分です。

注※

ジョブが実行されていない時間帯は，ジョブの異常を数十秒の間隔で監視しているため，ジョブの異常検知が数十秒遅れる場合があります。

"ExecutingJobRecoveryTime"=dword:設定値

実行中のジョブに対するエージェントの障害回復待ち時間を16進数で指定します。

指定できる範囲は0000001E～00000E10（10進数で30～3600）（単位：秒）です。

デフォルトは「00000258」（10進数で600）で10分です。※

注※

デフォルトの動作では，ジョブの異常検知までに実行中のジョブの状態確認を最大で3回実行します。また，実行中のジョブに対するエージェントの障害回復待ち時間をエージェント監視インターバル未満に設定した場合は，実行中のジョブの状態確認を実行する前に障害回復待ち時間に到達するため，実行中のジョブの状態確認を最大で2回実行します。障害検知までの合計時間の内訳は次のようになります。

障害検知までの合計時間 ≒
　(エージェント監視インターバル ＊ 1回)
　＋ (通信時間 ＊ 2回)
　＋ 障害発生時間から最初の状態確認までの時間

また， エージェント監視インターバル，TCP/IP通信接続エラーのリトライ間隔，リトライ回数を短く変更すると，障害検知までの合計時間はさらに短くなります。エージェント監視インターバルの設定については，「4.2.1 マネージャー環境の設定」を参照してください。TCP/IP通信接続エラーのリトライ間隔，およびリトライ回数の設定の詳細については，「7.19 TCP/IP通信接続エラーのリトライ間隔・回数の変更」を参照してください。

エージェント監視インターバルを使用したポーリングはエージェントホストごとに行います。したがって，エージェント監視インターバルの設定値を短くしてポーリング回数が増えるとエージェントホスト数に比例して通信回数が増えますので，設定を変更する場合は十分に注意してください。また，TCP/IP通信接続エラーのリトライ間隔，リトライ回数を変更する際にも注意事項を十分に確認してください。

7.25　新規インストール後に以前のバージョンの設定に戻す方法

JP1/AJS2 - Manager 08-00以降，またはJP1/AJS2 - Agent 08-00以降を新規にインストールする場合，08-00より前のバージョンと動作環境の設定が異なります。このため，08-00より前のバージョンのJP1/AJS2と混在させて動作させるような場合，08-00より前のバージョンの動作環境の設定に戻し，統一した動作環境で動作させることができます。

＜この節の構成＞

7.25.1　JP1/AJS2 - Managerの設定を以前のバージョンの設定に戻す

7.25.2　JP1/AJS2 - Agentの設定を以前のバージョンの設定に戻す

7.25.1　JP1/AJS2 - Managerの設定を以前のバージョンの設定に戻す

新規にインストールしたJP1/AJS2 - Manager 08-00以降の設定を08-00より前のバージョンの設定に戻す手順を次に示します。

Windowsの［コントロールパネル］の［管理ツール］で［サービス］を選択し，次に示すサービスを停止する。

JP1/AJS2 サービス

JP1/AJS2 Monitor サービス

次のファイルをコピーしてajs2_0750.confを作成する。
JP1/AJS2 - Managerのインストール先フォルダ¥conf¥ajs2_0750.conf.model

ajs2_0750.confをメモ帳などのテキストエディターで開き，必要に応じて次の項目を編集する。

論理ホスト名

スケジューラーサービス名

ファイルを保存し，次のコマンドを実行する。

jbssetcnf 保存先フォルダ¥ajs2_0750.conf

jbssetcnfコマンドのパスは，「JP1/Baseのインストール先フォルダ¥bin¥jbssetcnf」です。
jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/AJS2を再起動する。
08-00より前のバージョンの設定に戻ります。

7.25.2　JP1/AJS2 - Agentの設定を以前のバージョンの設定に戻す

新規にインストールしたJP1/AJS2 - Agent 08-00以降の設定を08-00より前のバージョンの設定に戻す手順を次に示します。

Windowsの［コントロールパネル］の［管理ツール］で［サービス］を選択し，次に示すサービスを停止する。

JP1/AJS2 サービス

次のファイルをコピーしてajs2_0750.confを作成する。
JP1/AJS2 - Agentのインストール先フォルダ¥conf¥ajs2_0750.conf.model

ajs2_0750.confをメモ帳などのテキストエディターで開き，必要に応じて次の項目を編集する。

論理ホスト名

スケジューラーサービス名

ファイルを保存し，次のコマンドを実行する。

jbssetcnf 保存先フォルダ¥ajs2_0750.conf

jbssetcnfコマンドのパスは，「JP1/Baseのインストール先フォルダ¥bin¥jbssetcnf」です。
jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/AJS2を再起動する。
08-00より前のバージョンの設定に戻ります。

7.26　ジョブ実行時にアクセストークンを再利用するための設定

ジョブ実行時にアクセストークンを再利用するための設定手順を次に示します。この設定はジョブの実行先ホスト上で行ってください。詳細については，マニュアル「JP1/Automatic Job Management System 2 設計・運用ガイド　8.2.3 ジョブ実行時のユーザーアカウント」を参照してください。

なお，この設定はキューレスジョブは対象外です。

＜この節の構成＞

(1)　定義手順

(2)　定義パラメーター一覧

(3)　定義内容

(4)　注意事項

(1)　定義手順

Windowsの［コントロールパネル］の［管理ツール］で［サービス］を選択し，次に示すサービスを停止する。

JP1/AJS2サービス

注意事項

クラスタシステムの場合は，クラスタの設定を確認し，論理ホストのJP1/AJS2サービスも停止してください。

メモ帳などのテキストエディターで，「(2) 定義パラメーター一覧」の定義パラメーターを記述した設定ファイルを作成する。
設定ファイルのファイル名は任意です。

ファイルを保存し，次のコマンドを実行する。

jbssetcnf 設定ファイル名

jbssetcnfコマンドのパスは，「JP1/Baseのインストール先フォルダ¥bin¥jbssetcnf」です。
jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/AJS2を再起動する。
設定ファイルに記述した内容が反映されます。

(2)　定義パラメーター一覧

表7-28　ジョブ実行時にアクセストークンを再利用する設定のための定義パラメーター

定義キー | 環境設定パラメーター | 定義内容
[{JP1_DEFAULT|論理ホスト名}¥JP1NBQAGENT¥Job]※ | "IsAccessTokenCache"= | ジョブ実行時にアクセストークンを再利用するための設定

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

(3)　定義内容

"IsAccessTokenCache"=dword:設定値

ジョブ実行時にアクセストークンを再利用するかどうかを指定します。

0

ジョブを実行するごとに，アクセストークンを取得し，実行終了後に解放します。

1

ジョブ実行時に「ユーザー名」，「ドメイン名」，「パスワード」が同一のアクセストークンが保存されている場合，アクセストークンを再利用してジョブを実行します。

アクセストークンを取得するとき，デスクトップヒープ領域が必要になります。この設定を行うと，すべてのジョブはJP1/AJS2サービス起動時に取得した一つのデスクトップヒープ領域を共有して使用します。

また，JP1/AJS2サービスを起動したユーザーと異なるユーザーでジョブを実行した場合は，新たに一つのデスクトップヒープ領域を作成し，サービスを起動したユーザーと異なるユーザーのジョブはすべてその一つのデスクトップヒープ領域を共有して使用します。

2

ジョブ実行時に「ユーザー名」，「ドメイン名」，「パスワード」が同一のアクセストークンが保存されている場合，アクセストークンを再利用してジョブを実行します。

アクセストークンを取得するとき，デスクトップヒープ領域が必要になります。この設定を行うと，ジョブを起動するときにジョブを実行するOSユーザーごとにデスクトップヒープ領域を作成して使用します。

デフォルトは「0」です。

(4)　注意事項

アクセストークンを再利用する設定にしたとき，次に示す場合にアクセストークンを解放します。

ジョブ実行OSユーザーのパスワードを変更した場合
ジョブ実行OSユーザーのパスワードを変更した場合は，パスワードを変更したユーザーのアクセストークンを解放し，新しいユーザー情報でアクセストークンを取得します。
注意事項
OSが管理するパスワード情報を変更した場合，JP1/Baseのユーザーマッピングで設定したOSユーザーのパスワード管理情報も変更する必要があります。JP1/Baseのユーザーマッピングで設定したOSユーザーのパスワード管理情報を変更しなかった場合は，パスワードを変更する前のアクセストークンを再利用してジョブを起動します。JP1/Baseのユーザー管理機能の設定をする際の注意事項については，マニュアル「JP1/Base 運用ガイド」のユーザー管理機能に関する注意事項が記載されている章を参照してください。

JP1/AJS2サービスを停止した場合
JP1/AJS2サービスを停止した場合は，保持しているすべてのユーザーのアクセストークンを解放します。

IsAccessTokenCacheが1の場合は，すべてのジョブはJP1/AJS2サービス起動時に取得した一つのデスクトップヒープ領域を共有して使用します。このため，同時実行するジョブ数が多いと，確保した一つのデスクトップヒープ領域の中で領域不足が発生するおそれがあります。

IsAccessTokenCacheが2の場合は，ユーザーごとにデスクトップヒープ領域を作成して使用します。例えば， 10ユーザーでジョブを実行すると，10個のデスクトップヒープ領域を作成することになります。このため，ユーザー数が多い場合は，デスクトップヒープ領域の数も多くなるため，OS全体のデスクトップヒープ領域の中で領域不足が発生するおそれがあります。

アクセストークンを再利用すると，同じユーザーが起動したジョブは最初にアクセストークンを取得した際に確保した一つのデスクトップヒープ領域を共有して使用するため，新たにデスクトップヒープ領域を作成しません。JP1/AJS2サービスの起動するユーザーをユーザーアカウントに変更し，同じユーザーでジョブを実行する場合はアクセストークンを取得しないため，新たにデスクトップヒープ領域を作成しません。JP1/AJS2のサービスのアカウントの変更については，マニュアル「JP1/Automatic Job Management System 2 設計・運用ガイド　5.2.3 JP1/AJS2のサービスの設定を変更する必要がある場合（Windows限定）」を参照してください。

7.27　ジョブ実行多重度到達を確認するメッセージを出力する設定

エージェントホストで実行中のジョブ数が，ジョブ実行多重度に達しているために後続のジョブの状態がキューイングのままとなり，ジョブが実行されるまでに時間が掛かることがあります。

ジョブ実行多重度に達しているためにジョブが登録できない場合に，次に示すメッセージを統合トレースログに出力するようにあらかじめ設定しておくことで，ジョブの実行に時間が掛かった要因がジョブ実行多重度到達であるかどうかを確認できます。

KAVU4310-I　エージェント(エージェントホスト名)で実行中のジョブ数がジョブ実行多重度（ジョブ実行多重度）に達しています（ホスト名：ホスト名，ジョブ番号：ジョブ番号）

この設定を行って，ジョブの状態がキューイングになっているにもかかわらず，このメッセージが出力されない場合は，次に示すどれかの要因が考えられますので，エージェントまたはキューの状態やジョブの実行先ホストの状態を確認してください。

ジョブ実行多重度に0が設定されている場合
jpqagtshowコマンドでジョブ実行多重度（CUREXECHGNUM）を確認してください。

キュー（デフォルトキューを含む）の設定でジョブの取出口が閉じている場合
jpqqueshowコマンドでジョブの取出口（EXITSTATUS）の状態を確認してください。

エージェントホストが停止，または障害状態になっている場合
エージェントホストでJP1/AJS2サービスが停止していないか，また，何らかの障害が発生していないかエージェントホスト上の統合トレースログを確認してください。また，マネージャーホストと通信できる状態かを確認してください。

排他実行リソースを指定したジョブでリソースの解放待ちになっている場合
jpqresshowコマンドでSTATUSがEXECUTINGになっているジョブが存在しないかを確認してください。

ジョブ実行多重度の詳細については，マニュアル「JP1/Automatic Job Management System 2 設計・運用ガイド　8.1.19 ジョブ実行多重度に関する注意事項」を参照してください。

ジョブ実行多重度到達を確認するメッセージを出力するための設定手順を次に示します。

＜この節の構成＞

(1)　定義手順

(2)　定義パラメーター一覧

(3)　定義内容

(1)　定義手順

Windowsの［コントロールパネル］の［管理ツール］で［サービス］を選択し，次に示すサービスを停止する。

JP1/AJS2サービス

注意事項

クラスタシステムの場合は，クラスタの設定を確認し，論理ホストのJP1/AJS2サービスも停止してください。

メモ帳などのテキストエディターで，「(2) 定義パラメーター一覧」の定義パラメーターを記述した設定ファイルを作成する。
設定ファイルのファイル名は任意です。

ファイルを保存し，次のコマンドを実行する。

jbssetcnf 設定ファイル名

jbssetcnfコマンドのパスは，「JP1/Baseのインストール先フォルダ¥bin¥jbssetcnf」です。
jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/AJS2を再起動する。
設定ファイルに記述した内容が反映されます。

(2)　定義パラメーター一覧

表7-29　ジョブ実行多重度到達を確認するメッセージを出力する設定のための定義パラメーター一覧

定義キー | 環境設定パラメーター | 定義内容
[{JP1_DEFAULT|論理ホスト名}¥JP1NBQMANAGER¥Job]※ | "MaximumExecJobLogOption"= | ジョブ実行多重度到達を確認するメッセージを出力する設定
"MaximumExecJobLogInterval"= | ジョブ実行多重度到達を確認するメッセージを出力する間隔

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

(3)　定義内容

"MaximumExecJobLogOption"=dword:設定値

ジョブ実行多重度到達を確認するメッセージを出力するかどうかを指定します。

0

ジョブ実行多重度到達を確認するメッセージを出力しません。

1

ジョブ実行多重度到達を確認するメッセージを出力します。

デフォルトは「0」です。

"MaximumExecJobLogInterval"=dword:設定値

ジョブ実行多重度到達を確認するメッセージを出力する間隔を16進数で指定します。

指定できる範囲は0000003C～00015180（10進数で60～86400）（単位：秒）です。

デフォルトは「00000258」（10進数で600）で10分です。

最初にKAVU4310-Iメッセージを出力したあと，この設定値の間隔（デフォルト10分）の間は，ジョブのキューイング状態が続いてもKAVU4310-Iメッセージは出力されません。この設定値に指定した時間を過ぎてもジョブのキューイング状態が続いている場合は，再度KAVU4310-Iメッセージがこの設定値の間隔で出力されます。

7.28　WOW64環境でジョブを実行する際にファイルシステムリダイレクトを無効にする設定

Windows Server 2003 x64 EditionsのWOW64環境でx86対応のJP1/AJS2を使用する場合，PCジョブ，Windows上で実行するQUEUEジョブ，またはjp1execコマンドを起動する際に，一時的にファイルシステムリダイレクトを無効にすることで，%systemroot%¥system32下の64ビットアプリケーションを起動できるように設定できます。

設定手順を次に示します。この設定はジョブの実行先ホスト上で行ってください。

詳細については，マニュアル「JP1/Automatic Job Management System 2 設計・運用ガイド　8.1.20 WOW64環境でx86対応のJP1/AJS2を使用する場合の注意事項」を参照してください。

注意事項

64ビット版のWindows Server 2008では，この設定を行ってもファイルシステムリダイレクトが無効になりません。

64ビット版のWindows Server 2008で%systemroot%¥system32配下の64ビットアプリケーションを使用する場合，%systemroot%¥system32配下の代わりに%systemroot%¥sysnative配下にアクセスするようにしてください。

（例）

変更前：%systemroot%¥system32¥実行ファイル名

変更後：%systemroot%¥sysnative¥実行ファイル名

＜この節の構成＞

(1)　定義手順

(2)　定義パラメーター一覧

(3)　定義内容

(4)　注意事項

(1)　定義手順

Windowsの［コントロールパネル］の［管理ツール］で［サービス］を選択し，次に示すサービスを停止する。

ジョブの実行先サービスに［JP1/AJS2］を指定している場合
JP1/AJS2サービス

ジョブの実行先サービスに［JP1/AJS2 Queueless Agent］を指定している場合
JP1/AJS2 Queueless Agentサービス

注

クラスタシステムの場合は，クラスタの設定を確認し，論理ホストのJP1/AJS2サービスも停止してください。

メモ帳などのテキストエディターで，「(2) 定義パラメーター一覧」の定義パラメーターを記述した設定ファイルを作成する。
設定ファイルのファイル名は任意です。

ファイルを保存し，次のコマンドを実行する。

jbssetcnf 設定ファイル名

jbssetcnfコマンドのパスは，「JP1/Baseのインストール先フォルダ¥bin¥jbssetcnf」です。
jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

注

クラスタシステムの場合は，実行系・待機系の両方でこの設定を行ってください。

JP1/AJS2を再起動する。
設定ファイルに記述した内容が反映されます。

(2)　定義パラメーター一覧

表7-30　WOW64環境でジョブを実行する際にファイルシステムリダイレクトを無効にする設定のための定義パラメーター一覧

定義キー | 環境設定パラメーター | 定義内容
[{JP1_DEFAULT|論理ホスト名}¥JP1NBQAGENT¥Job]※¹ | "DISABLE_FS_REDIRECTION"= | ジョブの実行先サービスに［JP1/AJS2］を指定している場合に，WOW64環境でジョブを実行する際にファイルシステムリダイレクトを無効にする設定
[JP1_DEFAULT¥JP1QLAGENT]※² | "DISABLE_FS_REDIRECTION"= | ジョブの実行先サービスに［JP1/AJS2 Queueless Agent］を指定している場合に，WOW64環境でジョブを実行する際にファイルシステムリダイレクトを無効にする設定

注※1

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

注※2

この設定は，物理ホストと論理ホストの両方に有効です。

(3)　定義内容

・ジョブの実行先サービスに[JP1/AJS2]を指定している場合

"DISABLE_FS_REDIRECTION"=dword:設定値

ジョブの実行先サービスに［JP1/AJS2］を指定している場合に，WOW64環境でジョブを実行する際にファイルシステムリダイレクトを無効にするかどうかを指定します。

0

WOW64環境でジョブを実行する際にファイルシステムリダイレクトが有効になります。

1

WOW64環境でジョブを実行する際にファイルシステムリダイレクトが無効になります。

デフォルトは「0」です。

・ジョブの実行先サービスに［JP1/AJS2 Queueless Agent］を指定している場合

"DISABLE_FS_REDIRECTION"=dword:設定値

ジョブの実行先サービスに[JP1/AJS2 Queueless Agent]を指定している場合に，WOW64環境でジョブを実行する際にファイルシステムリダイレクトを無効にするかどうかを指定します。

0

WOW64環境でジョブを実行する際にファイルシステムリダイレクトが有効になります。

1

WOW64環境でジョブを実行する際にファイルシステムリダイレクトが無効になります。

デフォルトは「0」です。

(4)　注意事項

WOW64環境でジョブを実行する際にファイルシステムリダイレクトを無効にする設定は，Windows Server 2003 x64 Editions Service Pack 1以降だけで有効なオプションです。

「DISABLE_FS_REDIRECTION」オプションをWindows Server 2003 x64 Editions Service Pack 1以降以外のOSに設定した場合，次のメッセージを統合トレースログに出力して，JP1/AJS2サービス，およびJP1/AJS2 Queueless Agentサービスの起動に失敗しますので，Windows Server 2003 x64 Editions Service Pack 1以降以外のOSには設定しないでください。

ジョブの実行先サービスに[JP1/AJS2]を指定している場合
KAVU3549-E ジョブ実行処理でシステムコール(GetProcAddress(Wow64DisableWow64FsRedirection))でエラーが発生しました(要因番号:127)

ジョブの実行先サービスに[JP1/AJS2 Queueless Agent]を指定している場合
KAVS1829-E キューレスエージェントサービスでシステムコール(GetProcAddress(Wow64DisableWow64FsRedirection))でエラーが発生しました:xxxxxxxx 127

また，Windows IPF版のJP1/AJS2（形名が「P-2812-3J84」または「P-2812-3384」）では，ファイルシステムリダイレクトは行われませんので，この設定を行わないでください。

設定した場合，次のメッセージを統合トレースログに出力して，ジョブが起動失敗します。

(a) ジョブの実行先サービスに[JP1/AJS2]を指定している場合

KAVU3549-E ジョブ実行処理でシステムコール(Wow64DisableWow64FsRedirection)でエラーが発生しました(要因番号:0x00000001)

(b) ジョブの実行先サービスに[JP1/AJS2 Queueless Agent]を指定している場合

KAVS0904-E JP1/AJS2で予期しないエラーが発生しました : xxxxxxxx 1

7.29　キューレスジョブが戻り値128で異常検出終了となる問題を回避するための設定

キューレスジョブの実行時に，次に示す条件に該当する場合，ジョブが戻り値128で異常検出終了となることがあります。

任意のジョブ実行OSユーザーで，ジョブを一切実行していない状態である

1と同一のジョブ実行OSユーザーでジョブを実行する

2のジョブが終了する瞬間に，2のジョブと同一のジョブ実行OSユーザーで別のジョブを実行する

上記の条件に該当する場合，環境設定パラメーターAJSQL_CREATEWINDOWSTATIONを設定することで，問題を回避してジョブを正常終了させることができます。設定手順を次に示します。

＜この節の構成＞

(1)　定義手順

(2)　定義パラメーター一覧

(3)　定義内容

(4)　注意事項

(1)　定義手順

Windowsの［コントロールパネル］の［管理ツール］で［サービス］を選択し，次に示すサービスを停止する。

JP1/AJS2 Queueless Agentサービス

メモ帳などのテキストエディターで，「(2) 定義パラメーター一覧」の定義パラメーターを記述した設定ファイルを作成する。
設定ファイルのファイル名は任意です。

ファイルを保存し，次のコマンドを実行する。

jbssetcnf 設定ファイル名

jbssetcnfコマンドのパスは，「JP1/Baseのインストール先フォルダ¥bin¥jbssetcnf」です。
jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

手順1で停止したサービスを再起動する。
設定ファイルに記述した内容が反映されます。

(2)　定義パラメーター一覧

表7-31　ジョブが戻り値128で異常検出終了となる問題を回避するための定義パラメーター

定義キー | 環境設定パラメーター | 定義内容
[JP1_DEFAULT¥JP1QLAGENT] | "AJSQL_CREATEWINDOWSTATION"= | ジョブが戻り値128で異常検出終了となる問題を回避する設定

(3)　定義内容

"AJSQL_CREATEWINDOWSTATION="{yes|no}"

ジョブが戻り値128で異常検出終了となる問題を回避するかどうかを指定します。

yes

ジョブが戻り値128で異常検出終了となる問題を回避します。

no

ジョブが戻り値128で異常検出終了となる問題を回避しません。

デフォルトは「no」です。

(4)　注意事項

この設定を有効にした場合，キューレスエージェントサービスは，ジョブ実行OSユーザーごとに，最初にジョブを実行したときにジョブ実行用デスクトップヒープ領域を取得して，ユーザーマッピングキャッシュにキャッシュします。ジョブの実行が終了しても，該当する領域を解放しません。2回目以降に同一ユーザーからジョブを実行する場合は，ユーザーマッピングキャッシュから該当する領域を再利用します。そのため，ジョブ実行OSユーザー数が多い場合，領域不足によりデスクトップヒープ領域の取得に失敗し，次に示すメッセージを出力してジョブが起動失敗になります。
KAVS1829-E キューレスエージェントサービスでシステムコール（CreateDesktop）でエラーが発生しました：xxxxxxxx 8
この場合，ajsqlalterコマンドを実行，またはキューレスエージェントサービスを再起動してユーザーマッピングキャッシュをクリアーし，ジョブ実行時に使用するジョブ実行OSユーザー数を少なくしてください。ajsqlalterコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 2 コマンドリファレンス　1. コマンド　ajsqlalter」を参照してください。
ジョブ実行時に使用するジョブ実行OSユーザー数を少なくできない場合は，アプリケーションが使用するデスクトップヒープ領域サイズが小さくなるように，デスクトップヒープ領域サイズを変更してください。デスクトップヒープ領域サイズの変更方法については，各OSのドキュメントを参照してください。

この設定を有効にしても，デスクトップヒープ不足によって，ジョブが戻り値128で異常検出終了となる現象は回避できません。

7.30　サブミットジョブの実行順序の入れ替わりを防止する設定

サブミットジョブの実行順序の入れ替わりを防止するための設定方法について説明します。

＜この節の構成＞

(1)　定義手順

(2)　定義パラメーター一覧

(3)　定義内容

(1)　定義手順

Windowsの［コントロールパネル］の［管理ツール］で［サービス］を選択し，次のサービスを停止する。

JP1/AJS2サービス

メモ帳などのテキストエディターで，「(2) 定義パラメーター一覧」の定義パラメーターを記述した設定ファイルを作成する。
設定ファイルのファイル名は任意です。

ファイルを保存し，次のコマンドを実行する。

jbssetcnf 設定ファイル名

jbssetcnfコマンドのパスは，「JP1/Baseのインストール先フォルダ¥bin¥jbssetcnf」です。
jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/AJS2を再起動する。
設定ファイルに記述した内容が反映されます。

(2)　定義パラメーター一覧

表7-32　サブミットジョブの実行順序の入れ替わりを防止する設定の定義パラメーター

定義キー | 環境設定パラメーター | 定義内容
[{JP1_DEFAULT|論理ホスト名}¥JP1NBQMANAGER¥Job]※ | "PreventChangeJobOrder"= | サブミットジョブの実行順序の入れ替わりを防止する設定

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

(3)　定義内容

"PreventChangeJobOrder"=dword: 00000000|00000001

サブミットジョブの実行順序の入れ替わりを防止するかを指定します。

0

サブミットジョブの実行順序の入れ替わりを防止しない場合に指定します。

1

サブミットジョブの実行順序の入れ替わりを防止する場合に指定します。

デフォルトは「0」です。

注意事項

サブミットジョブの実行順序の入れ替わりを防止するためにPreventChangeJobOrderに「1」を設定した場合に，ジョブを配信する処理が変更されますが，次の設定が行われていないと実行順序の入れ替わりを防止できません。

ジョブをサブミットしたキューに接続されているエージェント数は一つである。

エージェントのジョブ実行多重度が1に設定されている。

また，ジョブの実行順序を制御するために，ジョブ実行性能が数パーセントほど低下するおそれがあります。

7.31　ジョブ情報列挙時にジョブ実行制御マネージャー（jpqman）のメモリー消費量を少なくする設定

ジョブ実行マネージャー（jpqman）では，ジョブ情報列挙時に，列挙数に応じてメモリーを消費しているため，列挙数が増加すると統合トレースログにKAVU4280-Eのメッセージを出力して次の関数またはコマンドが失敗する場合があります。この場合，ジョブ情報列挙時にジョブ実行制御マネージャーのメモリー消費量を少なくする設定を行うことで回避できる場合があります。

jpqjobshowコマンド

jpqendjobshowコマンド

JpqOpenEnumJob関数※

JpqOpenEndEnumJob関数※

注※

関数機能を使用できるのは，Version 7i以前の環境でプログラムを作成している場合です。詳細については，マニュアル「JP1/Automatic Job Management System 2 設計・運用ガイド　9.10 関数機能を使用している場合の注意事項」を参照してください。

ジョブ情報列挙時にジョブ実行制御マネージャーのメモリー消費量を少なくするための設定手順を次に示します。

＜この節の構成＞

(1)　定義手順

(2)　定義パラメーター一覧

(3)　定義内容

(1)　定義手順

Windowsの［コントロールパネル］の［管理ツール］で［サービス］を選択し，次のサービスを停止する。

JP1/AJS2サービス

メモ帳などのテキストエディターで，「(2) 定義パラメーター一覧」の定義パラメーターを記述した設定ファイルを作成する。
設定ファイルのファイル名は任意です。

ファイルを保存し，次のコマンドを実行する。

jbssetcnf 設定ファイル名

jbssetcnfコマンドのパスは，「JP1/Baseのインストール先フォルダ¥bin¥jbssetcnf」です。
jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/AJS2を再起動する。
設定ファイルに記述した内容が反映されます。

(2)　定義パラメーター一覧

表7-33　ジョブ情報列挙時にジョブ実行制御マネージャーのメモリー消費量を少なくする設定の定義パラメーター

定義キー | 環境設定パラメーター | 定義内容
[{JP1_DEFAULT|論理ホスト名}¥JP1NBQMANAGER¥Job]※ | "EnumJobSaveMemory"= | ジョブ情報列挙時にジョブ実行制御マネージャーのメモリー消費量を少なくする設定

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

(3)　定義内容

"EnumJobSaveMemory"=dword: 00000000|00000001

ジョブ情報列挙時にジョブ実行制御マネージャーのメモリー消費量を少なくするかを指定します。

0

ジョブ情報列挙時に，ジョブ実行制御マネージャーが列挙数に応じてメモリーを消費する場合に指定します。

1

ジョブ情報列挙時に，ジョブ実行制御マネージャーのメモリー消費量を少なくする場合に指定します。

デフォルトは「0」です。

注意事項

ジョブ情報列挙時のメモリー消費量の見積もりは，次のとおりです。

0を設定した場合
メモリー消費量は，ジョブ1件当たり最大で約100キロバイトです。

1を設定した場合
メモリー消費量は，ジョブの列挙数にかかわらず，最大で約60メガバイトです。

7.32　ジョブ実行制御のマネージャープロセスに対する通信タイムアウト時間の変更

ジョブ実行制御のマネージャープロセスに対して次の要求をする際，要求する側は通信タイムアウト時間（デフォルト10分）を設定してマネージャープロセスと通信します。

ジョブネット（スケジューラー）によるジョブの登録，キャンセル，およびジョブの状態確認

ジョブの実行に使用するコマンド（jpqxxxxコマンド）によるジョブの操作

ジョブの実行に使用する関数（Jpqxxxx関数）によるジョブの操作

ジョブ実行制御のマネージャープロセスとの通信処理で時間が掛かり，通信タイムアウトが発生すると，ジョブの実行やコマンド要求が失敗します。

通信タイムアウトが発生する要因には，主に次のものがあります。

実行したジョブの転送ファイルや結果ファイルのファイルサイズが大きい

jpqendjobshowコマンド（終了ジョブ情報を列挙するコマンド）で列挙するジョブ数が多い
jpqendjobshowコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 2 コマンドリファレンス　1. コマンド　jpqendjobshow」を参照してください。

jpqjobshowコマンド（未終了ジョブ情報を列挙するコマンド）で列挙するジョブ数が多い
jpqjobshowコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 2 コマンドリファレンス　1. コマンド　jpqjobshow」を参照してください。

ジョブネット（スケジューラー）によるジョブの登録，キャンセル，およびジョブの状態確認の際に通信タイムアウトが発生すると，ジョブ※が異常終了します。この場合，統合トレースログには，次のメッセージが出力されます。

注※

イベントジョブおよびジョブの実行先サービスに［JP1/AJS2 Queueless Agent］を指定した場合を除きます。

KAVU0220-E マネージャーからの応答が返ってきません

jpqxxxxコマンドで通信タイムアウトが発生すると，標準エラー出力に次のメッセージが出力されます。

KAVU0953-E マネージャーからの応答が返ってきません

通信タイムアウトによるコマンド要求やジョブの実行失敗は，通信タイムアウト時間を長く設定することで回避できることがあります。ジョブネット（スケジューラー）によるジョブの登録，キャンセル，またはジョブの状態確認の際に通信タイムアウトを回避するには，ジョブを登録するマネージャーホストで通信タイムアウト時間を長く設定してください。また，ジョブの実行に使用するコマンドや関数の場合は，コマンドや関数を実行するクライアントホストで通信タイムアウト時間を長く設定してください。

通信タイムアウト時間を変更する設定方法について説明します。

＜この節の構成＞

(1)　定義手順

(2)　定義パラメーター一覧

(3)　定義内容

(4)　注意事項

(1)　定義手順

Windowsの［コントロールパネル］の［管理ツール］で［サービス］を選択し，次のサービスを停止する。

JP1/AJS2サービス

メモ帳などのテキストエディターで，「(2) 定義パラメーター一覧」の定義パラメーターを記述した設定ファイルを作成する。
設定ファイルのファイル名は任意です。

ファイルを保存し，次のコマンドを実行する。

jbssetcnf 設定ファイル名

jbssetcnfコマンドのパスは，「JP1/Baseのインストール先フォルダ¥bin¥jbssetcnf」です。
jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/AJS2を再起動する。
設定ファイルに記述した内容が反映されます。

(2)　定義パラメーター一覧

表7-34　ジョブ実行制御のマネージャープロセスに対する通信タイムアウト時間の設定の定義パラメーター

定義キー | 環境設定パラメーター | 定義内容
[{JP1_DEFAULT|論理ホスト名}¥JP1NBQCLIENT¥Network]※ | "CommunicateTimeout"= | ジョブ実行制御のマネージャープロセスに対する通信タイムアウト時間（単位：ミリ秒）

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

(3)　定義内容

"CommunicateTimeout"=dword:設定値

通信タイムアウト時間を16進数で指定します（単位：ミリ秒）。

指定できる範囲は000927c0～0036EE80（10進数で600000～3600000）です。

デフォルトは「000927c0（10進数で600000（10分））」です。

(4)　注意事項

通信タイムアウト時間を長く設定すると，通信処理中にコマンドやジョブに異常が発生した場合の障害検知までの時間も長くなります。そのため，後続ジョブの実行の遅延などが発生しやすくなります。通信タイムアウト時間を変更する場合は，設定値を十分に検証した上で設定してください。

7.33　JP1/AJS2のサービスが停止してもイベントジョブの実行を継続させる設定

イベントジョブについては，イベントジョブ実行継続オプションを使用することによって，JP1/AJS2のサービスが停止しても，そのとき実行中だったものは再起動後もそのまま状態を引き継ぎ，実行を継続できます。

ここでは，イベントジョブ実行継続オプションを有効にする手順について説明します。機能の詳細については，マニュアル「JP1/Automatic Job Management System 2 設計・運用ガイド　8.5.8 JP1/AJS2のサービスが停止してもイベントジョブの実行を継続させる」を参照してください。

＜この節の構成＞

(1)　定義手順

(2)　定義パラメーター

(3)　定義内容

(1)　定義手順

Windowsの［コントロールパネル］の［管理ツール］で［サービス］を選択し，次のサービスを停止する。

JP1/AJS2サービス

メモ帳などのテキストエディターで，「(2) 定義パラメーター一覧」の定義パラメーターを記述した設定ファイルを作成する。
設定ファイルのファイル名は任意です。

ファイルを保存し，次のコマンドを実行する。

jbssetcnf 設定ファイル名

jbssetcnfコマンドのパスは，「JP1/Baseのインストール先フォルダ¥bin¥jbssetcnf」です。
jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/AJS2を再起動する。
設定ファイルに記述した内容が反映されます。

(2)　定義パラメーター

表7-35　JP1/AJS2のサービスが停止してもイベントジョブの実行を継続させる設定の定義パラメーター

定義キー | 環境設定パラメーター | 定義内容
[{JP1_DEFAULT|論理ホスト名}¥JP1AOMMANAGER]※ | "EvJobExecContinue"= | イベントジョブ実行継続オプション

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定してください。

(3)　定義内容

"EvJobExecContinue"="{Y|N}"

実行ホストのJP1/AJS2のサービスを再起動したときに，イベントジョブの実行を継続するかどうかを指定します。

Y

イベントジョブの実行を継続します。

N

イベントジョブの実行を終了します。

デフォルトは「N」です。

注意事項

JP1/AJS2 - Managerが08-50より前のバージョンの場合，イベントジョブ実行継続オプションを使用できません。

イベントジョブ実行継続オプションは，物理・論理ホストのマネージャー単位で設定してください。

7.34　サービスの依存関係の解除・再設定

JP1/Baseのイベントサーバ名に，FQDN形式などデフォルト以外の名称を使用している場合は，JP1/AJS2サービスを開始しようとすると「依存関係サービスまたはグループを起動できませんでした」というメッセージが出力され，JP1/AJS2サービスを開始できなくなります。Windowsイベントログには，「JP1/AJS2サービスは，次のエラーのために開始できなかったJP1/Base Eventサービスに依存します」と出力されます。

JP1/Baseでデフォルト以外のイベントサーバ名を設定する場合は，次の方法でJP1/AJS2サービスの依存関係を解除してください。なお，依存関係を設定していない場合は，JP1/BaseサービスとJP1/Base Eventサービスの開始を確認してからJP1/AJS2サービスを開始してください。

デフォルト以外のイベントサーバ名を設定する方法については，マニュアル「JP1/Base 運用ガイド」を参照してください。

＜この節の構成＞

(1)　依存関係の解除手順

(2)　依存関係の設定手順

(3)　注意事項

(1)　依存関係の解除手順

依存関係を解除する手順を次に示します。

JP1/AJS2サービスが起動している場合は，JP1/AJS2サービスを停止する。

次のコマンドを実行し，JP1/AJS2サービスの依存関係を解除する。

SpmSetSvcAjs.exe -setdepend no

JP1/AJS2サービスを再起動する。

なお，デフォルトのイベントサーバを使用する運用に戻す場合は，JP1/AJS2，JP1/Base，およびJP1/Base Eventサービスの依存関係を再度設定してください。

(2)　依存関係の設定手順

依存関係を設定する手順を次に示します。

JP1/AJS2サービスが起動している場合は，JP1/AJS2サービスを停止する。

次のコマンドを実行し，JP1/AJS2サービスの依存関係を設定する。

SpmSetSvcAjs.exe -setdepend yes

JP1/AJS2サービスを再起動する。

(3)　注意事項

Windows Server 2008のマシンでSpmSetSvcAjs.exeを実行する際は，コマンドプロンプトを管理者として起動する必要があります。コマンドプロンプトを起動する際は，Windowsの［スタート］メニューの［コマンドプロンプト］を右クリックし，ショートカットメニューから［管理者として実行］を選択してください。なお，UAC機能が無効の場合は，コマンドプロンプトを管理者として起動する必要はありません。

7.35　イベント・アクション制御エージェント起動通知の送信に失敗した場合に再送を行う設定

イベントジョブや起動条件付きジョブネットを実行登録すると，実行ホストのJP1/AJS2は実行元のマネージャーホスト名を記憶し，自身が起動した際にその旨をイベント・アクション制御マネージャーに通知します。この通知をイベント・アクション制御エージェント起動通知と呼びます（以降，この章では起動通知と表記します）。

エージェントから起動通知を受けたマネージャーは，そのエージェントで実行中のイベントジョブ（起動条件付きジョブネットを含む）の実行状態について，マネージャー・エージェント間での整合を取る通信を行います。

エージェントが起動通知の送信に失敗した場合，マネージャー・エージェント間の通信が行われないため，マネージャー・エージェント間でイベントジョブ（起動条件付きジョブネット含む）の実行状態が一致しなくなることがあります。この場合，JP1/AJS2 - Viewで起動条件付きジョブネットの状態が監視中と表示されても，実際にはエージェントでは監視が行われていない状態になります。そのため，監視対象のイベントが発生してもイベントは検知されず，マネージャー側でイベントジョブが終了しないことや，起動条件付きジョブネットが起動しないことがあります。

イベントジョブや起動条件付きジョブネットを実行したまま，次のような状況でエージェントホストのJP1/AJS2サービスを再起動する運用を行う場合は，「(1) 定義手順」に従って，あらかじめ環境設定パラメーターを設定してください。

エージェントがJP1/AJS2以外のプログラムによってシステム全体が高負荷な状況で，エージェントホストのJP1/AJS2サービスを再起動する

ネットワークで一時的な通信障害が発生している状況で，エージェントホストのJP1/AJS2サービスを再起動する

なお，エージェントが記憶しているマネージャーホスト名はjpoagoecコマンドで確認できます。使用しない不要なマネージャーホストがある場合は，同コマンドで削除してから，環境設定パラメーターを設定してください。jpoagoecコマンドについては，マニュアル「JP1/Automatic Job Management System 2 コマンドリファレンス　1. コマンド　jpoagoec」を参照してください。

注意事項

エージェントが不要なマネージャーホストを記憶している状態で環境設定パラメーターを設定し，エージェントのJP1/AJS2サービスを起動すると，不要なマネージャーに対しても起動通知の送信に失敗した場合に通知を再送するようになるため，他のマネージャーから実行されたイベントジョブや起動条件付きジョブネットの開始が遅れたり，イベントの検知が遅れたりすることがあります。

＜この節の構成＞

(1)　定義手順

(2)　定義パラメーター

(3)　定義内容

(1)　定義手順

Windowsの［コントロールパネル］の［管理ツール］で［サービス］を選択し，次のサービスを停止する。

JP1/AJS2サービス

JP1/AJS2 Monitorサービス

メモ帳などのテキストエディターで，「(2) 定義パラメーター一覧」の定義パラメーターを記述した設定ファイルを作成する。
設定ファイルのファイル名は任意です。

ファイルを保存し，次のコマンドを実行する。

jbssetcnf 設定ファイル名

jbssetcnfコマンドのパスは，「JP1/Baseのインストール先フォルダ¥bin¥jbssetcnf」です。
jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/AJS2を再起動する。
設定ファイルに記述した内容が反映されます。

(2)　定義パラメーター

表7-36　イベント・アクション制御エージェント起動通知の送信に失敗した場合に再送を行う設定の定義パラメーター

定義キー | 環境設定パラメーター | 定義内容
[{JP1_DEFAULT|論理ホスト名}¥JP1AOMAGENT]※ | "RetryAgtStartNotification"= | 起動通知の送信に失敗した場合に起動通知の再送を行うための定義

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定してください。

(3)　定義内容

"RetryAgtStartNotification"="{Y|N}"

起動通知の再送を行うかどうかを指定します。

Y

起動通知の送信に失敗した場合，起動通知の再送を行います。

N

起動通知の送信に失敗した場合でも，起動通知の再送を行いません。

デフォルトは「N」です。

7.36　拡張子が4バイト以上の実行ファイルのジョブを実行するための設定

ジョブ※の詳細定義で，実行ファイル名に拡張子が4バイト以上のファイルを指定した場合，拡張子の先頭から3バイトまでの文字列に関連づけられた実行可能ファイル（.EXE）を使用してジョブを実行します。そのため，本来の4バイト以上の拡張子に関連づけられた実行可能ファイルではないファイルを使用してジョブを実行したり，ジョブが起動失敗したりするおそれがあります。

拡張子が4バイト以上の実行ファイルに関連づけられた実行可能ファイルを使用してジョブを実行するには，次の設定を行ってください。

なお，この設定はジョブの実行先ホスト上で行ってください。

注※

PCジョブ，およびWindows版のJP1/AJS2上で実行されるQUEUEジョブが該当します。また，jpqjobsubコマンドまたはJpqSubmitJob関数で実行するサブミットジョブも含まれます。

設定手順を次に示します。

＜この節の構成＞

(1)　定義手順

(2)　定義パラメーター一覧

(3)　定義内容

(4)　注意事項

(1)　定義手順

Windowsの［コントロールパネル］の［管理ツール］で［サービス］を選択し，次のサービスを停止する。

ジョブの実行先サービスに［JP1/AJS2］を指定している場合
JP1/AJS2サービス

ジョブの実行先サービスに［JP1/AJS2 Queueless Agent］を指定している場合
JP1/AJS2 Queueless Agentサービス

クラスタシステムの場合は，クラスタの設定を確認し，論理ホストのJP1/AJS2サービスも停止してください。

メモ帳などのテキストエディターで，「(2) 定義パラメーター一覧」の定義パラメーターを記述した設定ファイルを作成する。
設定ファイルのファイル名は任意です。

ファイルを保存し，次のコマンドを実行する。

jbssetcnf 設定ファイル名

jbssetcnfコマンドのパスは，「JP1/Baseのインストール先フォルダ¥bin¥jbssetcnf」です。
jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

手順1で停止したサービスを再起動する。
設定ファイルに記述した内容が反映されます。

(2)　定義パラメーター一覧

表7-37　拡張子が4バイト以上の実行ファイルのジョブを実行するためのパラメーター一覧

定義キー | 環境設定パラメーター | 定義内容
[{JP1_DEFAULT|論理ホスト名}¥JP1NBQAGENT¥Job]※1 | "ENABLE_LONG_EXT"= | ジョブの実行先サービスに［JP1/AJS2］を指定している場合に，拡張子が4バイト以上の実行ファイルに関連づけられた実行可能ファイルでジョブを実行するかどうかの設定
[JP1_DEFAULT¥JP1QLAGENT]※2 | "ENABLE_LONG_EXT"= | ジョブの実行先サービスに［JP1/AJS2 Queueless Agent］を指定している場合に，拡張子が4バイト以上の実行ファイルに関連づけられた実行可能ファイルでジョブを実行するかどうかの設定

注※1

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

注※2

この設定は，物理ホストと論理ホストの両方に有効です。

(3)　定義内容

"ENABLE_LONG_EXT"=dword:設定値

拡張子が4バイト以上の実行ファイルに関連づけられた実行可能ファイルでジョブを実行するかどうかを指定します。

0

拡張子が4バイト以上の実行ファイルを実行する場合，拡張子の先頭から3バイトまでの文字列に関連づけられた実行可能ファイルを使用してジョブを実行します。

なお，先頭から3バイトまでの文字列に関連づけられた実行可能ファイルがない場合，ジョブは起動失敗になります。

1

拡張子が4バイト以上の実行ファイルを実行する場合，4バイト以上の拡張子に関連づけられた実行可能ファイルを使用してジョブを実行します。

なお，ジョブの実行先サービスに［JP1/AJS2］を指定している場合で，拡張子が4バイト以上の実行ファイルを実行するときは，実行ファイル名をロングファイル名のままで実行します。

デフォルトは「0」です。

(4)　注意事項

このオプションを有効にした場合は，ジョブの詳細定義で，実行ファイル名に続けて実行ファイルに対するパラメーターを指定できません。指定した場合，ジョブが異常終了するおそれがあります。

このオプションを有効にするには，該当する拡張子（4バイト以上の拡張子）に，適切なアプリケーションを関連づけておく必要があります。
該当する拡張子とアプリケーションを関連づける手順は次のとおりです。

Windows Server 2008の場合

ftypeコマンドを実行し，関連づけるアプリケーションを登録する。

assocコマンドを実行し，手順1で登録したアプリケーションと拡張子を関連づける。

OSを再起動する。

ftypeコマンドとassocコマンドの詳細については，Windowsのヘルプを参照してください。

Windows Server 2003以前の場合

Windowsの［コントロールパネル］の［フォルダオプション］で［ファイルの種類］タブを選択する。

設定する拡張子を選択して［詳細設定］ボタンをクリックし，［ファイルの種類の編集］ダイアログボックスの［アクション］に「open」を指定して関連づけるアプリケーションを登録する。

OSを再起動する。

7.37　エージェントホスト名の名前解決オプションの設定

hostsファイルやDNSが正しく設定されていないなど，マネージャーホスト上でエージェントホスト名の名前解決ができない場合があります。その状態でマネージャーやエージェントのJP1/AJS2サービスを起動または停止すると，次の現象が発生することがあります。

実行登録したイベントジョブが「実行中」状態になるまでに長い時間が掛かる。

イベントジョブまたは起動条件で監視しているイベントの検知が遅れる。

イベントジョブまたは起動条件付きジョブネットに対して強制終了などの操作をしても，ジョブの状態が変わるまでに長い時間が掛かる。

マネージャーのJP1/AJS2サービスの停止に長い時間が掛かる。

マネージャーのJP1/AJS2サービスの起動に長い時間が掛かる。

上記の現象を回避したい場合は，エージェントホスト名の名前解決オプションを設定してください。

なお，すべてのエージェントホスト名の名前解決ができる環境では，このオプションを設定する必要はありません。

オプションを有効にする設定方法について次に説明します。

＜この節の構成＞

(1)　定義手順

(2)　定義パラメーター一覧

(3)　定義内容

(1)　定義手順

Windowsの［コントロールパネル］の［管理ツール］で［サービス］を選択し，次のサービスを停止する。

JP1/AJS2サービス

JP1/AJS2 Monitorサービス

メモ帳などのテキストエディターで，「(2) 定義パラメーター一覧」の定義パラメーターを記述した設定ファイルを作成する。
設定ファイルのファイル名は任意です。

ファイルを保存し，次のコマンドを実行する。

jbssetcnf 設定ファイル名

jbssetcnfコマンドのパスは，「JP1/Baseのインストール先フォルダ¥bin¥jbssetcnf」です。
jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/AJS2を再起動する。
設定ファイルに記述した内容が反映されます。

(2)　定義パラメーター一覧

表7-38　エージェントホストの名前解決オプション設定の定義パラメーター一覧

定義キー | 環境設定パラメーター | 定義内容
[JP1_DEFAULT¥JP1AOMMANAGER]※ | "_AgentStartStopResolveMode"= | エージェントホストの名前解決オプション

注※

このパラメーターの設定は，物理ホストおよびすべての論理ホストに対して有効です。

(3)　定義内容

"_AgentStartStopResolveMode"="{optimized|normal}"

エージェントホストの名前解決処理を最適化するかどうかを指定します。

optimized

エージェントホスト名の名前解決処理を最適化する場合に指定します。ただし，名前解決できるのは，イベントジョブや起動条件付きジョブネットを実行しているエージェントホストだけです。

normal

エージェントホスト名の名前解決処理を最適化しない場合に指定します。

デフォルトは「normal」です。

7.38　イベント・アクション制御のプロセス間通信でのデータ到着待ちタイムアウト化オプションの設定

ネットワークへの高負荷または回線不良などによって，イベント・アクション制御のプロセス間通信が正常にできない場合，次のような現象が発生することがあります。

ジョブの実行登録や強制終了などの操作を実行しても状態が変わらない。

ジョブネットがスケジュールで指定した時刻になっても開始されない。

イベントジョブまたは起動条件で監視しているイベントが検知されない。

ajsstopコマンドを実行してもスケジューラーサービスが停止しない。

JP1/AJS2サービスの停止に長い時間が掛かる。

上記の現象を回避したい場合は，イベント・アクション制御のプロセス間通信でのデータ到着待ちタイムアウト化オプションを設定してください。

オプションを有効にする設定方法について次に説明します。

＜この節の構成＞

(1)　定義手順

(2)　定義パラメーター一覧

(3)　定義内容

(1)　定義手順

Windowsの［コントロールパネル］の［管理ツール］で［サービス］を選択し，次のサービスを停止する。

JP1/AJS2サービス

JP1/AJS2 Monitorサービス

メモ帳などのテキストエディターで，「(2) 定義パラメーター一覧」の定義パラメーターを記述した設定ファイルを作成する。
設定ファイルのファイル名は任意です。

ファイルを保存し，次のコマンドを実行する。

jbssetcnf 設定ファイル名

jbssetcnfコマンドのパスは，「JP1/Baseのインストール先フォルダ¥bin¥jbssetcnf」です。
jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/AJS2を再起動する。
設定ファイルに記述した内容が反映されます。

(2)　定義パラメーター一覧

表7-39　データの到着待ちタイムアウト化オプション設定の定義パラメーター一覧

定義キー | 環境設定パラメーター | 定義内容
[JP1_DEFAULT¥JP1AOMAGENT]※ | "RecvTimeout"= | イベントジョブのソケット通信時のデータ到着待ちタイムアウト化オプション

注※

このパラメーターの設定は，物理ホストおよびすべての論理ホストに対して有効です。

(3)　定義内容

"RecvTimeout"="{Y|N}"

イベント・アクション制御のプロセス間通信で，通信データが何らかの理由によって受信側に到着しない場合に，データの到着待ちを打ち切ってほかの処理を行えるようにするかどうかを指定します。

通信環境が不安定な場合などに指定しますが，通常は指定する必要はありません。

Y

データが一定時間到着しない場合にデータ受信処理をタイムアウトさせます。

N

データの到着まで待機します。

デフォルトは「N」です。

7.39　ジョブ実行時のログオンリトライを変更する設定

JP1/AJS2では，ジョブ※を実行する際，JP1/AJS2サービスを起動したアカウントと異なるユーザーアカウントでジョブを実行することがあります。その場合，ジョブプロセスを起動するために，ユーザーが属するセキュリティグループや権限に関する情報などを含んだユーザー情報（以降，アクセストークンと呼びます）を取得する必要があります。アクセストークンの取得には，Win32API関数を使用しています。この関数が一時的にエラーとなっていると，アクセストークンを取得できないため，JP1/AJS2ではジョブが起動失敗（異常終了）の状態になります。例えば，認証先のドメインコントローラーがシャットダウンなどで停止した場合，ドメイン認証ができないためにジョブが起動失敗します。

この関数を一定の間隔でリトライすることで，一時的なエラーを回避し，ジョブが異常終了する要因の発生頻度を抑えることができます。

注※

PCジョブ，アクションジョブ，カスタムジョブ，およびWindows版JP1/AJS2上で実行するQUEUEジョブが該当します。また，jpqjobsubコマンドまたはJpqSubmitJob関数で実行するサブミットジョブも含まれます。

設定手順を次に示します。

＜この節の構成＞

(1)　定義手順

(2)　定義パラメーター一覧

(3)　定義内容

(4)　注意事項

(1)　定義手順

Windowsの［コントロールパネル］の［管理ツール］で［サービス］を選択し，次のサービスを停止する。

JP1/AJS2サービス

クラスタシステムの場合は，クラスタの設定を確認し，論理ホストのJP1/AJS2サービスも停止してください。

メモ帳などのテキストエディターで，「(2) 定義パラメーター一覧」の定義パラメーターを記述した設定ファイルを作成する。
設定ファイルのファイル名は任意です。

ファイルを保存し，次のコマンドを実行する。

jbssetcnf 設定ファイル名

jbssetcnfコマンドのパスは，「JP1/Baseのインストール先フォルダ¥bin¥jbssetcnf」です。
jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/AJS2を再起動する。
設定ファイルに記述した内容が反映されます。

(2)　定義パラメーター一覧

表7-40　ジョブ実行時にアクセストークンの取得をリトライする設定のための定義パラメーター

定義キー | 環境設定パラメーター | 定義内容
[{JP1_DEFAULT|論理ホスト名}¥JP1NBQAGENT¥Network]※ | "LogonUserRetryCount"= | ジョブの実行先サービスに［JP1/AJS2］を指定している場合に，アクセストークンの取得をリトライする回数
"LogonUserRetryInterval"= | ジョブの実行先サービスに［JP1/AJS2］を指定している場合に，アクセストークンの取得をリトライする間隔

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

(3)　定義内容

"LogonUserRetryCount"=dword:設定値

ジョブの実行先サービスに［JP1/AJS2］を指定している場合に，アクセストークンの取得をリトライする回数を16進数で指定します。

指定できる範囲は00000000～00000064（10進数で0～100）です。

デフォルトは「dword:00000003」（10進数で3）です。

"LogonUserRetryInterval"=dword:設定値

ジョブの実行先サービスに［JP1/AJS2］を指定している場合に，アクセストークンの取得をリトライする間隔を16進数で指定します（単位：秒）。

指定できる範囲は00000001～0000012C（10進数で1～300）です。

デフォルトは「dword:00000001」（10進数で1）です。

(4)　注意事項

リトライ回数およびリトライ間隔で調整するため，ドメインコントローラーが切り替わるまでに，設定したリトライ回数およびリトライ間隔以上の時間が掛かる場合は，この機能で回避できません。

ジョブを実行したOSユーザーのパスワードが不正だった場合は，OSのセキュリティポリシーの設定によってアカウントロックとなることがあります。アカウントロックされた場合，該当するユーザーではジョブを実行できなくなります。

次のことが原因でログオンに失敗する場合も指定回数と指定間隔によるリトライが実施されるため，ジョブが実行終了となるまで時間が掛かります。また，ジョブを強制終了した場合も同様に，強制終了となるまで時間が掛かります。

ジョブ実行時に，認証先のすべてのドメインコントローラーが停止している

パスワード不正ユーザーでジョブを実行する

未登録ユーザーでジョブを実行する

アカウントロックしているユーザーでジョブを実行する

アカウントが無効になっているユーザーでジョブを実行する

7.40　イベントジョブを実行する場合のマネージャーホスト名を固定化する設定

イベントジョブを実行すると，マネージャーはイベントジョブの実行先のエージェントと通信します。その通信では，マネージャーはエージェントが複数のマネージャーを区別できるように，マネージャーホスト名を送信します。マネージャーホスト名は，マネージャーのJP1/AJS2サービスを起動した際に取得しています。

通常は，意図してホスト名を変更しないかぎり，マネージャーのJP1/AJS2サービスの再起動前と再起動後で，取得したホスト名が変わることはありません。しかし，DNSなどの名前解決に関するOSの設定を変更した場合など，何らかの要因によって，JP1/AJS2サービスの再起動前と再起動後で取得したホスト名で使用されている英文字が，大文字から小文字または小文字から大文字に変わることがあります。

イベントジョブの実行先のエージェントは，マネージャーホスト名の英文字の大文字と小文字を区別するため，ホスト名の英文字が大文字から小文字，または小文字から大文字に変わると，結果としてマネージャーホスト名が変わることになり，次の問題が発生することがあります。

起動条件付きジョブネットを実行したままマネージャーのJP1/AJS2サービスを再起動すると，そのあとに発生した監視対象のイベントを重複して検知する。

イベントジョブ実行継続オプションを有効にしている状態で，イベントジョブを実行したままマネージャーのJP1/AJS2サービスをホットスタートで再起動すると，一つのイベントに対して不当に複数回イベントを検知する。
イベントジョブ実行継続オプションについては，「7.33 JP1/AJS2のサービスが停止してもイベントジョブの実行を継続させる設定」を参照してください。

この問題を回避するには，マネージャーホスト名固定化オプション（環境設定パラメーターFixedHostnameForAgent）を有効に設定してください。マネージャーホスト名固定化オプションを有効に設定すると，イベント・アクション制御マネージャーは常に小文字のホスト名を送信するようになります。

注意事項

起動条件付きジョブネットを実行中，またはイベントジョブ実行継続オプションを有効にしている状態でイベントジョブを実行したまま，マネージャーホスト名固定化オプションを変更した場合，マネージャーホスト名の英文字が大文字から小文字，または小文字から大文字に変化することになります。

すでに実行されている起動条件付きジョブネット，またはイベントジョブのジョブの管理状態に不整合が発生し，一つのイベントに対してジョブネットが不当に複数回起動することがあります。

そのような現象を回避するため，マネージャーホスト名固定化オプションを設定，または変更する場合，次の手順のとおり実施してください。

起動条件付きジョブネット，またはイベントジョブを実行しているエージェントホストのJP1/AJS2サービスを停止する。

手順1のエージェントホストでjpoagoecコマンドを実行し，マネージャーホスト名固定化オプションを有効にするマネージャーホスト名を削除する。jpoagoecコマンドについては，マニュアル「JP1/Automatic Job Management System 2 コマンドリファレンス　1. コマンド　jpoagoec」を参照してください。

マネージャーホストで，マネージャーホスト名固定化オプションを設定する。
設定方法については，「(1) 定義手順」を参照してください。

手順2のエージェントホストのJP1/AJS2サービスをコールドスタートで起動する。

オプションを有効にする設定方法について次に説明します。

＜この節の構成＞

(1)　定義手順

(2)　定義パラメーター一覧

(3)　定義内容

(1)　定義手順

Windowsの［コントロールパネル］の［管理ツール］で［サービス］を選択し，次のサービスを停止する。

JP1/AJS2サービス

メモ帳などのテキストエディターで，「(2) 定義パラメーター一覧」の定義パラメーターを記述した設定ファイルを作成する。
設定ファイルのファイル名は任意です。

ファイルを保存し，次のコマンドを実行する。

jbssetcnf 設定ファイル名

jbssetcnfコマンドのパスは，「JP1/Baseのインストール先フォルダ¥bin¥jbssetcnf」です。
jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/AJS2をコールドスタートで再起動する。
設定ファイルに記述した内容が反映されます。

(2)　定義パラメーター一覧

表7-41　マネージャーホスト名固定化オプション設定の環境設定パラメーター

定義キー | 環境設定パラメーター | 定義内容
[{JP1_DEFAULT|論理ホスト名}¥JP1AOMMANAGER]※ | "FixedHostnameForAgent"= | マネージャーホスト名固定化オプション

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定してください。

(3)　定義内容

"FixedHostnameForAgent"="{Y|N}"

イベント・アクション制御のプロセス間通信で，マネージャーホスト名を常に小文字で使用するかどうかを指定します。

Y

マネージャーホスト上で求まるホスト名をすべて小文字に変換したものが，イベント・アクション制御の通信に使用されます。

N

マネージャーホスト上で求まるホスト名を変換しないで，イベント・アクション制御の通信に使用されます。

デフォルトは「N」です。

7.41　システム環境変数とジョブ定義の環境変数が重複した場合にジョブ定義の環境変数を有効にするための設定

ジョブ※1の定義に指定した環境変数※2が小文字の英字を含み，大文字・小文字を区別しないと同名になる環境変数がシステム環境変数にある場合，小文字の英字を含む環境変数が有効にならないことがあります。

注※1

ジョブは，PCジョブ（キューレスジョブを除く），またはjpqjobsubコマンドで実行するサブミットジョブのことです。

注※2

次のどれかが該当します。

JP1/AJS2 - Viewの［詳細定義－［PC Job］］ダイアログボックスで［環境変数］に指定した環境変数，またはjpqjobsubコマンドの-envオプションに指定した環境変数

JP1/AJS2 - Viewの［詳細定義－［PC Job］］ダイアログボックスで［環境変数ファイル名］に指定した環境変数ファイルの環境変数，またはjpqjobsubコマンドの-evオプションに指定した環境変数ファイルの環境変数

小文字の英字の有無と有効になる環境変数の関係を，次の表に示します。

表7-42　小文字の英字の有無と有効になる環境変数の関係

ジョブ定義に指定した
環境変数
システム環境変数
有効になる環境変数

小文字の英字を含む例
Aa＝www
AB＝yyy
AA＝xxx
AB＝zzz
AA＝xxx
AB＝yyy

小文字の英字を含まない例
AA＝www
AB＝yyy
AA＝xxx
AB＝zzz
AA＝www
AB＝yyy

小文字の英字を含む例の場合，ジョブ定義に指定した環境変数「Aa」は小文字の英字「a」を含み，大文字・小文字を区別しないと同名になる環境変数「AA」がシステム環境変数にあります。この場合，システム環境変数「AA」が有効となり，ジョブ定義に指定した環境変数「Aa」は有効になりません。

ジョブ定義に指定した小文字の英字を含む環境変数を有効にするためには，次に示す手順でオプションを有効にしてください。大文字・小文字を区別しないと同名になる環境変数がシステム環境変数にない場合は，設定する必要はありません。

なお，このオプションはジョブの実行先ホスト上で設定してください。

＜この節の構成＞

(1)　定義手順

(2)　定義パラメーター一覧

(3)　定義内容

(1)　定義手順

Windowsの［コントロールパネル］の［管理ツール］で［サービス］を選択し，次のサービスを停止する。

JP1/AJS2サービス

注意事項

クラスタシステムの場合は，クラスタの設定を確認し，論理ホストのJP1/AJS2サービスも停止してください。

メモ帳などのテキストエディターで，「(2) 定義パラメーター一覧」の定義パラメーターを記述した設定ファイルを作成する。
設定ファイルのファイル名は任意です。

ファイルを保存し，次のコマンドを実行する。

jbssetcnf 設定ファイル名

jbssetcnfコマンドのパスは，「JP1/Baseのインストール先フォルダ¥bin¥jbssetcnf」です。
jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/AJS2を再起動する。
設定ファイルに記述した内容が反映されます。

(2)　定義パラメーター一覧

表7-43　システム環境変数とジョブ定義の環境変数が重複した場合にジョブ定義の環境変数を有効にするための定義パラメーター

定義キー | 環境設定パラメーター | 定義内容
[{JP1_DEFAULT|論理ホスト名}¥JP1NBQAGENT¥Job]※ | "MergeEnvMode"= | システム環境変数とジョブ定義の環境変数が重複した場合に，ジョブ定義の環境変数を有効にするかどうかの定義

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定してください。

(3)　定義内容

"MergeEnvMode"=dword:00000000|00000001

システム環境変数とジョブ定義の環境変数が重複した場合に，ジョブ定義の環境変数を有効にするかどうかを指定します。

0

システム環境変数と重複するジョブ定義の環境変数を有効にしない場合に指定します。

1

システム環境変数と重複するジョブ定義の環境変数を有効にする場合に指定します。

デフォルトは「0」です。

8.　ログ情報の採取

この章では，JP1/AJS2の障害発生時の調査分析に有効なログ情報の採取方法について説明します。

＜この章の構成＞

8.1　ログ情報の採取方法

8.1　ログ情報の採取方法

＜この節の構成＞

(1)　環境設定手順

(2)　資料採取ツールの注意事項

(1)　環境設定手順

Windowsの場合，ログ情報を採取するための「資料採取ツール」をJP1/AJS2 - Manager，JP1/AJS2 - AgentまたはJP1/AJS2 - Viewで提供します。

資料採取ツールは，JP1/AJS2 - Manager，JP1/AJS2 - Agent，JP1/AJS2 - Viewをインストールしたあと，別のフォルダにコピーしてから使用してください。

Windowsの［エクスプローラ］などを使ってフォルダをコピーすることによって，必要なログ情報だけを採取することもできます。

注意

JP1/AJS2 Consoleを使用する場合，JP1/AJS2 - ManagerおよびJP1/AJS2 - Viewの資料採取ツールの環境設定をしていれば，JP1/AJS2 Console AgentおよびJP1/AJS2 Console Viewでの設定は不要です。

資料採取ツールの環境設定をしていない場合は，次の手順に従って設定をしてください。

資料採取ツールを使用するための環境設定手順を次に示します。

［エクスプローラ］などを使って，次に示す資料採取ツールを任意のフォルダにコピーする。

JP1/AJS2 - ManagerまたはJP1/AJS2 - Agentの場合

JP1/AJS2 - ManagerまたはJP1/AJS2 - Agentのインストール先フォルダ¥tools¥_04.bat

この資料採取ツールを実行すると，同一ホスト上のJP1/AJS2 - Viewのログ情報も採取できます。

JP1/AJS2 - Viewの場合

JP1/AJS2 - Viewのインストール先フォルダ¥tools¥_04.bat

この資料採取ツールを実行すると，同一ホスト上のJP1/AJS2 - ManagerまたはJP1/AJS2 - Agentのログ情報も採取できます。

コピーした資料採取ツールを編集して，ユーザー固有のファイル名に変更する。
資料採取ツールの編集にはエディターを使用してください。
次に資料採取ツールに記述されているデフォルト値を示します。このデフォルト値と異なる場合，資料採取ツールの記述を変更してください。

@set INST_DIR_HNTRLIB=%PROGRAMFILES_DIR%¥hitachi¥HNTRLib
HNTRLibのインストール先フォルダを指定します。

@set INST_DIR_HNTRLIB2=%PROGRAMFILES_DIR%¥hitachi¥HNTRLib2
HNTRLib2のインストール先フォルダを指定します。

@set INST_DIR_DATABASE=%INST_DIR_MANAGER%¥hitachi¥JP1AJS2¥database
JP1/AJS2用データベース格納フォルダを指定します。※1

@set LOG_DIR_AJS2CONSOLE_DATABASE=%INST_DIR_AJS2CONSOLE%¥database
JP1/AJS2 Console Managerのデータフォルダを指定します。

@set LOG_DIR_AJSPDDIR=%INST_DIR_MANAGER%¥tmp¥schedule
JP1/AJS2用一時ファイル格納フォルダを指定します。

@set LOG_DIR_JOBINF=%INST_DIR_MANAGER%¥jobinf
JP1/AJS2用ジョブエラー情報格納フォルダを指定します。

@set LOG_DIR_DRWTSN=%ALLUSERSPROFILE%¥Documents¥DrWatson
ワトソン博士のログファイルパスを指定します。※2

@set LOG_DIR_USERDUMP=%Systemroot%¥*.dmp
メモリーダンプのファイルパスを，ファイル名を含めて指定します。※2

@set LOG_DIR_WTSNDUMP=%LOG_DIR_DRWTSN%¥*.dmp
クラッシュダンプのファイルパスを，ファイル名を含めて指定します。※2

@rem @set DIR_ADD=
追加取得を行うフォルダを記述します。「@rem」を削除し，フォルダを絶対パスで記述してください。スケジューラーログファイル1，スケジューラーログファイル2，スケジューラートレースログファイルの出力先を変更している場合は，次の例のように空白区切りで記述してください。また，絶対パスに空白を含む場合は，「"」で囲んで入力してください。
（例）
@set DIR_ADD=[変更したスケジューラーログ出力フォルダ]¥JP1AJS2¥log "[変更したスケジューラートレースログ出力フォルダ]¥sys"

@set DIR_BACKLOG=%TEMP%¥jp1ajs2¥backlog
資料採取ツールで採取した情報の退避先を指定します。

注※1

スケジューラーサービスおよびジョブ実行環境のデータベースに，このフォルダの配下にないフォルダを設定している場合は採取されません。

各データベースファイルを任意のフォルダ下に配置し，そのフォルダまでの絶対パスを指定するようにしてください。

注※2

Windows VistaおよびWindows Server 2008の場合は，取得できません。

資料採取ツールにデフォルトで記述されている各ログファイルの格納フォルダについては，マニュアル「JP1/Automatic Job Management System 2 設計・運用ガイド　17.2.4 ログファイルおよびディレクトリ一覧」およびマニュアル「JP1/Base 運用ガイド」の付録に記載されている，ファイルまたはフォルダの一覧を参照してください。

また，トラブルが発生した場合にメモリーダンプまたはクラッシュダンプが必要となることがあります。トラブル発生時にこれらのダンプを採取する場合は，あらかじめメモリーダンプまたはクラッシュダンプが出力されるように，次の設定をしてください。

メモリーダンプの出力設定

Windows 2000の場合

コントロールパネルの［システム］をダブルクリックする。

［詳細］タブの［起動/回復］ボタンをクリックする。

［デバッグ情報の書き込み］で［完全メモリ ダンプ］をチェックし，［ダンプ ファイル］に出力先のファイルを指定する。

Windows XP ProfessionalおよびWindows Server 2003の場合

コントロールパネルの［システム］をダブルクリックする。

［詳細設定］タブの［起動と回復］の［設定］ボタンをクリックする。

［デバッグ情報の書き込み］で，［完全メモリ ダンプ］を選択し，［ダンプ ファイル］に出力先のファイルを指定する。

注意

メモリーダンプのサイズは，実メモリーのサイズによって異なります。搭載している物理メモリーが大きいと，メモリーダンプのサイズも大きくなります。メモリーダンプを採取できるだけのディスク領域を確保してください。詳細については，Windowsのヘルプの「STOPエラー」の項目を参照してください。

クラッシュダンプの出力設定

Windowsの［スタート］メニューから［ファイル名を指定して実行］を選択する。
［ファイル名を指定して実行］ダイアログボックスが表示されます。

［名前］に「drwtsn32」と入力し，［OK］ボタンをクリックする。
［ワトソン博士］ダイアログボックスが表示されます。

［クラッシュ ダンプ ファイルの作成］をチェックし，［クラッシュ ダンプ］に出力先のファイルを指定する。

［OK］ボタンをクリックする。

注意

クラッシュダンプに出力される情報はJP1だけでなく，ほかのアプリケーションプログラムのトラブル情報も出力されます。また，クラッシュダンプが出力されると，その分ディスク容量が圧迫されます。クラッシュダンプが出力されるように設定する場合は，十分なディスク領域を確保しておいてください。

Windows VistaおよびWindows Server 2008上で資料を採取する場合の注意事項

Windows VistaおよびWindows Server 2008では，ワトソンログを取得できません。また，クラッシュダンプやメモリーダンプを自動取得できないため，これに相当する情報については別途，採取する必要があります。採取方法については，マニュアル「JP1/Automatic Job Management System 2 設計・運用ガイド　17.4.1(3) ユーザーダンプを採取する（Windows VistaおよびWindows Server 2008の場合）」および「JP1/Automatic Job Management System 2 設計・運用ガイド　17.4.1(4) 問題レポートを採取する（Windows VistaおよびWindows Server 2008限定）」を参照してください。

64ビット版Windows上で資料を採取する場合の注意事項

64ビット版Windowsを使用し，Windows on Windows 64環境下でJP1/AJS2の資料採取ツールで資料採取する場合，資料採取ツールを修正する必要があります。次のように修正してください。

資料採取ツールを任意のフォルダにコピーする。

テキストエディターを使用して，コピーしたバッチファイルを次のように編集し，任意のファイル名で保存する。

(2)　資料採取ツールの注意事項

07-10以降の資料採取ツールと07-10より前のバージョンの資料採取ツールでは，次の表に示す相違があります。

表8-1　資料採取ツールの相違点

機能
07-10以降
07-10より前のバージョン

次の資料の採取

Windowsレジストリー情報

Windowsイベントログ情報

マシン構成情報

サービス起動されているPP一覧

データベース格納フォルダのファイルリスト情報

JP1/Baseのファイルリスト情報

core解析に必要な情報

採取する。
採取しない。

論理ホストの指定
資料採取ツールの実行時に論理ホスト名を指定する。
資料採取ツールの環境設定で，論理ホストごとの情報格納フォルダを設定する。

初期調査ファイルの分離
初期調査ファイルを専用フォルダに保存する。
初期調査に必要なファイルが分散して出力される。

JP1/AJS2サービス起動中でのログの採取
資料採取ツール実行時に-sオプションを指定する。
採取不可。

07-10より前のバージョンの資料採取ツールをカスタマイズして，既存の情報以外の情報を取得していた場合，07-10以降にバージョンアップしても07-10以降の資料採取ツールには反映されません。

9.　クラスタシステム運用時のセットアップ

この章では，JP1/AJS2をクラスタシステムで運用する場合のセットアップ方法について説明します。

なお，クラスタシステムとは，これまでJP1のマニュアルで「系切り替えシステム」と呼ばれていたものと同じです。

＜この章の構成＞

9.1　クラスタ運用の前提

9.2　クラスタ運用の概要

9.3　クラスタシステム運用時のインストールとセットアップ

9.4　クラスタ運用の環境設定

9.5　クラスタ運用時の注意事項

9.1　クラスタ運用の前提

JP1/AJS2をクラスタシステムで使用する場合，次に示す前提条件があります。

クラスタソフトは，次に示す2～4を制御できるプログラムであること。

実行系から待機系へ引き継ぎ可能な共有ディスクが使用できること。
詳細には次に示す条件を満たすこと。

JP1を起動する前に，共有ディスクが割り当てられること。

JP1を実行中に，共有ディスクの割り当てが解除されないこと。

JP1を停止したあとに，共有ディスクの割り当てが解除されること。

実行系ノード以外からは共有ディスクをアクセスできないよう排他制御されていること。

システムダウンなどでファイルが消えないよう，ジャーナル機能を持つファイルシステムなどでファイルを保護すること。

フェールオーバーしてもファイルに書き込んだ内容が保証されて引き継がれること。

フェールオーバー時に共有ディスクを使用中のプロセスがあっても，強制的にフェールオーバーできること。

共有ディスクの障害を検知した場合の回復処置はクラスタソフトなどが制御し，回復処置をJP1が意識する必要がないこと。回復処置の延長での起動や停止が必要な場合は，クラスタソフトからJP1に起動や停止の実行要求をすること。

論理IPアドレスとして次に示す条件を満たすこと。

引き継ぎ可能な論理アドレスを使って通信できること。

論理ホスト名から論理アドレスが一意に求まること。

JP1を起動する前に，論理アドレスが割り当てられること。

JP1を実行中に，論理アドレスが削除されないこと。

JP1を実行中に，論理ホスト名と論理アドレスの対応が変更されないこと。

JP1を停止したあとに，論理アドレスが削除されること。

ネットワーク障害を検知した場合の回復処置はクラスタソフトなどが制御し，JP1が回復処理を意識する必要がないこと。また，回復処置の延長でJP1の起動や停止が必要な場合は，クラスタソフトからJP1に起動や停止の実行要求をすること。

多重起動する場合，論理ホストごとに一つずつのIPアドレスが割り当てられていること。

論理ホスト名が，hostsファイルやネームサーバに設定され，TCP/IP通信ができるようになっていること。DNS運用の場合には，JP1ホスト名として別名定義が必要になることがあるため，論理ホスト名として，FQDN形式でないJP1ホスト名が使用可能で，その論理ホストがネットワーク内で認識できることが必要。

前提であるJP1/Baseが，クラスタシステムを使用できる環境になっていること。

スケジューラーデータベースに組み込みDBを使用する場合，ホスト名に関して次に示す制限がある。

組み込みDB環境を構築するホストのホスト名をjp1hosts定義ファイルに登録しても，組み込みDBで使用するホスト名として有効にならない。

組み込みDB環境を構築するホストのホスト名には，エイリアス名を使用できない。

組み込みDBが稼働できるホストのホスト名は，最大32バイトとなる。したがって，組み込みDB環境を構築するホストは，実行系の物理ホスト名および論理ホスト名共に1～32バイトで設定する必要がある。

9.2　クラスタ運用の概要

JP1/AJS2のクラスタ運用の運用例を説明します。なお，クラスタシステムや，同時に利用するアプリケーションプログラム（JP1のプログラムを含みます）は，この形態に対応していないことがあります。各プログラムのマニュアルで確認してください。

＜この節の構成＞

9.2.1　基本的な運用方法

9.2.1　基本的な運用方法

クラスタシステムでフェールオーバーさせる場合の基本的な運用方法を説明します。フェールオーバーをする場合，JP1/AJS2では，フェールオーバーする単位ごとに論理ホスト名を割り当てて運用することになります。この論理ホスト名を使用して，フェールオーバーする単位ごとの多重起動および管理対象システムにアクセスします。

論理ホスト名には，「9.1 クラスタ運用の前提」で示した前提条件に基づいて割り当てられたホスト名を使用してください。DNS運用の場合は，FQDN形式でないホスト名を使用してください。

論理ホスト名を指定することで，サービス（デーモン）の起動およびコマンドの実行が論理ホストごとにできるようになります。論理ホスト名は次のどちらかの方法で指定します。

環境変数JP1_HOSTNAME

各コマンドの論理ホスト指定オプション（通常は-hオプションです。詳細は各コマンドの説明を参照してください）
論理ホスト指定オプションが指定されていない場合，各コマンドは，環境変数JP1_HOSTNAMEに設定された論理ホスト名を使用して実行されます。

ただし，環境変数JP1_HOSTNAMEをシステム環境変数，ユーザー環境変数として設定しないでください。サービスの起動などができなくなることがあります。環境変数JP1_HOSTNAMEは，コマンドプロンプトまたはバッチファイルで設定してください。

9.3　クラスタシステム運用時のインストールとセットアップ

クラスタ運用に対応するためのインストールおよびセットアップについて説明します。

＜この節の構成＞

9.3.1　クラスタ運用時のインストール

9.3.2　クラスタ運用時のセットアップ

9.3.3　クラスタ運用時の組み込みDBのインストール（JP1/AJS2 - Manager）

9.3.4　クラスタ運用時の組み込みDBのセットアップ（JP1/AJS2 - Manager）

9.3.5　クラスタ運用時の監視方法

9.3.1　クラスタ運用時のインストール

実行系，待機系それぞれのローカルディスク上にJP1/AJS2をインストールしてください。インストールの際には，実行系，待機系とも，同じ名称のドライブおよびフォルダを指定してください。

注意

共有ディスク上には，JP1/AJS2をインストールしないでください。

9.3.2　クラスタ運用時のセットアップ

JP1/AJS2をクラスタ運用するシステムを構築する場合の，Windowsホストのセットアップについて説明します。

クラスタ運用時のセットアップ手順を次の図に示します。

図9-1　クラスタ運用時のセットアップ手順

実行系と待機系のJP1シリーズプログラムは，同じドライブおよび同じフォルダにインストールしてください。図中の，JP1/BaseおよびJP1/AJS2シリーズプログラムのセットアップについては，「3. セットアップ」を参照してください。また，クラスタシステムのセットアップについては，使用するクラスタシステムのドキュメントを参照してください。

ここでは，クラスタ運用に必要な設定項目について説明します。説明中のコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 2 コマンドリファレンス　1. コマンド」を参照してください。

なお，JP1/AJS2でクラスタシステムのセットアップをする前に，必ずJP1/Baseでクラスタシステムをセットアップしておいてください。

また，クラスタ運用する場合は，使用するクラスタソフトへの対応を確認してからセットアップおよび運用してください。

9.3.3　クラスタ運用時の組み込みDBのインストール（JP1/AJS2 - Manager）

JP1/AJS2 - Managerでスケジューラーデータベースとして組み込みDBを使用する場合は，実行系，待機系それぞれのローカルディスク上に，組み込みDBをインストールしてください。インストールの際には，実行系，待機系とも，同じ名称のドライブおよびフォルダを指定してください。

＜この項の構成＞

(1)　環境変数TZ

(2)　セットアップ識別子の設定

(1)　環境変数TZ

組み込みDBインストール時に，環境変数TZの設定を要求されます。セットアップ終了後に，システム環境変数にTZを追加してください。

（例）

TZ=JST-9

(2)　セットアップ識別子の設定

セットアップ識別子に_JAn（n：1～9，A～Zの任意の文字）を指定します。

なお，クラスタ構成時，物理ホストおよび複数の論理ホストを同一マシン内に共存し，別々の組み込みDBサーバを使用する場合は，セットアップ識別子が重複しないようにしてください。

注意

共有ディスク上には，組み込みDBをインストールしないでください。

9.3.4　クラスタ運用時の組み込みDBのセットアップ（JP1/AJS2 - Manager）

＜この項の構成＞

(1)　必要なファイルシステム容量の見積もり，および組み込みDBファイルシステム領域の準備

(2)　組み込みDBサーバの構築

(3)　JP1/AJS2の設定

(4)　クラスタソフトへの登録

(5)　クラスタサービスの登録

(1)　必要なファイルシステム容量の見積もり，および組み込みDBファイルシステム領域の準備

領域作成時の注意事項

組み込みDBファイルシステム領域は，ファイルシステム（NTFS）としてフォーマットした共有ディスク上のパーティションに作成してください。また，ローカルディスクに30メガバイト程度の空きのある作業ディレクトリが必要です。

ここで用意するファイルシステム領域は，組み込みDBファイルシステム領域として確保する必要があるものです。JP1/AJS2で使用するデータベースディレクトリ（ジョブ実行環境用およびスケジューラーユニット管理用）は別途必要です。

表9-1　組み込みDBサーバに必要なパーティションサイズ

規模 | RDエリア用 | システムファイル1用 | システムファイル2用※
大規模 | 1,600メガバイト | 3,402メガバイト | 3,402メガバイト
中規模 | 800メガバイト | 1,200メガバイト | 1,200メガバイト
小規模 | 300メガバイト | 702メガバイト | 702メガバイト

注※

組み込みDBのシステムログ領域を二重化する場合に必要となります。

(2)　組み込みDBサーバの構築

ajsembdbbuildスクリプトを使用して，組み込みDBサーバを構築します。

セットアップに使用するajsembdbbuildスクリプトは，JP1/AJS2 - Managerのインストール先フォルダ¥toolsディレクトリにあります。

次に示す環境条件の構築例について説明します。

規模：大規模

ログ運用：システムログ運用（二重化なし）

実行系ホスト：physical1

待機系ホスト：physical2

論理ホスト：lhost

ローカルディスク：cドライブ

共有ディスク：dドライブ

RDエリア作成ディレクトリ：d:¥EmbDB¥RDArea

システムファイル作成ディレクトリ：d:¥EmbDB¥SYSArea

作業ディレクトリ：c:¥localdisk

組み込みDBインストールディレクトリ：c:¥win32app¥hitachi¥hirdb_e_JA0

組み込みDBサーバ構築時の準備
組み込みDBサーバを構築する前に，論理IPアドレスを有効にし，共有ディスクをマウントしておいてください。また，スクリプトを実行するときは，組み込みDBサービスが起動している必要があります。この時点で，組み込みDBサービスが起動している状態であることを確認してください。

注意

セットアップスクリプト内から，組み込みDBシステム定義ファイルを動的に生成します。運用に応じて，オプションの指定が必要です。

セットアップスクリプトは，オプションを省略すると，規定の設定でセットアップします。マルチ組み込みDB環境を作成する場合など，既存の組み込みDBでの運用に影響を及ぼさないように注意して使用してください。マルチ組み込みDB環境でセットアップする場合は，ポート番号の重複・環境変数の設定に誤りがないことを確認して実行してください。ajsembdbbuildスクリプトの使用方法については，「20. セットアップ時に使用するコマンド　ajsembdbbuild」を参照してください。

組み込みDBが稼働できるホストのホスト名は，最大32バイトです。したがって，組み込みDB環境を構築するホストは，物理ホストおよび論理ホスト共に1～32バイトで設定してください。

実行系の組み込みDBサーバ環境の構築
ajsembdbbuildスクリプトを実行します。

ajsembdbbuild -l -d "d:¥EmbDB¥RDArea,d:¥EmbDB¥SYSArea"
 -ld c:¥localdisk -bs -r -mh lhost -eh physical1
  -i c:¥win32app¥hitachi¥hirdb_e_JA0

注意

実行系でセットアップする場合は，-rオプションを指定してください。

明示的にオプションを指定しない場合は，ポート番号，テーブルプリフィックスなどは標準設定になるため，重複しないように注意してください。

-ld，-iオプションには共有ディスクを指定しないでください。

待機系の組み込みDBサーバ環境の構築
ajsembdbbuildスクリプトを実行します。

ajsembdbbuild -l -d "d:¥EmbDB¥RDArea,d:¥EmbDB¥SYSArea"
-ld c:¥localdisk -bs -f -mh lhost -eh physical1
 -i c:¥win32app¥hitachi¥hirdb_e_JA0

注意

待機系で実行する場合は，-rオプションではなく，-fオプションを指定してください。それ以外は，実行系と同じオプションを指定してください。

待機系ホストのセットアップであっても，-ehオプションには実行系物理ホスト名を指定してください。

-ld，-iオプションには共有ディスクを指定しないでください。

(3)　JP1/AJS2の設定

JP1/AJS2スケジューラーデータベースの組み込みDB化は，ISAMからの移行によって構築します。このため，JP1/AJS2のデータベースをいったんISAMで構築してください。

JP1/Base，JP1/AJS2の設定方法については，「9.4 クラスタ運用の環境設定」についても参照してください。

JP1/AJS2関連サービスの停止
JP1/AJS2の関連サービスが起動している場合，これらを停止してください。
物理ホスト・論理ホストすべてのJP1/AJS2サービスを停止します。

組み込みDBへの移行（実行系）
スケジューラーサービスのデータベースの移行には，ajsembdbsetupスクリプトを使用します。ajsembdbsetupスクリプトは，JP1/AJS2 - Managerのインストール先フォルダ¥toolsディレクトリにあります。ajsembdbsetupスクリプトの使用方法については，「20. セットアップ時に使用するコマンド　ajsembdbsetup」を参照してください。
スケジューラーサービスのデータベースを移行する場合は，いったんスケジューラーサービスのデータベースをISAMに変更する必要があります。
スケジューラーサービスのデータベースを組み込みDBからISAMに変更する方法については，マニュアル「JP1/Automatic Job Management System 2 設計・運用ガイド　15.14.2 スケジューラーデータベースで使用するDBMSを変更する」を参照してください。
スケジューラーサービスのデータベースをOracleからISAMに変更する方法については，「付録C Oracleデータベースの移行」を参照してください。
（例）
論理ホストlhostのスケジューラーサービスAJSROOT2で組み込みDBを使用する場合

ajsembdbsetup -mh lhost -F AJSROOT2 -ru l

JP1共通定義情報のコピー
実行系サーバで構築した論理ホスト環境をセットアップしたときに，JP1共通定義情報に論理ホストの定義情報が設定されます。新規インストールの場合，JP1共通定義情報の設定が，実行系と待機系で同じになるように設定内容を実行系から待機系にコピーします。

(4)　クラスタソフトへの登録

組み込みDBのクラスタ開始モード

組み込みDBをセットアップ直後のpd_mode_confは，MANUAL1（常に手動起動）です。

構築する環境に応じて，組み込みDBのパラメーターpd_mode_confを編集してください。

MANUAL1：

手動起動します。ただし，組み込みDB異常終了後の再開始は自動起動になります。

MANUAL2：

手動起動します。

組み込みDBの定義ファイルの編集は，次の手順で行ってください。

・実行系

組み込みDBを使用しているスケジューラーサービスを停止する。

組み込みDBを停止する。

組み込みDBの定義ファイルを編集する。
定義ファイル：pdsys
定義パラメーター：set pd_mode_conf = MANUAL1 | MANUAL2
上記ファイルを格納しているディレクトリは，次に示す場所になります。
組み込みDB運用ディレクトリ¥conf

組み込みDBを起動する。

組み込みDBを使用しているスケジューラーサービスを起動する。

・待機系

組み込みDBの定義ファイルを編集する。
定義ファイル：pdsys
定義パラメーター：set pd_mode_conf = MANUAL1 | MANUAL2
上記ファイルを格納しているディレクトリは，次に示す場所になります。
組み込みDB運用ディレクトリ¥conf

注意

組み込みDBの定義ファイルは，ajsembdbbuild実行時にディレクトリに作成され，環境を削除した際に削除されるので，ユーザーが定義ファイルを直接編集する場合には注意が必要です。

(5)　クラスタサービスの登録

JP1/AJS2の同一論理ホスト（同一グループ）に，組み込みDBの「HiRDB/ClusterService _JAn」を設定してください。

クラスタソフトに登録するときは，JP1/AJS2のサービスよりも先に起動させる必要があります。

9.3.5　クラスタ運用時の監視方法

＜この項の構成＞

(1)　JP1/AJS2の運用監視

(2)　スケジューラーサービスのデータベースに組み込みDBを使用している場合

(1)　JP1/AJS2の運用監視

クラスタ運用時，JP1/AJS2の起動状態をクラスタソフトで監視する場合は，JP1/AJS2のサービス名をクラスタソフトのリソースに登録してください。

(2)　スケジューラーサービスのデータベースに組み込みDBを使用している場合

組み込みDBサービスで回復できない障害が発生して組み込みDBサービスが停止状態となった場合に，JP1/AJS2のサービスを停止させることで障害を検知するには，次の環境設定を行う必要があります。

Windowsの［スタート］メニューから，［プログラム］－［JP1_Automatic Job Management System 2 - Manager］－［環境設定］を選択する。
［マネージャー環境設定］ダイアログボックスが表示されます。

環境設定を行う論理ホストを選択し，［設定］ボタンをクリックする。

［論理ホスト共通］タブで，次の項目を設定する。
［スケジューラーサービスの再起動回数］：0回
［スケジューラーサービス異常時の処理］：スケジューラーサービスを終了する

［スケジューラーファイルの構成］タブで，次の項目を設定する。
［切断検知する間隔］：300

設定の詳細については，「4.1 スケジューラーサービス環境の設定」を参照してください。また，上記は環境設定パラメーターでも設定できます。次の環境設定パラメーターを該当するスケジューラーサービスに設定してください。

環境設定パラメーター
値
説明

RDBCHECKINTERVAL
300
組み込みDBサービスとの接続確認を行い，切断を検知したときにスケジューラーサービスを自動的に停止させます。

AUTORESTARTCOUNT
0
スケジューラーサービスを構成するプロセスが異常終了した場合に，異常終了したプロセスを自動的に再起動する回数です。
ただし，異常要因は組み込みDBの障害に限らないため，ほかの障害時の回復運用に合わせて指定してください。

MASTERDABEND
yes
スケジューラーサービスの異常時に，スケジューラーサービス全体を異常終了させます。
スケジューラーサービスを多重起動している場合は，すべてのスケジューラーサービスを停止します。

環境設定パラメーターの詳細については，「14.1.3 スケジューラーサービス環境設定パラメーターの定義内容」を参照してください。

スケジューラーサービス環境の設定については，「14.1.1 スケジューラーサービス環境の設定手順」および「9.4.3 共通定義情報変更時の作業」を参照してください。

9.4　クラスタ運用の環境設定

クラスタ運用に対応するためのJP1/AJS2の環境設定について説明します。

＜この節の構成＞

9.4.1　クラスタシステムの環境設定の項目

9.4.2　クラスタシステムの環境設定の手順

9.4.3　共通定義情報変更時の作業

9.4.4　クラスタソフトへの登録

9.4.5　キューレスジョブ実行環境の設定

9.4.6　論理ホストの削除

9.4.7　論理ホストのスケジューラーサービスの多重起動の設定

9.4.1　クラスタシステムの環境設定の項目

ここでは，環境設定で設定する項目について説明します。実際の設定手順については「9.4.2 クラスタシステムの環境設定の手順」で説明します。

＜この項の構成＞

(1)　共有ディスクへの共有ファイルの作成

(2)　通信方式の設定

(3)　共通定義情報の設定

(4)　サービスの登録

(1)　共有ディスクへの共有ファイルの作成

実行系・待機系の切り替え時に情報を共有するために，フォルダやファイルを共有ディスク上に作成します。作成するフォルダの種類とフォルダ名を次の表に示します。これらフォルダは，jp1ajs2hasetup.exe実行時に［実行系論理ホストの設定］ダイアログボックスの［ファイルフォルダ］で指定したフォルダの下に自動的に作成されます。作成されたフォルダの権限は，［ファイルフォルダ］で指定したフォルダの権限を継承して設定されます。作成されたフォルダ，および上位のフォルダに，ジョブやコマンドを実行するOSユーザーのアクセス権限が不足していると，ジョブやコマンドが異常終了する場合があります。

表9-2　共有ディスクに作成するフォルダの種類とフォルダ名（JP1/AJS2 - Manager）

共有フォルダの種類 | フォルダ名
構成定義ファイル | 共有フォルダ名¥jp1ajs2¥conf
ジョブ実行環境ファイル | 共有フォルダ名¥jp1ajs2¥database
ジョブ情報ファイル | 共有フォルダ名¥jp1ajs2¥jobinf
ログファイル | 共有フォルダ名¥jp1ajs2¥log
システムファイル | 共有フォルダ名¥jp1ajs2¥sys
作業ファイル | 共有フォルダ名¥jp1ajs2¥tmp
バックアップファイル | 共有フォルダ名¥jp1ajs2¥backup
JP1/AJS2 Console Managerのデータディレクトリ | 共有フォルダ名¥jp1ajs2cm¥database※

注※

jp1ajs2hasetup.exe実行時に自動的に作成されませんので，JP1/AJS2 Console Managerをクラスタシステムで運用する場合にフォルダを作成してください。

表9-3　共有ディスクに作成するフォルダの種類とフォルダ名（JP1/AJS2 - Agent）

共有フォルダの種類 | フォルダ名
構成定義ファイル | 共有フォルダ名¥jp1ajs2¥conf
ログファイル | 共有フォルダ名¥jp1ajs2¥log
システムファイル | 共有フォルダ名¥jp1ajs2¥sys
作業ファイル | 共有フォルダ名¥jp1ajs2¥tmp

共有フォルダは，JP1/Baseで論理ホストの環境設定時に指定したフォルダを指定してください。論理ホストが異なる場合は，別のフォルダを割り当ててください。論理ホストごとに割り当てたフォルダ下に，共有するフォルダやファイルを作成します。

（例）

論理ホスト「node0」の共有ディスクを「e:¥shdsk¥node0」とした場合

e:¥shdsk¥node0¥jp1ajs2¥conf
e:¥shdsk¥node0¥jp1ajs2¥database
e:¥shdsk¥node0¥jp1ajs2¥jobinf
e:¥shdsk¥node0¥jp1ajs2¥log
e:¥shdsk¥node0¥jp1ajs2¥sys
e:¥shdsk¥node0¥jp1ajs2¥tmp
e:¥shdsk¥node0¥jp1ajs2¥backup
e:¥shdsk¥node0¥jp1ajs2cm¥database

注意事項

jp1ajs2hasetup.exe実行時に作成されるフォルダのセキュリティは，上位フォルダのセキュリティの設定に依存し，通常は上位フォルダのセキュリティの設定を継承します。そのため，JP1/AJS2を操作するユーザーが，共有フォルダにアクセスする権限がない状態でjp1ajs2hasetup.exeを実行した場合，作成されたフォルダにアクセスする権限が与えられないため，JP1/AJS2の操作時にエラーとなることがあります。

必要に応じて，JP1/AJS2を操作するユーザーまたはEveryoneに，次のフォルダの書き込み権限および読み取り権限を設定してください。

対象フォルダ

共有フォルダ¥jp1ajs2

共有フォルダ¥jp1ajs2配下のすべてのフォルダ

(2)　通信方式の設定

通信で使用するTCP/IPソケットにIPアドレスをバインドする方法が設定されます。クラスタシステムで多重起動をする場合は，物理ホストも含めてすべてIPアドレスにバインドする方式を使用します。「9.4.2 クラスタシステムの環境設定の手順」に従うと，IPアドレスにバインドする方式が自動的に設定されます。

スケジューラーサービスの多重起動の設定でジョブ状態通知ポートのサービス名に対するポート番号を追加している場合は，ポート番号の設定をしてください。

(3)　共通定義情報の設定

JP1/AJS2，JP1/Base，JP1/IMでは，論理ホストごとの情報を共通定義情報としてローカルディスク上に持っており，論理ホストごとに同じ内容にしておく必要があります。

引き継がれる情報は，構成定義ファイルやジョブ実行環境ファイルなどです。

(4)　サービスの登録

論理ホスト対応のサービスを登録します。サービスは，次の名称で登録されます。

表示名称：JP1/AJS2_論理ホスト名

サービス名：JP1_AJS2_論理ホスト名

9.4.2　クラスタシステムの環境設定の手順

「9.4.1 クラスタシステムの環境設定の項目」で説明した項目を，画面で定義します。実行系と待機系でそれぞれ作業が必要です。

次に，Windowsの環境設定画面について，実行系と待機系それぞれでの作業を説明します。なお，環境設定は，JP1のすべてのサービスを停止したあと，JP1/AJS2 - ManagerまたはJP1/AJS2 - Agentで実施してください。

環境設定の手順を次に示します。

＜この項の構成＞

(1)　実行系での作業（JP1/AJS2 - Manager）

(2)　待機系での作業（JP1/AJS2 - Manager）

(3)　実行系での作業（JP1/AJS2 - Agent）

(4)　待機系での作業（JP1/AJS2 - Agent）

(1)　実行系での作業（JP1/AJS2 - Manager）

JP1/Baseの実行系での作業をする。
JP1/Baseの作業については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/AJS2 Consoleを使用する場合は，物理ホストのセットアップをする。
JP1/AJS2 Console ManagerおよびJP1/AJS2 Console Agentを使用する場合は，それぞれ次のコマンドを実行します。

JP1/AJS2 Consoleのインストール先フォルダ¥bin¥ajscmsetup.exe
JP1/AJS2のインストール先フォルダ¥bin¥ajscasetup.exe

すでに物理ホストのセットアップがされている場合は上記コマンドの実行は不要です。ただし，JP1/AJS2 Consoleのサービスの起動方法が「自動」になっていない場合は，「自動」にしてください。

「JP1/AJS2のインストール先フォルダ¥bin¥jp1ajs2hasetup.exe」を実行する。
［AJS2クラスタ構成の設定］ダイアログボックスが表示されます。

図9-2　［AJS2クラスタ構成の設定］ダイアログボックス

［実行系論理ホストの設定］ボタンをクリックする。
［実行系論理ホストの設定］ダイアログボックス（入力用）が表示されます。

図9-3　［実行系論理ホストの設定］ダイアログボックス（入力用）（JP1/AJS2 - Manager）

情報を作成する論理ホスト名および共有フォルダ・共有ファイルを作成する共有ディスク上のフォルダを指定する。また，スケジューラーサービスについても指定する。
「指定したフォルダ名¥jp1ajs2¥」フォルダ下に，共有フォルダおよび共有ファイルがローカルディスクからコピーされます。
なお，このフォルダを指定するときには，共有ディスクを参照できる状態にしておく必要があります。
スケジューラーサービスについては，次のように設定します。

［スケジューラーサービス名］

一意のスケジューラーサービス名を指定します。ほかのスケジューラーサービス名と重複しない名称を指定してください。名称が重複している場合，エラーメッセージ「指定されたサービスは登録済みです。」が表示されます。

なお，JP1/AJS2 - Agentでは設定不要です。

［スケジューラーサービスの識別番号］

スケジューラーサービスの識別番号を1～20の間で指定します。識別番号は，自ホスト内の物理ホストおよびすべての論理ホストで使用している識別番号と重複しない番号を指定してください。値が重複している場合，エラーメッセージ「スケジューラーサービスの識別番号に指定された値は，ほかの論理ホスト，または別のサービスの設定値と重複しています。重複しない値を設定してください。」が表示されます。

すでに指定されている識別番号は，jbsgetcnfコマンドで共通定義情報を取得し，共通定義パラメーターAJSSERVICEIDに設定されている値で確認できます。共通定義パラメーターAJSSERVICEIDは，スケジューラーサービスが複数設定されている場合には複数の設定値があります。そのため，物理ホストおよび論理ホストの共通定義を取得し，すべての定義で指定する識別番号が重複しないことを確認してください。

なお，JP1/AJS2 - Agentでは設定不要です。

［ジョブ状態通知ポートのサービス名］

「jp1ajs2report」を指定します。なお，一つの論理ホストで複数のスケジューラーサービスを起動する場合は，別のサービス名を指定します。

サービス名はservicesファイルに登録しておいてください。

論理ホストでスケジューラーサービスを多重起動する設定が必要な場合は，「9.4.7(1) 論理ホストでスケジューラーサービスを多重起動する」を参照して設定してください。

なお，JP1/AJS2 - Agentでは設定不要です。

［次へ］ボタンをクリックする。
［実行系論理ホストの設定］ダイアログボックス（確認用）が表示されます。

図9-4　［実行系論理ホストの設定］ダイアログボックス（確認用）

内容を確認し，内容が正しければ［完了］ボタンをクリックする。

JP1/AJS2 Console Managerの環境設定をする。
JP1/AJS2 Console Managerを使用している場合，次の手順でJP1/AJS2 Console Managerの環境設定をしてください。
なお，JP1/AJS2 Console Agentのクラスタ運用時の環境設定は，JP1/AJS2 Managerのクラスタ運用時のセットアップ中に実施されるため，JP1/AJS2 Console Agentのクラスタ運用時の環境設定は必要ありません。

1.　テキストエディターで構成定義ファイルを作成する。

作成する構成定義ファイルの内容を次に示します。

[論理ホスト名¥JP1AJS2CONSOLEMANAGER]

"DATADIRECTORY"="論理ホストのデータディレクトリのフォルダパス"

論理ホスト名が「node0」で，論理ホストの共有フォルダが「e:¥shdsk¥node0」の場合の指定例を次に示します。

[node0¥JP1AJS2CONSOLEMANAGER]

"DATADIRECTORY"="e:¥shdsk¥node0¥jp1ajs2cm¥database"

2.　構成定義ファイルを任意のフォルダに保存する。

ファイル名の例を次に示します。

jp1ajs2cm_node0.txt

3.　次に示すコマンドを実行して構成定義ファイルの情報を設定する。

jbssetcnf 構成定義ファイル名

jbssetcnfコマンドのパスは，「JP1/Baseのインストール先フォルダ¥bin¥jbssetcnf」です。

jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

コマンドの指定例を次に示します。

jbssetcnf jp1ajs2cm_node0.txt

スケジューラーサービスのデータベース作成のために，ajssetupコマンドを実行する。

（例）

JP1/AJS2データベースとしてISAMを使用する場合

ajssetup -F サービス名 -t -mh 論理ホスト名

ajssetupコマンドの詳細については，「20. セットアップ時に使用するコマンド　ajssetup」を参照してください。
JP1/AJS2データベースとして組み込みDBを使用する場合は，「5. スケジューラーデータベースに組み込みDBを使用する場合のセットアップ」を参照してください。

キューレスジョブを利用する場合は，キューレスジョブのセットアップをする。
次のコマンドを実行します。

ajsqlsetup -h 論理ホスト名 -F スケジューラーサービス名

ajsqlsetupコマンドの詳細については「20. セットアップ時に使用するコマンド　ajsqlsetup」を参照してください。

注意事項

ajsqlsetupコマンドを実行すると，共有ディスク上にキューレスジョブの実行に必要なファイルを作成し，チェックしますので，必ず共有ディスクをマウントしてから実行してください。

論理ホストで使用するファイルやフォルダを作成するために，jpqimportコマンドを実行する。

（例）

JP1/AJS2データベースとしてISAMを使用する場合

jpqimport -dt isam -ci ジョブ実行環境構成定義ファイル名 -mh 論理ホスト名

jpqimportコマンドの詳細については「20. セットアップ時に使用するコマンド　jpqimport」を参照してください。

論理ホストのサービスの設定を確認する。

スケジューラーデータベースにISAMを使用する場合は，マネージャー環境設定の「スケジューラーファイルの構成」で，データファイル更新モードを「同期」に設定してください。

マネージャー環境設定の「スケジューラーオプション」で，「サービス起動モード」など，運用に適したオプションを選択してください。

JP1/AJS2サービス起動時のISAMファイル自動再編成機能を有効にする。
論理ホストの共有フォルダが「e:¥shdsk¥node0」の場合，「e:¥shdsk¥node0¥jp1ajs2¥conf¥jp1ajs_spmd_pre.conf.model」ファイルを，jp1ajs_spmd_pre.confファイルにコピーします。

これで実行系での作業は完了です。

注意事項

設定は論理ホストごとに実施してください。

実行系の論理ホストの設定（jp1ajs2hasetup.exeコマンド）は，物理ホストのスケジューラーサービスの多重起動が設定されていない状態で実行してください。

論理ホストでスケジューラーサービスを多重起動する設定が必要な場合は，「9.4.7(1) 論理ホストでスケジューラーサービスを多重起動する」を参照して設定してください。

実行系の論理ホストの設定（jp1ajs2hasetup.exeコマンド）を実行すると，物理ホストのjp1ajs_spmd.confファイルが論理ホストにコピーされます。そのため，物理ホストの設定を引き継いで，論理ホストに必要のないプロセスが起動されることがあります。物理ホストでjp1ajs_spmd.confファイルを編集している場合は，論理ホストのjp1ajs_spmd.confファイルを編集し，必要なプロセスだけが起動されるようにしてください。

(2)　待機系での作業（JP1/AJS2 - Manager）

JP1/AJS2 Consoleを使用する場合は，物理ホストのセットアップをする。
JP1/AJS2 Console ManagerおよびJP1/AJS2 Console Agentを使用する場合は，それぞれ次のコマンドを実行します。

JP1/AJS2 Consoleのインストール先フォルダ¥bin¥ajscmsetup.exe
JP1/AJS2のインストール先フォルダ¥bin¥ajscasetup.exe

すでに物理ホストのセットアップがされている場合は上記コマンドの実行は不要です。ただし，JP1/AJS2 Consoleのサービスの起動方法が「自動」になっていない場合は，「自動」にしてください。

実行系でのJP1/Base，JP1/AJS2，JP1/IMの作業を完了させたあと，実行系の共通定義情報を退避し，待機系に共通定義情報を設定する。
実行系での作業が完了したあと，実行系でjbsgetcnfコマンドを実行し，共通定義情報を退避します。その退避ファイルを待機系にコピーし，退避ファイルを引数に指定してjbssetcnfコマンドを実行します。実行するコマンドを次に示します。

実行系

jbsgetcnf -h 論理ホスト名 > 退避ファイル名

待機系

jbssetcnf 退避ファイル名

JP1/Baseの待機系での作業をする。
JP1/Baseの作業については，マニュアル「JP1/Base 運用ガイド」を参照してください。

「JP1/AJS2のインストール先フォルダ¥bin¥jp1ajs2hasetup.exe」コマンドを実行する。
［AJS2クラスタ構成の設定］ダイアログボックスが表示されます。

［待機系論理ホストの設定］ボタンをクリックする。
［待機系論理ホストの設定］ダイアログボックス（入力用）が表示されます。

図9-5　［待機系論理ホストの設定］ダイアログボックス（入力用）

実行系で設定した論理ホスト名を指定し，［次へ］ボタンをクリックする。
［待機系論理ホストの設定］ダイアログボックス（確認用）が表示されます。

図9-6　［待機系論理ホストの設定］ダイアログボックス（確認用）

内容を確認し，内容が正しければ［完了］ボタンをクリックする。

キューレスジョブを利用する場合は，キューレスジョブのセットアップをする。
次のコマンドを実行します。

ajsqlsetup -h 論理ホスト名 -F スケジューラーサービス名 -nc

スケジューラーサービスの多重起動の設定でジョブ状態通知ポートのサービス名に対するポート番号を追加する場合は，servicesファイルにポート番号を設定する。

これで待機系での作業は終了です。

注意事項

設定は論理ホストごとに実施してください。

論理ホストでスケジューラーサービスを多重起動する設定が必要な場合は，「9.4.7(1) 論理ホストでスケジューラーサービスを多重起動する」を参照して設定してください。

(3)　実行系での作業（JP1/AJS2 - Agent）

JP1/Baseの実行系での作業をする。
JP1/Baseの作業については，マニュアル「JP1/Base 運用ガイド」を参照してください。

「JP1/AJS2のインストール先フォルダ¥bin¥jp1ajs2hasetup.exe」を実行する。
［AJS2クラスタ構成の設定］ダイアログボックスが表示されます。

図9-7　［AJS2クラスタ構成の設定］ダイアログボックス

［実行系論理ホストの設定］ボタンをクリックする。
［実行系論理ホストの設定］ダイアログボックス（入力用）が表示されます。

図9-8　［実行系論理ホストの設定］ダイアログボックス（入力用）（JP1/AJS2 - Agent）

情報を作成する論理ホスト名および共有フォルダ・共有ファイルを作成する共有ディスク上のフォルダを指定する。
「指定したフォルダ名¥jp1ajs2¥」フォルダ下に，共有フォルダおよび共有ファイルがローカルディスクからコピーされます。なお，このフォルダを指定するときには，共有ディスクを参照できる状態にしておく必要があります。
スケジューラーサービスについては，次のように設定します。

［次へ］ボタンをクリックする。
［実行系論理ホストの設定］ダイアログボックス（確認用）が表示されます。

図9-9　［実行系論理ホストの設定］ダイアログボックス（確認用）

内容を確認し，内容が正しければ［完了］ボタンをクリックする。

キューレスジョブを利用する場合は，キューレスジョブのセットアップをする。
次のコマンドを実行します。

エージェント環境の場合（JP1/AJS2 - Agent）

ajsqlsetup -h 論理ホスト名

注意事項

ajsqlsetupコマンドを実行すると，共有ディスク上にキューレスジョブの実行に必要なファイルを作成し，チェックしますので，必ず共有ディスクをマウントしてから実行してください。

これで実行系での作業は完了です。

注意事項

設定は論理ホストごとに実施してください。

(4)　待機系での作業（JP1/AJS2 - Agent）

実行系でのJP1/Base，JP1/AJS2，JP1/IMの作業を完了させたあと，実行系の共通定義情報を退避し，待機系に共通定義情報を設定する。
実行系での作業が完了したあと，実行系でjbsgetcnfコマンドを実行し，共通定義情報を退避します。その退避ファイルを待機系にコピーし，退避ファイルを引数に指定してjbssetcnfコマンドを実行します。実行するコマンドを次に示します。

実行系

jbsgetcnf -h 論理ホスト名 > 退避ファイル名

待機系

jbssetcnf 退避ファイル名

JP1/Baseの待機系での作業をする。
JP1/Baseの作業については，マニュアル「JP1/Base 運用ガイド」を参照してください。

「JP1/AJS2のインストール先フォルダ¥bin¥jp1ajs2hasetup.exe」コマンドを実行する。
［AJS2クラスタ構成の設定］ダイアログボックスが表示されます。

［待機系論理ホストの設定］ボタンをクリックする。
［待機系論理ホストの設定］ダイアログボックス（入力用）が表示されます。

図9-10　［待機系論理ホストの設定］ダイアログボックス（入力用）

実行系で設定した論理ホスト名を指定し，［次へ］ボタンをクリックする。
［待機系論理ホストの設定］ダイアログボックス（確認用）が表示されます。

図9-11　［待機系論理ホストの設定］ダイアログボックス（確認用）

内容を確認し，内容が正しければ［完了］ボタンをクリックする。

キューレスジョブを利用する場合は，キューレスジョブのセットアップをする。
次のコマンドを実行します。

エージェント環境の場合（JP1/AJS2 - Agent）

ajsqlsetup -h 論理ホスト名

これで待機系での作業は終了です。

注意事項

設定は論理ホストごとに実施してください。

9.4.3　共通定義情報変更時の作業

クラスタ運用の場合，JP1/Base，JP1/AJS2およびJP1/IMの共通定義情報を各物理ホスト上で一致させる必要があります。実行系の物理ホストでJP1/Base，JP1/AJS2，JP1/IMの設定が完了し，共通定義情報を変更したあと※に次に示すコマンドを実行して，各物理ホスト上の情報を一致させてください。なお，この操作は，JP1/Base，JP1/AJS2およびJP1/IMすべての製品に影響を与えるので注意してください。

実行系

jbsgetcnf -h 論理ホスト名 > 退避ファイル名

待機系

jbssetcnf 退避ファイル名

注※

JP1/AJS2を使用している場合に，JP1/Base，JP1/AJS2およびJP1/IMの共通定義情報が更新されるタイミングを次に示します。

JP1/AJS2をセットアップしたとき。

JP1/AJS2の［マネージャー環境設定］ダイアログボックスまたは［エージェント環境設定］ダイアログボックスで，設定を変更したとき。

JP1/Power Monitorのjpwconfigsetコマンド（クラスタシステムを利用しているJP1/AJS2と連携して，JP1/AJS2でホストの電源を制御する場合に必要な環境を設定するコマンド）で，JP1/AJS2との連携を設定したとき。

9.4.4　クラスタソフトへの登録

使用するクラスタソフトに，フェールオーバーさせるJP1/AJS2 のサービス（デーモン）を登録してください。登録方法の詳細は各クラスタソフトのドキュメントを参照してください。

登録の際は，次の点に注意してください。

JP1/AJS2サービスは，使用するIPアドレスおよび共有ディスクと一緒に実行系から待機系に引き継がれるようにしてください。アプリケーションプログラムも一緒に引き継がれるように設定してください。

IPアドレスおよび共有ディスクが引き継がれ，待機系のJP1/Baseが起動したあとに，JP1/AJS2が起動するようにしてください。

環境設定で登録された「JP1_AJS2_論理ホスト名」という名称のサービスをクラスタソフトに登録してください。

JP1/AJS2 Consoleを使用する場合，JP1/AJS2 Consoleのサービスをクラスタソフトに登録する必要はありません。

キューレスジョブを使用する場合，「9.4.5 キューレスジョブ実行環境の設定」を参照してください。

9.4.5　キューレスジョブ実行環境の設定

キューレスジョブを使用する場合は，系切り替え時に系切り替え元ホストで論理ホストのデタッチ，および系切り替え先ホストの論理ホストのアタッチが必要です。

系切り替え時に自動で論理ホストのアタッチおよびデタッチを行う場合は，次の操作を行ってください。

＜この項の構成＞

(1)　JP1/AJS2 - ManagerまたはJP1/AJS2 - Agentを新規インストールして環境を構築する場合

(2)　JP1/AJS2 - ManagerまたはJP1/AJS2 - Agentを上書きインストールして環境を構築する場合

(3)　キューレスジョブ使用時に論理ホストを自動でアタッチ・デタッチする場合の注意事項

(4)　注意事項

(1)　JP1/AJS2 - ManagerまたはJP1/AJS2 - Agentを新規インストールして環境を構築する場合

JP1/AJS2 - ManagerまたはJP1/AJS2 - Agentを新規インストールして環境を構築する場合に，実行系および待機系で行う操作の手順を次に示します。

JP1/AJS2 - ManagerまたはJP1/AJS2 - Agentを新規インストールする。
インストール手順については，「2.2.2 JP1/AJS2シリーズプログラムをインストールする」を参照してください。

物理ホストをセットアップする。
セットアップ手順については，「3. セットアップ」を参照してください。

論理ホストをセットアップする。
セットアップ手順については，「9.4.2 クラスタシステムの環境設定の手順」を参照してください。

jp1ajs_spmd.confファイルを編集する。
手順3でセットアップした論理ホストのjp1ajs_spmd.confファイルを編集します。JP1/AJS2 - Managerをインストールしていてスケジューラーの状態監視の設定またはジョブネットコネクタで異なるスケジューラーサービス間のルートジョブネットの実行順序を制御するための設定をしていない場合，もしくはJP1/AJS2 - Agentをインストールしている場合は，jp1ajs_spmd.confファイルのバックアップを作成して，jp1ajs_spmd_ql.conf.modelファイルをjp1ajs_spmd.confにリネームしてください。
JP1/AJS2 - Managerをインストールしていてスケジューラーの状態監視の設定またはジョブネットコネクタで異なるスケジューラーサービス間のルートジョブネットの実行順序を制御するための設定をしている場合は，jp1ajs_spmd.confファイルのバックアップを作成し，次のように直接編集してください。

qlcltd|ajsqlcltd.exe|||1800|
queue|jpqmon.exe||qlcltd|1800|
evactionm|jpomanager.exe||queue|1800|
evactiona|jpoagent.exe||evactionm|1800|
ajsovstatd|ajsovstatd.exe||evactiona|1800|
schedule|ajsmasterd.exe||ajsovstatd|1800|

補足事項

異なるスケジューラーサービス間のルートジョブネットの実行順序を制御する場合は，スケジューラーサービス間通信制御プロセス（ajsgwd.exe）を起動するためjp1ajs_spmd.confファイルに「gatewayd|ajsgwmasterd.exe|||1800|」を記述してください。

なお，jp1ajs_spmd.confファイルおよびjp1ajs_spmd_ql.conf.modelファイル格納フォルダは，共有フォルダ名¥jp1ajs2¥confです。

jp1ajs_service_0700.confファイルを編集する。
手順3でセットアップした論理ホストのjp1ajs_service_0700.confファイルを編集します。
jp1ajs_service_0700.confファイルのバックアップを作成して，jp1ajs_service_0700.conf.modelファイルをjp1ajs_service_0700.confにリネームしてください。
なお，jp1ajs_service_0700.confファイルおよびjp1ajs_service_0700.conf.modelファイル格納フォルダは，共有フォルダ名¥jp1ajs2¥confです。

キューレスエージェントサービスおよびキューレスファイル転送サービスを起動する。
キューレスエージェントサービスを起動します。JP1/AJS2 - Managerの場合は，キューレスファイル転送サービスも起動してください。

(2)　JP1/AJS2 - ManagerまたはJP1/AJS2 - Agentを上書きインストールして環境を構築する場合

JP1/AJS2 - ManagerまたはJP1/AJS2 - Agentのバージョン7から上書きインストールして環境を構築する場合に，実行系および待機系で行う操作の手順を次に示します。

JP1/AJS2 - ManagerまたはJP1/AJS2 - Agentを上書きインストールする。
上書きインストール手順については，「2.2.2 JP1/AJS2シリーズプログラムをインストールする」を参照してください。
なお，すでに上書きインストール済みの場合，再度上書きインストールする必要はありません。

物理ホストのキューレスジョブ実行環境をセットアップする。
物理ホストのキューレスジョブ実行環境をセットアップしていない場合は，ajsqlsetupコマンドを使用してセットアップしてください。ajsqlsetupコマンドの詳細については，「20. セットアップ時に使用するコマンド　ajsqlsetup」を参照してください。

論理ホストをセットアップする。
論理ホストをセットアップしていない場合は，セットアップしてください。
セットアップ手順については，「9.4.2 クラスタシステムの環境設定の手順」を参照してください。
また，論理ホストのセットアップ時にキューレスジョブ実行環境をセットアップしていない場合は，ajsqlsetupコマンドを使用してセットアップしてください。ajsqlsetupコマンドの詳細については，「20. セットアップ時に使用するコマンド　ajsqlsetup」を参照してください。

jp1ajs_spmd.confファイルを編集する。
自動アタッチ・デタッチ対象論理ホストのjp1ajs_spmd.confファイルを編集します。
JP1/AJS2 - Managerを上書きインストールしていてスケジューラーの状態監視の設定またはジョブネットコネクタで異なるスケジューラーサービス間のルートジョブネットの実行順序を制御するための設定をしていない場合，もしくはJP1/AJS2 - Agentを上書きインストールしている場合は，jp1ajs_spmd.confファイルのバックアップを作成して，jp1ajs_spmd_ql.conf.modelファイルをjp1ajs_spmd.confにリネームしてください。
JP1/AJS2 - Managerを上書きインストールしていてスケジューラーの状態監視の設定またはジョブネットコネクタで異なるスケジューラーサービス間のルートジョブネットの実行順序を制御するための設定をしている場合は，jp1ajs_spmd.confファイルのバックアップを作成し，次のように直接編集してください。

qlcltd|ajsqlcltd.exe|||1800|
queue|jpqmon.exe||qlcltd|1800|
evactionm|jpomanager.exe||queue|1800|
evactiona|jpoagent.exe||evactionm|1800|
ajsovstatd|ajsovstatd.exe||evactiona|1800|
schedule|ajsmasterd.exe||ajsovstatd|1800|

補足事項

異なるスケジューラーサービス間のルートジョブネットの実行順序を制御する場合は，スケジューラーサービス間通信制御プロセス（ajsgwd.exe）を起動するためjp1ajs_spmd.confファイルに「gatewayd|ajsgwmasterd.exe|||1800|」を記述してください。

なお，jp1ajs_spmd.confファイルおよびjp1ajs_spmd_ql.conf.modelファイル格納フォルダは，共有フォルダ名¥jp1ajs2¥confです。

jp1ajs_service_0700.confファイルを編集する。
自動アタッチ・デタッチ対象論理ホストのjp1ajs_service_0700.confファイルを編集します。
jp1ajs_service_0700.confファイルのバックアップを作成して，jp1ajs_service_0700.conf.modelファイルをjp1ajs_service_0700.confにリネームしてください。
なお，jp1ajs_service_0700.confファイルおよびjp1ajs_service_0700.conf.modelファイル格納フォルダは，共有フォルダ名¥jp1ajs2¥confです。

キューレスエージェントサービスおよびキューレスファイル転送サービスを起動する。
キューレスエージェントサービスを起動します。JP1/AJS2 - Managerの場合は，キューレスファイル転送サービスも起動してください。

上記の設定後，論理ホストのJP1/AJS2のサービス起動時に，キューレスクラスタプロセスが同時に起動され，自動でキューレスクラスタプロセスから論理ホストのアタッチが行われます。また，論理ホストのJP1/AJS2のサービス停止時に，キューレスクラスタプロセスが同時に停止され，自動でキューレスクラスタプロセスから論理ホストのデタッチが行われます。

(3)　キューレスジョブ使用時に論理ホストを自動でアタッチ・デタッチする場合の注意事項

この機能は，論理ホストごとに設定する必要があります。その際，キューレスクラスタプロセスは，論理ホストごとに生成されます。
なお，キューレスジョブを使用しない論理ホストでは，この機能を設定する必要はありません。

この機能は，クラスタシステム運用をしていない論理ホストでも設定できます。

クラスタシステム運用時にこの機能を使用しない場合は，系切り替え時に手動でajsqlattachコマンドおよびajsqldetachコマンドを実行し，論理ホストのアタッチ・デタッチを行ってください。

この機能を使用する場合は，実行系・待機系ともにキューレスエージェントサービスを事前に起動しておく必要があります。また，系切り替え時にキューレスエージェントサービスを起動・停止する必要はありません。

この機能は，物理ホストでは使用できません。

デフォルトの設定では，自動アタッチに失敗してもキューレスクラスタプロセスを異常終了させないで，論理ホストのJP1/AJS2のサービス起動処理を続行します。キューレスクラスタプロセスを異常終了させて，JP1/AJS2のサービスの起動処理を中止したい場合は，環境設定パラメーターAJSQL_CLUSTERREQに「error」を設定してください。AJSQL_CLUSTERREQの詳細については，「4.4 キューレスジョブ実行環境の設定」を参照してください。

自動デタッチに失敗した場合は，キューレスクラスタプロセスが異常終了します。また，論理ホストのJP1/AJS2のサービス停止処理も異常終了します。

この機能の使用時は，未使用時のjajs_spmd_statusコマンドの実行結果と異なり，キューレスクラスタプロセスの状態も出力されます。
（出力例）

未使用時の場合
   c:¥>jajs_spmd_status -h LHOST1
   KAVB3690-I JP1_AJS2 の状態通知処理を開始します
   稼働中のプロセスを表示します
   プロセス名称  プロセスID
           queue        888
       evactionm       2480
       evactiona       3260
       schedule        4008
   KAVB3691-I プロセスは全て起動しています

使用時の場合
   c:¥>jajs_spmd_status -h LHOST1
   KAVB3690-I JP1_AJS2 の状態通知処理を開始します
   稼働中のプロセスを表示します
   プロセス名称  プロセスID
          qlcltd        436
           queue        888
       evactionm       2480
       evactiona       3260
        schedule       4008
   KAVB3691-I プロセスは全て起動しています

(4)　注意事項

環境設定パラメーターAJSQL_ATTACHの値を「yes」に設定して論理ホストをアタッチする場合，系切り替え時にクラスタソフトなどで系切り替え元のキューレスエージェントサービスを停止し，系切り替え先のキューレスエージェントサービスを起動する必要があります。
このため，物理ホストや系切り替え元のキューレスエージェントサービスにアタッチしているほかの論理ホストで実行していたキューレスジョブが，起動失敗，異常検出終了，または終了状態不明となるおそれがあります。複数のホストでキューレスジョブを実行する運用の場合は，AJSQL_ATTACHを使用しないで，この設定を使用してください。

キューレスエージェントサービスから物理ホストをデタッチした状態で論理ホストだけを運用しないでください。
キューレスジョブの起動失敗時に出力するエラーメッセージ，およびジョブ実行時に標準エラー出力に出力した内容がマネージャーホストへ通知されない場合があります。

キューレスジョブ実行内部ログファイルは，物理ホスト，論理ホストに関係なく，ローカルディスク上に作成されます。実行系，および待機系それぞれでキューレスジョブ実行内部ログファイルのサイズを設定してください。
また，キューレスジョブ実行内部ログファイルを共有ディスク上に作成した場合，ログが適切に出力されないおそれがあります。必ずローカルディスク上に作成してください。

9.4.6　論理ホストの削除

Windowsの場合，論理ホストの削除は，実行系・待機系の両方で実行します。論理ホストの削除手順を次に示します。

＜この項の構成＞

(1)　JP1/AJS2 - Manager

(2)　JP1/AJS2 - Agent

(1)　JP1/AJS2 - Manager

JP1/AJS2サービスおよびJP1/AJS2 Monitorサービスを停止する。
物理ホストのJP1/AJS2 - Managerも含め，すべてのJP1/AJS2サービスを停止してください。

JP1/Baseのjp1bshasetup.exeコマンドを実行する。
［Baseクラスタ構成の設定］ダイアログボックスが表示されます。

［論理ホストの削除］ボタンをクリックする。

削除したい論理ホスト名を選択する。
JP1/Base，JP1/AJS2およびJP1/IMの論理ホスト情報およびサービスが削除されます。ただし，共有ディスク上の共有ファイルおよび共有フォルダは削除されません。手動で削除してください。
JP1/Baseを削除しないで，JP1/AJS2だけの論理ホスト上の共通定義情報を削除したい場合は，次に示すコマンドを実行して情報を削除してください。

jbsunsetcnf  -i -h 論理ホスト名 -c JP1AJS2
jbsunsetcnf  -i -h 論理ホスト名 -c JP1NBQAGENT
jbsunsetcnf  -i -h 論理ホスト名 -c JP1NBQMANAGER
jbsunsetcnf  -i -h 論理ホスト名 -c JP1NBQCLIENT
jbsunsetcnf  -i -h 論理ホスト名 -c JP1NBQNOTIFY
jbsunsetcnf  -i -h 論理ホスト名 -c JP1AOMMANAGER
jbsunsetcnf  -i -h 論理ホスト名 -c JP1AOMAGENT
jbsunsetcnf  -i -h 論理ホスト名 -c JP1AJSMANAGER
jbsunsetcnf  -i -h 論理ホスト名 -c JP1AJS2COMMON
jbsunsetcnf  -i -h 論理ホスト名 -c JP1QLAGENT
jbsunsetcnf  -i -h 論理ホスト名 -c JP1AJS2CONSOLEMANAGER

なお上記コマンドの実行時，設定されている情報がない場合は，次のメッセージが出力されることがありますが，無視してください。

KAVA0405-I The specified -cで指定した文字列 does not exist [論理ホスト名]. Processing Stops.

共有ディスク上の共有ファイルおよびディレクトリを削除する。
jbsunsetcnfコマンドを実行すると，JP1/Base，JP1/IMおよびJP1/AJS2の論理ホスト情報が削除されます。ただし，共有ディスク上の共有ファイルおよび共有フォルダは削除されません。手動で削除してください。

JP1/AJS2の物理ホストの共通定義情報をクラスタ未設定の状態に変更する。
すべての論理ホストを削除した場合，次の手順でJP1/AJS2の物理ホストの共通定義情報をクラスタシステム未設定の状態に変更してください。

1. テキストエディターで構成定義ファイルを作成する。

作成する構成定義ファイルの内容を次に示します。

[JP1_DEFAULT¥JP1NBQAGENT¥Process]

"IsHA"=dword:00000000

[JP1_DEFAULT¥JP1NBQCLIENT¥Process]

"IsHA"=dword:00000000

[JP1_DEFAULT¥JP1NBQMANAGER¥Process]

"IsHA"=dword:00000000

[JP1_DEFAULT¥JP1NBQNOTIFY¥Process]

"IsHA"=dword:00000000

環境設定パラメーターの詳細については，「4.2 ジョブ実行環境の設定」を参照してください。

2. 構成定義ファイルを任意のフォルダに保存する。

ファイル名の例：jp1ajs2_delete_cluster.txt

3. 次に示すコマンドを実行し，構成定義ファイルの情報を設定する。

jbssetcnf 構成定義ファイル名

jbssetcnfコマンドのパスは，「JP1/Baseのインストール先フォルダ¥bin¥jbssetcnf」です。

jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

コマンドの指定例を次に示します。

jbssetcnf jp1ajs2_delete_cluster.txt

環境変数JP1_HOSTNAMEを削除する。

(2)　JP1/AJS2 - Agent

JP1/AJS2サービスを停止する。
物理ホストのJP1/AJS2エージェントも含め，すべてのJP1/AJS2サービスを停止してください。

JP1/Baseのjp1bshasetup.exeコマンドを実行する。
［Baseクラスタ構成の設定］ダイアログボックスが表示されます。

［論理ホストの削除］ボタンをクリックする。

削除したい論理ホスト名を選択する。
JP1/Base，JP1/AJS2およびJP1/IMの論理ホスト情報およびサービスが削除されます。ただし，共有ディスク上の共有ファイルおよび共有フォルダは削除されません。手動で削除してください。
JP1/Baseを削除しないで，JP1/AJS2だけの論理ホスト上の共通定義情報を削除したい場合は，次に示すコマンドを実行して情報を削除してください。

jbsunsetcnf  -i -h 論理ホスト名 -c JP1AJS2
jbsunsetcnf  -i -h 論理ホスト名 -c JP1NBQAGENT
jbsunsetcnf  -i -h 論理ホスト名 -c JP1NBQMANAGER
jbsunsetcnf  -i -h 論理ホスト名 -c JP1NBQCLIENT
jbsunsetcnf  -i -h 論理ホスト名 -c JP1NBQNOTIFY
jbsunsetcnf  -i -h 論理ホスト名 -c JP1AOMAGENT
jbsunsetcnf  -i -h 論理ホスト名 -c JP1AJS2COMMON
jbsunsetcnf  -i -h 論理ホスト名 -c JP1QLAGENT

なお上記コマンドの実行時，設定されている情報がない場合は，次のメッセージが出力されることがありますが，無視してください。

KAVA0405-I The specified -cで指定した文字列 does not exist [論理ホスト名]. Processing Stops.

共有ディスク上の共有ファイルおよびディレクトリを削除する。
jbsunsetcnfコマンドを実行すると，JP1/Base，JP1/IMおよびJP1/AJS2の論理ホスト情報が削除されます。ただし，共有ディスク上の共有ファイルおよび共有フォルダは削除されません。手動で削除してください。

JP1/AJS2の物理ホストの共通定義情報をクラスタ未設定の状態に変更する。
すべての論理ホストを削除した場合，次の手順でJP1/AJS2の物理ホストの共通定義情報をクラスタシステム未設定の状態に変更してください。

1. テキストエディターで構成定義ファイルを作成する。

作成する構成定義ファイルの内容を次に示します。

[JP1_DEFAULT¥JP1NBQAGENT¥Process]

"IsHA"=dword:00000000

[JP1_DEFAULT¥JP1NBQCLIENT¥Process]

"IsHA"=dword:00000000

[JP1_DEFAULT¥JP1NBQMANAGER¥Process]

"IsHA"=dword:00000000

[JP1_DEFAULT¥JP1NBQNOTIFY¥Process]

"IsHA"=dword:00000000

環境設定パラメーターの詳細については「4.2 ジョブ実行環境の設定」を参照してください。

2. 構成定義ファイルを任意のフォルダに保存する。

ファイル名の例：jp1ajs2_delete_cluster.txt

3. 次に示すコマンドを実行し，構成定義ファイルの情報を設定する。

jbssetcnf 構成定義ファイル名

jbssetcnfコマンドのパスは，「JP1/Baseのインストール先フォルダ¥bin¥jbssetcnf」です。

jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

コマンドの指定例を次に示します。

jbssetcnf jp1ajs2_delete_cluster.txt

環境変数JP1_HOSTNAMEを削除する。

9.4.7　論理ホストのスケジューラーサービスの多重起動の設定

スケジューラーサービスの多重起動を設定するためには，まず追加するスケジューラーサービスの名称などの情報を設定します。次に，そのスケジューラーサービス用のデータベースを新規に作成します。

論理ホストでスケジューラーサービスの多重起動の設定をする場合の手順，および追加したスケジューラーサービスの削除手順を次に示します。

＜この項の構成＞

(1)　論理ホストでスケジューラーサービスを多重起動する

(2)　追加したスケジューラーサービスを削除する

(1)　論理ホストでスケジューラーサービスを多重起動する

論理ホストでスケジューラーサービスの多重起動を設定する場合の手順を次に示します。

(a)　実行系での作業

Windowsの［コントロールパネル］の［サービス］で，次に示すサービスを停止する。

追加の対象となる論理ホストのJP1/AJS2サービス

JP1/AJS2 Monitorサービス

エクスプローラなどで，次に示すフォルダを共有ディスクに作成する。

データベースフォルダ

一時ファイル用フォルダ

ジョブエラー情報フォルダ

退避情報フォルダ

なお，退避情報フォルダ以外は，自ホスト内（物理ホストとすべての論理ホスト）に設定されている，ほかのスケジューラーサービスが使用するフォルダと重複しないようにしてください。また，ほかのスケジューラーサービスが使用するフォルダの配下にも作成しないでください。

Windowsの［スタート］メニューから［プログラム］－［JP1_Automatic Job Management System 2 - Manager］－［環境設定］を選択する。
設定したい論理ホスト名を選択し，［設定］ボタンを押すと，［マネージャー環境設定］ダイアログボックスが表示されます。このダイアログボックスの定義項目の詳細については，「4.1 スケジューラーサービス環境の設定」，「4.2.1(1) ジョブ実行環境を定義する」および 「4.3.1(1) イベント起動を定義する」を参照してください。

［スケジューラーサービスの制御］タブで，［追加］ボタンをクリックする。
［サービスの設定］ダイアログボックスが表示されます。

スケジューラーサービスの多重起動のために必要な項目を入力する。
（例）「AJSROOT3」というスケジューラーサービスを追加する場合

スケジューラーサービスの追加

「AJSROOT3」と入力します。

スケジューラーサービスの識別番号

「3」と入力します。スケジューラーサービスの識別番号は，自ホスト内の物理ホストおよびすべての論理ホストで使用している識別番号と重複しない番号を指定してください。

ジョブ状態通知ポートのサービス名

「jp1ajs2report3」と入力します。ジョブ状態通知ポートのサービス名には，現在作成中の論理ホスト内の，ほかのスケジューラーサービスで使用しているサービス名と重複しない名称を指定してください。

［次へ］ボタンをクリックする。
［ディレクトリ名の設定］ダイアログボックスが表示されます。

各項目に，手順2で作成したフォルダを指定する。

［次へ］ボタンをクリックする。
［ログの設定］ダイアログボックスが表示されます。

ログの設定内容に問題がないことを確認する。

［完了］ボタンをクリックする。
［ログの設定］ダイアログボックスが閉じます。

［マネージャー環境設定］ダイアログボックスで，［OK］ボタンをクリックする。
［マネージャー環境設定］ダイアログボックスが閉じます。

次のファイルをメモ帳などのエディターで開く。
システムフォルダ¥system32¥drivers¥etc¥Services

手順5で指定したジョブ状態通知ポートのサービス名に対するポート番号を設定する。
（例）ポート番号を「20248」として設定する場合

  jp1ajs2report3 20248/tcp

注意事項

設定するポート番号は既存の番号と重ならないようにしてください。また，Windowsファイアウォールを設定した環境で運用する場合は，設定したポート番号（上記の例ではサービス名：jp1ajs2report3，ポート番号：20248）をWindowsファイアウォールの規則へ登録して，ファイアウォールを透過できるようにしてください。

次のコマンドを実行して，追加したスケジューラーサービス用のJP1/AJS2データベースを作成する。

ajssetup -F スケジューラーサービス名 -mh 論理ホスト名

（例）
論理ホスト名「node0」に「AJSROOT3」サービスのスケジューラーデータベースを作成する場合

 ajssetup -F AJSROOT3 -mh node0

キューレスジョブを利用する場合は，キューレスジョブのセットアップをする。
次のコマンドを実行します。

ajsqlsetup -F スケジューラーサービス名 -h 論理ホスト名

組み込みDBを使用する場合は組み込みDBに移行する。
組み込みDBセットアップツール（ajsembdbsetupスクリプト）を使用して，標準データベースを組み込みDBに移行します。
組み込みDBへの移行手順については，「5. スケジューラーデータベースに組み込みDBを使用する場合のセットアップ」を参照してください。

スケジューラーサービスを追加した論理ホストのJP1/AJS2サービスおよびJP1/AJS2 Monitorサービスを再起動する。
設定した内容でスケジューラーサービスが追加され，起動します。再起動後，JP1/AJS2 - Viewなどで，追加したスケジューラーサービス名が付けられたルートジョブグループが表示されていることを確認してください。

(b)　待機系での作業

実行系の共通定義情報を待機系に設定する。
実行系での作業が完了したあと，実行系でjbsgetcnfコマンドを実行し，共通定義情報を退避します。その退避ファイルを待機系にコピーし，退避ファイルを引数に指定してjbssetcnfコマンドを実行します。
実行するコマンドを次に示します。

実行系

jbsgetcnf -h 論理ホスト名 > 退避ファイル名

待機系

jbssetcnf 退避ファイル名

次のファイルをメモ帳などのエディターで開く。
システムフォルダ¥system32¥drivers¥etc¥Services

(a)の実行系での作業の手順13で設定したポート番号を待機系に設定する。
（例）ポート番号を「20248」として設定する場合

  jp1ajs2report3 20248/tcp

注意事項

設定するポート番号は実行系と同じ番号になるようにしてください。また，Windowsファイアウォールを設定した環境で運用する場合は，設定したポート番号（上記の例ではサービス名：jp1ajs2report3，ポート番号：20248）をWindowsファイアウォールの規則へ登録して，ファイアウォールを透過できるようにしてください。

JP1/AJS2 Monitorサービスを再起動する。

多重起動時のコマンド実行についての補足事項

スケジューラーサービスを多重起動している場合，「-F スケジューラーサービス名」オプションを指定しないでコマンドを実行すると，デフォルトのスケジューラーサービスに対する操作となります。

環境変数AJSCONFにスケジューラーサービス名を指定しておくと，-Fオプションを省略できます。

(2)　追加したスケジューラーサービスを削除する

スケジューラーサービスの削除は，実行系・待機系の両方で実行します。追加したスケジューラーサービスの削除手順を次に示します。

JP1/AJS2サービスおよびJP1/AJS2 Monitorサービスを停止する。
物理ホスト，論理ホストのすべてのJP1/AJS2サービスを停止してください。

スケジューラーサービスを追加したときに作成したフォルダを削除する。

［マネージャー環境設定］ダイアログボックスの［スケジューラーサービスの制御］タブで，削除したいサービスを選択し，［削除］ボタンをクリックする。
追加したスケジューラーサービスが削除されます。

JP1/AJS2サービスおよびJP1/AJS2 Monitorサービスを起動する。
手順1で停止したサービスを再起動し，スケジューラーサービスが削除されていることを確認します。

9.5　クラスタ運用時の注意事項

＜この節の構成＞

(1)　JP1/AJS2全体に対する注意事項

(2)　ジョブ実行環境に対する注意事項

(3)　イベント起動に関する注意事項

(4)　キューレスジョブ実行環境に関する注意事項

(5)　定義内容の事前チェック機能に関する注意事項

(1)　JP1/AJS2全体に対する注意事項

クラスタシステムでJP1/AJS2のセットアップを実施する場合は，物理ホストおよび既存の論理ホストで動作しているJP1/AJS2のサービスを必ず停止してください。JP1/AJS2のサービスを停止しないままセットアップを実施した場合，JP1/AJS2のサービスが正しく動作しなくなります。この場合は，サーバを再起動して回復させてください。

JP1/AJS2のスケジューラーデータベース（ISAM），ジョブ実行環境データべース（ISAM），および内部ファイルの二重化はサポートしていません。ミラーディスク，RAIDディスクなどを利用して，ディスクシステム自体で信頼性を確保してください。

クラスタシステムでJP1/AJS2を多重起動する場合，多重起動する論理ホストの数だけ，システムのリソースが必要となります。

クラスタシステム運用時，論理ホスト上で起動されるJP1/AJS2サービスは，JP1/AJS2のプロセスが異常終了した場合には縮退運転しないで，すべてのプロセスを終了してください。なお，Windowsでは，論理ホスト対応のJP1/AJS2サービスを作成した場合，デフォルトで縮退運転しないモードになりますが，異常終了したJP1/AJS2のプロセスを再起動するように設定している場合，再起動が優先されるため，設定を解除してください。再起動設定の詳細については，マニュアル「JP1/Automatic Job Management System 2 設計・運用ガイド　15.15.1 異常終了したJP1/AJS2のプロセスを再起動する」を参照してください。

JP1/AJS2 Monitorサービス，キューレスエージェントサービス，キューレスファイル転送サービス，JP1/AJS2 Console Managerサービス，JP1/AJS2 Console Agentサービスはマシンに一つのサービスです。しかし，クラスタソフトによる共有ディスクおよび論理IPアドレスの移動に伴い，論理ホストごとに処理を切り分けることで，クラスタシステムに対応しています。

環境変数JP1_HOSTNAMEをシステム環境変数，ユーザー環境変数として設定しないでください。サービスの起動などができなくなることがあります。環境変数JP1_HOSTNAMEは，コマンドプロンプトまたはバッチファイルで設定してください。なお，論理ホスト名の指定方法については，「9.2.1 基本的な運用方法」を参照してください。

JP1/AJS2サービスの停止直後，JP1/AJS2のプロセスの一部が残っている場合があります。クラスタソフトで再起動設定している場合，JP1/AJS2の再起動に失敗することがありますが，クラスタソフトの再起動間隔，またはMSCSを使用している場合は再起動回数を増やすことで回避できます。

(2)　ジョブ実行環境に対する注意事項

クラスタシステム運用時，実行系で実行中のジョブがある状態でデーモンを停止した場合，実行中のジョブは強制終了されてから待機系に移行します。しかし，強制終了されたジョブの状態は，待機系ではすぐには終了状態とは認識されません。数分後に終了状態になります。

JP1/OJE for VOS3と連携するために，jpqreguserコマンドでVOS3ユーザー情報を登録する場合は，実行系ホストおよび待機系ホストの両方にユーザー情報を登録する必要があります。実行系ホストのユーザー情報を追加・変更・削除した場合は，「20. セットアップ時に使用するコマンド　jpqreguser」のクラスタシステムで運用する場合の注意事項に記載している手順に従い，待機系ホストのユーザー情報を追加・変更・削除してください。

(3)　イベント起動に関する注意事項

07-10より前のバージョンで，すでにクラスタシステム運用がセットアップされている環境から，07-10以降にバージョンアップした場合，論理ホストのイベント起動のファイル更新モードは非同期となります。論理ホストのイベント起動のファイル更新モードを同期モードにするには，［マネージャー環境設定］ダイアログボックスまたは［エージェント環境設定］ダイアログボックスの［ファイル更新モード］で［同期］を設定してください。また，07-10以降にバージョンアップ後に，クラスタシステム運用のセットアップを行うと，論理ホストのイベント起動のファイル更新モードは同期となります。論理ホストのイベント起動のファイル更新モードを非同期モードにするには，クラスタシステム運用のセットアップ後に［マネージャー環境設定］ダイアログボックスまたは［エージェント環境設定］ダイアログボックスの［ファイル更新モード］で［非同期］を設定してください。

07-10-/Cより前のバージョンで，すでにクラスタシステム運用がセットアップされている環境から，07-10-/C以降にバージョンアップした場合，論理ホストのイベント起動の詳細プロセス終了時オプションは［終了しない］となります。
また，07-10-/Cへバージョンアップ後に，クラスタシステム運用のセットアップを行うと，論理ホストのイベント起動の詳細プロセス終了時オプションは［終了する］となります。必要に応じて上記の設定を変更してください。

メールシステム連携およびメッセージキューシステム連携を使用している場合，物理ホストまたは論理ホストのうち，どれか一つのJP1/AJS2だけで連携できます。論理ホストで連携する場合でも，連携機能の環境設定は物理ホストに定義してください。
なお，メールシステム連携およびメッセージキューシステム連携は多重起動できないため，待機系ではこれらの連携ができません。

(4)　キューレスジョブ実行環境に関する注意事項

キューレスジョブ実行環境に関する注意事項の詳細については，「9.4.5(3) キューレスジョブ使用時に論理ホストを自動でアタッチ・デタッチする場合の注意事項」を参照してください。

(5)　定義内容の事前チェック機能に関する注意事項

定義内容の事前チェック機能に関する注意事項については，マニュアル「JP1/Automatic Job Management System 2 設計・運用ガイド　8.1.16 本番運用前のJP1/AJS2定義内容のチェックと注意事項」を参照してください。

10.　アンインストール

この章では，JP1/BaseおよびJP1/AJS2のアンインストールについて説明します。

＜この章の構成＞

10.1　JP1/Baseのアンインストール

10.2　JP1/AJS2シリーズプログラムのアンインストール

10.3　組み込みDBのアンインストール

10.1　JP1/Baseのアンインストール

JP1/Baseをアンインストールする場合，自動アンインストール機能を使用してください。JP1/Baseのアンインストール機能を使用すると，統合トレースログ機能（HTNRLib2）もアンインストールされます。ただし，統合トレースログ機能（HTNRLib2）を使用する製品（JP1/AJS2 - Viewなど）がある場合，その製品がアンインストールされた時点で，統合トレースログ機能（HTNRLib2）もアンインストールされます。

JP1/Baseのアンインストールの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

注意

JP1/Baseは，JP1/AJS2のアンインストール後にアンインストールしてください。JP1/AJS2がアンインストールできなくなることがあります。また，JP1/Baseをアンインストールしてから再インストールした場合は，JP1/AJS2もアンインストールしてから再インストールしてください。JP1/Baseをアンインストールすると，JP1/AJS2で使用する共通定義情報が削除されるため，JP1/AJS2が動作できなくなります。

10.2　JP1/AJS2シリーズプログラムのアンインストール

この節では，JP1/AJS2のアンインストールについて説明します。

注意

JP1/AJS2をアンインストールすると，JP1/AJS2のプログラムが削除され，ユーザー環境（データベースや環境設定ファイルなど）そのものも削除されます。そのため，JP1/AJS2をアンインストール後に，新たにJP1AJS2をインストールすると，すべて最初から設定し直す必要があります。

［コントロールパネル］－［管理ツール］－［サービス］画面を開いた状態でアンインストールを行うと，JP1/AJS2で提供しているサービスの［スタートアップの種類］が「無効」となり，アンインストールされない場合があります。アンインストールする場合は［サービス］画面を閉じてください。スタートアップの種類が無効となり，アンインストールされなかった場合は，システムを再起動するとアンインストールされます。［スタートアップの種類］が「無効」のまま再インストールした場合，JP1/AJS2で提供するサービスがインストールされませんのでご注意ください。

JP1/AJS2のアンインストール前にJP1/Baseがアンインストールされると，JP1/AJS2のアンインストールができません。JP1/AJS2のアンインストール実行前に必ずJP1/Baseがインストールされていることを確認してください。

クラスタ運用を行っている場合は，JP1/AJS2のアンインストールの前にJP1/Baseで論理ホストの削除を実行してください。論理ホストの削除の詳細については，「9.4.6 論理ホストの削除」を参照してください。

組み込みDBのアンインストールについての注意事項

組み込みDBをインストールした場合，組み込みDBをアンインストールしたあと，作成したファイルを手動で削除してください。組み込みDBのアンインストール方法については，「10.3 組み込みDBのアンインストール」を参照してください。

WindowsホストからJP1/AJS2シリーズプログラムをアンインストールする手順を次に示します。

JP1/AJS2シリーズプログラムをアンインストールするホストに，Administrators権限でログインする。

すべてのプログラムを終了する。
既存のJP1シリーズのプログラムが動作している場合，必ず停止しておいてください。

Windowsの［コントロールパネル］で［アプリケーションの追加と削除］を選択する。
アンインストールするプログラムを選択するダイアログボックスが表示されます。

アンインストールするJP1/AJS2シリーズプログラムを選択し，［追加と削除］ボタンをクリックする。
プログラムの削除を確認するダイアログボックスが表示されます。

［OK］ボタンをクリックする。
選択したプログラムがアンインストールされます。

必要に応じて，JP1/AJS2で作成したユーザーファイルと，JP1/AJS2のインストール先フォルダを削除する。

10.3　組み込みDBのアンインストール

この節では，組み込みDBのアンインストールについて説明します。

組み込みDBをアンインストールする前に，組み込みDBが稼働中かどうかをajsembdbstatusコマンドで確認してください。組み込みDBが稼働中の場合は，組み込みDBをajsembdbstopコマンドで正常終了してください。そのあと，アンインストールする組み込みDBのサービスが開始しているかどうかを［コントロールパネル］－［サービス］で確認してください。開始している場合は組み込みDBのサービスを停止してから，アンインストールを実行してください。

組み込みDBのアンインストール手順を次に示します。

JP1/AJS2シリーズプログラムをアンインストールするホストに，Administrators権限でログインする。

すべてのプログラムを終了する。
既存のJP1シリーズのプログラムが動作している場合，必ず停止しておいてください。

Windowsの［コントロールパネル］で［アプリケーションの追加と削除］を選択する。
アンインストールするプログラムを選択するダイアログボックスが表示されます。

［JP1/AJS2-Database］を選択し，［追加と削除］ボタンをクリックする。
プログラムの削除を確認するダイアログボックスが表示されます。

［OK］ボタンをクリックする。
選択したプログラムがアンインストールされます。
［共有ファイルを削除しますか？］という問い合わせのメッセージが表示されることがあります。表示されたら，［いいえ］をクリックしてください。

必要に応じて，インストール後に作成したファイルと，組み込みDBのインストール先フォルダを削除する。

11.　システム構成の種類とセットアップの手順

JP1/AJS2は，1台でジョブを定義・実行するシステムから，何台ものホストを使って大量のジョブを実行させる大規模なシステムまで，いろいろなシステム構成で使用できます。また，ほかの製品と連携していろいろな機能を使うこともできます。この章では，JP1/AJS2でできるシステム構成とそのセットアップの手順の概要を説明します。

＜この章の構成＞

11.1　JP1/AJS2シリーズプログラムと適用OS

11.2　JP1/AJS2のセットアップ手順の概要

11.1　JP1/AJS2シリーズプログラムと適用OS

JP1/AJS2シリーズのプログラムについて次に説明します。

JP1/AJS2 - Manager
業務の定義，管理および実行をします。1台のJP1/AJS2 - Managerに最大1,024のエージェントを接続できます。JP1/AJS2 - Manager同士を接続して使うこともできます。

JP1/AJS2 - Agent
JP1/AJS2 - Managerから実行依頼を受けた処理を実行します。JP1/AJS2 - Agentは，ジョブの実行機能のエージェントおよびイベントジョブのエージェントだけで構成されています。

JP1/AJS2シリーズプログラムが動作するOS一覧を次の表に示します。

表11-1　JP1/AJS2シリーズプログラムが動作するOS一覧

OS名 | JP1/AJS2 - Manager | JP1/AJS2 - Agent
HP-UX（PA-RISC） | ○ | ○
HP-UX（IPF） | ○ | ○
Solaris | ○ | ○
AIX | ○ | ○
Linux | ○ | ○
Linux（IPF） | ○ | ○

（凡例）

○：動作する。

JP1/AJS2 - ManagerおよびJP1/AJS2 - AgentにはJP1/Baseが必要です。

11.2　JP1/AJS2のセットアップ手順の概要

JP1/AJS2でできるシステム構成とそのセットアップの手順を次に示します。

＜この節の構成＞

11.2.1　JP1/AJS2 - ManagerとJP1/AJS2 - Viewでシステムを構築する場合のセットアップ手順

11.2.2　1台のJP1/AJS2 - Managerホストを使ったマネージャー・エージェント構成にする場合のセットアップ手順

11.2.3　複数のJP1/AJS2 - Managerを使ったマネージャー・エージェント構成にする場合のセットアップ手順

11.2.1　JP1/AJS2 - ManagerとJP1/AJS2 - Viewでシステムを構築する場合のセットアップ手順

ホストを1台用意し，JP1/AJS2 - Managerをインストールします。また，必要に応じてJP1/AJS2 - View用のホスト（Windows）を用意し，インストールします。複数のJP1/AJS2 - Viewを接続して使うこともできます。

JP1/AJS2 - ManagerとJP1/AJS2 - Viewでシステムを構築する場合のセットアップ手順を次の図に示します。

図11-1　セットアップ手順（JP1/AJS2 - ManagerとJP1/AJS2 - Viewでシステムを構築する場合）

11.2.2　1台のJP1/AJS2 - Managerホストを使ったマネージャー・エージェント構成にする場合のセットアップ手順

JP1/AJS2 - Manager用ホストを1台用意し，JP1/AJS2 - Agent用ホストを複数台用意します。また，必要に応じてJP1/AJS2 - View用のホスト（Windows）を用意します。

1台のJP1/AJS2 - Managerホストを使ったマネージャー・エージェント構成にする場合のセットアップ手順を次の図に示します。

図11-2　セットアップ手順（1台のJP1/AJS2 - Managerホストを使ったマネージャー・エージェント構成の場合）

11.2.3　複数のJP1/AJS2 - Managerを使ったマネージャー・エージェント構成にする場合のセットアップ手順

JP1/AJS2 - Manager用ホストとJP1/AJS2 - Agent用ホストを複数台用意します。また，必要に応じてJP1/AJS2 - View用のホスト（Windows）を用意します。

複数のJP1/AJS2 - Managerを使ったマネージャー・エージェント構成のセットアップ手順は，JP1/AJS2 - Managerホスト1台のときと同様です。図11-2の作業を，JP1/AJS2 - Managerの数だけ繰り返します。

業務の運用を開始したあと，マネージャージョブグループやマネージャージョブネットを定義して，複数のマネージャーを統括して管理できるようにします。

12.　インストール

この章では，JP1/AJS2のインストール方法について説明します。

＜この章の構成＞

12.1　JP1/AJS2シリーズプログラムのインストール前に必要な作業

12.2　JP1/AJS2シリーズプログラムのインストール

12.3　組み込みDBのインストール

12.1　JP1/AJS2シリーズプログラムのインストール前に必要な作業

ここでは，UNIXホストにJP1/AJS2をインストールする前に必要な次の作業について説明します。

JP1/Baseのインストール

注意

新規インストールの場合は，JP1/Baseを先にインストールしてください。また，バージョンアップインストールの場合は，JP1/Baseを先にバージョンアップしてください。

＜この節の構成＞

12.1.1　JP1/Baseをインストールする

12.1.1　JP1/Baseをインストールする

JP1/AJS2 - Manager，およびJP1/AJS2 - Agentをインストールするホストに，JP1/Baseをインストールしておきます。

なお，JP1/Baseを新規導入した場合，インストール時に自動セットアップを選択すると，ユーザー情報が次のように設定されます。この情報をそのまま使用する場合，ユーザー情報の設定は不要です。

認証サーバ：自ホスト

JP1ユーザー：jp1admin

JP1ユーザーのパスワード：jp1admin

JP1ユーザーをマッピングするOSのユーザー：root

サーバホスト名：*

JP1/Baseのインストールの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

12.2　JP1/AJS2シリーズプログラムのインストール

この節では，JP1/AJS2シリーズプログラム（JP1/AJS2 - Manager，JP1/AJS2 - Agent）のインストール方法を，インストール先ホストのOSごとに説明します。組み込みDBを使用する場合のJP1組み込みデータベースのインストール方法については，「12.3 組み込みDBのインストール」を参照してください。

なお，JP1/AJS2 - Manager，およびJP1/AJS2 - Agentをインストールする前に，JP1/Baseがインストールされていることを確認してください。また，JP1/BaseのバージョンがJP1/AJS2の前提バージョンとなっているか確認してください。

JP1/Baseのインストールについては，マニュアル「JP1/Base 運用ガイド」を参照してください。

＜この節の構成＞

12.2.1　インストール時の注意事項

12.2.2　HP-UXの場合のインストール

12.2.3　Solarisの場合のインストール

12.2.4　AIXの場合のインストール

12.2.5　Linuxの場合のインストール

12.2.1　インストール時の注意事項

ここでは，JP1/AJS2 - Managerをインストールするホストについての注意事項，および上書きインストールについての注意事項について説明します。また，JP1/NETM/DMを使ったリモートインストール（ソフトウェアの配布）についても説明します。

＜この項の構成＞

(1)　JP1/AJS2 - Managerをインストールするホストについての注意事項

(2)　上書きインストールについての注意事項

(3)　JP1/NETM/DMを使ったリモートインストール（ソフトウェアの配布）

(1)　JP1/AJS2 - Managerをインストールするホストについての注意事項

JP1/AJS2 - Managerをインストールしたホストには，JP1/AJS2 - Agentはインストールできません。

(2)　上書きインストールについての注意事項

(a)　カスタマイズできるファイルの扱い

JP1/AJS2で提供しているファイルには，ユーザーがカスタマイズできるファイルがあります。ユーザーによるカスタマイズを考慮し，上書きインストール後も，これらのファイルは置き換えられません。

また，カスタマイズ前のファイルは，モデルファイルとして同一ディレクトリに格納されています（ファイル名の末尾に，「.model」が付いています）。アップデートはこのモデルファイルに対して行われます。このため，バージョンアップ後は次に示すファイルのカスタマイズ状況を確認し，カスタマイズしている場合は，モデルファイルをコピーし，再度カスタマイズしてください。カスタマイズしていない場合は，コピーだけしてください。

/etc/opt/jp1ajs2/jajs_killall.cluster

/etc/opt/jp1ajs2/jajs_start.cluster

/etc/opt/jp1ajs2/jajs_start

/etc/opt/jp1ajs2/jajs_stop.cluster

/etc/opt/jp1ajs2/jajs_stop

/etc/opt/jp1ajs2/jajsca_start

/etc/opt/jp1ajs2/jajsca_stop

/etc/opt/jp1ajs2cm/jajscm_start

/etc/opt/jp1ajs2cm/jajscm_stop

/etc/opt/jp1ajs2/conf/ajs2ca.conf

/etc/opt/jp1ajs2/conf/ajs2cfa.conf

/etc/opt/jp1ajs2/conf/Common.conf

/etc/opt/jp1ajs2/conf/EVAction.conf

/etc/opt/jp1ajs2/conf/jp1ajs_param_V7.conf

/etc/opt/jp1ajs2/conf/jp1ajs_service_0700.conf

/etc/opt/jp1ajs2/conf/jp1ajs_spmd.conf

/etc/opt/jp1ajs2/conf/jpqsetup.conf

/etc/opt/jp1ajs2/conf/Queue.conf

/etc/opt/jp1ajs2/conf/Queueless.conf

/etc/opt/jp1ajs2/conf/Schedule.conf

/etc/opt/jp1ajs2cm/conf/ajs2cm.conf

注意事項

モデルファイルのアップデートは共有ディレクトリのjp1ajs2の下にあるモデルファイルに対しては行われません。

論理ホストのconfファイルは，共有ディレクトリのjp1ajs2の下にあるconfディレクトリのファイルになります。

(b)　JP1/AJS2 - ManagerおよびJP1/AJS2 - Agentを使用する場合

JP1/AJS2のすべてのサービスおよびプロセスを停止させてからインストールしてください。必要に応じて，定義ファイルをバックアップしてから製品をバージョンアップすることをお勧めします。

次の場合はJP1/AJS2 - ManagerおよびJP1/AJS2 - Agentのインストールは失敗しますので注意してください。

すでにインストールされているJP1/AJS2 - ManagerまたはJP1/AJS2 - Agentのプロセスが稼働中の場合

JP1/Baseがインストールされていないか，前提バージョンのJP1/Baseがインストールされていない場合

共存できない製品がインストールされている場合

(c)　JP1/AJS2 - Light Editionを使用している場合

06-71以前のJP1/AJS2 - Light Editionを使用している場合は，JP1/AJS2のすべてのサービスおよびプロセスを停止させてから，JP1/AJS2 - Managerを上書きインストールすることで，そのまま使用できます。JP1/AJS2 - Light Editionをアンインストールする必要はありません。

(d)　クラスタ構成で上書きインストールする場合

クラスタ構成のUNIXホストにJP1/AJS2シリーズプログラムをバージョンアップでインストールする手順を次に示します。

なお，この手順では論理ホストが通常動作している系を実行系，論理ホストが通常動作していないで待機している系を待機系と呼びます。

待機系で論理ホストが動作していないことを確認する。
待機系で論理ホストのJP1/AJS2が動作していないことを確認してください。
なお，実行系で論理ホストのJP1/AJS2が動作していても問題ありません。

待機系でバージョンアップインストールする。

実行系で論理ホストが動作していないことを確認する。
実行系から待機系にフェールオーバーさせる，または論理ホストを停止して，実行系で論理ホストのJP1/AJS2が動作していないことを確認してください。
なお，手順2でバージョンアップした待機系に論理ホストをフェールオーバーさせても問題ありません。

実行系でバージョンアップインストールする。

注意

待機系をバージョンアップしたあと，待機系で論理ホストを稼働させている場合，実行系のバージョンアップが完了するまでは実行系にフェールオーバーさせないでください。

(3)　JP1/NETM/DMを使ったリモートインストール（ソフトウェアの配布）

JP1/AJS2は，JP1/NETM/DMを使ったリモートインストールに対応しています。

JP1/AJS2の場合，次に示すインストールに対応しています。

新規インストール
インストール対象ホストにJP1/AJS2を新規にインストールできます。

上書きインストール
リモートインストールすることで，JP1/AJS2インストール済みホストのJP1/AJS2を上書きインストールできます。

JP1/NETM/DMを使った実際のリモートインストール方法については，マニュアル「JP1/NETM/DM Client (UNIX(R)用)」を参照してください。

12.2.2　HP-UXの場合のインストール

HP-UXの場合のインストール手順を説明します。なお，CD-ROMのディレクトリ名やファイル名は，ハードウェア環境などによって記述した内容と見え方が異なることがあります。lsコマンドで確認し，表示されたファイル名をそのまま入力してください。

JP1/AJS2シリーズプログラムをインストールするホストにスーパーユーザーでログインするかまたはsuコマンドでユーザーをスーパーユーザーに変更する。

すべてのプログラムを終了する。
既存のJP1シリーズのプログラムが動作している場合，必ず停止しておいてください。

JP1/AJS2シリーズプログラムの媒体をセットする。

次のコマンドを実行して，CD-ROM装置をマウントする。

/usr/sbin/mount -F cdfs -r デバイススペシャルファイル名 /cdrom

/cdromはCD-ROMデバイススペシャルファイルのマウントポイントです。マウントポイントディレクトリがない場合は，作成してください。なお，デバイススペシャルファイル名およびマウントポイントは使用している環境によって異なる場合があります。

次のコマンドを実行して，Hitachi PP Installerを起動する。

/cdrom/HPUX※1/SETUP /cdrom※2

Hitachi PP Installerが起動され，初期画面が表示されます。

注※1

HP-UX（IPF）の場合は，IPFHPUXです。

注※2

ここではマウントポイントに/cdromを仮定します。

初期画面で「I」を入力する。
インストールできるプログラムの一覧が表示されます。

インストールするJP1/AJS2シリーズプログラムを選択し，「I」を入力する。
選択したプログラムがインストールされます。なお，プログラムを選択するには，カーソルを移動させ，スペースバーで選択します。

インストールが正常終了したら，「Q」を入力する。
Hitachi PP Installerの初期画面に戻ります。

インストールが終了すると，ユーザー情報（認証サーバおよびJP1ユーザー），DBの設定が完了しているため，サービスの起動だけでジョブを実行できます。

ただし，設定はすべてデフォルトです。デフォルトから設定を変更する場合は，「13. セットアップ」を参照してください。

12.2.3　Solarisの場合のインストール

Solarisの場合のインストール手順を説明します。なお，CD-ROMのディレクトリ名やファイル名は，ハードウェア環境などによって記述した内容と見え方が異なることがあります。lsコマンドで確認し，表示されたファイル名をそのまま入力してください。

JP1/AJS2シリーズプログラムをインストールするホストにスーパーユーザーでログインするかまたはsuコマンドでユーザーをスーパーユーザーに変更する。

すべてのプログラムを終了する。
既存のJP1シリーズのプログラムが動作している場合，必ず停止しておいてください。

JP1/AJS2シリーズプログラムの媒体をセットする。

次のコマンドを実行して，Hitachi PP Installerを起動する。

/cdrom/cdrom/solaris/setup /cdrom/cdrom※

Hitachi PP Installerが起動され，初期画面が表示されます。

注※

ここではマウントポイントに/cdrom/cdromを仮定します。

初期画面で「I」を入力する。
インストールできるプログラムの一覧が表示されます。

インストールするJP1/AJS2シリーズプログラムを選択し，「I」を入力する。
選択したプログラムがインストールされます。なお，プログラムを選択するには，カーソルを移動させ，スペースバーで選択します。

インストールが正常終了したら，「Q」を入力する。
Hitachi PP Installerの初期画面に戻ります。

インストールが終了すると，ユーザー情報（認証サーバおよびJP1ユーザー），DBの設定が完了しているため，サービスの起動だけでジョブを実行できます。

ただし，設定はすべてデフォルトです。デフォルトから設定を変更する場合は，「13. セットアップ」を参照してください。

12.2.4　AIXの場合のインストール

AIXの場合のインストール手順を説明します。なお，CD-ROMのディレクトリ名やファイル名は，ハードウェア環境などによって記述した内容と見え方が異なることがあります。lsコマンドで確認し，表示されたファイル名をそのまま入力してください。

JP1/AJS2シリーズプログラムをインストールするホストにスーパーユーザーでログインするかまたはsuコマンドでユーザーをスーパーユーザーに変更する。

すべてのプログラムを終了する。
既存のJP1シリーズのプログラムが動作している場合，必ず停止しておいてください。

JP1/AJS2シリーズプログラムの媒体をセットする。

次のコマンドを実行して，CD-ROM装置をマウントする。

/usr/sbin/mount -r -v cdrfs デバイススペシャルファイル名 /cdrom

/cdromはCD-ROMデバイススペシャルファイルのマウントポイントです。マウントポイントディレクトリがない場合は，作成してください。なお，デバイススペシャルファイル名およびマウントポイントは使用している環境によって異なる場合があります。

次のコマンドを実行して，Hitachi PP Installerを起動する。

/cdrom/AIX/SETUP /cdrom※

Hitachi PP Installerが起動され，初期画面が表示されます。

注※

ここではマウントポイントに/cdromを仮定します。

初期画面で「I」を入力する。
インストールできるプログラムの一覧が表示されます。

インストールするJP1/AJS2シリーズプログラムを選択し，「I」を入力する。
選択したプログラムがインストールされます。なお，プログラムを選択するには，カーソルを移動させ，スペースバーで選択します。

インストールが正常終了したら，「Q」を入力する。
Hitachi PP Installerの初期画面に戻ります。

インストールが終了すると，ユーザー情報（認証サーバおよびJP1ユーザー），DBの設定が完了しているため，サービスの起動だけでジョブを実行できます。

ただし，設定はすべてデフォルトです。デフォルトから設定を変更する場合は，「13. セットアップ」を参照してください。

12.2.5　Linuxの場合のインストール

Linuxの場合のインストール手順を説明します。なお，CD-ROMのディレクトリ名やファイル名は，ハードウェア環境などによって記述した内容と見え方が異なることがあります。lsコマンドで確認し，表示されたファイル名をそのまま入力してください。

JP1/AJS2シリーズプログラムをインストールするホストにスーパーユーザーでログインするかまたはsuコマンドでユーザーをスーパーユーザーに変更する。

すべてのプログラムを終了する。
既存のJP1シリーズのプログラムが動作している場合，必ず停止しておいてください。

JP1/AJS2シリーズプログラムの媒体をセットする。

CD-ROM装置をマウントする。
マウントディレクトリを「/mnt/cdrom」としてマウントします。マウントのためのコマンドについては，OSのドキュメントを参照してください。

次のコマンドを実行して，Hitachi PP Installerを起動する。

/mnt/cdrom/linux※1/setup /mnt/cdrom※2

Hitachi PP Installerが起動され，初期画面が表示されます。

注※1

Linux（IPF）の場合は，iplinuxです。

注※2

ここではマウントポイントに/mnt/cdromを仮定します。

初期画面で「I」を入力する。
インストールできるプログラムの一覧が表示されます。

インストールするJP1/AJS2シリーズプログラムを選択し，「I」を入力する。
選択したプログラムがインストールされます。なお，プログラムを選択するには，カーソルを移動させ，スペースバーで選択します。

インストールが正常終了したら，「Q」を入力する。
Hitachi PP Installerの初期画面に戻ります。

インストールが終了すると，ユーザー情報（認証サーバおよびJP1ユーザー），DBの設定が完了しているため，サービスの起動だけでジョブを実行できます。

ただし，設定はすべてデフォルトです。デフォルトから設定を変更する場合は，「13. セットアップ」を参照してください。

12.3　組み込みDBのインストール

組み込みDB（JP1/AJS2 - Database option）のインストール方法については，「15. スケジューラーデータベースに組み込みDBを使用する場合のセットアップ」を参照してください。

13.　セットアップ

この章では，JP1/AJS2シリーズプログラムで必要なセットアップ，システムおよびユーザー環境で必要なセットアップについて説明します。

＜この章の構成＞

13.1　JP1/AJS2 - Managerで必要なセットアップ

13.2　JP1/AJS2 - Agentで必要なセットアップ

13.3　JP1/AJS2 Consoleで必要なセットアップ

13.4　システムおよびユーザー環境で必要なセットアップ

13.5　そのほかの注意事項

13.1　JP1/AJS2 - Managerで必要なセットアップ

JP1/AJS2 - Managerを使用するには，JP1/Baseのセットアップと，JP1/AJS2 - Managerのセットアップが必要です。

まず，JP1/Baseをセットアップし，次にJP1/AJS2 - Managerをセットアップしてください。

＜この節の構成＞

13.1.1　JP1/Baseのセットアップ

13.1.2　JP1/AJS2 - Managerのセットアップ

13.1.1　JP1/Baseのセットアップ

この項では，JP1/Baseのセットアップについて説明します。

なお，この項では，設定の流れと大まかな設定内容を説明します。設定方法，設定項目，コマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/Baseは，次の流れでセットアップします。

ユーザー情報の設定
ユーザー情報では，JP1/Baseのユーザー管理機能を使って，ユーザー認証やユーザーマッピングなどを設定します。
ユーザー認証の設定では，JP1/AJS2のユーザーや，JP1/AJS2を使うために必要な権限などを設定します。
ユーザーマッピングは，ジョブを実行したり，JP1/AJS2 - Viewからログインしたりするために必要な設定です。JP1ユーザーに，各ホストに登録されているOSユーザーをマッピングします。
設定方法については，「(1) ユーザー情報を設定する」を参照してください。

イベントサービス環境の設定
イベントサービス環境の設定は，JP1イベントを送受信するために必要です。
設定方法については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/Baseのセットアップの手順と定義内容を次に示します。

＜この項の構成＞

(1)　ユーザー情報を設定する

(2)　JP1/AJS2に必要なJP1権限レベル一覧

(1)　ユーザー情報を設定する

ユーザー情報は，次の流れで設定します。

使用する認証サーバを指定する。

JP1ユーザーを登録する。

JP1権限レベルを設定する。

ユーザーマッピングを設定する（JP1/AJS2 - Viewからログインする場合にも，この設定は必要です）。

なお，他ホストに認証サーバを設定している場合は，2と3の作業は不要です。他ホストの認証サーバであらかじめ設定しておいてください。

UNIX版JP1/Baseでは，コマンドを使ってユーザー情報を設定します。ユーザー情報の設定手順を設定内容ごとに説明します。

(a)　使用する認証サーバを指定する

次のコマンドを実行します。

jbssetusrsrvプライマリー認証サーバ [セカンダリー認証サーバ]

「プライマリー認証サーバ」に指定したホストが，通常時に使用する認証サーバとなり，「セカンダリー認証サーバ」に指定したホストが，予備の認証サーバとなります。

「セカンダリー認証サーバ」は必要に応じて指定してください。省略した場合は，「プライマリー認証サーバ」に指定したホストだけが，一つのユーザー認証圏内で認証サーバとして稼働します。

注意

認証サーバ（プライマリー認証サーバまたはセカンダリー認証サーバ）として指定するホスト名は，JP1/Baseを起動する前に，hostsファイルまたはDNSサーバに設定しておいてください。認証サーバの指定（jbssetusrsrvコマンドの実行）と，hostsファイルまたはDNSサーバへの設定順序は任意ですが，JP1/Baseの起動時にはホスト名からIPアドレスを解決できる状態になっている必要があります。jbssetusrsrvコマンドを実行して自ホストを認証サーバ（プライマリー認証サーバまたはセカンダリー認証サーバ）に指定した場合は，次の形式でコマンドを実行してください。

cd /etc/opt/jp1base/conf

cp -p jp1bs_spmd.conf.session.model jp1bs_spmd.conf

なお，このコマンドを実行しない場合は，自ホストを認証サーバ（プライマリー認証サーバまたはセカンダリー認証サーバ）に指定しても，認証サーバとして起動しません。

(b)　JP1ユーザーを登録する

次のコマンドを実行します。

jbsadduser JP1ユーザー名

登録するJP1ユーザーの数だけ，このコマンドを実行します。

(c)　JP1権限レベルを設定する

登録したJP1ユーザーに対して，JP1/AJS2で処理を定義・実行するための権限レベルを設定します。権限レベルを設定するには，JP1ユーザーに対して「JP1資源グループ」と「JP1権限レベル」を定義します。

JP1権限レベルの設定手順を次に示します。

次のファイルをエディターで開く。

/etc/opt/jp1base/conf/user_acl/JP1_UserLevel

ファイルには，初期値として次の定義が記載されています。

jp1admin:*=JP1_AJS_Admin,JP1_Console_Admin,JP1_JPQ_Admin

「JP1ユーザー名:JP1資源グループ名=JP1権限レベル名」の形式で定義を記述する。
JP1権限レベルを複数定義する場合は，「,（コンマ）」で区切って入力します。複数の資源グループへの権限を定義する場合は，「:（コロン）」で区切って入力します。また，コメントを挿入したい場合は，行頭に「;（セミコロン）」を入力します。改行されるまでコメントとして扱われます。
「JP1_Queue」は，大文字・小文字を間違えないように入力してください。
なお，JP1/AJS2に必要な権限レベルの詳細については「(2) JP1/AJS2に必要なJP1権限レベル一覧」を参照してください。
記述例を次に示します。

すべてのJP1ユーザーに権限レベルを設定したら，ファイルを閉じる。

JP1/Baseを再起動するか，またはjbs_spmd_reloadコマンドを実行する。
定義した内容が有効になります。

(d)　ユーザーマッピングを設定する

登録したJP1ユーザーに対して，OSユーザーをマッピングします。ジョブを実行させたり，JP1/AJS2 - Viewからログインしたりするためにこの設定が必要です。

ユーザーマッピングの設定手順を次に示します。

エディターなどで，ユーザーマッピング定義ファイルを開く。
任意のファイルで設定することもできますが，実際の定義内容と一致させるため，/etc/opt/jp1base/conf/user_acl/jp1BsUmap.confを使用することをお勧めします。

「JP1ユーザー名:ホスト名:OSユーザー名」の形式で定義を記述する。
記述例を次に示します。

定義の記述が終了したらファイルを閉じ，次のコマンドを実行する。

jbsmkumap [-f ユーザーマッピング定義ファイル]

定義した内容が有効になります。なお，ユーザーマッピング定義ファイルに/etc/opt/jp1base/conf/user_acl/jp1BsUmap.confを使用した場合は，-fオプションの指定は不要です。

補足事項

ユーザーマッピング定義ファイルに設定する項目を次の表に示します。

表13-1　ユーザーマッピング定義ファイルに設定する項目（JP1/AJS2 - Manager）

操作内容 | JP1ユーザー名 | ホスト名 | OSユーザー名
JP1/AJS2 - Viewを使ってジョブを実行する | JP1/AJS2 - Managerにログインするユーザー | JP1/AJS2 - Viewが接続するJP1/AJS2 - Managerホスト | ジョブを実行するホストのOSに登録されているユーザー
JP1/AJS2 - Managerホスト以外のホストでジョブを実行する | JP1/AJS2 - ManagerホストのOSにログインするユーザー | JP1/AJS2 - Managerホスト | サブミットジョブを実行するホストのOSに登録されているユーザー
JP1/AJS2 - Client Toolkitからサブミットジョブを登録する | サブミット先JP1/AJS2 - ManagerホストのOSにログインするユーザー | JP1/AJS2 - Managerホスト | サブミットジョブを実行するホストのOSに登録されているユーザー

注意事項

マッピングするOSユーザーには，ユーザーID，グループIDを正しく設定したOSユーザーを指定してください。

JP1/AJS2 - Viewからログインする場合，マッピングするOSユーザーにホームディレクトリを正しく設定する必要があります。

また，JP1ユーザーにマッピングするOSユーザーは正常にOSにログインできるOSユーザーをJP1ユーザーにマッピングしてください。

OSユーザーが次に示す状態だとジョブが起動失敗となるおそれがあります。

/etc/passwdに指定したホームディレクトリが存在しない。

/etc/passwdに指定したログインシェルが存在しない。

(2)　JP1/AJS2に必要なJP1権限レベル一覧

JP1/AJS2のJP1権限レベルには次の2種類があります。

ジョブネット定義・実行時のJP1権限レベル

ジョブの実行・操作時のJP1権限レベル

それぞれの権限レベル名と操作できる内容について説明します。

(a)　ジョブネット定義・実行時のJP1権限レベル

ジョブネット定義・実行時のJP1権限レベルには，次の5種類があります。

JP1_AJS_Admin
管理者権限です。ユニットの所有者や資源グループの操作権限，ジョブネットの定義・実行・編集権限などを持っています。

JP1_AJS_Manager
ジョブネットの定義・実行・編集権限などを持っています。

JP1_AJS_Editor
ジョブネットの定義・編集権限などを持っています。

JP1_AJS_Operator
ジョブネットの実行・参照権限などを持っています。

JP1_AJS_Guest
ジョブネットの参照権限などを持っています。

ジョブネット定義・実行時のJP1権限レベル名と詳細な操作内容を次の表に示します。

表13-2　ジョブネット定義・実行時のJP1権限レベル名と操作できる内容

操作内容
JP1_AJS_
Admin
JP1_AJS_
Manager
JP1_AJS_
Editor
JP1_AJS_
Operator
JP1_AJS_
Guest

他ユーザーが所有権を持つユニットに対して，所有者，JP1資源グループ名，またはジョブの実行ユーザー種別を変更する
○※1
－
－
－
－

ジョブネットワーク要素を定義する
○
○※2
○※2
－
－

ジョブネットに定義したジョブネットワーク要素の定義内容を変更する
○
○※3
○※3
－
－

ジョブネットの定義内容を変更する
○
○
○
－
－

ジョブネットワーク要素を複写・移動したり，名称を変更したりする
○
○※2
○※2
－
－

ジョブネットワーク要素を削除する
○
○
○
－
－

ジョブネットワーク要素名を標準出力ファイルに出力する
○
○
○
○
○

ジョブネットワーク要素の定義内容を標準出力ファイルに出力する
○
○
○
○
○

ジョブネットワーク要素を退避する
○
○
○
○
○

ジョブネットワーク要素を回復する
○
○※2
○※2
－
－

ジョブグループにカレンダー情報を定義する
○
○
○
－
－

特定期間について，ジョブネットの実行スケジュールを定義する
○
○
－
○
－

定義済みのジョブネットを実行登録する
○
○
－
○
－

ジョブネットの実行登録を解除する
○
○
－
○
－

ジョブネットやジョブの実行履歴，現在の状態，次回実行予定などを標準出力ファイルに出力する
○
○
○
○
○

ジョブネットに定義されたスケジュールを一時的に変更する
○
○
－
○
－

ジョブの状態を一時的に変更する
○
○
－
○
－

ジョブの状態を変更する
○
○
－
○
－

ジョブネットの実行を中断する
○
○
－
○
－

ジョブネットを再実行する
○
○
－
○
－

ジョブやジョブネットの実行を強制終了させる
○
○
－
○
－

ジョブネットワーク要素をエクスポートする
○
○
○
○
○

ジョブネットワーク要素をインポートする
○
○
○
－
－

（凡例）

○：操作できる。

－：操作できない。

注

OSのスーパーユーザーは，JP1権限レベルに関係なく，すべての操作を実行できます。

また，ユニットにJP1資源グループが設定されていない場合，そのユニットに対して，JP1権限レベルに関係なく，あらゆるユーザーはすべての操作ができます。

注※1

ユニットの所有者であれば，JP1_AJS_Admin権限が与えられていなくても操作ができます。

ただし，ユニット所有者であっても，そのユニットに設定されているJP1資源グループに対して参照する権限が与えられていない場合，JP1/AJS2 - ViewからJP1資源グループ名，所有者，ジョブの実行ユーザーの種別を変更できません。JP1/AJS2 - ViewからJP1資源グループ名，所有者，ジョブの実行ユーザーの種別を変更したい場合は，「ajschange -g JP1資源グループ名 ユニット名」で，JP1資源グループ名を参照する権限が与えられているJP1資源グループに変更してください。

また，ユニットに所有者が設定されていない場合，すべてのユーザーが，JP1資源グループ名，所有者，またはジョブの実行ユーザーの種別を変更できます。

なお，ユニットの実行ユーザーの種別が所有ユーザーに設定されている場合，次に示すユーザー以外のユーザーが，ユニットの所有者を別のJP1ユーザーに変更すると，ユニットの実行ユーザーの種別が登録ユーザーになります。ユニットの実行ユーザーの種別が登録ユーザーになると，ジョブはジョブネットを実行登録したユーザーでの実行として扱われます。これは，次に示すユーザー以外のユーザーが，任意のユーザー権限でジョブを実行することを防ぐためです。

スーパーユーザー権限が与えられているユーザー

ユニットに設定されているJP1資源グループに対してJP1_AJS_Admin権限が与えられているJP1ユーザー

注※2

マネージャージョブグループ，マネージャージョブネットでは，参照先のJP1/AJS2 - Managerのアクセス権限の定義が適用されます。

注※3

ユニットの実行ユーザーの種別が所有ユーザーになっている場合，JP1_AJS_Admin権限以外のJP1ユーザーは，自分が所有するユニットでなければ変更操作ができません。これは，JP1_AJS_Admin権限が与えられていない一般ユーザーが，任意のジョブを実行することを防ぐためです。

なお，ユニットの実行ユーザーの種別が登録ユーザーになっている場合は，操作ができるJP1権限レベルを与えられているだけで変更操作ができます。

(b)　ジョブの実行・操作時のJP1権限レベル

ジョブの実行・操作時のJP1権限レベルには，次の3種類があります。

JP1_JPQ_Admin
管理者権限です。ジョブ実行環境の設定権限，キューやジョブ実行先エージェントの操作権限，ほかのユーザーがキューイングしたジョブの操作権限を持っています。

JP1_JPQ_Operator
キューの操作権限，ほかのユーザーがキューイングしたジョブの操作権限を持っています。

JP1_JPQ_User
サブミットジョブの登録や，自分がキューイングしたジョブの操作権限を持っています。

ジョブの実行・操作時のアクセス権限の設定では，資源グループ「JP1_Queue」に対して，これらの権限レベルを持たせるように設定します。「JP1_Queue」は，大文字・小文字を間違えないように入力してください。

ジョブの実行・操作時のJP1権限レベル名と詳細な操作内容を次の表に示します。

表13-3　ジョブの実行・操作時のJP1権限レベル名と詳細な操作内容

操作内容
JP1_JPQ_
Admin
JP1_JPQ_
Operator
JP1_JPQ_
User

サブミットジョブを登録する
○
○
○

ジョブの実行をキャンセルまたは強制終了する
○
○
△

ジョブの実行を保留，または保留解除する
○
○
△

ジョブを移動する
○
○
△

ジョブ情報を出力する
○
○
△

終了ジョブ情報を出力する
○
○
△

データベースから終了ジョブ情報を削除する
○
○
－

キューを開く
○
○
－

キューを閉じる
○
○
－

キューを追加する
○
－
－

キューを削除する
○
－
－

キュー情報を出力する
○
○
○

キューの定義を変更する
○
－
－

キューをエージェントに接続する
○
－
－

キューとエージェントの接続を解除する
○
－
－

ジョブ実行多重度を変更する
○
－
－

エージェントを追加する
○
－
－

エージェントを削除する
○
－
－

エージェントホスト情報を出力する
○
－
－

排他実行リソースを追加する
○
－
－

排他実行リソースを削除する
○
－
－

排他実行リソース情報を出力する
○
○
○

（凡例）

○：操作できる。

△：操作できるが，ほかのユーザーが実行したジョブは操作できない。

－：操作できない。

注意

ジョブの実行・操作時は，処理要求先マネージャーが使用する認証サーバのアクセス権限の定義が適用されます。

ジョブ実行制御のコマンドを使用してジョブの実行・操作を行う場合，コマンドを実行するOSユーザーと同名のJP1ユーザーを登録しておく必要があります。また，コマンドを実行するOSユーザーと同名のJP1ユーザーに対してジョブの実行・操作を行うのに必要なJP1権限レベルを設定してください。

例えば，OSユーザー「root」でログインしてコマンドを実行する場合は，定義ファイルに次のように記述して設定してください。

root:JP1_Queue=JP1_JPQ_Admin

上記の例では，JP1権限レベル名はJP1_JPQ_Adminですが，実行するコマンドに必要なJP1権限レベルを記述します。

jpqjobsubコマンドを実行する場合は，ジョブ実行先ホスト側でジョブを実行するJP1ユーザー（コマンドを実行したOSユーザーと同名のJP1ユーザー）と実行先ホストのOSユーザーをマッピングしておく必要があります。

jpqjobsubコマンドで-euを指定する場合は，-euに指定したOSユーザーとJP1ユーザー（コマンドを実行したOSユーザーと同名のJP1ユーザー）をジョブ実行先ホスト側でマッピングしておく必要があります。

13.1.2　JP1/AJS2 - Managerのセットアップ

この項では，JP1/AJS2 - Managerのセットアップについて説明します。JP1/AJS2 - Managerのセットアップには，スーパーユーザーの実行権限が必要です。

JP1/Baseのセットアップが完了したら，JP1/AJS2 - Managerをセットアップします。JP1/AJS2を起動するユーザーのumaskには，JP1/AJS2のコマンドを実行するすべてのユーザーから参照・更新できるumaskを設定してください。

なお，ここでは，JP1/AJS2を動作させるために，基本となるセットアップ方法を説明します。業務に合わせて設定を変更したい場合は，必要に応じて次に示す個所を参照してください。

設定または変更したい内容 | 参照個所
スケジューラーサービス環境の設定手順および設定内容 | 14.1節
ジョブ実行環境の設定手順および設定内容 | 14.2節
イベント起動の設定手順および設定内容 | 14.3節
キューレスジョブ実行環境の設定 | 14.4節
JP1/AJS2 Console環境の設定手順および設定内容 | 14.5節
スケジューラーサービスの多重起動の設定 | 14.7.1
JP1/AJS2サービスの自動起動および自動終了の設定 | 14.7.2
ISAMファイル自動再編成機能の設定 | 14.7.3
JP1/AJS2 - Managerの運用方法をサブミットジョブの登録や操作に限定するときの設定 | 14.7.7
実行登録中にルートジョブネットの下位定義を編集する場合に必要なサスペンド機能の設定変更 | 14.7.8
JP1/AJS2定義内容の事前チェック機能の設定 | 14.7.11
ジョブネットコネクタで異なるスケジューラーサービス間のルートジョブネットの実行順序を制御するための設定 | 14.7.12
スケジューラーデータベースに組み込みDBを使用する場合の設定 | 15章
ジョブ実行時のワークパスを変数として定義する | 16.1節
転送元ファイルの検索パスを定義する | 16.2節
JP1ユーザー仮定機能 | 16.3節
エージェントのパイプ通信タイムアウト値の変更 | 16.4節
ジョブプロセス実行準備完了通知時のタイムアウト値の設定 | 16.5節
イベントジョブのログサイズ設定の変更 | 16.6節
イベント順序保証オプションの設定 | 16.7節
ファイル監視ジョブの状態引き継ぎオプションの設定 | 16.8節
「"（ダブルクォーテーションマーク）」を含むデータをイベントジョブの引き継ぎ情報に使用するための設定 | 16.9節
ファイル受信制限をするための設定 | 16.13節
ジョブの結果ファイルの再送間隔・再送回数の変更 | 16.15節
ジョブ結果ファイルの二重受信防止の設定 | 16.16節
TCP/IP通信接続エラーのリトライ間隔・回数の変更 | 16.17節
ジョブを配信するエージェントホストの決定方式の設定 | 16.18節
マクロ変数の展開失敗時の動作の設定 | 16.19節
マクロ変数の引き継ぎ情報がNULL文字列の場合の置き換え方法の設定 | 16.20節
ラージファイル（2ギガバイト以上のファイル）を監視するための設定 | 16.21節
JP1/AJS2のサービスが停止してもイベントジョブの実行を継続させる設定 | 16.30
ログ情報の採取 | 17章
クラスタシステムのセットアップ | 18章

＜この項の構成＞

(1)　セットアップの手順

(1)　セットアップの手順

JP1/AJS2 - Managerのセットアップの手順を次に示します。

なお，新規で07-00以降のJP1/BaseとJP1/AJS2 - Managerをインストールした場合，手順1のjp1ajs2_setupコマンドは自動的に実行されるので，手順2からセットアップを実施してください。インストール時のセットアップ処理で問題が発生した場合だけ，補助的にjp1ajs2_setupコマンドを使用して，セットアップしてください。

jp1ajs2_setupコマンドを実行する。
ジョブ実行環境が設定されます。このコマンドを実行すると，JP1/AJS2の構成定義情報（jbssetcnfコマンドで実行できます）およびジョブ実行環境情報（jpqimportコマンドで実行できます）が設定され，JP1/AJS2のポート番号が/etc/servicesファイルに追加されます。設定しようとしたポート番号がすでに/etc/servicesファイルに設定されている場合，次のメッセージが表示されます。

Service(サービス名称) port ポート番号/tcp already used.

このメッセージは，/etc/servicesファイルのコメント中に該当ポート番号が指定されている場合にも表示されます。使用済みのポート番号と重複しないポート番号を登録したあと，jp1ajs2_setupコマンドを再実行してください。

システムおよびユーザー環境をセットアップする。
システムおよびユーザー環境のセットアップについては，「13.4 システムおよびユーザー環境で必要なセットアップ」を参照してください。

必要に応じて，JP1/AJS2サービスの自動起動・終了を設定する。
JP1/AJS2サービスの自動起動・終了方法の設定については，「14.7.2 JP1/AJS2サービスの自動起動および自動終了の設定」を参照してください。

必要に応じて，ISAMファイル自動再編成機能を有効にする。
ISAMファイルの自動再編成機能を有効にすると，JP1/AJS2サービスの起動時にISAMファイルを自動的に再編成できます。設定方法については，「14.7.3 ISAMファイル自動再編成機能の設定」を参照してください。

必要に応じて，共有メモリーのセグメント数を増加させないように設定する。
共有メモリーのセグメント数を増加させない設定については，「13.5.1 ジョブ実行制御で使用する共有メモリーについて」を参照してください。

07-50と同様のオプションで運用する場合， 07-50互換オプションを適用する。
次の手順に従ってください。

ajs2_0750.conf.modelをajs2_0750.confにコピーする。

ajs2_0750.confを必要に応じて編集する。

jbssetcnfコマンドを実行する。

（例）

jbssetcnf ajs2_0750.conf

これでセットアップは終了です。

13.2　JP1/AJS2 - Agentで必要なセットアップ

JP1/AJS2 - Agentを使うには，JP1/Baseのセットアップと，JP1/AJS2 - Agentのセットアップが必要です。

まず，JP1/Baseをセットアップし，次にJP1/AJS2 - Agentをセットアップします。

＜この節の構成＞

13.2.1　JP1/Baseのセットアップ

13.2.2　JP1/AJS2 - Agentのセットアップ

13.2.1　JP1/Baseのセットアップ

この項では，JP1/Baseのセットアップについて説明します。

なお，ここでは，設定の流れと大まかな設定内容を説明します。設定方法，設定項目，コマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/Baseは，次の流れでセットアップします。

ユーザー情報の設定
ユーザー情報の設定では，JP1/Baseのユーザー管理機能を使って，ユーザーマッピングを設定します。
ユーザーマッピングは，他ホストから自ホストに対してジョブ実行を依頼される場合に必要な設定です。JP1ユーザーに，各ホストに登録されているOSユーザーをマッピングします。
設定方法については，「(1) ユーザー情報を設定する」を参照してください。

イベントサービス環境の設定
イベントサービス環境の設定は，JP1イベントを送受信するために必要です。
設定方法については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/Baseのセットアップの手順と定義内容を次に示します。

＜この項の構成＞

(1)　ユーザー情報を設定する

(1)　ユーザー情報を設定する

UNIX版JP1/Baseでは，コマンドを使ってユーザー情報を設定します。ユーザー情報の設定手順を設定内容ごとに説明します。

なお，JP1/AJS2 - Agent 07-00-/C以降では，JP1/AJS2 - Agentの起動時に認証サーバへのアクセスを行わなくなりました。

JP1/AJS2 - Agentで認証サーバを指定する必要はありません。

(a)　ユーザーマッピングを設定する

認証サーバに登録されているJP1ユーザーに対して，OSユーザーをマッピングします。

ユーザーマッピングの設定手順を次に示します。

エディターなどで，新規のテキストファイルを開く。
このファイルを，ユーザーマッピング定義ファイルとします。

「JP1ユーザー名:ホスト名:OSユーザー名」の形式で定義を記述する。
記述例を次に示します。

定義の記述が終了したらファイルを閉じ，次のコマンドを実行する。

jbsmkumap -f ユーザーマッピング定義ファイル

定義した内容が有効になります。

補足事項

ユーザーマッピング定義ファイルに設定する項目を次の表に示します。

表13-4　ユーザーマッピング定義ファイルに設定する項目（JP1/AJS2 - Agent）

操作内容 | JP1ユーザー名 | ホスト名 | OSユーザー名
JP1/AJS2 - Managerホスト以外のホストでジョブを実行する | JP1/AJS2 - ManagerホストのOSにログインするユーザー | JP1/AJS2 - Managerホスト | ジョブを実行するホストのOSに登録されているユーザー

注意事項

マッピングするOSユーザーには，ユーザーID，グループIDを正しく設定したOSユーザーを指定してください。

また，JP1ユーザーにマッピングするOSユーザーは正常にOSにログインできるOSユーザーをJP1ユーザーにマッピングしてください。

OSユーザーが次に示す状態だとジョブが起動失敗となるおそれがあります。

/etc/passwdに指定したホームディレクトリが存在しない。

/etc/passwdに指定したログインシェルが存在しない。

13.2.2　JP1/AJS2 - Agentのセットアップ

この項では，JP1/AJS2 - Agentのセットアップについて説明します。JP1/AJS2 - Agentのセットアップには，スーパーユーザーの実行権限が必要です。

JP1/Baseのセットアップが完了したら，JP1/AJS2 - Agentをセットアップする前に，接続先のJP1/AJS2 - Managerが正常に動作することを確認しておいてください。

JP1/AJS2を起動するユーザーのumaskには，JP1/AJS2のコマンドを実行するすべてのユーザーから参照・更新できるumaskを設定してください。

なお，ここでは，JP1/AJS2を動作させるために，基本となるセットアップ方法を説明します。業務に合わせて設定を変更したい場合は，必要に応じて次に示す個所を参照してください。

設定または変更したい内容 | 参照個所
ジョブ実行環境の設定手順および設定内容 | 14.2節
キューレスジョブ実行環境の設定 | 14.4節
JP1/AJS2サービスの自動起動および自動終了の設定 | 14.7.2
JP1/AJS2定義内容の事前チェック機能の設定 | 14.7.11
ジョブ実行時のワークパスを変数として定義する | 16.1節
エージェントのパイプ通信タイムアウト値の変更 | 16.4節
ジョブプロセス実行準備完了通知時のタイムアウト値の設定 | 16.5節
イベントジョブのログサイズ設定の変更 | 16.6節
ファイル監視ジョブの状態引き継ぎオプションの設定 | 16.8節
ラージファイル（2ギガバイト以上のファイル）を監視するための設定 | 16.21節
ログ情報の採取 | 17章
クラスタシステムのセットアップ | 18章

＜この項の構成＞

(1)　セットアップの手順

(1)　セットアップの手順

JP1/AJS2 - Agentのセットアップの手順を次に示します。

なお，新規で07-00以降のJP1/BaseとJP1/AJS2 - Agentをインストールした場合，手順1のjp1ajs2_setupコマンドは自動的に実行されるので，手順2からセットアップを実施してください。インストール時のセットアップ処理で問題が発生した場合だけ，補助的にjp1ajs2_setupコマンドを使用して，セットアップしてください。

jp1ajs2_setupコマンドを実行する。

システムおよびユーザー環境をセットアップする。
システムおよびユーザー環境のセットアップについては，「13.4 システムおよびユーザー環境で必要なセットアップ」を参照してください。

必要に応じて，JP1/AJS2サービスの自動起動・終了方法を設定する。
JP1/AJS2サービスの自動起動・終了方法の設定については，「14.7.2 JP1/AJS2サービスの自動起動および自動終了の設定」を参照してください。

必要に応じて，共有メモリーのセグメント数を増加させないように設定する。
共有メモリーのセグメント数を増加させない設定については，「13.5.1 ジョブ実行制御で使用する共有メモリーについて」を参照してください。

07-50と同様のオプションで運用する場合，07-50互換オプションを適用する。
次の手順に従ってください。

ajs2_0750.conf.modelをajs2_0750.confにコピーする。

ajs2_0750.confを必要に応じて編集する。

jbssetcnfコマンドを実行する。

（例）

jbssetcnf ajs2_0750.conf

これでセットアップは終了です。

13.3　JP1/AJS2 Consoleで必要なセットアップ

JP1/AJS2 Console機能を使用する場合には，JP1/AJS2 Console Manager, JP1/AJS2 Console Agent, JP1/AJS2 Console Viewのそれぞれで，セットアップが必要です。

＜この節の構成＞

13.3.1　JP1/AJS2 Console Managerのセットアップ

13.3.2　JP1/AJS2 Console Agentのセットアップ

13.3.1　JP1/AJS2 Console Managerのセットアップ

JP1/AJS2 Console Managerを使用するためには，JP1/AJS2 - ManagerをインストールしたホストでJP1/AJS2 Console Managerのセットアップをする必要があります。

セットアップの手順を次に示します。

jp1ajs2cmsetupコマンドを実行する。

必要に応じて，JP1/AJS2 Console Managerサービスの自動起動・終了方法を設定する。

JP1/AJS2 Console Managerサービスの自動起動・終了方法の設定については，「14.7.2(3) JP1/AJS2 Consoleサービスの自動起動および自動終了を設定する」を参照してください。

13.3.2　JP1/AJS2 Console Agentのセットアップ

JP1/AJS2 Console Agentを使用するためには，JP1/AJS2 - ManagerをインストールしたホストでJP1/AJS2 Console Agentのセットアップをする必要があります。

セットアップの手順を次に示します。

jp1ajs2casetupコマンドを実行する。

必要に応じて，JP1/AJS2 Console Agentサービスの自動起動・終了方法を設定する。

JP1/AJS2 Console Agentサービスの自動起動・終了方法の設定については，「14.7.2(3) JP1/AJS2 Consoleサービスの自動起動および自動終了を設定する」を参照してください。

13.4　システムおよびユーザー環境で必要なセットアップ

システム環境およびユーザー環境のセットアップについて説明します。

＜この節の構成＞

13.4.1　言語環境の設定

13.4.2　ログインスクリプトの変更

13.4.3　カーネルパラメーターの調整

13.4.4　トレースログファイルの拡張

13.4.5　通信環境の設定

13.4.6　ジョブ実行環境の構成定義情報を変更する

13.4.1　言語環境の設定

システムの言語環境を設定する方法を次に示します。

なお，システムで使用できる言語種別の詳細については，マニュアル「JP1/Automatic Job Management System 2 設計・運用ガイド　5.6.1 システムで使用する言語種別を検討する」を参照してください。

＜この項の構成＞

(1)　文字コード種別の変更

(1)　文字コード種別の変更

文字コードの変更手順を次に示します。なお，すでにJP1/AJS2で運用しているユニット名に仮名文字や2バイトコード文字を使用している場合は，ユニットを再定義する必要があります。

JP1の各サービス，接続しているJP1/AJS2 - Viewおよび実行中のコマンドを停止する。

JP1/Baseで使用する文字コード種別を変更する。
JP1/Baseで使用する文字コード種別の変更方法については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/AJS2サービスが発行するイベントやジョブ実行環境などの出力文字コード種別を変更するために，次のファイルをviなどのエディターで開く。

物理ホストの場合

/etc/opt/jp1ajs2/conf/jp1ajs_env.conf

論理ホストの場合

共用ディレクトリ/jp1ajs2/conf/jp1ajs_env.conf

手順3で開いたファイルの「LANG=」と定義された行に，変更後の環境変数LANGを指定し，ファイルを保存する。

ジョブの実行環境およびユニット定義環境の文字コード種別を変更するために，環境設定情報を変更する。
次に示す内容を記述した設定用一時ファイル（拡張子は「.conf」）を作成します。

[{JP1_DEFAULT|論理ホスト名}¥JP1AJSMANAGER¥スケジューラーサービス名¥]
"AJSCHARCODE"="EUC"

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。
スケジューラーサービス名は，標準では「AJSROOT1」です。AJSCHARCODEパラメーターの詳細については，「14.1.3 スケジューラーサービス環境設定パラメーターの定義内容」を参照してください。

スケジューラーサービスがsyslogファイルへ出力するメッセージを変更するために，環境設定情報を変更する。
次に示す内容を記述した設定用一時ファイル（拡張子は「.conf」）を作成します。

[{JP1_DEFAULT|論理ホスト名}¥JP1AJSMANAGER¥スケジューラーサービス名¥]
"SYSLOGCODE"="C"

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。
なお，「C」以外の値を指定した場合，スケジューラーサービスを起動した環境の環境変数LANGに従います。スケジューラーサービスを起動する環境の環境変数LANGを変更してください。

LANG="ja_JP.SJIS"
export LANG

注意

syslogファイルに環境変数LANGで指定した文字コードが出力できない場合があります。その場合には「C」を必ず指定してください。

JP1/AJS2 Monitorサービスが出力するメッセージを変更します。
JP1/AJS2 Monitorサービスを起動する環境の環境変数LANGを変更してください。

LANG="ja_JP.SJIS"
export LANG

JP1/AJS2 Consoleを使用する場合には，ユーザー定義データに格納される情報の文字コードを変更するために，環境設定情報を変更する。
次に示す内容を記述した設定用一時ファイル（拡張子は「.conf」）を作成します。

[JP1_DEFAULT¥JP1AJS2CONSOLEMANAGER¥]
"CHARCODE"="EUC"

CHARCODEパラメーターの詳細については，「14.5.1 JP1/AJS2 Console Manager環境の設定」を参照してください。

JP1/AJS2 Console を使用する場合には，JP1/AJS2 Console ManagerまたはJP1/AJS2 Console Agentがsyslogファイルへ出力するメッセージを変更するために，環境設定情報を変更する。
次に示す内容を記述した設定用一時ファイル（拡張子は「.conf」）を作成します。

JP1/AJS2 Console Managerの場合

[JP1_DEFAULT¥JP1AJS2CONSOLEMANAGER¥]
"SYSLOGCODE"="C"

JP1/AJS2 Console Agentの場合

[JP1_DEFAULT¥JP1AJS2CONSOLEAGENT¥]
"SYSLOGCODE"="C"

「C」以外の値を指定した場合，JP1/AJS2 Console ManagerまたはJP1/AJS2 Console Agentサービスを起動した環境の環境変数LANGに従います。JP1/AJS2 Console ManagerまたはJP1/AJS2 Console Agentサービス起動する環境の環境変数LANGを変更してください。

LANG="ja_JP.SJIS"
export LANG

注意

syslogファイルに環境変数LANGで指定した文字コードが出力できない場合があります。その場合には「C」を必ず指定してください。

JP1/AJS2 Console を使用する場合には，JP1/AJS2 Console ManagerまたはJP1/AJS2 Console Agentサービスが出力するメッセージを変更します。
JP1/AJS2 Console ManagerまたはJP1/AJS2 Console Agentサービスを起動する環境の環境変数LANGを変更してください。

LANG="ja_JP.SJIS"
export LANG

次のコマンドを実行する。

/opt/jp1base/bin/jbssetcnf 設定用一時ファイル名

設定用一時ファイルに設定した文字コード種別が設定されます。

13.4.2　ログインスクリプトの変更

JP1/AJS2では，UNIXジョブの実行に先立って，次に示すシェルのログインスクリプトが実行されます。

shの場合

/etc/profile
$HOME/.profile

cshの場合

/etc/csh.login
$HOME/.cshrc
$HOME/.login

そのため，ログインスクリプトの中にechoやcatコマンドなど，標準出力ファイルへ出力するコマンドがあると，ジョブの実行結果以外のテキストが標準出力ファイルに出力されます。また，対話環境が前提であるstty，tty，tset，scriptコマンドなどをバッチ環境で実行すると，ジョブが異常終了するおそれがあります。このような場合は，これらのコマンドを実行しないようにログインスクリプトを変更してください。

なお，シェルで読み込むログインスクリプトで上記以外のものについては，各OSでの動作を確認してください。

例えば，shの場合は，ログインスクリプトの該当する個所に，次に示す網掛けの部分を追加してください。

cshの場合も同様に，該当する個所に，次に示す網掛けの部分を追加してください。

補足事項

AIXでは，/etc/environmentの情報は引き継ぎません。次の例を参考にして，ログインスクリプトを変更してください。

if [ ${JP1JobID:-""} != "" ]; then

. /etc/environment

fi

/etc/environmentを読み込んだあと，設定したい環境変数に対してexportコマンドを実行してください。

注意

上記の設定は，sh（.profile）だけで有効です。その他のcshなどでは無効です。上記の設定をした場合，ログインスクリプトの中で/etc/environmentを読み込むため，各情報の設定順序が変わることがあることを考慮する必要があります。このため，ログインスクリプトに/etc/environmentの読み込みを追加する際は，/etc/environmentで設定している環境変数をログインスクリプトでも設定している個所がないかを確認し，挿入個所に十分注意してください。

ログインスクリプトの最初で/etc/environmentを読み込むように変更することをお勧めします。

13.4.3　カーネルパラメーターの調整

UNIX環境でJP1/AJS2を使用する場合，カーネルパラメーターを調整し，JP1/AJS2の実行処理に必要なリソースを割り当ててください。調整が必要なカーネルパラメーターはOSごとに異なります。詳細については，製品添付のドキュメント（リリースノートまたはソフトウェア添付資料）を参照してください。

カーネルパラメーターとは，UNIXシステムが使用するリソースを調整して最適化するための設定です。次のような値を調整します。

ファイルシステムの調整：ファイルの最大オープン数，ファイルの最大ロック数

共用メモリーの調整：共用メモリーの最大サイズ，共用メモリーの最大数

セマフォの調整：セマフォの最大数，セマフォの最大アンドゥ数

カーネルパラメーターについての詳しい説明は，各OSのドキュメントやUNIXの参考文献を参照してください。

13.4.4　トレースログファイルの拡張

次に示すUNIX版トレースログファイルの拡張手順を説明します。

JP1/AJS2のトレースログファイル

JP1/AJS2 Consoleのトレースログファイル

キューレストレースログファイル

キューレスジョブ実行内部ログファイル

＜この項の構成＞

(1)　JP1/AJS2のトレースログファイルの拡張

(2)　JP1/AJS2 Consoleのトレースログファイルの拡張

(3)　キューレストレースログファイルの拡張

(4)　キューレスジョブ実行内部ログファイルの拡張

(1)　JP1/AJS2のトレースログファイルの拡張

JP1/AJS2のトレースログファイルは，初期状態では次のように設計されています。

格納先
/var/opt/jp1ajs2/log/tracelog

サイズ
約2,000個のジョブを実行したときのトレースログを保存できるサイズ（具体的には，20メガバイト（20,480キロバイト））

必要となるトレースログファイルの容量は，ジョブネットの構造や，JP1/AJS2 - Viewの接続数，操作内容によって大きく異なります。必要に応じて，トレースログファイルの適切な容量を見積もり，拡張してください。

トレースログファイルの適切な容量を見積もる方法については，マニュアル「JP1/Automatic Job Management System 2 設計・運用ガイド　4.4.2 トレースログファイルのサイズを見積もる」を参照してください。

トレースログファイルのサイズを拡張する手順を次に示します。

次のコマンドを実行する。

ajstrsetsz -s 適切なトレースログファイル容量

（例）

トレースログファイルのサイズを20メガバイト（20,480キロバイト）から30メガバイト（30,720キロバイト）に拡張する場合

ajstrsetsz -s 30720

(2)　JP1/AJS2 Consoleのトレースログファイルの拡張

JP1/AJS2 Consoleのトレースログファイルの拡張は，JP1/AJS2 Console ManagerとJP1/AJS2 Console Agentではそれぞれ設定が必要です。JP1/AJS2 Consoleのトレースログファイルは，初期状態では次のように設計されています。

格納先
JP1/AJS2 Console Managerの場合：/var/opt/jp1ajs2cm/log/tracelog.cm
JP1/AJS2 Console Agentの場合：/var/opt/jp1ajs2/log/tracelog.ca

サイズ
JP1/AJS2 Console Managerの場合：3,072キロバイト
JP1/AJS2 Console Agentの場合：3,072キロバイト

必要となるトレースログファイルの容量は，業務の監視状況などによって大きく異なります。必要に応じて，トレースログファイルの適切な容量を見積もり，拡張してください。

トレースログファイルの適切な容量を見積もる方法については，マニュアル「JP1/Automatic Job Management System 2 設計・運用ガイド　4.4.2 トレースログファイルのサイズを見積もる」を参照してください。

トレースログファイルのサイズを拡張する手順を次に示します。

(a)　JP1/AJS2 Console Managerの場合

次のコマンドを実行する。

ajscmtrsetsz -s 適切なトレースログファイル容量

（例）

トレースログファイルのサイズを3メガバイト（3,072キロバイト）から10倍の30メガバイト（30,720キロバイト）に拡張する場合

ajscmtrsetsz -s 30720

(b)　JP1/AJS2 Console Agentの場合

次のコマンドを実行する。

ajscatrsetsz -s 適切なトレースログファイル容量

（例）

トレースログファイルのサイズを3メガバイト（3,072キロバイト）から10倍の30メガバイト（30,720キロバイト）に拡張する場合

ajscatrsetsz -s 30720

(3)　キューレストレースログファイルの拡張

キューレストレースログファイルは，初期状態では次のように設計されています。

格納先
/var/opt/jp1ajs2/log/tracelog.ql

サイズ
約10,000個のジョブを実行したときのトレースログを保存できるサイズ（具体的には，15メガバイト（15,360キロバイト））

必要となるキューレストレースログファイルの容量は，ジョブのファイル転送の有無やエラー出力結果の有無によって大きく異なります。必要に応じてトレースログファイルの適切な容量を見積もり，拡張してください。

トレースログファイルの適切な容量を見積もる方法については，マニュアル「JP1/Automatic Job Management System 2 設計・運用ガイド　4.4.6 キューレストレースログファイルのサイズを見積もる」を参照してください。

トレースログファイルのサイズを拡張する手順を次に示します。

次のコマンドを実行する。

ajsqltrsetsz -s 適切なトレースログファイル容量

（例）

トレースログファイルのサイズを15メガバイト（15,360キロバイト）から30メガバイト（30,720キロバイト）に拡張する場合

ajsqltrsetsz -s 30720

(4)　キューレスジョブ実行内部ログファイルの拡張

キューレスジョブ実行内部ログファイルは，初期状態では次のように設定されています。

格納先
/var/opt/jp1ajs2/log/ajsqlexeclog※1
/var/opt/jp1ajs2/log/ajsqlexeclog_ftpd※2

注※1

クラスタ運用時は，名称が次のようになります。

/var/opt/jp1ajs2/log/ajsqlexeclog-[論理ホスト名]

なお，名称が256バイト以上である場合は，ファイル名に論理ホスト名として30バイトまで付加します。

注※2

JP1/AJS2 - Managerの場合だけ作成します。

サイズ

ajsqlexeclogファイルの場合

約40,000個のキューレスジョブを実行したときに，キューレスエージェントサービスが出力する実行内部ログを保存できるサイズ（具体的には，24メガバイト（24,576キロバイト））

ajsqlexeclog_ftpdファイルの場合

約20,000個のファイル転送を伴うキューレスジョブを実行したときに，キューレスファイル転送サービスが出力する実行内部ログを保存できるサイズ（具体的には，10メガバイト（10,240キロバイト））

必要となるキューレスジョブ実行内部ログファイルのサイズは，実行するキューレスジョブの個数，およびキューレスジョブ実行時のファイル転送の有無などによって大きく異なります。必要に応じて，キューレスジョブ実行内部ログファイルの適切なサイズを見積もり，拡張してください。

キューレスジョブ実行内部ログファイルの適切なサイズを見積もる方法については，マニュアル「JP1/Automatic Job Management System 2 設計・運用ガイド　4.4.7 キューレスジョブ実行内部ログファイルのサイズを見積もる」を参照してください。また，キューレスジョブ実行内部ログファイルのサイズを拡張する方法については，マニュアル「JP1/Automatic Job Management System 2 コマンドリファレンス　1. コマンド　ajsqlexecsetsz」を参照してください。

13.4.5　通信環境の設定

DNSの構成や，ファイアウォールを使用した環境でJP1/AJS2を構築する場合には，取得できるホスト名やファイアウォール上での通信設定が必要です。

次の個所を参照し，通信環境を設定してください。

マニュアル「JP1/Automatic Job Management System 2 設計・運用ガイド　3.3.3 DNS環境で運用する場合の注意事項」

マニュアル「JP1/Automatic Job Management System 2 設計・運用ガイド　3.4.5 ファイアウォールを設定した環境の構成例と通信設定」

13.4.6　ジョブ実行環境の構成定義情報を変更する

ジョブ実行環境は，デフォルトで実行ホスト（エージェント）が一つ，ローカルホストに作成されます。しかし，システムによってはジョブの実行環境を変更する（ジョブ実行環境に構成定義情報を追加する）必要があります。

例として，次の場合があります。

実行ホストが複数台ある場合

他システム（JP1/NQSEXECやJP1/OJEなど）と連携する場合

ジョブを複数の実行ホストで分散実行する場合

特定ジョブ同士を排他実行する場合

ジョブの実行環境を変更する（ジョブ実行環境に構成定義情報を追加する）必要がある場合は，次のどちらかの方法で新たに実行ホスト（エージェント），キュー，または排他実行リソースの構成定義情報を追加してください。

ジョブ実行環境に構成定義情報を一括で追加する

運用中にジョブ実行環境の構成定義情報を動的に追加する

ジョブ実行環境に構成定義情報を一括で追加する場合は，「14.2.1(3) ジョブ実行環境の構成定義情報を一括で変更する場合の手順」を参照してください。

運用中にジョブ実行環境の構成定義情報を動的に追加する場合は，「14.2.1(4) 運用中にジョブ実行環境の構成定義情報を変更する場合の手順」を参照してください。

13.5　そのほかの注意事項

＜この節の構成＞

13.5.1　ジョブ実行制御で使用する共有メモリーについて

13.5.1　ジョブ実行制御で使用する共有メモリーについて

ジョブ実行制御のエージェントプロセスは共有メモリーを使用して情報のやり取りをしています。これらの情報は通常はJP1/AJS2サービス停止時に削除されますが，エージェントプロセスが異常終了したり，jajs_killall.clusterコマンドを使用してサービスを強制停止させたりするとこれらの情報が残ってしまうことがあります。エージェントプロセスの異常終了または強制停止と再起動が繰り返されると，共有メモリーのセグメント数が増加してシステムに影響を与えるおそれが出てきます。

jpqshmakeコマンドを実行すると共有メモリーのセグメント数を増加させないようにできます。JP1/AJS2 06-71-/H以降のバージョンから新規インストールした場合は，JP1/AJS2のセットアップ（jp1ajs2_setup，jp1ajs2_setup.cluster）を行った際にjpqshmakeコマンドが自動的に実行されます。ただし，JP1/AJS2 06-71-G1以前のバージョンから上書きインストールしてセットアップを行った場合，jpqshmakeコマンドは自動的に実行されません。この場合はjpqshmakeコマンドを手動で実行してください。jpqshmakeコマンドの詳細については,「20. セットアップ時に使用するコマンド　jpqshmake（UNIX限定）」を参照してください。

14.　環境設定

この章では，JP1/AJS2の環境設定について説明します。

＜この章の構成＞

14.1　スケジューラーサービス環境の設定

14.2　ジョブ実行環境の設定

14.3　イベント起動に関する環境の設定

14.4　キューレスジョブ実行環境の設定

14.5　JP1/AJS2 Console環境の設定

14.6　JP1/AJS2共通情報の設定

14.7　そのほかの設定

14.1　スケジューラーサービス環境の設定

スケジューラーサービス環境の設定は，マネージャー環境（JP1/AJS2 - Manager）で作業します。エージェント環境（JP1/AJS2 - Agent）で設定する作業はありません。

スケジューラーサービス環境のセットアップに使用する構成定義ファイル（スケジューラーサービス環境設定ファイル（Schedule.conf））には，環境設定に必要な情報が定義されています。情報を変更したい場合は，構成定義ファイルの内容（環境設定パラメーターの定義内容）を書き換えてください。

＜この節の構成＞

14.1.1　スケジューラーサービス環境の設定手順

14.1.2　スケジューラーサービス環境設定ファイルの環境設定パラメーター一覧

14.1.3　スケジューラーサービス環境設定パラメーターの定義内容

14.1.1　スケジューラーサービス環境の設定手順

この項では，構成定義ファイルの内容（環境設定パラメーターの定義内容）を変更する手順を説明します。

なお，スケジューラーサービス環境設定ファイル（Schedule.conf）の内容については，「14.1.2 スケジューラーサービス環境設定ファイルの環境設定パラメーター一覧」または「14.1.3 スケジューラーサービス環境設定パラメーターの定義内容」を参照してください。

＜この項の構成＞

(1)　初期状態の構成定義情報を変更する場合の手順

(2)　設定済みの構成定義情報を利用して変更する場合の手順

(1)　初期状態の構成定義情報を変更する場合の手順

構成定義ファイルは，初期状態では推奨値で定義されています。初期状態の登録情報の変更手順を次に示します。

次のファイルをエディターで開く。

/etc/opt/jp1ajs2/conf/Schedule.conf

構成定義パラメーターを変更し，保存する。

次のコマンドを実行する。

jbssetcnf 設定ファイル名

jbssetcnfコマンドのパスは，「/opt/jp1base/bin/jbssetcnf」です。
jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。
設定ファイルの内容が構成定義に反映されます。

(2)　設定済みの構成定義情報を利用して変更する場合の手順

定義情報ファイルは，現在設定されている登録情報から作成することもできます。現在設定されている登録情報の変更手順を次に示します。

次のコマンドを実行する。

jbsgetcnf [-h 論理ホスト名] > 退避ファイル名

jbsgetcnfコマンドのパスは，「/opt/jp1base/bin/jbsgetcnf」です。
jbsgetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。
現在設定されている定義情報が退避ファイルに退避されます。

手順1で取得した退避ファイルをviなどのエディターで開く。

構成定義パラメーターを変更または追加し，保存する。

次のコマンドを実行する。

jbssetcnf 退避ファイル名

jbssetcnfコマンドのパスは，「/opt/jp1base/bin/jbssetcnf」です。
jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。
変更した退避ファイルの内容が登録されます。

14.1.2　スケジューラーサービス環境設定ファイルの環境設定パラメーター一覧

スケジューラーサービス環境設定ファイルの環境設定パラメーターの一覧を次の表に示します。

各パラメーターの推奨値と設定が有効になる時期については，マニュアル「JP1/Automatic Job Management System 2 設計・運用ガイド　5.3.1 スケジューラーサービスに関する環境設定について検討する」を参照してください。

表14-1　環境設定パラメーター一覧（Schedule.conf）

定義キー | 環境設定パラメーター | 定義内容
[JP1_DEFAULT¥JP1AJSMANAGER] | "MAXSESSION"=※1 | 最大同時セション数
"IPC_TIMEOUT"=※1 | リモート通信タイムアウト時間
"IPC_LOCALTIMEOUT"=※1 | ローカル通信タイムアウト時間
"IPCRETRYINTERVAL"=※1 | リトライ間隔
"IPCRETRYCOUNT"=※1 | リトライ回数
"DEFAULTSERVICENAME"=※1 | デフォルトスケジューラーサービス名
"REMNETSERVICENAME"=※1 | リモートジョブネットを実行するスケジューラーサービス名
"AUTORESTARTCOUNT"=※1 | スケジューラーサービスの再起動回数
"RESTARTCLRTIME"=※1 | 再起動回数をクリアーするまでの時間
"MASTERDABEND"=※1 | スケジューラーサービス異常時の処理
"TRACELOGFILE"=※1 | スケジューラートレースログファイルの名称
"EVENTRETRY"=※1 | イベントサービス接続失敗時の処理
"VRSHIFT_IMMINT"=※1 | ジョブネット中断・強制終了時の即時停止の可否
"VRSHIFT_INTRERUN"=※1 | 中断したジョブネットの，後続ユニットの再実行の可否
"AJSINETDLOGSIZE"=※1 | JP1/AJS2 Monitorサービスの内部ログサイズ
"MONLOG"=※1 | JP1/AJS2 - ViewおよびJP1/AJS2 - Scenario Operationからスケジューラーサービスへの接続開始・終了メッセージの，スケジューラーログへの出力
"MONSYSLOG"=※1 | JP1/AJS2 Monitorサービスおよびモニターサーバの開始・終了メッセージの，syslogファイルおよび統合トレースログへの出力
"AUTHLOG"=※1 | ユーザー認証に関するメッセージをスケジューラーログに出力するかしないかの設定
"AUTHSYSLOG"=※1 | ユーザー認証に関するメッセージをsyslogファイルおよび統合トレースログに出力するかしないかの設定
[{JP1_DEFAULT|論理ホスト名}¥JP1AJSMANAGER]※2 | "LOGSIZE"= | スケジューラーログファイルのサイズ
"AJSLOGFILE1"= | スケジューラーログファイル1の名称
"AJSLOGFILE2"= | スケジューラーログファイル2の名称
"HIDEOTHERLHOST"= | JP1/AJS2 - Viewのスケジューラーサービス表示
"LOGDLOG"= | スケジューラーログ出力プロセス（ajslogd）の起動・停止の履歴をスケジューラーログに出力するかどうかの設定
"LOGDSYSLOG"= | スケジューラーログ出力プロセス（ajslogd）の起動・停止の履歴をsyslogファイルおよび統合トレースログに出力するかどうかの設定
"AJSLOGOUTPUTYEAR"= | スケジューラーログの日付に「年」を出力するかしないかの設定
"AJSLOGOUTPUTEXTEND"= | スケジューラーログの拡張出力の設定
[{JP1_DEFAULT|論理ホスト名}¥JP1AJSMANAGER¥スケジューラーサービス名]※2 | "AUTOSTART"= | スケジューラーサービスの自動起動
"SESSIONTIMEOUT"= | 接続打ち切り時間
"AJSSERVICEID"= | スケジューラーサービスの識別番号
"AJSDBTYPE"= | データベース種別
"AJSDBDIRECTORY"= | データベースディレクトリ名
"ISAMWRITEMODE"= | ISAMファイル更新時の書き込み方法
"TABLENAMEPREFIX"= | テーブル名プリフィックス
"TABLENAMEPOSTFIX"= | テーブルID
"RDBAUTHID"= | RDB認可識別子
"RDBUSER"= | RDBアクセスユーザー名
"RDBPASSWORD"= | RDBユーザーパスワード
"RDBCHECKINTERVAL"= | RDBサーバ接続確認機能使用有無
"RDBHOST"= | RDB接続先ホスト名
"RDBPORT"= | RDB接続ポート番号
"RDBIPC"= | RDBサーバとの通信方式
"RDBSENDMEMSIZE"= | RDBプロセス間メモリー通信使用時の，送信用メモリーサイズ
"RDBRECVMEMSIZE"= | RDBプロセス間メモリー通信使用時の，受信用メモリーサイズ
"RDBCONNECTWAITTIME"= | RDBへの接続の最大待ち合わせ時間
"AJSCHARCODE"= | 文字コード
"AJSTMPDIR"= | テンポラリーファイル用ディレクトリ名
"JOBINFDIR"= | ジョブエラー情報ディレクトリ名
"AJSBKUROOT"= | 退避情報ディレクトリ名
"HNTRLOGLEVEL"= | 統合トレースログに出力するメッセージレベル
"SYSLOGCODE"= | ログファイル出力時の文字コード
"AJSSYSLOG"= | スケジューラーサービスの起動・終了メッセージの，syslogファイルへの出力
"NETSYSLOG"= | ジョブネット起動・終了メッセージの，syslogファイルへの出力
"JOBSYSLOG"= | ジョブネット中のジョブの開始・終了メッセージの，syslogファイルへの出力
"AJSLOG"= | スケジューラーサービスの起動・終了メッセージの，スケジューラーログファイルへの出力
"NETLOG"= | ジョブネット起動・終了メッセージの，スケジューラーログファイルへの出力
"JOBLOG"= | ジョブネット中のジョブの開始・終了メッセージの，スケジューラーログファイルへの出力
"OPELOG"= | 操作履歴の出力
"LOGINFOALL"= | ログの出力形式
"REFLOG"= | 参照履歴の出力
"LOGHEADER"= | 履歴情報にプロセスIDを付加して出力
"INFOLOG"= | 情報用履歴の出力
"ROOTJOBNETSCHEDULERANGE"= | ルートジョブネットのスケジュールの有効範囲
"VIEWSTATUSRANGE"= | 状態取得の基にする世代情報の範囲（JP1/AJS2 - Viewの状態表示ための定義）
"STARTMODE"= | サービスの起動方法
"OVERSCHEDULE"= | ジョブネットのスキップ方法
"SUPPRESS"= | ジョブネット中のジョブ・ジョブネットの実行抑止方法
"EXECDEFER"= | ジョブネットの繰り越し方法
"JOBSTATUSPORT"= | ジョブ状態取得ポートのサービス名
"QUEUELESSMULTIREQ"= | キューレスジョブリクエスト多重度
"MFPOLLINTERVAL"= | JP1/AJS2 for Mainframeに状態を問い合わせるポーリング間隔
"MFUSERNAME"= | JP1/AJS2 for Mainframeと連携する際に使用するJP1ユーザー名
"UNITDEFINERELOAD"= | ジョブネット定義変更の即時反映の有無
"INHERITCONDHOLD"= | 起動条件付きジョブネット保留属性の実行世代への引き継ぎ動作
"MAXSAVEGEN"= | 最大保存世代数
"AJSPRINTNETSCHPRF"= | ネストジョブネットの，スケジュールルールの扱い方
"SUBMITRETRYINTERVAL"= | サブミット処理でのリトライ処理間隔
"CONDEXECDEFER"= | 起動条件待ち世代の繰り越し未実行への遷移の可否
"JOBEXECIPCBUFSIZE"= | スケジューラーサービスのジョブ実行情報通信バッファサイズ
"BACKGROUNDLEAVE"= | 登録解除や保存世代数管理による世代削除の処理方式
"WARMSTARTMSG"= | スケジューラーサービスをウォームスタートで起動させたときに，実行中であったジョブまたはジョブネットの終了メッセージ，および終了イベントの出力有無の設定
"MONITORINGINVALIDHOLD"= | 起動条件監視中世代に対する保留操作時の動作
"REQDAGTREQCONNECTTIMEOUT"= | キューレスエージェントへの通信タイムアウト時間
"REQDAGTRECONNECTTIMEOUT"= | キューレスエージェントとの通信回復処理の通信タイムアウト時間
"COMMANDEVENT"= | コマンドまたはJP1/AJS2 - Viewからの操作時のJP1イベント発行有無の設定
"NONRELOADHOLDING"= | 保留中状態のユニット定義再読み込み動作設定
"RJCUSE"=※3 | 異なるスケジューラーサービス間のルートジョブネットの実行順序を制御するかどうかの設定
"JOBDELAYWARNMSG"= | スケジューラーサービスの停止中に，実行所要時間によって終了遅延を監視しているジョブがエージェントで実行開始した場合のメッセージを，スケジューラーサービス起動時に統合トレースログに出力するかどうかの設定
"FGRECONLMT"=※3 | フロー制御プロセスとスケジューラーサービス間通信制御プロセスが通信接続できなかった場合の再接続回数

注※1

この項目は必ず「[JP1_DEFAULT¥JP1AJSMANAGER]」キーの直下に指定してください。

注※2

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

注※3

定義内容の詳細については，「14.7.12 ジョブネットコネクタで異なるスケジューラーサービス間のルートジョブネットの実行順序を制御するための設定」を参照してください。

注意

スケジューラーサービスは，1台のマシンにつき物理ホストと論理ホストを合わせて20個まで作成できます。サービス名は，自ホストの物理ホストおよびすべての論理ホストで名称が重複しないように指定してください。サービス名は30バイト以内で指定し，半角英数字および次の記号が使用できます。

「!」，「#」，「$」，「%」，「+」，「-（ハイフン）」，「.（ピリオド）」，「_（アンダーバー）」

全角文字や半角カナ，および上記以外の記号は使用しないでください。

推奨しない文字を使用すると，コマンドインタープリターがコマンドラインを解析する際にスケジューラーサービス名を正しく認識できず，誤動作することがあります。

14.1.3　スケジューラーサービス環境設定パラメーターの定義内容

環境設定パラメーターの定義内容の詳細を次に示します。

環境設定パラメーターの「デフォルト」は，環境設定パラメーターを省略した場合の仮定値です。

なお，詳細の記載がないパラメーターは保守用のパラメーターです。値は変更しないでください。

"MAXSESSION"=dword:最大同時セション数

JP1/AJS2 - Viewの最大接続数を16進数で指定します。

0～80（10進数で0～128）の間で指定します。

デフォルトは「dword:00000032」（10進数で50）です。

ここで指定した数を超えてJP1/AJS2 - Viewから接続しようとした場合，接続できなくなります。

"IPC_TIMEOUT"=dword:通信タイムアウト時間

他ホストとの通信時に，接続元が通信できるまでどのくらい待つか（タイムアウト時間）を16進数で指定します。

マシン間のネットワークが高速で，マシン未起動のエラーをすぐに検知したい場合などにカスタマイズします。

このパラメーターは，次の操作時に接続元マシンの設定値が利用されます。

リモートジョブネットの実行開始，終了時
（要求元JP1/AJS2 - Manager ←→ 実行先JP1/AJS2 - Manager）

ホストリンクジョブネットの実行登録，登録解除，および実行時
（JP1/AJS2 - Manager → JP1/AJS2 - Manager for MainFrame）

ジョブ・ジョブネット操作コマンドのリモート実行
（要求元JP1/AJS2 - Manager → 実行先JP1/AJS2 - Manager）

JP1/Cm2またはhp OpenViewのNNMからの「管理→JP1AJS2の管理→JP1AJS2の状態」メニュー実行
（NNM側JP1/AJS2 - Manager → 監視先JP1/AJS2 - Manager）

0～258（10進数で0～600）（単位：秒）の間で指定します。

デフォルトは「dword:00000000」です。

ここで指定した時間を待っても通信できない場合は，エラーとなります。

なお，「dword:00000000」を指定した場合は，OSのタイムアウト時間に依存して制御されます。

"IPC_LOCALTIMEOUT"=dword:ローカル通信タイムアウト時間

JP1/AJS2のスケジューラーサービス関連のプロセス間通信時に，接続元が通信できるまでどのくらい待つか（タイムアウト時間）を16進数で指定します。内部処理用のパラメーターのため，標準設定のまま使用してください。

0～3C（10進数で0～60）（単位：秒）の間で指定します。

デフォルトは「dword:00000000」です。

ここで指定した時間を待っても通信できない場合は，エラーとなります。

なお，「dword:00000000」を指定した場合は，OSのタイムアウト時間に依存して制御されます。

"IPCRETRYINTERVAL"=dword:リトライ間隔

通信エラー時のリトライ間隔を16進数で指定します。

0～A（10進数で0～10）（単位：秒）の間で指定します。

デフォルトは「dword:00000001」（10進数で1）です。

リトライが発生するごとに，ここで指定した値分が加算されます。

"IPCRETRYCOUNT"=dword:リトライ回数

通信エラー時のリトライ回数を16進数で指定します。

0～64（10進数で0～100）の間で指定します。

デフォルトは「dword:00000003」（10進数で3）です。

スケジューラーサービスのプロセス間通信が集中した場合に，一時的に通信エラーが発生する場合があります。同時に多数のスケジューラーサービスを起動したり，同時に多量のJP1/AJS2コマンドを実行したりする場合などに，デフォルト値より大きい値を指定してください。

"DEFAULTSERVICENAME"="デフォルトスケジューラーサービス名"

デフォルトとなるスケジューラーサービスの名称を30バイト以内で指定します。

デフォルトは「AJSROOT1」です。

コマンド実行時などで，対象となるスケジューラーサービス名が指定されていない場合は，ここで指定したスケジューラーサービスを対象として処理されます。

"REMNETSERVICENAME"="リモートジョブネットを実行するスケジューラーサービス名"

リモートジョブネットを実行するスケジューラーサービスの名称を30バイト以内で指定します。この項目を設定しない場合は，リモートジョブネットの実行を他ホストから依頼されても，実行できません。

"AUTORESTARTCOUNT"=dword:スケジューラーサービスの再起動回数

スケジューラーサービスを構成するプロセスが異常終了した場合に，異常終了したプロセスを自動的に再起動する回数を16進数で指定します。

0～3（10進数で0～3）の間で指定します。

デフォルトは「dword:00000003」（10進数で3）です。

「dword:00000000」を指定した場合，スケジューラーサービスは再起動されません。「dword:00000001」を指定した場合，スケジューラーサービスは1回だけ再起動されます。

"RESTARTCLRTIME"=dword:再起動回数をクリアーするまでの時間

スケジューラーサービスを構成するプロセスが異常終了し，再起動された場合，再起動から再度停止するまでの時間が一定時間を超えたときには，正常動作できたものとみなし，再起動回数をクリアーします。正常動作とみなす稼働時間を16進数で指定します。

B4～15180（10進数で180～86,400）（単位：秒）の間で指定します。

デフォルトは「dword:000000B4」（10進数で180）です。

"MASTERDABEND"="{yes|no}"

一つのスケジューラーサービスが異常終了した場合に，すべてのスケジューラーサービスを停止し，ajsmasterdプロセスを異常終了させるかどうかを指定します。

yes

すべてのスケジューラーサービスが終了し，ajsmasterdプロセスが異常終了します。

この場合，ajsstartコマンドでスケジューラーサービスを再起動できません。JP1/AJS2サービスを再起動して，スケジューラーサービスを起動してください。

no

スケジューラーサービス全体は終了しません。

この場合，ajsstartコマンドでスケジューラーサービスを再起動できます。

デフォルトは「no」です。

jajs_spmdコマンドに-HAオプションを指定して起動したJP1/AJS2サービスに含まれるスケジューラーサービスが異常終了した場合，次の動作になります。

「yes」を指定した場合，jajs_spmdコマンドに-HAオプションを指定して起動したJP1/AJS2サービスは終了します。

「no」を指定した場合，jajs_spmdコマンドに-HAオプションを指定して起動したJP1/AJS2サービスは終了しません。

なお，「yes」を指定した場合でも，環境設定パラメーターAUTORESTARTCOUNTで指定した回数の再起動を行います。指定した再起動回数に達したあとに異常終了した場合，すべてのスケジューラーサービスは終了します。

"TRACELOGFILE"="スケジューラートレースログファイルの名称"

スケジューラーサービスのトレース情報を出力するファイル名を指定します。

このパラメーターを省略した場合，トレース情報は出力されません。このパラメーターは，JP1/AJS2の新規のインストール時および新規のセットアップ時に「/var/opt/jp1ajs2/log/tracelog」が設定されます。

このファイル名を任意のファイル名に変更したい場合は，ファイルの名称をフルパスで，かつ255バイト以内で指定してください。

物理ホストおよびすべての論理ホストのスケジューラートレース情報が，ここで指定したファイルに記録されます。トレース情報を確実に記録できるように，必ずローカルディスク上のファイル名として指定してください。

なお，ファイルは，トレース情報が出力されたときに新規作成されます。したがって，既存のファイル名は指定しないでください。

"EVENTRETRY"="{yes|no}"

イベントサービスへの接続でエラーが発生した場合に，イベントサービスへの再接続を行うかどうかを指定します。

yes

次回のイベント出力時に，イベントサービスへの再接続を行います。

イベントサービスへの再接続に成功すると，JP1イベントを出力します。ただし，エラー発生時のJP1イベントについては，イベントサービスへの再接続を行わないため，出力しません（エラー発生時のイベントはJP1イベントとして登録されません）。

「yes」を指定すると，イベントサービスへの再接続に成功するまでの間，イベント出力ごとにイベントサービスへの接続を試みるため，「no」を指定したときと比べて，ジョブの実行性能が低下するおそれがあります。性能よりもイベントサービスへの再接続を優先させたい場合に「yes」を指定してください。

また，「yes」を指定すると，イベントサービスへの接続エラーが発生するたびにエラーメッセージ（KAVS0863-E）が出力されます。イベントサービスへの接続が長時間回復しないと，大量にログメッセージが出力されることになります。

no

イベントサービス接続エラーが発生したあとは，JP1イベントを出力しません。

JP1/AJS2サービス再起動時に，イベントサービスへの再接続を行います。

デフォルトは「no」です。

"VRSHIFT_IMMINT"="{V5|V6}"

スケジューラーサービスがジョブの実行を抑止している間に，ルートジョブネットを中断，または強制終了したとき，ジョブネットの状態をすぐに変化させるかどうかを（ジョブネットを即時停止するかどうかを）指定します。

V5

ジョブネットの状態をすぐに変化させます。

V6

ジョブの実行抑止解除後に，ジョブネットの状態を変化させます。

デフォルトは「V5」です。

"VRSHIFT_INTRERUN"="{V5|V6}"

中断状態となったネストジョブネットの後続ユニットを再実行するかどうかを指定します。

中断状態となったネストジョブネット配下には，未実行終了のユニットがあります。これらの未実行終了のユニットを実行しないで，中断状態となったネストジョブネットの後続ユニットの実行を優先したい場合は「V5」を指定してください。

なお，このパラメーターは，再実行するユニットの先行に中断状態のネストジョブネットがある場合に有効になります。

再実行するユニットの先行に中断状態のネストジョブネットがなく，異常終了状態のネストジョブネットがある場合は，このパラメーターの設定にかかわらず再実行できます。

V5

中断状態となったネストジョブネットの後続ユニットを再実行します。

V6

中断状態となったネストジョブネットの後続ユニットを再実行しません。

デフォルトは「V6」です。

このパラメーターは，JP1/AJS2の新規のインストール時および新規のセットアップ時に「V5」が設定されます。

"AJSINETDLOGSIZE"=dword:JP1/AJS2 Monitorサービスの内部ログサイズ

JP1/AJS2 Monitorサービスの内部ログのサイズを16進数で指定します。

00000000，00000004～001E8480（10進数で0，4～2,000,000）（単位：キロバイト）の間で指定します。

デフォルトは「dword:00000080」（10進数で128）です。

「dword:00000000」を指定した場合，ログファイルは作成されません。

なお，このパラメーターが設定されていない場合は「dword:00000080」を，設定値に誤りがある場合は，「dword:00000000」を仮定して動作します。

"MONLOG"="{none|all}"

JP1/AJS2 - ViewおよびJP1/AJS2 - Scenario Operationからスケジューラーサービスへの接続開始・終了メッセージをスケジューラーログに出力するかどうかを指定します。

none

JP1/AJS2 - ViewおよびJP1/AJS2 - Scenario Operationからスケジューラーサービスへの接続開始・終了メッセージを出力しません。

all

JP1/AJS2 - ViewおよびJP1/AJS2 - Scenario Operationからスケジューラーサービスへの接続開始・終了メッセージを出力します。

デフォルトは「none」です。

"MONSYSLOG"="{none|all}"

JP1/AJS2 Monitorサービスの開始・終了メッセージ，JP1/AJS2 Monitorサービスの受付処理開始・終了メッセージ，およびモニターサーバの起動・終了メッセージを次のログに出力するかどうかを指定します。

Windowsの場合
Windowsイベントログおよび統合トレースログ

UNIXの場合
syslogおよび統合トレースログ

none

JP1/AJS2 Monitorサービスおよびモニターサーバに関するメッセージを出力しません。

all

JP1/AJS2 Monitorサービスの開始メッセージ（KAVS0530-I），終了メッセージ（KAVS0531-I），JP1/AJS2 Monitorサービスの受付処理開始メッセージ（KAVS0532-I），受付処理終了メッセージ（KAVS0533-I），モニターサーバの起動メッセージ（KAVS0534-I），および終了メッセージ（KAVS0535-I）を出力します。

デフォルトは「none」です。

このパラメーターは，JP1/AJS2の新規のインストール時および新規のセットアップ時に「all」が設定されます。

"AUTHLOG"="{none|all}"

ユーザー認証に関するメッセージをスケジューラーログに出力するかどうかを指定します。

none

ユーザー認証に関するメッセージをスケジューラーログに出力しません。

all

ユーザー認証に関するメッセージをスケジューラーログに出力します。

デフォルトは「none」です。

"AUTHSYSLOG"="{none|all}"

ユーザー認証に関するメッセージを次のログに出力するかどうかを指定します。

Windowsの場合
Windowsイベントログおよび統合トレースログ

UNIXの場合
syslogおよび統合トレースログ

none

ユーザー認証に関するメッセージを出力しません。

all

ユーザー認証に関するメッセージを出力します。

デフォルトは「none」です。

"AJSLOGOUTPUTYEAR"="{yes|no}"

スケジューラーログの日付に「年」を出力するかどうかを設定します。

yes

「年」を出力します。日付には「年月日」が表示されます。

no

「年」を出力しません。日付には「月日」が表示されます。

デフォルトは「no」です。

"AJSLOGOUTPUTEXTEND"="{yes|no}"

スケジューラーログに出力する，ユニットの実行ログや操作ログを出力する場合の出力形式を指定します。

yes

「no」選択時に出力されるメッセージに，操作ユーザー種別などの詳細な情報を追加した形式で出力します。

メッセージに追加される情報を次に示します。

操作ユーザー種別

要求元ホストIPアドレス

要求元識別情報

コマンド操作のオプション

ユニット名

no

操作ユーザー種別などの詳細な情報がない形式で出力します。

デフォルトは「no」です。

このパラメーターを「yes」に設定することで，ユニットの実行や操作時にスケジューラーログに詳細な情報が出力され，操作の正当性を検証することができます。機能および追加される情報の詳細については，マニュアル「JP1/Automatic Job Management System 2 設計・運用ガイド　付録F.1 JP1/AJS2での操作の正当性を検証するための機能」を参照してください。

また，ログが出力される条件および出力されるときに追加される情報は，ログ種別によって異なります。詳細については，マニュアル「JP1/Automatic Job Management System 2 設計・運用ガイド　付録E.1 スケジューラーサービスが出力するログ」を参照してください。

"LOGSIZE"=dword:スケジューラーログファイルのサイズ

スケジューラーログファイルのサイズを16進数で指定します。

0～1E8480（10進数で0～2,000,000）（単位：キロバイト）の間で指定します。デフォルトは「dword:00000000」（10進数で0）です。

このパラメーターは，JP1/AJS2の新規のインストール時および新規のセットアップ時に「dword:00002800」（10進数で10,240）が設定されます。

「dword:00000000」を指定した場合，ログファイルは作成されません。

JP1/AJS2 - Managerをエージェントとして使用するなどスケジューラーログが不要な場合は，「dword:00000000」を指定してスケジューラーログ出力プロセス（ajslogd）を起動しないようにしてください。

スケジューラーログファイルのサイズの見積もり手順については，マニュアル「JP1/Automatic Job Management System 2 設計・運用ガイド　4.4.1 スケジューラーログファイルのサイズを見積もる」を参照してください。

"AJSLOGFILE1"="スケジューラーログファイル1の名称"

ログファイルの名称を255バイト以内で指定します。

ファイル名はフルパスで指定します。

スケジューラーログファイルを使用する場合，このパラメーターは省略できません。このパラメーターは，JP1/AJS2の新規のインストール時および新規のセットアップ時に「/var/opt/jp1ajs2/log/ajs-log1.log」が設定されます。

スケジューラーログファイル2とは異なるファイル名を指定してください。

このログファイルに指定したサイズ以上の情報が書き込まれると，それ以降はログファイル2に情報が書き込まれるようになります。

別の論理ホストに指定したファイル名と重複しない名称を指定してください。

"AJSLOGFILE2"="スケジューラーログファイル2の名称"

ログファイルの名称を255バイト以内で指定します。

ファイル名はフルパスで指定します。

スケジューラーログファイルを使用する場合，このパラメーターは省略できません。このパラメーターは，JP1/AJS2の新規のインストール時および新規のセットアップ時に「/var/opt/jp1ajs2/log/ajs-log2.log」が設定されます。

別の論理ホストに指定したファイル名と重複しない名称を指定してください。

"HIDEOTHERLHOST"="{yes|no}"

論理ホスト対応のJP1/AJS2サービスを構築している環境で，JP1/AJS2 - Viewからログインしたときに表示されるスケジューラーサービスの範囲を指定します。

yes

JP1/AJS2 - Viewからログインするときに指定したホスト名に対応するスケジューラーサービスだけを表示します。

no

ログインしたJP1ユーザーにマッピングされているOSユーザーが，root権限を持つ場合，ログインしたマシンに構築されている定義済みのスケジューラーサービスがすべて表示されます。

それ以外のJP1ユーザーでログインした場合，ログインしたマシンに構築されている定義済みのスケジューラーサービスのうち，ログインしたホストと同一のユーザー認証圏に属するホストのスケジューラーサービスがすべて表示されます。

ただし，ログインした論理ホスト以外のスケジューラーサービスがフェールオーバーして，ログインした物理ホスト上にない場合は，該当するスケジューラーサービスへアクセスしないようにしてください。

デフォルトは「yes」です。

"LOGDLOG"="{none|all}"

スケジューラーログ出力プロセス（Windowsの場合：ajslogd.exe，UNIXの場合：ajslogd）の起動・停止のメッセージをスケジューラーログに出力するかどうかを設定します。

none

スケジューラーログ出力プロセスの起動・停止のメッセージを出力しません。

all

スケジューラーログ出力プロセスの起動・停止のメッセージを出力します。

デフォルトは「none」です。

"LOGDSYSLOG"="{none|all}"

スケジューラーログ出力プロセス（Windowsの場合：ajslogd.exe，UNIXの場合：ajslogd）の起動・停止のメッセージを次のログに出力するかどうかを指定します。

Windowsの場合
Windowsイベントログおよび統合トレースログ

UNIXの場合
syslogおよび統合トレースログ

none

スケジューラーログ出力プロセスの起動・停止メッセージを出力しません。

all

スケジューラーログ出力プロセスの起動・停止メッセージを出力します。

デフォルトは「none」です。

"AUTOSTART"="{yes|no}"

JP1/AJS2 - Manager起動時にスケジューラーサービスを自動起動するかどうかを指定します。

yes

JP1/AJS2 - Manager起動時にスケジューラーサービスを自動起動します。

no

ajsstartコマンドを使ってスケジューラーサービスを起動します。

デフォルトは「yes」です。なお，「no」を指定してもajsmasterdプロセスは起動します。

"SESSIONTIMEOUT"=dword:接続打ち切り時間

JP1/AJS2 - Viewとの通信が途絶えた場合，何分待って接続を打ち切るのかを16進数で指定します。

1～78（10進数で1～120）（単位：分）の間で指定します。

デフォルトは「dword:00000078」（10進数で120）です。

JP1/AJS2 - Viewと最後に通信した時間から，ここで指定した時間が経過しても通信できなかった場合，JP1/AJS2 - Viewに異常があったとみなし，接続を切断します。

"AJSSERVICEID"=dword:スケジューラーサービスの識別番号

スケジューラーサービスの識別番号を16進数で指定します。

1～14（10進数で1～20）の間で指定します。識別番号は，自ホスト内の物理ホストおよびすべての論理ホストで使用している識別番号と重複しない番号を指定してください。

ここで指定した識別番号は，テンポラリーファイルの名称や，プロセス間通信用のキーなど，内部的にスケジューラーサービスを識別するために使われます。そのため，一度指定した識別番号はできるだけ変更しないでください。変更した場合は，スケジューラーサービスをコールドスタートしてください。

"AJSDBTYPE"="{ISAM|EmbedDB}"

使用するデータベース種別を指定します。

ISAM

ISAMはJP1/AJS2 - Manager中に標準提供されています。

EmbedDB

組み込みDBを指定した場合は，JP1/AJS2 - Managerホストに組み込みDBが設定されている必要があります。

デフォルトは「ISAM」です。

"AJSDBDIRECTORY"="データベースディレクトリ名"

JP1/AJS2のユニット情報を格納するディレクトリの名称を191バイト以内で指定します。

ディレクトリ名はフルパスで指定します。なお，「;（セミコロン）」と「空白」は指定しないでください。

このパラメーターは省略できません。

このパラメーターは，JP1/AJS2の新規のインストール時および新規のセットアップ時に「/var/opt/jp1ajs2/database/schedule/AJSROOT1」が設定されます。

スケジューラーサービスを追加した場合，このディレクトリを新たに作成してください。

ジョブネットを定義，実行，および参照するユーザーには，ここで指定したディレクトリとその下にあるファイルに対して，更新権限（rwx）を定義しておいてください。

ここで指定したディレクトリには，ユニットに対して排他編集をする際に必要なファイルや，ISAMのデータファイルやキーファイル（JP1/AJS2データベースにISAMを指定した場合）が保存されます。これらのファイルは削除しないでください。

ここで指定したディレクトリに作成されたファイルに対してシンボリックリンクを作成しないでください。再編成を実施したときに，ファイルが再作成されるため，リンクが切れてしまいます。シンボリックリンクを作成したい場合は，ここで指定したディレクトリに対して作成してください。

ここで指定するディレクトリ先にNFSまたはネットワークドライブを使用しないでください。

"ISAMWRITEMODE"="{flush|noflush|sync}"

ISAMファイルの更新時に，同期書き込みを許可するかどうかを指定します。

flush

書き込み処理を終了するたびに，メモリーにあるバッファーの内容をディスクに書き込みます。

noflush

JP1/AJS2での処理とは同期を取らないで，OSのバッファーリングによってディスクに書き込みます。

sync

ファイル更新時に，常に同期書き込みを実行します。この方法で書き込みを実行した場合，信頼性は向上しますが，性能は低下します。なお，同期書き込みは，ジョブ・ジョブネットの状態管理ファイルに対してだけ行います。ユニット定義情報を保存するファイルに対しては，フラッシュモードで書き込みます。

デフォルトは「flush」です。

"TABLENAMEPREFIX"="テーブル名プリフィックス"

スケジューラーサービスのスキーマ内に保持されるテーブルの名称の先頭に付けられる文字列を4バイト以内の半角英数字で指定します。

テーブル名は，大文字・小文字が区別されず，すべて大文字として扱われます。デフォルトは「AJS」です。

データベースにRDBを使用している場合，既存のデータベーススキーマに，テーブル名が重複しないようにスケジューラーサービスのテーブルを作成できます。

RDBを使用して複数のスケジューラーサービスを同一スキーマ内に作成する場合，それぞれのサービスで異なる名称を指定してください。

"TABLENAMEPOSTFIX"="テーブルID"

スケジューラーサービスのスキーマ内に保持されるテーブルの名称の最後に付けられる文字列を4バイト以内の半角英数字で指定します。

テーブル名は，大文字・小文字が区別されず，すべて大文字として扱われます。この項目を指定しない場合は，文字列は付けられません。

RDBを使用して複数のスケジューラーサービスを同一スキーマ内に作成する場合，このパラメーターに指定した文字列およびテーブル名が重複しないようにしてください。

"RDBAUTHID"="RDB認可識別子"

データベースをセットアップおよび運用する際に使う認可識別子を130バイト以内の半角英数字で指定します。

データベース種別として「"AJSDBTYPE"="EmbedDB"」を指定した場合は，8バイト以内で指定し，必ず設定してください。

データベースの各テーブルは，ここで指定したスキーマ内に作成され，運用されます。

"RDBUSER"="RDBアクセスユーザー名"

データベースにアクセスするときのユーザーの名称を130バイト以内の半角英数字で定義します。

この項目は必ず指定してください。また，RDBAUTHIDパラメーターに指定するRDB認可識別子とは異なる名称を指定してください。

データベース種別として「"AJSDBTYPE"="EmbedDB"」を指定した場合は，8バイト以内で指定し，必ず設定してください。

"RDBPASSWORD"="RDBユーザーパスワード"

データベースにアクセスするときのパスワードを130バイト以内の半角英数字で定義します。

データベース種別として「"AJSDBTYPE"="EmbedDB"」を指定した場合は，30バイト以内で指定します。

組み込みDBの場合，通常，パスワードは大文字・小文字が区別されません。区別したい場合には，パスワード文字列を「!」で囲んでください。

（例）　"RDBPASSWORD"="!password!"

RDBのセキュリティに問題がなければ，この項目の設定を省略できます。この項目を指定しない場合，セットアップ時にシステムがユーザー名に対してパスワードを決めます。ただし，このパスワードを確認する方法はありませんので注意してください。

"RDBCHECKINTERVAL"=dword:RDBサーバ接続確認機能使用有無

データベースサーバが停止したなどの理由でスケジューラーサービスが処理を続行できなくなる場合に備えて，データベースサーバとの接続を確認し，切断を検知したときにスケジューラーサービスを自動的に停止させる機能を使用する場合に指定します。

1～15180（10進数で1～86,400）の範囲内の値を指定した場合だけこの機能が有効となります。この機能を使用する場合には，この範囲内の値を指定してください。

1～15180（10進数で1～86,400）の範囲外の値を指定した場合にはこの機能は無効となり，データベースサーバとの接続確認およびスケジューラーサービスの自動停止は行いません。

デフォルトは「dword:00000000」（10進数で0）です。

このパラメーターは，JP1/AJS2の新規のインストール時および新規のセットアップ時に「dword:0000012C」（10進数で300）が設定されます。

この機能を使用しない場合には，1～15180（10進数で1～86,400）の範囲外の値を指定するか，またはこのパラメーターを省略してください。

"RDBHOST"="RDB接続先ホスト名"

データベースが設定されているホストの名称を511バイト以内で指定します。

通常は自ホスト名を指定します。

"RDBPORT"=dword:RDB接続ポート番号

RDBの接続ポート番号を16進数で指定します。

1～FFFF（10進数で1～65,535）の間で指定します。

データベース種別として「"AJSDBTYPE"="EmbedDB"」を指定した場合，1389～C34F（10進数で5,001～49,999）の間で指定します。

"RDBIPC"="{MEMORY|DEFAULT}"

RDBサーバとの通信方式を指定します。

DEFAULT

組み込みDBサーバとの通信に，TCP/IP通信を使用します。

MEMORY

RDBサーバとの通信に，プロセス間メモリー通信を使用します。

デフォルトは「DEFAULT」です。

"RDBSENDMEMSIZE"=dword:RDBプロセス間メモリー通信使用時の，送信用メモリーサイズ

RDBのプロセス間メモリー通信を使用する際に，送信データを格納するメモリーサイズを16進数で指定します。

指定できる値は任意ですが，JP1/AJS2でRDBのプロセス間メモリー通信を使用する場合は，少なくとも，「dword:00000008」（10進数で8）以上の値を指定してください。

このパラメーターは，RDBの通信方式として「"RDBIPC"="MEMORY"」を指定した場合にだけ有効です。

このパラメーターを省略した場合や，0を指定した場合は，RDBの既定値が使用されます。

"RDBRECVMEMSIZE"=dword:RDBプロセス間メモリー通信使用時の，受信用メモリーサイズ

RDBのプロセス間メモリー通信を使用する際に，受信データを格納するメモリーサイズを16進数で指定します。

指定できる値は任意ですが，JP1/AJS2でRDBのプロセス間メモリー通信を使用する場合は，少なくとも，「dword:00000040」（10進数で64）以上の値を指定してください。

このパラメーターは，RDBの通信方式として「"RDBIPC"="MEMORY"」を指定した場合にだけ有効です。

このパラメーターを省略した場合や，0を指定した場合は，RDBの既定値が使用されます。

"RDBCONNECTWAITTIME"=dword: RDBへの接続の最大待ち合わせ時間

RDBへの接続の最大待ち合わせ時間を指定します。

0～3C（10進数で0～60）（単位：分）の間の値で指定します。

デフォルトは「dword:00000001」（10進数で1）です。

この定義に0を指定した場合は，RDB接続待ち合わせ機能が無効になります。

"AJSCHARCODE"="{C|SJIS|EUC|UTF-8}"

ユニット名称や定義内容で使う文字コードを指定します。

C

7ビットASCII文字コード

SJIS

シフトJISコード

EUC

EUC文字コード

UTF-8

UTF-8文字コード

文字コードは，「C」，「SJIS」，「EUC」，「UTF-8」のどれか一つを必ず指定してください。

なお，JP1/AJS2で業務を定義・実行しているときに文字コードを変更しないでください。JP1/AJS2運用中に文字コードを変更する場合は，ジョブネットをすべて登録解除し，ユニットを退避させてから変更してください。変更後は，JP1/AJS2 - Managerホストを再起動し，ユニットを回復し，ジョブネットを実行登録してください。

"AJSTMPDIR"="テンポラリーファイル用ディレクトリ名"

JP1/AJS2のテンポラリーファイルを作成するディレクトリの名称を191バイト以内で指定します。

ディレクトリ名はフルパスで指定します。また，「;（セミコロン）」と「 （空白）」は指定しないでください。

デフォルトは「/var/opt/jp1ajs2/tmp/schedule」です。

スケジューラーサービスを追加した場合は，このディレクトリを新たに作成してください。ただし，自ホスト内（物理ホストとすべての論理ホスト）に設定されている，ほかのスケジューラーサービスが使用するディレクトリと重複しないようにしてください。また，ほかのスケジューラーサービスが使用するディレクトリの配下にも作成しないでください。

ジョブネットを実行および参照するユーザーには，このディレクトリに対して更新権限（rwx）を定義しておいてください。また，ジョブネットを参照するユーザーには，操作権限（rx）を定義しておいてください。

なお，運用中に障害が発生した場合は，指定したディレクトリ下に作業用のファイルが残ることがあります。

そのため，システム起動時などですべてのJP1/AJS2のサービスが起動していないときにファイルを削除し，ディレクトリを定期的にメンテナンスしてください。

ただし，組み込みDBを使用している場合は，pdで始まるファイル（pderr1.trc，pderr2.trcなど）を削除しないでください。

"JOBINFDIR"="ジョブエラー情報ディレクトリ名"

ジョブ定義時に標準エラー出力ファイルを指定していない場合に，ジョブ実行時に標準エラー出力ファイルを格納するディレクトリの名称を255バイト以内のフルパス名で指定します。

「;（セミコロン）」と「 （空白）」は指定しないでください。

デフォルトは「/var/opt/jp1ajs2/jobinf」です。

スケジューラーサービスを追加した場合は，このディレクトリを新たに作成してください。ただし，自ホスト内（物理ホストとすべての論理ホスト）に設定されている，ほかのスケジューラーサービスが使用するディレクトリと重複しないようにしてください。また，ほかのスケジューラーサービスが使用するディレクトリの配下にも作成しないでください。

ジョブネットを実行および参照するユーザーには，このディレクトリに対して更新権限（rwx）を定義しておいてください。また，ジョブネットを参照するユーザーには，操作権限（rx）を定義しておいてください。

"AJSBKUROOT"="退避情報ディレクトリ名"

ジョブネットワーク要素を退避させるときのディレクトリの名称を191バイト以内で指定します。

ディレクトリ名はフルパスで指定します。また，「;（セミコロン）」と「 （空白）」は指定しないでください。

デフォルトは「/var/opt/jp1ajs2/backup/schedule」です。

スケジューラーサービスを追加した場合は，このディレクトリを新たに作成してください。

ジョブネットを退避するユーザーには，このディレクトリに対して更新権限（rwx）を設定しておいてください。また，ジョブネットを回復するユーザーには，操作権限（rx）を設定しておいてください。

"HNTRLOGLEVEL"="{none|error|warn|info}"

スケジューラーサービスが統合トレースログに出力するメッセージレベルを指定します。

none

どのメッセージも出力しません。

error

エラーメッセージを出力します。

warn

エラーおよび警告メッセージを出力します。

info

エラー，警告および情報メッセージを出力します。

デフォルトは「none」です。

このパラメーターは，JP1/AJS2の新規のインストール時および新規のセットアップ時に「error」が設定されます。

"SYSLOGCODE"="{C|環境変数LANGの値}"

スケジューラーサービスがsyslogファイルに出力するメッセージの言語種別を指定します。

C

英語ASCIIコードで出力します。

環境変数LANGの値（「C」以外の文字列）

スケジューラーサービスを起動したときの環境変数LANGの設定に従います。ただし，スケジューラーサービス起動時の環境変数LANGに対応する言語種別のメッセージがsyslogファイルに出力されないシステムもあります。そのようなシステムでは，このパラメーターには必ず「C」を指定してください。使用しているシステムで日本語出力ができるかどうかは，loggerコマンドなどで日本語メッセージを出力し，syslogファイルに正しく出力されているかどうかで確認してください。

環境変数LANGの値はOSによって異なります。

指定できる環境変数LANGの値を次の表に示します。

表14-2　指定できる環境変数LANGの値

OS
シフトJISを設定する
環境変数の値
EUCを設定する
環境変数の値
UTF-8を設定する
環境変数の値

HP-UX
ja_JP.SJIS
ja_JP.eucJP
使用できません

Solaris
ja_JP.PCK
ja
使用できません

AIX
Ja_JP
ja_JP
使用できません

Linux
使用できません
ja_JP.eucJP
ja_JP.UTF-8

"AJSSYSLOG"="{none|all}"

スケジューラーサービスの起動・終了メッセージをWindowsイベントログまたはsyslogに出力するかどうかを指定します。

none

スケジューラーサービスの起動・終了メッセージを出力しません。

all

スケジューラーサービスの起動メッセージ（KAVS0200-I）と終了メッセージ（KAVS0201-I）を出力します。

デフォルトは「none」です。

"NETSYSLOG"="{none|{abend:warning:hold:startdelay:enddelay:condition:execdeffer:connector}|all}"

ジョブネットの起動・終了メッセージをWindowsイベントログまたはsyslogに出力するかどうかを指定します。

none

ジョブネットの起動・終了に関するメッセージを出力しません。

abend

ジョブネットの異常終了メッセージ（KAVS0262-E）を出力します。

warning

ジョブネットの警告終了メッセージ（KAVS0268-W）を出力します。

hold

ジョブネットの保留通知メッセージ（KAVS0270-I）を出力します。

startdelay

ジョブネットの開始遅延通知メッセージ（KAVS0275-I）を出力します。

enddelay

ジョブネットの終了遅延通知メッセージ（KAVS0276-I）を出力します。

condition

ジョブネットの起動条件監視開始通知メッセージ（KAVS0240-I），および起動条件監視終了通知メッセージ（KAVS0241-I）を出力します。

execdeffer

ジョブネットの繰り越し未実行通知メッセージ（KAVS0279-E）を出力します。

connector

ジョブネットコネクタと接続先のジョブネットとの接続に関するエラーメッセージ（KAVS0243-E，KAVS0244-E，KAVS4700-E～KAVS4708-E，KAVS4711-E～KAVS4716-E，KAVS4730-E～KAVS4733-E）を出力します。

all

ジョブネットの起動・終了に関する，次のメッセージを出力します。

開始（KAVS0260-I）

正常終了（KAVS0261-I）

異常終了（KAVS0262-E）

警告終了（KAVS0268-W）

保留通知（KAVS0270-I）

開始遅延（KAVS0275-I）

終了遅延（KAVS0276-I）

起動条件監視開始・終了（KAVS0240-IおよびKAVS0241-I）

繰り越し未実行（KAVS0279-E）

全登録解除（KAVS0267-I）

ジョブネットコネクタ接続エラー（KAVS0243-E，KAVS0244-E，KAVS4700-E～KAVS4708-E，KAVS4711-E～KAVS4716-E，KAVS4730-E～KAVS4733-E）

デフォルトは「none」です。

なお，「all」以外を指定した場合は，ジョブネットの開始メッセージ・正常終了メッセージは出力されません。

"JOBSYSLOG"="{none|{abend:warning:hold:enddelay}|all}"

ジョブネット中のジョブの開始・終了メッセージを，Windowsイベントログまたはsyslogに出力するかどうかを指定します。

none

ジョブの開始・終了に関するメッセージを出力しません。

abend

ジョブの異常終了メッセージ（KAVS0265-E）を出力します。

warning

ジョブの警告終了メッセージ（KAVS0269-W）を出力します。

hold

ジョブの保留通知メッセージ（KAVS0271-I）を出力します。

enddelay

ジョブの終了遅延通知メッセージ（KAVS0248-I）を出力します。

all

ジョブの開始・終了に関する，次のメッセージを出力します。

開始（KAVS0263-I）

正常終了（KAVS0264-I）

異常終了（KAVS0265-E）

警告終了（KAVS0269-W）

保留通知（KAVS0271-I）

終了遅延（KAVS0248-I）

デフォルトは「none」です。

なお，「all」以外を指定した場合は，ジョブの開始メッセージ・正常終了メッセージは出力されません。

"AJSLOG"="{none|all}"

スケジューラーサービスの起動・終了メッセージをスケジューラーログファイルに出力するかどうかを指定します。

none

スケジューラーサービスの起動・終了メッセージを出力しません。

all

スケジューラーサービスの起動メッセージ（KAVS0200-I）と終了メッセージ（KAVS0201-I）を出力します。

デフォルトは「all」です。

"NETLOG"="{none|{abend:warning:hold:startdelay:enddelay:condition:execdeffer}|all}"

ジョブネットの起動・終了メッセージをスケジューラーログファイルに出力するかどうかを指定します。

none

ジョブネットの起動・終了に関するメッセージを出力しません。

abend

ジョブネットの異常終了メッセージ（KAVS0262-E）を出力します。

warning

ジョブネットの警告終了メッセージ（KAVS0268-W）を出力します。

hold

ジョブネットの保留通知メッセージ（KAVS0270-I）を出力します。

startdelay

ジョブネットの開始遅延通知メッセージ（KAVS0275-I）を出力します。

enddelay

ジョブネットの終了遅延通知メッセージ（KAVS0276-I）を出力します。

condition

ジョブネットの起動条件監視開始通知メッセージ（KAVS0240-I），および起動条件監視終了通知メッセージ（KAVS0241-I）を出力します。

execdeffer

ジョブネットの繰り越し未実行通知メッセージ（KAVS0279-E）を出力します。

all

ジョブネットの開始・終了に関する，次のメッセージを出力します。

開始（KAVS0260-I）

正常終了（KAVS0261-I）

異常終了（KAVS0262-E）

警告終了（KAVS0268-W）

保留通知（KAVS0270-I）

開始遅延通知（KAVS0275-I）

終了遅延通知（KAVS0276-I）

起動条件監視開始通知（KAVS0240-I）

起動条件監視終了通知（KAVS0241-I）

繰り越し未実行通知（KAVS0279-E）

全登録解除（KAVS0267-I）

デフォルトは「all」です。

なお，「all」以外を指定した場合は，ジョブネットの開始メッセージ（KAVS0260-I），正常終了メッセージ（KAVS0261-I），および全登録解除メッセージ（KAVS0267-I）は出力されません。

デフォルトのまま使用している場合，JP1/AJS2 06-71以降からは，ジョブネットの起動条件監視開始・終了通知メッセージ，繰り越し未実行通知メッセージ，および全登録解除メッセージも出力されるようになりますので，注意してください。

"JOBLOG"="{none|{abend:warning:hold:enddelay}|all}"

ジョブネット中のジョブの開始・終了メッセージをスケジューラーログファイルに出力するかどうかを指定します。

none

ジョブの開始・終了に関するメッセージを出力しません。

abend

ジョブの異常終了メッセージ（KAVS0265-E）を出力します。

warning

ジョブの警告終了メッセージ（KAVS0269-W）を出力します。

hold

ジョブの保留通知メッセージ（KAVS0271-I）を出力します。

enddelay

ジョブの終了遅延通知メッセージ（KAVS0248-I）を出力します。

all

イベントジョブの実行要求開始メッセージ（KAVS0242-I），ジョブの開始メッセージ（KAVS0263-I），正常終了メッセージ（KAVS0264-I），異常終了メッセージ（KAVS0265-E），警告終了メッセージ（KAVS0269-W），保留通知メッセージ（KAVS0271-I），サブミット開始メッセージ（KAVS0278-I），ジョブの終了遅延通知メッセージ（KAVS0248-I）を出力します。

デフォルトは「all」です。

なお，「all」以外を指定した場合は，ジョブの開始に関するメッセージ（KAVS0242-I，KAVS0263-I，KAVS0278-I）および正常終了メッセージ（KAVS0264-I）は出力されません。

"OPELOG"="{none|{alter:stop:entry:leave:plan:intrpt:rerun:kill:change:calendar:delete:restore:define:copy:chgst:suspend:import:start:rgimport}|all}"

操作履歴をスケジューラーログファイルに出力するかどうかを指定します。

none

操作履歴を出力しません。

alter

ajsalterコマンドの実行履歴を出力します。

stop

ajsstopコマンドの実行履歴を出力します。

entry

ジョブネットの登録の操作履歴を出力します。

leave

ジョブネットの登録解除の操作履歴を出力します。

plan

ジョブネットの計画一時変更の操作履歴を出力します。

intrpt

ジョブネットの中断の操作履歴を出力します。

rerun

ジョブネットの再実行の操作履歴を出力します。

kill

ジョブの強制終了の操作履歴を出力します。

change

ジョブネットワーク要素の変更の操作履歴を出力します。

calendar

カレンダー情報の変更の操作履歴を出力します。

delete

ジョブネットワーク要素の削除の操作履歴を出力します。

restore

ジョブネットワーク要素の回復の操作履歴を出力します。

define

ジョブネットワーク要素の定義の操作履歴を出力します。

copy

ジョブネットワーク要素の複写および移動の操作履歴を出力します。

chgst

ジョブの状態変更の操作履歴を出力します。

suspend

サスペンド時またはサスペンド解除時の操作履歴を出力します。

import

ジョブネットワーク要素のインポートの操作履歴を出力します。

start

ajsstartコマンドの実行履歴を出力します。

rgimport

登録予定情報のインポートの操作履歴を出力します。

all

すべての操作履歴を出力します。

デフォルトは「all」です。

"LOGINFOALL"="{yes|no}"

スケジューラーログファイルや，Windowsイベントログまたはsyslogに出力するメッセージの出力形式を指定します。

yes

「no」選択時に出力されるメッセージに，実行IDやジョブ番号などの詳細な情報を追加した形式で出力します。

メッセージに追加される情報を次に示します。

ジョブネットやジョブの開始・終了などのログに「実行ID」が追加されます。

ジョブの開始・終了のログに「ジョブ番号」が追加されます。

Windowsイベントログまたはsyslogの，ジョブの開始のログに「ホスト名」が追加されます。ジョブの終了のログには，設定に関係なく「ホスト名」が出力されます。

ジョブの正常終了ログに「戻り値」が追加されます。

no

実行IDやジョブ番号などの情報がない形式で出力します。

デフォルトは「no」です。

このパラメーターは，JP1/AJS2の新規のインストール時および新規のセットアップ時に「yes」が設定されます。

スケジューラーログファイルに出力されるログの詳細については，マニュアル「JP1/Automatic Job Management System 2 設計・運用ガイド　付録E.1 スケジューラーサービスが出力するログ」を参照してください。

"REFLOG"="{none|{backup:export:name:print:schedule:show:rgexport}|all}"

参照履歴をスケジューラーログファイルに出力するかどうかを指定します。

none

参照履歴を出力しません。

backup

ジョブネットワーク要素の退避の参照履歴を出力します。

export

ジョブネットワーク要素のエクスポートの参照履歴を出力します。

name

ジョブネットワーク要素の名称出力の参照履歴を出力します。

print

ジョブネットワーク要素の定義内容出力の参照履歴を出力します。

schedule

ジョブネットの予定情報出力の参照履歴を出力します。

show

ジョブネットワーク要素の状態出力の参照履歴を出力します。

rgexport

登録予定情報のエクスポートの参照履歴を出力します。

all

すべての参照履歴を出力します。

デフォルトは「all」です。

注意

履歴ファイルのサイズ（LOGSIZE）は，07-00以降と06-71以前のデフォルト値が異なります。これは，06-71以前では履歴を出力していなかったコマンドが，07-00以降では操作履歴を出力するように変更されたためです。

補足事項

この値でall，またはbackup，export，name，print，schedule，およびshowのどれか（複数可）を指定し，かつ環境設定パラメーターAJSLOGOUTPUTEXTENDにyesを指定すると，異常終了時の参照履歴を出力できます。

"LOGHEADER"="{none|PID}"

履歴情報にプロセスIDを付加して出力するかどうかを指定します。

none

履歴にプロセスIDを出力しません（06-71までの仕様どおり）

PID

履歴にプロセスIDを出力します

デフォルトは「none」です。

このパラメーターは，JP1/AJS2の新規のインストール時および新規のセットアップ時に「PID」が設定されます。

"INFOLOG"="{none|{START:REQUEST}|all}"

情報用履歴を出力するかどうか指定します。

none

コマンドの実行開始履歴（ログ種別：I001）およびサービス要求履歴（ログ種別：I002）を出力しません

START

コマンドの該当処理開始履歴（ログ種別：I001）を出力します

REQUEST

コマンドからサービスへの処理要求開始履歴（ログ種別：I002）を出力します

all

コマンドの実行開始履歴（ログ種別：I001）およびサービス要求履歴（ログ種別：I002）を出力します

デフォルトは「none」です。

このパラメーターは，JP1/AJS2の新規のインストール時および新規のセットアップ時に「all」が設定されます。

"ROOTJOBNETSCHEDULERANGE"=dword:{00000018|00000030}

ルートジョブネットのスケジュールの有効範囲を指定します。

なお，一度指定した内容を変更する場合，変更前と変更後ではルートジョブネットの実行スケジュールが異なるため，コールドスタートおよびジョブネットのスケジュールを見直す必要があります。

00000018

ルートジョブネットのスケジュールの有効範囲を24時間とします。

00000030

ルートジョブネットのスケジュールの有効範囲を48時間とします。

「dword:00000030」は，JP1/AJS2 - View表示時の状態取得の基にする世代情報の範囲として「"VIEWSTATUSRANGE"="all"」を指定した場合だけ，指定できます。

デフォルトは「dword:00000018」です。

"VIEWSTATUSRANGE"="{today|all}"

JP1/AJS2 - Viewに状態を表示する場合に，状態取得の基にする世代情報の範囲を指定します。

today

基準時刻の範囲で，当日分の世代情報から表示する状態を決定します。

「today」は，ルートジョブネットのスケジュールの有効範囲として「"ROOTJOBNETSCHEDULERANGE"=dword:00000018」（24時間）を指定している場合だけ指定できます。

「"ROOTJOBNETSCHEDULERANGE"=dword:00000030」（48時間）を指定している場合，「today」は指定できません。

all

当日分に限らず，すべての日にちを範囲として，実行中の世代，または予定世代の情報から表示する状態を決定します。

デフォルトは「all」です。

"STARTMODE"="{cold|warm|hot}"

JP1/AJS2サービス起動時に起動されるスケジューラーサービスの起動モードを指定します。

なお，起動モード別のジョブネットおよびジョブの状態については，マニュアル「JP1/Automatic Job Management System 2 設計・運用ガイド　15.4.1(3) 起動モード別のジョブネットおよびジョブの状態」を参照してください。

cold

スケジューラーサービスが前回終了したときの登録状態を解除して，スケジューラーサービスが起動します。

warm

スケジューラーサービスが前回終了したときの登録状態を保持したまま，スケジューラーサービスが起動します。ただし，スケジューラーサービス終了時に実行中だったジョブネットは終了状態になり，スケジューラーサービスを起動した日の予定に従って実行されます。

hot

スケジューラーサービスが前回終了したときの登録状態を保持したまま，スケジューラーサービスが起動します。

デフォルトは「warm」です。

"OVERSCHEDULE"="{exec|skip|plan}"

スケジューラーサービスを起動した日に実行予定があるジョブネットの，スケジューラーサービス起動時に，すでに実行開始予定時刻を過ぎていた場合の実行方法を指定します。なお，スケジューラーサービスの起動モードとして"STARTMODE"="hot"を指定した場合，このオプションおよび実行登録時のオプションに関係なく，すべてのジョブネットが実行されます。

また，スケジューラーサービスをajsstartコマンドで起動した場合，環境設定パラメーターOVERSCHEDULEの値は有効になりません。ajsstartコマンドの動作に従って実行されます。ajsstartコマンドについては，マニュアル「JP1/Automatic Job Management System 2 コマンドリファレンス　1. コマンド　ajsstart」を参照してください。

exec

当日実行予定があるジョブネットを実行します。スケジューラーサービスの起動時より前に実行を予定していたジョブネットは，スケジューラーサービスの起動と同時に開始されます。ただし，次の場合は実行されません。

実行登録時に，JP1/AJS2 - Viewの［実行登録］ダイアログボックスで［デーモン起動時に予定時刻超過］に［次回から実行する］を選択したジョブネットの実行予定時刻が過ぎていたとき。

実行登録時に，ajsentryコマンドに-oオプションを指定したジョブネットの実行予定時刻が過ぎていたとき。

skip

当日実行予定があるジョブネットを実行します。ただし，スケジューラーサービスの起動時より前に実行を予定していたジョブネットは，繰り越し未実行状態になり実行されません。また，次の場合も実行されません。

実行登録時に，JP1/AJS2 - Viewの［実行登録］ダイアログボックスで［デーモン起動時に予定時刻超過］に［すぐに実行する］を選択したジョブネットの実行予定時刻が過ぎていたとき。

実行登録時に，ajsentryコマンドに-oオプションを指定しなかったジョブネットの実行予定時刻が過ぎていたとき。

plan

当日実行予定があるジョブネットは，すべて繰り越し未実行状態になり実行されません。実行登録時のオプションにも関係なく，スケジューラーサービスの起動日に実行予定のあるジョブネットは，すべて実行されません。

デフォルトは「exec」です。

"SUPPRESS"="{none|exec}"

ジョブネット中のジョブおよびジョブネットの実行を抑止するかどうかを指定します。

none

ジョブネットとジョブの実行を抑止しません。

exec

ジョブネットとジョブの実行を抑止します。

デフォルトは「none」です。

"EXECDEFER"="{oneday|twoday|unlimit}"

実行登録したルートジョブネットが開始予定日時を過ぎても実行されなかった場合，いつまで待って繰り越し未実行状態にするのかを指定します。

この項目は，実行登録の方法に関係なく有効です。

oneday

予定日を1日超えた場合，ジョブネットを繰り越し未実行状態にします。

twoday

予定日を2日超えた場合，ジョブネットを繰り越し未実行状態にします。

unlimit

予定日を過ぎた場合，ジョブネットを開始時刻待ちまたは保留中のままとします。

デフォルトは「oneday」です。

即時実行登録の場合は，登録した日時を開始予定日時として扱います。

"JOBSTATUSPORT"="ジョブ状態取得ポートのサービス名"

ジョブ状態の情報を取得するために使用する通信ポートのポート番号を，servicesファイルに定義されているサービスの名称で指定します。デフォルトは「jp1ajs2report」です。

スケジューラーサービスを多重起動する場合は，スケジューラーサービスごとに異なるサービス名を指定し，servicesファイルに重複しないポート番号を設定してください。

"QUEUELESSMULTIREQ"=dword:キューレスジョブリクエスト多重度

キューレスジョブリクエスト多重度は，キューレスジョブを実行するときに，キューレスエージェントと通信するプロセスの多重度です。スケジューラーサービス当たりに起動するキューレスジョブリクエストプロセス（ajsreqd）数を指定します。

キューレスジョブリクエスト多重度を16進数の00000001～00000008（10進数で1～8）の間で指定します。

デフォルトは「dword:00000001」（10進数で1）です。

現状のキューレスジョブシステムでは，キューレスジョブの配送が，性能ネックとなることはありませんので，デフォルトの「dword:00000001」（10進数で1）のまま使用してください。

"MFPOLLINTERVAL"=dword:ポーリング時間

連携するJP1/AJS2 for Mainframeに状態を問い合わせるポーリング間隔を16進数で指定します。

1～5A0（10進数で1～1,440）（単位：秒）の間で指定します。

デフォルトは「dword:0000012C」（10進数で300）です。

"MFUSERNAME"="ユーザー名"

JP1/AJS2 for Mainframeと連携する際に使用するJP1ユーザー名を指定します。デフォルトは"jp1admin"です。

"UNITDEFINERELOAD"="{yes|no}"

実行登録後にジョブおよびジョブネットの定義内容を変更した場合，変更した定義内容を実行直前に再読み込みし，変更内容を即時に有効にするかしないかを選択します。

yes

ジョブおよびジョブネットの実行直前に定義を再読み込みします。

この場合，定義変更時に実行中であった世代についても，変更した最新の定義内容が有効になります。

no

ジョブおよびジョブネットの実行直前に定義を再読み込みしません（JP1/AJS2 06-51以前と同じ動作です）。

この場合，定義変更時に実行中であった世代については，変更した最新の定義内容が有効になりません。

デフォルトは「no」です。

このパラメーターは，JP1/AJS2の新規のインストール時および新規のセットアップ時に「yes」が設定されます。

注意

JP1/AJS2では，実行ファイル名，実行ホスト，保留属性などのユニットの実行に影響するユニット定義情報については実行登録中に変更できます。ただし，定義変更時に実行中であった世代については，変更した最新の定義内容が，有効になるユニット定義情報と，有効にならないユニット定義情報があります。詳細については，マニュアル「JP1/Automatic Job Management System 2 設計・運用ガイド　15.12 実行登録中にユニット定義情報を変更する」を参照してください。

"INHERITCONDHOLD"="{V6|no}"

起動条件付きジョブネットの保留属性の引き継ぎ動作を指定します。

起動条件付きジョブネットを使用する場合，保留動作を制御するために「no」を設定することをお勧めします。

V6

起動条件付きジョブネットを実行登録し，監視中状態となっているジョブネットに対して保留属性変更を行った場合，起動条件待ち状態のジョブネットが，監視中状態ジョブネットの保留属性を引き継ぎます。

ただし，起動条件成立タイミングによっては保留属性が引き継がれないことがあります。

no

起動条件付きジョブネットを実行登録し，監視中状態となっているジョブネットに対して保留属性変更を行った場合，起動条件待ち状態のジョブネットが，監視中状態のジョブネットの保留属性を引き継ぎません。

このため，「V6」の場合とは異なり，起動条件成立タイミングによって，保留属性が引き継がれたり，引き継がれなかったりすることがなくなります。

起動条件が成立した際，起動条件待ち状態のジョブネットを保留したい場合は，保留したい起動条件待ち状態のジョブネットを指定して，保留属性設定を行ってください。

デフォルトは「V6」です。

このパラメーターは，JP1/AJS2の新規のインストール時および新規のセットアップ時に「no」が設定されます。

補足事項

JP1/AJS2 - Viewの保留属性表示機能と実際の動作を一致させるには，"UNITDEFINERELOAD"の値に「yes」を指定し，"INHERITCONDHOLD"の値を「no」に設定します。

その他の値を設定した場合にはJP1/AJS2 - Viewの表示と動作が一致しないことがあります。

"MAXSAVEGEN"=dword:最大保存世代数

最大保存世代数を16進数で指定します。

63～3E7（10進数で99～999）の間で指定します。

デフォルトは「dword:63」（10進数で99）です。

ここに指定した値が，保存世代数として定義可能な値の最大値となります。

注意

指定可能な世代数の最大値を拡張すると，レコード数が増加します。「保存世代数＊ユニット数」で求められるレコード数を少なくするなど，1ルートジョブネット単位の規模が小さくなるように，ジョブネットを分割してから，保存世代数を拡張してください。

保存世代数を100以上に拡張する場合，すべてのJP1/AJS2 - Viewのバージョンを07-00以降にしてください。07-00以降のバージョンのJP1/AJS2 - Viewで保存世代数を100以上に拡張しても，07-00より前のバージョンのJP1/AJS2 - Viewで詳細定義情報を更新してしまうと，保存世代数の上位2けたしか表示されないため，意図しない2けたの値に変更してしまうおそれがあります。

最大保存世代数を拡張したシステムで定義したジョブネット定義情報は，それより小さい値に設定したシステムでは回復できない場合があります。例えば，最大保存世代数を200に設定しているシステムでジョブネットの保存世代数を200に定義した場合，この定義情報をajsprintコマンドで出力し，この出力情報を最大保存世代数が150のシステムでajsdefineコマンドを実行して定義しようとしても，定義パラメーター中に150より大きい値の200が存在するためエラーとなります。

最大保存世代数を拡張し，保存世代数を大きな値で定義したジョブネットを，最大保存世代数を小さくしたあと，JP1/AJS2 - Viewでそのジョブネットの詳細定義ダイアログボックスを開くと，保存世代数は大きな値のまま表示されますが，［OK］ボタンをクリックしてダイアログボックスを閉じようとするとエラーダイアログボックスが表示され，小さくした最大保存世代数までの値に変更するよう要求されます。

最大保存世代数を拡張し，保存世代数を大きな値で定義したジョブネットが登録済みの場合，最大保存世代数を小さくしても，定義した大きい値の保存世代数に従って世代は保存されます。

最大保存世代数に10進数で320を超える値を指定し，保存世代数を最大に定義した場合，未来世代数との関係によって，必ずしも指定した保存世代数分の世代を保存できないことがあります。保存世代数を拡張する場合，確定登録する未来世代数との関係を見積もってから使用するようにしてください。保存世代数と未来世代数との関係については，マニュアル「JP1/Automatic Job Management System 2 設計・運用ガイド　付録D 制限値一覧」を参照してください。

"AJSPRINTNETSCHPRF"="{yes|no}"

スケジュールルールを有効にして上位ジョブネットのスケジュールに依存しないようにするのか，またはスケジュールルールを削除して上位ジョブネットのスケジュールに依存するようにするのかを指定できます。

このオプションは，スケジュールルールを持ったルートジョブネットをネストジョブネットにコピーして作成したジョブネットに対して，ajsprint，ajsbackup，ajsexportコマンド，およびJP1/AJS2 - Viewで「退避」を行った場合に有効です。

yes

スケジュールルールを有効にして上位ジョブネットのスケジュールに依存しません。

no

スケジュールルールを削除して上位ジョブネットのスケジュールに依存します。

デフォルトは「yes」です。

このパラメーターは，JP1/AJS2の新規のインストール時および新規のセットアップ時に「no」が設定されます。

"SUBMITRETRYINTERVAL"=dword:リトライ間隔

同時に多量のジョブが実行されると，ジョブのサブミットは行われるが，実際にはジョブがキューイング状態にならないことがあります（滞留したサブミット）。

このときに，滞留したサブミットを何ミリ秒後にリトライするかをミリ秒単位で指定します。

リトライ間隔には，16進数で00000000～00002710（10進数で10,000）（ミリ秒単位）を指定します。

指定がない場合や設定値に誤りがある場合は，デフォルト値の「dword:00000BB8」（10進数で3,000）が仮定されます。

リトライ間隔に小さな値を指定すると，ジョブのサブミットが滞留している状態では何度もリトライされることになるため，システム負荷が増大しますので注意してください。

"CONDEXECDEFER"="{yes|no}"

保留中になった起動条件待ち世代，または起動条件が次の条件をすべて満たし，複数回成立した場合にあとから成立した世代を「繰り越し未実行」にするかしないかを選択します。

多重起動に「不可能」を設定した起動条件付きジョブネットを実行登録している。

起動条件成立によって実行中の世代があるとき，再び起動条件が成立して実行を開始しようとした起動条件待ち世代が実行中の世代の終了を待っている。

ルートジョブネットに設定された「打ち切り時間」を過ぎている。

yes

あとから成立した世代を「繰り越し未実行」にします。

no

あとから成立した世代を「繰り越し未実行」にせず，実行中の世代の終了を待ちます。

デフォルトは「yes」です。

このパラメーターは，JP1/AJS2の新規のインストール時および新規のセットアップ時に「no」が設定されます。

詳細については，マニュアル「JP1/Automatic Job Management System 2 設計・運用ガイド　8.5.1(2) 起動条件が複数回成立するジョブネットの運用について」を参照してください。

"JOBEXECIPCBUFSIZE"=dword:ジョブ実行情報通信バッファサイズ

スケジューラーサービスのジョブ実行情報通信バッファサイズを16進数で指定します。

00001000～00100000（10進数で4096～1048576）（単位：バイト）の範囲で指定します。

デフォルトは「dword:00000000」です。

ジョブ実行情報通信バッファサイズを指定しない場合は，「dword:00000000」を指定してください。この場合，OSのソケットバッファのデフォルト値で動作します。

なお，このパラメーターが設定されていない場合や設定値に誤りがある場合は，「dword:00000000」を仮定して動作します。

"BACKGROUNDLEAVE"="{yes|no}"

登録解除や保存世代管理による世代削除の処理方式を決定します。

yes

ジョブネットの登録情報の削除を，世代管理サブプロセス（ajsschbd）で処理します。

no

ジョブネットの登録情報の削除を，スケジュール制御プロセス（ajsschd）で処理します。

デフォルトは「no」です。

このパラメーターは，JP1/AJS2の新規のインストール時および新規のセットアップ時に「yes」が設定されます。

「yes」を選択した場合，世代管理サブプロセスがバックグラウンドで登録情報を削除しますので，登録解除操作のターンアラウンドタイムが短縮されます。ただし，「yes」を指定した場合は，世代管理サブプロセスの分だけリソース使用量が増加しますので注意が必要です。

「no」を選択した場合，世代削除処理は削除対象の情報すべてをスケジュール制御プロセス（ajsschd）で削除していきますので，削除対象の世代数やユニット数に比例して登録解除操作のターンアラウンドタイムが増加します。

なお，このパラメーターを変更した場合，JP1/AJS2サービスの再起動が必要です。また，その際には移行ツールによる移行，またはコールドスタートが必要です。

環境設定パラメーターの設定方法については，マニュアル「JP1/Automatic Job Management System 2 設計・運用ガイド　8.1.2 保存世代数に関する注意事項」を参照してください。

"WARMSTARTMSG"="{yes|no}"

スケジューラーサービスをウォームスタートで起動させたときに，実行中であったジョブまたはジョブネットの終了メッセージ，および終了イベントの出力有無を決定します。

yes

終了メッセージ，および終了イベントを出力します。

no

終了メッセージ，および終了イベントを出力しません。

デフォルトは「no」です。

なお，このパラメーターを変更した場合，JP1/AJS2サービスの再起動が必要です。

"MONITORINGINVALIDHOLD"="{yes|no}"

監視中状態の起動条件付きジョブネットに対して，保留属性の設定または解除の操作を行った場合，エラーとするかどうかを選択します。

yes

保留属性の設定または解除の操作をエラー※1にします。

no

保留属性の設定または解除の操作をエラーにしません。

デフォルトは「yes」です。

起動条件成立後，起動条件待ち世代を保留中にしたい場合は，INHERITCONDHOLDパラメーターに「no」を設定した上で，起動条件待ち世代に対して保留属性の設定をしてください。MONITORINGINVALIDHOLDパラメーターとINHERITCONDHOLDパラメーターの組み合わせによっては，起動条件が成立した起動条件待ち世代が保留中にならないことがあります。パラメーターの組み合わせと，起動条件が成立時の動作を次の表に示します。

表14-3　保留属性の設定・解除操作対象世代と操作後の動作

パラメーターの設定 | 保留属性の設定・解除操作対象世代と操作後の動作
MONITORINGINVALIDHOLD | INHERITCONDHOLD | 監視中世代 | 起動条件待ち世代
yes | V6 | ×※1 | △※3
yes | no | ×※1 | ○
no | V6 | △※2 | △※3
no | no | × | ○

（凡例）

○：起動条件成立後，起動条件待ち世代が保留中になる。※4

×：起動条件成立後，起動条件待ち世代が保留中にならない。

△：条件によって起動条件成立後，起動条件待ち世代が保留中になる場合がある。※4

注※1

JP1/AJS2 - Viewからの操作時は「KAVV522-E 指定したジョブまたはジョブネットは実行中です。」が，ajsplanコマンドからの操作時は「KAVS0110-E ジョブネット（ジョブネット名）は実行中です」が出力されます。

注※2

次の条件が重なった場合，起動条件成立時に起動条件待ち世代が保留中になります。

起動条件付きジョブネットの定義で多重起動に「不可能」を設定している

監視中世代に対して，保留属性の設定をする

起動条件が成立して，実行中状態の世代が存在する

再度起動条件が成立する

実行中だった3の世代が終了する

注※3

次の条件が重なった場合，起動条件成立時に起動条件待ち世代が保留中になります。

起動条件付きジョブネットの定義で多重起動に「不可能」を設定している

起動条件が成立して，実行中状態の世代が存在する

起動条件待ち世代に対して，保留属性の設定をする

再度起動条件が成立する

実行中だった3の世代が終了する

注※4

ジョブネットの多重起動を「不可能」に設定している場合で，起動条件成立後，実行中世代の終了を待っている起動条件待ち世代のジョブネットは，実行中の世代が終了したあとに保留中となります。

"REQDAGTREQCONNECTTIMEOUT"=dword:通信タイムアウト時間

キューレスエージェントへの処理要求（ジョブ実行，強制終了，状態確認）時に行う接続処理において，要求元のキューレスジョブリクエストプロセスが通信できるまでどのくらい待つか（タイムアウト時間）を16進数の00000000～00000258（10進数で0～600）（単位：秒）の範囲で指定します。

デフォルトは「dword:0000000F」（10進数で15）です。

「dword:00000000」を指定した場合は，OSのタイムアウト時間に依存して制御されます。

マネージャーホストとエージェントホスト間のネットワークが高速で，エージェントホストが未起動のエラーをすぐに検知したい場合は値を短く，逆にネットワークやシステムが低速であったり，エージェントホストがビジーであったりする環境では長めに設定します。ただし，接続が完了するまたはタイムアウトするまでの間は，他のエージェントホストへの処理要求は行われませんので，値を大きくする場合には注意が必要です。特に問題がないかぎり，デフォルトの15秒での運用をお勧めします。

このパラメーターで指定した時間を待っても通信できない場合，キューレスジョブリクエストプロセスは，メッセージKAVS1930-Wを出力して再接続処理を開始します。再接続処理を開始したら，ほかの正常に通信できるエージェントへの処理要求は通常どおり実行されますが，これ以降の当該エージェントへの処理要求は，障害エージェントへの要求としてマネージャーホスト上で蓄えられ，要求を行った順に一つずつ再接続処理を行います。再接続処理のタイムアウト時間はOSによって異なりますが，最大でも通信回復処理のタイムアウト時間を設定する環境設定パラメーターREQDAGTRECONNECTTIMEOUTに指定した時間で再接続処理を打ち切ります。再接続処理は，60秒間隔で2回行いますが，回復できなかった場合は，処理要求に応じて次に示すエラーメッセージを出力します。

ジョブの実行要求時：KAVS1931-E

ジョブの強制終了要求時：KAVS1932-E

ジョブの状態確認要求時：KAVS1933-E

再接続に成功した場合は，KAVS1929-Iを出力して，蓄えていた要求を順番に再送し障害状態から回復します。

"REQDAGTRECONNECTTIMEOUT"=dword:通信タイムアウト時間

キューレスエージェントへの処理要求（ジョブ実行，強制終了，状態確認）時に通信障害が発生した場合（メッセージKAVS1930-Wが出力される場合）やキューレスエージェントでジョブを実行中にマネージャーホストとエージェントホスト間の通信回線切断を検知した場合（メッセージKAVS1922-Wが出力される場合）に行う再接続処理で，再接続要求元のキューレスジョブリクエストプロセスが通信できるまでどのくらい待つか（タイムアウト時間）を16進数の00000000～00000258（10進数で0～600）（単位：秒）の範囲で指定します。なお，この再接続処理は，ほかのエージェントホストへの処理要求と並行して実行します。

したがって，正常に通信ができるほかのエージェントホストへの要求が，接続の完了，またはタイムアウトするまでの間，待たされることはありません。

デフォルトは「dword:0000005A」（10進数で90）です。

「dword:00000000」を指定した場合は，OSのタイムアウト時間に依存して制御されます。再接続処理の詳細については，接続処理におけるタイムアウト時間を設定する環境設定パラメーターREQDAGTREQCONNECTTIMEOUTの説明を参照してください。

"COMMANDEVENT"="{yes|no}"

コマンドまたはJP1/AJS2 - Viewから操作したときに，JP1イベントを発行するかどうかを指定します。

yes

コマンドまたはJP1/AJS2 - Viewから操作したときに，JP1イベントを発行します。

no

コマンドまたはJP1/AJS2 - Viewから操作したときに，JP1イベントを発行しません。

デフォルトは「no」です。

環境設定パラメーターOPELOG，REFLOG，およびINFOLOGでコマンドの操作履歴をスケジューラーログに出力するように設定している場合，同等の内容をJP1イベントとして発行します。ただし，スケジューラーサービスへの処理要求開始履歴（ログ種別：I002）については，JP1イベントは発行しません。

補足事項

JP1/Performance Management - Agent Option for JP1/AJS2を利用して，JP1/AJS2の操作（JP1/AJS2 - Viewやコマンド）状況を監視している場合は，このパラメーターを「yes」に設定し，OPELOG，REFLOG，およびINFOLOGをすべて「all」に設定してください。

"NONRELOADHOLDING"="{yes|no}"

ジョブネット定義変更の即時反映機能（UNITDEFINERELOAD）を使用している場合，保留中状態のユニット定義の再読み込みをしないようにします。保留中状態のユニット定義を再読み込みすると，ユニット定義の保留を「する」から「しない」に変更したタイミングで保留中状態のユニットが実行されます。

yes

ジョブネット定義変更の即時反映機能（UNITDEFINERELOAD）を使用している場合，保留中状態のユニット定義の再読み込みをしません。

no

ジョブネット定義変更の即時反映機能（UNITDEFINERELOAD）を使用している場合，保留中状態のユニット定義の再読み込みをします。

デフォルトは「no」です。

このパラメーターは，JP1/AJS2の新規のインストール時および新規のセットアップ時に「yes」が設定されます。

「no」を指定した場合，保留中状態のユニット定義の保留を「する」から「しない」に変更すると，次のタイミングで保留中状態のユニットが実行されますので注意してください。

同一スケジューラーサービス上にあるユニットが実行開始または終了したとき

同一スケジューラーサービス上にあるユニットに対して次の操作のどれかを行ったとき
再実行，保留設定，保留解除，サスペンド，サスペンド解除，スケジュールの変更

スケジューラーサービスを再起動したとき

ajsstopコマンドを，-rオプションを指定して実行したとき

また，保留中状態のユニットが多数（環境によりますが200個程度を目安としてください）ある場合，「yes」を指定した場合に比べ，ユニット定義を再読み込みする回数が増えるため，入出力処理が増える点についても注意してください。

保留中状態のユニットに対してユニット定義の保留を「しない」とすることで，保留の解除をするように運用手順を構築していて，運用手順の修正が困難な場合だけ「no」を指定してください。

"RJCUSE"="{yes|no}"

ジョブネットコネクタで異なるスケジューラーサービス間のルートジョブネットの実行順序を制御するかどうかを設定します。

yes

異なるスケジューラーサービス間のルートジョブネットの実行順序を制御する場合に指定します。

no

異なるスケジューラーサービス間のルートジョブネットの実行順序を制御しない場合に指定します。

デフォルトは「no」です。

異なるスケジューラーサービス間のルートジョブネットの実行順序を制御するための設定の詳細については，「14.7.12 ジョブネットコネクタで異なるスケジューラーサービス間のルートジョブネットの実行順序を制御するための設定」を参照してください。

"JOBDELAYWARNMSG"="{yes|no}"

スケジューラーサービスの停止中に，実行所要時間によって終了遅延を監視しているジョブがエージェントで実行開始した場合のメッセージを，スケジューラーサービス起動時に統合トレースログに出力するかどうかを指定します。

yes

メッセージ（KAVS0249-W）を出力します。

ただし，ディザスターリカバリーモードでスタートした場合は，エージェントでのジョブの状態に関係なくジョブが終了状態不明になるため，メッセージは出力されません。

no

メッセージを出力しません。

デフォルトは「no」です。

"FGRECONLMT"=dword:再接続回数

フロー制御プロセスとスケジューラーサービス間通信制御プロセスが通信接続できなかった場合の再接続回数を16進数で指定します。

指定できる範囲は，0～64（10進数で0～100）です。

デフォルトは「dword:00000003」（10進数で3）です。

14.2　ジョブ実行環境の設定

ジョブ実行環境は，マネージャー環境（JP1/AJS2 - Manager）で設定する作業と，エージェント環境（JP1/AJS2 - Agent）で設定する作業があります。

ジョブ実行環境のセットアップに使用する構成定義ファイル（ジョブ実行環境設定ファイル（Queue.conf））には，環境設定に必要な情報が定義されています。情報を変更したい場合は，構成定義ファイルの内容（環境設定パラメーターの定義内容）を書き換えてください。

＜この節の構成＞

14.2.1　ジョブ実行環境の設定手順

14.2.2　マネージャー環境（JP1/AJS2 - Manager）で設定する内容

14.2.3　エージェント環境（JP1/AJS2 - Agent）で設定する内容

14.2.1　ジョブ実行環境の設定手順

ジョブ実行環境のセットアップに使用する構成定義ファイル（ジョブ実行環境設定ファイル（Queue.conf））には，環境設定に必要な情報が定義されています。情報を変更したい場合は，構成定義ファイルの内容（環境設定パラメーターの定義内容）を書き換えてください。

この項では，構成定義ファイルの内容（環境設定パラメーターの定義内容）を変更する手順を説明します。

なお，ジョブ実行環境設定ファイル（Queue.conf）の内容については，「14.2.2 マネージャー環境（JP1/AJS2 - Manager）で設定する内容」または「14.2.3 エージェント環境（JP1/AJS2 - Agent）で設定する内容」を参照してください。

＜この項の構成＞

(1)　初期状態の構成定義情報を変更する場合の手順

(2)　設定済みの構成定義情報を利用して変更する場合の手順

(3)　ジョブ実行環境の構成定義情報を一括で変更する場合の手順

(4)　運用中にジョブ実行環境の構成定義情報を変更する場合の手順

(1)　初期状態の構成定義情報を変更する場合の手順

構成定義ファイルは，初期状態では推奨値で定義されています。初期状態の登録情報の変更手順を次に示します。

次のファイルをエディターで開く。

/etc/opt/jp1ajs2/conf/Queue.conf

必要に応じて，ジョブの実行環境を変更する。
デフォルトでは，実行ホスト（エージェント）が一つ，ローカルホストに作成されます。しかし，システムによっては，ジョブの実行環境を変更する必要があります。例として次の場合があります。

実行ホストが複数台ある場合

他システム（JP1/NQSEXECやJP1/OJEなど）と連携する場合

ジョブを複数の実行ホストで分散実行する場合

特定ジョブ同士を排他実行する場合

このような運用をする場合は，新たに実行ホスト（エージェント），キューまたは排他実行リソースを定義する必要があります。

編集した構成定義ファイルを保存する。

次のコマンドを実行する。

jbssetcnf 設定ファイル名

jbssetcnfコマンドのパスは，「/opt/jp1base/bin/jbssetcnf」です。
jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/AJS2を再起動する。
設定ファイルの内容が構成定義に反映されます。

(2)　設定済みの構成定義情報を利用して変更する場合の手順

定義情報ファイルは，現在設定されている登録情報から作成することもできます。現在設定されている登録情報の変更手順を次に示します。

次のコマンドを実行する。

jbsgetcnf [-h 論理ホスト名] > 退避ファイル名

jbsgetcnfコマンドのパスは，「/opt/jp1base/bin/jbsgetcnf」です。
jbsgetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。
現在設定されている定義情報が退避ファイルに退避されます。

手順1で取得した退避ファイルをviなどのエディターで開く。

構成定義パラメーターを変更または追加し，保存する。

次のコマンドを実行する。

jbssetcnf 退避ファイル名

jbssetcnfコマンドのパスは，「/opt/jp1base/bin/jbssetcnf」です。
jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/AJS2を再起動する。
変更した退避ファイルの内容が登録されます。

(3)　ジョブ実行環境の構成定義情報を一括で変更する場合の手順

ここでは，jpqimportコマンドを使用して，ジョブの実行環境を一括で定義する方法を説明します。次に示す手順で，ジョブ実行環境のデータベースを再作成してください。

ジョブ実行環境構成定義ファイル（jpqsetup.conf）をviなどのエディターで開き，使用するキューとエージェントを設定する。
ジョブ実行環境構成定義ファイルのパスは，/etc/opt/jp1ajs2/conf/jpqsetup.confです。
ファイルに書き込む内容の詳細については，「20. セットアップ時に使用するコマンド　jpqimport」を参照してください。
ファイルの記述例を次に示します。

図14-1　ジョブ実行環境構成定義ファイルの記述例

編集した構成定義ファイルを保存する。

ジョブ実行環境のデータベースディレクトリにあるファイルをすべて削除する。
JP1/AJS2デーモンを停止してから，ファイルを削除してください。
ジョブ実行環境のデータベースディレクトリは，ジョブ実行環境設定ファイル（Queue.conf）の[{JPLDEFAULT|論理ホスト名}¥JP1NBQMANAGER¥Database]のDatabasePathパラメーターに指定したディレクトリです。物理ホストでは，/var/opt/jp1ajs2/database/queueです。

(4)　運用中にジョブ実行環境の構成定義情報を変更する場合の手順

jpqagtadd，jpqqueaddなどのコマンドを使用して，JP1/AJS2の運用中にエージェントやキューなどを追加，削除，または変更できます。運用中に，ジョブ実行環境に構成定義情報を追加する場合は，jpqagtadd，jpqqueadd，jpqresaddなどのコマンドを使用してください。また，運用中にジョブ実行環境の構成定義情報を変更する場合は，jpqagtalt，jpqquealtなどのコマンドを使用してください。各コマンドの詳細については，マニュアル「JP1/Automatic Job Management System 2 コマンドリファレンス　1. コマンド」を参照してください。

jpqagtaddコマンドで実行ホスト（エージェント）を追加する手順を次に示します。

エージェントを追加し，ジョブ実行多重度を設定する。
追加するエージェントのホスト名はIPアドレス解決できることを確認しておく必要があります。ジョブ実行多重度を省略すると，24時間，実行多重度は0が仮定されます。ジョブ実行多重度が0の場合，ジョブは実行できません。ジョブを実行する場合は1以上を指定するか，jpqagtaltコマンドでジョブ実行多重度を変更してください。ジョブ実行多重度の指定例については，マニュアル「JP1/Automatic Job Management System 2 コマンドリファレンス　1. コマンド　jpqagtalt」の補足事項も参照してください。

jpqagtadd -ah エージェント名 -cp ジョブ実行多重度の設定

デフォルトキューの受付口を開く。
エージェントを作成すると同時に同名のデフォルトキューが作成されます。jpqagtaddコマンドでエージェントを追加した直後は，キューの受付口が閉じているのでジョブを登録できません。jpqqueopenコマンドを使用してキューの受付口を開いてください。

jpqqueopen -ah エージェント名 -en

デフォルトキューのジョブ数の最大値および警告値を変更する。
ジョブ数の最大値および警告値は，デフォルトで最大値（4,294,967,295）が設定されています。特に制限する必要がない場合，変更する必要はありません。

jpqquealt -ah エージェント名 -mj ジョブ数の最大値 -wj ジョブ数の警告値

接続するエージェントを追加したり，接続先エージェントの優先順位を設定したりする。
jpqagtaddコマンドで追加したエージェントは，デフォルトキューと接続されています。このデフォルトキューにエージェントを複数台接続して，ジョブの実行を分散させる場合などに変更してください。優先順位を指定して複数のエージェントを接続すると，指定された優先順位に従ってエージェントへジョブを配信します。

jpqagtlink -ah エージェント名 -lh エージェント名 -clp 接続先エージェントの優先順位

設定内容を確認する。
jpqagtshowコマンド，jpqqueshowコマンドを実行して，手順1～4の設定内容が正しいことを確認してください。

jpqagtshow -ah エージェント名

jpqqueshow -ah エージェント名

14.2.2　マネージャー環境（JP1/AJS2 - Manager）で設定する内容

この項では，マネージャー環境（JP1/AJS2 - Manager）で設定するジョブ実行環境設定ファイル（Queue.conf）の内容について説明します。

各パラメーターの推奨値と設定が有効になる時期については，マニュアル「JP1/Automatic Job Management System 2 設計・運用ガイド　5.3.2 ジョブ実行環境に関する環境設定について検討する」を参照してください。

＜この項の構成＞

(1)　ジョブ実行環境設定ファイル（JP1/AJS2 - Manager）の環境設定パラメーター一覧

(2)　ジョブ実行環境設定ファイル（JP1/AJS2 - Manager）の環境設定パラメーターの定義内容

(3)　ジョブ実行環境のリソースを制限する場合の注意事項

(1)　ジョブ実行環境設定ファイル（JP1/AJS2 - Manager）の環境設定パラメーター一覧

ジョブ実行環境設定ファイルで定義する環境設定パラメーターの一覧を次の表に示します。

表14-4　環境設定パラメーター一覧（Queue.conf・JP1/AJS2 - Manager）

定義キー | 環境設定パラメーター | 定義内容
[{JP1_DEFAULT|論理ホスト名}¥JP1NBQMANAGER¥Process]※1 | "WorkPath"= | マネージャープロセス実行時のワークディレクトリ名
"IsHA"= | マネージャープロセスのクラスタ環境設定の定義
[{JP1_DEFAULT|論理ホスト名}¥JP1NBQMANAGER¥Database]※1 | "DatabasePath"= | データベース格納ディレクトリ名
"PreserveTerm"= | ジョブ情報の保存日数
"StandardTime"= | ジョブ情報削除の基準時刻
"FlashOption"= | データファイル更新モード
"DeleteFlashOption"= | ジョブ情報削除処理非同期オプション
"PreserveMinute"= | ジョブ情報保存日数0日指定時のジョブ情報の保存時間
"StartUpDelete"= | JP1/AJS2サービス起動時のジョブ情報削除処理抑止オプション
"ColdStartMode"= | JP1/AJS2サービスのコールドスタート時のデータベース初期化
[{JP1_DEFAULT|論理ホスト名}¥JP1NBQMANAGER¥Queue]※1 | "MaximumQueue"= | キューの最大定義数
[{JP1_DEFAULT|論理ホスト名}¥JP1NBQMANAGER¥Job]※1 | "MaximumContentJob"= | システム内の最大ジョブ数
"AlartContentJob"= | システム内の警告ジョブ数
"ReceiveFileSizeStatus"= | ファイルサイズが上限値に達したときの動作
"LimitReceiveFileSize"= | ファイルサイズの上限値
"ReceiveFileOption"= | ジョブ結果ファイルの二重受信防止の定義
"QueuingJobRecoveryTime"= | キューイング中のジョブに対するエージェントの障害回復待ち時間
"ExecutingJobRecoveryTime"= | 実行中のジョブに対するエージェントの障害回復待ち時間
"MaximumExecJobLogOption"= | ジョブ実行多重度到達を確認するメッセージを出力する設定
"MaximumExecJobLogInterval"= | ジョブ実行多重度到達を確認するメッセージを出力する間隔
"PreventChangeJobOrder"= | サブミットジョブの実行順序の入れ替わりを防止する設定
"EnumJobSaveMemory"= | ジョブ情報列挙時にジョブ実行制御マネージャーのメモリー消費量を少なくする設定
[{JP1_DEFAULT|論理ホスト名}¥JP1NBQMANAGER¥Network]※1 | "ConnectTimeout"=※2 | ジョブ実行制御マネージャーのTCP/IP通信接続タイムアウト値の定義
"CommunicateRetryCount"=※2 | ジョブ実行制御マネージャーのTCP/IP通信接続エラーのリトライ回数の定義
"CommunicateRetryInterval"=※2 | ジョブ実行制御マネージャーのTCP/IP通信接続エラーのリトライ間隔の定義
[{JP1_DEFAULT|論理ホスト名}¥JP1NBQMANAGER¥Agent]※1 | "MaximumAgent"= | エージェントの最大定義数
"ObserveInterval"= | エージェント監視インターバル
"AutoCreate"= | ジョブサブミット時のエージェント自動定義の制御フラグ
"AutoCreateExecJobs"= | エージェント自動定義時のジョブの実行多重度
"AutoCreateMaxJobs"= | エージェント自動定義時のジョブ数の最大値
"AutoCreateWarnJobs"= | エージェント自動定義時のジョブ数の警告値
"AutoCreatePriority"= | エージェント自動定義時のエージェント優先順位
"LeastRecentlyUsed"= | ジョブを配信するエージェントホストの決定方式の定義
[{JP1_DEFAULT|論理ホスト名}¥JP1NBQMANAGER¥Resource]※1 | "MaximumResource"= | 排他実行リソースの最大定義数
[{JP1_DEFAULT|論理ホスト名}¥JP1NBQAGENT¥Process]※1 | "WorkPath"= | エージェントプロセス実行時のワークディレクトリ名
"IsHA"= | エージェントプロセスのクラスタ環境設定の定義
[{JP1_DEFAULT|論理ホスト名}¥JP1NBQAGENT¥Job]※1 | "IsLimitCoreSize"= | プロセスごとの最大コアファイルサイズの制限フラグ
"LimitCoreSize"= | プロセスごとの最大コアファイルサイズ
"IsLimitDataSize"= | プロセスごとの最大データセグメントサイズの制限フラグ
"LimitDataSize"= | プロセスごとの最大データセグメントサイズ
"IsLimitFileSize"= | プロセスごとの最大パーマネントファイルサイズの制限フラグ
"LimitFileSize"= | プロセスごとの最大パーマネントファイルサイズ
"IsLimitMemorySize"= | プロセスごとの最大メモリーサイズの制限フラグ
"LimitMemorySize"= | プロセスごとの最大メモリーサイズ
"IsLimitStackSize"= | プロセスごとの最大スタックセグメントサイズの制限フラグ
"LimitStackSize"= | プロセスごとの最大スタックセグメントサイズ
"IsLimitCpuTime"= | プロセスごとの最大CPU時間の制限フラグ
"LimitCpuTime"= | プロセスごとの最大CPU時間
"IsLimitWorkSize"= | プロセスごとの最大ワーキングセットサイズの制限フラグ
"LimitWorkSize"= | プロセスごとの最大ワーキングセットサイズ
"IsLimitNoFile"= | プロセスごとの最大ファイルディスクリプタ数の制限フラグ
"LimitNoFile"= | プロセスごとの最大ファイルディスクリプタ数
"PipeComTimeout"= | エージェントのパイプ通信タイムアウト値の定義
"AfterForkPipeTimeout"= | ジョブプロセス実行準備完了通知時のタイムアウト値の定義
"IsCacheCmdSearchPath"= | コマンド検索パスの値のキャッシング指定フラグ
"IsUseWorkPath"= | ジョブ実行時のワーク（カレント）パスの変更フラグ
"IsSigchldDefault"= | JP1/AJS2から起動される子プロセスを，SIGCHLDシグナルを受信する設定（SIG_DFL）に変更する定義
"FileAccessPermissionMode"=※3 | UNIXジョブ実行時のファイルのアクセス権限をチェックする方法の設定
"GetPasswd_RetryCount"= | OSのパスワードファイルからユーザー情報の取得に失敗した場合にリトライする回数
"GetPasswd_RetryInterval"= | OSのパスワードファイルからユーザー情報の取得に失敗した場合にリトライする間隔
[{JP1_DEFAULT|論理ホスト名}¥JP1NBQAGENT¥Network]※1 | "NotfyJobStateInterval"= | ジョブの結果ファイルの再送間隔
"NotfyJobStateCount"= | ジョブの結果ファイルの再送回数
"ConnectTimeout"=※2 | ジョブ実行制御エージェントのTCP/IP通信接続タイムアウト値の定義
"CommunicateRetryCount"=※2 | ジョブ実行制御エージェントのTCP/IP通信接続エラーのリトライ回数の定義
"CommunicateRetryInterval"=※2 | ジョブ実行制御エージェントのTCP/IP通信接続エラーのリトライ間隔の定義
[{JP1_DEFAULT|論理ホスト名}¥JP1NBQAGENT¥Variable]※1 | "変数名"=※4 | 変数名に対応した実行プログラムの，そのホストでのインストールディレクトリ
[{JP1_DEFAULT|論理ホスト名}¥JP1NBQCLIENT¥PathEnv]※1 | "All Users"=※5 | 転送元ファイルの検索パス
"JP1ユーザー名"=※5 | 転送元ファイルの検索パス
[{JP1_DEFAULT|論理ホスト名}¥JP1NBQCLIENT¥Network]※1 | "ConnectTimeout"=※2 | ジョブ実行に使用するコマンドおよびスケジュール制御のTCP/IP通信接続タイムアウト値の定義
"CommunicateRetryCount"=※2 | ジョブ実行に使用するコマンドおよびスケジュール制御のTCP/IP通信接続エラーのリトライ回数の定義
"CommunicateRetryInterval"=※2 | ジョブ実行に使用するコマンドおよびスケジュール制御のTCP/IP通信接続エラーのリトライ間隔の定義
"CommunicateTimeout"= | ジョブ実行制御のマネージャープロセスに対する通信タイムアウト時間
[{JP1_DEFAULT|論理ホスト名}¥JP1NBQCLIENT¥Process]※1 | "MacroOptionReplaceMode"= | マクロ変数の引き継ぎ情報がNULL文字列の場合の置き換え方法の設定
"IsHA"= | ジョブ実行に使用するコマンドおよびスケジュール制御のクラスタ環境設定の定義
[{JP1_DEFAULT|論理ホスト名}¥JP1NBQNOTIFY¥Network]※1 | "ConnectTimeout"=※2 | ジョブ実行制御状態通知プロセスのTCP/IP通信接続タイムアウト値の定義
"CommunicateRetryCount"=※2 | ジョブ実行制御状態通知プロセスのTCP/IP通信接続エラーのリトライ回数の定義
"CommunicateRetryInterval"=※2 | ジョブ実行制御状態通知プロセスのTCP/IP通信接続エラーのリトライ間隔の定義
[{JP1_DEFAULT|論理ホスト名}¥JP1NBQNOTIFY¥Process]※1 | "IsHA"= | ジョブ実行制御状態通知プロセスのクラスタ環境設定の定義

注※1

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

注※2

定義内容の詳細については，「16.17 TCP/IP通信接続エラーのリトライ間隔・回数の変更」を参照してください。

注※3

定義内容の詳細については，「16.32 ジョブ実行時のファイル権限チェックでアクセス制御リストやセカンダリーグループの設定を有効にする」を参照してください。

注※4

定義内容の詳細については，「16.1 ジョブ実行時のワークパスを変数として定義する」を参照してください。

注※5

定義内容の詳細については，「16.2 転送元ファイルの検索パスを定義する」を参照してください。

(2)　ジョブ実行環境設定ファイル（JP1/AJS2 - Manager）の環境設定パラメーターの定義内容

環境設定パラメーターの定義内容の詳細を次に示します。

なお，環境設定パラメーターのデフォルトは，環境設定パラメーターを省略した場合の仮定値です。

また，詳細の記載がないパラメーターは保守用のパラメーターです。値は変更しないでください。

"WorkPath"="マネージャープロセス実行時のワークディレクトリ名"

ジョブ実行管理用のワークディレクトリの名称を180バイト以内で指定します。

ディレクトリ名はフルパスで指定します。

デフォルトは「/var/opt/jp1ajs2/tmp」です。

"IsHA"=dword:マネージャープロセスのクラスタ環境設定の定義

ジョブ実行制御マネージャープロセスのクラスタ環境設定の定義を指定します。このパラメーターは，クラスタ運用をやめる場合だけ設定してください。

00000000

クラスタ運用しない場合に指定します。

00000001

クラスタ運用する場合に指定します。クラスタシステム運用時のセットアップを実行すると，この値が自動的に設定されます。

デフォルトは「00000000（クラスタ運用しない）」です。

"DatabasePath"="データベース格納ディレクトリ名"

ジョブ実行環境情報やジョブ情報が書き込まれる，ISAMファイルを格納するディレクトリの名称を180バイト以内で指定します。

ディレクトリ名はフルパスで指定します。

デフォルトは「/var/opt/jp1ajs2/database/queue」です。

ここで指定したディレクトリに作成されたファイルに対してシンボリックリンクを作成しないでください。再編成を実施したときに，ファイルが再作成されるため，リンクが切れてしまいます。シンボリックリンクを作成したい場合は，ここで指定したディレクトリに対して作成してください。

ここで指定するディレクトリ先にNFSまたはネットワークドライブを使用しないでください。

"PreserveTerm"=dword:ジョブ情報の保存日数

ジョブの実行結果情報を何日前のものまで保存しておくのかを16進数で指定します。

0～3E7（10進数で0～999）（単位：日）の間で指定します。

ジョブ情報の保存日数は，ジョブ情報の件数が20万件を超えないように設定してください。例えば，1日当たりのジョブ件数が2万件の場合は，保存日数を10日以内に設定してください。

デフォルトは「dword:00000007」（7日）です。

このパラメーターは，JP1/AJS2の新規のインストール時および新規のセットアップ時に「dword:00000001」が設定されます。

「dword:00000000」（0日）を指定した場合，実行結果情報はジョブの実行終了時に削除されます。

ジョブ情報の保存日数を0日とした場合の，保存時間の設定方法については，マニュアル「JP1/Automatic Job Management System 2 設計・運用ガイド　8.1.7(2) ジョブ情報の保存日数を0日にした場合の効果およびジョブ情報の保存時間の設定」も参照してください。

なお，この指定で対象となるジョブにイベントジョブは含まれません。

注意事項

ジョブ情報保存日数は，ジョブ実行環境データベースに格納されたジョブ情報を保存する日数です。この指定で保存日数の値を小さくしても，スケジューラーデータベースが管理するジョブネットの世代保存数には影響しません。

また，ジョブ情報保存日数の値を小さく変更したあと，次のジョブ情報削除基準時刻またはJP1/AJS2サービス再起動時に，削除対象のジョブ情報が大量にあると，ジョブ情報の削除処理と競合してジョブの実行性能が低下したり，システムへの負荷が高くなったりすることがあります。

ジョブの実行数が少ない時間帯に変更したり，段階的に保存日数の値を小さくしたりするなど，設定の変更には十分に注意してください。

"StandardTime"=dword:ジョブ情報削除の基準時刻

ジョブ実行結果情報を削除する時刻を16進数で指定します。

時刻は，0:00～23:59の間で，0:00を基準とした相対時刻（単位：分）を指定します。例えば，1:00に設定する場合は，「dword:0000003c」（1:00=60分）と指定します。

デフォルトは「dword:00000000」（0:00）です。

ただし，JP1/AJS2サービス起動時にもジョブの実行結果情報が削除されます。その際，サービス起動時刻を基準時刻として，保存日数以前のジョブ実行結果情報が削除されます。その後は，この設定値の時刻にジョブの実行結果情報を削除するようになります。

なお，この指定で対象となるジョブにイベントジョブは含まれません。

"FlashOption"=dword:データファイル更新モード

ISAMファイルの更新時に，同期書き込みを許可するかどうかを指定します。

00000000

JP1/AJS2の処理とは同期を取らないで，OSのバッファーリングによってディスクに書き込みます。

00000001

ファイル更新時に，常に同期書き込みを実行します。この方法で書き込みを実行した場合，信頼性は向上しますが，性能は低下します。

デフォルトは「dword:00000001」（同期方式）です。

"DeleteFlashOption"=dword:ジョブ情報削除処理非同期オプション

ジョブ情報の削除処理について非同期で実行するかどうかを指定します。

0

ジョブ情報の削除を非同期で実行します。

1

ジョブ情報の削除を同期して実行します。

デフォルトは「1」です。

このパラメーターには，JP1/AJS2の新規のインストール時および新規のセットアップ時に「0」が設定されます。

ジョブ情報の削除処理の詳細については，マニュアル「JP1/Automatic Job Management System 2 設計・運用ガイド　8.1.7 ジョブ情報削除処理の注意事項」を参照してください。

"PreserveMinute"=dword:ジョブ情報保存日数0日指定時のジョブ情報の保存時間

ジョブ情報の保存日数を0日にした場合に，ジョブが終了してから削除するまでの保存時間を16進数で指定します。

0000000A～000005A0（10進数で10～1,440）（単位：分）の間で指定します。

デフォルトは「dword:0000000A」（10進数で10）です。

ジョブ情報の削除処理の詳細については，マニュアル「JP1/Automatic Job Management System 2 設計・運用ガイド　8.1.7 ジョブ情報削除処理の注意事項」を参照してください。

"StartUpDelete"=dword:JP1/AJS2サービス起動時のジョブ情報削除処理抑止オプション

ジョブ情報の保存日数を1日以上設定している場合に，JP1/AJS2サービス起動時にジョブ情報の削除処理を抑止するかどうかを指定します。

0

JP1/AJS2サービス起動時に，ジョブ情報削除の基準時刻を基点として保存日数を超えているジョブ情報をジョブ情報削除処理で削除します。

JP1/AJS2サービス起動時，ジョブ情報削除の基準時刻からJP1/AJS2サービス起動時刻までの間に保存日数を超えたジョブ情報については削除しません。

前回のジョブ情報削除の基準時刻にJP1/AJS2サービスが停止していてジョブ情報削除処理が実施されなかった場合に，ジョブ情報削除の基準時刻を基点として保存日数を超えているジョブ情報が残っていることがあります。その場合は，JP1/AJS2サービス起動時に，これらのジョブ情報だけを削除します。

1

JP1/AJS2サービス起動時に，JP1/AJS2サービス起動時刻を基点として保存日数を超えているジョブ情報をジョブ情報削除処理で削除します。

JP1/AJS2サービス起動時，ジョブ情報削除の基準時刻からJP1/AJS2サービス起動時刻までの間に保存日数を超えたジョブ情報がある場合，これらのジョブ情報を削除します。

前回のジョブ情報削除の基準時刻にJP1/AJS2サービスが停止していてジョブ情報削除処理が実施されなかった場合に，ジョブ情報削除の基準時刻を基点として保存日数を超えているジョブ情報が残っていることがあります。その場合は，JP1/AJS2サービス起動時に，これらのジョブ情報も削除します。

2

JP1/AJS2サービス起動時のジョブ情報削除処理を抑止します。

ただし，ジョブ情報削除の基準時刻にJP1/AJS2サービスを停止する運用の場合，JP1/AJS2サービス起動時にジョブ情報削除処理が実行されないとジョブ情報が削除されなくなるため，ジョブ実行環境データベースのディスク占有量が増加します。そのため，運用される環境を十分検討した上で使用してください。

デフォルトは「1」です。

このパラメーターは，JP1/AJS2の新規のインストール時および新規のセットアップ時に「0」が設定されます。

ジョブ情報の削除処理の詳細については「16.23.3 JP1/AJS2起動時にジョブ情報削除処理を抑止する設定」，またはマニュアル「JP1/Automatic Job Management System 2 設計・運用ガイド　8.1.7 ジョブ情報削除処理の注意事項」を参照してください。

"ColdStartMode"="{clear|noclear}"

JP1/AJS2サービスのコールドスタート時に，ジョブ実行環境データベースのジョブ情報を初期化するかどうかを指定します。

clear

JP1/AJS2サービスのコールドスタート時に，ジョブ実行環境データベースのジョブ情報を初期化します。ただし，自動起動しない設定のスケジューラーサービスが存在する場合は初期化しません。

noclear

JP1/AJS2サービスのコールドスタート時に，ジョブ実行環境データベースのジョブ情報を初期化しません。06-71以前の初期化しない動作にあわせたい場合に指定します。

デフォルトは「clear」です。

"MaximumQueue"=dword:キューの最大定義数

キューを定義できる最大数を16進数で指定します。

1～2000（10進数で1～8,192）の間で指定します。

デフォルトは「dword:00000096」（10進数で150）です。

JP1/AJS2 サービス起動時に，ここで設定した値分のキュー情報領域がメモリーに確保されます。

注意

1台のマネージャーで使用できるキューの最大数は，エージェントで使用するデフォルトキューの数を含みます。MaximumAgentパラメーターに指定するエージェントの最大定義数がデフォルトキューの最大値となるので，MaximumQueueパラメーターには，MaximumAgentパラメーターに指定する値よりも大きい値を指定してください。

ここで指定するキューの最大定義数と，1台のマネージャーで使用できるキューの最大数は次のような関係です。

MaximumQueueパラメーターに指定する値（MaximumAgentパラメーターに指定する値よりも大きい値）=1台のマネージャーで使用できるキューの最大数

ただし，Windowsホストでキューの最大定義数を指定する場合，［マネージャー環境設定］ダイアログボックスの［ジョブ実行環境］タブの［キューの最大定義数］では，デフォルトキューの数を除いた値を指定してください。

キューの最大定義数の指定方法は，Windowsホストの場合とUNIXホストの場合とで異なるので，注意してください。

"MaximumContentJob"=dword:システム内の最大ジョブ数

システム内の作業領域上に保持できる最大ジョブ数を16進数で指定します。

1～14000（10進数で1～81,920）の間で指定します。

デフォルトは「dword:000007D0」（10進数で2,000）です。

JP1/AJS2サービス起動時に，ここで設定した値分のジョブ情報領域がメモリーに確保されます。運用時のキューイングジョブのピーク数を十分に補える値を設定してください。

なお，この指定で対象となるジョブにイベントジョブは含まれません。

"AlartContentJob"=dword:システム内の警告ジョブ数

システム内に保持されている作業領域上のジョブ情報領域の使用状況によって，警告メッセージを出力するためのしきい値を16進数で指定します。

1～14000（10進数で1～81,920）の間で指定します。

デフォルトは「dword:00000640」（10進数で1,600）です。

なお，この指定で対象となるジョブにイベントジョブは含まれません。

"ReceiveFileSizeStatus"=dword:ファイルサイズが上限値に達したときの動作

ファイル受信サイズが上限値に達したときの動作を指定します。

0

すべてのファイルデータを受信します。

1

ファイル受信サイズの上限値をチェックし，上限値に達したときはファイルの受信処理を中止してジョブの状態を異常検出終了に変更します。

2

ファイル受信サイズの上限値をチェックし，上限値に達したときはファイルの受信処理を中止してジョブの状態を警告検出終了に変更します。

3

ファイル受信サイズの上限値をチェックし，上限値に達したときはファイルの受信処理を中止して実際の終了状態を引き継ぎます。

デフォルトは「0」です。

詳細については，「16.13 ファイル受信制限をするための設定」を参照してください。

"LimitReceiveFileSize"=dword:ファイルサイズの上限値

ファイル受信サイズの上限値を16進数で指定します。

指定できる範囲は80000～40000000（10進数で524,288～1,073,741,824）（単位：バイト）です。デフォルトは「dword:00500000」（10進数で5,242,880）です。詳細については，「16.13 ファイル受信制限をするための設定」を参照してください。

"ReceiveFileOption"=dword:ジョブ結果ファイルの二重受信防止の定義

ジョブ結果ファイルの二重受信防止を行うかどうかを指定します。

0

ジョブ結果ファイルの二重受信を防止しません。

1

ジョブ結果ファイルの二重受信を防止します。

デフォルトは「0」です。

詳細については，「16.16 ジョブ結果ファイルの二重受信防止の設定」を参照してください。

"QueuingJobRecoveryTime"=dword:キューイング中のジョブに対するエージェントの障害回復待ち時間

キューイング中のジョブに対するエージェントの障害回復待ち時間を16進数で指定します。指定できる範囲は0000001E～00000E10（10進数で30～3600）（単位：秒）です。デフォルトは「dword:00000258」（10進数で600）で10分です。詳細については，「16.22 エージェントの障害回復待ち時間を短縮する設定方法」を参照してください。

"ExecutingJobRecoveryTime"=dword:実行中のジョブに対するエージェントの障害回復待ち時間

実行中のジョブに対するエージェントの障害回復待ち時間を16進数で指定します。指定できる範囲は0000001E～00000E10（10進数で30～3600）（単位：秒）です。デフォルトは「dword:00000258」（10進数で600）で10分です。詳細については，「16.22 エージェントの障害回復待ち時間を短縮する設定方法」を参照してください。

"MaximumExecJobLogOption"=dword:ジョブ実行多重度到達を確認するメッセージを出力する設定

ジョブ実行多重度到達を確認するメッセージを出力するかどうかを指定します。

0

ジョブ実行多重度到達を確認するメッセージを出力しません。

1

ジョブ実行多重度到達を確認するメッセージを出力します。

デフォルトは「0」です。

詳細については，「16.25 ジョブ実行多重度到達を確認するメッセージを出力する設定」を参照してください。

"MaximumExecJobLogInterval"=dword:ジョブ実行多重度到達を確認するメッセージを出力する間隔

ジョブ実行多重度到達を確認するメッセージを出力する間隔を16進数で指定します。指定できる範囲は0000003C～00015180（10進数で60～86400）（単位：秒）です。デフォルトは「dword:00000258」（10進数で600）で10分です。詳細については，「16.25 ジョブ実行多重度到達を確認するメッセージを出力する設定」を参照してください。

"PreventChangeJobOrder"=dword:サブミットジョブの実行順序の入れ替わりを防止する設定

サブミットジョブの実行順序の入れ替わりを防止するかを指定します。

0

サブミットジョブの実行順序の入れ替わりを防止しません。

1

サブミットジョブの実行順序の入れ替わりを防止します。

デフォルトは「0」です。

詳細については，「16.27 サブミットジョブの実行順序の入れ替わりを防止する設定」を参照してください。

"EnumJobSaveMemory"=dword:ジョブ情報列挙時にジョブ実行制御マネージャーのメモリー消費量を少なくする設定

ジョブ情報列挙時にジョブ実行制御マネージャーのメモリー消費量を少なくするかを指定します。

0

ジョブ情報列挙時に，ジョブ実行制御マネージャーが列挙数に応じてメモリーを消費する場合に指定します。

1

ジョブ情報列挙時に，ジョブ実行制御マネージャーのメモリー消費量を少なくする場合に指定します。

デフォルトは「0」です。

詳細については，「16.28 ジョブ情報列挙時にジョブ実行制御マネージャー（jpqman）のメモリー消費量を少なくする設定」を参照してください。

"MaximumAgent"=dword:エージェントの最大定義数

定義をしているJP1/AJS2 - Managerから，ジョブを実行するエージェントの最大数を16進数で指定します。

1～400（10進数で1～1,024）の間で指定します。

デフォルトは「dword:00000032」（10進数で50）です。

JP1/AJS2サービス起動時に，ここで設定した値分のエージェント情報領域がメモリーに確保されます。

ここで指定した数を超えてジョブ実行エージェントと接続しようとした場合，接続できなくなります。

"ObserveInterval"=dword:エージェント監視インターバル

ジョブ実行先のエージェントを監視する間隔を16進数で指定します。

3C～15180（10進数で60～86,400）（単位：秒）の間で指定します。

デフォルトは「dword:0000012C」（10進数で300）です。

"AutoCreate"=dword:ジョブサブミット時のエージェント自動定義の制御フラグ

ジョブをサブミットしたときにエージェントを自動定義するかどうかを指定します。

0

ジョブをサブミットしたときにエージェントを自動定義しません。

1

ジョブをサブミットしたときにエージェントを自動定義します。

デフォルトは「0」です。

「1」を指定した場合，このパラメーターが指定されたマネージャーホストを使用するすべてのジョブのサブミットに対して，エージェントの自動定義機能が有効になります。

この機能を使用できるのは，ジョブネットに定義されたPCジョブ，UNIXジョブ，アクションジョブ，jpqjobsubコマンドに定義されたサブミットジョブを実行するときです。QUEUEジョブ，イベントジョブは対象外です。

エージェントは，ジョブのサブミット時に作成されます。例えジョブの実行に失敗しても，エージェントは作成されたままとなります。いったん作成されたエージェントは，JP1/AJS2再起動後も有効です。

作成されるエージェントのデフォルトキューの属性は次のとおりです。

ジョブの実行多重度：24時間，実行多重度は5

最大ジョブ数：100

最大警告数：80

キュー受付口状態：open

キュー取出口状態：open

接続エージェント：自エージェントホスト

エージェントの優先順位：1

なお，デフォルトキューの属性は，あらかじめ構成定義情報でカスタマイズできます。次に示す環境設定パラメーターを定義すると，エージェント自動定義機能を使用して作成されるすべてのエージェント属性値に対して有効になります。

"AutoCreateExecJobs"=

"AutoCreateMaxJobs"=

"AutoCreateWarnJobs"=

"AutoCreatePriority"=

また，デフォルトキューの属性は，jpqagtalt，jpqquealt，jpqqueopen，jpqqueclose，jpqagtlinkおよびjpqagtunlinkコマンドでも変更できます。

コマンドの詳細については，マニュアル「JP1/Automatic Job Management System 2 コマンドリファレンス　1. コマンド」を参照してください。

注意

この機能は，既存のエージェント（ジョブ実行環境）に障害が発生したため，緊急に代替エージェント作成し，ジョブを実行しなければならなくなった場合など，やむを得ない場合にだけ使用してください。通常の運用では，エージェントはジョブ実行前に作成しておいてください。運用途中でエージェントを追加する必要が生じた場合は，jpqimportコマンドやjpqagtaddコマンドを使用してエージェントを追加してください。

"AutoCreateExecJobs"=dword:エージェント自動定義時のジョブの実行多重度

エージェント自動定義時に作成されるエージェントのジョブ実行多重度を16進数で指定します。

1～00000400（10進数で1～1,024）の間で指定します。

デフォルトは「dword:00000005」（10進数で5）です。

ここで指定した多重度は24時間共通の設定となります。30分単位で設定したい場合は，jpqagtaltコマンドを使用して変更してください。

"AutoCreateMaxJobs"=dword:エージェント自動定義時のジョブ数の最大値

エージェント自動定義時に作成されるデフォルトキューのジョブの最大数を16進数で指定します。

1～FFFFFFFF（10進数で1～4,294,967,295）の間で指定します。

デフォルトは「dword:00000064」（10進数で100）です。

"AutoCreateWarnJobs"=dword:エージェント自動定義時のジョブ数の警告値

エージェント自動定義時に作成されるデフォルトキューのジョブの警告数を16進数で指定します。

1～FFFFFFFF（10進数で1～4,294,967,295）の間で指定します。

デフォルトは「dword:00000050」（10進数で80）です。

"AutoCreatePriority"=dword:エージェント自動定義時のエージェント優先順位

エージェント自動定義時に作成されるデフォルトキューのエージェント優先順位を16進数で指定します。

1～00000010（10進数で1～16）の間で指定します。

デフォルトは「dword:00000001」（10進数で1）です。

"LeastRecentlyUsed"=dword:ジョブを配信するエージェントホストの決定方式

ジョブを配信するエージェントホストの決定方式を指定します。

0

複数の接続エージェントが同じ優先順位で，さらにエージェント使用率が同じであった場合に，エージェントIDが大きいものをジョブの配信先エージェントホストに決定します。

1

複数の接続エージェントが同じ優先順位で，さらにエージェント使用率が同じであった場合に，ジョブを最後に配信してから最も未使用時間が長いエージェントホストをジョブの配信先エージェントホストに決定します。

デフォルトは「0」です。

詳細については，「16.18 ジョブを配信するエージェントホストの決定方式の設定」を参照してください。

"MaximumResource"=dword:排他実行リソースの最大定義数

ジョブの同時実行を抑止するために使用する排他実行リソースの最大数を16進数で指定します。

1～2000（10進数で1～8,192）の間で指定します。

デフォルトは「dword:00000032」（10進数で50）です。

JP1/AJS2サービス起動時に，ここで設定した値分の排他実行リソース情報領域がメモリーに確保されます。

なお，この指定で対象となるジョブにイベントジョブは含まれません。

排他実行リソースは，ジョブネットに定義したジョブでは使用できません。一方，jpqjobsubコマンドに定義したサブミットジョブでは使用できます。

コマンドの詳細については，マニュアル「JP1/Automatic Job Management System 2 コマンドリファレンス　1. コマンド」を参照してください。

"WorkPath"="エージェントプロセス実行時のワークディレクトリ名"

このホストでジョブを実行する場合のワークディレクトリの名称を180バイト以内で指定します。

ディレクトリ名はフルパスで指定します。

デフォルトは「/var/opt/jp1ajs2/tmp」です。

"IsHA"=dword:エージェントプロセスのクラスタ環境設定の定義

ジョブ実行制御エージェントプロセスのクラスタ環境設定の定義を指定します。このパラメーターは，クラスタ運用をやめる場合だけ設定してください。

00000000

クラスタ運用しない場合に指定します。

00000001

クラスタ運用する場合に指定します。クラスタシステム運用時のセットアップを実行すると，この値が自動的に設定されます。

デフォルトは「00000000（クラスタ運用しない）」です。

"IsLimitCoreSize"=dword:プロセスごとの最大コアファイルサイズの制限フラグ

JP1/AJS2から実行するジョブのプロセスごとのコアファイルサイズを制限するかどうかを指定します。

0

ジョブのプロセスごとのコアファイルサイズを制限しません。

1

ジョブのプロセスごとのコアファイルサイズを制限します。

デフォルトは「0」です。

"LimitCoreSize"=dword:プロセスごとの最大コアファイルサイズ

JP1/AJS2から実行するジョブのプロセスごとの最大コアファイルサイズを16進数で指定します。

0～0x7FFFFFFF（10進数で0～2,147,483,647）（単位：バイト）の間で指定します。

デフォルトは「dword:0x7FFFFFFF」（10進数で2,147,483,647）です。

このパラメーターで指定した値は，最大コアファイルサイズの制限として「"IsLimitCoreSize"=dword:1」を指定した場合に有効になります。

注意

0～0x7FFFFFFFという指定範囲は，論理上の指定範囲です。実際の指定範囲は，OSのシステムコールsetrlimit()の設定範囲に依存します。

「dword:0x7FFFFFFF」を指定した場合，システムに設定されている上限値が上限になります。

また，「dword:0x7FFFFFFF」より小さくても，その値がシステムの上限値よりも大きい場合は，システムの上限値が上限になります。

設定に失敗した場合はメッセージが出力され，制限値は変更されません。

"IsLimitDataSize"=dword:プロセスごとの最大データセグメントサイズの制限フラグ

JP1/AJS2から実行するジョブのプロセスごとのデータセグメントサイズを制限するかどうかを指定します。

0

ジョブのプロセスごとのデータセグメントサイズを制限しません。

1

ジョブのプロセスごとのデータセグメントサイズを制限します。

デフォルトは「0」です。

"LimitDataSize"=dword:プロセスごとの最大データセグメントサイズ

JP1/AJS2から実行するジョブのプロセスごとの最大データセグメントサイズを16進数で指定します。

0～0x7FFFFFFF（10進数で0～2,147,483,647）（単位：バイト）の間で指定します。

デフォルトは「dword:0x7FFFFFFF」（10進数で2,147,483,647）です。

このパラメーターで指定した値は，最大データセグメントサイズの制限として「"IsLimitDataSize"=dword:1」を指定した場合に有効になります。

注意

0～0x7FFFFFFFという指定範囲は，論理上の指定範囲です。実際の指定範囲は，OSのシステムコールsetrlimit()の設定範囲に依存します。

「dword:0x7FFFFFFF」を指定した場合，システムに設定されている上限値が上限になります。

また，「dword:0x7FFFFFFF」より小さくても，その値がシステムの上限値よりも大きい場合は，システムの上限値が上限になります。

設定に失敗した場合はメッセージが出力され，制限値は変更されません。

"IsLimitFileSize"=dword:プロセスごとの最大パーマネントファイルサイズの制限フラグ

JP1/AJS2から実行するジョブのプロセスごとのパーマネントファイルサイズを制限するかどうかを指定します。

0

ジョブのプロセスごとのパーマネントファイルサイズを制限しません。

1

ジョブのプロセスごとのパーマネントファイルサイズを制限します。

デフォルトは「0」です。

"LimitFileSize"=dword:プロセスごとの最大パーマネントファイルサイズ

JP1/AJS2から実行するジョブのプロセスごとの最大パーマネントファイルサイズを16進数で指定します。

0～0x7FFFFFFF（10進数で0～2,147,483,647）（単位：バイト）の間で指定します。

デフォルトは「dword:0x7FFFFFFF」（10進数で2,147,483,647）です。

このパラメーターで指定した値は，最大パーマネントファイルサイズの制限として「"IsLimitFileSize"=dword:1」を指定した場合に有効になります。

注意

0～0x7FFFFFFFという指定範囲は，論理上の指定範囲です。実際の指定範囲は，OSのシステムコールsetrlimit()の設定範囲に依存します。

「dword:0x7FFFFFFF」を指定した場合，システムに設定されている上限値が上限になります。

また，「dword:0x7FFFFFFF」より小さくても，その値がシステムの上限値よりも大きい場合は，システムの上限値が上限になります。

設定に失敗した場合はメッセージが出力され，制限値は変更されません。

"IsLimitMemorySize"=dword:プロセスごとの最大メモリーサイズの制限フラグ

JP1/AJS2から実行するジョブのプロセスごとのメモリーサイズ（物理メモリーとスワップとの合計サイズ）を制限するかどうかを指定します。

0

ジョブのプロセスごとのメモリーサイズを制限しません。

1

ジョブのプロセスごとのメモリーサイズを制限します。

デフォルトは「0」です。

"LimitMemorySize"=dword:プロセスごとの最大メモリーサイズ

JP1/AJS2から実行するジョブのプロセスごとの最大メモリーサイズ（物理メモリーとスワップとの合計サイズ）を16進数で指定します。

0～0x7FFFFFFF（10進数で0～2,147,483,647）（単位：バイト）の間で指定します。

デフォルトは「dword:0x7FFFFFFF」（10進数で2,147,483,647）です。

このパラメーターで指定した値は，最大メモリーサイズの制限として「"IsLimitMemorySize"=dword:1」を指定した場合に有効になります。

注意

0～0x7FFFFFFFという指定範囲は，論理上の指定範囲です。実際の指定範囲は，OSのシステムコールsetrlimit()の設定範囲に依存します。

「dword:0x7FFFFFFF」を指定した場合，システムに設定されている上限値が上限になります。

また，「dword:0x7FFFFFFF」より小さくても，その値がシステムの上限値よりも大きい場合は，システムの上限値が上限になります。

設定に失敗した場合はメッセージが出力され，制限値は変更されません。

"IsLimitStackSize"=dword:プロセスごとの最大スタックセグメントサイズの制限フラグ

JP1/AJS2から実行するジョブのプロセスごとのスタックセグメントサイズを制限するかどうかを指定します。

0

ジョブのプロセスごとのスタックセグメントサイズを制限しません。

1

ジョブのプロセスごとのスタックセグメントサイズを制限します。

デフォルトは「0」です。

"LimitStackSize"=dword:プロセスごとの最大スタックセグメントサイズ

JP1/AJS2から実行するジョブのプロセスごとの最大スタックセグメントサイズを16進数で指定します。

0～0x7FFFFFFF（10進数で0～2,147,483,647）（単位：バイト）の間で指定します。

デフォルトは「dword:0x7FFFFFFF」（10進数で2,147,483,647）です。

このパラメーターで指定した値は，最大スタックセグメントサイズの制限として「"IsLimitStackSize"=dword:1」を指定した場合に有効になります。

注意

0～0x7FFFFFFFという指定範囲は，論理上の指定範囲です。実際の指定範囲は，OSのシステムコールsetrlimit()の設定範囲に依存します。

「dword:0x7FFFFFFF」を指定した場合，システムに設定されている上限値が上限になります。

また，「dword:0x7FFFFFFF」より小さくても，その値がシステムの上限値よりも大きい場合は，システムの上限値が上限になります。

設定に失敗した場合はメッセージが出力され，制限値は変更されません。

"IsLimitCpuTime"=dword:プロセスごとの最大CPU時間の制限フラグ

JP1/AJS2から実行するジョブのプロセスごとのCPU時間を制限するかどうかを指定します。

0

ジョブのプロセスごとのCPU時間を制限しません。

1

ジョブのプロセスごとのCPU時間を制限します。

デフォルトは「0」です。

"LimitCpuTime"=dword:プロセスごとの最大CPU時間

JP1/AJS2から実行するジョブのプロセスごとの最大CPU時間を16進数で指定します。

0～0x7FFFFFFF（10進数で0～2,147,483,647）（単位：秒）の間で指定します。

デフォルトは「dword:0x7FFFFFFF」（10進数で2,147,483,647）です。

このパラメーターで指定した値は，最大CPU時間の制限として「"IsLimitCpuTime"=dword:1」を指定した場合に有効になります。

注意

0～0x7FFFFFFFという指定範囲は，論理上の指定範囲です。実際の指定範囲は，OSのシステムコールsetrlimit()の設定範囲に依存します。

「dword:0x7FFFFFFF」を指定した場合，システムに設定されている上限値が上限になります。

また，「dword:0x7FFFFFFF」より小さくても，その値がシステムの上限値よりも大きい場合は，システムの上限値が上限になります。

設定に失敗した場合はメッセージが出力され，制限値は変更されません。

"IsLimitWorkSize"=dword:プロセスごとの最大ワーキングセットサイズの制限フラグ

JP1/AJS2から実行するジョブのプロセスごとのワーキングセットサイズ（プロセスが使用する物理メモリーのサイズ）を制限するかどうかを指定します。

0

ジョブのプロセスごとのワーキングセットサイズを制限しません。

1

ジョブのプロセスごとのワーキングセットサイズを制限します。

デフォルトは「0」です。

注意

Solarisを使用している場合，このフラグは指定しないでください。JP1/AJS2が起動できなくなるおそれがあります。

"LimitWorkSize"=dword:プロセスごとの最大ワーキングセットサイズ

JP1/AJS2から実行するジョブのプロセスごとの最大ワーキングセットサイズ（プロセスが使用する物理メモリーのサイズ）を16進数で指定します。

0～0x7FFFFFFF（10進数で0～2,147,483,647）（単位：バイト）の間で指定します。

デフォルトは「dword:0x7FFFFFFF」（10進数で2,147,483,647）です。

このパラメーターで指定した値は，最大ワーキングセットサイズの制限として「"IsLimitWorkSize"=dword:1」を指定した場合に有効になります。

注意

0～0x7FFFFFFFという指定範囲は，論理上の指定範囲です。実際の指定範囲は，OSのシステムコールsetrlimit()の設定範囲に依存します。

「dword:0x7FFFFFFF」を指定した場合，システムに設定されている上限値が上限になります。

また，「dword:0x7FFFFFFF」より小さくても，その値がシステムの上限値よりも大きい場合は，システムの上限値が上限になります。

設定に失敗した場合はメッセージが出力され，制限値は変更されません。

"IsLimitNoFile"=dword:プロセスごとの最大ファイルディスクリプタ数の制限フラグ

JP1/AJS2から実行するジョブのプロセスごとのファイルディスクリプタ数を制限するかどうかを指定します。

0

ジョブのプロセスごとのファイルディスクリプタ数を制限しません。

1

ジョブのプロセスごとのファイルディスクリプタを制限します。

デフォルトは「0」です。

"LimitNoFile"=dword:プロセスごとの最大ファイルディスクリプタ数

JP1/AJS2から実行するジョブのプロセスごとの最大ファイルディスクリプタ数を16進数で指定します。

0～0x7FFFFFFF（10進数で0～2,147,483,647）の間で指定します。

デフォルトは「dword:0x7FFFFFFF」（10進数で2,147,483,647）です。

このパラメーターで指定した値は，最大ファイルディスクリプタ数の制限として「"IsLimitNoFile"=dword:1」を指定した場合に有効になります。

注意

0～0x7FFFFFFFという指定範囲は，論理上の指定範囲です。実際の指定範囲は，OSのシステムコールsetrlimit()の設定範囲に依存します。

「dword:0x7FFFFFFF」を指定した場合，システムに設定されている上限値が上限になります。

また，「dword:0x7FFFFFFF」より小さくても，その値がシステムの上限値よりも大きい場合は，システムの上限値が上限になります。

設定に失敗した場合はメッセージが出力され，制限値は変更されません。

"PipeComTimeout"=dword:エージェントのパイプ通信タイムアウト値

パイプ通信タイムアウト時間（単位：秒）を16進数で指定します。

指定できる範囲は0x0000012C～0x7FFFFFFF（10進数で300～2,147,483,647）です。

デフォルトは「dword:0000012C」（10進数で300）です。

詳細については，「16.4 エージェントのパイプ通信タイムアウト値の変更」を参照してください。

"AfterForkPipeTimeout"=dword:ジョブプロセス実行準備完了通知時のタイムアウト値

ジョブプロセス実行準備完了通知のタイムアウト時間（単位：秒）を16進数で指定します。指定できる範囲は0x00000384～0x00015180（10進数で900～86,400）です。

最大値の0x00015180（10進数で86,400秒）は1日の秒数です。デフォルトは「dword:00000384」（10進数で900）です。詳細については，「16.5 ジョブプロセス実行準備完了通知時のタイムアウト値の設定」を参照してください。

"IsCacheCmdSearchPath"=dword:コマンド検索パスの値のキャッシング指定フラグ

ジョブ起動時に使用するコマンド検索パスの値をキャッシングするかどうかを指定します。

0

コマンド検索パスの値をキャッシングしません。

1

コマンド検索パスの値をキャッシングします。

デフォルトは「1」です。

「0」または「1」のどちらかではない値を指定した場合は，「1」が指定された場合と同じ動作になります。

キャッシングする場合，検索パスの取得処理に時間が掛からないため，ジョブ起動時の性能が改善されます。ただし，キャッシングしていると，パスを変更したときに直ちに変更が反映されません。キャッシングする設定でコマンド検索パスを変更した場合は，5分以上経過してからジョブを起動することをお勧めします。

なお，06-71以前のバージョンの動作に合わせたい場合は，「dword:00000000」を指定してください。

補足事項

コマンド検索パスは，実行OSユーザーのログインスクリプトに設定されている環境変数PATHです。

"IsUseWorkPath"=dword:ジョブ実行時のワークパスの変更フラグ

ジョブ実行時のワークパスをJP1/AJS2のエージェントプロセス実行時のワークディレクトリにするかどうかを指定します。

0

ジョブ実行時のワークパスをエージェントプロセス実行時のワークディレクトリにしません（設定を無効にする）。

1

ジョブ実行時のワークパスをエージェントプロセス実行時のワークディレクトリにします。

デフォルトは「0」です。

補足事項

UNIXで実行するジョブの場合，ワークパス名の指定（jpqjobsubコマンドでは-wオプションの作業用パス名）を省略すると，実行ユーザーのホームディレクトリが仮定されます。ホームディレクトリが未定義の場合は，「/」（ルート）が仮定されます。

ジョブの実行時，ワークパスにはJPQ_EXECで始まる名称のファイルが一時ファイルとして作成されます（それ以外のファイルは作成されません）。ワークパス名の指定を省略していてジョブが異常終了した場合は，ジョブ実行ユーザーのホームディレクトリにこれらのファイルが残ってしまいます。ジョブ実行ユーザーのホームディレクトリにこれらのファイルが残らないようにするには，ジョブ実行時のワークパスをJP1/AJS2のエージェントプロセス実行時のワークディレクトリに変更する必要があります。

"IsSigchldDefault"=dword:JP1/AJS2から起動される子プロセスを，SIGCHLDシグナルを受信する設定（SIG_DFL）に変更する定義

SIGCHLDシグナルを受信するデフォルト（SIG_DFL）で実行するかどうかを指定します。

0

SIGCHLDシグナルを無視します。

1

SIGCHLDシグナルを受信するデフォルト（SIG_DFL）で実行します。

デフォルトは「0」です。

このパラメーターには，JP1/AJS2の新規のインストール時および新規のセットアップ時に「1」が設定されます。

詳細については，「16.26 JP1/AJS2から起動される子プロセスを，SIGCHLDシグナルを受信する設定（SIG_DFL）に変更する方法」を参照してください。

"FileAccessPermissionMode"=dword:UNIXジョブ実行時のファイルのアクセス権限をチェックする方法の設定

UNIXジョブ実行時の，次に示すファイルのアクセス権限についてチェックする方法を指定します。

スクリプトファイル

環境変数ファイル

標準入力ファイル

標準出力ファイル

標準エラー出力ファイル

転送先ファイル

0

各ファイルのアクセス権限について，ファイルパーミッションの設定に基づいてチェックします。アクセス制御リストやセカンダリーグループの設定に基づくチェックは行いません。

1

スクリプトファイルのアクセス権限について，ファイルパーミッション，アクセス制御リスト，およびセカンダリーグループの設定に基づいてチェックします。

スクリプトファイル以外のファイルのアクセス権限については，ファイルパーミッションに基づくチェックだけ行います。

2

各ファイルのアクセス権限について，ファイルパーミッション，アクセス制御リスト，およびセカンダリーグループの設定に基づいてチェックします。

デフォルトは「0」です。

詳細については，「16.32 ジョブ実行時のファイル権限チェックでアクセス制御リストやセカンダリーグループの設定を有効にする」を参照してください。

"GetPasswd_RetryCount"= dword:OSのパスワードファイルからユーザー情報の取得に失敗した場合にリトライする回数

OSのパスワードファイルからユーザー情報の取得に失敗した場合にリトライする回数を16進数で指定します。

0～0x000000A（10進数で0～10）の間で指定します。

デフォルトは「dword:00000002」（10進数で2）です。

「0」を指定した場合は，リトライしません。

通常，この値は変更する必要はありません。詳細については，「16.37 ユーザー情報取得時のリトライを変更する設定」を参照してください。

"GetPasswd_RetryInterval"= dword:OSのパスワードファイルからユーザー情報の取得に失敗した場合にリトライする間隔

OSのパスワードファイルからユーザー情報の取得に失敗した場合にリトライする間隔（単位：ミリ秒）を16進数で指定します。

0～0x0002710（10進数で0～10,000）の間で指定します。

デフォルトは「dword:000003E8」（10進数で1,000）です。

「0」を指定した場合は，すぐにリトライします。

通常，この値は変更する必要はありません。詳細については，「16.37 ユーザー情報取得時のリトライを変更する設定」を参照してください。

"NotfyJobStateInterval"=dword:ジョブの結果ファイルの再送間隔

ジョブの結果ファイルの再送間隔（単位：秒）を16進数で指定します。0～0x00015180（10進数で0～86,400）の間で指定します。最大値の0x00015180（10 進数で86,400 秒）は1日の秒数です。デフォルトは「dword:0000012C」（10進数で300）で5分です。結果ファイルの再送を行わないようにするには0を指定してください。詳細については，「16.15 ジョブの結果ファイルの再送間隔・再送回数の変更」を参照してください。

"NotfyJobStateCount"=dword:ジョブの結果ファイルの再送回数

ジョブの結果ファイルの再送回数を16進数で指定します。1～0x00000800（10進数で1～2,048）の間で指定します。デフォルトは「dword:00000120」（10進数で288）で288回です（デフォルトでは5分間隔で24時間再送します）。詳細については，「16.15 ジョブの結果ファイルの再送間隔・再送回数の変更」を参照してください。

"CommunicateTimeout"=dword:設定値

通信タイムアウト時間を16進数で指定します（単位：ミリ秒）。

指定できる範囲は000927c0～0036EE80（10進数で600000～3600000）です。

デフォルトは「000927c0（10進数で600000（10分））」です。

詳細については，「16.29 ジョブ実行制御のマネージャープロセスに対する通信タイムアウト時間の変更」を参照してください。

"MacroOptionReplaceMode"=dword:マクロ変数の引き継ぎ情報がNULL文字列の場合の置き換え方法の設定

前後に文字列がないマクロ変数の引き継ぎ情報がNULL文字列の場合に，マクロ変数名をNULL文字列に置き換えるかどうかを指定します。

0

マクロ変数名をNULL文字列に置き換えないで，指定されたマクロ変数名をそのままの文字列として使用します。

1

マクロ変数名をNULL文字列に置き換えます。

デフォルトは「0」です。

詳細については，「16.20 マクロ変数の引き継ぎ情報がNULL文字列の場合の置き換え方法の設定」を参照してください。

"IsHA"=dword:ジョブ実行に使用するコマンドおよびスケジュール制御のクラスタ環境設定の定義

ジョブ実行に使用するコマンドおよびスケジュール制御のクラスタ環境設定の定義を指定します。このパラメーターは，クラスタ運用をやめる場合だけ設定してください。

00000000

クラスタ運用しない場合に指定します。

00000001

クラスタ運用する場合に指定します。クラスタシステム運用時のセットアップを実行すると，この値が自動的に設定されます。

デフォルトは「00000000（クラスタ運用しない）」です。

"IsHA"=dword:ジョブ実行制御状態通知プロセスのクラスタ環境設定の定義

ジョブ実行制御状態通知プロセスのクラスタ環境設定の定義を指定します。このパラメーターは，クラスタ運用をやめる場合だけ設定してください。

00000000

クラスタ運用しない場合に指定します。

00000001

クラスタ運用する場合に指定します。クラスタシステム運用時のセットアップを実行すると，この値が自動的に設定されます。

デフォルトは「00000000（クラスタ運用しない）」です。

(3)　ジョブ実行環境のリソースを制限する場合の注意事項

ジョブ実行制御から実行するジョブのリソースを制限する場合，環境設定パラメーターに指定する値によっては，ジョブが正常に実行できなくなることがあるため，注意が必要です。例えば，スタックセグメントサイズの上限を0に設定すると，ジョブが実行できなくなる場合があります。

このため，余裕のある制限値を指定するか，または制限を設けないでください。制限を設ける場合は，事前にpsコマンドを実行し，セグメントサイズやCPU時間などを計測してから，指定する値を決定してください。

ただし，制限を設けない場合でも，リソースに対する制限がまったくなくなるわけではありません。この場合，JP1/AJS2が明示的に制限値を設定しないだけであり，システムのデフォルトの制限値（JP1/AJS2起動時の制限値）が有効になります。

なお，環境設定パラメーターの中にはOSによって制限をしていないものもあります。

デフォルトの制限値を超える値を指定した場合は，ジョブ実行ユーザーに適切な権限（スーパーユーザー権限）が必要です。ジョブ実行ユーザーに適切な権限（スーパーユーザー権限）がないときは，ジョブ実行時にリソース制限に失敗し，統合トレースログに警告メッセージKAVU3587-Wが出力されます。この場合，ジョブはデフォルトの制限値で実行されます。

なお，リソースの制限は，ジョブプロセスが生成した子プロセスにも反映されます（ただし，子プロセス側で独自に制限する場合は除きます）。

また，AIXおよびLinuxの場合，ジョブの実行ユーザーに対して，/etc/security/limits（Linuxの場合は/etc/security/limits.conf）でリソースの制限値の定義をしても，ジョブ実行時に値は有効になりません。JP1/AJS2起動時のユーザー（root）に対してリソース制限値を定義してください。詳細については，マニュアル「JP1/Automatic Job Management System 2 設計・運用ガイド　8.1.18 UNIXジョブ実行時のリソース制限値についての注意事項」を参照してください。

14.2.3　エージェント環境（JP1/AJS2 - Agent）で設定する内容

この項では，エージェント環境（JP1/AJS2 - Agent）で設定するジョブ実行環境設定ファイル（Queue.conf）について説明します。

各パラメーターの推奨値と設定が有効になる時期については，マニュアル「JP1/Automatic Job Management System 2 設計・運用ガイド　5.4.1 ジョブ実行環境に関する環境設定について検討する」を参照してください。

＜この項の構成＞

(1)　ジョブ実行環境設定ファイル（JP1/AJS2 - Agent）の環境設定パラメーター一覧

(2)　ジョブ実行環境設定ファイル（JP1/AJS2 - Agent）の環境設定パラメーターの定義内容

(3)　ジョブ実行環境のリソースを制限する場合の注意事項

(1)　ジョブ実行環境設定ファイル（JP1/AJS2 - Agent）の環境設定パラメーター一覧

ジョブ実行環境設定ファイルで定義する環境設定パラメーターの一覧を次の表に示します。

表14-5　環境設定パラメーター一覧（Queue.conf・JP1/AJS2 - Agent）

定義キー | 環境設定パラメーター | 定義内容
[{JP1_DEFAULT|論理ホスト名}¥JP1NBQAGENT¥Process]※1 | "WorkPath"= | エージェントプロセス実行時のワークディレクトリ名
"IsHA"= | エージェントプロセスのクラスタ環境設定の定義
[{JP1_DEFAULT|論理ホスト名}¥JP1NBQAGENT¥Job]※1 | "IsLimitCoreSize"= | プロセスごとの最大コアファイルサイズの制限フラグ
"LimitCoreSize"= | プロセスごとの最大コアファイルサイズ
"IsLimitDataSize"= | プロセスごとの最大データセグメントサイズの制限フラグ
"LimitDataSize"= | プロセスごとの最大データセグメントサイズ
"IsLimitFileSize"= | プロセスごとの最大パーマネントファイルサイズの制限フラグ
"LimitFileSize"= | プロセスごとの最大パーマネントファイルサイズ
"IsLimitMemorySize"= | プロセスごとの最大メモリーサイズの制限フラグ
"LimitMemorySize"= | プロセスごとの最大メモリーサイズ
"IsLimitStackSize"= | プロセスごとの最大スタックセグメントサイズの制限フラグ
"LimitStackSize"= | プロセスごとの最大スタックセグメントサイズ
"IsLimitCpuTime"= | プロセスごとの最大CPU時間の制限フラグ
"LimitCpuTime"= | プロセスごとの最大CPU時間
"IsLimitWorkSize"= | プロセスごとの最大ワーキングセットサイズの制限フラグ
"LimitWorkSize"= | プロセスごとの最大ワーキングセットサイズ
"IsLimitNoFile"= | プロセスごとの最大ファイルディスクリプタ数の制限フラグ
"LimitNoFile"= | プロセスごとの最大ファイルディスクリプタ数
"PipeComTimeout"= | エージェントのパイプ通信タイムアウト値の定義
"AfterForkPipeTimeout"= | ジョブプロセス実行準備完了通知時のタイムアウト値の定義
"IsCacheCmdSearchPath"= | コマンド検索パスの値のキャッシング指定フラグ
"IsUseWorkPath"= | ジョブ実行時のワーク（カレント）パスの変更フラグ
"IsSigchldDefault"= | JP1/AJS2から起動される子プロセスを，SIGCHLDシグナルを受信する設定（SIG_DFL）に変更する定義
"FileAccessPermissionMode"=※2 | UNIXジョブ実行時のファイルのアクセス権限をチェックする方法の設定
"GetPasswd_RetryCount"= | OSのパスワードファイルからユーザー情報の取得に失敗した場合にリトライする回数
"GetPasswd_RetryInterval"= | OSのパスワードファイルからユーザー情報の取得に失敗した場合にリトライする間隔
[{JP1_DEFAULT|論理ホスト名}¥JP1NBQAGENT¥Network]※1 | "NotfyJobStateInterval"= | ジョブの結果ファイルの再送間隔
"NotfyJobStateCount"= | ジョブの結果ファイルの再送回数
"ConnectTimeout"=※3 | ジョブ実行制御エージェントのTCP/IP通信接続タイムアウト値の定義
"CommunicateRetryCount"=※3 | ジョブ実行制御エージェントのTCP/IP通信接続エラーのリトライ回数の定義
"CommunicateRetryInterval"=※3 | ジョブ実行制御エージェントのTCP/IP通信接続エラーのリトライ間隔の定義
[{JP1_DEFAULT|論理ホスト名}¥JP1NBQAGENT¥Variable]※1 | "変数名"=※4 | 変数名に対応した実行プログラムの，そのホストでのインストールディレクトリ
[{JP1_DEFAULT|論理ホスト名}¥JP1NBQCLIENT¥PathEnv]※1 | "All Users"=※5 | 転送元ファイルの検索パス
"JP1ユーザー名"=※5 | 転送元ファイルの検索パス
[{JP1_DEFAULT|論理ホスト名}¥JP1NBQCLIENT¥Network]※1 | "ConnectTimeout"=※3 | ジョブ実行に使用するコマンドおよびスケジュール制御のTCP/IP通信接続タイムアウト値の定義
"CommunicateRetryCount"=※3 | ジョブ実行に使用するコマンドおよびスケジュール制御のTCP/IP通信接続エラーのリトライ回数の定義
"CommunicateRetryInterval"=※3 | ジョブ実行に使用するコマンドおよびスケジュール制御のTCP/IP通信接続エラーのリトライ間隔の定義
"CommunicateTimeout"= | ジョブ実行制御のマネージャープロセスに対する通信タイムアウト時間
[{JP1_DEFAULT|論理ホスト名}¥JP1NBQCLIENT¥Process]※1 | "MacroOptionReplaceMode"= | マクロ変数の引き継ぎ情報がNULL文字列の場合の置き換え方法の設定
"IsHA"= | ジョブ実行に使用するコマンドおよびスケジュール制御のクラスタ環境設定の定義

注※1

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

注※2

定義内容の詳細については，「16.32 ジョブ実行時のファイル権限チェックでアクセス制御リストやセカンダリーグループの設定を有効にする」を参照ください。

注※3

定義内容の詳細については，「16.17 TCP/IP通信接続エラーのリトライ間隔・回数の変更」を参照してください。

注※4

定義内容の詳細については，「16.1 ジョブ実行時のワークパスを変数として定義する」を参照してください。

注※5

定義内容の詳細については，「16.2 転送元ファイルの検索パスを定義する」を参照してください。

(2)　ジョブ実行環境設定ファイル（JP1/AJS2 - Agent）の環境設定パラメーターの定義内容

環境設定パラメーターの定義内容の詳細を次に示します。

なお，環境設定パラメーターのデフォルトは，環境設定パラメーターを省略した場合の仮定値です。

また，詳細の記載がないパラメーターは保守用のパラメーターです。値は変更しないでください。

"WorkPath"="エージェントプロセス実行時のワークディレクトリ名"

このホストでジョブを実行する場合のワークディレクトリの名称を180バイト以内で指定します。

ディレクトリ名はフルパスで指定します。

デフォルトは「/var/opt/jp1ajs2/tmp」です。

"IsHA"=dword:エージェントプロセスのクラスタ環境設定の定義

ジョブ実行制御エージェントプロセスのクラスタ環境設定の定義を指定します。このパラメーターは，クラスタ運用をやめる場合だけ設定してください。

00000000

クラスタ運用しない場合に指定します。

00000001

クラスタ運用する場合に指定します。クラスタシステム運用時のセットアップを実行すると，この値が自動的に設定されます。

デフォルトは「00000000（クラスタ運用しない）」です。

"IsLimitCoreSize"=dword:プロセスごとの最大コアファイルサイズの制限フラグ

JP1/AJS2から実行するジョブのプロセスごとのコアファイルサイズを制限するかどうかを指定します。

0

ジョブのプロセスごとのコアファイルサイズを制限しません。

1

ジョブのプロセスごとのコアファイルサイズを制限します。

デフォルトは「0」です。

"LimitCoreSize"=dword:プロセスごとの最大コアファイルサイズ

JP1/AJS2から実行するジョブのプロセスごとの最大コアファイルサイズを16進数で指定します。

0～0x7FFFFFFF（10進数で0～2,147,483,647）（単位：バイト）の間で指定します。

デフォルトは「dword:0x7FFFFFFF」（10進数で2,147,483,647）です。

このパラメーターで指定した値は，最大コアファイルサイズの制限として「"IsLimitCoreSize"=dword:1」を指定した場合に有効になります。

注意

0～0x7FFFFFFFという指定範囲は，論理上の指定範囲です。実際の指定範囲は，OSのシステムコールsetrlimit()の設定範囲に依存します。

「dword:0x7FFFFFFF」を指定した場合，システムに設定されている上限値が上限になります。

また，「dword:0x7FFFFFFF」より小さくても，その値がシステムの上限値よりも大きい場合は，システムの上限値が上限になります。

設定に失敗した場合はメッセージが出力され，制限値は変更されません。

"IsLimitDataSize"=dword:プロセスごとの最大データセグメントサイズの制限フラグ

JP1/AJS2から実行するジョブのプロセスごとのデータセグメントサイズを制限するかどうかを指定します。

0

ジョブのプロセスごとのデータセグメントサイズを制限しません。

1

ジョブのプロセスごとのデータセグメントサイズを制限します。

デフォルトは「0」です。

"LimitDataSize"=dword:プロセスごとの最大データセグメントサイズ

JP1/AJS2から実行するジョブのプロセスごとの最大データセグメントサイズを16進数で指定します。

0～0x7FFFFFFF（10進数で0～2,147,483,647）（単位：バイト）の間で指定します。

デフォルトは「dword:0x7FFFFFFF」（10進数で2,147,483,647）です。

このパラメーターで指定した値は，最大データセグメントサイズの制限として「"IsLimitDataSize"=dword:1」を指定した場合に有効になります。

注意

0～0x7FFFFFFFという指定範囲は，論理上の指定範囲です。実際の指定範囲は，OSのシステムコールsetrlimit()の設定範囲に依存します。

「dword:0x7FFFFFFF」を指定した場合，システムに設定されている上限値が上限になります。

また，「dword:0x7FFFFFFF」より小さくても，その値がシステムの上限値よりも大きい場合は，システムの上限値が上限になります。

設定に失敗した場合はメッセージが出力され，制限値は変更されません。

"IsLimitFileSize"=dword:プロセスごとの最大パーマネントファイルサイズの制限フラグ

JP1/AJS2から実行するジョブのプロセスごとのパーマネントファイルサイズを制限するかどうかを指定します。

0

ジョブのプロセスごとのパーマネントファイルサイズを制限しません。

1

ジョブのプロセスごとのパーマネントファイルサイズを制限します。

デフォルトは「0」です。

"LimitFileSize"=dword:プロセスごとの最大パーマネントファイルサイズ

JP1/AJS2から実行するジョブのプロセスごとの最大パーマネントファイルサイズを16進数で指定します。

0～0x7FFFFFFF（10進数で0～2,147,483,647）（単位：バイト）の間で指定します。

デフォルトは「dword:0x7FFFFFFF」（10進数で2,147,483,647）です。

このパラメーターで指定した値は，最大パーマネントファイルサイズの制限として「"IsLimitFileSize"=dword:1」を指定した場合に有効になります。

注意

0～0x7FFFFFFFという指定範囲は，論理上の指定範囲です。実際の指定範囲は，OSのシステムコールsetrlimit()の設定範囲に依存します。

「dword:0x7FFFFFFF」を指定した場合，システムに設定されている上限値が上限になります。

また，「dword:0x7FFFFFFF」より小さくても，その値がシステムの上限値よりも大きい場合は，システムの上限値が上限になります。

設定に失敗した場合はメッセージが出力され，制限値は変更されません。

"IsLimitMemorySize"=dword:プロセスごとの最大メモリーサイズの制限フラグ

JP1/AJS2から実行するジョブのプロセスごとのメモリーサイズ（物理メモリーとスワップとの合計サイズ）を制限するかどうかを指定します。

0

ジョブのプロセスごとのメモリーサイズを制限しません。

1

ジョブのプロセスごとのメモリーサイズを制限します。

デフォルトは「0」です。

"LimitMemorySize"=dword:プロセスごとの最大メモリーサイズ

JP1/AJS2から実行するジョブのプロセスごとの最大メモリーサイズ（物理メモリーとスワップとの合計サイズ）を16進数で指定します。

0～0x7FFFFFFF（10進数で0～2,147,483,647）（単位：バイト）の間で指定します。

デフォルトは「dword:0x7FFFFFFF」（10進数で2,147,483,647）です。

このパラメーターで指定した値は，最大メモリーサイズの制限として「"IsLimitMemorySize"=dword:1」を指定した場合に有効になります。

注意

0～0x7FFFFFFFという指定範囲は，論理上の指定範囲です。実際の指定範囲は，OSのシステムコールsetrlimit()の設定範囲に依存します。

「dword:0x7FFFFFFF」を指定した場合，システムに設定されている上限値が上限になります。

また，「dword:0x7FFFFFFF」より小さくても，その値がシステムの上限値よりも大きい場合は，システムの上限値が上限になります。

設定に失敗した場合はメッセージが出力され，制限値は変更されません。

"IsLimitStackSize"=dword:プロセスごとの最大スタックセグメントサイズの制限フラグ

JP1/AJS2から実行するジョブのプロセスごとのスタックセグメントサイズを制限するかどうかを指定します。

0

ジョブのプロセスごとのスタックセグメントサイズを制限しません。

1

ジョブのプロセスごとのスタックセグメントサイズを制限します。

デフォルトは「0」です。

"LimitStackSize"=dword:プロセスごとの最大スタックセグメントサイズ

JP1/AJS2から実行するジョブのプロセスごとの最大スタックセグメントサイズを16進数で指定します。

0～0x7FFFFFFF（10進数で0～2,147,483,647）（単位：バイト）の間で指定します。

デフォルトは「dword:0x7FFFFFFF」（10進数で2,147,483,647）です。

このパラメーターで指定した値は，最大スタックセグメントサイズの制限として「"IsLimitStackSize"=dword:1」を指定した場合に有効になります。

注意

0～0x7FFFFFFFという指定範囲は，論理上の指定範囲です。実際の指定範囲は，OSのシステムコールsetrlimit()の設定範囲に依存します。

「dword:0x7FFFFFFF」を指定した場合，システムに設定されている上限値が上限になります。

また，「dword:0x7FFFFFFF」より小さくても，その値がシステムの上限値よりも大きい場合は，システムの上限値が上限になります。

設定に失敗した場合はメッセージが出力され，制限値は変更されません。

"IsLimitCpuTime"=dword:プロセスごとの最大CPU時間の制限フラグ

JP1/AJS2から実行するジョブのプロセスごとのCPU時間を制限するかどうかを指定します。

0

ジョブのプロセスごとのCPU時間を制限しません。

1

ジョブのプロセスごとのCPU時間を制限します。

デフォルトは「0」です。

"LimitCpuTime"=dword:プロセスごとの最大CPU時間

JP1/AJS2から実行するジョブのプロセスごとの最大CPU時間を16進数で指定します。

0～0x7FFFFFFF（10進数で0～2,147,483,647）（単位：秒）の間で指定します。

デフォルトは「dword:0x7FFFFFFF」（10進数で2,147,483,647）です。

このパラメーターで指定した値は，最大CPU時間の制限として「"IsLimitCpuTime"=dword:1」を指定した場合に有効になります。

注意

0～0x7FFFFFFFという指定範囲は，論理上の指定範囲です。実際の指定範囲は，OSのシステムコールsetrlimit()の設定範囲に依存します。

「dword:0x7FFFFFFF」を指定した場合，システムに設定されている上限値が上限になります。

また，「dword:0x7FFFFFFF」より小さくても，その値がシステムの上限値よりも大きい場合は，システムの上限値が上限になります。

設定に失敗した場合はメッセージが出力され，制限値は変更されません。

"IsLimitWorkSize"=dword:プロセスごとの最大ワーキングセットサイズの制限フラグ

JP1/AJS2から実行するジョブのプロセスごとのワーキングセットサイズ（プロセスが使用する物理メモリーのサイズ）を制限するかどうかを指定します。

0

ジョブのプロセスごとのワーキングセットサイズを制限しません。

1

ジョブのプロセスごとのワーキングセットサイズを制限します。

デフォルトは「0」です。

注意

Solarisを使用している場合，このフラグは指定しないでください。JP1/AJS2が起動できなくなるおそれがあります。

"LimitWorkSize"=dword:プロセスごとの最大ワーキングセットサイズ

JP1/AJS2から実行するジョブのプロセスごとの最大ワーキングセットサイズ（プロセスが使用する物理メモリーのサイズ）を16進数で指定します。

0～0x7FFFFFFF（10進数で0～2,147,483,647）（単位：バイト）の間で指定します。

デフォルトは「dword:0x7FFFFFFF」（10進数で2,147,483,647）です。

このパラメーターで指定した値は，最大ワーキングセットサイズの制限として「"IsLimitWorkSize"=dword:1」を指定した場合に有効になります。

注意

0～0x7FFFFFFFという指定範囲は，論理上の指定範囲です。実際の指定範囲は，OSのシステムコールsetrlimit()の設定範囲に依存します。

「dword:0x7FFFFFFF」を指定した場合，システムに設定されている上限値が上限になります。

また，「dword:0x7FFFFFFF」より小さくても，その値がシステムの上限値よりも大きい場合は，システムの上限値が上限になります。

設定に失敗した場合はメッセージが出力され，制限値は変更されません。

"IsLimitNoFile"=dword:プロセスごとの最大ファイルディスクリプタ数の制限フラグ

JP1/AJS2から実行するジョブのプロセスごとのファイルディスクリプタ数を制限するかどうかを指定します。

0

ジョブのプロセスごとのファイルディスクリプタ数を制限しません。

1

ジョブのプロセスごとのファイルディスクリプタ数を制限します。

デフォルトは「0」です。

"LimitNoFile"=dword:プロセスごとの最大ファイルディスクリプタ数

JP1/AJS2から実行するジョブのプロセスごとの最大ファイルディスクリプタ数を16進数で指定します。

0～0x7FFFFFFF（10進数で0～2,147,483,647）の間で指定します。

デフォルトは「dword:0x7FFFFFFF」（10進数で2,147,483,647）です。

このパラメーターで指定した値は，最大ファイルディスクリプタ数の制限として「"IsLimitNoFile"=dword:1」を指定した場合に有効になります。

注意

0～0x7FFFFFFFという指定範囲は，論理上の指定範囲です。実際の指定範囲は，OSのシステムコールsetrlimit()の設定範囲に依存します。

「dword:0x7FFFFFFF」を指定した場合，システムに設定されている上限値が上限になります。

また，「dword:0x7FFFFFFF」より小さくても，その値がシステムの上限値よりも大きい場合は，システムの上限値が上限になります。

設定に失敗した場合はメッセージが出力され，制限値は変更されません。

"PipeComTimeout"=dword:エージェントのパイプ通信タイムアウト値

パイプ通信タイムアウト時間（単位：秒）を16進数で指定します。

指定できる範囲は0x0000012C～0x7FFFFFFF（10進数で300～2,147,483,647）です。

デフォルトは「dword:0000012C」（10進数で300）です。

詳細については，「16.4 エージェントのパイプ通信タイムアウト値の変更」を参照してください。

"AfterForkPipeTimeout"=dword:ジョブプロセス実行準備完了通知時のタイムアウト値

ジョブプロセス実行準備完了通知のタイムアウト時間（単位：秒）を16進数で指定します。

指定できる範囲は0x00000384～0x00015180（10進数で900～86,400）です。

最大値の0x00015180（10進数で86,400秒）は1日の秒数です。デフォルトは「dword:00000384」（10進数で900）です。詳細については，「16.5 ジョブプロセス実行準備完了通知時のタイムアウト値の設定」を参照してください。

"IsCacheCmdSearchPath"=dword:コマンド検索パスの値のキャッシング指定フラグ

ジョブ起動時に使用するコマンド検索パスの値をキャッシングするかどうかを指定します。

0

コマンド検索パスの値をキャッシングしません。

1

コマンド検索パスの値をキャッシングします。

デフォルトは「1」です。

「0」または「1」のどちらかではない値を指定した場合は，「1」が指定された場合と同じ動作になります。

キャッシングする場合，検索パスの取得処理に時間が掛からないため，ジョブ起動時の性能が改善されます。ただし，キャッシングしていると，パスを変更したときに直ちに変更が反映されません。キャッシングする設定でコマンド検索パスを変更した場合は，5分以上経過してからジョブを起動することをお勧めします。

なお，06-71以前のバージョンの動作に合わせたい場合は，「dword:00000000」を指定してください。

補足事項

コマンド検索パスは，実行OSユーザーのログインスクリプトに設定されている環境変数PATHです。

"IsUseWorkPath"=dword:ジョブ実行時のワークパスの変更フラグ

ジョブ実行時のワークパスをJP1/AJS2のエージェントプロセス実行時のワークディレクトリにするかどうかを指定します。

0

ジョブ実行時のワークパスをエージェントプロセス実行時のワークディレクトリにしません（設定を無効にします）。

1

ジョブ実行時のワークパスをエージェントプロセス実行時のワークディレクトリにします。

デフォルトは「0」です。

補足事項

UNIXで実行するジョブの場合，ワークパス名の指定（jpqjobsubコマンドでは-wオプションの作業用パス名）を省略すると，実行ユーザーのホームディレクトリが仮定されます。ホームディレクトリが未定義の場合は，「/」（ルート）が仮定されます。

ジョブの実行時，ワークパスにはJPQ_EXECで始まる名称のファイルが一時ファイルとして作成されます（それ以外のファイルは作成されません）。ワークパス名の指定を省略していてジョブが異常終了した場合は，ジョブ実行ユーザーのホームディレクトリにこれらのファイルが残ってしまいます。ジョブ実行ユーザーのホームディレクトリにこれらのファイルが残らないようにするには，ジョブ実行時のワークパスをJP1/AJS2のエージェントプロセス実行時のワークディレクトリに変更する必要があります。

"IsSigchldDefault"=dword:JP1/AJS2から起動される子プロセスを，SIGCHLDシグナルを受信する設定（SIG_DFL）に変更する定義

SIGCHLDシグナルを受信するデフォルト（SIG_DFL）で実行するかどうかを指定します。

0

SIGCHLDシグナルを無視します。

1

SIGCHLDシグナルを受信するデフォルト（SIG_DFL）で実行します。

デフォルトは「0」です。

このパラメーターは，JP1/AJS2の新規のインストール時および新規のセットアップ時に「1」が設定されます。

詳細については，「16.26 JP1/AJS2から起動される子プロセスを，SIGCHLDシグナルを受信する設定（SIG_DFL）に変更する方法」を参照してください。

"FileAccessPermissionMode"=dword:UNIXジョブ実行時のファイルのアクセス権限をチェックする方法の設定

UNIXジョブ実行時の，次に示すファイルのアクセス権限についてチェックする方法を指定します。

スクリプトファイル

環境変数ファイル

標準入力ファイル

標準出力ファイル

標準エラー出力ファイル

転送先ファイル

0

各ファイルのアクセス権限について，ファイルパーミッションの設定に基づいてチェックします。アクセス制御リストやセカンダリーグループの設定に基づくチェックは行いません。

1

スクリプトファイルのアクセス権限について，ファイルパーミッション，アクセス制御リスト，およびセカンダリーグループの設定に基づいてチェックします。

スクリプトファイル以外のファイルのアクセス権限については，ファイルパーミッションに基づくチェックだけ行います。

2

各ファイルのアクセス権限について，ファイルパーミッション，アクセス制御リスト，およびセカンダリーグループの設定に基づいてチェックします。

デフォルトは「0」です。

詳細については，「16.32 ジョブ実行時のファイル権限チェックでアクセス制御リストやセカンダリーグループの設定を有効にする」を参照してください。

"GetPasswd_RetryCount"= dword:OSのパスワードファイルからユーザー情報の取得に失敗した場合にリトライする回数

OSのパスワードファイルからユーザー情報の取得に失敗した場合にリトライする回数を16進数で指定します。

0～0x000000A（10進数で0～10）の間で指定します。

デフォルトは「dword:00000002」（10進数で2）です。

「0」を指定した場合は，リトライしません。

通常，この値は変更する必要はありません。詳細については，「16.37 ユーザー情報取得時のリトライを変更する設定」を参照してください。

"GetPasswd_RetryInterval"= dword:OSのパスワードファイルからユーザー情報の取得に失敗した場合にリトライする間隔

OSのパスワードファイルからユーザー情報の取得に失敗した場合にリトライする間隔（単位：ミリ秒）を16進数で指定します。

0～0x0002710（10進数で0～10,000）の間で指定します。

デフォルトは「dword:000003E8」（10進数で1,000）です。

「0」を指定した場合は，すぐにリトライします。

通常，この値は変更する必要はありません。詳細については，「16.37 ユーザー情報取得時のリトライを変更する設定」を参照してください。

"NotfyJobStateInterval"=dword:ジョブの結果ファイルの再送間隔

ジョブの結果ファイルの再送間隔（単位：秒）を16進数で指定します。0～0x00015180（10進数で0～86,400）の間で指定します。最大値の0x00015180（10 進数で86,400 秒）は1日の秒数です。デフォルトは「dword:0000012C」（10進数で300）で5分です。結果ファイルの再送を行わないようにするには0を指定してください。詳細については，「16.15 ジョブの結果ファイルの再送間隔・再送回数の変更」を参照してください。

"NotfyJobStateCount"=dword:ジョブの結果ファイルの再送回数

ジョブの結果ファイルの再送回数を16進数で指定します。1～0x00000800（10進数で1～2,048）の間で指定します。デフォルトは「dword:00000120」（10進数で288）で288回です（デフォルトでは5分間隔で24時間再送します）。詳細については，「16.15 ジョブの結果ファイルの再送間隔・再送回数の変更」を参照してください。

"CommunicateTimeout"=dword:設定値

通信タイムアウト時間を16進数で指定します（単位：ミリ秒）。

指定できる範囲は000927c0～0036EE80（10進数で600000～3600000）です。

デフォルトは「000927c0（10進数で600000（10分））」です。

詳細については，「16.29 ジョブ実行制御のマネージャープロセスに対する通信タイムアウト時間の変更」を参照してください。

"MacroOptionReplaceMode"=dword: マクロ変数の引き継ぎ情報がNULL文字列の場合の置き換え方法の設定

前後に文字列がないマクロ変数の引き継ぎ情報がNULL文字列の場合に，マクロ変数名をNULL文字列に置き換えるかどうかを指定します。

0

マクロ変数名をNULL文字列に置き換えないで，指定されたマクロ変数名をそのままの文字列として使用します。

1

マクロ変数名をNULL文字に置き換えます。

デフォルトは「0」です。

詳細については，「16.20 マクロ変数の引き継ぎ情報がNULL文字列の場合の置き換え方法の設定」を参照してください。

"IsHA"=dword:ジョブ実行に使用するコマンドおよびスケジュール制御のクラスタ環境設定の定義

ジョブ実行に使用するコマンドおよびスケジュール制御のクラスタ環境設定の定義を指定します。このパラメーターは，クラスタ運用をやめる場合だけ設定してください。

00000000

クラスタ運用しない場合に指定します。

00000001

クラスタ運用する場合に指定します。クラスタシステム運用時のセットアップを実行すると，この値が自動的に設定されます。

デフォルトは「00000000（クラスタ運用しない）」です。

(3)　ジョブ実行環境のリソースを制限する場合の注意事項

ジョブ実行制御から実行するジョブのリソースを制限する場合，環境設定パラメーターに指定する値によっては，ジョブが正常に実行できなくなることがあるため，注意が必要です。例えば，スタックセグメントサイズの上限を0に設定すると，ジョブが実行できなくなる場合があります。

このため，余裕のある制限値を指定するか，または制限を設けないでください。制限を設ける場合は，事前にpsコマンドを実行し，セグメントサイズやCPU時間などを計測してから，指定する値を決定してください。

ただし，制限を設けない場合でも，リソースに対する制限がまったくなくなるわけではありません。この場合，JP1/AJS2が明示的に制限値を設定しないだけであり，システムのデフォルトの制限値（JP1/AJS2起動時の制限値）が有効になります。

なお，環境設定パラメーターの中にはOSによって制限をしていないものもあります。

デフォルトの制限値を超える値を指定した場合は，ジョブ実行ユーザーに適切な権限（スーパーユーザー権限）が必要です。ジョブ実行ユーザーに適切な権限（スーパーユーザー権限）がないときは，ジョブ実行時にリソース制限に失敗し，統合トレースログに警告メッセージKAVU3587-Wが出力されます。この場合，ジョブはデフォルトの制限値で実行されます。

なお，リソースの制限は，ジョブプロセスが生成した子プロセスにも反映されます（ただし，子プロセス側で独自に制限する場合は除きます）。

また，AIXおよびLinuxの場合，ジョブの実行ユーザーに対して，/etc/security/limits（Linuxの場合は/etc/security/limits.conf）でリソースの制限値の定義をしても，ジョブ実行時に値は有効になりません。JP1/AJS2起動時のユーザー（root）に対してリソース制限値を定義してください。詳細については，マニュアル「JP1/Automatic Job Management System 2 設計・運用ガイド　8.1.18 UNIXジョブ実行時のリソース制限値についての注意事項」を参照してください。

14.3　イベント起動に関する環境の設定

イベントジョブ起動に関する環境は，マネージャー環境（JP1/AJS2 - Manager）で設定する作業と，エージェント環境（JP1/AJS2 - Agent）で設定する作業があります。

イベントジョブ起動に関する環境のセットアップに使用する構成定義ファイル（イベント・アクション定義ファイル（EVAction.conf））には，環境設定に必要な情報が定義されています。情報を変更したい場合は，構成定義ファイルの内容（環境設定パラメーターの定義内容）を書き換えてください。

＜この節の構成＞

14.3.1　イベントジョブ起動に関する環境の設定手順

14.3.2　マネージャー環境（JP1/AJS2 - Manager）で設定する内容

14.3.3　エージェント環境（JP1/AJS2 - Agent）で設定する内容

14.3.1　イベントジョブ起動に関する環境の設定手順

イベントジョブ起動に関する環境のセットアップに使用する構成定義ファイル（イベント・アクション定義ファイル（EVAction.conf））には，環境設定に必要な情報が定義されています。情報を変更したい場合は，構成定義ファイルの内容（環境設定パラメーターの定義内容）を書き換えてください。

この項では，構成定義ファイルの内容（環境設定パラメーターの定義内容）を変更する手順を説明します。

なお，イベント・アクション定義ファイル（EVAction.conf）の内容については，「14.3.2 マネージャー環境（JP1/AJS2 - Manager）で設定する内容」または「14.3.3 エージェント環境（JP1/AJS2 - Agent）で設定する内容」を参照してください。

＜この項の構成＞

(1)　初期状態の構成定義情報を変更する場合の手順

(2)　設定済みの構成定義情報を利用して変更する場合の手順

(1)　初期状態の構成定義情報を変更する場合の手順

構成定義ファイルは，初期状態では推奨値で定義されています。初期状態の登録情報の変更手順を次に示します。

次のファイルをエディターで開く。
/etc/opt/jp1ajs2/conf/EVAction.conf

必要に応じて，イベントジョブの起動に関する環境を変更する。

編集した構成定義ファイルを保存する。

次のコマンドを実行する。

jbssetcnf 設定ファイル名

jbssetcnfコマンドのパスは，「/opt/jp1base/bin/jbssetcnf」です。
jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。
設定ファイルの内容が構成定義に反映されます。

(2)　設定済みの構成定義情報を利用して変更する場合の手順

定義情報ファイルは，現在設定されている登録情報から作成することもできます。現在設定されている登録情報の変更手順を次に示します。

次のコマンドを実行する。

jbsgetcnf [-h 論理ホスト名] > 退避ファイル名

jbsgetcnfコマンドのパスは，「/opt/jp1base/bin/jbsgetcnf」です。
jbsgetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。
現在設定されている定義情報が退避ファイルに退避されます。

手順1で取得した退避ファイルをviなどのエディターで開く。

構成定義パラメーターを変更または追加し，保存する。

次のコマンドを実行する。

jbssetcnf 退避ファイル名

jbssetcnfコマンドのパスは，「/opt/jp1base/bin/jbssetcnf」です。
jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。
変更した退避ファイルの内容が登録されます。

14.3.2　マネージャー環境（JP1/AJS2 - Manager）で設定する内容

この項では，マネージャー環境（JP1/AJS2 - Manager）で設定するイベント・アクション定義ファイル（EVAction.conf）の内容について説明します。

各パラメーターの推奨値と設定が有効になる時期については，マニュアル「JP1/Automatic Job Management System 2 設計・運用ガイド　5.3.3 イベントジョブ起動に関する環境設定について検討する」を参照してください。

＜この項の構成＞

(1)　イベント・アクション定義ファイル（JP1/AJS2 - Manager）の環境設定パラメーター一覧

(2)　イベント・アクション定義ファイル（JP1/AJS2 - Manager）の環境設定パラメーターの定義内容

(1)　イベント・アクション定義ファイル（JP1/AJS2 - Manager）の環境設定パラメーター一覧

イベント・アクション定義ファイルで定義する環境設定パラメーターの一覧を次の表に示します。

メールシステム連携で使用するパラメーターについては，マニュアル「JP1/Automatic Job Management System 2 連携ガイド　2.3.2 メール受信監視ジョブのための環境設定をする」を参照してください。

表14-6　環境設定パラメーター一覧（EVAction.conf・JP1/AJS2 - Manager）

定義キー | 環境設定パラメーター | 定義内容
[{JP1_DEFAULT|論理ホスト名}¥JP1AOMMANAGER]※ | "WaitInfFileOutDir"= | 待機情報ファイル出力ディレクトリ名（マネージャープロセスの設定）
"FileWriteMode"= | ファイル更新モード
"EvJobExecContinue"= | イベントジョブ実行継続オプション
[{JP1_DEFAULT|論理ホスト名}¥JP1AOMAGENT]※ | "WaitInfFileOutDir"= | 待機情報ファイル出力ディレクトリ名（エージェントプロセスの設定）
"EvjobInfFile"= | イベント・ジョブ情報引き継ぎディレクトリ名
"HowUseInfWhenHA"= | フェールオーバー時の情報引き継ぎ
"InformationWhenShutDown"= | シャットダウン時の情報引き継ぎ方法
"FilewatchinfContinue"= | ファイル監視ジョブの情報の引き継ぎ
"FileWriteMode"= | ファイル更新モード
"EVProcessHA"= | 詳細プロセス終了時オプション

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

(2)　イベント・アクション定義ファイル（JP1/AJS2 - Manager）の環境設定パラメーターの定義内容

環境設定パラメーターの定義内容の詳細を次に示します。

なお，環境設定パラメーターのデフォルトは，環境設定パラメーターを省略した場合の仮定値です。

また，詳細の記載がないパラメーターは保守用のパラメーターです。値は変更しないでください。

"WaitInfFileOutDir"="待機情報ファイル出力ディレクトリ名（マネージャープロセスの設定）"

イベントジョブの詳細情報や，起動条件で監視しているイベントの受信状態などの情報（待機情報）を出力するディレクトリの名称を180バイト以内の文字列で指定します。

ディレクトリ名はフルパスで指定します。ただし，標準のディレクトリを変更したい場合以外は指定する必要はありません。

この引数の指定を省略した場合，実行時に「/var/opt/jp1ajs2」が仮定されます。

なお，待機情報は，この項目で指定したディレクトリ，または仮定されたディレクトリの下の「sys/infodir」に出力されます。

"FileWriteMode"="{sync|nosync}"（マネージャープロセスの設定）

待機情報ファイルの更新時に，同期書き込みを実行するかどうかを指定します。

sync

ファイル更新時に，常に同期書き込みを実行します。この方法で書き込みを実行した場合，信頼性は向上しますが，性能は低下します。

nosync

JP1/AJS2での処理とは同期を取らないで，OSのバッファーリングによってディスクに書き込みます。「sync」に比べて性能は向上しますが，システムダウンが発生した場合，情報の不整合が発生し，イベントが消失するおそれがあります。

省略した場合，「nosync」が仮定されます。

注意

このパラメーターは，JP1AOMMANAGERとJP1AOMAGENTで同じ値を設定してください。特に，JP1AOMMANAGERを「nosync」，JP1AOMAGENTを「sync」に設定した場合，イベントジョブを使用したジョブネットや起動条件付きジョブネットの実行登録時，強制終了時，または先行ジョブに大量のイベントジョブを使用したORジョブが実行された場合などでは，JP1/AJS2の動作が極端に遅くなることがあります。また，同じ理由から，マネージャー・エージェント構成のシステムでも，マネージャーとエージェントで同じ設定にしてください。

"EvJobExecContinue"="{Y|N}"

実行ホストのJP1/AJS2のサービスを再起動したときに，イベントジョブの実行を継続するかどうかを指定します。

Y

イベントジョブの実行を継続します。

N

イベントジョブの実行を終了します。

省略した場合，「N」が仮定されます。

詳細については，「16.30 JP1/AJS2のサービスが停止してもイベントジョブの実行を継続させる設定」を参照してください。

"WaitInfFileOutDir"="待機情報ファイル出力ディレクトリ名（エージェントプロセスの設定）"

イベントジョブでのイベント発生状態や，起動条件で監視しているイベントの受信状態などの情報（待機情報）を出力するディレクトリの名称を180バイト以内の文字列で指定します。

ディレクトリ名はフルパスで指定します。ただし，標準のディレクトリを変更したい場合以外は指定する必要はありません。

この引数の指定を省略した場合，実行時に「/var/opt/jp1ajs2」が仮定されます。

なお，待機情報は，この項目で指定したディレクトリ，または仮定されたディレクトリの下の「sys/infoagt」に出力されます。

"EvjobInfFile"="イベント・ジョブ情報引き継ぎディレクトリ名"

メール受信監視ジョブやメッセージキュー受信監視ジョブで受信した情報をファイルで引き継ぐ場合，そのファイルを保存しておくディレクトリの名称を180バイト以内の文字列で指定します。

ディレクトリ名はフルパスで指定します。ただし，標準のディレクトリを変更したい場合以外は指定する必要はありません。

この引数の指定を省略した場合は，「/var/opt/jp1ajs2/sys/infoagt/tmp/infodir」に保存されます。このディレクトリに保存されるファイルは，JP1/AJS2では使用されません。また，自動的に削除されないので，不要になった場合は削除してください。

"HowUseInfWhenHA"="{Y|N}"

クラスタ運用時に，JP1/AJS2 - ManagerまたはJP1/AJS2 - Agentでフェールオーバーが発生した場合に，フェールオーバー先のJP1/AJS2 - ManagerまたはJP1/AJS2 - Agentに情報を引き継ぐかどうかを指定します。

Y

フェールオーバー発生時の状態を，切り替え後のJP1/AJS2 - ManagerまたはJP1/AJS2 - Agentに引き継ぎます。例えば，フェールオーバー発生前にJP1/AJS2 - Manager に通知できなかったイベントを，切り替え後に再度通知します。

N

フェールオーバー発生時の状態を，切り替え後のJP1/AJS2 - ManagerまたはJP1/AJS2 - Agentに引き継ぎません。例えば，フェールオーバー発生前にJP1/AJS2 - Manager に通知できなかったイベントは破棄されます。

省略した場合，「Y」が仮定されます。

通常は「Y」を使用してください。また，クラスタ運用をしない場合でも「Y」を使用してください。

"InformationWhenShutDown"="{K|B}"

JP1/AJS2 - ManagerホストまたはJP1/AJS2 - Agentホストがシャットダウン（停止処理を伴う終了）されたときに，シャットダウン前にJP1/AJS2 - Managerへ通知できなかったイベントを再度通知するかどうかを指定します。

K

シャットダウン後にJP1/AJS2 - ManagerまたはJP1/AJS2 - Agentを起動したときに，シャットダウン前にJP1/AJS2 - Managerへ通知できなかったイベントを再度通知します。例えば，シャットダウン前に発生していたイベントを，起動後にJP1/AJS2 - Managerに通知します（ただし，24時間以内にJP1/AJS2 - Managerが起動した場合に限ります）。

B

シャットダウン後にJP1/AJS2 - ManagerまたはJP1/AJS2 - Agentを起動したときに，シャットダウン前にJP1/AJS2 - Managerへ通知できなかったイベントを通知しません。例えば，シャットダウン前に発生していたイベントは破棄されます。電源ダウンの障害時だけ，情報を引き継ぎたいような場合に使用します。

省略した場合，「K」が仮定されます。

通常は「K」を使用してください。

"FilewatchinfContinue"="{Y|N}"

ファイル監視ジョブの実行中に，JP1/AJS2 - ManagerまたはJP1/AJS2 - Agentがシャットダウン（停止処理を伴う終了）されたときに，次回起動時にシャットダウン前のファイル監視ジョブの情報を引き継ぐかどうかを指定します。

Y

シャットダウン後にJP1/AJS2 - ManagerまたはJP1/AJS2 - Agentを起動したときに，シャットダウン前のファイル監視ジョブの監視状態を引き継ぎます。

N

シャットダウン後にJP1/AJS2 - ManagerまたはJP1/AJS2 - Agentを起動したときに，シャットダウン前のファイル監視ジョブの監視状態を引き継ぎません。

省略した場合，「N」が仮定されます。

このパラメーターは，JP1/AJS2の新規のインストール時および新規のセットアップ時に「Y」が設定されます。

"FileWriteMode"="{sync|nosync}"（エージェントプロセスの設定）

イベント・ジョブ情報，待機情報ファイルの更新時に，同期書き込みを実行するかどうかを指定します。

sync

ファイル更新時に，常に同期書き込みを実行します。この方法で書き込みを実行した場合，信頼性は向上しますが，性能は低下します。

nosync

JP1/AJS2での処理とは同期を取らないで，OSのバッファーリングによってディスクに書き込みます。「sync」に比べて性能は向上しますが，システムダウンが発生した場合，情報の不整合が発生し，イベントが消失するおそれがあります。

省略した場合，「nosync」が仮定されます。

注意

このパラメーターは，JP1AOMMANAGERとJP1AOMAGENTで同じ値を設定してください。特に，JP1AOMMANAGERを「nosync」，JP1AOMAGENTを「sync」に設定した場合，イベントジョブを使用したジョブネットや起動条件付きジョブネットの実行登録時，強制終了時，または先行ジョブに大量のイベントジョブを使用したORジョブが実行された場合などでは，JP1/AJS2の動作が極端に遅くなることがあります。また，同じ理由から，マネージャー・エージェント構成のシステムでも，マネージャーとエージェントで同じ設定にしてください。

"EVProcessHA"="{Y|N}"

イベント・アクション制御の詳細プロセスがシグナル終了した場合，イベント・アクション制御のエージェントプロセスを終了せず縮退運転するか，すべての詳細プロセスを停止して終了するかどうかを指定します。

Y

すべての詳細プロセスを停止してイベント・アクション制御のエージェントプロセスを終了します。

N

イベント・アクション制御のエージェントプロセスを終了せず縮退運転します。シグナルなどによって詳細プロセスの一部が終了した場合，終了した詳細プロセスで動作するイベントジョブ以外は使用できます。

省略した場合，「Y」が仮定されます。

このオプションはJP1/AJS2の再起動後に有効となります。

注意

異常終了したJP1/AJS2のプロセスを再起動させる設定を行っている場合，このパラメーターにYを設定しても，エージェントプロセスと詳細プロセスはJP1/AJS2のプロセスの再起動に伴って再起動されます。異常終了したJP1/AJS2のプロセスを再起動させる設定については，マニュアル「JP1/Automatic Job Management System 2 設計・運用ガイド　15.15.1 異常終了したJP1/AJS2のプロセスを再起動する」を参照してください。

このパラメーターにNを設定して，詳細プロセス終了時オプションを「無効」としている場合，異常終了している詳細プロセスに該当するジョブを実行登録する※と，そのジョブは異常終了します。
注※　例えば，jpocwtflMainプロセスが異常終了している状態でファイル監視ジョブを実行するなど。

14.3.3　エージェント環境（JP1/AJS2 - Agent）で設定する内容

この項では，エージェント環境（JP1/AJS2 - Agent）で設定するイベント・アクション定義ファイル（EVAction.conf）の内容について説明します。

各パラメーターの推奨値と設定が有効になる時期については，マニュアル「JP1/Automatic Job Management System 2 設計・運用ガイド　5.4.2 イベントジョブ起動に関する環境設定について検討する」を参照してください。

＜この項の構成＞

(1)　イベント・アクション定義ファイル（JP1/AJS2 - Agent）の環境設定パラメーター一覧

(2)　イベント・アクション定義ファイル（JP1/AJS2 - Agent）の環境設定パラメーターの定義内容

(1)　イベント・アクション定義ファイル（JP1/AJS2 - Agent）の環境設定パラメーター一覧

イベント・アクション定義ファイルで定義する環境設定パラメーターの一覧を次の表に示します。

メールシステム連携で使用するパラメーターについては，マニュアル「JP1/Automatic Job Management System 2 連携ガイド　2.3.2 メール受信監視ジョブのための環境設定をする」を参照してください。

表14-7　環境設定パラメーター一覧（EVAction.conf・JP1/AJS2 - Agent）

定義キー | 環境設定パラメーター | 定義内容
[{JP1_DEFAULT|論理ホスト名}¥JP1AOMAGENT]※ | "WaitInfFileOutDir"= | 待機情報ファイル出力ディレクトリ名（エージェントプロセスの設定）
"EvjobInfFile"= | イベント・ジョブ情報引き継ぎディレクトリ名
"HowUseInfWhenHA"= | フェールオーバー時の情報引き継ぎ
"InformationWhenShutDown"= | シャットダウン時の情報引き継ぎ方法
"FilewatchinfContinue"= | ファイル監視ジョブの情報の引き継ぎ
"FileWriteMode"= | ファイル更新モード
"EVProcessHA"= | 詳細プロセス終了時オプション

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

(2)　イベント・アクション定義ファイル（JP1/AJS2 - Agent）の環境設定パラメーターの定義内容

環境設定パラメーターの定義内容の詳細を次に示します。

なお，環境設定パラメーターのデフォルトは，環境設定パラメーターを省略した場合の仮定値です。

また，詳細の記載がないパラメーターは保守用のパラメーターです。値は変更しないでください。

"WaitInfFileOutDir"="待機情報ファイル出力ディレクトリ名（エージェントプロセスの設定）"

イベントジョブでのイベント発生状態や，起動条件で監視しているイベントの受信状態などの情報（待機情報）を出力するディレクトリの名称を180バイト以内の文字列で指定します。

ディレクトリ名はフルパスで指定します。ただし，標準のディレクトリを変更したい場合以外は指定する必要はありません。

この引数の指定を省略した場合，実行時に「/var/opt/jp1ajs2」が仮定されます。

なお，待機情報は，この項目で指定したディレクトリ，または仮定されたディレクトリの下の「sys/infoagt」に出力されます。

"EvjobInfFile"="イベント・ジョブ情報引き継ぎディレクトリ名"

メール受信監視ジョブやメッセージキュー受信監視ジョブで受信した情報をファイルで引き継ぐ場合，そのファイルを保存しておくディレクトリの名称を180バイト以内の文字列で指定します。

ディレクトリ名はフルパスで指定します。ただし，標準のディレクトリを変更したい場合以外は指定する必要はありません。

この引数の指定を省略した場合は，「/var/opt/jp1ajs2/sys/infoagt/tmp/infodir」に保存されます。このディレクトリに保存されるファイルは，JP1/AJS2では使用されません。また，自動的に削除されないので，不要になった場合は削除してください。

"HowUseInfWhenHA"="{Y|N}"

JP1/AJS2 - ManagerまたはJP1/AJS2 - Agentにフェールオーバーが発生したときに，フェールオーバー先のJP1/AJS2 - ManagerまたはJP1/AJS2 - Agentに情報を引き継ぐかどうかを指定します。

Y

フェールオーバー発生時の状態を，切り替え後のJP1/AJS2 - ManagerまたはJP1/AJS2 - Agentに引き継ぎます。例えば，フェールオーバー発生前にJP1/AJS2 - Manager に通知できなかったイベントを，切り替え後に再度通知します。

N

フェールオーバー発生時の状態を，切り替え後のJP1/AJS2 - ManagerまたはJP1/AJS2 - Agent に引き継ぎません。例えば，フェールオーバー発生前にJP1/AJS2 - Managerに通知できなかったイベントは破棄されます。

省略した場合，「Y」が仮定されます。

通常は「Y」を使用してください。また，クラスタ運用をしない場合でも「Y」を使用してください。

"InformationWhenShutDown"="{K|B}"

JP1/AJS2 - ManagerまたはJP1/AJS2 - Agentのホストがシャットダウン（停止処理を伴う終了）されたときに，シャットダウン前にJP1/AJS2 - Managerへ通知できなかったイベントを再度通知するかどうかを指定します。

K

シャットダウン後にJP1/AJS2 - ManagerまたはJP1/AJS2 - Agentを起動したときに，シャットダウン前にJP1/AJS2 - Manager へ通知できなかったイベントを再度通知します。例えば，シャットダウン前に発生していたイベントを，起動後にJP1/AJS2 - Managerに通知します（ただし，24時間以内にJP1/AJS2 - Managerが起動した場合に限ります）。

B

シャットダウン後にJP1/AJS2 - ManagerまたはJP1/AJS2 - Agentを起動したときに，シャットダウン前にJP1/AJS2 - Manager へ通知できなかったイベントを通知しません。例えば，シャットダウン前に発生していたイベントは破棄されます。電源ダウンの障害時だけ，情報を引き継ぎたいような場合に使用します。

省略した場合，「K」が仮定されます。

通常は「K」を使用してください。

"FilewatchinfContinue"="{Y|N}"

ファイル監視ジョブの実行中に，JP1/AJS2 - ManagerまたはJP1/AJS2 - Agentがシャットダウン（停止処理を伴う終了）されたときに，次回起動時にシャットダウン前のファイル監視ジョブの情報を引き継ぐかどうかを指定します。

Y

シャットダウン後にJP1/AJS2 - ManagerまたはJP1/AJS2 - Agentを起動したときに，シャットダウン前のファイル監視ジョブの監視状態を引き継ぎます。

N

シャットダウン後にJP1/AJS2 - ManagerまたはJP1/AJS2 - Agent を起動したときに，シャットダウン前のファイル監視ジョブの監視状態を引き継ぎません。

省略した場合，「N」が仮定されます。

このパラメーターは，JP1/AJS2の新規のインストール時および新規のセットアップ時に「Y」が設定されます。

"FileWriteMode"="{sync|nosync}"

イベント・ジョブ情報，待機情報ファイルの更新時に，同期書き込みを実行するかどうかを指定します。

sync

ファイル更新時に，常に同期書き込みを実行します。この方法で書き込みを実行した場合，信頼性は向上しますが，性能は低下します。

nosync

JP1/AJS2での処理とは同期を取らないで，OSのバッファーリングによってディスクに書き込みます。「sync」に比べて性能は向上しますが，システムダウンが発生した場合，情報の不整合が発生し，イベントが消失するおそれがあります。

省略した場合，「nosync」が仮定されます。

注意

このパラメーターは，マネージャーホストのJP1AOMMANAGERと同じ値を設定してください。特に，マネージャーホストのJP1AOMMANAGERを「nosync」，JP1AOMAGENTを「sync」に設定した場合，イベントジョブを使用したジョブネットや起動条件付きジョブネットの実行登録時，強制終了時，または先行ジョブに大量のイベントジョブを使用したORジョブが実行された場合などでは，JP1/AJS2の動作が極端に遅くなることがあります。

"EVProcessHA"="{Y|N}"

イベント・アクション制御の詳細プロセスがシグナル終了した場合，イベント・アクション制御のエージェントプロセスを終了せず縮退運転するか，すべての詳細プロセスを停止して終了するかどうかを指定します。

Y

すべての詳細プロセスを停止してイベント・アクション制御のエージェントプロセスを終了します。

N

イベント・アクション制御のエージェントプロセスを終了せず縮退運転します。シグナルなどによって詳細プロセスの一部が終了した場合，終了した詳細プロセスで動作するイベントジョブ以外は使用できます。

省略した場合，「N」が仮定されます。

このパラメーターは，JP1/AJS2の新規のインストール時および新規のセットアップ時に「Y」が設定されます。

このオプションはJP1/AJS2の再起動後に有効となります。

注意

異常終了したJP1/AJS2のプロセスを再起動させる設定を行っている場合，このパラメーターにYを設定しても，エージェントプロセスと詳細プロセスはJP1/AJS2のプロセスの再起動に伴って再起動されます。異常終了したJP1/AJS2のプロセスを再起動させる設定については，マニュアル「JP1/Automatic Job Management System 2 設計・運用ガイド　15.15.1 異常終了したJP1/AJS2のプロセスを再起動する」を参照してください。

このパラメーターにNを設定して，詳細プロセス終了時オプションを「無効」としている場合，異常終了している詳細プロセスに該当するジョブを実行登録する※と，そのジョブは異常終了します。
注※　例えば，jpocwtflMainプロセスが異常終了している状態でファイル監視ジョブを実行するなど。

14.4　キューレスジョブ実行環境の設定

キューレスジョブ実行環境を新規で設定する場合，環境設定前にajsqlsetupコマンドを実行してキューレスジョブ実行環境をセットアップする必要があります。マネージャー・エージェント構成の場合は，マネージャーとエージェントとで，それぞれajsqlsetupコマンドの実行が必要です。

ajsqlsetupコマンドの詳細については，「20. セットアップ時に使用するコマンド　ajsqlsetup」を参照してください。

キューレスジョブ実行環境は，キューレスエージェント環境（キューレスエージェントサービス）で設定します。

＜この節の構成＞

14.4.1　キューレスジョブ実行環境の設定手順

14.4.2　キューレスジョブ実行環境設定ファイルの環境設定パラメーター一覧

14.4.3　キューレスジョブ実行環境設定ファイルの環境設定パラメーターの定義内容

14.4.1　キューレスジョブ実行環境の設定手順

キューレスジョブ実行環境の設定時に使用する構成定義ファイル（キューレスジョブ実行環境設定ファイル（Queueless.conf））には，環境設定に必要な情報が定義されています。情報を変更したい場合は，構成定義ファイルの内容（環境設定パラメーターの定義内容）を書き換えてください。

この項では，構成定義ファイルの内容（環境設定パラメーターの定義内容）を変更する手順を説明します。

なお，ジョブ実行環境設定ファイル（Queueless.conf）の内容については，「14.4.2 キューレスジョブ実行環境設定ファイルの環境設定パラメーター一覧」または「14.4.3 キューレスジョブ実行環境設定ファイルの環境設定パラメーターの定義内容」を参照してください。

＜この項の構成＞

(1)　初期状態の構成定義情報を変更する場合の手順

(2)　設定済みの構成定義情報を利用して変更する場合の手順

(1)　初期状態の構成定義情報を変更する場合の手順

構成定義ファイルは，初期状態では推奨値で定義されています。初期状態の登録情報の変更手順を次に示します。

次のファイルをエディターで開く。

/etc/opt/jp1ajs2/conf/Queueless.conf

必要に応じて，キューレスジョブの実行環境を変更する。

編集した構成定義ファイルを保存する。

次のコマンドを実行する。

jbssetcnf 設定ファイル名

jbssetcnfコマンドのパスは，「/opt/jp1base/bin/jbssetcnf」です。
jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。
設定ファイルの内容が構成定義に反映されます。

(2)　設定済みの構成定義情報を利用して変更する場合の手順

定義情報ファイルは，現在設定されている登録情報から作成することもできます。現在設定されている登録情報の変更手順を次に示します。

次のコマンドを実行する。

jbsgetcnf [-h 論理ホスト名] > 退避ファイル名

jbsgetcnfコマンドのパスは，「/opt/jp1base/bin/jbsgetcnf」です。
jbsgetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。
現在設定されている定義情報が退避ファイルに退避されます。

手順1で取得した退避ファイルをviなどのエディターで開く。

構成定義パラメーターを変更または追加し，保存する。

次のコマンドを実行する。

jbssetcnf 退避ファイル名

jbssetcnfコマンドのパスは，「/opt/jp1base/bin/jbssetcnf」です。
jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。
変更した退避ファイルの内容が登録されます。

14.4.2　キューレスジョブ実行環境設定ファイルの環境設定パラメーター一覧

キューレスジョブ実行環境設定ファイルで定義する環境設定パラメーターの一覧を次の表に示します。

各パラメーターの推奨値と設定が有効になる時期については，マニュアル「JP1/Automatic Job Management System 2 設計・運用ガイド　5.4.3 キューレスジョブ実行環境に関する環境設定について検討する」を参照してください。

表14-8　環境設定パラメーター一覧（Queueless.conf）

定義キー | 環境設定パラメーター | 定義内容
[JP1_DEFAULT¥JP1AJSMANAGER]※1 | "QLMANCHARCODE"= | UTF-8環境のマネージャーからキューレスジョブを使用する運用で，UTF-8に対応していないエージェント（08-00より前のバージョンおよびLinux以外のプラットフォーム）で正しくジョブを実行するための設定
[JP1_DEFAULT¥JP1QLAGENT] | "AJSQL_JOBMAX"= | キューレスエージェントサービス内での最大同時ジョブ実行数
"AJSQL_CHARCODE"= | ジョブ情報およびジョブ出力結果の言語コード
"AJSQL_JOBWAITMAX"= | キューレスエージェントサービス内での最大待ちジョブ数
"AJSQL_NOATTACHREQ"= | アタッチされていない論理ホストへの実行要求時の処理
"AJSQL_EXECCURRENTSCRIPT"= | カレントパス上のスクリプトファイルの実行有無
"AJSQL_TRACELOGFILE"= | トレースログファイル名
"AJSQL_VARDQUOTEADD"= | 「$JP1AJS2_JPQTEMPxx$」変数変換時の処理
"AJSQL_CONNECTTIMEOUT"= | キューレスファイル転送サービスへの通信接続タイムアウト時間
"AJSQL_CONNECTCOUNT"= | キューレスファイル転送サービスへの通信接続リトライ回数
"AJSQL_CONNECTINT"= | キューレスファイル転送サービスへの通信接続リトライ間隔
"AJSQL_EXECLOG"= | キューレスジョブ実行内部ログ出力機能を有効にするかどうかの設定
"AJSQL_EXECLOG_FTPPATH"= | キューレスファイル転送サービスが出力するキューレスジョブ実行内部ログを格納するフォルダ名
"AJSQL_GETPASSWD_FTPRETRYCOUNT"= | キューレスファイル転送サービスでOSのパスワードファイルからユーザー情報の取得に失敗した場合にリトライする回数
"AJSQL_GETPASSWD_FTPRETRYINTERVAL"= | キューレスファイル転送サービスでOSのパスワードファイルからユーザー情報の取得に失敗した場合にリトライする間隔
[{JP1_DEFAULT|論理ホスト名}¥JP1QLAGENT]※2 | "AJSQL_LOGFILE"= | ログフォルダ名
"AJSQL_LOGSIZE"= | ログファイルサイズ
"AJSQL_STATFILE"= | ステータスファイル名
"AJSQL_STATSIZE"= | ステータスファイルサイズ
"AJSQL_ATTACH"= | キューレスエージェントサービス起動時に設定されている論理ホストのアタッチの可否
"AJSQL_EXECLOG_AGTPATH"= | キューレスエージェントサービスが出力するキューレスジョブ実行内部ログを格納するフォルダ名
"AJSQL_GETPASSWD_AGTRETRYCOUNT"= | キューレスエージェントサービスでOSのパスワードファイルからユーザー情報の取得に失敗した場合にリトライする回数
"AJSQL_GETPASSWD_AGTRETRYINTERVAL"= | キューレスエージェントサービスでOSのパスワードファイルからユーザー情報の取得に失敗した場合にリトライする間隔
"AJSQL_AGTWORKPATH"= | キューレスジョブで使用するワークパス，およびテンポラリーファイル用ディレクトリ
[{JP1_DEFAULT|論理ホスト名}¥JP1QLAGENT¥AJSQL_CLASS¥クラス名]※2 | "AJSQL_CJOBMAX"= | クラス内での最大同時ジョブ実行数
"AJSQL_CJOBWAITMAX"= | クラス内での最大待ちジョブ数

注※1

Linuxの場合だけ，指定できます。

注※2

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

14.4.3　キューレスジョブ実行環境設定ファイルの環境設定パラメーターの定義内容

環境設定パラメーターの定義内容の詳細を次に示します。

なお，詳細の記載がないパラメーターは保守用のパラメーターです。値は変更しないでください。

"QLMANCHARCODE"="{none|UTF-8}"

UTF-8環境のマネージャーからキューレスジョブを使用する運用で，UTF-8に対応していないエージェント（08-00より前のバージョンおよびLinux以外のプラットフォーム）で正しくジョブを実行させるために設定します。この環境設定パラメーターは，UTF-8をサポートしているLinux版のJP1/AJS2 - Managerの場合だけ有効です。その他の環境で指定された場合は無視されます。

08-00より前のバージョンおよびLinux以外のプラットフォームのキューレスエージェントでは，文字コード変換対象としてUTF-8をサポートしていません。この環境設定パラメーターに「UTF-8」を指定した場合，08-00より前のバージョンおよびLinux以外のプラットフォームのキューレスエージェントでも文字コードが正しく処理できるように，マネージャー側で文字コードの変換が実行されます。

なお，変換対象はキューレスジョブに関連するデータだけです。

none

マネージャー側で文字コード変換を行いません。すべての実行先キューレスエージェントが，UTF-8環境の場合にだけ指定してください。

UTF-8

マネージャー側でキューレスエージェントが対応している文字コードに変換して，キューレスエージェントと通信します。実行先キューレスエージェントに1台でもUTF-8以外の環境がある場合に指定してください。

デフォルトは「none」です。

また，キューレスジョブを一度もセットアップしていないLinux環境でajsqlsetupコマンドを実行すると，「UTF-8」が設定されます。

注意事項

この環境設定パラメーターに「UTF-8」を指定した場合，同一ホストで次に示す環境設定パラメーターを指定する必要があります。
[JP1_DEFAULT¥JP1QLAGENT]
"AJSQL_CHARCODE"=UTF-8

AJSCHARCODEはスケジューラーサービス単位で設定するのに対し，QLMANCHARCODEはマシンに一つ設定します。キューレスジョブを使用する場合は，すべてのスケジューラーサービスでAJSCHARCODEの設定を合わせて運用してください。

"AJSQL_JOBMAX"=dword:キューレスエージェントサービス内での最大同時ジョブ実行数

キューレスエージェントサービス内での最大同時ジョブ実行数を16進数で指定します。

0～400（10進数で0～1,024）の間で指定します。

デフォルトは「dword:400」（10進数で1,024）です。

ここで指定した値を超えた場合，超えた分については待ち状態になります（キューレスエージェントのメモリーに貯められます）。待ち状態にできるジョブの数の指定については，"AJSQL_JOBWAITMAX"=を参照してください。

"AJSQL_CHARCODE"="{none|C|SJIS|EUC|UTF-8}"

ジョブ情報やジョブ出力結果を表示する文字コードを指定します。

none

7ビットASCII文字コードを指定します。マネージャー・エージェント間で文字コード変換をしません。

C

7ビットASCII文字コードを指定します。マネージャー・エージェント間で文字コード変換をしません。

SJIS

シフトJISコードを指定します。

EUC

EUC文字コードを指定します。

UTF-8

UTF-8文字コードを指定します。

デフォルトは「none」です。

なお，ジョブ実行時の環境変数LANGはキューレスエージェントサービス起動時の環境変数LANGになります。

"AJSQL_JOBWAITMAX"=dword:キューレスエージェントサービス内での最大待ちジョブ数

キューレスエージェントサービス内での最大待ちジョブ数を16進数で指定します。

0～19000（10進数で0～102,400）の間で指定します。

デフォルトは「dword:00000000」です。

"AJSQL_NOATTACHREQ"="{exec|error}"

アタッチされていない論理ホストに対して実行要求があった場合の処理を指定します。

exec

物理ホストで処理します

error

エラーにします

デフォルトは「exec」です。

"AJSQL_EXECCURRENTSCRIPT"="{yes|no}"

相対パスでスクリプトファイルを指定した場合にジョブ実行時のカレントパス上に存在するスクリプトファイルの実行有無を指定します。

カレントパスとは，［ワークパス］指定時は指定したワークパス上，［ワークパス］未指定時はジョブ実行OSユーザーのホームディレクトリ上になります。

yes

カレントパス上に存在するスクリプトファイルを優先して実行します。

no

ジョブ実行時の環境変数PATH上から実行するスクリプトファイルを検索して実行します。

デフォルトは「no」です。

注意事項

"yes"を指定した場合，カレントパス上のスクリプトファイルを検索するため，ハードディスク障害などによってスクリプトファイルの存在チェックに失敗するとジョブは起動失敗となります。

"AJSQL_TRACELOGFILE"="トレースログファイル名"

キューレスエージェントのトレースログファイルの名称を255バイト以内の文字列で指定します。

ファイル名はフルパスで指定します。

セットアップ時に，次のファイル名で設定されます。

/var/opt/jp1ajs2/log/tracelog.ql

セットアップ後，トレースログファイル名に何も指定しないように設定を変更した場合は，トレース情報は出力されません。

"AJSQL_VARDQUOTEADD"="{yes|no}"

「$JP1AJS2_JPQTEMPxx$」変数変換時に，変換後の変数値を「"」で囲むかどうかを選択します。

yes

変換後の変数値を「"」で囲みます。

no

変換後の変数値を「"」で囲みません。

デフォルトは「yes」です。

このパラメーターの設定は物理ホスト，およびすべての論理ホストに対して有効になります。

"AJSQL_CONNECTTIMEOUT"=dword:通信接続タイムアウト時間

キューレスファイル転送サービスへの通信接続タイムアウト時間を16進数の00000000～00000258（10進数で0～600）（単位：秒）の間で指定します。

デフォルトは「dword:0000000A」（10進数で10）です。

「dword:00000000」を指定した場合は，OSの通信接続タイムアウト時間に依存して制御されます。

"AJSQL_CONNECTCOUNT"=dword:通信接続リトライ回数

キューレスファイル転送サービスへの通信接続処理で，通信エラーが発生したときの通信接続リトライ回数を16進数の00000000～00000064（10進数で0～100）（単位：秒）の間で指定します。

デフォルトは「dword:00000003」（10進数で3）です。

"AJSQL_CONNECTINT"=dword:通信接続リトライ間隔

キューレスファイル転送サービスへの通信接続処理で，通信エラーが発生したときの通信リトライ間隔を16進数の00000000～0000003C（10進数で0～60）（単位：秒）の間で指定します。

デフォルトは「dword:00000001」（10進数で1）です。

"AJSQL_EXECLOG"="{yes|no}"

キューレスジョブ実行内部ログ出力機能を有効にするかどうかを指定します。

yes

キューレスジョブ実行内部ログ出力機能を有効にします。

no

キューレスジョブ実行内部ログ出力機能を無効にします。

デフォルトは「yes」です。

"AJSQL_EXECLOG_FTPPATH"="キューレスファイル転送サービスが出力する内部ログを格納するディレクトリ名"

キューレスファイル転送サービスが出力する内部ログデータを格納するディレクトリの名称を，200バイト以内の文字列で指定します。

ディレクトリ名はフルパスで指定します。

デフォルトは「/var/opt/jp1ajs2/log」です。

注意事項

ローカルディスク上のディレクトリ名称を指定してください。

"AJSQL_GETPASSWD_FTPRETRYCOUNT"= dword:リトライ回数

キューレスファイル転送サービスでOSのパスワードファイルからユーザー情報の取得に失敗した場合にリトライする回数を16進数で指定します。

00000000～0000000A（10進数で0～10）の間で指定します。

デフォルトは「dword:00000002」（10進数で2）です。

「dword:00000000」を指定した場合は，リトライしません。

通常，この値は変更する必要はありません。

詳細については「16.37 ユーザー情報取得時のリトライを変更する設定」を参照してください。

"AJSQL_GETPASSWD_FTPRETRYINTERVAL"= dword:リトライ間隔

キューレスファイル転送サービスでOSのパスワードファイルからユーザー情報の取得に失敗した場合にリトライする間隔を16進数で指定します。

00000000～00002710（10進数で0～10,000）（単位：ミリ秒）の間で指定します。

デフォルトは「dword:000003E8」（10進数で1,000）です。

「dword:00000000」を指定した場合は，すぐにリトライします。

通常，この値は変更する必要はありません。

詳細については，「16.37 ユーザー情報取得時のリトライを変更する設定」を参照してください。

"AJSQL_LOGFILE"="ログフォルダ名"

実行したジョブの開始・終了メッセージを出力するログフォルダの名称を，180バイト以内の文字列で指定します。

フォルダ名はフルパスで指定します。

セットアップ時に，次のファイルが仮定されます。

物理ホストの場合

/var/opt/jp1ajs2/log

論理ホストの場合

共有ディレクトリ名/jp1ajs2/log

この項目を設定しない場合も，上記ファイルが仮定されます。

"AJSQL_LOGSIZE"=dword:ログファイルサイズ

ログファイルのサイズを16進数で指定します。

0または4～1E8480（10進数で0または4～2,000,000）（単位：キロバイト）の間で指定します。

デフォルトは「dword:00002000」（10進数で8,192）です。

ログファイルとして，ここで指定したサイズのファイルを2面（ファイル1，ファイル2）使用します。

注意

ここで指定したサイズの上限までファイル1に情報が書き込まれると，それ以上の情報はファイル2に書き込まれます。さらにファイル2でもサイズの上限まで情報が書き込まれると，再びファイル1に戻って情報を書き込みます。ファイル1→ファイル2→ファイル1→ファイル2を繰り返し，古い情報から上書きされていきますので，サイズの指定には注意が必要です。

"AJSQL_STATFILE"="ステータスファイル名"

実行中のジョブ情報を記憶するステータスファイルの名称を，255バイト以内の文字列で指定します。

ファイル名はフルパスで指定します。

キューレスエージェントのセットアップ時に，次のファイル名が設定されます。

物理ホストの場合

/var/opt/jp1ajs2/log/ajsqlstat.dat

論理ホストの場合

共有ディレクトリ名/jp1ajs2/log/ajsqlstat.dat

この項目を設定しない場合も，上記ファイルが仮定されます。

"AJSQL_STATSIZE"=dword:ステータスファイルサイズ

実行中のジョブ情報を記憶するステータスファイルのサイズを16進数で指定します。

ステータスファイルを使用した場合，実行元マネージャーにジョブ終了結果を伝える前に，実行元スケジューラーサービスおよび実行先キューレスエージェントで系切り替えが発生した場合でも，再起動後に実行元マネージャーにジョブの終了結果を伝えることができます。

0または4～1E8480（10進数で0または4～2,000,000）（単位：キロバイト）の間で指定します。1キロバイト当たり，約12ジョブの情報を保持します。

デフォルトは「dword:00000800」（10進数で2,048）です。

注意

この項目に0を設定した場合は，実行中のジョブ情報が記憶されないため，ジョブ実行中に実行元スケジューラーサービスで系切り替えが発生した場合などは，ジョブの状態が終了状態不明となります。

0以外を設定した場合，該当ジョブ自体は正常終了していても，ジョブの状態が「異常検出終了」となることがあります。これは，該当ジョブが標準エラー出力へ出力した内容を，エージェントホストからマネージャーホストへ転送する処理に失敗しているためです。この現象を避けるためには，エラー発生時以外での標準エラー出力への出力を行わないようにしてください。

"AJSQL_ATTACH"="{yes|no}"

キューレスエージェントサービス起動時に設定されている論理ホストをアタッチするかどうかを指定します。

yes

論理ホストをアタッチします。

no

論理ホストはアタッチしません。

使用する場合はサービス起動後にajsqlattachコマンドでアタッチしてください。

デフォルトは「no」です。

この項目は，論理ホストキーに指定がある場合だけ有効です。

"AJSQL_EXECLOG_AGTPATH"="キューレスエージェントサービスが出力する内部ログを格納するディレクトリ名"

キューレスエージェントサービスが出力する内部ログデータを格納するディレクトリの名称を，200バイト以内の文字列で指定します。

ディレクトリ名はフルパスで指定します。

デフォルトは次のとおりです。

物理ホストの場合
/var/opt/jp1ajs2/log

論理ホストの場合
共有ディレクトリ名/jp1ajs2/log

注意事項

ローカルディスク上のディレクトリ名称を指定してください。

クラスタ運用時は，名称が次のようになります。

キューレスエージェントサービスが出力する内部ログを格納するディレクトリ名称/ajsqlexeclog-[論理ホスト名]

ログファイル名称が256バイト以上である場合，[論理ホスト名]は論理ホスト名の先頭から30バイトとなります。

上記の条件を満たし，先頭から30バイトが同一名称である論理ホストが複数ある場合，該当する論理ホストの内部ログは，同一のファイルに出力されます。複数の論理ホストが同一のファイルに内部ログを出力する場合，キューレスジョブ起動性能の劣化，および内部ログの出力に失敗するおそれがあります。

複数の論理ホストが同一のファイルに内部ログを出力する場合は，それぞれの論理ホストのAJSQL_EXECLOG_AGTPATHに異なるディレクトリパスを指定し，異なるファイルに内部ログを出力させてください。なお，AJSQL_EXECLOG_AGTPATHをデフォルト以外の値に変更した場合，資料採取ツールの内容を編集する必要があります。詳細については，「17.1 ログ情報の採取方法」を参照してください。

"AJSQL_GETPASSWD_AGTRETRYCOUNT"= dword:リトライ回数

キューレスエージェントサービスでOSのパスワードファイルからユーザー情報の取得に失敗した場合にリトライする回数を16進数で指定します。

00000000～0000000A（10進数で0～10）の間で指定します。

デフォルトは「dword:00000002」（10進数で2）です。

「dword:00000000」を指定した場合は，リトライしません。

通常，この値は変更する必要はありません。

詳細については，「16.37 ユーザー情報取得時のリトライを変更する設定」を参照してください。

"AJSQL_GETPASSWD_AGTRETRYINTERVAL"= dword:リトライ間隔

キューレスエージェントサービスでOSのパスワードファイルからユーザー情報の取得に失敗した場合にリトライする間隔を16進数で指定します。

00000000～00002710（10進数で0～10,000）（単位：ミリ秒）の間で指定します。

デフォルトは「dword:000003E8」（10進数で1,000）です。

「dword:00000000」を指定した場合は，すぐにリトライします。

通常，この値は変更する必要はありません。

詳細については，「16.37 ユーザー情報取得時のリトライを変更する設定」を参照してください。

"AJSQL_AGTWORKPATH"="キューレスジョブで使用するワークパスおよびテンポラリーファイル用ディレクトリ名"

キューレスジョブで使用するワークパス，およびテンポラリーファイル用ディレクトリの名称を，100バイト以内の文字列で指定します。

ディレクトリ名はフルパスで指定します。

デフォルトは次のとおりです。

物理ホストの場合
/var/opt/jp1ajs2/tmp

論理ホストの場合
共有ディレクトリ名/jp1ajs2/tmp

"AJSQL_CJOBMAX"=dword:クラス内での最大同時ジョブ実行数

そのクラスで同時実行を許すジョブの最大数を16進数で指定します。

00000000～00000400（10進数で0～1,024）の間で指定します。

デフォルトは「dword:00000400」（10進数で1,024）です。

詳細については，「7.15 キューレスジョブ環境でクラスを指定したジョブを実行するための設定」（Windowsの場合）または「16.12 キューレスジョブ環境でクラスを指定したジョブを実行するための設定」（UNIXの場合）を参照してください。

"AJSQL_CJOBWAITMAX"=dword:クラス内での最大待ちジョブ数

そのクラスでの最大同時ジョブ実行数を超えたときに，キューレスエージェント上のメモリーに蓄えておくジョブの最大数を16進数で指定します。

0～19000（10進数で0～102,400）の間で指定します。

デフォルトは「dword:00000000」です。

詳細については，「7.15 キューレスジョブ環境でクラスを指定したジョブを実行するための設定」（Windowsの場合）または「16.12 キューレスジョブ環境でクラスを指定したジョブを実行するための設定」（UNIXの場合）を参照してください。

14.5　JP1/AJS2 Console環境の設定

自動運用している業務を集中監視するJP1/AJS2 Consoleの環境設定は，JP1/AJS2 Console Manager環境とJP1/AJS2 Console Agent環境では異なります。

それぞれの環境で設定する内容を次に示します。

＜この節の構成＞

14.5.1　JP1/AJS2 Console Manager環境の設定

14.5.2　JP1/AJS2 Console Agent環境の設定

14.5.1　JP1/AJS2 Console Manager環境の設定

JP1/AJS2 Console Manager環境のセットアップに使用する構成定義ファイル（JP1/AJS2 Console Manager環境設定ファイル（ajs2cm.conf））には，環境設定に必要な情報が定義されています。情報を変更したい場合は，構成定義ファイルの内容（環境設定パラメーターの定義内容）を書き換えてください。

各パラメーターの推奨値と設定が有効になる時期については，マニュアル「JP1/Automatic Job Management System 2 設計・運用ガイド　5.3.5(1) JP1/AJS2 Console Managerの環境設定」を参照してください。

この項では，JP1/AJS2 Console Manager環境の設定手順および設定内容を説明します。

＜この項の構成＞

(1)　JP1/AJS2 Console Manager環境の設定手順

(2)　JP1/AJS2 Console Manager環境で設定する内容

(1)　JP1/AJS2 Console Manager環境の設定手順

構成定義ファイル（環境設定パラメーター）は，初期状態では推奨値で定義されています。必要に応じて，JP1/AJS2 Console Managerの環境を設定し直してください。

JP1/AJS2 Console Manager環境の設定手順を次に示します。

JP1/AJS2 Console Managerのサービスを停止する。
次のコマンドを実行します。

# /etc/opt/jp1ajs2cm/ajscminetd_startstop stop

次のファイルをviなどのエディターで開く。

/etc/opt/jp1ajs2cm/conf/ajs2cm.conf

必要に応じて，JP1/AJS2 Console Managerの環境を変更する。

ファイルを保存し，次のコマンドを実行する。

jbssetcnf ファイル名

jbssetcnfコマンドのパスは，「/opt/jp1base/bin/jbssetcnf」です。
jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/AJS2 Console Managerサービスを再起動する。
次のコマンドを実行します。

# /etc/opt/jp1ajs2cm/ajscminetd_startstop start

変更した内容が構成定義に反映されます。

注意

JP1/Baseを前提製品とするJP1シリーズのプログラムが稼働中の場合には，jbssetcnfコマンドを実行する前に，JP1シリーズのプログラムを終了させてください。

(2)　JP1/AJS2 Console Manager環境で設定する内容

(a)　JP1/AJS2 Console Manager環境設定ファイルの環境設定パラメーター一覧

JP1/AJS2 Console Managerは，定義キー［JP1_DEFAULT¥JP1AJS2CONSOLEMANAGER］に構成定義情報を設定できます。論理ホストを使用する場合でも，DATADIRECTORYキー以外の構成定義パラメーターは，JP1_DEFAULTホストキーの値が使用されます。

JP1/AJS2 Console Manager環境設定ファイルで定義する環境設定パラメーターの一覧を次の表に示します。

表14-9　環境設定パラメーター一覧（ajs2cm.conf）

環境設定パラメーター
内容およびデフォルト値

"MAXSESSION"=
最大同時セション数
デフォルトは「dword:00000010」（10進数で16）。

"IPC_TIMEOUT"=
リモート通信タイムアウト時間
デフォルトは「dword:00000000」。

"IPCRETRYINTERVAL"=
リトライ間隔
デフォルトは「dword:00000001」。

"IPCRETRYCOUNT"=
リトライ回数
デフォルトは「dword:00000003」。

"SESSIONTIMEOUT"=
接続打ち切り時間
デフォルトは「dword:00000078」（10進数で120）。

"CHARCODE"=
ユーザー定義データに格納される情報の文字コード
セットアップを実行すると，次の内容で設定されます。
Solaris：EUC
Linux：UTF-8
その他のOS：SJIS

"SYSLOGCODE"=
ログファイル出力時の文字コード

"HNTRLOGLEVEL"=
統合トレースログに出力するメッセージレベル
デフォルトは「error」。

"DATADIRECTORY"=
ルートスコープ用データディレクトリ名
デフォルトは「/var/opt/jp1ajs2cm/database」。

"RECONNECTINTERVAL"=
JP1/AJS2 Console Agentへの再接続間隔
デフォルトは「dword:0000012C」（10進数で300）です。

"TRACELOGFILE"=
JP1/AJS2 Console Managerのトレースログファイル名
デフォルトは「/var/opt/jp1ajs2cm/log/tracelog.cm」。

"IPC_CONNECTTIMEOUT"=
リモート通信接続タイムアウト値
デフォルトは「dword:00000014」（10進数で20）。

注意

構成定義パラメーターのDATADIRECTORYの指定に誤りがある場合は，JP1/AJS2 Console Viewでのログイン時にエラーになります。DATADIRECTORY以外の構成定義パラメーターの指定に誤りがある場合は，JP1/AJS2 Console Managerの標準設定で動作します。

(b)　JP1/AJS2 Console Managerの環境設定パラメーターの定義内容

環境設定パラメーターの定義内容の詳細を次に示します。

"MAXSESSION"=dword:最大同時セション数

JP1/AJS2 Console Viewの最大接続数を16進数で指定します。

指定できる範囲は，0～40（10進数で0～64）です。

デフォルトは「dword:00000010」（10進数で16）です。

JP1/AJS2 Console Viewの接続数がここで指定した値を超える場合は，エラーになります。

"IPC_TIMEOUT"=dword:通信タイムアウト時間

JP1/AJS2 Console Agentと通信するときのタイムアウト時間（秒）を16進数で指定します。

指定できる範囲は，0～258（10進数で0～600）です。

デフォルトは「dword:00000000」（10進数で0）です。

ここで指定した時間（秒）待っても通信できない場合は，エラーになります。なお，この場合OSのタイムアウト時間に依存して制御されます。

"IPCRETRYINTERVAL"=dword:リトライ間隔

通信エラー時のリトライ間隔（秒）を16進数で指定します。

指定できる範囲は，0～A（10進数で0～10）です。

デフォルトは「dword:00000001」（10進数で1）です。

リトライが発生するたびに，ここで指定した値分が加算されます。

"IPCRETRYCOUNT"=dword:リトライ回数

通信エラー時のリトライ回数を16進数で指定します。

指定できる範囲は，0～64（10進数で0～100）です。

デフォルトは「dword:00000003」（10進数で3）です。

"SESSIONTIMEOUT"=dword:接続打ち切り時間

JP1/AJS2 Console Viewとの通信が切れた場合にどのくらい待って（分）接続を打ち切るのかを16進数で指定します。

指定できる範囲は，1～78（10進数で1～120）です。

デフォルトは「dword:00000078」（10進数で120）です。

"CHARCODE"="{C|SJIS|EUC|UTF-8}"

ネスト業務スコープ・監視オブジェクトの名称や定義内容で使用する文字コードを指定します。

SJIS

シフトJISコード

C

7ビットASCII文字コード

EUC

EUC文字コード

UTF-8

UTF-8文字コード

文字コードは一つだけ定義してください。何も指定しなかった場合は，「C」が仮定されます。

"SYSLOGCODE"="{C|環境変数LANG}"

syslogファイルに出力するメッセージの言語種別を指定します。

C

英語ASCIIコードで出力されます。

環境変数LANG（「C」以外の文字列）

JP1/AJS2 Console Managerサービスを起動したときの環境変数LANGの設定に従います。

ただし，JP1/AJS2 Console Managerサービスの環境変数LANGに対応する言語種別のメッセージがsyslogファイルに出力されないシステムもあります。その場合は，このパラメーターには必ず「C」を指定してください。使用しているシステムで日本語出力ができるかどうかについては，loggerコマンドなどで日本語メッセージを出力し，syslogファイルに正しく出力されているかどうかを確認してください。

環境変数LANGの値はOSによって異なります。

指定できる環境変数LANGの値を次の表に示します。

表14-10　指定できる環境変数LANG（JP1/AJS2 Console Manager）

OS
シフトJISを設定する
環境変数の値
EUCを設定する
環境変数の値
UTF-8を設定する
環境変数の値

HP-UX
ja_JP.SJIS
ja_JP.eucJP
使用できません

Solaris
ja_JP.PCK
ja
使用できません

AIX
Ja_JP
ja_JP
使用できません

Linux
使用できません
ja_JP.eucJP
ja_JP.UTF-8

"HNTRLOGLEVEL"="{none|error|warn|info}"

統合トレースログに出力するメッセージレベルを次の中から選択して指定します。

none

どのメッセージも出力されません。

error

エラーメッセージが出力されます。

warn

警告メッセージが出力されます。

info

情報メッセージが出力されます。

デフォルトは「error」です。

"DATADIRECTORY"="データディレクトリパス"

ルートスコープの定義情報を格納するディレクトリ名を191バイト以内で指定します。

ディレクトリ名は，完全名で指定します。

デフォルトは「/var/opt/jp1ajs2cm/database」です。

変更する場合は，その時点ですでに存在するディレクトリを指定してください。新たなデータディレクトリを指定する場合は，先にディレクトリを作成してから指定してください。存在しないディレクトリを指定した場合は，JP1/AJS2 Console Viewのログイン時にエラーになります。

なお，ここで指定したディレクトリ内のファイルは，削除しないでください。

"RECONNECTINTERVAL"=dword:JP1/AJS2 Console Agentとの再接続間隔

JP1/AJS2 Console Agentと接続できなかった場合に再接続するまでの間隔（秒）を16進数で指定します。

指定できる範囲は，1E～E10（10進数で30～3,600）です。

デフォルトは「dword:0000012C」（10進数で300）です。

"TRACELOGFILE"="トレースログファイル名称"

トレースログファイル名称を完全名，かつ255バイト以内で指定します。

トレース情報を確実に記録できるように必ずローカルディスク上のファイル名として指定してください。

デフォルトは「/var/opt/jp1ajs2cm/log/tracelog.cm」です。

なお，ファイルはトレース情報が出力されたときに新規作成されます。したがって，既存のファイル名と同じ名称は指定しないでください。

"IPC_CONNECTTIMEOUT"=dword:リモート通信接続タイムアウト値

JP1/AJS2 Console Agentに接続する場合などのリモート通信接続タイムアウト値を16進数で指定します。0～258（10進数で0～600）（単位：秒）の値を指定します。デフォルトは「dword:00000014」（10進数で20）です。

なお，OSで設定されているTCP/IPの接続タイムアウト値がこの値より短い場合，OSの設定が有効になります。

14.5.2　JP1/AJS2 Console Agent環境の設定

JP1/AJS2 Console Agent環境のセットアップに使用する構成定義ファイル（JP1/AJS2 Console Agent環境設定ファイル（ajs2ca.conf））には，環境設定に必要な情報が定義されています。情報を変更したい場合は，構成定義ファイルの内容（環境設定パラメーターの定義内容）を書き換えてください。

各パラメーターの推奨値と設定が有効になる時期については，マニュアル「JP1/Automatic Job Management System 2 設計・運用ガイド　5.3.5(2) JP1/AJS2 Console Agentの環境設定」を参照してください。

この項では，JP1/AJS2 Console Agent環境の設定手順および設定内容を説明します。

＜この項の構成＞

(1)　JP1/AJS2 Console Agent環境の設定手順

(2)　JP1/AJS2 Console Agent環境で設定する内容

(1)　JP1/AJS2 Console Agent環境の設定手順

構成定義ファイル（環境設定パラメーター）は，初期状態では推奨値で定義されています。必要に応じて，JP1/AJS2 Console Agentの環境を設定し直してください。

JP1/AJS2 Console Agent環境の設定手順を次に示します。

JP1/AJS2 Console Agentのサービスを停止する。
次のコマンドを実行して，psコマンドなどでプロセスがすべて停止していることを確認します。

# /etc/opt/jp1ajs2/ajscainetd_startstop stop

次のファイルをviなどのエディターで開く。

/etc/opt/jp1ajs2/conf/ajs2ca.conf

必要に応じて，JP1/AJS2 Console Agentの環境を変更する。

ファイルを保存し，次のコマンドを実行する。

jbssetcnf ファイル名

jbssetcnfコマンドのパスは，「/opt/jp1base/bin/jbssetcnf」です。
jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/AJS2 Console Agentのサービスを再起動する。
次のコマンドを実行します。

# /etc/opt/jp1ajs2/ajscainetd_startstop start

変更した内容が構成定義に反映されます。

注意

JP1/Baseを前提製品とするJP1シリーズのプログラムが稼働中の場合には，jbssetcnfコマンドを実行する前に，JP1シリーズのプログラムを終了させてください。

(2)　JP1/AJS2 Console Agent環境で設定する内容

(a)　JP1/AJS2 Console Agentの環境設定パラメーター一覧

JP1/AJS2 Console Agentは，定義キー［JP1_DEFAULT¥JP1AJS2CONSOLEAGENT］に構成定義情報を設定できます。論理ホストのオブジェクトを監視する場合でも，構成定義パラメーターはJP1_DEFAULTホストキーの下に設定してください。

JP1/AJS2 Console Agent環境設定ファイルで定義する環境設定パラメーターの一覧を次の表に示します。

表14-11　環境設定パラメーター一覧（ajs2ca.conf）

環境設定パラメーター
内容およびデフォルト値

"MAXSESSION"=
最大同時セション数
デフォルトは「dword：00000010」（10進数で16）。

"SYSLOGCODE"=
ログファイル出力時の文字コード

"HNTRLOGLEVEL"=
統合トレースログに出力するメッセージレベル
デフォルトは「error」。

"TRACELOGFILE"=
JP1/AJS2 Console Agentのトレースログファイル名
デフォルトは「/var/opt/jp1ajs2/log/tracelog.ca」。

"ENABLEOPERATION"=
操作機能の許可
デフォルトは「yes」。

注意

構成定義パラメーターの指定に誤りがある場合は，JP1/AJS2 Console Agentの標準設定で動作します。

(b)　JP1/AJS2 Console Agentの環境設定パラメーターの定義内容

環境設定パラメーターの定義内容の詳細を次に示します。

"MAXSESSION"=dword:最大同時セション数

JP1/AJS2 Console Managerの最大接続数を16進数で指定します。

指定できる範囲は，0～40（10進数で0～64）です。

デフォルトは「dword：00000010」（10進数で16）です。

JP1/AJS2 Console Managerからの接続数がここで指定した値を超える場合は，エラーになります。

"SYSLOGCODE"="{C|環境変数LANG }"

UNIX環境で，JP1/AJS2 Console Agentがsyslogファイルに出力するメッセージの言語種別を指定します。

C

英語ASCIIコードで出力されます。

環境変数LANG（「C」以外の文字列）

JP1/AJS2 Console Agentサービスを起動したときの環境変数LANGの設定に従います。ただし，JP1/AJS2 Console Agentサービスの環境変数LANGに対応する言語種別のメッセージがsyslogファイルに出力されないシステムもあります。その場合は，このパラメーターには必ず「C」を指定してください。使用しているシステムで日本語出力ができるかどうかについては，loggerコマンドなどで日本語メッセージを出力し，syslogファイルに正しく出力されているかどうかを確認してください。

環境変数LANGの値はOSによって異なります。

指定できる環境変数LANGの値を次の表に示します。

表14-12　指定できる環境変数LANG（JP1/AJS2 Console Agent）

OS
シフトJISを設定する
環境変数の値
EUCを設定する
環境変数の値
UTF-8を設定する
環境変数の値

HP-UX
ja_JP.SJIS
ja_JP.eucJP
使用できません

Solaris
ja_JP.PCK
ja
使用できません

AIX
Ja_JP
ja_JP
使用できません

Linux
使用できません
ja_JP.eucJP
ja_JP.UTF-8

"HNTRLOGLEVEL"="{none|error|warn|info}"

JP1/AJS2 Console Agentサービスが統合トレースログに出力するメッセージレベルを次の中から選択して指定します。

none

どのメッセージも出力されません。

error

エラーメッセージが出力されます。

warn

警告メッセージが出力されます。

info

情報メッセージが出力されます。

デフォルトは「error」です。

"TRACELOGFILE"="トレースログファイル名称"

トレースログファイル名称を完全名，かつ255バイト以内で指定します。トレース情報を確実に記録できるように必ずローカルディスク上のファイル名として指定してください。

なお，ファイルはトレース情報が出力されたときに新規作成されます。したがって，既存のファイル名と同じ名称は指定しないでください。

デフォルトは「/var/opt/jp1ajs2/log/tracelog.ca」です。

"ENABLEOPERATION"="{yes|no}"

JP1/AJS2 Console Viewによる操作機能を許可するかどうかを指定します。

yes

JP1/AJS2 Console Viewによる操作機能を許可します。

no

JP1/AJS2 Console Viewによる操作機能を許可しません。

デフォルトは「yes」です。

14.6　JP1/AJS2共通情報の設定

JP1/AJS2共通情報の設定は，マネージャー環境（JP1/AJS2 - Manager）とエージェント環境（JP1/AJS2 - Agent）で共通です。

JP1/AJS2共通情報のセットアップに使用する構成定義ファイル（共通情報環境設定ファイル（Common.conf））には，環境設定に必要な情報が定義されています。情報を変更したい場合は，構成定義ファイルの内容（環境設定パラメーターの定義内容）を書き換えてください。

＜この節の構成＞

(1)　JP1/AJS2共通情報の設定手順

(2)　共通情報環境設定ファイルの環境設定パラメーター一覧

(3)　定義内容

(1)　JP1/AJS2共通情報の設定手順

次のファイルをエディターで開く。

/etc/opt/jp1ajs2/conf/Common.conf

必要に応じて，JP1/AJS2共通情報を変更する。

編集した構成定義ファイルを保存する。

次のコマンドを実行する。

jbssetcnf /etc/opt/jp1ajs2/conf/Common.conf

jbssetcnfコマンドのパスは，「/opt/jp1base/bin/jbssetcnf」です。
jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。
設定ファイルの内容が構成定義に反映されます。

(2)　共通情報環境設定ファイルの環境設定パラメーター一覧

共通情報環境設定ファイルで定義する環境設定パラメーターの一覧を次の表に示します。

表14-13　環境設定パラメーター一覧（Common.conf）

定義キー | 環境設定パラメーター | 定義内容
[{JP1_DEFAULT|論理ホスト名}¥JP1AJS2COMMON] | "SYSLOGJOBMSG"= | ジョブ・イベントジョブのエラーメッセージをsyslogにも出力するかどうかの設定
"MACROCHANGEFAIL"= | イベントジョブ，および実行登録時に指定したマクロ変数の展開失敗時の動作
"LARGEFILEUSE"= | ラージファイル対応の動作

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

(3)　定義内容

"SYSLOGJOBMSG" ="{none|error}"

ジョブ・イベントジョブのジョブ実行時に発生するエラーメッセージをsyslogにも出力するかどうかを指定します。

none

ジョブ・イベントジョブのジョブ実行時に発生するエラーメッセージをsyslogに出力しません。JP1/AJS2の状態は，日立統合トレースログで監視します。

error

ジョブ・イベントジョブのジョブ実行時に発生するエラーメッセージをsyslogに出力します。JP1/AJS2のエラー状態は，syslogで監視します。なお，このオプションを指定しても，日立統合トレースログプロセスは停止しないでください。

デフォルトは「none」です。

なお，スケジューラーサービスの設定でJOBSYSLOG（ジョブ実行開始・終了メッセージのsyslogへの出力）が指定されていない場合に，"SYSLOGJOBMSG"="error"を指定したときはsyslogへメッセージが出力されます。動作としては"JOBSYSLOG"="abend"（ジョブの異常終了メッセージ（KAVS0265-E）を出力）が仮定されます。また，すでにJOBSYSLOGに値が指定されていた場合は，JOBSYSLOGの値が優先されます。

"MACROCHANGEFAIL"="{yes|no}"

ジョブ実行時，マクロ変数の引き継ぎ情報の展開に失敗した場合に，状態を「起動失敗」にするかどうかを指定します。

yes

ジョブ実行時，マクロ変数の引き継ぎ情報の展開に失敗した場合に，状態を「起動失敗」にし，展開に失敗したマクロ変数が確認できるエラーメッセージを日立統合ログおよび実行結果詳細に出力します。

no

ジョブ実行時，マクロ変数の引き継ぎ情報の展開に失敗しても，マクロ変数に定義した情報をそのまま文字列として扱い，処理を続行します。

デフォルトは「no」です。

"LARGEFILEUSE"="{yes|no}"

ファイル監視ジョブでラージファイルを監視，および判定ジョブでラージファイルを判定するかどうかを指定します。

yes

ファイル監視ジョブでサイズが2ギガバイト以上のファイルを監視，および判定ジョブでサイズが2ギガバイト以上のファイルの有無を判定できます。

no

ファイル監視ジョブで，サイズが2ギガバイト以上のファイルは監視できません。「no」を指定して，2ギガバイト以上のファイルを監視対象に指定した場合，ファイル監視ジョブの実行時にエラーメッセージが統合トレースログに出力され，ジョブは異常終了します。ただし，実行ホストのOSがLinux（IPF）の場合，エラーメッセージの出力やジョブの異常終了はしませんが，ファイル変更の誤検知などの不正な動作をするおそれがあります。このため，監視対象ファイルには2ギガバイト以上のファイルを指定しないでください。

判定ジョブでサイズが2ギガバイト以上のファイルの有無を判定できません。「no」を指定して，2ギガバイト以上のファイルを判定条件で指定した場合，OSがLinux（IPF）以外の場合は常にファイルがないものとして判定されます。

デフォルトは「no」です。

14.7　そのほかの設定

ここでは，次に示す設定手順について説明します。

スケジューラーサービスの多重起動の設定
ルートジョブグループを管理するスケジューラーサービスの多重起動ができます。多重起動させると，ルートジョブグループをサービスごとに管理できるようになります。

JP1/AJS2サービスの自動起動および自動終了の設定
システムの起動・終了時に，JP1/AJS2サービス（デーモン）も自動的に起動・終了できます。

ISAMファイル自動再編成機能の設定
JP1/AJS2サービスの起動時に，該当する物理ホストおよび論理ホストで使用するISAMデータファイルを自動的に再編成できます。

スケジューラーサービスの統合トレースログ出力レベルの変更
スケジューラーサービスが統合トレースログに出力するメッセージのレベルを指定できます。

ネストジョブネット定義パラメーター出力時のスケジュールルールの出力方法の変更
スケジュールルールを有効にして上位ジョブネットのスケジュールに依存しないようにするのか，またはスケジュールルールを削除して上位ジョブネットのスケジュールに依存するようにするのかを指定できます。

スケジューラートレースログファイルの名称変更
スケジューラーサービスのトレースログファイル名をデフォルトから任意のファイル名に変更できます。

JP1/AJS2 - Managerの運用方法をサブミットジョブの登録や操作に限定するときの設定
JP1/AJS2 - Managerでジョブネットによるジョブの操作をしない場合，ジョブ実行制御のコマンドを使用したサブミットジョブの登録や操作に限定できます。

サスペンド機能の設定
実行登録中にルートジョブネットの下位定義を編集する場合に必要なサスペンド機能を有効にします。

登録解除や保存世代数管理による世代削除処理方式の変更
保存世代数に大きい値を設定しているジョブネットに対して登録解除の操作をすると，登録が解除されるまでに時間が掛かってしまうことがあります。これを回避するため登録解除の処理を非同期型に設定できます。

スケジューラーサービスをウォームスタートで起動させたときに，実行中であったジョブまたはジョブネットの終了メッセージ，および終了イベントの出力有無の設定

JP1/AJS2定義内容の事前チェック機能の設定
JP1/AJS2では，本番運用時に障害の発生を抑えるため，ジョブの定義内容に不正がないかどうかを本番運用の開始前にチェックできます。このチェック機能を有効にします。

ジョブネットコネクタで異なるスケジューラーサービス間のルートジョブネットの実行順序を制御するための設定
ジョブネットコネクタで異なるスケジューラーサービス間のルートジョブネットの実行順序を制御できるようにします。

＜この節の構成＞

14.7.1　スケジューラーサービスの多重起動の設定

14.7.2　JP1/AJS2サービスの自動起動および自動終了の設定

14.7.3　ISAMファイル自動再編成機能の設定

14.7.4　スケジューラーサービスの統合トレースログ出力レベルの変更

14.7.5　ネストジョブネット定義パラメーター出力時のスケジュールルールの出力方法の変更

14.7.6　スケジューラートレースログファイルの名称変更

14.7.7　JP1/AJS2 - Managerの運用方法をサブミットジョブの登録や操作に限定するときの設定

14.7.8　サスペンド機能の設定

14.7.9　登録解除や保存世代数管理による世代削除処理方式の変更

14.7.10　スケジューラーサービスをウォームスタートで起動させたときに，実行中であったジョブまたはジョブネットの終了メッセージ，および終了イベントの出力有無の設定

14.7.11　JP1/AJS2定義内容の事前チェック機能の設定

14.7.12　ジョブネットコネクタで異なるスケジューラーサービス間のルートジョブネットの実行順序を制御するための設定

14.7.1　スケジューラーサービスの多重起動の設定

スケジューラーサービスは，ジョブグループを管理する制御単位です。多重起動させると，ジョブグループをサービスごとに管理できるようになります。

スケジューラーサービスの多重起動を設定するためには，まず，追加するサービスの名称などの情報を設定します。次に，そのサービス用のデータベースを新規に作成します。

スケジューラーサービスの多重起動の設定手順，および追加したスケジューラーサービスの削除手順を次に示します。

論理ホストへのスケジューラーサービスの追加，および論理ホストに追加したスケジューラーサービスの削除については，「18.4.7 論理ホストのスケジューラーサービスの多重起動の設定」を参照してください。

＜この項の構成＞

(1)　スケジューラーサービスを多重起動する

(2)　追加したスケジューラーサービスを削除する

(1)　スケジューラーサービスを多重起動する

スケジューラーサービスの多重起動の設定手順を次に示します。

JP1/AJS2のサービスを停止する。
次のコマンドを実行して，プロセスがすべて停止していることを確認します。

# /etc/opt/jp1ajs2/jajs_stop
# /opt/jp1ajs2/bin/jajs_spmd_status

次のファイルをviなどのエディターで開く。

/etc/opt/jp1ajs2/conf/Schedule.conf

Schedule.conf（スケジューラーサービス環境設定ファイル）に書かれている内容の詳細については，「14.1.2 スケジューラーサービス環境設定ファイルの環境設定パラメーター一覧」または「14.1.3 スケジューラーサービス環境設定パラメーターの定義内容」を参照してください。

スケジューラーサービスの多重起動のために必要な項目を追加する。
Schedule.confの[JP1_DEFAULT¥JP1AJSMANAGER¥AJSROOT1]の内容を参考にして，追加するスケジューラーサービスの環境を設定します。設定内容は，ファイルの最後に追加します。
なお，退避情報ディレクトリ（環境設定パラメーターAJSBKUROOTで設定するディレクトリ）以外は，自ホスト内（物理ホストとすべての論理ホスト）に設定されている，ほかのスケジューラーサービスが使用するディレクトリと重複しないようにしてください。また，ほかのスケジューラーサービスが使用するディレクトリの配下にも設定しないでください。

（例）「AJSROOT2」というサービスを追加する場合

　[JP1_DEFAULT¥JP1AJSMANAGER¥AJSROOT2]
　"AJSBKUROOT"="/var/opt/jp1ajs2/backup/schedule2"
　"AJSCHARCODE"="SJIS"
　"AJSDBDIRECTORY"="/var/opt/jp1ajs2/database/schedule/AJSROOT2"
　"AJSDBTYPE"="ISAM"
　"AJSLOG"="all"
　"AJSSERVICEID"=dword:00000002
　"AJSSYSLOG"="none"
　"AJSTMPDIR"="/var/opt/jp1ajs2/tmp/schedule2"
　"AUTOSTART"="yes"
　"EXECDEFER"="oneday"
　"HNTRLOGLEVEL"="error"
　"ISAMWRITEMODE"="flush"
　"JOBINFDIR"="/var/opt/jp1ajs2/jobinf2"
　"JOBLOG"="all"
　"JOBSTATUSPORT"="jp1ajs2report2"
　"JOBSYSLOG"="none"
　"NETLOG"="all"
　"NETSYSLOG"="none"
　"OPELOG"="all"
　"OVERSCHEDULE"="exec"
　"RDBAUTHID"=""
　"RDBUSER"=""
　"SESSIONTIMEOUT"=dword:00000078
　"STARTMODE"="warm"
　"SUPPRESS"="none"
　"SYSLOGCODE"="C"
　"TABLENAMEPOSTFIX"=""
　"TABLENAMEPREFIX"="AJS"

ファイルを保存し，次のコマンドを実行する。

jbssetcnf 設定ファイル名

jbssetcnfコマンドのパスは，「/opt/jp1base/bin/jbssetcnf」です。
jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

手順3で設定したディレクトリをmkdirコマンドなどで作成する。

手順3のJOBSTATUSPORTパラメーターに指定したジョブ状態通知ポートのサービス名に対するポート番号を設定する。
/etc/servicesファイルをエディターなどで開き，ポート番号を追加します。このとき，既存のポート番号と重複しないようにしてください。

（例）ポート番号を「20248」として設定する場合

jp1ajs2report2 20248/tcp

次のコマンドを実行して，追加したスケジューラーサービス用のJP1/AJS2データベースを作成する。

ajssetup -F [スケジューラーサービス名]

（例）「AJSROOT2」というサービスのデータベースを作成する場合

ajssetup -F AJSROOT2

キューレスジョブを利用する場合は，キューレスジョブのセットアップをする。
次のコマンドを実行します。

ajsqlsetup -F [スケジューラーサービス名]

組み込みDBを使用する場合は組み込みDBに移行する。
組み込みDBセットアップツール（ajsembdbsetupスクリプト）を使用して，標準データベースを組み込みDBに移行します。

JP1/AJS2サービスを再起動する。
設定した内容でスケジューラーサービスが追加され，起動します。

多重起動時のコマンド実行についての補足事項

スケジューラーサービスを多重起動している場合，「-F サービス名」オプションを指定しないでコマンドを実行すると，デフォルトのスケジューラーサービスに対する操作となります。

環境変数AJSCONFにサービス名を指定しておくと，-Fオプションを省略できます。

(2)　追加したスケジューラーサービスを削除する

追加したスケジューラーサービスの削除手順を次に示します。

jajs_spmd_stopコマンドを実行して，JP1/AJS2サービスを停止する。
論理ホストのJP1/AJS2マネージャーも含め，すべてのJP1/AJS2サービスを停止してください。

次に示すコマンドを実行して，JP1/AJS2 Monitorサービスを停止する。

ajsinetd_startstop stop

ajsinetd_startstopコマンドのパスは，「/etc/opt/jp1ajs2/ajsinetd_startstop」です。

ajsshmdelコマンドを実行して，環境設定情報を削除する。
ajsshmdelコマンドのパスは，「/opt/jp1ajs2/bin/ajsshmdel」です。
（例）shの場合

　/opt/jp1ajs2/bin/ajsshmdel >/dev/null 2>&1

（例）cshの場合

　/opt/jp1ajs2/bin/ajsshmdel >&/dev/null

スケジューラーサービスを追加したときに作成したディレクトリを削除する。

物理ホストまたは論理ホストの環境設定情報をファイルに退避する。
次に示すコマンドを実行します。

jbsgetcnf [-h 論理ホスト名] > 退避ファイル名

物理ホストの場合は，-hオプションを指定しないでください。
jbsgetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

削除するスケジューラーサービスの名称を指定し，環境設定情報から削除する。
次に示すコマンドを実行します。

jbsunsetcnf -h 論理ホスト名 -c JP1AJSMANAGER
           -n 削除するスケジューラーサービス名

物理ホストからスケジューラーサービスを削除する場合は，「論理ホスト名」の部分に「JP1_DEFAULT」と入力します。
jbsunsetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/AJS2サービスを起動する。
追加したスケジューラーサービスが削除されます。

14.7.2　JP1/AJS2サービスの自動起動および自動終了の設定

システムの起動・終了時に，JP1/AJS2サービス（デーモン）も自動的に起動・終了できます。

＜この項の構成＞

(1)　JP1/AJS2サービス（JP1/AJS2 - Manager）の自動起動および自動終了を設定する

(2)　JP1/AJS2サービス（JP1/AJS2 - Agent）の自動起動および自動終了を設定する

(3)　JP1/AJS2 Consoleサービスの自動起動および自動終了を設定する

(4)　キューレスエージェントサービス，キューレスファイル転送サービスの自動起動および自動終了を設定する

(5)　JP1/AJS2 Check Managerサービス，JP1/AJS2 Check Agentサービスの自動起動および自動終了を設定する

(6)　JP1/AJS2の自動起動時にJP1/AJS2のプロセスの状態を出力する

(7)　メモリー不足時のプロセス動作設定（AIX限定）

(8)　環境変数JP1_HOSTNAMEに依存しないJP1/AJS2サービスの自動起動および自動終了を設定する

(9)　組み込みDBの自動起動および自動終了を設定する

(1)　JP1/AJS2サービス（JP1/AJS2 - Manager）の自動起動および自動終了を設定する

ここでは，JP1/AJS2サービス（JP1/AJS2 - Manager）の自動起動および自動終了を設定する方法を説明します。

(a)　JP1/AJS2サービス（JP1/AJS2 - Manager）の自動起動を設定する

システムの起動時に，JP1/AJS2サービス（デーモン）も自動的に起動させる手順を次に示します。

次のファイルをviなどのエディターで開く。

/etc/opt/jp1ajs2/jajs_start

ファイル（自動起動用シェルスクリプト）に記述されている，次の網掛け部分を削除する。

削除する際は，削除する前に，内容を確認してください。
なお，「: # WAIT_READY=YES」のコメントを削除すると，JP1/AJS2 - Managerサービスの起動を待てるようになります。ただし，この設定をするとOSの起動時間が遅くなります。OSの起動を優先させたい場合は，このコメントを削除しないでください。
「WAIT_READY=YES」のコメントを削除した場合には，サービスの起動順序の制御が行えます。JP1/AJS2サービスの起動を待って，JP1/AJS2 Monitorサービスを起動することで，JP1/AJS2サービス起動時の自動再編成が排他エラーで失敗するのを防ぐことができます。
次に示す，JP1/AJS2 Monitorを起動する記述を，

 if [ -x /etc/opt/jp1ajs2/ajsinetd_startstop ] ; then
   : （省略）
   fi
 fi

サービス起動を待つ処理

 WAIT_READY=YES
 if [ "$WAIT_READY" = "YES" ] ; then
   : （省略）
 fi

の後ろへ移動させてください。
修正後は，次のようになります。

if [ -x /opt/jp1ajs2/bin/jajs_spmd ] ; then
 :（省略）
 WAIT_READY=YES
 if [ "$WAIT_READY" = "YES" ] ; then
   : （省略）
 fi
 if [ -x /etc/opt/jp1ajs2/ajsinetd_startstop ] ; then
   : （省略）
   fi
 fi
fi
exit 0

これでJP1/AJS2サービスの自動起動の設定は完了です。

(b)　RDB接続待ち合わせ機能の設定を変更し，JP1/AJS2サービス（JP1/AJS2 - Manager）の自動起動を設定する

最大待ち合わせ時間を変更したい場合や，RDB接続待ち合わせ機能を無効にしたい場合には以下の設定が必要です。

なお，JP1/AJS2を07-10以前のバージョンからバージョンアップした場合，組み込みDB共にRDB接続待ち合わせ機能はデフォルトで適用されます。

jbsgetcnfを実行して，ファイルに構成定義を取得する。

1で取得した構成定義の[{JP1_DEFAULT|論理ホスト名}¥JP1AJSMANAGER¥対象スケジューラーサービス名]下の，次の定義を変更する。
（例）物理ホストのスケジューラーサービスAJSROOT1に変更する場合

[JP1_DEFAULT¥JP1AJSMANAGER¥AJSROOT1]
"RDBCONNECTWAITTIME"=dword:00000001

RDBCONNECTWAITTIMEの値は，0～3C（10進数で0～60）（単位：分）の範囲で指定してください。「0」を指定した場合，RDB接続待ち合わせ機能は無効になります。

2で修正したファイルを使ってjbssetcnfを実行する。

注意

クラスタ環境でRDB接続待ち合わせ機能を使用する場合は，実行系および待機系のそれぞれで上記の設定を行います。そのとき，指定する値は実行系，待機系で同じ値を指定してください。

RDB接続待ち合わせ機能を使用する場合は，JP1/AJS2のOS起動時の自動起動を有効にします。有効にするには，/etc/opt/jp1ajs2/jajs_startファイルで，以下の行の網掛け部分を削除する必要があります。

さらに，次の設定も確認が必要です。

物理ホストの場合
OSの再起動時，「WAIT_READY=YES」（jajs_spmdの起動完了を待つ）が有効のまま，RDB接続待ち合わせ機能を使用すると，スケジューラーサービスの起動に失敗します。RDB接続待ち合わせ機能を使用したいときは，「: # WAIT_READY=YES」と指定し，行を無効にしてください。

論理ホストの場合
「WAIT_READY=YES」が有効でも問題ありません。

これで設定は完了です。次回JP1/AJS2起動時から設定が有効になります。

注意事項

OS起動時に，スケジューラーサービスの起動に失敗し，KAVS0999-W（待ち合わせ開始メッセージ），KAVS0998-E（待ち合わせ失敗メッセージ）が出力されている場合，次に示すことを確認してください。

組み込みDBはセットアップされているか。
スケジューラーサービスに指定した組み込みDBが起動していない場合，接続を待ち合わせてもデータベースに接続できません。
セットアップ時に，問題なくスケジューラーサービスが起動できていることを確認してください。

組み込みDBの定義を変更していないか。
組み込みDBをセットアップ後に起動方法を変更すると，OS起動時に組み込みDBが起動しなくなることがあります。その場合は，セットアップ時の値に戻してください。

前回の終了時に，組み込みDBが異常終了していないか。
ジョブ実行中などに組み込みDBが異常終了した場合，次回の起動に時間が掛かることがあります。その場合，デフォルトの最大待ち合わせ時間内に組み込みDBが起動しないことがありますので，ジョブ実行中に組み込みDBを強制停止しないでください。

jajs_startファイルの「: # WAIT_READY=YES」行の「: #」が削除されていないか。
「: #」が削除されている場合は，「: #」を追加して行を無効にしてください。

組み込みDBの起動に時間が掛かる場合，事前にどの程度掛かるかがわかっているときは，起動時間に応じて最大接続待ち合わせ時間を変更してください。

(c)　JP1/AJS2サービス（JP1/AJS2 - Manager）の自動終了を設定する

システムの終了時に，JP1/AJS2サービス（デーモン）も自動的に終了させる手順を次に示します。

次のファイルをviなどのエディターで開く。

/etc/opt/jp1ajs2/jajs_stop

ファイル（自動停止用シェルスクリプト）に記述されている，次の網掛け部分を削除する。

削除する際は，削除する前に内容を確認してください。なお，「：# WAIT READY=YES」のコメントを削除すると，JP1/AJS2 - Managerサービスの終了を待てるようになります。ただし，この設定をするとOSの停止時間が遅くなります。OSの停止を優先させたい場合は，このコメントを削除しないでください。

これでJP1/AJS2サービスの自動終了の設定は完了です。

(2)　JP1/AJS2サービス（JP1/AJS2 - Agent）の自動起動および自動終了を設定する

ここでは，JP1/AJS2 サービス（JP1/AJS2 - Agent）の自動起動および自動終了を設定する方法を説明します。

(a)　JP1/AJS2サービス（JP1/AJS2 - Agent）の自動起動を設定する

システムの起動時に，JP1/AJS2サービス（デーモン）も自動的に起動させる手順を次に示します。

次のファイルをviなどのエディターで開く。

/etc/opt/jp1ajs2/jajs_start

ファイル（自動起動用シェルスクリプト）に記述されている，次の網掛け部分を削除する。

削除する際は，削除する前に，内容を確認してください。
なお，「: # WAIT_READY=YES」のコメントを削除すると，JP1/AJS2 - Agentサービスの起動を待てるようになります。ただし，この設定をするとOSの起動時間が遅くなります。OS起動を優先させたい場合は，このコメントを削除しないでください。

これでJP1/AJS2サービスの自動起動の設定は完了です。

(b)　JP1/AJS2サービス（JP1/AJS2 - Agent）の自動終了を設定する

システムの終了時に，JP1/AJS2サービス（デーモン）も自動的に終了させる手順を次に示します。

次のファイルをviなどのエディターで開く。

/etc/opt/jp1ajs2/jajs_stop

ファイルに記述されている，次の網掛け部分を削除する。

削除する際は，削除する前に，内容を確認してください。なお，「：# WAIT READY=YES」のコメントを削除すると，JP1/AJS2 - Agentサービスの終了を待てるようになります。ただし，この設定をするとOSの停止時間が遅くなります。OSの停止を優先させたい場合は，このコメントを削除しないでください。

これでJP1/AJS2サービスの自動終了の設定は完了です。

(3)　JP1/AJS2 Consoleサービスの自動起動および自動終了を設定する

JP1/AJS2 Consoleサービスをシステムの起動時に開始させたり，JP1/AJS2 Consoleサービスを自動終了させたりするためには，自動起動用スクリプトおよび自動終了用スクリプトの設定が必要です。

JP1/AJS2 Consoleサービスには，JP1/AJS2 Console ManagerサービスとJP1/AJS2 Console Agentサービスがあり，サービスごとに設定が必要です。

(a)　JP1/AJS2 Console Managerサービスの自動起動および自動終了を設定する

JP1/AJS2 Console Managerサービスの自動起動および自動終了の設定方法について説明します。

JP1/AJS2 Console Managerサービスの自動起動を設定する
JP1/AJS2 Console Managerサービスをシステムの起動時に開始するために，自動起動スクリプトを設定します。設定手順を次に示します。

viなどのエディターで次のファイルを開く。
/etc/opt/jp1ajs2cm/jajscm_start

ファイルに記述されている，次の網掛け部分を削除する。

削除する際は，削除する前に，内容を確認してください。

ファイルを閉じる。

JP1/AJS2 Console Managerサービスの自動終了を設定する
JP1/AJS2 Console Managerサービスの自動終了スクリプトの設定手順を次に示します。

viなどのエディターで次のファイルを開く。
/etc/opt/jp1ajs2cm/jajscm_stop

ファイルに記述されている，次の網掛け部分を削除する。

削除する際は，削除する前に，内容を確認してください。

ファイルを閉じる。

(b)　JP1/AJS2 Console Agentサービスの自動起動および自動終了を設定する

JP1/AJS2 Console Agentサービスの自動起動および自動終了の設定方法について説明します。

JP1/AJS2 Console Agentサービスの自動起動を設定する
JP1/AJS2 Console Agentサービスをシステムの起動時に開始するために，自動起動スクリプトを設定します。設定手順を次に示します。

viなどのエディターで次のファイルを開く。
/etc/opt/jp1ajs2/jajsca_start

ファイルに記述されている，次の網掛け部分を削除する。

削除する際は，削除する前に，内容を確認してください。

ファイルを閉じる。

JP1/AJS2 Console Agentサービスの自動終了を設定する
JP1/AJS2 Console Agentサービスの自動終了スクリプトの設定手順を次に示します。

viなどのエディターで次のファイルを開く。
/etc/opt/jp1ajs2/jajsca_stop

ファイルに記述されている，次の網掛け部分を削除する。

削除する際は，削除する前に，内容を確認してください。

ファイルを閉じる。

(4)　キューレスエージェントサービス，キューレスファイル転送サービスの自動起動および自動終了を設定する

キューレスエージェントサービス，キューレスファイル転送サービスをシステムの起動時に開始させたり，自動終了させたりするためには，自動起動用スクリプトおよび自動終了用スクリプトの設定が必要です。

キューレスファイル転送サービスは，JP1/AJS2 - Managerにしか存在しないため，JP1/AJS2 - Agentでの設定は不要です。

(a)　キューレスエージェントサービスの自動起動および自動終了を設定する

キューレスエージェントサービスの自動起動および自動終了の設定方法について説明します。

キューレスエージェントサービスの自動起動を設定する
キューレスエージェントサービスをシステムの起動時に開始するために，自動起動スクリプトを設定します。設定手順を次に示します。

viなどのエディターで次のファイルを開く。
/etc/opt/jp1ajs2/jajs_start

ファイルに記述されている，次の網掛け部分を削除する。

削除する際は，削除する前に，内容を確認してください。

ファイルを閉じる。

キューレスエージェントサービスの自動終了を設定する
キューレスエージェントサービスの自動終了スクリプトの設定手順を次に示します。

viなどのエディターで次のファイルを開く。
/etc/opt/jp1ajs2/jajs_stop

ファイルに記述されている，次の網掛け部分を削除する。

削除する際は，削除する前に，内容を確認してください。

ファイルを閉じる。

(b)　キューレスファイル転送サービスの自動起動および自動終了を設定する

キューレスファイル転送サービスの自動起動および自動終了の設定方法について説明します。

キューレスファイル転送サービスの自動起動を設定する
キューレスファイル転送サービスをシステムの起動時に開始するために，自動起動スクリプトを設定します。設定手順を次に示します。

viなどのエディターで次のファイルを開く。
/etc/opt/jp1ajs2/jajs_start

ファイルに記述されている，次の網掛け部分を削除する。

削除する際は，削除する前に，内容を確認してください。

ファイルを閉じる。

キューレスファイル転送サービスの自動終了を設定する
キューレスファイル転送サービスの自動終了スクリプトの設定手順を次に示します。

viなどのエディターで次のファイルを開く。
/etc/opt/jp1ajs2/jajs_stop

ファイルに記述されている，次の網掛け部分を削除する。

削除する際は，削除する前に，内容を確認してください。

ファイルを閉じる。

(5)　JP1/AJS2 Check Managerサービス，JP1/AJS2 Check Agentサービスの自動起動および自動終了を設定する

JP1/AJS2 Check Managerサービス，JP1/AJS2 Check Agentサービスの自動起動および自動終了の設定方法について説明します。

(a)　JP1/AJS2 Check Managerサービス，JP1/AJS2 Check Agentサービスの自動起動を設定する

JP1/AJS2 Check Managerサービス，JP1/AJS2 Check Agentサービスをシステムの起動時に開始するために，自動起動スクリプトを設定します。設定手順を次に示します。

viなどのエディターで次のファイルを開く。
/etc/opt/jp1ajs2/jajs_start

ファイルに記述されている，次の網掛け部分を削除する。

削除する際は，削除する前に，内容を確認してください。

ファイルを閉じる。

(b)　JP1/AJS2 Check Managerサービス，JP1/AJS2 Check Agentサービスの自動終了を設定する

JP1/AJS2 Check Managerサービス，JP1/AJS2 Check Agentサービスの自動終了スクリプトの設定手順を次に示します。

viなどのエディターで次のファイルを開く。
/etc/opt/jp1ajs2/jajs_stop

ファイルに記述されている，次の網掛け部分を削除する。

削除する際は，削除する前に，内容を確認してください。

ファイルを閉じる。

(6)　JP1/AJS2の自動起動時にJP1/AJS2のプロセスの状態を出力する

JP1/AJS2の自動起動時に，JP1/AJS2のプロセスの状態を出力できます。JP1/AJS2の自動起動時にJP1/AJS2のプロセスの状態を出力させるには，自動起動スクリプトを設定します。設定手順を次に示します。

viなどのエディターで次のファイルを開く。
/etc/opt/jp1ajs2/jajs_start

ファイルに記述されている，次の網掛け部分を削除する。

削除する際は，削除する前に，内容を確認してください。

注意事項

自動起動時のプロセス状態を出力する場合は，「:# WAIT_READY=YES」のコメントを削除しておく必要があります。

ファイルを閉じる。

(7)　メモリー不足時のプロセス動作設定（AIX限定）

AIXでは，メモリー不足が発生するとOSがSIGKILLを発行し，JP1/AJS2のプロセスが終了することがあります。この現象を回避するには，環境変数にPSALLOC=earlyを設定し，JP1/AJS2を起動してください。

なお，環境変数PSALLOCにearlyを設定する場合には，同時に環境変数NODISCLAIM=trueを設定する必要があります。

自動起動スクリプト中に設定する例を次に示します。

自動スクリプト中の次の部分を検索する。

unset LC_MESSAGES

手順1で検索した行の前に，次の部分を追加する。

------------------------- ここから
PSALLOC=early
NODISCLAIM=true
export PSALLOC NODISCLAIM
------------------------- ここまでを追加
unset LC_MESSAGES
: # unset JP1_HOSTNAME
cd /opt/jp1ajs2/bin

(8)　環境変数JP1_HOSTNAMEに依存しないJP1/AJS2サービスの自動起動および自動終了を設定する

環境変数JP1_HOSTNAMEが設定されている環境で，環境変数JP1_HOSTNAMEに依存しないでJP1/AJS2サービスを自動起動および自動終了させる方法を次に示します。

viなどのエディターで次のファイルを開く。

(a) JP1/AJS2サービスの自動起動を設定する場合

/etc/opt/jp1ajs2/jajs_start

(b) JP1/AJS2サービスの自動終了を設定する場合

/etc/opt/jp1ajs2/jajs_stop

ファイルに記述されている，次の網掛けの部分を削除する。

削除する際は，削除する前に，内容を確認してください。

ファイルを閉じる。

(9)　組み込みDBの自動起動および自動終了を設定する

組み込みDBの自動起動および自動終了の設定方法について説明します。

ajsembdbstartコマンドおよびajsembdbstopコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 2 コマンドリファレンス　1. コマンド」を参照してください。

(a)　組み込みDBの自動起動を設定する

システムの起動時に，組み込みDBを自動的に起動させる手順を次に示します。

ajsembdbbuildコマンド実行時に，-rオプションまたは-fオプションを指定しないで組み込みDBを構築した場合は，システム共通定義のpd_mode_confオペランドに「AUTO」が設定されるため，変更する必要はありません。pd_mode_confオペランドの詳細については，マニュアル「JP1/Automatic Job Management System 2 設計・運用ガイド　5.7.1 システム定義」を参照してください。

JP1/AJS2サービス，JP1/AJS2 Monitorサービス，およびJP1/AJS2 Console Agentサービスなど，組み込みDBにアクセスするサービスをすべて停止する。

ajsembdbstopコマンドを実行し，組み込みDBを停止する。

システム共通定義ファイル（組み込みDB運用ディレクトリ/conf/pdsys）をviなどのエディターで開き，次のように設定値をAUTOに変更する。

pd_mode_conf = AUTO

ajsembdbstartコマンドを実行し，組み込みDBを起動する。

手順1で停止したサービスを起動する。

(b)　組み込みDBの自動終了を設定する

システムの終了時に，組み込みDBを自動的に終了させる手順を次に示します。

次のファイルをviなどのエディターで開く。

/etc/opt/jp1ajs2/jajs_stop

ファイルに記述されている，次の網掛けの部分を削除する。

組み込みDB停止処理を追加する。
次に示す組み込みDB停止処理を，他のJP1/AJS2サービス停止処理の後に追加します。

 if [ -x /opt/jp1ajs2/tools/ajsembdbstop ] ; then
   /opt/jp1ajs2/tools/ajsembdbstop
 fi

修正後は，次のようになります。

 #! /bin/sh
 ## JP1/Automatic Job Management System 2
   : （省略）
   if [ -x /opt/jp1ajs2/bin/ajsqlftpstop ] ; then
     : # /opt/jp1ajs2/bin/ajsqlftpstop
   fi
   if [ -x /opt/jp1ajs2/tools/ajsembdbstop ] ; then
     /opt/jp1ajs2/tools/ajsembdbstop -id _JA0
   fi
 fi
 exit 0

ajsembdbstopコマンドの-idオプションに指定する組み込みDBセットアップ識別子は，環境に合わせて変更してください。

ファイルを閉じる。

14.7.3　ISAMファイル自動再編成機能の設定

JP1/AJS2サービスの起動時に，該当する物理ホストおよび論理ホストで使用するISAMデータファイルを自動的に再編成できます。JP1/AJS2 - Managerのインストール時には，この機能は無効になっています。有効にするには，/etc/opt/jp1ajs2/conf/jp1ajs_spmd_pre.conf.modelを，サービス構成ファイル格納ディレクトリのjp1ajs_spmd_pre.confにコピーしてください。サービス構成ファイル格納ディレクトリは，物理ホスト環境では/etc/opt/jp1ajs2/conf，論理ホスト環境では「jp1ajs2_setup_clusterコマンドで指定した共有ディレクトリ/jp1ajs2/conf」です。

ISAMファイル自動再編成機能を有効にすると，/opt/jp1ajs2/binディレクトリのjpqautocondおよびajsautocondが起動されるようになります。jpqautocondは，ジョブ実行環境のデータファイルを再編成します。ajsautocondは，ISAMで運用されているすべてのスケジューラーサービスのデータベースを再編成します。

ajsautocondは次の処理を行います。

JP1/AJS2 - Viewから，再編成の対象となるホストにあるデータベースへの接続を切り離す。
データベースへの接続を切り離す場合で，すでにデータベースへの処理要求があったときは，その要求が終了するまで接続の切り離しを待ちます。
データベースへの接続を切り離したあとに，JP1/AJS2 - Viewから再接続すると，「KAVV461-E 指定したスケジューラーサービスはメンテナンス中のため接続できません。」メッセージが出力されます。その場合は，時間を置いて（再編成の終了を待って）再接続してください。
また，ジョブネットワーク要素を操作するコマンドが，再編成の対象となるホストで実行中の場合も，該当するコマンドの実行が終了するまで接続の切り離しを待ちます。再編成中にジョブネットワーク要素を操作するコマンドを実行した場合は，「KAVS1717-E メンテナンス中のため実行できません」メッセージが出力されます。
これらの切断状況監視時間は，環境変数AJSAUTOCONDWAITで指定できます。指定できる値は，0～86,400（単位：秒）です。デフォルトは20秒です。切断状況監視時間内に切断が完了しない場合は，再編成は行いません。自動再編成を行う場合，環境変数AJSAUTOCONDWAITはJP1/AJS2サービスの起動環境に設定してください。
なお，ajsautocondは内部でjajs_maintainコマンドを呼び出します。環境変数AJSAUTOCONDWAITの値は，jajs_maintainコマンドの-cオプションに設定されます。この値が不正な場合は，jajs_maintainコマンドのエラーメッセージが下記補足事項に示すログファイルに出力され，再編成は行いません。
また，JP1/AJS2 Console機能を使用している場合，監視対象ホストが再編成中の間は，AJS2ユニット監視オブジェクトの状態が「状態不明」になります。

該当する物理ホスト，および論理ホストのすべてのスケジューラーサービスのデータベースを再編成する。

JP1/AJS2 - Viewおよびジョブネットワーク要素を操作するコマンドの，データベースへの接続抑止を解除する。

注意事項

再編成時には，対象の物理ホストまたは論理ホストの作業ディレクトリ（ジョブ実行環境の環境設定パラメーターWorkPathパラメーターに指定したマネージャープロセス実行時のワークディレクトリおよび各スケジューラーサービスの環境設定パラメーターAJSTMPDIRパラメーターに指定したテンポラリーファイル用ディレクトリ）があるパーティションに，再編成対象のスケジューラーおよびジョブ実行環境のISAMファイルの中で最もサイズが大きいファイルの2倍程度の空き容量が必要です。

また，スケジューラーサービスおよびジョブ実行環境データベースディレクトリがあるパーティションに，再編成対象のISAMファイルの中で最もサイズが大きいファイルと同じ程度の空き容量が必要です。

補足事項

06-71以前のJP1/AJS2では，従来まではスクリプトの処理方式にJP1/BaseのISAMデータベース再編成コマンドJiscondを使用していましたが，JP1/AJS2 07-00では自動再編成スクリプトajsautocondおよびjpqautocondスクリプトで再編成前のファイルの検証と再編成失敗時の自動修復ができるようにするため，スクリプトの処理方式を変更しています。できるだけマスターISAMファイルが不正になる状態を少なくするためにISAMファイルの状態を検証（Jischk）し，データを一度作業ファイルに抽出（Jisext）して再作成（Jisconv）した上でマスターファイルにリネームする方式になっています。それぞれの処理でエラーになった場合には，エラーメッセージが次に示す再編成ログファイルに出力されますので，オペレーターのとる処置を参照して対処してください。

・物理ホストの場合

次の二つのログファイルにエラーメッセージを出力します。

/var/opt/jp1ajs2/log/ajsautocond[面数番号].log

/var/opt/jp1ajs2/log/jpqautocond[面数番号].log

[面数番号]はログファイル名を表し，1から4の数字になります。

四つのログファイルをすべて使い切ると，古いログファイルから再利用します。

・論理ホストの場合

次の二つのログファイルにエラーメッセージを出力します。

/var/opt/jp1ajs2/log/ajsautocond_[論理ホスト名][面数番号].log

/var/opt/jp1ajs2/log/jpqautocond_[論理ホスト名][面数番号].log

[面数番号]はログファイル名を表し，1から4の数字になります。

四つのログファイルをすべて使い切ると，古いログファイルから再利用します。

14.7.4　スケジューラーサービスの統合トレースログ出力レベルの変更

スケジューラーサービスが統合トレースログに出力するメッセージのレベルを指定できます。

指定手順を次に示します。

JP1/AJS2のサービスを停止する。
次のコマンドを実行して，プロセスがすべて停止していることを確認します。

# /etc/opt/jp1ajs2/jajs_stop
# /opt/jp1ajs2/bin/jajs_spmd_status

viなどのエディターで次に示す内容を記述した設定ファイルを作成する。

[{JP1_DEFAULT|論理ホスト名}¥JP1AJSMANAGER¥スケジューラーサービス名]
HNTRLOGLEVEL="設定値"

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。
「設定値」には，出力レベルとして次のどれかを指定します。

none
どのメッセージも出力しません。

error
エラーメッセージを出力します。

warn
エラーおよび警告メッセージを出力します。

info
エラー，警告および情報メッセージを出力します。

デフォルトは「error」です。
設定ファイルのファイル名は任意です。

ファイルを保存し，次のコマンドを実行する。

jbssetcnf 設定ファイル名

jbssetcnfコマンドのパスは，「/opt/jp1base/bin/jbssetcnf」です。
jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/AJS2を再起動する。
設定ファイルの内容が構成定義に反映されます。

14.7.5　ネストジョブネット定義パラメーター出力時のスケジュールルールの出力方法の変更

スケジュールルールを有効にして上位ジョブネットのスケジュールに依存しないようにするのか，またはスケジュールルールを削除して上位ジョブネットのスケジュールに依存するようにするのかを指定できます。

このオプションは，スケジュールルールを持ったルートジョブネットをネストジョブネットにコピーして作成したジョブネットに対して，ajsprint，ajsbackup，ajsexportコマンドの実行，およびJP1/AJS2 - Viewで「退避」を行った場合に有効です。

JP1/AJS2のサービスを停止する。
次のコマンドを実行して，プロセスがすべて停止していることを確認します。

# /etc/opt/jp1ajs2/jajs_stop
# /opt/jp1ajs2/bin/jajs_spmd_status

viなどのエディターで次に示す内容を記述した設定ファイルを作成する。

[{JP1_DEFAULT|論理ホスト名}¥JP1AJSMANAGER¥スケジューラーサービス名]
AJSPRINTNETSCHPRF="設定値"

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。
「設定値」には，次のどちらかを指定します。

yes
スケジュールルールを有効にして，上位ジョブネットのスケジュールに依存しない。

no
スケジュールルールを削除して，上位ジョブネットのスケジュールに依存する。

デフォルトは「yes」です。
この項目は，JP1/AJS2の新規のインストール時および新規のセットアップ時に「no」が設定されます。
設定ファイルのファイル名は任意です。

ファイルを保存し，次のコマンドを実行する。

jbssetcnf 設定ファイル名

jbssetcnfコマンドのパスは，「/opt/jp1base/bin/jbssetcnf」です。
jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/AJS2を再起動する。
変更した構成定義の内容が反映されます。

14.7.6　スケジューラートレースログファイルの名称変更

スケジューラーサービスのトレースログファイル名のデフォルトは「/var/opt/jp1ajs2/log/tracelog」です。このファイル名を任意のファイル名に変更できます。

ファイル名の変更手順を次に示します。

JP1/AJS2のサービスを停止する。
次のコマンドを実行して，プロセスがすべて停止していることを確認します。

# /etc/opt/jp1ajs2/jajs_stop
# /opt/jp1ajs2/bin/jajs_spmd_status

viなどのエディターで次に示す内容を記述した設定ファイルを作成する。

[JP1_DEFAULT¥JP1AJSMANAGER]
TRACELOGFILE="ファイル名"

「ファイル名」には，スケジューラーサービスのトレースログファイルの名称をフルパスで，かつ255バイト以内で指定します。
物理ホストおよびすべての論理ホストのスケジューラートレース情報が，ここで指定したファイルに記録されます。トレース情報を確実に記録できるように，必ずローカルディスク上のファイル名として指定してください。
なお，ファイルは，トレース情報が出力されたときに新規作成されます。したがって，既存のファイル名は指定しないでください。
設定ファイルのファイル名は任意です。

ファイルを保存し，次のコマンドを実行する。

jbssetcnf 設定ファイル名

jbssetcnfコマンドのパスは，「/opt/jp1base/bin/jbssetcnf」です。
jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/AJS2を再起動する。
設定ファイルの内容が構成定義に反映されます。

14.7.7　JP1/AJS2 - Managerの運用方法をサブミットジョブの登録や操作に限定するときの設定

JP1/AJS2 - Managerでジョブネットによるジョブの操作をしないで，ジョブ実行制御のコマンドを使用してサブミットジョブの登録や操作だけをするような運用をしたい場合は，JP1/AJS2 - Managerデーモンパラメーターの変更が必要です。

デーモンパラメーターの変更手順を次に示します。

JP1/AJS2のサービスを停止する。
次のコマンドを実行して，プロセスがすべて停止していることを確認します。

# /etc/opt/jp1ajs2/jajs_stop
# /opt/jp1ajs2/bin/jajs_spmd_status

次のファイルをviなどのエディターで開く。

/etc/opt/jp1ajs2/conf/jp1ajs_spmd.conf

デーモンパラメーターを次の行だけに変更する。

jpqmon|/opt/jp1ajs2/bin/jpqmon|||1800|

JP1/AJS2を再起動する。

なお，このパラメーターを記述するときには，空行（スペースだけの行も含みます）を作成しないでください。

14.7.8　サスペンド機能の設定

実行登録中にルートジョブネットの下位定義を編集する場合，対象のルートジョブネットをサスペンドするため，サスペンド機能を有効にしておく必要があります。

JP1/AJS2のサスペンド機能は，初期状態では無効になっているため，ajssetupコマンドで有効にしてください。

サスペンド機能を有効にする手順を次に示します。

JP1/AJS2のサービスを停止する。
次のコマンドを実行して，プロセスがすべて停止していることを確認します。

# /etc/opt/jp1ajs2/jajs_stop
# /opt/jp1ajs2/bin/jajs_spmd_status

次のコマンドを実行して，サスペンド機能を使用するための環境を設定する。

ajssetup -F スケジューラーサービス名 -m

ajssetupコマンドの文法および注意事項については，「20. セットアップ時に使用するコマンド　ajssetup」を参照してください。

JP1/AJS2サービスを再起動する。

実行登録中のルートジョブネットの下位定義変更の詳細については，マニュアル「JP1/Automatic Job Management System 2 解説　10.2.14 ジョブネットの実行登録を解除しないでジョブネットやジョブの定義を変更する」を参照してください。

14.7.9　登録解除や保存世代数管理による世代削除処理方式の変更

ルートジョブネットおよびルートリモートジョブネットの保存世代数の設定には，1～99（保存世代数の拡張機能を使用した場合は1～999）を指定できます。この保存世代数に関して，次に示す条件のジョブネットに対して登録解除の操作をすると，登録が解除されるのに長い時間が掛かってしまいます。

保存世代数に30以上を指定しているジョブネット

保存世代数が10以上で，かつ起動条件を使用しているジョブネット

そのため，ほかのジョブネットの起動条件監視が，「監視打ち切り終了」状態になったり，ジョブネットが正しく実行されなくなったりする場合があります。

この現象は，スケジューラーサービスの登録解除処理の設定が，「同期型」に設定されているのが原因です。登録解除処理の設定が「同期型」だと，登録解除対象の世代数が大量であればあるほど登録解除に多大な時間を必要とします。その登録解除に掛かる多大な時間が，ほかのジョブネットの実行動作に影響を与えてしまいます。

この現象を回避するには，登録解除処理の設定を「非同期型」にすることで対処してください。非同期型に変更する場合，設定変更前に実行していたジョブネットの登録情報を必要とする場合と必要としない場合とで手順が異なります。

JP1/AJS2 08-00以降で新規インストールした場合は，環境設定パラメーターBACKGROUNDLEAVEに「非同期型（yes）」が設定されるため，変更は不要です。ただし，バージョンアップインストールした場合は，「同期型（no）」が設定されることがあります。

環境設定パラメーターBACKGROUNDLEAVEに「同期型（no）」が設定されている，またはBACKGROUNDLEAVEが設定されていない場合は，登録解除に掛かる時間を考慮し，登録解除処理の設定を「非同期型（yes）」に変更することをお勧めします。設定を「同期型（no）」に変更する場合，設定変更前に実行していたジョブネットの登録情報は削除されるため注意してください。

登録解除処理の設定を変更する場合，設定変更が必要なスケジューラーサービスがあるJP1/AJS2のサービスを停止する必要があります。

スケジューラーサービス（AJSROOT1）の登録解除処理を変更する例を挙げて，設定方法を次に示します。

＜この項の構成＞

(1)　登録解除処理の設定を「同期型」から「非同期型」にする手順

(2)　登録解除処理の設定を「非同期型」から「同期型」にする手順

(1)　登録解除処理の設定を「同期型」から「非同期型」にする手順

環境設定パラメーターBACKGROUNDLEAVEの設定値がすでに「非同期型（yes）」に設定されている場合は，ここに示す操作の必要はありません。

(a)　実行していたジョブネットの登録情報を必要としない場合

実行していたジョブネットの登録情報を必要としない場合の手順を次に示します。

JP1/AJS2サービスおよびJP1/AJS2 Monitorサービスを停止する。
スーパーユーザー権限を持つユーザーで次のコマンドを実行し，プロセスがすべて停止していることを確認します。

# /etc/opt/jp1ajs2/jajs_stop
# /opt/jp1ajs2/bin/jajs_spmd_status
# /etc/opt/jp1ajs2/ajsinetd_startstop stop

viなどのエディターで，次の内容を記述したテキストファイルを作成する。

[{JP1_DEFAULT|論理ホスト名}¥JP1AJSMANAGER¥スケジューラーサービス名]
"BACKGROUNDLEAVE"="yes"

（例）スケジューラーサービス名が「AJSROOT1」の場合

[{JP1_DEFAULT|論理ホスト名}¥JP1AJSMANAGER¥AJSROOT1]
"BACKGROUNDLEAVE"="yes"

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

ファイルを保存し，次のコマンドを実行する。

jbssetcnf テキストファイル名

jbssetcnfコマンドのパスは，「/opt/jp1base/bin/jbssetcnf」です。
jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/AJS2 Monitorサービスを起動する。
スーパーユーザー権限を持つユーザーで，次に示すコマンドを実行します。

# /etc/opt/jp1ajs2/ajsinetd_startstop start

JP1/AJS2サービスをコールドスタートする。
スーパーユーザー権限を持つユーザーで，次に示すコマンドを実行します。

# /opt/jp1ajs2/bin/jajs_spmd -cold

(b)　実行していたジョブネットの登録情報を必要とする場合

実行登録情報が必要な場合は，次に示す手順に従って移行作業を実施してください。

JP1/AJS2サービスおよびJP1/AJS2 Monitorサービスを停止する。
スーパーユーザー権限を持つユーザーで次のコマンドを実行し，プロセスがすべて停止していることを確認します。

# /etc/opt/jp1ajs2/jajs_stop
# /opt/jp1ajs2/bin/jajs_spmd_status
# /etc/opt/jp1ajs2/ajsinetd_startstop stop

viなどのエディターで，次の内容を記述したテキストファイルを作成する。

[{JP1_DEFAULT|論理ホスト名}¥JP1AJSMANAGER¥スケジューラーサービス名]
"BACKGROUNDLEAVE"="yes"

（例）スケジューラーサービス名が「AJSROOT1」の場合

[{JP1_DEFAULT|論理ホスト名}¥JP1AJSMANAGER¥AJSROOT1]
"BACKGROUNDLEAVE"="yes"

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

ファイルを保存し，次のコマンドを実行する。

jbssetcnf テキストファイル名

jbssetcnfコマンドのパスは，「/opt/jp1base/bin/jbssetcnf」です。
jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/AJS2 Monitorサービスを起動する。
スーパーユーザー権限を持つユーザーで，次に示すコマンドを実行します。

# /etc/opt/jp1ajs2/ajsinetd_startstop start

実行登録情報を非同期型に変換する。
次に示すコマンドを実行します。

/opt/jp1ajs2/tools/ajsregcnv -F スケジューラーサービス名

（例）スケジューラーサービス名が「AJSROOT1」の場合

/opt/jp1ajs2/tools/ajsregcnv -F AJSROOT1

JP1/AJS2サービスを起動する。
スーパーユーザー権限を持つユーザーで，次に示すコマンドを実行します。

# /opt/jp1ajs2/bin/jajs_spmd

(2)　登録解除処理の設定を「非同期型」から「同期型」にする手順

登録解除処理の設定を「非同期型」から「同期型」に変更する場合の手順を次に示します。

JP1/AJS2サービスおよびJP1/AJS2 Monitorサービスを停止する。
スーパーユーザー権限を持つユーザーで次のコマンドを実行し，プロセスがすべて停止していることを確認します。

# /etc/opt/jp1ajs2/jajs_stop
# /opt/jp1ajs2/bin/jajs_spmd_status
# /etc/opt/jp1ajs2/ajsinetd_startstop stop

viなどのエディターで，次の内容を記述したテキストファイルを作成する。

[{JP1_DEFAULT|論理ホスト名}¥JP1AJSMANAGER¥スケジューラーサービス名]
"BACKGROUNDLEAVE"="no"

（例）スケジューラーサービス名が「AJSROOT1」の場合

[{JP1_DEFAULT|論理ホスト名}¥JP1AJSMANAGER¥AJSROOT1]
"BACKGROUNDLEAVE"="no"

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

ファイルを保存し，次のコマンドを実行する。

jbssetcnf テキストファイル名

jbssetcnfコマンドのパスは，「/opt/jp1base/bin/jbssetcnf」です。
jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/AJS2 Monitorサービスを起動する。
スーパーユーザー権限を持つユーザーで，次に示すコマンドを実行します。

# /etc/opt/jp1ajs2/ajsinetd_startstop start

JP1/AJS2サービスをコールドスタートする。
スーパーユーザー権限を持つユーザーで，次に示すコマンドを実行します。

# /opt/jp1ajs2/bin/jajs_spmd -cold

14.7.10　スケジューラーサービスをウォームスタートで起動させたときに，実行中であったジョブまたはジョブネットの終了メッセージ，および終了イベントの出力有無の設定

スケジューラーサービスをウォームスタートで起動させたときに，実行中であったジョブまたはジョブネットの終了メッセージ，および終了イベントの出力有無を選択できます。設定手順を次に示します。

JP1/AJS2のサービスを停止する。
次のコマンドを実行して，プロセスがすべて停止していることを確認します。

# /etc/opt/jp1ajs2/jajs_stop
# /opt/jp1ajs2/bin/jajs_spmd_status

ajsshmdelコマンドを実行して，共有メモリー情報を削除する。
ajsshmdelコマンドのパスは，「/opt/jp1ajs2/bin/ajsshmdel」です。

（例）shの場合

/opt/jp1ajs2/bin/ajsshmdel >/dev/null 2>&1

（例）cshの場合

/opt/jp1ajs2/bin/ajsshmdel >&/dev/null

viなどのエディターで次に示す内容を記述した設定ファイルを作成する。

[{JP1_DEFAULT|論理ホスト名}¥JP1AJSMANAGER¥スケジューラーサービス名]
"WARMSTARTMSG"="設定値"

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。
「設定値」には，次のどちらかを指定します。

yes
終了メッセージ，および終了イベントを出力します。

no
終了メッセージ，および終了イベントを出力しません。

デフォルトは「no」です。
設定ファイルのファイル名は任意です。

ファイルを保存し，次のコマンドを実行する。

jbssetcnf 設定ファイル名

jbssetcnfコマンドのパスは，「/opt/jp1base/bin/jbssetcnf」です。
jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/AJS2サービスを再起動する。
設定ファイルの内容が構成定義に反映されます。

14.7.11　JP1/AJS2定義内容の事前チェック機能の設定

JP1/AJS2では，本番運用時に障害の発生を抑えるため，ジョブの定義内容に不正がないかどうかを本番運用の開始前にチェックできます。このチェック機能を使用できるように設定します。

＜この項の構成＞

(1)　JP1/AJS2定義内容の事前チェック機能の設定手順

(2)　JP1/AJS2定義内容の事前チェック機能の設定変更

(3)　定義パラメーター一覧

(4)　定義内容

(1)　JP1/AJS2定義内容の事前チェック機能の設定手順

JP1/AJS2定義内容の事前チェック機能を使用するための手順を次に示します。

次のコマンドを実行する。
JP1/AJS2 - Managerの場合

　#/opt/jp1ajs2/bin/ajschksetup -m -a

JP1/AJS2 - Agentの場合

　#/opt/jp1ajs2/bin/ajschksetup -a

ajschksetupコマンドの詳細については，「20. セットアップ時に使用するコマンド　ajschksetup」を参照してください。

JP1/AJS2 Check Managerサービス，JP1/AJS2 Check Agentサービスを起動する。
次のコマンドを実行してください。
JP1/AJS2 - Managerの場合

　#/opt/jp1ajs2/bin/ajschkstart -m -a

JP1/AJS2 - Agentの場合

　#/opt/jp1ajs2/bin/ajschkstart -a

ajschkstartコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 2 コマンドリファレンス　1. コマンド　ajschkstart（UNIX限定）」を参照してください。

(2)　JP1/AJS2定義内容の事前チェック機能の設定変更

JP1/AJS2定義内容の事前チェック機能の設定を変更する手順を次に示します。

JP1/AJS2 Check Managerサービス，JP1/AJS2 Check Agentサービスを停止する。
次のコマンドを実行してください。
JP1/AJS2 - Managerの場合

　#/opt/jp1ajs2/bin/ajschkstop -m -a

JP1/AJS2 - Agentの場合

　#/opt/jp1ajs2/bin/ajschkstop -a

ajschkstopコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 2 コマンドリファレンス　1. コマンド　ajschkstop（UNIX限定）」を参照してください。

viなどのテキストエディターで，（3）の構成定義パラメーターを記述した設定ファイルを作成する。

ファイルを保存し，次のコマンドを実行する。

jbssetcnf 設定ファイル名

jbssetcnfコマンドのパスは，「/opt/jp1base/bin/jbssetcnf」です。
jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

手順1で停止させたサービスを起動する。
次のコマンドを実行してください。
JP1/AJS2 - Managerの場合

　#/opt/jp1ajs2/bin/ajschkstart -m -a

JP1/AJS2 - Agentの場合

　#/opt/jp1ajs2/bin/ajschkstart -a

変更した構成定義の内容が反映されます。

(3)　定義パラメーター一覧

表14-14　JP1/AJS2定義内容の事前チェック機能の設定するための定義パラメーター一覧

定義キー | 定義パラメーター | 定義内容
[JP1_DEFAULT¥JP1AJS2¥CHECK] | "AJSCHK_CHECKFILE"※= | 定義内容の事前チェック結果格納ファイル名
"AJSCHK_LOGDIR"= | 定義チェックログフォルダ名
"AJSCHK_LOGSIZE"= | 定義チェックログファイルのサイズ
"AJSCHK_TRACELOGFILE"= | 定義内容の事前チェック機能のトレースログファイル名
"AJSCHK_CHARCODE"= | ジョブ情報や定義内容の事前チェック結果を表示する文字コードを指定

注※

JP1/AJS2 - Managerでだけ設定できます。

(4)　定義内容

"AJSCHK_CHECKFILE"="定義内容の事前チェック結果格納ファイル名"

定義内容の事前チェック結果を格納するファイル名を255バイト以内で指定します。ファイル名はフルパスで指定します。

デフォルトは「/var/opt/jp1ajs2/log/ajscheckfile.txt」です。

"AJSCHK_LOGDIR"="定義チェックログフォルダ名"

定義内容の事前チェックプロセスがログ出力するログフォルダ名を180バイト以内で指定します。フォルダ名はフルパスで指定します。

デフォルトは「/var/opt/jp1ajs2/log」です。

このフォルダ配下の「ajscheck1.log」にログが書き込まれます。「ajscheck1.log」にAJSCHK_LOGSIZEで指定したサイズまでログが書き込まれると「ajscheck2.log」にログが書き込まれるようになります。

"AJSCHK_LOGSIZE"=dword:ログファイルサイズ

定義内容の事前チェックプロセスがログ出力するファイルのサイズを16進数で指定します。

0または4～1E8480（10進数で0または4～2,000,000）（単位：キロバイト）の間で指定します。

デフォルトは「dword:00001000」（10進数で4,096）です。

指定したサイズが，定義チェックログファイル1（ajscheck1.log），および2（ajscheck2.log）のファイルサイズになります。

注意事項

ここで指定したサイズの上限までファイル1に情報が書き込まれると，それ以上の情報はファイル2に書き込まれます。さらに，ファイル2でもサイズの上限まで情報が書き込まれると，再びファイル1に戻って情報を書き込みます。ファイル1→ファイル2→ファイル1→ファイル2を繰り返し，古い情報から上書きされるため，サイズの指定には注意が必要です。

"AJSCHK_TRACELOGFILE"="トレースログファイル名"

定義内容の事前チェック機能におけるトレースログファイルの名称を指定します。

ファイル名はフルパスで指定します。

ファイル名を省略した場合，トレースログは出力されません。

セットアップ時には，次のファイル名が仮定されます。

「/var/opt/jp1ajs2/log/tracelog.ch」です。

"AJSCHK_CHARCODE"="{none|C|SJIS|EUC|UTF-8}"

ジョブ情報や定義内容の事前チェック結果を表示する文字コードを指定します。

none

7ビットASCII文字コードを指定します。JP1/AJS2 - Manager，JP1/AJS2 - Agent間で文字コード変換をしません。

C

7ビットASCII文字コードを指定します。JP1/AJS2 - Manager，JP1/AJS2 - Agent間で文字コード変換をしません。

SJIS

シフトJISコードを指定します。

EUC

EUC文字コードを指定します。

UTF-8

UTF-8文字コードを指定します。

デフォルトは「none」です。

なお，定義内容の事前チェック時の環境変数LANGは，JP1/AJS2 Check Agentサービス起動時の環境変数LANGとなります。

注意事項

次の場合，ジョブ情報や定義内容の事前チェック結果は，AJSCHARCODEに指定された文字コードで表示されます。

AJSCHARCODEに「SJIS」または「EUC」を指定していて，AJSCHK_CHARCODEに「none」または「C」を指定している。

AJSCHARCODEに「C」を指定している。

14.7.12　ジョブネットコネクタで異なるスケジューラーサービス間のルートジョブネットの実行順序を制御するための設定

異なるスケジューラーサービス間のルートジョブネットの実行順序を制御する場合，ジョブネットコネクタおよび接続先のジョブネットの各ホストでセットアップが必要です。次に示す設定手順に従ってセットアップしてください。

なお，このセットアップはマネージャー環境（JP1/AJS2 - Manager）で作業します。エージェント環境（JP1/AJS2 - Agent）で設定する作業はありません。

＜この項の構成＞

(1)　スケジューラーサービス間通信制御プロセスの設定手順

(2)　スケジューラーサービス間通信制御プロセスの設定変更

(3)　定義パラメーター一覧

(4)　定義内容

(1)　スケジューラーサービス間通信制御プロセスの設定手順

スケジューラーサービス間通信制御プロセス（ajsgwd）の設定手順を次に示します。

jp1ajs_spmd.confファイルを編集する。
jp1ajs_spmd起動時にスケジューラーサービス間通信制御プロセス（ajsgwd）を起動させるため，jp1ajs_spmd.confファイルを編集します。
スケジューラーの状態監視の設定をしていないときは，jp1ajs_spmd.confファイルのバックアップを作成し，jp1ajs_spmd_gw.conf.modelファイルをjp1ajs_spmd.confにリネームしてください。
スケジューラーの状態監視の設定をしているときは，jp1ajs_spmd.confファイルのバックアップを作成し，jp1ajs_spmd_gw.conf.modelファイルの内容を参照してjp1ajs_spmd.confファイルに次の下線部分を追加します。

jpqmon|/opt/jp1ajs2/bin/jpqmon|||1800|
jpomanager|/opt/jp1ajs2/bin/jpomanager||jpqmon|1800|
jpoagent|/opt/jp1ajs2/bin/jpoagent||jpomanager|1800|
ajsovstatd|/opt/jp1ajs2/bin/ajsovstatd||jpoagent|1800|
ajsmasterd|/opt/jp1ajs2/bin/ajsmasterd||jpoagent|1800|
ajsgwmasterd|/opt/jp1ajs2/bin/ajsgwmasterd|||1800|

なお，論理ホストのjp1ajs_spmd_gw.conf.modelファイルは上書きインストールの対象ではありませんので，物理ホストのjp1ajs_spmd_gw.conf.modelを参照してjp1ajs_spmd.confファイルを編集してください。
jp1ajs_spmd_gw.conf.modelファイルおよびjp1ajs_spmd.confファイルの格納ディレクトリは，次のとおりです。

物理ホストの場合

/etc/opt/jp1ajs2/conf

論理ホストの場合

共有ディレクトリ/jp1ajs2/conf

スケジューラーサービス間通信制御プロセスが使用する通信ポートのサービス名（jp1ajs2gw）とポート番号（23160/tcp）をservicesファイルに設定する。

jp1ajs2gw 23160/tcp

jp1ajs_service_0700.confファイルを編集する。
JP1/AJS2 - Managerを08-50より前のバージョンから上書きインストールして環境を構築する場合，次のようにjp1ajs_service_0700.confファイルを編集します。
jp1ajs_service_0700.confの設定を変更していないときは，jp1ajs_service_0700.confファイルのバックアップを作成し，jp1ajs_service_0700.conf.modelファイルをjp1ajs_service_0700.confにリネームしてください。
jp1ajs_service_0700.confの設定を変更しているときは，jp1ajs_service_0700.confファイルのバックアップを作成し，jp1ajs_service_0700.conf.modelファイルを参照してjp1ajs_service_0700.confファイルに次の下線部分を追加します。

jpqmon|/opt/jp1ajs2/bin/jpqmon||0|3|3|21600|
jpomanager|/opt/jp1ajs2/bin/jpomanager||0|3|3|21600|
jpoagent|/opt/jp1ajs2/bin/jpoagent||0|3|3|21600|
ajsovstatd|/opt/jp1ajs2/bin/ajsovstatd||0|3|3|21600|
ajsmasterd|/opt/jp1ajs2/bin/ajsmasterd||0|3|3|21600|
ajsgwmasterd|/opt/jp1ajs2/bin/ajsgwmasterd||0|3|3|21600|

なお，論理ホストのjp1ajs_service_0700.conf.modelファイルは上書きインストールの対象ではありませんので，物理ホストのjp1ajs_service_0700.conf.modelを参照して編集してください。
jp1ajs_service_0700.conf.modelファイルおよびjp1ajs_service_0700.confファイルの格納ディレクトリは，次のとおりです。

物理ホストの場合

/etc/opt/jp1ajs2/conf

論理ホストの場合

共有ディレクトリ/jp1ajs2/conf

viなどのエディターで次に示す内容を記述した設定ファイルを作成する。
異なるスケジューラーサービス間のルートジョブネットの実行順序を制御するスケジューラーサービスに対して次の内容を設定してください。

[{JP1_DEFAULT|論理ホスト名}¥JP1AJSMANAGER¥スケジューラーサービス名]
"RJCUSE"="yes"

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

ファイルを保存し，次のコマンドを実行する。

jbssetcnf 設定ファイル名

jbssetcnfコマンドのパスは，「/opt/jp1base/bin/jbssetcnf」です。
jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。
なお，論理ホストで設定する場合は，実行系および待機系の両系のホストでこの設定が必要です。論理ホストでの設定方法については，「18.4.3 共通定義情報変更時の作業」を参照してください。

JP1/AJS2のサービスを起動する。
設定した内容が反映されます。

(2)　スケジューラーサービス間通信制御プロセスの設定変更

スケジューラーサービス間通信制御プロセスについての設定を変更する手順を次に示します。

JP1/AJS2のサービスを停止する。
JP1/AJS2のサービスを停止して，プロセスがすべて停止していることを確認します。

viなどのテキストエディターで，「(3) 定義パラメーター一覧」に示したパラメーターを記述した設定ファイルを作成する。

ファイルを保存し，次のコマンドを実行する。

jbssetcnf 設定ファイル名

jbssetcnfコマンドのパスは，「/opt/jp1base/bin/jbssetcnf」です。
jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。
なお，論理ホストで設定する場合は，実行系および待機系の両系のホストでこの設定が必要です。論理ホストでの設定方法については，「18.4.3 共通定義情報変更時の作業」を参照してください。

JP1/AJS2のサービスを再起動します。
変更した内容が反映されます。

(3)　定義パラメーター一覧

表14-15　異なるスケジューラーサービス間のルートジョブネットの実行順序を制御するための定義パラメーター一覧

定義キー | 定義パラメーター | 定義内容
[{JP1_DEFAULT|論理ホスト名}¥JP1AJSMANAGER¥スケジューラーサービス名]※ | "RJCUSE"= | 異なるスケジューラーサービス間のルートジョブネットの実行順序を制御するかどうかの設定
"FGRECONLMT"= | フロー制御プロセスとスケジューラーサービス間通信制御プロセスが通信接続できなかった場合の再接続回数
[{JP1_DEFAULT|論理ホスト名}¥JP1AJS2¥GATEWAY]※ | "GWMAXCONNECTION"= | スケジューラーサービス間通信制御プロセス（ajsgwd）が通信する際の最大同時接続数
"GWPROCESSHA"= | スケジューラーサービス間通信制御プロセス（ajsgwd）が異常終了した場合に，スケジューラーサービス間通信制御プロセスを管理するプロセス（ajsgwmasterd）を終了するかどうかの設定
"GWRESTARTCOUNT"= | スケジューラーサービス間通信制御プロセスが異常終了した場合に，自動的に再起動する回数

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

(4)　定義内容

"RJCUSE"="{yes|no}"

異なるスケジューラーサービス間のルートジョブネットの実行順序を制御するかどうかを設定します。

yes

異なるスケジューラーサービス間のルートジョブネットの実行順序を制御する場合に指定します。

no

異なるスケジューラーサービス間のルートジョブネットの実行順序を制御しない場合に指定します。

デフォルトは「no」です。

"FGRECONLMT"=dword:再接続回数

フロー制御プロセスとスケジューラーサービス間通信制御プロセスが通信接続できなかった場合の再接続回数を16進数で指定します。

指定できる範囲は，0～64（10進数で0～100）です。

デフォルトは「dword:00000003」（10進数で3）です。

"GWMAXCONNECTION"=dword:最大同時コネクション数

スケジューラーサービス間通信制御プロセス（ajsgwd）が通信する際の，最大同時接続数を16進数で指定します。

指定できる範囲は，a～400（10進数で10～1,024）です。

デフォルトは「dword:a」（10進数で10）です。

システム内の，スケジューラーサービス間通信制御プロセスをセットアップしたJP1/AJS2 - Managerホストの数を指定してください（物理ホスト・論理ホストの両方を含む）。指定した値が実際の値より少ない場合，スケジューラーサービス間通信制御プロセスの通信に失敗する場合があります。

"GWPROCESSHA"="{yes|no}"

スケジューラーサービス間通信制御プロセス（ajsgwd）が異常終了した場合に，スケジューラーサービス間通信制御プロセスを管理するプロセス（ajsgwmasterd）を終了するかどうかを設定します。

yes

スケジューラーサービス間通信制御プロセスを管理するプロセス（ajsgwmasterd）を終了します。

jajs_spmdコマンドに-HAオプションを指定してJP1/AJS2サービスを起動している場合，およびクラスタ構成時の論理ホストの場合は，JP1/AJS2サービス全体が停止します。

no

スケジューラーサービス間通信制御プロセスを管理するプロセス（ajsgwmasterd）を終了しません。

jajs_spmdコマンドに-HAオプションを指定してJP1/AJS2サービスを起動している場合，およびクラスタ構成時の論理ホストの場合でもJP1/AJS2サービスを停止させないで，スケジューラーサービス間のルートジョブネットの実行順序制御以外の機能を使用できます。

デフォルトは「no」です。

"GWRESTARTCOUNT"=dword:スケジューラーサービス間通信制御プロセス再起動回数

スケジューラーサービス間通信制御プロセスが異常終了した場合に，自動的に再起動する回数を16進数で指定します。

指定できる範囲は，0～3（10進数で0～3）です。

デフォルトは「dword:00000003」（10進数で3）です。

15.　スケジューラーデータベースに組み込みDBを使用する場合のセットアップ

この章では，スケジューラーデータベースに組み込みDBを使用する場合のセットアップについて説明します。

＜この章の構成＞

15.1　組み込みDBを使用する場合の準備

15.2　組み込みDBのセットアップ

15.3　クラスタ構成時の実行系組み込みDBのセットアップ

15.4　クラスタ構成時の待機系組み込みDBのセットアップ

15.5　クラスタ構成時の組み込みDBの設定変更

15.6　組み込みDBのクラスタソフトへの登録

15.1　組み込みDBを使用する場合の準備

この節では，JP1/AJS2 - Managerのスケジューラーデータベースとして組み込みDBを使用する場合の準備について説明します。

＜この節の構成＞

15.1.1　前提条件

15.1.2　組み込みDBのセットアップ手順

15.1.3　組み込みDB稼働環境と運用方法の検討

15.1.1　前提条件

スケジューラーサービスが設定されていて，スケジューラーデータベースがISAMで作成済みである必要があります。

クラスタ構成の場合は，論理ホスト環境でスケジューラーサービスの設定およびスケジューラーデータベースがISAMで作成済みである必要があります。

15.1.2　組み込みDBのセットアップ手順

組み込みDBのセットアップ手順を次に示します。

図15-1　組み込みDBのセットアップ手順

15.1.3　組み込みDB稼働環境と運用方法の検討

＜この項の構成＞

(1)　稼働環境

(2)　運用方法

(1)　稼働環境

組み込みDBが稼働する環境条件として，次の項目について検討および確認します。

システム構成

環境構築規模

システムファイル領域

(a)　システム構成

非クラスタ構成（物理ホスト）とするか，またはクラスタ構成（論理ホスト）とするかを検討します。組み込みDBだけでなく，JP1/AJS2サービスの全体構成としての環境条件となります。

(b)　環境構築規模

JP1/AJS2の運用規模に合わせて，組み込みDB環境を構築する規模を三つ（小規模，中規模，大規模）の中から選択します。それぞれの規模の目安について，次の表に示します。

表15-1　組み込みDB環境構築規模の目安

規模
ユニット数
1日に実行される
ジョブ・ジョブネット数

小規模
10,000以下
10,000以下

中規模
10,000～40,000
10,000～25,000

大規模
40,000～100,000
25,000～50,000

運用規模が大規模を超える場合は，組み込みDB環境を大規模で構築し，そのあと環境の拡張を実施してください。

組み込みDB環境の拡張については，マニュアル「JP1/Automatic Job Management System 2 コマンドリファレンス　1. コマンド　ajsembdbaddarea」を参照してください。

(c)　システムファイル領域

組み込みDBで使用するシステムファイルの二重化実施の有無について検討します。システムファイルを二重化すると，必要なディスク容量は増加しますが，ディスク障害などによって組み込みDBシステムが停止する可能性を低くすることができます。

組み込みDBの稼働環境ごとに必要なディスク容量を次の表に示します。項番1～24から一つを選択してください。

表15-2　組み込みDB稼働環境ごとの必要ディスク容量

項番 | 組み込みDB稼働環境 | 必要ディスク容量（単位：メガバイト）
システム構成 | 環境構築規模 | RAWファイルの使用 | システムファイルの二重化 | データ領域 | システムファイル領域 | 作業領域 | 合計
1 | 非クラスタ | 小規模 | なし | なし | 300 | 702 | － | 1,002
2 | あり | 1,404 | 1,704
3 | あり | なし | 702 | 40 | 1,042
4 | あり | 1,404 | 1,744
5 | 中規模 | なし | なし | 800 | 1,200 | － | 2,000
6 | あり | 2,400 | 3,200
7 | あり | なし | 1,200 | 40 | 2,040
8 | あり | 2,400 | 3,240
9 | 大規模 | なし | なし | 1,600 | 3,402 | － | 5,002
10 | あり | 6,804 | 8,404
11 | あり | なし | 3,402 | 40 | 5,042
12 | あり | 6,804 | 8,444
13 | クラスタ | 小規模 | なし | なし | 300 | 702 | 40＊2※ | 1,082
14 | あり | 1,404 | 1,784
15 | あり | なし | 702 | 1,082
16 | あり | 1,404 | 1,784
17 | 中規模 | なし | なし | 800 | 1,200 | 2,080
18 | あり | 2,400 | 3,280
19 | あり | なし | 1,200 | 2,080
20 | あり | 2,400 | 3,280
21 | 大規模 | なし | なし | 1,600 | 3,402 | 5,082
22 | あり | 6,804 | 8,484
23 | あり | なし | 3,402 | 5,082
24 | あり | 6,804 | 8,484

（凡例）

－：作成先は指定できません。

注

組み込みDB運用ディレクトリのディスク容量については，「JP1/AJS2 - Database option ソフトウェア添付資料」のディスク占有量を参照してください。

注※

クラスタ構成時の作業領域は，共有ディスク上ではなくローカルディスク上に作成する必要があるため，実行系および待機系それぞれに必要です。

(2)　運用方法

組み込みDBの具体的な運用方法として，次の項目について検討します。

システムログの運用

バックアップの取得タイミング

バックアップからの回復点

バックアップからの回復方法

(a)　システムログの運用

システムログを使用して回復する場合は，次に示す二とおりの運用方法のどちらかを選択する必要があります。システムログを使用して回復しない場合，考慮する必要はありません。

システムログ運用（アンロードレス運用）
組み込みDB環境構築時に作成されるシステムファイル（システムログファイル）上にデータを保持する運用方法です。システムログファイルをすべて使い切ると組み込みDBシステムが停止してしまうため，システムログファイルの状態を定期的に監視する必要があります。

アンロードログ運用
システムログファイルに出力されたデータを別ファイルに退避（アンロード）する運用方法です。アンロードは組み込みDBによって自動的に実行され，同時にシステムログファイルも再利用できる状態になります。しかし，アンロードログファイルを保存するためのディスク容量が必要となり，ディスクの空き容量については監視する必要があるほか，回復時には使用するアンロードログファイルを正しい順序で指定する必要があります。

(b)　バックアップの取得タイミング

組み込みDBのバックアップを取得するタイミングには，次の二つがあります。

JP1/AJS2サービス停止中（ジョブ，ジョブネットを運用していないとき）
組み込みDBのバックアップを取得する際に，JP1/AJS2の運用を停止する必要があります。取得したバックアップデータだけでバックアップ時点へ回復できる，基本的なバックアップ方法です。

JP1/AJS2サービス稼働中（ジョブ，ジョブネットを運用しているとき）
組み込みDBのバックアップを取得する際に，JP1/AJS2の運用を停止する必要はありません。しかし，回復する際には取得したバックアップデータと共に，組み込みDBが出力しているシステムログまたはアンロードログが必要です。

(c)　バックアップからの回復点

組み込みDBのバックアップからの回復点は，次の二つです。

バックアップ取得時点
バックアップを取得した時点の状態へ回復します。バックアップ取得時点以降の運用内容は反映されません。

バックアップ取得後の最新の同期点
バックアップを取得した時点の状態に加えて，バックアップ時点以降の運用によるデータベースの更新内容も反映されるため，最新の状態まで回復できます。

(d)　バックアップからの回復方法

バックアップからの回復方法を次に説明します。

バックアップデータだけ
バックアップ時に取得したバックアップデータだけで回復します。バックアップ取得時点の状態に回復できます。

バックアップデータとシステムログ
バックアップ時に取得したバックアップデータと共に，バックアップ時点以降に出力されたシステムログの情報を使用して回復します。バックアップ時点以降の運用によるデータベースの更新内容も反映されます。JP1/AJS2運用中に取得したバックアップからの回復は，この方法で回復します。

組み込みDBの運用方法を次の表に示します。

表15-3　組み込みDBの運用方法

項番
運用方法

システムログの運用
バックアップ取得タイミング
バックアップからの回復点
バックアップからの回復方法

A
システムログ運用しない
JP1/AJS2サービス停止中
バックアップ取得時点
バックアップデータのみ

B
B-1
システムログ運用
（アンロードレス運用）
JP1/AJS2サービス停止中
バックアップ取得時点
バックアップデータのみ

B-2
最新の同期点
バックアップデータとシステムログ

B-3
JP1/AJS2サービス稼働中

C
C-1
アンロードログ運用
JP1/AJS2サービス停止中
バックアップ取得時点
バックアップデータのみ

C-2
最新の同期点
バックアップデータとアンロードログ

C-3
JP1/AJS2サービス稼働中

運用方法の特徴を次の表に示します。この表に示す運用方法の特徴を考慮して表15-3から運用方法を選択してください。

表15-4　各運用方法の特徴

項番※
特徴

長所
短所

A
システムログファイルの状態を監視する必要がありません。

バックアップからの回復点はバックアップ時点だけです。

バックアップ取得時にはJP1/AJS2サービスを停止する必要があります。

B
共通
アンロードログ運用と比較した場合，回復するときの手順が容易です。

システムログファイルの状態を監視する必要があります。

バックアップの必要がなくても頻繁に取得する必要があります。

B-1
システムログファイルに障害が発生しても，バックアップデータだけで回復できます。

バックアップからの回復点はバックアップ時点だけです。

バックアップ取得時にはJP1/AJS2サービスを停止する必要があります。

B-2

システムログファイルに障害が発生しても，バックアップデータだけで回復できます。

バックアップ取得時点以降の運用を反映した最新の状態に回復できます。

バックアップ取得時にはJP1/AJS2サービスを停止する必要があります。

B-3

バックアップ取得時にJP1/AJS2サービスを停止する必要がありません。

バックアップ取得時点以降の運用を反映した最新の状態に回復できます。

システムログファイルに障害が発生すると，該当するバックアップデータからの回復は一切できません。

C
共通

システムログファイルの状態を監視する必要がありません。

システムログ運用と比較した場合，バックアップを必要以上に取得する必要がありません。

自動ログアンロード機能の動作状態を監視する必要があります。

アンロードログファイル作成ディレクトリを準備する必要があります。

システムログ運用と比較した場合，回復するときの手順が繁雑です。

C-1

システムログファイルに障害が発生しても，バックアップデータだけで回復できます。

バックアップからの回復点はバックアップ時点だけです。

バックアップ取得時にはJP1/AJS2サービスを停止する必要があります。

C-2

システムログファイルに障害が発生しても，バックアップデータだけで回復できます。

バックアップ取得時点以降の運用を反映した最新の状態に回復できます。

バックアップ取得時にはJP1/AJS2サービスを停止する必要があります。

C-3

バックアップ取得時にJP1/AJS2サービスを停止する必要がありません。

バックアップ取得時点以降の運用を反映した最新の状態に回復できます。

アンロードログファイルを失うと，該当するバックアップデータからの回復は一切できません。

注※

表15-3の項番に対応します。

バックアップおよびバックアップからの回復方法の詳細については，次に示す個所を参照してください。

マニュアル「JP1/Automatic Job Management System 2 設計・運用ガイド　3.5.5 システムログを使用しない運用」

マニュアル「JP1/Automatic Job Management System 2 設計・運用ガイド　3.5.6 システムログ運用」

マニュアル「JP1/Automatic Job Management System 2 設計・運用ガイド　3.5.7 アンロードログ運用」

表15-3で選択した運用をする場合，組み込みDBの環境構築，組み込みDBのバックアップおよびバックアップからの回復で必要となるコマンドを次に示します。

ajsembdbbuildコマンド（組み込みDBの環境を構築する）

ajsembdbbackupコマンド（バックアップする）

ajsembdbrstrコマンド（バックアップから回復する）

これらコマンドの実行時に必要となるオプションを次の表に示します。

表15-5　コマンドの指定オプション

項番※
システムファイルの二重化
システムログの運用方法および回復方法に関するオプション

ajsembdbbuild
（-bs，-br，-bl）
ajsembdbbackup
（-s，-z）
ajsembdbrstr
（-lr，-l）

A
なし
なし
なし
なし

B
B-1
-bs
なし
なし

-z
なし

B-2
-lr

B-3
-s -z
-lr

C
C-1
-bs -bl
なし
なし

C-2
-l

C-3
-s
-l

A
あり
－
－
－

B
B-1
-br
なし
なし

-z
なし

B-2
-lr

B-3
-s -z
-lr

C
C-1
-br -bl
なし
なし

C-2
-l

C-3
-s
-l

（凡例）

－：該当しない。

注※

表15-3の項番に対応します。

ajsembdbbuildコマンドについては，「20. セットアップ時に使用するコマンド　ajsembdbbuild」を参照してください。

ajsembdbbackupコマンドおよびajsembdbrstrコマンドについては，マニュアル「JP1/Automatic Job Management System 2 コマンドリファレンス　1. コマンド」を参照してください。

15.2　組み込みDBのセットアップ

この節では，非クラスタ構成時に組み込みDBを使用する場合のインストール，環境構築および移行方法について説明します。

＜この節の構成＞

15.2.1　組み込みDBのインストール

15.2.2　組み込みDB環境の構築

15.2.3　組み込みDBへの移行

15.2.4　複数スケジューラーデータベースの組み込みDBへの移行

15.2.5　組み込みDBの再セットアップ

15.2.1　組み込みDBのインストール

ここでは，組み込みDB（JP1/AJS2 - Database option）のインストール方法を説明します。

なお，インストールにはJP1/AJS2シリーズプログラムの媒体に同梱されているHitachi PP Installerを使用してください。

組み込みDBをインストールするホストについての注意事項

組み込みDBは，JP1/AJS2 - Managerに付属します。同梱されるJP1/AJS2 - Managerと同一のマシンにインストールして使用してください。組み込みDBを単体で，別のマシンにインストールしたり，外部のクライアントソフトウェアから接続したりすることはできません。

＜この項の構成＞

(1)　組み込みDBインストール前の作業

(2)　組み込みDBを新規にインストールする

(3)　組み込みDBを上書きインストールする

(1)　組み込みDBインストール前の作業

ここでは，組み込みDBインストール前の作業について説明します。

(a)　カーネルパラメーターの確認・変更

組み込みDBが使うメッセージキューおよびセマフォ所要量を見積もり，必要に応じてカーネルパラメーターを変更する必要があります。カーネルパラメーターの見積もりについては，マニュアル「JP1/Automatic Job Management System 2 設計・運用ガイド　4.2.5 カーネルパラメーターを見積もる」を参照してください。

(b)　インストールディレクトリについて

インストールディレクトリを作成する必要はありません。インストールの実行時にインストールディレクトリ（/opt/HiRDB_J）が自動生成されます。

なお，インストールディレクトリをインストールする前に作成することもできますが，作成するインストールディレクトリは/opt/HiRDB_J固定になります。ほかのパス名のインストールディレクトリを作成しても，そのディレクトリ下に組み込みDBはインストールできません。

注意事項

組み込みDBは/opt/HiRDB_Jにインストールされるため，ルートパーティションには十分な空き領域を用意してください。ルートパーティションに十分な空き領域を確保できない場合は，/opt/HiRDB_Jを作成して別のディスクにマウントしてください。

(2)　組み込みDBを新規にインストールする

(a)　HP-UXの場合のインストール

組み込みDBをHP-UXの環境で使用する場合のインストール手順を次に示します。

組み込みDBをインストールするホストにスーパーユーザーでログインするかまたはsuコマンドでユーザーをスーパーユーザーに変更する。

すべてのプログラムを終了する。
既存のJP1シリーズのプログラムが動作している場合，必ず停止しておいてください。

媒体をセットする。

次のコマンドを実行して，CD-ROM装置をマウントする。

/usr/sbin/mount -F cdfs -r /dev/dsk/c0t2d0 /cdrom

/cdromはCD-ROMデバイススペシャルファイルのマウントポイントです。マウントポイントディレクトリがない場合は，作成してください。なお，デバイススペシャルファイル名およびマウントポイントはご使用の環境によって異なります。

次のコマンドを実行して，Hitachi PP Installerを起動する。

/cdrom/HPUX/SETUP※1，※2 /cdrom※2

Hitachi PP Installerが起動され，初期画面が表示されます。

注※1

CD-ROMのディレクトリ名やファイル名は，マシン環境によっては記述した内容と見え方が異なることがあります。lsコマンドで確認して，表示されたファイル名をそのまま入力してください。

注※2

ここではマウントポイントに/cdromを仮定します。

初期画面で「I」を入力する。
インストールできるプログラムの一覧が表示されます。

「JP1/AJS2 - Database option」を選択し，「I」を入力する。
選択したプログラムがインストールされます。なお，プログラムを選択するには，カーソルを移動させ，スペースバーで選択します。

インストールが正常終了したら，「Q」を入力する。
Hitachi PP Installerの初期画面に戻ります。

(b)　Solarisの場合のインストール

組み込みDBをSolarisの環境で使用する場合のインストール手順を次に示します。

組み込みDBをインストールするホストにスーパーユーザーでログインするかまたはsuコマンドでユーザーをスーパーユーザーに変更する。

すべてのプログラムを終了する。
既存のJP1シリーズのプログラムが動作している場合，必ず停止しておいてください。

媒体をセットする。

CD-ROM装置をマウントする。
通常は自動的にマウントされますが，マウントされない場合は，次のコマンドを実行してください。

/usr/sbin/mount -r -F hsfs /dev/dsk/c0t4d0s0 /cdrom

/cdromはCD-ROMデバイススペシャルファイルのマウントポイントです。マウントポイントディレクトリがない場合は，作成してください。なお，デバイススペシャルファイル名およびマウントポイントはご使用の環境によって異なります。

次のコマンドを実行して，Hitachi PP Installerを起動する。

/cdrom/cdrom/solaris/setup※1，※2 /cdrom/cdrom※2

Hitachi PP Installerが起動され，初期画面が表示されます。

注※1

CD-ROMのディレクトリ名やファイル名は，マシン環境によっては記述した内容と見え方が異なることがあります。lsコマンドで確認して，表示されたファイル名をそのまま入力してください。

注※2

ここではマウントポイントに/cdrom/cdromを仮定します。

初期画面で「I」を入力する。
インストールできるプログラムの一覧が表示されます。

「JP1/AJS2 - Database option」を選択し，「I」を入力する。
選択したプログラムがインストールされます。なお，プログラムを選択するには，カーソルを移動させ，スペースバーで選択します。

インストールが正常終了したら，「Q」を入力する。
Hitachi PP Installerの初期画面に戻ります。

(c)　AIXの場合のインストール

組み込みDBをAIXの環境で使用する場合のインストール手順を次に示します。

組み込みDBをインストールするホストにスーパーユーザーでログインするかまたはsuコマンドでユーザーをスーパーユーザーに変更する。

すべてのプログラムを終了する。
既存のJP1シリーズのプログラムが動作している場合，必ず停止しておいてください。

媒体をセットする。

次のコマンドを実行して，CD-ROM装置をマウントする。

/usr/sbin/mount -r -v cdrfs /dev/cd0 /cdrom

/cdromはCD-ROMデバイススペシャルファイルのマウントポイントです。マウントポイントディレクトリがない場合は，作成してください。なお，デバイススペシャルファイル名およびマウントポイントはご使用の環境によって異なります。

次のコマンドを実行して，Hitachi PP Installerを起動する。

/cdrom/AIX/SETUP※1，※2 /cdrom※2

Hitachi PP Installerが起動され，初期画面が表示されます。

注※1

CD-ROMのディレクトリ名やファイル名は，マシン環境によっては記述した内容と見え方が異なることがあります。lsコマンドで確認して，表示されたファイル名をそのまま入力してください。

注※2

ここではマウントポイントに/cdromを仮定します。

初期画面で「I」を入力する。
インストールできるプログラムの一覧が表示されます。

「JP1/AJS2 - Database option」を選択し，「I」を入力する。
選択したプログラムがインストールされます。なお，プログラムを選択するには，カーソルを移動させ，スペースバーで選択します。

インストールが正常終了したら，「Q」を入力する。
Hitachi PP Installerの初期画面に戻ります。

(d)　Linuxの場合のインストール

組み込みDBをLinuxの環境で使用する場合のインストール手順を次に示します。

組み込みDBをインストールするホストにスーパーユーザーでログインするかまたはsuコマンドでユーザーをスーパーユーザーに変更する。

すべてのプログラムを終了する。
既存のJP1シリーズのプログラムが動作している場合，必ず停止しておいてください。

媒体をセットする。

CD-ROM装置をマウントする。

次のコマンドを実行して，Hitachi PP Installerを起動する。

/mnt/cdrom/linux/setup※1，※2 /mnt/cdrom※2

Hitachi PP Installerが起動され，初期画面が表示されます。

注※1

CD-ROMのディレクトリ名やファイル名は，マシン環境によっては記述した内容と見え方が異なることがあります。lsコマンドで確認して，表示されたファイル名をそのまま入力してください。

注※2

ここではマウントポイントに/mnt/cdromを仮定します。

初期画面で「I」を入力する。
インストールできるプログラムの一覧が表示されます。

「JP1/AJS2 - Database」を選択し，「I」を入力する。
選択したプログラムがインストールされます。なお，プログラムを選択するには，カーソルを移動させ，スペースバーで選択します。

インストールが正常終了したら，「Q」を入力する。
Hitachi PP Installerの初期画面に戻ります。

(3)　組み込みDBを上書きインストールする

ここでは組み込みDBのバージョンアップインストールについて説明します。

(a)　バージョンアップ前にすること

バージョンアップをする前に，次に示すことを必ず実施してください。

組み込みDBのデータベースのバックアップを取得する
ajsembdbbackupコマンドで，組み込みDBのバックアップを取得してください。

組み込みDBをインストールするホストに，スーパーユーザーでログインするか，またはsuコマンドでユーザーをスーパーユーザーに変更する。

すべてのプログラムを終了する。
既存のJP1シリーズのプログラムが動作している場合，必ず停止しておいてください。

ajsembdbbackupコマンドで組み込みDBのバックアップを取得する。
ajsembdbbackupコマンド実行時，-sオプションを指定しないでください。指定した場合，ajsembdbrstrコマンドの実行時にエラーとなり回復できなくなります。

組み込みDBが稼働中かを確認する
組み込みDBの稼働状態をajsembdbstatusコマンドで確認してください。
ajsembdbstatusコマンドの実行例を次に示します。この例では，_JA0の組み込みDB識別子でセットアップした環境が構築されているものと仮定します。

ajsembdbstatus -s ust

HOSTNAME  : hostname(154313)
SYSTEMID  : ajs2
UNITID    : unt1
ENTRYHOST : hostname
PAIRHOST  :
UNIT-STAT FES-STAT SETUP-STAT
ONLINE    ******** SETUP

ajsembdbstatusコマンドの実行結果のUNIT-STATを参照してください。ONLINEと表示されている場合，組み込みDBは稼働中です。この場合，ajsembdbstopコマンドで組み込みDBを正常終了させてください。

組み込みDBが正常終了しているかを確認する
バージョンアップをする場合，組み込みDBが正常終了している必要があります。組み込みDBが稼働中かどうかを確認した結果，組み込みDBがすでに停止しているか，ajsembdbstopコマンドで停止した場合，組み込みDBが正常終了しているかを確認してください。
次に示すファイルに出力されるKFPS01850-Iメッセージを参照してください。このメッセージに表示されている終了モードがNORMALの場合，組み込みDBは正常終了しています。

組み込みDB運用ディレクトリ/spool/pdlog1

組み込みDB運用ディレクトリ/spool/pdlog2

（例）　KFPS01850-I HiRDB system terminated. mode=NORMAL
組み込みDBが正常終了していない場合は，次に示す手順で組み込みDBを正常終了させてください。

ajsembdbstartコマンドで組み込みDBを開始する。

ajsembdbstopコマンドで組み込みDBを正常終了する。

組み込みDB運用ディレクトリ下のファイルのバックアップを取得する
バージョンアップの失敗に備えて，次に示すファイルのバックアップをOSの機能（コマンド）で取得してください。

組み込みDB運用ディレクトリ下のconf下にある全ファイル

組み込みDB運用ディレクトリ下にあるユーザーが作成したファイル

なお，取得したバックアップは，新バージョンの動作確認後に削除してください。

(b)　バージョンアップ手順

組み込みDBをバージョンアップする手順を次に示します。

ajsembdbunsetコマンドに-rオプションを指定して実行する。

組み込みDBを上書きインストールする。
新しいバージョンの組み込みDBを上書きインストールします。

組み込みDB環境構築時に実行したajsembdbbuildコマンドの指定内容に-rsオプションの指定を追加して実行する。

ajsembdbbuild -l -d "/RDArea_JA0,/SYSArea1_JA0" -i /opt/HiRDB_J -id _JA0 -rs

組み込みDBを開始する。
非クラスタ環境の場合は，組み込みDBは自動的に開始しますが，クラスタ環境の場合は，ajsembdbstartコマンドを実行して組み込みDBを開始してください。
なお，システム共通定義のpd_mode_confオペランド指定値を変更すると組み込みDBの開始方法が変わります。

組み込みDB環境が複数ある場合，ほかの組み込みDB環境に対しても，手順1，手順3，および手順4を実施してください。

(c)　バージョンアップに失敗した場合

ここでは，次に示す現象が発生した場合の対処方法について説明します。

組み込みDBの開始時にリターンコードが5以上のKFPX24404-Iメッセージがメッセージログおよびsyslogに出力された。

メッセージログとは，次に示すファイルのことです。

組み込みDB運用ディレクトリ/spool/pdlog1

組み込みDB運用ディレクトリ/spool/pdlog2

この場合，一緒に出力されたメッセージを参照し，バージョンアップ失敗の原因を取り除いてください。

(d)　組み込みDBを旧バージョンに戻す場合

組み込みDBを旧バージョンに戻す手順を次に示します。

組み込みDBが自動起動しないように設定を変更する。
システム共通定義のpd_mode_confオペランドの設定値をMANUAL2に変更してください。なお，手順6でpd_mode_confオペランドの設定値を元に戻すため，変更前の設定値を忘れないようにしてください。

ajsembdbunsetコマンドに-rオプションを指定して実行する。

組み込みDBをアンインストールする。
組み込みDBのアンインストール方法については，「19.3 組み込みDBのアンインストール」を参照してください。

旧バージョンの組み込みDBをインストールする。
旧バージョンの組み込みDBをインストールします。組み込みDBのインストール方法については，「(2) 組み込みDBを新規にインストールする」を参照してください。

ajsembdbbuildコマンドに-rsオプションを指定して実行する。

組み込みDB運用ディレクトリ下のファイルを回復する。
「(a) バージョンアップ前にすること」の「組み込みDB運用ディレクトリ下のファイルのバックアップを取得する」で取得したバックアップから，旧バージョンの組み込みDB運用ディレクトリ下のファイルを回復します。
また，手順1で変更したシステム共通定義のpd_mode_confオペランドを変更前の設定値に戻してください。

システムファイルを初期化する。
システムログファイル，シンクポイントダンプファイル，およびステータスファイルを初期化します。次に示すコマンドラインを実行してください。

組み込みDB運用ディレクトリ/conf/fmkfs
組み込みDB運用ディレクトリ/conf/sysfint

また，旧バージョンでシステムログファイル，またはシンクポイントダンプファイルを追加した場合は，追加したファイルについても初期化します。
次に示すどちらかの操作で，システムログファイル，シンクポイントダンプファイルを初期化してください。

ajsembdbaddlogコマンドを使用して追加した場合
次に示すファイルを実行してください。
組み込みDB運用ディレクトリ/conf/embrm/addlog
なお，バージョンアップ後に，ajsembdbaddlogコマンドでシステムログファイル，またはシンクポイントダンプファイルを追加した場合は，バージョンアップ後に追加した領域も初期化します。

pdfmkfsコマンドおよびpdloginitコマンドを使用して追加した場合
追加時に実施した操作を再度実行してください。この作業は，JP1 Version 7iで構築した組み込みDB環境に戻す場合が該当します。

組み込みDBを回復する。
「(a) バージョンアップ前にすること」の「組み込みDB運用ディレクトリのデータベースのバックアップを取得する」で取得したバックアップから，旧バージョンの組み込みDBを回復します。
組み込みDBの回復手順を次に示します。

1. -rオプションを指定したajsembdbstartコマンドを実行して組み込みDBを開始する。

2. -Mオプションを指定したajsembdbrstrコマンドで，バックアップから組み込みDBのシステム領域を回復する。

3. ajsembdbstopコマンドで組み込みDBを正常終了する。

4. ajsembdbstartコマンドで組み込みDBを開始する。

5. ajsembdbrstrコマンドで，バックアップから組み込みDBのデータ領域を回復する。

コマンドの詳細については，マニュアル「JP1/Automatic Job Management System 2 コマンドリファレンス　1. コマンド」を参照してください。

15.2.2　組み込みDB環境の構築

組み込みDBの環境構築手順について次に示します。

各サービスを停止する。
物理ホストおよびすべての論理ホストで，JP1/AJS2サービス，JP1/AJS2 MonitorサービスおよびJP1/AJS2 Console Agentサービスを含め，スケジューラーデータベースにアクセスするサービスはすべて停止してください。

共用メモリー上の環境設定情報を削除する。
ajsshmdelコマンドを実行して，共用メモリー上の環境設定情報を削除します。

ajsshmdel >/dev/null 2>&1

組み込みDB環境構築コマンドを実行する。
ajsembdbbuildコマンドを使用して，組み込みDBの環境を構築します。
ajsembdbbuildコマンドを実行すると，次に示す処理が実行されます。

組み込みDBの定義情報作成

組み込みDBの領域作成

組み込みDBシステムの起動

大規模の組み込みDB環境を構築する場合のajsembdbbuildコマンドの指定例を次に説明します。表15-2および表15-3の項番の組み合わせについても示します。

指定例では次に示す設定値が設定，およびディレクトリが存在することと仮定します。

アンロードログファイル作成ディレクトリ：/Unload_Log_JA0

組み込みDB作業領域ディレクトリ：/WorkArea_JA0

組み込みDB運用ディレクトリ：/opt/HiRDB_J

組み込みDBセットアップ識別子：_JA0

また，指定例で使用するデータ領域作成ディレクトリおよびシステムファイル領域作成ディレクトリを次に示します。

領域種別 | ファイル種別
通常ファイル | RAWファイル
データ領域作成ディレクトリ | /RDArea_JA0 | /dev/rdb_JA0
システムファイル領域作成ディレクトリ1 | /SYSArea1_JA0 | /dev/rsys1_JA0
システムファイル領域作成ディレクトリ2 | /SYSArea2_JA0 | /dev/rsys2_JA0

●システムファイルを二重化しないで，システムログを使用した運用をしない場合

データ領域およびシステムファイル領域を通常ファイルで作成する場合（表15-2，表15-3の組み合わせが9-A）

ajsembdbbuild -l -d "/RDArea_JA0,/SYSArea1_JA0"
-i /opt/HiRDB_J -id _JA0

データ領域およびシステムファイル領域をRAWファイルで作成する場合（表15-2，表15-3の組み合わせが11-A）

ajsembdbbuild -l
-a "ajssys01=/dev/rdb_JA0,ajssys11=/dev/rsys1_JA0"
-d /WorkArea_JA0
-i /opt/HiRDB_J -id _JA0

●システムファイルを二重化しないで，システムログ運用（アンロードレス運用）をする場合

データ領域およびシステムファイル領域を通常ファイルで作成する場合（表15-2，表15-3の組み合わせが9-B）

ajsembdbbuild -l
-d "/RDArea_JA0,/SYSArea1_JA0" -bs -i /opt/HiRDB_J -id _JA0

データ領域およびシステムファイル領域をRAWファイルで作成する場合（表15-2，表15-3の組み合わせが11-B）

ajsembdbbuild -l
-a "ajssys01=/dev/rdb_JA0,ajssys11=/dev/rsys1_JA0"
-d /WorkArea_JA0
-bs -i /opt/HiRDB_J -id _JA0

●システムファイルを二重化しないで，アンロードログ運用をする場合

データ領域およびシステムファイル領域を通常ファイルで作成する場合（表15-2，表15-3の組み合わせが9-C）

ajsembdbbuild -l
-d "/RDArea_JA0,/SYSArea1_JA0" -bs -bl /Unload_Log_JA0
-i /opt/HiRDB_J -id _JA0

データ領域およびシステムファイル領域をRAWファイルで作成する場合（表15-2，表15-3の組み合わせが11-C）

ajsembdbbuild -l
-a "ajssys01=/dev/rdb_JA0,ajssys11=/dev/rsys1_JA0"
-d /WorkArea_JA0
-bs -bl /Unload_Log_JA0 -i /opt/HiRDB_J -id _JA0

●システムファイルを二重化し，システムログ運用（アンロードレス運用）をする場合

データ領域およびシステムファイル領域を通常ファイルで作成する場合（表15-2，表15-3の組み合わせが10-B）

ajsembdbbuild -l
-d "/RDArea_JA0,/SYSArea1_JA0,/SYSArea2_JA0"
-br -i /opt/HiRDB_J -id _JA0

データ領域およびシステムファイル領域をRAWファイルで作成する場合（表15-2，表15-3の組み合わせが12-B）

ajsembdbbuild -l
-a "ajssys01=/dev/rdb_JA0,ajssys11=/dev/rsys1_JA0,
ajssys17=/dev/rsys2_JA0" -d /WorkArea_JA0
-br -i /opt/HiRDB_J -id _JA0

●システムファイルを二重化し，アンロードログ運用をする場合

データ領域およびシステムファイル領域を通常ファイルで作成する場合（表15-2，表15-3の組み合わせが10-C）

ajsembdbbuild -l
-d "/RDArea_JA0,/SYSArea1_JA0,/SYSArea2_JA0"
-br -bl /Unload_Log_JA0 -i /opt/HiRDB_J -id _JA0

データ領域およびシステムファイル領域をRAWファイルで作成する場合（表15-2，表15-3の組み合わせが12-C）

ajsembdbbuild -l
-a "ajssys01=/dev/rdb_JA0,ajssys11=/dev/rsys1_JA0,
ajssys17=/dev/rsys2_JA0" -d /WorkArea_JA0
-br -bl /Unload_Log_JA0 -i /opt/HiRDB_J -id _JA0

ajsembdbbuildコマンドの詳細については，「20. セットアップ時に使用するコマンド　ajsembdbbuild」を参照してください。

補足事項

システムファイルを二重化し，システムログを使用した運用をしない（表15-2，表15-3の組み合わせが2-A，4-A，6-A，8-A，10-A，12-A）場合，環境を構築できません。

バージョンアップ作業で，環境構築時に実行したajsembdbbuildコマンドの指定内容が必要になるため，指定内容を記録しておいてください。

注意事項

組み込みDB環境を構築するホストのホスト名を，hostsファイルまたはDNSに登録してください。

組み込みDB環境を構築するホストのホスト名をjp1hosts定義ファイルに登録しても，組み込みDBで使用するホスト名として有効になりません。

組み込みDB環境を構築するホストのホスト名には，エイリアス名を使用しないでください。

組み込みDBが稼働できるホストのホスト名は，最大32バイトです。したがって，組み込みDB環境を構築するホストの物理ホスト名を1～32バイトで設定してください。

15.2.3　組み込みDBへの移行

ajsembdbsetupコマンドを使用して，ISAMで作成されているスケジューラーデータベースの内容を組み込みDBに移行します。

ajsembdbsetupコマンドを実行すると，次に示す処理が実行されます。

組み込みDBのデータベース情報の設定（スキーマ，テーブル）

組み込みDBへのスケジューラーデータベース情報の格納

JP1/AJS2環境設定パラメーターの設定

ISAMファイルの退避

大規模の組み込みDB環境で実行するajsembdbsetupコマンドの指定例を次に説明します。指定例では，次に示す設定値が設定されていることとします。

スケジューラーサービス名：AJSROOT1

組み込みDBセットアップ識別子：_JA0

ajsembdbsetup -F AJSROOT1 -ru l -id _JA0

補足事項

ajsembdbsetupコマンドを実行すると，次の表に示す環境設定パラメーターが設定されます。表に示す環境設定パラメーターについては設定値を変更しないでください。各環境設定パラメーターの詳細については，「14.1.3 スケジューラーサービス環境設定パラメーターの定義内容」を参照してください。

表15-6　ajsembdbsetupコマンド実行時に設定される環境設定パラメーター

環境設定パラメーター
定義内容
ajsembdbsetupコマンドで設定する内容※

AJSDBTYPE
データベース種別
EmbedDB

TABLENAMEPREFIX
テーブル名プリフィックス
次のどちらかが設定される。

-tpオプション指定値

AJS

TABLENAMEPOSTFIX
テーブルID
－

RDBAUTHID
RDB認可識別子
root

RDBUSER
RDBアクセスユーザー名
ajs2

RDBPASSWORD
RDBユーザーパスワード
－

RDBHOST
RDB接続先ホスト名
次のどれかが設定される。

物理ホスト名

-mhオプション指定値

環境変数JP1_HOSTNAMEの設定値

RDBPORT
RDB接続ポート番号
次のどちらかが設定される。

-pオプション指定値

22200

RDBIPC
RDBサーバとの通信方式
MEMORY

RDBSENDMEMSIZE
RDBプロセス間メモリ通信使用時の送信用メモリサイズ
次のどちらかが設定される。

-sオプション指定値

100

RDBRECVMEMSIZE
RDBプロセス間メモリ通信使用時の受信用メモリサイズ
次のどちらかが設定される。

-rオプション指定値

100

注※

設定内容が数値の場合は，10進数で表記しています。

15.2.4　複数スケジューラーデータベースの組み込みDBへの移行

ここでは，複数のスケジューラーデータベースを組み込みDBへ移行する方法について説明します。

＜この項の構成＞

(1)　スケジューラーサービスごとに異なる組み込みDB環境を構築する

(2)　一つの組み込みDB環境に複数のスケジューラーデータベースを移行する

(1)　スケジューラーサービスごとに異なる組み込みDB環境を構築する

複数のスケジューラーサービスが定義されていて，スケジューラーサービスごとに異なる組み込みDB環境を構築する場合，次に示す領域を別に準備してください。

なお，次に示す領域のうちシステムファイル領域，組み込みDB作業領域，アンロードログファイル作成ディレクトリについては，必要に応じて準備してください。

組み込みDB運用ディレクトリ

データ領域

システムファイル領域

組み込みDB作業領域

アンロードログファイル作成ディレクトリ

組み込みDB環境構築の際，使用するポート番号および組み込みDBセットアップ識別子が組み込みDB間で重複しないように指定する必要があります。そのため，ajsembdbbuildコマンドおよびajsembdbsetupコマンド実行時には，ポート番号を指定するオプション（-p）および組み込みDBセットアップ識別子を指定するオプション（-id）に，異なる値を指定してください。

セットアップの実施例を次に示します。

なお，この実施例は，「15.2.2 組み込みDB環境の構築」で示した環境がすでに構築されていることを前提に記載します。

組み込みDBの環境内容

データ領域作成ディレクトリ：/RDArea_JA1

システムファイル領域作成ディレクトリ1：/SYSArea1_JA1

システムファイル領域作成ディレクトリ2：/SYSArea2_JA1

アンロードログファイル作成ディレクトリ：/Unload_Log_JA1

組み込みDB運用ディレクトリ：/Embdb_JA1

スケジューラーサービス名：AJSROOT2

組み込みDBポート番号：22201

組み込みDBセットアップ識別子：_JA1

ajsembdbbuildコマンドの指定内容

ajsembdbbuild -l
-d "/RDArea_JA1,/SYSArea1_JA1,/SYSArea2_JA1"
-br -bl /Unload_Log_JA1 -i /Embdb_JA1 -p 22201 -id _JA1

ajsembdbsetupコマンドの指定内容

ajsembdbsetup -F AJSROOT2 -ru l -id _JA1 -p 22201

ajsembdbbuildコマンドおよびajsembdbsetupコマンドの詳細については，「20. セットアップ時に使用するコマンド」を参照してください。

(2)　一つの組み込みDB環境に複数のスケジューラーデータベースを移行する

一つの組み込みDB環境に複数のスケジューラーデータベースを移行する場合，組み込みDB内にはスケジューラーサービスごとに異なるテーブルを作成して管理する必要があります。そのため，ajsembdbsetupコマンド実行時のテーブル名プリフィックスを変更する必要があります。

また，該当する組み込みDBに対して二つ目以降のスケジューラーデータベースを移行する際には，一つ目のスケジューラーデータベースを移行した際にスキーマは作成済みとなっているため，ajsembdbsetupコマンドのスキーマ作成をスキップするオプション（-q）を指定します。

同じ組み込みDBに対して二つ目のスケジューラーデータベースを移行する際のajsembdbsetupコマンドの指定例を次に示します。

スケジューラーサービス名：AJSROOT3

テーブル名プリフィックス：AJS3

組み込みDBセットアップ識別子：_JA0

ajsembdbsetup -F AJSROOT3 -tp AJS3 -q -ru l -id _JA0

ajsembdbsetupコマンドの詳細については，「20. セットアップ時に使用するコマンド　ajsembdbsetup」を参照してください。

注意事項

一つの組み込みDB環境に複数のスケジューラーデータベースを移行した環境で，特定のスケジューラーデータベースだけを再構築することはできません。組み込みDB環境に移行したすべてのスケジューラーデータベースの再構築が必要となります。特定のスケジューラーデータベースだけを再構築したい場合は，スケジューラーサービスごとに組み込みDBを用意してください。構築方法については「(1) スケジューラーサービスごとに異なる組み込みDB環境を構築する」を参照してください。

一つの組み込みDB環境に複数のスケジューラーデータベースを移行した環境で，ajsembdbbackupコマンドを使用してバックアップする場合，特定のスケジューラーデータベースだけを対象にすることはできません。ajsembdbbackupコマンドでのバックアップは，該当する組み込みDB環境に移行したすべてのスケジューラーデータベースをバックアップ対象とし，そのバックアップを使用して回復すると，すべてのスケジューラーデータベースが回復されます。そのため，ajsembdbbackupコマンドおよびajsembdbrstrコマンドでバックアップ・リストアをする場合，該当する組み込みDBにアクセスするすべてのスケジューラーサービスを停止する必要があります。なお，ajsprintコマンドでユニット定義だけをバックアップする場合は，スケジューラーサービスを停止しないで，スケジューラーデータベースごとに取得できます。
また，ajsembdbbackupコマンドで特定のスケジューラーデータベースだけをバックアップ対象としたい場合は，スケジューラーサービスごとに組み込みDBを用意してください。構築方法については「(1) スケジューラーサービスごとに異なる組み込みDB環境を構築する」を参照してください。

15.2.5　組み込みDBの再セットアップ

組み込みDBを再セットアップする場合の，セットアップ手順を次に示します。

ajsprintコマンドで，ジョブネットの定義をバックアップする。
バックアップの方法については，マニュアル「JP1/Automatic Job Management System 2 設計・運用ガイド　11.2.2 JP1/AJS2 - Managerの設定情報のバックアップ」を参照してください。

物理ホストおよびすべての論理ホストで，JP1/AJS2サービス，JP1/AJS2 Monitorサービス，およびJP1/AJS2 Console Agentサービスを含め，スケジューラーデータベースにアクセスするサービスをすべて停止する。

ajsembdbunsetコマンドに-eオプションを指定して実行する。

ajsembdbbuildコマンドで，組み込みDBを構築する。

ISAM環境で構築する。

(1) ajsshmdelコマンドを実行して，共用メモリー上の環境設定情報を削除します。

ajsshmdel >/dev/null 2>&1

(2) 該当スケジューラーサービスの構成定義パラメーターをISAMに戻します。

(a) jbsgetcnf -h 論理ホスト名※ > 退避ファイル名

注※　物理ホストの場合は「-h 論理ホスト名」は指定しないでください。

(b) 退避ファイル内の該当スケジューラーサービスの構成定義パラメーターAJSDBTYPEをISAMに変更する。

(c) jbssetcnf 退避ファイル名

(3) マネージャー環境設定で，データベース種別を「ISAM」にし，次のコマンドを実行してISAMファイルでセットアップします。

ajssetup -F スケジューラーサービス名 -mh 論理ホスト名※

注※　物理ホストの場合は「-mh 論理ホスト名」を指定しないでください。

ajsembdbsetupコマンドで，組み込みDBにスケジューラーデータベースを移行する。

JP1/AJS2サービスおよびJP1/AJS2 Monitorサービスを起動する。

手順1でバックアップした，ジョブネット定義を回復する。
マニュアル「JP1/Automatic Job Management System 2 設計・運用ガイド　11.3.3 JP1/AJS2 - Managerの設定情報のリカバリー」を参照してください。

運用に必要なジョブネットの実行登録を実施する。

上記の手順に記載したコマンドの詳細については，「20. セットアップ時に使用するコマンド」を参照してください。

補足事項

一つの組み込みDB環境で，複数のスケジューラーデータベースがセットアップされている場合にajsembdbunsetコマンドを実行すると，すべてのスケジューラーデータベースの情報が削除されます。この場合，この項に示した手順のうち，手順1，5，6，8，9については，組み込みDB環境にセットアップされているすべてのスケジューラーデータベースに対して実施してください。

15.3　クラスタ構成時の実行系組み込みDBのセットアップ

この節では，クラスタ構成時の実行系組み込みDBを使用する場合のインストール，環境構築，および移行方法について説明します。

＜この節の構成＞

15.3.1　組み込みDBのインストール

15.3.2　組み込みDB環境の構築

15.3.3　組み込みDBへの移行

15.3.4　複数スケジューラーデータベースの組み込みDBへの移行

15.3.5　組み込みDBの再セットアップ

15.3.1　組み込みDBのインストール

インストールの手順については，「15.2.1 組み込みDBのインストール」を参照してください。

15.3.2　組み込みDB環境の構築

この節では，組み込みDBの環境構築方法について説明します。

各サービスを停止する。
物理ホストおよびすべての論理ホストで，JP1/AJS2サービス，JP1/AJS2 Monitorサービス，およびJP1/AJS2 Console Agentサービスを含め，スケジューラーデータベースにアクセスするサービスをすべて停止します。

共用メモリー上の環境設定情報を削除する。
ajsshmdelコマンドを実行して，共用メモリー上の環境設定情報を削除します。

ajsshmdel >/dev/null 2>&1

組み込みDB環境構築コマンドを実行する。
ajsembdbbuildコマンドを使用して，組み込みDBの環境を構築します。
ajsembdbbuildコマンドを実行することで，次の処理が実行されます。

組み込みDBの定義情報作成

組み込みDBの領域作成

組み込みDBシステムの起動

ajsembdbbuildコマンドの-dオプションおよび-aオプションに指定するデータ領域およびシステムファイル領域は，共有ディスク上の領域を指定して，-ldオプションに指定する組み込みDB作業領域および-iオプションに指定する組み込みDB運用ディレクトリは，ローカルディスク上の領域を指定してください。

大規模の組み込みDB環境を構築する場合のajsembdbbuildコマンドの指定例を示します。表15-2および表15-3の項番の組み合わせについても示します。

指定例では次の設定値を設定，またはディレクトリが存在することとします。

アンロードログファイル作成ディレクトリ：/Unload_Log_JAA

組み込みDB作業領域ディレクトリ：/WorkArea_JAA

組み込みDB運用ディレクトリ：/Embdb_JAA

スケジューラーサービス名：AJSROOT4

組み込みDBポート番号：22202

組み込みDBセットアップ識別子：_JAA

実行系物理ホスト名：physical_host

論理ホスト名：logical_host

また，指定例で使用するデータ領域作成ディレクトリおよびシステムファイル領域作成ディレクトリを次に示します。

領域種別 | ファイル種別
通常ファイル | RAWファイル
データ領域作成ディレクトリ | /share1/RDArea_JAA | /dev/vgshare1/rdb_JAA
システムファイル領域作成ディレクトリ1 | /share2/SYSArea_JAA | /dev/vgshare2/rsys_JAA
システムファイル領域作成ディレクトリ2 | /share3/SYSArea_JAA | /dev/vgshare3/rsys_JAA

●システムファイルを二重化しないで，システムログを使用した運用をしない場合

データ領域およびシステムファイル領域を通常ファイルで作成する場合（表15-2，表15-3の組み合わせが21-A）

ajsembdbbuild -l
-d "/share1/RDArea_JAA,/share2/SYSArea_JAA"
-ld /WorkArea_JAA -i /Embdb_JAA -p 22202 -id _JAA
-r -mh logical_host -eh physical_host

データ領域およびシステムファイル領域をRAWファイルで作成する場合（表15-2，表15-3の組み合わせが23-A）

ajsembdbbuild -l
-a "ajssys01=/dev/vgshare1/rdb_JAA,
ajssys11=/dev/vgshare2/rsys_JAA"
-ld /WorkArea_JAA -i /Embdb_JAA -p 22202 -id _JAA
-r -mh logical_host -eh physical_host

●システムファイルを二重化しないで，システムログ運用（アンロードレス運用）をする場合

データ領域およびシステムファイル領域を通常ファイルで作成する場合（表15-2，表15-3の組み合わせが21-B）

ajsembdbbuild -l
-d "/share1/RDArea_JAA,/share2/SYSArea_JAA"
-ld /WorkArea_JAA -bs -i /Embdb_JAA -p 22202 -id _JAA
-r -mh logical_host -eh physical_host

データ領域およびシステムファイル領域をRAWファイルで作成する場合（表15-2，表15-3の組み合わせが23-B）

ajsembdbbuild -l
-a "ajssys01=/dev/vgshare1/rdb_JAA,
ajssys11=/dev/vgshare2/rsys_JAA"
-ld /WorkArea_JAA -bs -i /Embdb_JAA -p 22202 -id _JAA
-r -mh logical_host -eh physical_host

●システムファイルを二重化しないで，アンロードログ運用をする場合

データ領域およびシステムファイル領域を通常ファイルで作成する場合（表15-2，表15-3の組み合わせが21-C）

ajsembdbbuild -l
-d "/share1/RDArea_JAA,/share2/SYSArea_JAA"
-ld /WorkArea_JAA -bs -bl /Unload_Log_JAA -i /Embdb_JAA
-p 22202 -id _JAA -r -mh logical_host -eh physical_host

データ領域およびシステムファイル領域をRAWファイルで作成する場合（表15-2，表15-3の組み合わせが23-C）

ajsembdbbuild -l
-a "ajssys01=/dev/vgshare1/rdb_JAA,
ajssys11=/dev/vgshare2/rsys_JAA"
-ld /WorkArea_JAA -bs -bl /Unload_Log_JAA -i /Embdb_JAA
-p 22202 -id _JAA -r -mh logical_host -eh physical_host

●システムファイルを二重化し，システムログ運用（アンロードレス運用）をする場合

データ領域およびシステムファイル領域を通常ファイルで作成する場合（表15-2，表15-3の組み合わせが22-B）

ajsembdbbuild -l
-d "/share1/RDArea_JAA,/share2/SYSArea_JAA,
/share3/SYSArea_JAA" -ld /WorkArea_JAA -br -i /Embdb_JAA
-p 22202 -id _JAA -r -mh logical_host -eh physical_host

データ領域およびシステムファイル領域をRAWファイルで作成する場合（表15-2，表15-3の組み合わせが24-B）

ajsembdbbuild -l
-a "ajssys01=/dev/vgshare1/rdb_JAA,
ajssys11=/dev/vgshare2/rsys_JAA,
ajssys17=/dev/vgshare3/rsys_JAA"
-ld /WorkArea_JAA -br -i /Embdb_JAA
-p 22202 -id _JAA -r -mh logical_host -eh physical_host

●システムファイルを二重化し，アンロードログ運用をする場合

データ領域およびシステムファイル領域を通常ファイルで作成する場合（表15-2，表15-3の組み合わせが22-C）

ajsembdbbuild -l
-d "/share1/RDArea_JAA,/share2/SYSArea_JAA,
/share3/SYSArea_JAA" -ld /WorkArea_JAA -br
-bl /Unload_Log_JAA -i /Embdb_JAA -p 22202 -id _JAA
-r -mh logical_host -eh physical_host

データ領域およびシステムファイル領域をRAWファイルで作成する場合（表15-2，表15-3の組み合わせが24-C）

ajsembdbbuild -l
-a "ajssys01=/dev/vgshare1/rdb_JAA,
ajssys11=/dev/vgshare2/rsys_JAA,
ajssys17=/dev/vgshare3/rsys_JAA" -ld /WorkArea_JAA -br
-bl /Unload_Log_JAA -i /Embdb_JAA -p 22202 -id _JAA -r
-mh logical_host -eh physical_host

ajsembdbbuildコマンドの詳細については，「20. セットアップ時に使用するコマンド　ajsembdbbuild」を参照してください。

補足事項

システムファイルを二重化し，システムログを使用した運用をしない（表15-2，表15-3の組み合わせが14-A，16-A，18-A，20-A，22-A，24-Aとなる）場合の環境は構築できません。

バージョンアップ作業で，環境構築時に実行したajsembdbbuildコマンドの指定内容が必要になるため，指定内容を記録しておいてください。

注意事項

組み込みDB環境を構築するホストは，実行系の物理ホスト名および論理ホスト名共にhostsファイルまたはDNSに登録してください。

組み込みDB環境を構築するホストのホスト名をjp1hosts定義ファイルに登録しても，組み込みDBで使用するホスト名として有効になりません。

組み込みDB環境を構築するホストのホスト名には，エイリアス名を使用しないでください。

組み込みDBが稼働できるホストのホスト名は，最大32バイトです。したがって，組み込みDB環境を構築するホストは，実行系の物理ホスト名および論理ホスト名共に1～32バイトで設定してください。

15.3.3　組み込みDBへの移行

ajsembdbsetupコマンドを使用して，ISAMで作成されているスケジューラーデータベースの内容を組み込みDBに移行します。ただし，移行作業を開始する前に，論理ホスト環境でスケジューラーサービスの設定およびスケジューラーデータベースがISAMで作成済みである必要があります。これらの設定が完了していることを確認してから，ajsembdbsetupコマンドを実行してください。

ajsembdbsetupコマンドを実行することで次の処理が実行されます。

組み込みDBのデータベース情報の設定（スキーマ，テーブル）

組み込みDBへのスケジューラーデータベース情報の格納

JP1/AJS2環境設定パラメーターの設定

ISAMファイルの退避

大規模の組み込みDB環境で実行するajsembdbsetupコマンドの指定例を次に示します。なお，次の設定値を仮定します。

スケジューラーサービス名：AJSROOT4

組み込みDBセットアップ識別子：_JAA

論理ホスト名：logical_host

ajsembdbsetup -F AJSROOT4 -ru l -id _JAA -mh logical_host

補足事項

ajsembdbsetupコマンドを実行することで次の環境設定パラメーターが設定されます。これらの環境設定パラメーターについては設定値を変更しないでください。また，それぞれの環境設定パラメーターの詳細については，「14.1.3 スケジューラーサービス環境設定パラメーターの定義内容」を参照してください。

表15-7　ajsembdbsetupコマンド実行時に設定される環境設定パラメーター

環境設定パラメーター
定義内容
ajsembdbsetupコマンドで
設定する内容※

AJSDBTYPE
データベース種別
EmbedDB

TABLENAMEPREFIX
テーブル名プリフィックス
次のどちらかが設定される。

-tpオプション指定値

AJS

TABLENAMEPOSTFIX
テーブルID
－

RDBAUTHID
RDB認可識別子
root

RDBUSER
RDBアクセスユーザー名
ajs2

RDBPASSWORD
RDBユーザーパスワード
－

RDBHOST
RDB接続先ホスト名
次のどちらかが設定される。

-mhオプション指定値

環境変数JP1_HOSTNAMEの設定値

RDBPORT
RDB接続ポート番号
次のどちらかが設定される。

-pオプション指定値

22200

RDBIPC
RDBサーバとの通信方式
MEMORY

RDBSENDMEMSIZE
RDBプロセス間メモリー通信使用時の送信用メモリーサイズ
次のどちらかが設定される。

-sオプション指定値

100

RDBRECVMEMSIZE
RDBプロセス間メモリー通信使用時の受信用メモリーサイズ
次のどちらかが設定される。

-rオプション指定値

100

注※

設定内容が数値の場合は，10進数で表記しています。

15.3.4　複数スケジューラーデータベースの組み込みDBへの移行

この節では，複数のスケジューラーデータベースを組み込みDBへ移行する方法について説明します。

＜この項の構成＞

(1)　スケジューラーサービスごとに異なる組み込みDB環境を構築する

(2)　一つの組み込みDB環境に複数のスケジューラーデータベースを移行する

(1)　スケジューラーサービスごとに異なる組み込みDB環境を構築する

複数のスケジューラーサービスが定義されていて，スケジューラーサービスごとに異なる組み込みDB環境を構築する場合，次に示す領域を別に準備してください。

組み込みDB運用ディレクトリ

データ領域

システムファイル領域

組み込みDB作業領域

アンロードログファイル作成ディレクトリ

上記に示す領域のうち，システムファイル領域，アンロードログファイル作成ディレクトリについては，必要に応じて準備してください。また，データ領域およびシステムファイル領域は，共有ディスク上の領域を指定してください。

組み込みDB環境構築の際，使用するポート番号および組み込みDBセットアップ識別子が組み込みDB間で重複しないように指定する必要があります。そのため，ajsembdbbuildコマンドおよびajsembdbsetupコマンドの実行時には，ポート番号を指定するオプション（-p）および組み込みDBセットアップ識別子を指定するオプション（-id）に異なる値を指定してください。

セットアップ例を次に示します。なお，この例は，「15.3.2 組み込みDB環境の構築」で示した環境がすでに構築されていることを前提に記載します。

組み込みDBの環境内容

追加する組み込みDBの環境内容を次に示します。

データ領域作成ディレクトリ：/share4/RDArea_JAB

システムファイル領域作成ディレクトリ1：/share5/SYSArea_JAB

システムファイル領域作成ディレクトリ2：/share6/SYSArea_JAB

アンロードログファイル作成ディレクトリ：/Unload_Log_JAB

組み込みDB作業領域：/WorkArea_JAB

組み込みDB運用ディレクトリ：/Embdb_JAB

スケジューラーサービス名：AJSROOT5

組み込みDBポート番号：22203

組み込みDBセットアップ識別子：_JAB

実行系物理ホスト名：physical_host

論理ホスト名：logical_host

ajsembdbbuildコマンドの指定内容

ajsembdbbuildコマンドの指定内容を次に示します。

ajsembdbbuild -l
-d "/share4/RDArea_JAB,/share5/SYSArea_JAB,
/share6/SYSArea_JAB" -ld /WorkArea_JAB -br
-bl /Unload_Log_JAB -i /Embdb_JAB -p 22203
-id _JAB -r -mh logical_host -eh physical_host

ajsembdbsetupコマンドの指定内容

ajsembdbsetupコマンドの指定内容を次に示します。

ajsembdbsetup -F AJSROOT5 -ru l -id _JAB -p 22203
-mh logical_host

ajsembdbbuildコマンドおよびajsembdbsetupコマンドの詳細については，「20. セットアップ時に使用するコマンド」を参照してください。

(2)　一つの組み込みDB環境に複数のスケジューラーデータベースを移行する

一つの組み込みDB環境に複数のスケジューラーデータベースを移行する場合，組み込みDB内にはスケジューラーサービスごとに異なるテーブルを作成して管理する必要があります。そのため，ajsembdbsetupコマンド実行時のテーブル名プリフィックスを変更する必要があります。

また，該当する組み込みDBに対して二つ目以降のスケジューラーデータベースを移行する際には，一つ目のスケジューラーデータベースを移行した際にスキーマが作成済みとなっているため，ajsembdbsetupコマンドのスキーマ作成をスキップするオプション（-q）を指定します。

同じ組み込みDBに対して二つ目のスケジューラーデータベースを移行する際のajsembdbsetupコマンドの指定例を次に示します。なお，次の設定値を仮定します。

スケジューラーサービス名：AJSROOT6

テーブル名プリフィックス：AJS2

組み込みDBセットアップ識別子：_JAA

論理ホスト名：logical_host

ajsembdbsetup -F AJSROOT6 -tp AJS2 -q -ru l -id _JAA -mh logical_host

ajsembdbsetupコマンドの詳細については，「20. セットアップ時に使用するコマンド　ajsembdbsetup」を参照してください。

注意事項

一つの組み込みDB環境に複数のスケジューラーデータベースを移行した環境で，特定のスケジューラーデータベースだけを再構築することはできません。組み込みDB環境に移行したすべてのスケジューラーデータベースの再構築が必要となります。特定のスケジューラーデータベースだけを再構築したい場合は，スケジューラーサービスごとに組み込みDBを用意してください。構築方法については「(1) スケジューラーサービスごとに異なる組み込みDB環境を構築する」を参照してください。

一つの組み込みDB環境に複数のスケジューラーデータベースを移行した環境で，ajsembdbbackupコマンドを使用してバックアップする場合，特定のスケジューラーデータベースだけを対象にはできません。ajsembdbbackupコマンドでのバックアップは，該当する組み込みDB環境に移行したすべてのスケジューラーデータベースをバックアップ対象とし，そのバックアップを使用して回復すると，すべてのスケジューラーデータベースを回復します。そのため，ajsembdbbackupコマンドおよびajsembdbrstrコマンドでバックアップ・リストアをする場合，該当する組み込みDBにアクセスするすべてのスケジューラーサービスを停止する必要があります。
なお，ajsprintコマンドでユニット定義だけをバックアップする場合は，スケジューラーサービスを停止しないで，スケジューラーデータベースごとに取得できます。
ajsembdbbackupコマンドで特定のスケジューラーデータベースだけをバックアップ対象としたい場合は，スケジューラーサービスごとに組み込みDBを用意してください。構築方法については「(1) スケジューラーサービスごとに異なる組み込みDB環境を構築する」を参照してください。

一つの組み込みDB環境に論理ホストのスケジューラーデータベース，および物理ホストのスケジューラーデータベースを混在して移行できません。

15.3.5　組み込みDBの再セットアップ

組み込みDBの再セットアップについては，「15.2.5 組み込みDBの再セットアップ」を参照してください。

15.4　クラスタ構成時の待機系組み込みDBのセットアップ

この節では，クラスタ構成時に待機系組み込みDBを使用する場合のインストール，環境構築，および移行方法について説明します。

＜この節の構成＞

15.4.1　組み込みDBのインストール

15.4.2　組み込みDB環境の構築

15.4.3　組み込みDBへの移行

15.4.4　複数スケジューラーデータベースの組み込みDBへの移行

15.4.5　組み込みDBの再セットアップ

15.4.1　組み込みDBのインストール

インストールの手順については，「15.2.1 組み込みDBのインストール」を参照してください。

15.4.2　組み込みDB環境の構築

組み込みDBの環境構築方法について説明します。

各サービスを停止する。
物理ホストおよびすべての論理ホストで，JP1/AJS2サービス，JP1/AJS2 Monitorサービス，およびJP1/AJS2 Console Agentサービスを含め，スケジューラーデータベースにアクセスするサービスをすべて停止します。

共用メモリー上の環境設定情報を削除する。
ajsshmdelコマンドを実行して，共用メモリー上の環境設定情報を削除します。

ajsshmdel >/dev/null 2>&1

組み込みDB環境構築コマンドを実行する。
ajsembdbbuildコマンドで組み込みDBの環境を構築します。
ajsembdbbuildコマンドを実行することで，次の処理が行われます。

組み込みDBの定義情報作成

組み込みDB作業領域の作成

待機系でajsembdbbuildコマンドを実行する場合は，-rオプションではなく，-fオプションを指定してください。その他の引数については，実行系で指定した内容と同じ内容を指定してください。

大規模の組み込みDB環境を構築する場合のajsembdbbuildコマンドの指定例を示します。表15-2および表15-3の項番の組み合わせについても示します。

指定例では次に示す設定値が設定，およびディレクトリが存在することと仮定します。

アンロードログファイル作成ディレクトリ：/Unload_Log_JAA

組み込みDB作業領域ディレクトリ：/WorkArea_JAA

組み込みDBインストールフォルダ：/Embdb_JAA

スケジューラーサービス名：AJSROOT4

組み込みDBポート番号：22202

組み込みDBセットアップ識別子：_JAA

実行系物理ホスト名※：physical_host

論理ホスト名：logical_host

注※

待機系の組み込みDBの環境構築についても，実行系の物理ホスト名をajsembdbbuildコマンドの-ehオプションに指定する必要があります。

また，指定例で使用するデータ領域作成ディレクトリおよびシステムファイル領域作成ディレクトリを次に示します。

領域種別 | ファイル種別
通常ファイル | RAWファイル
データ領域作成ディレクトリ | /share1/RDArea_JAA | /dev/vgshare1/rdb_JAA
システムファイル領域作成ディレクトリ1 | /share2/SYSArea_JAA | /dev/vgshare2/rsys_JAA
システムファイル領域作成ディレクトリ2 | /share3/SYSArea_JAA | /dev/vgshare3/rsys_JAA

●システムファイルを二重化しないで，システムログを使用した運用をしない場合

データ領域およびシステムファイル領域を通常ファイルで作成する場合（表15-2，表15-3の組み合わせが21-A）

ajsembdbbuild -l
-d "/share1/RDArea_JAA,/share2/SYSArea_JAA"
-ld /WorkArea_JAA -i /Embdb_JAA -p 22202 -id _JAA
-f -mh logical_host -eh physical_host

データ領域およびシステムファイル領域をRAWファイルで作成する場合（表15-2，表15-3の組み合わせが23-A）

ajsembdbbuild -l
-a "ajssys01=/dev/vgshare1/rdb_JAA,
ajssys11=/dev/vgshare2/rsys_JAA"
-ld /WorkArea_JAA -i /Embdb_JAA -p 22202 -id _JAA -f
-mh logical_host -eh physical_host

●システムファイルを二重化しないで，システムログ運用（アンロードレス運用）をする場合

データ領域およびシステムファイル領域を通常ファイルで作成する場合（表15-2，表15-3の組み合わせが21-B）

ajsembdbbuild -l
-d "/share1/RDArea_JAA,/share2/SYSArea_JAA"
-ld /WorkArea_JAA -bs -i /Embdb_JAA -p 22202 -id _JAA
-f -mh logical_host -eh physical_host

データ領域およびシステムファイル領域をRAWファイルで作成する場合（表15-2，表15-3の組み合わせが23-B）

ajsembdbbuild -l
-a "ajssys01=/dev/vgshare1/rdb_JAA,
ajssys11=/dev/vgshare2/rsys_JAA"
-ld /WorkArea_JAA -bs -i /Embdb_JAA -p 22202 -id _JAA
-f -mh logical_host -eh physical_host

●システムファイルを二重化しないで，アンロードログ運用をする場合

データ領域およびシステムファイル領域を通常ファイルで作成する場合（表15-2，表15-3の組み合わせが21-C）

ajsembdbbuild -l
-d "/share1/RDArea_JAA,/share2/SYSArea_JAA"
-ld /WorkArea_JAA -bs -bl /Unload_Log_JAA -i /Embdb_JAA
-p 22202 -id _JAA -f -mh logical_host -eh physical_host

データ領域およびシステムファイル領域をRAWファイルで作成する場合（表15-2，表15-3の組み合わせが23-C）

ajsembdbbuild -l
-a "ajssys01=/dev/vgshare1/rdb_JAA,
ajssys11=/dev/vgshare2/rsys_JAA "
-ld /WorkArea_JAA -bs -bl /Unload_Log_JAA -i /Embdb_JAA
-p 22202 -id _JAA -f -mh logical_host -eh physical_host

●システムファイルを二重化し，システムログ運用（アンロードレス運用）をする場合

データ領域およびシステムファイル領域を通常ファイルで作成する場合（表15-2，表15-3の組み合わせが22-B）

ajsembdbbuild -l
-d "/share1/RDArea_JAA,/share2/SYSArea_JAA,
/share3/SYSArea_JAA" -ld /WorkArea_JAA -br -i /Embdb_JAA
-p 22202 -id _JAA -f -mh logical_host -eh physical_host

データ領域およびシステムファイル領域をRAWファイルで作成する場合（表15-2，表15-3の組み合わせが24-B）

ajsembdbbuild -l
-a "ajssys01=/dev/vgshare1/rdb_JAA,
ajssys11=/dev/vgshare2/rsys_JAA,
ajssys17=/dev/vgshare3/rsys_JAA" -ld /WorkArea_JAA -br
-i /Embdb_JAA -p 22202 -id _JAA -f -mh logical_host
-eh physical_host

●システムファイルを二重化し，アンロードログ運用をする場合

データ領域およびシステムファイル領域を通常ファイルで作成する場合（表15-2，表15-3の組み合わせが22-C）

ajsembdbbuild -l
-d "/share1/RDArea_JAA,/share2/SYSArea_JAA,
/share3/SYSArea_JAA"
-ld /WorkArea_JAA -br -bl /Unload_Log_JAA -i /Embdb_JAA
-p 22202 -id _JAA -f -mh logical_host -eh physical_host

データ領域およびシステムファイル領域をRAWファイルで作成する場合（表15-2，表15-3の組み合わせが24-C）

ajsembdbbuild -l
-a "ajssys01=/dev/vgshare1/rdb_JAA,
ajssys11=/dev/vgshare2/rsys_JAA,
ajssys17=/dev/vgshare3/rsys_JAA" -ld /WorkArea_JAA
-br -bl /Unload_Log_JAA -i /Embdb_JAA -p 22202
-id _JAA -f -mh logical_host -eh physical_host

ajsembdbbuildコマンドの詳細については，「20. セットアップ時に使用するコマンド　ajsembdbbuild」を参照してください。

補足事項

システムファイルの二重化をして，システムログを使用した運用をしない（表15-2，表15-3の組み合わせが14-A，16-A，18-A，20-A，22-A，24-Aとなる）場合，環境は構築できません。

バージョンアップ作業で，環境構築時に実行したajsembdbbuildコマンドの指定内容が必要になるため，指定内容を記録しておいてください。

注意事項

組み込みDB環境を構築するホストは，実行系の物理ホスト名および論理ホスト名共にhostsファイルまたはDNSに登録してください。

組み込みDB環境を構築するホストのホスト名をjp1hosts定義ファイルに登録しても，組み込みDBで使用するホスト名として有効になりません。

組み込みDB環境を構築するホストのホスト名には，エイリアス名を使用しないでください。

組み込みDBが稼働できるホストのホスト名は，最大32バイトです。したがって，組み込みDB環境を構築するホストは，実行系の物理ホスト名および論理ホスト名共に1～32バイトで設定してください。

15.4.3　組み込みDBへの移行

待機系での作業は実行系での移行作業とは異なり，ajsembdbsetupコマンドを実行する必要はありませんが，実行系と待機系で共通定義情報の設定内容を合わせる必要があります。

共通定義情報の設定手順を次に示します。

実行系で組み込みDBのセットアップを実施する。

手順1の作業完了後，実行系でjbsgetcnfコマンドを実行して共通定義情報をファイルに退避する。
実行するコマンドを次に示します。

jbsgetcnf -h 論理ホスト名 > 退避ファイル名

手順2で作成したファイルを待機系にコピーする。

手順3の作業完了後，待機系でjbssetcnfコマンドを実行して共通定義情報を設定する。
実行するコマンドを次に示します。

jbssetcnf 退避ファイル名

以上で待機系での移行作業は完了です。

実行系でのセットアップについては，「15.3.3 組み込みDBへの移行」または「15.3.4 複数スケジューラーデータベースの組み込みDBへの移行」を参照してください。

jbsgetcnfコマンドおよびjbssetcnfコマンドについては，マニュアル「JP1/Base 運用ガイド」を参照してください。

15.4.4　複数スケジューラーデータベースの組み込みDBへの移行

ここでは，複数のスケジューラーデータベースを組み込みDBへ移行する方法について説明します。

＜この項の構成＞

(1)　スケジューラーサービスごとに異なる組み込みDB環境を構築する

(2)　一つの組み込みDB環境に複数のスケジューラーデータベースを移行する

(1)　スケジューラーサービスごとに異なる組み込みDB環境を構築する

複数のスケジューラーサービスが定義されていて，スケジューラーサービスごとに異なる組み込みDB環境を構築する場合，次に示す領域を別に準備してください。

組み込みDB運用ディレクトリ

組み込みDB作業領域

アンロードログファイル作成ディレクトリ

上記の領域のうち，アンロードログファイル作成ディレクトリについては，必要に応じて準備してください。

待機系の環境構築時は，データ領域およびシステムファイル領域は作成しません。データ領域およびシステムファイル領域は，実行系の環境構築時，共有ディスク上に作成します。

組み込みDB環境構築の際，使用するポート番号および組み込みDBセットアップ識別子が組み込みDB間で重複しないように指定する必要があります。そのため，ajsembdbbuildコマンド実行時には，ポート番号を指定するオプション（-p）および組み込みDBセットアップ識別子を指定するオプション（-id）に，異なる値を指定してください。

セットアップ例を次に示します。なお，この例は「15.4.2 組み込みDB環境の構築」で示した環境がすでに構築されていることを前提に記載します。

組み込みDBの環境内容

追加する組み込みDBの環境内容を次に示します。

データ領域作成ディレクトリ：/share4/RDArea_JAB

システムファイル領域作成ディレクトリ1：/share5/SYSArea_JAB

システムファイル領域作成ディレクトリ2：/share6/SYSArea_JAB

アンロードログファイル作成ディレクトリ：/Unload_Log_JAB

組み込みDB作業領域：/WorkArea_JAB

組み込みDB運用ディレクトリ：/Embdb_JAB

スケジューラーサービス名：AJSROOT5

組み込みDBポート番号：22203

組み込みDBセットアップ識別子：_JAB

実行系物理ホスト名：physical_host

論理ホスト名：logical_host

ajsembdbbuildコマンドの指定内容

ajsembdbbuildコマンドの指定内容を次に示します。

ajsembdbbuild -l
-d "/share4/RDArea_JAB,/share5/SYSArea_JAB,
/share6/SYSArea_JAB"
-ld /WorkArea_JAB -br -bl /Unload_Log_JAB -i /Embdb_JAB
-p 22203 -id _JAB -f -mh logical_host -eh physical_host

組み込みDBへの移行方法

組み込みDBへの移行方法については，「15.4.3 組み込みDBへの移行」で示した指定例を参照してください。

ajsembdbbuildコマンドおよびajsembdbsetupコマンドの詳細については，「20. セットアップ時に使用するコマンド」を参照してください。

(2)　一つの組み込みDB環境に複数のスケジューラーデータベースを移行する

「15.4.3 組み込みDBへの移行」を参照してください。

15.4.5　組み込みDBの再セットアップ

組み込みDBを再セットアップする場合の，セットアップ手順を次に示します。

ajsembdbunsetコマンドに-eオプションを指定して実行する。

ajsembdbbuildコマンドで，組み込みDBを構築する。

実行系の共通定義情報を待機系に設定する。
実行系でのセットアップ完了後，実行系でjbsgetcnfコマンドを実行し，共通定義情報をファイルに退避します。
その退避したファイルを待機系にコピーし，jbssetcnfコマンドに指定して実行します。実行するコマンドを次に示します。

実行系で実行するコマンド
jbsgetcnf -h 論理ホスト名 > 退避ファイル名

待機系で実行するコマンド
jbssetcnf 退避ファイル名

ajsembdbunsetコマンドおよびajsembdbbuildコマンドの詳細については，「20. セットアップ時に使用するコマンド」を参照してください。また，jbsgetcnfコマンドおよびjbssetcnfコマンドについては，マニュアル「JP1/Base 運用ガイド」を参照してください。

15.5　クラスタ構成時の組み込みDBの設定変更

クラスタに関するシステム定義のうち，変更できる定義について説明します。

この節で説明するシステム定義は，システム共通定義ファイルに設定する定義です。システム共通定義ファイルとは，次に示すファイルのことです。

組み込みDB運用ディレクトリ/conf/pdsys

システム共通定義ファイルは，ajsembdbbuildコマンドを実行することで作成されます。そのため，システム共通定義ファイルは，ajsembdbbuildコマンドの実行後に編集してください。

クラスタに関するシステム定義のうち，変更できる定義を次に示します。

pd_mode_conf = 組み込みDBの開始方法
pd_mode_confの設定値を次に示します。

MANUAL1
組み込みDBを手動開始します。ただし，組み込みDBが異常終了した場合に限り，組み込みDBの再開始は自動開始になります。

MANUAL2
組み込みDBを手動開始します。MANUAL1とは異なり，自動開始することはありません。

AUTO
組み込みDBを自動開始します。OSを起動すると，自動的に組み込みDBを開始します。また，組み込みDB異常終了後の再開始についても自動開始します。

ajsembdbbuildコマンド実行時に，-rオプションまたは-fオプションを指定して環境構築した場合の，pd_mode_confの初期値はMANUAL1です。

クラスタ構成時は，MANUAL1またはMANUAL2を設定してください。構築する環境に応じて設定値を変更してください。

システム共通定義ファイルの編集は，次の手順で行ってください。

実行系

組み込みDBを使用しているスケジューラーサービスを停止する。

組み込みDBを停止する。

システム共通定義ファイルを編集する。

組み込みDBを起動する。

組み込みDBを使用しているスケジューラーサービスを起動する。

待機系
実行系での作業後，次のどちらかの方法でシステム共通定義ファイルを変更してください。

実行系で編集したシステム共通定義ファイルを，待機系の環境にコピーする。

実行系の手順3と同じ内容で編集する。

15.6　組み込みDBのクラスタソフトへの登録

クラスタスクリプトでは，ajsembdbstartコマンドおよびajsembdbstopコマンドを実行するようにしてください。

注意事項

ajsembdbstartコマンド実行時には，-idオプションだけを指定してください。また，このコマンドは，JP1/AJS2サービスを起動するよりも先に実行する必要があります。

ajsembdbstopコマンド実行時には，-fオプション，-qオプション，-idオプションを指定してください。また，このコマンドは，JP1/AJS2サービス停止後に実行する必要があります。

クラスタソフトへの登録については，各クラスタソフトのマニュアルを参照してください。

16.　運用形態に合わせた各種設定

この章では，JP1/AJS2の運用形態に合わせた設定について説明します。

＜この章の構成＞

16.1　ジョブ実行時のワークパスを変数として定義する

16.2　転送元ファイルの検索パスを定義する

16.3　JP1ユーザー仮定機能の設定

16.4　エージェントのパイプ通信タイムアウト値の変更

16.5　ジョブプロセス実行準備完了通知時のタイムアウト値の設定

16.6　イベントジョブのログサイズの設定の変更

16.7　イベント順序保証オプションの設定

16.8　ファイル監視ジョブの状態引き継ぎオプションの設定

16.9　「"（ダブルクォーテーションマーク）」を含むデータをイベントジョブの引き継ぎ情報に使用するための設定

16.10　ジョブの標準出力と標準エラー出力を同時に確認する設定

16.11　イベントジョブを使用したDNS運用時にFQDN形式で運用するための設定

16.12　キューレスジョブ環境でクラスを指定したジョブを実行するための設定

16.13　ファイル受信制限をするための設定

16.14　ジョブ・イベントジョブのエラーメッセージをsyslogに出力するための設定

16.15　ジョブの結果ファイルの再送間隔・再送回数の変更

16.16　ジョブ結果ファイルの二重受信防止の設定

16.17　TCP/IP通信接続エラーのリトライ間隔・回数の変更

16.18　ジョブを配信するエージェントホストの決定方式の設定

16.19　マクロ変数の展開失敗時の動作の設定

16.20　マクロ変数の引き継ぎ情報がNULL文字列の場合の置き換え方法の設定

16.21　ラージファイルを監視するための設定

16.22　エージェントの障害回復待ち時間を短縮する設定方法

16.23　ジョブ情報削除処理に関する設定

16.24　新規インストール後に以前のバージョンの設定に戻す方法

16.25　ジョブ実行多重度到達を確認するメッセージを出力する設定

16.26　JP1/AJS2から起動される子プロセスを，SIGCHLDシグナルを受信する設定（SIG_DFL）に変更する方法

16.27　サブミットジョブの実行順序の入れ替わりを防止する設定

16.28　ジョブ情報列挙時にジョブ実行制御マネージャー（jpqman）のメモリー消費量を少なくする設定

16.29　ジョブ実行制御のマネージャープロセスに対する通信タイムアウト時間の変更

16.30　JP1/AJS2のサービスが停止してもイベントジョブの実行を継続させる設定

16.31　イベント・アクション制御エージェント起動通知の送信に失敗した場合に再送を行う設定

16.32　ジョブ実行時のファイル権限チェックでアクセス制御リストやセカンダリーグループの設定を有効にする

16.33　エージェントホスト名の名前解決オプションの設定

16.34　イベント・アクション制御のプロセス間通信でのデータ到着待ちタイムアウト化オプションの設定

16.35　イベントジョブを実行する場合のマネージャーホスト名を固定化する設定

16.36　エージェント自動定義機能で作成されるキュー属性値をカスタマイズする設定

16.37　ユーザー情報取得時のリトライを変更する設定

16.1　ジョブ実行時のワークパスを変数として定義する

PCジョブ，UNIXジョブ，およびQUEUEジョブの詳細定義では，次の項目のワークパスを変数で定義できます。この変数はエージェントホストごとに異なる値を定義できるため，エージェントホストごとに異なるワークパスでジョブが実行できます。

表16-1　ジョブ定義の変数指定可能項目一覧

ジョブ定義時の指定項目 | 使用可否
コマンド文（UNIX限定） | ○
実行ファイル名（Windows限定） | ○
スクリプトファイル名（UNIX限定）※ | ○
パラメーター | ○
環境変数 | ×
環境変数ファイル名 | ×
ワークパス | ×
標準入力ファイル名 | ○
標準出力ファイル名 | ○
標準エラー出力ファイル名 | ○
転送元ファイル名 | ×
転送先ファイル名 | ×

（凡例）

○：指定できる。

×：指定できない。

注※

スクリプトファイルの中身は対象外。

ジョブ実行時のワークパスを変数として定義する手順を次に示します。

＜この節の構成＞

(1)　定義手順

(2)　定義パラメーター一覧

(3)　定義内容

(4)　定義例

(5)　注意事項

(1)　定義手順

JP1/AJS2のサービスを停止する。
次のコマンドを実行して，プロセスがすべて停止していることを確認します。

# /etc/opt/jp1ajs2/jajs_stop※1
# /opt/jp1ajs2/bin/jajs_spmd_status
# /opt/jp1ajs2/bin/ajsqlstop※2
# /opt/jp1ajs2/bin/ajsqlstatus※2

注※1

自動停止の設定が行われていることを確認してください。

注※2

キューレスジョブを使用している場合だけ実行する必要があります。

viなどのエディターで，「(2) 定義パラメーター一覧」の定義パラメーターを記述した設定ファイルを作成する。
設定ファイルのファイル名は任意です。

ファイルを保存し，次のコマンドを実行する。

jbssetcnf 設定ファイル名

jbssetcnfコマンドのパスは，「/opt/jp1base/bin/jbssetcnf」です。
jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

手順1で停止したサービスを再起動する。
設定ファイルに記述した内容が反映されます。

(2)　定義パラメーター一覧

表16-2　ジョブ実行時のワークパス変数定義パラメーター一覧

定義キー | 環境設定パラメーター | 定義内容
[{JP1_DEFAULT|論理ホスト名}¥JP1NBQAGENT¥Variable]※ | "変数名"= | 変数名に対応したワークパスを入力します。

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

(3)　定義内容

"変数名"="値"

変数名

「$変数名$」で指定する文字列を入力します。なお，ここで定義した変数名は，ファイルパス名やパラメーターで使用できます。

値

変数名に対応した実行プログラムの，そのホストでのインストールパスを入力します。

注意事項

環境設定パラメーターを誤って設定した場合は，「付録E 誤った環境設定パラメーターを設定したときの回復方法」を参照し，手順に従って回復してください。

(4)　定義例

例えば，「prog1」という名称のジョブプログラムのインストールパスがホストごとに異なっていて，Agent1ホストでは「/usr/i1/pp1/bin」に，Agent2ホストでは「/usr/i2/pp1/bin」に，それぞれインストールされているとします。この場合，次のように定義します。

ジョブの定義

ファイル名=$pp1_inst$/prog1

Agent1ホストでの設定

[{JP1_DEFAULT|論理ホスト名}¥JP1NBQAGENT¥Variable]
"pp1_inst"="/usr/i1/pp1/bin"

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

Agent2ホストでの設定

[{JP1_DEFAULT|論理ホスト名}¥JP1NBQAGENT¥Variable]
"pp1_inst"="/usr/i2/pp1/bin"

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

この定義によって，Agent1ホストでは「/usr/i1/pp1/bin/prog1」が実行され，Agent2ホストでは「/usr/i2/pp1/bin/prog1」が実行されます。

(5)　注意事項

「JP1」から始まる文字列はシステムで使用するため，指定しないでください。

16.2　転送元ファイルの検索パスを定義する

転送元ファイルの検索パスを定義すると，相対パス指定でもパス解決ができます。

検索パスの定義方法を次に示します。

＜この節の構成＞

(1)　定義手順

(2)　定義パラメーター一覧

(3)　定義内容

(4)　定義例

(1)　定義手順

JP1/AJS2のサービスを停止する。
次のコマンドを実行して，プロセスがすべて停止していることを確認します。

# /etc/opt/jp1ajs2/jajs_stop※1
# /opt/jp1ajs2/bin/jajs_spmd_status
# /opt/jp1ajs2/bin/ajsqlstop※2
# /opt/jp1ajs2/bin/ajsqlstatus※2

注※1

自動停止の設定が行われていることを確認してください。

注※2

キューレスジョブを使用している場合だけ実行する必要があります。

viなどのエディターで，「(2) 定義パラメーター一覧」の定義パラメーターを記述した検索パス定義ファイルを作成する。

ファイルを保存し，次のコマンドを実行する。

jbssetcnf 検索パス定義ファイル名

jbssetcnfコマンドのパスは，「/opt/jp1base/bin/jbssetcnf」です。
jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

手順1で停止したサービスを再起動する。
設定した内容が反映されます。

注意

要求を行うホスト上で設定してください。例えば，jpqjobsubコマンドでジョブをサブミットする場合は，コマンドを実行するホスト上で設定してください。

なお，結果ファイルに対して，この機能は有効ではありません。

(2)　定義パラメーター一覧

表16-3　転送元ファイルの検索パスの定義パラメーター一覧

定義キー | 環境設定パラメーター | 定義内容
[{JP1_DEFAULT|論理ホスト名}¥JP1NBQCLIENT¥PathEnv]※ | "All Users"= | 転送元ファイルの検索パスの定義
"JP1ユーザー名"= | 転送元ファイルの検索パス

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

(3)　定義内容

"JP1ユーザー名"=検索パス名

ジョブを実行するJP1ユーザーごとに検索パス名を指定します。

"All Users"=検索パス名

すべてのJP1ユーザーに対して検索パス名を指定します。

JP1ユーザーごとの設定と，すべてのJP1ユーザーに対する設定の順序は任意です。

設定が重複した場合の優先度は次のとおりです。

すべてのJP1ユーザーに対する設定より，JP1ユーザーごとの設定が優先されます。JP1ユーザーごとに設定された検索パスで転送ファイルが見付かった場合，すべてのJP1ユーザーに対して設定された検索パスでは検索されません。

JP1ユーザー名が重複している場合，あとに定義されている方が優先されます。

(4)　定義例

条件

JP1ユーザー共通の検索パス：/home/user1/trans1，/home/user1/trans2

転送元ファイル名：/home/user1/trans1/TransFile1

定義例

ジョブ中の転送元ファイルの定義

転送元ファイル名=TransFile1

サブミット要求元での検索パスの定義

[{JP1_DEFAULT|論理ホスト名}¥JP1NBQCLIENT¥PathEnv]
"All Users"="/home/user1/trans1::/home/user1/trans2"

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

この定義によって，サブミット要求元ホストでは，転送元ファイルとして「/home/user1/trans1/TransFile1」が設定されます。

16.3　JP1ユーザー仮定機能の設定

JP1/AJS2では，JP1ユーザーというユーザー名を使って権限を管理しています。OSユーザー（実行ユーザー）をJP1ユーザーにマッピングすることによって，ユーザーマッピングに設定されているホスト以外からの要求を受け付けないようにしています。

JP1/AJS2のこのユーザー管理では，OSユーザーごとにOSユーザーをJP1ユーザーにマッピングしなければならないため，不特定のOSユーザーがJP1/AJS2を使用することを目的とした場合，運用に負荷が掛かる場合があります。

このような運用負荷を軽減するために，一つのJP1ユーザーを不特定のOSユーザーで使用できるように設定しておきます（JP1仮定ユーザーに設定しておきます）。こうしておくと，JP1ユーザーにマッピングされていないOSユーザーでも，JP1仮定ユーザーの権限を使ってJP1/AJS2を操作できるようになります。これをJP1ユーザー仮定機能と呼びます（実行するOSユーザーがJP1ユーザーとして登録されている場合は，そのJP1ユーザーを使用します）。JP1ユーザー仮定機能は，JP1/AJS2のジョブ実行制御で提供しているコマンドを実行する際に利用できます。ジョブ実行制御で提供しているコマンドについては，マニュアル「JP1/Automatic Job Management System 2 コマンドリファレンス　1. コマンド」を参照してください。

ここでは，JP1ユーザー仮定機能の設定手順，注意事項について説明します。

＜この節の構成＞

16.3.1　JP1ユーザー仮定機能の設定手順

16.3.2　JP1ユーザー仮定機能の注意事項

16.3.1　JP1ユーザー仮定機能の設定手順

JP1ユーザー仮定機能の設定手順を次に示します。

＜この項の構成＞

(1)　定義手順

(1)　定義手順

JP1/AJS2のサービスを停止する。
次のコマンドを実行して，プロセスがすべて停止していることを確認します。

# /etc/opt/jp1ajs2/jajs_stop※
# /opt/jp1ajs2/bin/jajs_spmd_status

注※

自動停止の設定が行われていることを確認してください。

JP1/Baseでユーザー情報を設定する。
ユーザー情報の設定手順については，「13.1.1(1) ユーザー情報を設定する」を参照してください。

jpqregguestuserコマンドを実行する。
手順1で登録したJP1ユーザーを，JP1仮定ユーザーに設定します。
jpqregguestuserコマンドについては，「20. セットアップ時に使用するコマンド　jpqregguestuser」を参照してください。

JP1/AJS2を再起動する。
設定した内容が反映されます。

これでJP1ユーザー仮定機能の設定は終了です。

JP1ユーザー仮定機能の設定を解除したい場合も，jpqregguestuserコマンドを使用してください。

16.3.2　JP1ユーザー仮定機能の注意事項

JP1ユーザー仮定機能の注意事項を次に示します。

JP1仮定ユーザーに設定できるJP1ユーザーの数は，1台のJP1/AJS2 - Managerホストが管理する範囲につき，一つです。

JP1仮定ユーザーとして利用するJP1ユーザーにも，通常のJP1ユーザーと同様に，JP1権限レベルおよびユーザーマッピングを設定してください。
JP1権限レベルを設定する際は，次の点を考慮してください。

不特定のユーザーの実行要求を満たすことができること。

ユーザーの誤操作によって，運用環境が壊されるおそれがないこと。

クラスタシステムで運用する場合は，実行系ホストおよび待機系ホストの両方でjpqregguestuserコマンドを実行してください。
jpqregguestuserコマンドの詳細については，「20. セットアップ時に使用するコマンド　jpqregguestuser」

16.4　エージェントのパイプ通信タイムアウト値の変更

ジョブ実行制御のエージェントプロセス間通信でパイプ通信のタイムアウトエラーが発生することがあります。その原因として，次のことが考えられます。

大量のジョブが一時期に集中して実行された。

CPUに高い負荷が掛かり，300秒以上の間CPUが割り当てられなかった。

実メモリーが不足することでジョブ実行制御のエージェントプロセスが300秒以上の間スワップアウトされ，実行されなかった。

これらの発生条件が解消されずにパイプ通信のタイムアウトエラーが頻繁に発生するような場合は，エージェントプロセスが実行されるホスト上のパイプ通信タイムアウト時間を長めに変更して運用されることをお勧めします。なお，デフォルトは「300秒間」に設定されています。

エージェントのパイプ通信タイムアウト値の設定手順を次に示します。

＜この節の構成＞

(1)　定義手順

(2)　定義パラメーター一覧

(3)　定義内容

(1)　定義手順

JP1/AJS2のサービスを停止する。
次のコマンドを実行して，プロセスがすべて停止していることを確認します。

# /etc/opt/jp1ajs2/jajs_stop※
# /opt/jp1ajs2/bin/jajs_spmd_status

注※

自動停止の設定が行われていることを確認してください。

viなどのエディターで，「(2) 定義パラメーター一覧」の定義パラメーターを記述した設定ファイルを作成する。
設定ファイルのファイル名は任意です。

ファイルを保存し，次のコマンドを実行する。

jbssetcnf 設定ファイル名

jbssetcnfコマンドのパスは，「/opt/jp1base/bin/jbssetcnf」です。
jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/AJS2を再起動する。
設定ファイルに記述した内容が反映されます。

(2)　定義パラメーター一覧

表16-4　エージェントのパイプ通信タイムアウト値の変更定義パラメーター一覧

定義キー | 環境設定パラメーター | 定義内容
[{JP1_DEFAULT|論理ホスト名}¥JP1NBQAGENT¥Job]※ | "PipeComTimeout"= | エージェントのパイプ通信タイムアウト値の定義

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

(3)　定義内容

" PipeComTimeout "=dword:設定値

パイプ通信タイムアウト時間（単位：秒）を16進数で指定します。

0x0000012C～0x7FFFFFFF（10進数で300～2,147,483,647）の間で指定します。

デフォルトは「dword:0000012C」（10進数で300）です。

注意

パイプ通信タイムアウト時間に長い時間を設定すると，ジョブの障害検知が遅くなることがあるため注意してください。

また，パイプ通信タイムアウト時間には，最小値として1秒から設定できますが，300秒未満を設定するとパイプ通信のタイムアウトエラーが発生しやすくなり，ジョブが起動失敗になるため指定できる範囲を300秒からとしました。ただし，すでに300秒未満の値を設定して運用している場合はエラーにはならないため，そのまま継続して使用できます。

16.5　ジョブプロセス実行準備完了通知時のタイムアウト値の設定

キューを使用するジョブ（キューレスジョブを除くPCジョブ，UNIXジョブ，JP1/AJS2上で実行するQUEUEジョブ，アクションジョブ，およびカスタムジョブ）は，ジョブ実行制御のエージェントプロセスからジョブプロセスとして起動されます。その際，エージェントプロセスはパイプ通信を使用してジョブプロセスからの実行準備完了通知を待っています。このときCPUの負荷が高い，ジョブの実行優先度が低いなどの理由でエージェントプロセスへの実行準備完了通知の送信処理が沈み込んでしまうことがあります。エージェントプロセスはジョブプロセスから実行準備完了通知を受けてジョブの状態を実行中にしているため，実行準備完了通知がこないままだと，ジョブの状態はキューイング中のままになってしまうという問題が発生することがあります。ジョブプロセスからの実行準備完了通知の受信にタイムアウト値を設定すると，タイムアウトが発生した場合に次に示すメッセージを統合ログに出力し，早目に異常を検知できるようになります。

KAVU3589-E　ジョブ実行処理でパイプタイムアウトエラーが発生しました（タイムアウト値（秒）：タイムアウト値）

ジョブプロセス実行準備完了通知時のタイムアウト値の設定手順を次に示します。

＜この節の構成＞

(1)　定義手順

(2)　定義パラメーター一覧

(3)　定義内容

(1)　定義手順

JP1/AJS2のサービスを停止する。
次のコマンドを実行して，プロセスがすべて停止していることを確認します。

# /etc/opt/jp1ajs2/jajs_stop※
# /opt/jp1ajs2/bin/jajs_spmd_status

注※

自動停止の設定が行われていることを確認してください。

viなどのエディターで，「(2) 定義パラメーター一覧」の定義パラメーターを記述した設定ファイルを作成する。
設定ファイルのファイル名は任意です。

ファイルを保存し，次のコマンドを実行する。

jbssetcnf 設定ファイル名

jbssetcnfコマンドのパスは，「/opt/jp1base/bin/jbssetcnf」です。
jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/AJS2を再起動する。
設定ファイルに記述した内容が反映されます。

(2)　定義パラメーター一覧

表16-5　ジョブプロセス実行準備完了通知時のタイムアウト値設定の定義パラメーター

定義キー | 環境設定パラメーター | 定義内容
[{JP1_DEFAULT|論理ホスト名}¥JP1NBQAGENT¥Job]※ | "AfterForkPipeTimeout"= | ジョブプロセス実行準備完了通知時のタイムアウト値の定義

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

(3)　定義内容

" AfterForkPipeTimeout "=dword:設定値

ジョブプロセス実行準備完了通知のタイムアウト時間（単位：秒）を16進数で指定します。

指定できる範囲は0x00000384～0x00015180（10進数で900～86,400）です。

最大値の0x00015180（10進数で86,400秒）は1日の秒数です。

デフォルトは「dword:00000384」（10進数で900）です。

注意

ジョブプロセス実行準備完了通知のタイムアウト時間に長い時間を設定すると，ジョブの障害検知が遅くなることがあるため注意してください。

また，ジョブプロセス実行準備完了通知のタイムアウト時間には，最小値として0秒から設定できますが，900秒未満を設定するとタイムアウトエラーが発生しやすくなり，ジョブは起動失敗となります。そのため，指定できる範囲を900秒からとしています。ただし，すでに900秒未満の値を設定して運用している場合はエラーにはならないため，そのまま継続して使用できます。

16.6　イベントジョブのログサイズの設定の変更

運用の形態に合わせてイベントジョブのログサイズの設定変更を行います。最低でも24時間分のログが保持できることを目安とし，2，3日分のログを保持できるように設定することをお勧めします。

ログサイズの見積もりについては，マニュアル「JP1/Automatic Job Management System 2 設計・運用ガイド　4.4.4 イベントジョブが出力するログのサイズを見積もる」を参照してください。

イベントジョブのログ設定を変更する手順を次に示します。

＜この節の構成＞

(1)　定義手順

(1)　定義手順

JP1/AJS2のサービスを停止する。
次のコマンドを実行して，プロセスがすべて停止していることを確認します。

# /etc/opt/jp1ajs2/jajs_stop※
# /opt/jp1ajs2/bin/jajs_spmd_status

注※

自動停止の設定が行われていることを確認してください。

viなどのエディターで，定義パラメーターの記述を設定に合わせて変更してください。
定義パラメーターについては，マニュアル「JP1/Automatic Job Management System 2 設計・運用ガイド　4.4.4 イベントジョブが出力するログのサイズを見積もる」を参照してください。
ログ設定構成定義ファイルのファイル名は任意です。

ファイルを保存し，次のコマンドを実行する。

jbssetcnf ログ設定構成定義ファイル名

jbssetcnfコマンドのパスは，「/opt/jp1base/bin/jbssetcnf」です。
jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/AJS2を再起動する。
設定ファイルに記述した内容が反映されます。

16.7　イベント順序保証オプションの設定

起動条件で監視している一つのイベントジョブのイベントが連続して発生する場合，通信の状態によって，イベントの成立順序が実際に発生した順序とは異なってしまうことがあります。引き継ぎ情報を使用しているなどで，成立するイベントの順序をイベントが実際に発生した順にしたい場合は，イベント順序保証オプションを使用してください。イベント順序保証オプションを有効にする方法を次に示します。なお，イベント順序保証オプションは，イベントジョブを実行するすべてのエージェントホストで設定してください。

＜この節の構成＞

(1)　定義手順

(2)　定義パラメーター一覧

(3)　定義内容

(1)　定義手順

JP1/AJS2のサービスを停止する。
次のコマンドを実行して，プロセスがすべて停止していることを確認します。

# /etc/opt/jp1ajs2/jajs_stop※
# /opt/jp1ajs2/bin/jajs_spmd_status

注※

自動停止の設定が行われていることを確認してください。

viなどのエディターで，「(2) 定義パラメーター一覧」の定義パラメーターを記述した設定ファイルを作成する。
設定ファイルのファイル名は任意です。

ファイルを保存し，次のコマンドを実行する。

jbssetcnf 設定ファイル名

jbssetcnfコマンドのパスは，「/opt/jp1base/bin/jbssetcnf」です。
jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/AJS2を再起動する。
設定ファイルに記述した内容が反映されます。

(2)　定義パラメーター一覧

表16-6　イベント順序保証オプション設定の定義パラメーター

定義キー | 環境設定パラメーター | 定義内容
[{JP1_DEFAULT|論理ホスト名}¥JP1AOMAGENT]※ | "EventSequential"= | イベント順序保証オプション

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

(3)　定義内容

" EventSequential "="{Y|N}"

イベント順序保証オプションを使用するかどうかを指定します。

Y

イベント順序保証オプションを使用する場合に指定します。

N

イベント順序保証オプションを使用しない場合に指定します。

デフォルトは「N」です。

16.8　ファイル監視ジョブの状態引き継ぎオプションの設定

ファイル監視ジョブが監視対象ファイルを監視している間の情報を随時退避しておき，JP1/AJS2サービスが一時的に停止した場合でもジョブの状態を引き継ぐことができます。

なお，監視状態を引き継ぐには，ファイル監視ジョブが継続して動作している必要があります。ファイル監視ジョブが継続して動作するか，終了するかによって監視状態が引き継がれるかどうかが異なります。

監視状態が引き継がれる条件については，マニュアル「JP1/Automatic Job Management System 2 設計・運用ガイド　8.3.2 ファイル監視ジョブの注意事項」を参照してください。

ファイル監視ジョブの状態を引き継ぐ機能は，デフォルトでは無効になっていますが，JP1/AJS2の新規のインストール時および新規のセットアップ時に有効になります。オプションを変更する手順を次に示します。

＜この節の構成＞

(1)　定義手順

(2)　定義パラメーター一覧

(3)　定義内容

(1)　定義手順

JP1/AJS2のサービスを停止する。
次のコマンドを実行して，プロセスがすべて停止していることを確認します。

# /etc/opt/jp1ajs2/jajs_stop※
# /opt/jp1ajs2/bin/jajs_spmd_status

注※

自動停止の設定が行われていることを確認してください。

viなどのエディターで，「(2) 定義パラメーター一覧」の定義パラメーターを記述した設定ファイルを作成する。
設定ファイルのファイル名は任意です。

ファイルを保存し，次のコマンドを実行する。

jbssetcnf 設定ファイル名

jbssetcnfコマンドのパスは，「/opt/jp1base/bin/jbssetcnf」です。
jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/AJS2を再起動する。
設定ファイルに記述した内容が反映されます。

(2)　定義パラメーター一覧

表16-7　ファイル監視ジョブの状態引き継ぎオプション設定の定義パラメーター

定義キー | 環境設定パラメーター | 定義内容
[{JP1_DEFAULT|論理ホスト名}¥JP1AOMAGENT]※ | "FilewatchinfContinue"= | ファイル監視ジョブの状態引き継ぎオプション

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

(3)　定義内容

" FilewatchinfContinue "="{Y|N}"

ファイル監視ジョブの状態を引き継ぐかどうかを指定します。

Y

ファイル監視ジョブの状態を引き継ぐ場合に指定します。

N

ファイル監視ジョブの状態を引き継がない場合に指定します。

16.9　「"（ダブルクォーテーションマーク）」を含むデータをイベントジョブの引き継ぎ情報に使用するための設定

「"（ダブルクォーテーションマーク）」を含むデータを指定したとおりに引き継ぎ情報として引き継がせることができます。詳細については，マニュアル「JP1/Automatic Job Management System 2 設計・運用ガイド　5.3.8(4) 「"（ダブルクォーテーションマーク）」を含むデータをイベントジョブの引き継ぎ情報に使用する」を参照してください。

「"（ダブルクォーテーションマーク）」を含むデータを指定したとおりに引き継ぎ情報として引き継がせるオプションを有効にするための設定をするには，設定ファイルを作成します。

設定手順を次に示します。

＜この節の構成＞

(1)　定義手順

(2)　定義パラメーター一覧

(3)　定義内容

(4)　定義例

(1)　定義手順

JP1/AJS2のサービスを停止する。
次のコマンドを実行して，プロセスがすべて停止していることを確認します。

# /etc/opt/jp1ajs2/jajs_stop※
# /opt/jp1ajs2/bin/jajs_spmd_status

注※

自動停止の設定が行われていることを確認してください。

viなどのエディターで，「(2) 定義パラメーター一覧」の定義パラメーターを記述した設定ファイルを作成する。
設定ファイルのファイル名は任意です。

ファイルを保存し，次のコマンドを実行する。

jbssetcnf 設定ファイル名

jbssetcnfコマンドのパスは，「/opt/jp1base/bin/jbssetcnf」です。
jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/AJS2を再起動する。
設定ファイルに記述した内容が反映されます。
ファイルには変更したい定義内容だけを定義します。ファイルに定義しなかったものについては，デフォルト値が仮定されます。

(2)　定義パラメーター一覧

表16-8　引き継ぎ情報における「"（ダブルクォーテーションマーク）」有効オプション設定の定義パラメーター

定義キー | 環境設定パラメーター | 定義内容
[{JP1_DEFAULT|論理ホスト名}¥JP1AOMMANAGER]※ | "MacVarDQuotation"= | 引き継ぎ情報における「"（ダブルクォーテーションマーク）」有効オプション

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

(3)　定義内容

" MacVarDQuotation "="{Y|N}"

引き継ぎ情報における「"（ダブルクォーテーションマーク）」有効オプションを使用するかしないかを指定します。

Y

使用する場合に指定します。

N

使用しない場合に指定します。

デフォルトは「N」です。

このパラメーターは，JP1/AJS2の新規のインストール時および新規のセットアップ時に「Y」が設定されます。

(4)　定義例

ファイルの作成例を次に示します。

（例）引き継ぎ情報における「"（ダブルクォーテーションマーク）」有効オプションを使用するようにする場合

[{JP1_DEFAULT|論理ホスト名}¥JP1AOMMANAGER]
"MacVarDQuotation"="Y

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

16.10　ジョブの標準出力と標準エラー出力を同時に確認する設定

JP1/AJS2 - Viewの［実行結果詳細］ダイアログボックスに表示される内容は，ジョブが標準エラー出力に出力した内容です。ジョブが標準出力に出力した内容も同時に［実行結果詳細］ダイアログボックスで確認するためには，次の設定が必要です。

PCジョブ，UNIXジョブの場合

［詳細定義－［PC Job］］ダイアログボックスまたは，［詳細定義－［UNIX Job］］ダイアログボックスの［標準出力ファイル名］と［標準エラー出力ファイル名］に同じファイル名を指定します。

注意事項

［標準出力ファイル名］と［標準エラー出力ファイル名］に同じファイル名を指定する場合は，追加書きオプションの設定を合わせてください。片方が新規作成で，もう片方を追加書きに設定した定義のジョブを実行すると，次のメッセージを統合トレースログに出力して，ジョブの状態が起動失敗となります。
・ジョブの実行先サービスに［JP1/AJS2］を指定している場合
　KAVU0201-E パラメーターに誤りがあります
・ジョブの実行先サービスに［JP1/AJS2 Queueless Agent］を指定している場合（キューレスジョブの場合）
　KAVS1846-E ジョブ定義文（ジョブ名）に誤りがあります

キューレスジョブに同一ファイル名を指定した場合，標準出力と標準エラー出力にジョブが出力する内容はいったん一時ファイルに保存されるため，ジョブの実行中は，指定したファイルが更新されません。ジョブが終了した時点で更新されます。

16.11　イベントジョブを使用したDNS運用時にFQDN形式で運用するための設定

イベントジョブを使用する場合，かつDNS運用時にFQDN形式のホスト名で運用する場合の設定について説明します。ここでは，JP1/AJS2 07-00を新規に導入するの場合の設定手順を次に示します。イベントジョブを使用する場合の設定であり，標準ジョブ・アクションジョブ・カスタムジョブはすでに対応しています。JP1/AJS2 06-71以前の運用環境からバージョンアップする場合の設定の流れと手順については，マニュアル「JP1/Automatic Job Management System 2 設計・運用ガイド　9.5 イベントジョブをDNS環境で運用する場合の設定方法（バージョンアップ時）」を参照してください。

なお，この設定はマネージャーホスト上で実施します。

設定手順を次に示します。

＜この節の構成＞

(1)　定義手順

(2)　定義パラメーター一覧

(3)　定義内容

(1)　定義手順

JP1/AJS2のサービスを停止する。
次のコマンドを実行して，プロセスがすべて停止していることを確認します。

# /etc/opt/jp1ajs2/jajs_spmd_stop※
# /opt/jp1ajs2/bin/jajs_spmd_status

注※

自動停止の設定が行われていることを確認してください。

viなどのエディターで，「(2) 定義パラメーター一覧」の定義パラメーターを記述した設定ファイルを作成する。
設定ファイルのファイル名は任意です。

ファイルを保存し，次のコマンドを実行する。

jbssetcnf 設定ファイル名

jbssetcnfコマンドのパスは，「/opt/jp1base/bin/jbssetcnf」です。
jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/AJS2を再起動する。
設定ファイルに記述した内容が反映されます。

(2)　定義パラメーター一覧

表16-9　イベントジョブを使用したDNS運用時にFQDN形式で運用する設定の定義パラメーター

定義キー | 環境設定パラメーター | 定義内容
[{JP1_DEFAULT|論理ホスト名}¥JP1AOMMANAGER]※ | "DNSEstablish"= | イベントジョブを使用したDNS運用時にFQDN形式で運用するための定義

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

(3)　定義内容

" DNSEstablish "="{Y|N}"

DNS運用時にFQDN形式のホスト名で運用するかどうかを指定します。

Y

DNS運用時にFQDN形式のホスト名で運用する場合に指定します。

N

DNS運用時にFQDN形式のホスト名で運用しない場合に指定します。エージェントへはFQDN形式のホスト名ではなく，ホスト名を送ります。

デフォルトは「N」です。

16.12　キューレスジョブ環境でクラスを指定したジョブを実行するための設定

キューレスジョブ環境では，クラスを定義し，クラスごとに最大同時ジョブ実行数と最大待ちジョブ数を制限できます。クラスは複数定義できます。

クラス内での最大同時ジョブ実行数を超えて同時にジョブを実行しようとすると，実行できなかったジョブはキューレスエージェントのメモリーに貯えられます。クラス内での最大待ちジョブ数を超えてジョブを同時に実行しようとすると，そのジョブの実行は失敗し，状態は「起動失敗」となります。

例えば，あるクラスでの最大同時ジョブ実行数が10であり，最大待ちジョブ数が5のとき，同時に15個のジョブが実行中の状態でさらにジョブを実行しようとすると，16個目以降のジョブの状態は「起動失敗」となります。

キューレスエージェント全体の最大同時実行ジョブ数を超える場合，クラスごとの最大同時ジョブ実行数の制限値以内であっても，そのジョブはキューレスエージェントのメモリーに貯えられます。キューレスエージェント全体の最大待ちジョブ数を超える場合，クラスごとの最大待ちジョブ数の制限値以内であっても，そのジョブの状態は「起動失敗」になります。

クラスを指定してジョブを実行するためには，区切り文字「!」を使用して，ジョブの［実行ホスト］に次の形式で実行ホスト名とクラス名を指定します。

実行ホスト名!クラス名

ジョブの実行ホスト名を省略して，区切り文字とクラス名だけを指定した場合は，自ホストに対するクラス名が仮定されます。

ジョブの実行ホスト名，クラス名を共に省略した場合は，ジョブが属するジョブネットの［実行ホスト］に指定された実行ホスト名が仮定されます。

ジョブネットの［実行ホスト］にクラス名は指定できません。このようなジョブネットを実行しようとすると，ジョブネット中に含まれるジョブの状態は「起動失敗」になります。

存在しないクラスを指定してジョブを実行しようとすると，そのジョブの状態は「起動失敗」になります。

クラスを設定する手順を次に示します。

＜この節の構成＞

(1)　定義手順

(2)　定義パラメーター一覧

(3)　定義内容

(4)　定義例

(5)　注意事項

(1)　定義手順

クラスを定義してキューレスジョブを実行させたいキューレスエージェントホスト上で次に示す設定をしてください。

キューレスエージェントサービスを停止する。
次のコマンドを実行して，プロセスがすべて停止していることを確認します。

# /opt/jp1ajs2/bin/ajsqlstop
# /opt/jp1ajs2/bin/ajsqlstatus

viなどのエディターで，「(2) 定義パラメーター一覧」の定義パラメーターを記述した設定ファイルを作成する。
設定ファイルのファイル名は任意です。

ファイルを保存し，次のコマンドを実行する。

jbssetcnf 設定ファイル名

jbssetcnfコマンドのパスは，「/opt/jp1base/bin/jbssetcnf」です。
jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

手順1で停止した次のサービスを再起動する。

# /opt/jp1ajs2/bin/ajsqlstart

設定ファイルに記述した内容が反映されます。

(2)　定義パラメーター一覧

表16-10　キューレスジョブ環境でクラスを指定したジョブを実行する設定の定義パラメーター一覧

定義キー | 環境設定パラメーター | 定義内容
[{JP1_DEFAULT|論理ホスト名}¥JP1QLAGENT¥AJSQL_CLASS¥クラス名]※ | "AJSQL_CJOBMAX"= | クラス内での最大同時ジョブ実行数
"AJSQL_CJOBWAITMAX"= | クラス内での最大待ちジョブ数

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

(3)　定義内容

" AJSQL_CJOBMAX "=dword:クラス内での最大同時ジョブ実行数

そのクラスで同時実行を許すジョブの最大数を16進数で指定します。

指定できる値は0～400（10進数で0～1,024）です。

デフォルトは「400」（10進数で1,024）です。

" AJSQL_CJOBWAITMAX "=dword:クラス内での最大待ちジョブ数

そのクラスでの最大同時ジョブ実行数を超えたときに，キューレスエージェントサービス上のメモリーに貯えておくキューレスジョブの最大数を16進数で指定します。

指定できる値は0～19000（10進数で0～102,400）です。

デフォルトは「0」です。

(4)　定義例

ジョブの[実行先ホスト]の定義

実行先ホスト=agent1!class1

ジョブ実行先(agent1)でのクラスの定義

[JP1_DEFAULT¥JP1QLAGENT¥AJSQL_CLASS¥class1]
"AJSQL_CJOBMAX"=dword:200
"AJSQL_CJOBWAITMAX"=dword:100

この定義では，ジョブ実行先ホストagent1のクラスclass1上で同時に実行できるジョブ数は512個です。ジョブ実行先ホストagent1のクラスclass1上での最大待ちジョブ数は256個です。

512個を超えて同時にジョブを実行しようとした場合，256個まではエージェント上のメモリーに貯えられます。さらにジョブを実行しようとした場合，以降のジョブは「起動失敗」となります。

(5)　注意事項

クラス名にマルチバイト文字は使用できません。

［実行先ホスト］に指定できるクラス名の最大長は63バイトまでです。64バイト以上を指定した場合，64バイト以降の文字は切り捨てられます。

16.13　ファイル受信制限をするための設定

JP1/AJS2では，ジョブ※実行時に結果ファイル（標準出力ファイル，および標準エラー出力ファイル）や転送ファイルをマネージャーホストとエージェントホスト間，またはクライアントホストとマネージャーホスト間で送受信します。これらのファイルのサイズが非常に大きい場合,ファイルのデータ解析処理に負荷が掛かり，CPU使用率の増加や，メモリー使用量の増加など，ジョブの実行が遅延するだけでなく，システム全体の処理に影響を与えるおそれがあります。

注※

ジョブは，QUEUEジョブ，イベントジョブを除きます。また，キューレスジョブは対象外です。

ファイル受信制限をするための設定を行うと，ジョブ実行時にマネージャーホスト側で受信する結果ファイルのサイズ（標準出力ファイルと標準エラー出力ファイルを合わせた合計のサイズ），または，エージェントホストが受信する転送ファイルのサイズ（転送ファイルを複数指定した場合はその合計サイズ）の上限値を設定できます。

また，上限値を超えた場合の動作（ジョブの終了状態）や出力するメッセージを指定できます。

ファイル受信サイズの上限値を超えた場合の動作と上限値を超えたファイルデータの扱いについて次に示します。

表16-11　ファイル受信サイズの上限値を超えた場合の動作と上限値を超えたファイルデータの扱い

上限値を超えたファイルの種類 | 動作内容 | ReceiveFileSizeStatus環境設定パラメーターの指定
0 | 1 | 2 | 3
結果ファイル | ジョブの状態 | 実際の終了状態を引き継ぐ | 異常検出終了 | 警告検出終了※ | 実際の終了状態を引き継ぐ
出力するメッセージの種別 | 情報 | 異常 | 警告 | 情報
ファイルデータの扱い | すべてのファイルデータを受信する | 上限値を超えたデータを破棄する | 上限値を超えたデータを破棄する | 上限値を超えたデータを破棄する
転送ファイル | ジョブの状態 | 実際の終了状態を引き継ぐ | 起動失敗 | 起動失敗 | 実際の終了状態を引き継ぐ
出力するメッセージの種別 | 情報 | 異常 | 異常 | 情報
ファイルデータの扱い | すべてのファイルデータを受信する | すべてのファイルデータを受信しない | すべてのファイルデータを受信しない | すべてのファイルデータを受信しない

注※

エージェントホストでジョブの状態が「異常検出終了」だった場合はその状態を引き継ぎます。

＜この節の構成＞

(1)　定義手順

(2)　定義パラメーター一覧

(3)　定義内容

(4)　ファイル受信サイズが上限値を超えた場合の動作

(5)　注意事項

(1)　定義手順

viなどのテキストエディターで，「(2) 定義パラメーター一覧」の定義パラメーターを指定した設定ファイルを作成する。
設定ファイルのファイル名は任意です。

ファイルを保存し，次のコマンドを実行する。

jbssetcnf 設定ファイル名

jbssetcnfコマンドのパスは，「/opt/jp1base/bin/jbssetcnf」です。
jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/AJS2を再起動する。
変更した構成定義の内容が反映されます。

(2)　定義パラメーター一覧

表16-12　ファイル受信制限をする設定の定義パラメーター一覧

定義キー | 環境設定パラメーター | 定義内容
[{JP1_DEFAULT|論理ホスト名}¥JP1NBQMANAGER¥Job]※ | "ReceiveFileSizeStatus"= | ファイルサイズが上限値に達したときの動作
"LimitReceiveFileSize"= | ファイルサイズの上限値

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

(3)　定義内容

"ReceiveFileSizeStatus"=dword:ファイルサイズが上限値に達したときの動作

ファイル受信サイズが上限値に達したときの動作を指定します。

デフォルトは「0」です。

0

ファイル受信サイズの上限値をチェックし，上限値に達した場合は次のメッセージを出力しますが，すべてのファイルデータを受信します。ファイル受信サイズが上限値を超えてもジョブの状態は変更しないで，エージェントホストでのジョブの終了状態を引き継ぎます。

結果ファイルの場合
KAVU4294-Iメッセージ

転送ファイルの場合
KAVU2243-Iメッセージ

1

ファイル受信サイズの上限値をチェックし，上限値に達した場合はファイルの受信処理を中止して，ジョブの状態を変更します。

結果ファイルは，ファイルサイズの上限値（LimitReceiveFileSize）まで受信し，上限値を超えたデータを破棄して，終了状態を「異常検出終了」にします。転送ファイルはすべてのファイルデータを受信しないで，終了状態を「起動失敗」にします。終了コードと状態については，「(4) ファイル受信サイズが上限値を超えた場合の動作」を参照してください。

上限値に達した場合は次のメッセージを出力します。

結果ファイルの場合
KAVU4296-Eメッセージ

転送ファイルの場合
KAVU2244-Eメッセージ

2

ファイル受信サイズの上限値をチェックし，上限値に達した場合はファイルの受信処理を中止して，ジョブの状態を変更します。

結果ファイルは，ファイルサイズの上限値（LimitReceiveFileSize）まで受信し，上限値を超えたデータを破棄して，終了状態を「警告検出終了」にします。ただし，エージェントホストでのジョブの状態が「異常検出終了」だった場合はその状態を引き継ぎます。転送ファイルはすべてのファイルデータを受信しないで，終了状態を「起動失敗」にします。終了コードと状態については，「(4) ファイル受信サイズが上限値を超えた場合の動作」を参照してください。

上限値に達した場合は次のメッセージを出力します。

結果ファイルの場合
KAVU4295-Wメッセージ

転送ファイルの場合
KAVU2244-Eメッセージ

3

ファイル受信サイズの上限値をチェックし，上限値に達した場合はファイルの受信処理を中止します。

結果ファイルは，ファイルサイズの上限値（LimitReceiveFileSize）まで受信し，上限値を超えたデータを破棄します。転送ファイルはすべてのファイルデータを破棄します。ジョブの終了状態は，エージェントホストでの終了状態を引き継ぎます。終了コードと状態については，「(4) ファイル受信サイズが上限値を超えた場合の動作」を参照してください。

上限値に達した場合は次のメッセージを出力します。

結果ファイルの場合
KAVU4294-Iメッセージ

転送ファイルの場合
KAVU2243-Iメッセージ

この指定をした場合，制限を超えてもジョブは正常に終了します。しかし，ファイルが完全に作成された状態ではないため，後続ジョブなどでファイルを参照する場合は，不完全なファイルでも問題ないことを確認して使用してください。

"LimitReceiveFileSize"=dword:ファイルサイズの上限値

ファイル受信サイズの上限値を16進数で指定します。

指定できる範囲は80000～40000000（10進数で524,288～1,073,741,824）（単位：バイト）です。

デフォルトは「500000」（10進数で5,242,880）です。

ジョブ実行時に使用する転送ファイルや結果ファイルのサイズが運用上の見積もり値を超えたときに，マネージャーホスト側で受信するファイルのサイズを制限します。運用に合わせて5メガバイト程度で上限値を設定することをお勧めします。

この設定は，一回に送信する転送ファイルが複数ある場合，それらのファイルサイズを合計した値に対して上限値をチェックします。結果ファイルの場合は，標準出力ファイルと標準エラー出力ファイルのサイズを合計した値でチェックします。

なお，上限値に対して±数百バイト程度の範囲で誤差が生じることがあります。

ファイルサイズの見積もり方法を次に示します（単位：バイト）。

ファイル数
　Σ（ファイル名長＋ファイルサイズ＋（12＊ファイル行数）＋100）

注

この設定は8000単位（10進数で32,768）で切り上げて設定されます。例えば，80001（10進数で524,289）を指定した場合，有効になる値は88000（10進数で557,056）になります。

アクションジョブについては，JP1/AJS2が出力する情報としては指定できる範囲の下限値（524,288バイト）を超えて出力されません。ただし，UNIX上で実行した場合に，システムやジョブ実行OSユーザーのログインスクリプトで標準エラー出力を出力した場合は，下限値を超えることがあります。

(4)　ファイル受信サイズが上限値を超えた場合の動作

ファイル受信サイズが上限値を超えたときの動作を次に示します。

結果ファイル

環境設定パラメーターReceiveFileSizeStatusの値を1，2，3のどれかで指定しているときに，受信サイズの上限値に達した場合，標準出力ファイル，標準エラー出力ファイルは上限値のサイズまでマネージャーホスト側に残ります。結果ファイルは完全に作成された状態ではないため，後続ジョブなどで結果ファイルを参照する場合は，不完全なファイルでも問題がないことを確認して使用してください。

結果ファイルのサイズが上限値を超えた場合のジョブの終了コードおよび終了状態を次の表に示します。

表16-13　結果ファイルサイズが上限値を超えた場合の終了状態と終了コードの関係

実際のジョブの状態
設定項目
ReceiveFileSizeStatus定義パラメーターの指定

1
2
0または3

正常終了
（常に正常を指定した場合も含む）
状態
異常検出終了
警告検出終了
正常終了

終了コード
ジョブの戻り値※
ジョブの戻り値※
ジョブの戻り値※

警告検出終了
状態
異常検出終了
警告検出終了
警告検出終了

終了コード
ジョブの戻り値※
ジョブの戻り値※
ジョブの戻り値※

異常検出終了
状態
異常検出終了
異常検出終了
異常検出終了

終了コード
ジョブの戻り値※
ジョブの戻り値※
ジョブの戻り値※

強制終了
状態
強制終了
強制終了
強制終了

終了コード
PCジョブ（-1），
UNIXジョブ（255）
PCジョブ（-1），
UNIXジョブ（255）
PCジョブ（-1），
UNIXジョブ（255）

起動失敗
状態
起動失敗
起動失敗
起動失敗

注※

ジョブとして実行したジョブプロセスの終了コードです。

転送ファイル

環境設定パラメーターReceiveFileSizeStatusの値を1，2，3のどれかで指定しているときに，受信サイズの上限値に達した場合，転送ファイルは受信しません。複数指定している場合はすべての転送ファイルのデータを破棄します。

転送ファイルのサイズが上限値を超えた場合のジョブの終了コードおよび終了状態を次の表に示します。

表16-14　転送ファイルサイズが上限値を超えた場合の終了状態と終了コードの関係

実際のジョブの状態
設定項目
ReceiveFileSizeStatus定義パラメーターの指定

1
2
0または3

なし※1
状態
起動失敗
起動失敗
実際のジョブの終了状態

終了コード
PCジョブ（-1），
UNIXジョブ（-1）
PCジョブ（-1），
UNIXジョブ（-1）
ジョブの戻り値※2

注※1

転送ファイルの処理はジョブが登録される際に行うため，ジョブがキューイング状態になる前のジョブの状態で「なし」となっています。

注※2

ジョブとして実行したジョブプロセスの終了コードです。

(5)　注意事項

ファイルを送受信するホストがシフトJIS以外の日本語環境の場合に，ファイル受信制限を使用すると，実際のファイルサイズと上限値として指定したサイズが異なる場合があります。

結果ファイルの受信時および転送ファイルの転送時の，ファイルサイズのチェックは，ファイルデータがシフトJISの状態で行われます。サイズチェック後に，結果ファイル受信ホストおよび転送ファイル転送先ホストで，各ホストに対応した文字コードに変換してファイルを作成します。

転送ファイルおよび結果ファイルは，対象ファイルの文字コードをシフトJISに変換してからサイズをチェックします。そのため，ファイル送信元ホストがシフトJIS以外の日本語環境の場合，シフトJISに文字コード変換を行った際に，変換後のファイルサイズが変換前のファイルサイズより小さくなる場合があります。この場合，ファイル送信元ホスト上ではファイルサイズが上限値より大きなファイルでも，ファイル受信制限が動作しません。

また，ファイルが作成されるホストがシフトJIS以外の日本語環境の場合，サイズチェック後にシフトJISからホスト上の文字コードに変換するため，チェック時のサイズより実際のファイルサイズが大きくなる場合があります。この場合，ファイル受信制限を使用し，上限値を超えるファイルを受信しないように設定しても，上限値より大きなサイズのファイルが作成されます。このように，上限値より大きなサイズのファイルが作成されることで，ディスク領域を予想以上に消費するおそれがありますので注意してください。

16.14　ジョブ・イベントジョブのエラーメッセージをsyslogに出力するための設定

ジョブ・イベントジョブのジョブ実行時に発生するエラーメッセージ（KAVUメッセージ，およびKAVTメッセージ）をsyslogにも出力し，JP1/AJS2のジョブ実行時のエラー監視をsyslogだけで行うことができます。

ジョブ・イベントジョブのエラーメッセージをsyslogに出力するための定義手順を次に示します。

＜この節の構成＞

(1)　定義手順

(2)　環境設定パラメーター一覧

(3)　定義内容

(1)　定義手順

JP1/AJS2のサービスを停止する。
次のコマンドを実行して，プロセスがすべて停止していることを確認します。

# /etc/opt/jp1ajs2/jajs_stop※
# /opt/jp1ajs2/bin/jajs_spmd_status

注※

自動停止の設定が行われていることを確認してください。

次のファイルをviなどのエディターで開く。

/etc/opt/jp1ajs2/conf/Common.conf

環境設定パラメーターを次に示すとおり変更する。

[{JP1_DEFAULT|論理ホスト名}¥JP1AJS2COMMON¥]
"SYSLOGJOBMSG"="error"

（環境設定パラメーターの詳細については(2)を参照）

ファイルを保存し，次のコマンドを実行する。

jbssetcnf /etc/opt/jp1ajs2/conf/Common.conf

jbssetcnfコマンドのパスは，「/opt/jp1base/bin/jbssetcnf」です。
jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/AJS2を再起動する。
変更した構成定義の内容が反映されます。

(2)　環境設定パラメーター一覧

表16-15　環境設定パラメーター一覧（Common.conf）

定義キー | 環境設定パラメーター | 定義内容
[{JP1_DEFAULT|論理ホスト名}¥JP1AJS2COMMON¥] | "SYSLOGJOBMSG"= | ジョブ・イベントジョブのエラーメッセージをsyslogにも出力するかどうかの設定

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

(3)　定義内容

" SYSLOGJOBMSG "="{none|error}"

ジョブ・イベントジョブのジョブ実行時に発生するエラーメッセージをsyslogにも出力するかどうかを指定します。

none

ジョブ・イベントジョブのジョブ実行時に発生するエラーメッセージをsyslogに出力しません。JP1/AJS2の状態は，日立統合トレースログで監視します。

error

ジョブ・イベントジョブのジョブ実行時に発生するエラーメッセージをsyslogに出力します。JP1/AJS2のエラー状態は，syslogで監視します。なお，このオプションを指定しても，日立統合トレースログプロセスは停止しないでください。

デフォルトは「none」です。

なお，"SYSLOGJOBMSG"="error"を指定した場合は，スケジューラーサービスの設定でJOBSYSLOG（ジョブ実行開始・終了メッセージのsyslogへの出力）の指定にかかわらずジョブの異常終了メッセージ（KAVS0265-E）がsyslogへ出力されます。

SYSLOGJOBMSGとJOBSYSLOGの指定値により出力されるメッセージを次の表に示します。

表16-16　 SYSLOGJOBMSGとJOBSYSLOGの指定値により出力されるメッセージ

SYSLOGJOBMSGの指定値
JOBSYSLOGの指定値

none
abend
warning
hold
all

none
－
KAVS0265-E
KAVS0269-W
KAVS0271-I
KAVS0263-I
KAVS0264-I
KAVS0265-E
KAVS0269-W
KAVS0271-I

error
KAVS0265-E
KAVS0265-E
KAVS0265-E
KAVS0269-W
KAVS0265-E
KAVS0271-I
KAVS0263-I
KAVS0264-I
KAVS0265-E
KAVS0269-W
KAVS0271-I

16.15　ジョブの結果ファイルの再送間隔・再送回数の変更

エージェントホストはジョブが終了したとき，マネージャーホストに対してジョブの結果ファイルを転送し，結果ファイルの転送が成功すると終了通知を行います。エージェントホストでは結果ファイルの転送時に一時的な通信障害などでファイルの転送に失敗したときでも，確実に終了状態を通知するために，このファイルの転送を通常は5分おきにリトライしています。一方でこの結果ファイルのサイズが大きいと，マネージャーホストではファイルの解析を行うのに非常に負荷が掛かります。通常，ファイルの転送を行ったとき，エージェントホスト側では10分間マネージャーホストからの応答がないと，タイムアウトエラーが発生したものとして結果ファイルを再送します。マネージャーホストでは結果ファイルの再送が繰り返されることによって負荷の掛かるファイル解析処理を多重に行うことになり，結果としてCPUの使用率が非常に高くなりほかの要求を受け付けられなくなるといった問題が発生します。

次の設定を行うと，結果ファイルの転送に失敗したときの，再送までの間隔を変更したり，再送する回数を制限したりすることができ，マネージャーホストに掛かる負荷を抑えることができます。

ジョブの結果ファイルの再送間隔・再送回数の設定手順を次に示します。

＜この節の構成＞

(1)　定義手順

(2)　定義パラメーター一覧

(3)　定義内容

(1)　定義手順

JP1/AJS2のサービスを停止する。
次のコマンドを実行して，プロセスがすべて停止していることを確認します。

# /etc/opt/jp1ajs2/jajs_stop※
# /opt/jp1ajs2/bin/jajs_spmd_status

注※

自動停止の設定が行われていることを確認してください。

viなどのエディターで，「(2) 定義パラメーター一覧」の定義パラメーターを記述した設定ファイルを作成する。
設定ファイルのファイル名は任意です。

ファイルを保存し，次のコマンドを実行する。

jbssetcnf 設定ファイル名

jbssetcnfコマンドのパスは，「/opt/jp1base/bin/jbssetcnf」です。
jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/AJS2を再起動する。
設定ファイルに記述した内容が反映されます。

(2)　定義パラメーター一覧

表16-17　ジョブの結果ファイルの再送間隔・再送回数定義パラメーター一覧

定義キー | 環境設定パラメーター | 定義内容
[{JP1_DEFAULT|論理ホスト名}¥JP1NBQAGENT¥Network]※ | "NotfyJobStateInterval"= | ジョブの結果ファイルの再送間隔
"NotfyJobStateCount"= | ジョブの結果ファイルの再送回数

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

(3)　定義内容

"NotfyJobStateInterval"=dword:設定値

ジョブの結果ファイルの再送間隔（単位：秒）を16進数で指定します。0～0x00015180（10進数で0～86,400）の間で指定します。最大値の0x00015180（10 進数で86,400 秒）は1日の秒数です。

デフォルトは「dword:0000012C」（10進数で300）で5分です。結果ファイルの再送を行わないようにするには0を指定してください。

"NotfyJobStateCount"=dword:設定値

ジョブの結果ファイルの再送回数を16進数で指定します。1～0x00000800（10進数で1～2,048）の間で指定します。

デフォルトは「dword:00000120」（10進数で288）で288回です（デフォルトでは5分間隔で24時間再送します）。

注意事項

NotfyJobStateIntervalに0を指定した場合は，結果ファイルの再送は行いません。このため，結果ファイルの転送に失敗するとジョブの終了通知を行わなくなり，マネージャーホスト側からのジョブ状態監視処理によってジョブの終了を検知します。ジョブ状態監視処理は通常5分間隔のポーリングで行っているため，ジョブの終了検知が遅れることがあります。

また次の場合は，エージェントホスト上のジョブの終了情報が削除されるため，マネージャーホスト上の統合トレースログに「KAVU4597-W　エージェント（エージェントホスト名）で消失したジョブを強制終了します」メッセージが出力されて，ジョブの状態は強制終了となります。

NotfyJobStateCountの上限値まで再送を繰り返し，最終的に結果ファイルの転送が失敗したとき

マネージャーホストからのジョブの状態確認が行われる前にエージェントホストのJP1/AJS2サービスが停止したとき

16.16　ジョブ結果ファイルの二重受信防止の設定

標準ジョブまたはアクションジョブを実行する際，ジョブの終了時にエージェントホストからマネージャーホストに対して結果ファイル（標準出力・標準エラー出力ファイル）を転送します。エージェントホストからファイルの転送を行う際は，通常，マネージャーホストからの応答を10分間待ちますが，ファイルサイズが大きい場合は，マネージャーホストでのファイル解析に時間が掛かり，応答のタイムアウトが発生します。この場合，エージェントホストでは結果ファイルの転送が成功するまで再送を繰り返します。マネージャーホストでは結果ファイルの再送を受け付けると，負荷の掛かる解析処理を多重に行うことになりCPUの使用率が非常に高くなり，他の要求を受け付けられなくなるといった問題が発生します。

次のオプションを指定すると，エージェントホストからの結果ファイルの再送を受け付けなくなり，マネージャーホストに掛かる負荷を抑えることができます。また，結果ファイルの再送を行うかどうかはエージェントホスト側でも設定することもできます。その場合はエージェントホストごとに設定する必要があり，エージェント台数が多数あるような大規模な運用には向きません。エージェントホスト側での設定に関しては，「16.15 ジョブの結果ファイルの再送間隔・再送回数の変更」も参照してください。

次のオプションでは，マネージャーホスト側だけの設定で一括して再送を防止することができます。ジョブ結果ファイルの二重受信防止の設定手順を次に示します。

＜この節の構成＞

(1)　定義手順

(2)　定義パラメーター一覧

(3)　定義内容

(1)　定義手順

JP1/AJS2のサービスを停止する。
次のコマンドを実行して，プロセスがすべて停止していることを確認します。

# /etc/opt/jp1ajs2/jajs_stop※
# /opt/jp1ajs2/bin/jajs_spmd_status

注※

自動停止の設定が行われていることを確認してください。

viなどのエディターで，「(2) 定義パラメーター一覧」の定義パラメーターを記述した設定ファイルを作成する。
設定ファイルのファイル名は任意です。

ファイルを保存し，次のコマンドを実行する。

jbssetcnf 設定ファイル名

jbssetcnfコマンドのパスは，「/opt/jp1base/bin/jbssetcnf」です。
jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/AJS2を再起動する。
設定ファイルに記述した内容が反映されます。

(2)　定義パラメーター一覧

表16-18　ジョブ結果ファイルの二重受信防止定義パラメーター一覧

定義キー | 環境設定パラメーター | 定義内容
[{JP1_DEFAULT|論理ホスト名}¥JP1NBQMANAGER¥Job]※ | "ReceiveFileOption"= | ジョブ結果ファイルの二重受信防止の定義

注※

{JP1_DEFAULT|論理ホスト名}の部分は，「JP1_DEFAULT」または「論理ホスト名」を指定してください。

(3)　定義内容

"ReceiveFileOption"=dword: 00000000|00000001

ジョブ結果ファイルの二重受信防止を行うかどうかを指定します。

0

ジョブ結果ファイルの二重受信防止を行いません。

1

ジョブ結果ファイルの二重受信防止をします。

デフォルトは「0」です。

16.17　TCP/IP通信接続エラーのリトライ間隔・回数の変更

ジョブ実行制御ではジョブの登録，ジョブの配信，ジョブの状態通知，ジョブの状態確認またはエージェントホストの状態確認を行う際，プロセス間で情報を受け渡すためにTCP/IP通信を使用しています。接続先のマシンが起動していない場合やネットワーク障害が発生している場合，TCP/IP通信の接続エラーが発生します。

このとき，ジョブ実行制御のTCP/IP通信処理では，最初の接続要求に対して通信相手から応答がなかった場合に最大で90秒待ち，その後，20秒の間隔をおいて再接続を試みるリトライを2回行います。このため，リトライがすべて失敗し最終的に接続エラーとなるまでにおよそ4～5分が掛かることがあります。

ジョブの登録，ジョブの配信，ジョブの状態通知，ジョブの状態確認またはエージェントホストの状態確認を行う際に通信障害が発生すると，その検知に遅れが生じることがあります。障害の検知が遅れることによって，結果的にジョブの状態を変更するまでの時間が遅れることになります。

TCP/IP通信の接続エラーが頻繁に発生する場合は，接続タイムアウト時間，リトライ回数，リトライ間隔を短く設定変更することで，障害状態をより早く検知できます。

表16-19　値を変更する定義キー

定義キー | 使用目的
JP1NBQMANAGER¥Network | ジョブの配信，ジョブの状態確認，ジョブの状態通知，エージェントホストの状態確認（障害回復の検知）
JP1NBQAGENT¥Network | ジョブの状態通知
JP1NBQCLIENT¥Network | スケジュール制御からのジョブの登録，ジョブ実行に使用するコマンド
JP1NBQNOTIFY¥Network | 他システム（JP1/NQSEXECやJP1/OJEなど）のジョブの状態確認，および状態通知

ジョブ実行制御の接続タイムアウト，リトライ間隔・回数の設定手順を次に示します。

＜この節の構成＞

(1)　定義手順

(2)　定義パラメーター一覧

(3)　定義内容

(1)　定義手順

JP1/AJS2のサービスを停止する。
次のコマンドを実行して，プロセスがすべて停止していることを確認します。

# /etc/opt/jp1ajs2/jajs_stop※
# /opt/jp1ajs2/bin/jajs_spmd_status

注※

自動停止の設定が行われていることを確認してください。

viなどのエディターで，「(2) 定義パラメーター一覧」の定義パラメーターを記述した設定ファイルを作成する。
設定ファイルのファイル名は任意です。

ファイルを保存し，次のコマンドを実行する。

jbssetcnf 設定ファイル名

jbssetcnfコマンドのパスは，「/opt/jp1base/bin/jbssetcnf」です。
jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/AJS2を再起動する。
設定ファイルに記述した内容が反映されます。

(2)　定義パラメーター一覧

表16-20　ジョブ実行制御のTCP/IP通信定義パラメーター一覧

定義キー | 環境設定パラメーター | 定義内容
[{JP1_DEFAULT|論理ホスト名}¥JP1NBQMANAGER¥Network]※ | "ConnectTimeout"= | ジョブ実行制御マネージャーのTCP/IP通信接続タイムアウト値の定義（単位：ミリ秒）
"CommunicateRetryCount"= | ジョブ実行制御マネージャーのTCP/IP通信接続エラーのリトライ回数の定義
"CommunicateRetryInterval"= | ジョブ実行制御マネージャーのTCP/IP通信接続エラーのリトライ間隔の定義（単位：秒）
[{JP1_DEFAULT|論理ホスト名}¥JP1NBQAGENT¥Network]※ | "ConnectTimeout"= | ジョブ実行制御エージェントのTCP/IP通信接続タイムアウト値の定義（単位：ミリ秒）
"CommunicateRetryCount"= | ジョブ実行制御エージェントのTCP/IP通信接続エラーのリトライ回数の定義
"CommunicateRetryInterval"= | ジョブ実行制御エージェントのTCP/IP通信接続エラーのリトライ間隔の定義（単位：秒）
[{JP1_DEFAULT|論理ホスト名}¥JP1NBQCLIENT¥Network]※ | "ConnectTimeout"= | ジョブ実行に使用するコマンドおよびスケジュール制御のTCP/IP通信接続タイムアウト値の定義（単位：ミリ秒）
"CommunicateRetryCount"= | ジョブ実行に使用するコマンドおよびスケジュール制御のTCP/IP通信接続エラーのリトライ回数の定義
"CommunicateRetryInterval"= | ジョブ実行に使用するコマンドおよびスケジュール制御のTCP/IP通信接続エラーのリトライ間隔の定義（単位：秒）
[{JP1_DEFAULT|論理ホスト名}¥JP1NBQNOTIFY¥Network]※ | "ConnectTimeout"= | ジョブ実行制御状態通知プロセスのTCP/IP通信接続タイムアウト値の定義（単位：ミリ秒）
"CommunicateRetryCount"= | ジョブ実行制御状態通知プロセスのTCP/IP通信接続エラーのリトライ回数の定義
"CommunicateRetryInterval"= | ジョブ実行制御状態通知プロセスのTCP/IP通信接続エラーのリトライ間隔の定義（単位：秒）

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

(3)　定義内容

"ConnectTimeout"=dword:設定値

TCP/IP通信の接続タイムアウト値を16進数で指定します。

指定できる範囲は00002710～000927C0（10進数で10,000～600,000）（単位：ミリ秒）です。

デフォルトは「dword:00015F90」（10進数で90,000）で90秒です。

"CommunicateRetryCount"=dword:設定値

TCP/IP通信の接続エラーのリトライ回数を16進数で指定します。

指定できる範囲は00000000～00000064（10進数で0～100）です。

デフォルトは「dword:00000002」（10進数で2）です。

"CommunicateRetryInterval"=dword:設定値

TCP/IP通信の接続エラーのリトライ間隔を16進数で指定します。

指定できる範囲は00000001～0000012C（10進数で1～300）（単位：秒）です。

デフォルトは「dword:00000014」（10進数で20）です。

注意事項

接続タイムアウト，リトライ回数，リトライ間隔の値を小さくし過ぎると，通信のリトライ間隔が短くなるため，通信障害が回避できなくなり，TCP/IP通信の接続エラーが頻繁に発生することがありますので注意してください。

また，オペレーティングシステムの接続タイムアウト仕様とその設定によって，ConnectTimeoutに設定した値より前に接続のタイムアウトが発生することがあります。

16.18　ジョブを配信するエージェントホストの決定方式の設定

ジョブを配信する際に，優先順位とエージェント使用率が同一のエージェントホストが複数ある場合，デフォルトではエージェントID※の大きいエージェントホストを選択してジョブを配信します。

例えば，実行時間が非常に短いジョブを複数実行する場合，ジョブはすぐに終了するためエージェント使用率はなかなか上昇せず，ジョブが配信されていないエージェントホストとエージェント使用率を比較した際に差異が出にくくなります。結果として，エージェントIDの大きい方に偏ってジョブを配信するため，エージェントIDの大きいエージェントで実行するジョブ数が多くなり，システムの使用率に偏りが生じることになります。

このような場合に，エージェントIDの代わりに未使用時間が最も長いエージェントホストを選択してジョブを配信する方式を設定することで，均等に負荷分散を行うことができます。

注※

エージェントIDはjpqimportコマンドでジョブ実行環境構成定義ファイル（jpqsetup.conf）に指定したものです。また，jpqagtaddコマンドでエージェントを追加した場合は，使用していない番号から昇順に付加されます。jpqagtshowコマンドでエージェントの一覧を表示するとエージェントIDの昇順で表示されます。

ジョブを配信するエージェントホストの決定方式を設定するための手順を次に示します。

＜この節の構成＞

(1)　定義手順

(2)　定義パラメーター一覧

(3)　定義内容

(1)　定義手順

JP1/AJS2のサービスを停止する。
次のコマンドを実行して，プロセスがすべて停止していることを確認します。

# /etc/opt/jp1ajs2/jajs_stop※
# /opt/jp1ajs2/bin/jajs_spmd_status

注※

自動停止の設定が行われていることを確認してください。

viなどのエディターで，「(2) 定義パラメーター一覧」の定義パラメーターを記述した設定ファイルを作成する。
設定ファイルのファイル名は任意です。

ファイルを保存し，次のコマンドを実行する。

jbssetcnf 設定ファイル名

jbssetcnfコマンドのパスは，「/opt/jp1base/bin/jbssetcnf」です。
jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/AJS2を再起動する。
設定ファイルに記述した内容が反映されます。

(2)　定義パラメーター一覧

表16-21　ジョブを配信するエージェントホストの決定方式定義パラメーター一覧

定義キー | 環境設定パラメーター | 定義内容
[{JP1_DEFAULT|論理ホスト名}¥JP1NBQMANAGER¥Agent]※ | "LeastRecentlyUsed"= | ジョブを配信するエージェントホストの決定方式の定義

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

(3)　定義内容

"LeastRecentlyUsed"=dword:設定値

ジョブを配信するエージェントホストの決定方式を指定します。

0

複数の接続エージェントが同じ優先順位で，さらにエージェント使用率が同じであった場合に，エージェントIDが大きいものをジョブの配信先エージェントホストに決定します。

1

複数の接続エージェントが同じ優先順位で，さらにエージェント使用率が同じであった場合に，ジョブを最後に配信してから最も未使用時間が長いエージェントホストをジョブの配信先エージェントホストに決定します。

デフォルトは「0」です。

16.19　マクロ変数の展開失敗時の動作の設定

ジョブの実行時にマクロ変数の引き継ぎ情報の展開が失敗した場合，そのジョブネットの状態を「起動失敗」にするか，マクロ変数を文字列として扱いそのままジョブネットを実行させるかを設定できます。

ジョブ実行時にマクロ変数の引き継ぎに失敗した場合の動作を設定するための方法を次に示します。

＜この節の構成＞

(1)　定義手順

(2)　環境設定パラメーター一覧

(3)　定義内容

(1)　定義手順

JP1/AJS2のサービスを停止する。
次のコマンドを実行して，プロセスがすべて停止していることを確認します。

# /etc/opt/jp1ajs2/jajs_stop※
# /opt/jp1ajs2/bin/jajs_spmd_status

注※

自動停止の設定が行われていることを確認してください。

次のファイルをviなどのエディターで開く。

/etc/opt/jp1ajs2/conf/Common.conf

環境設定パラメーターを次に示すとおり変更する。

[{JP1_DEFAULT|論理ホスト名}¥JP1AJS2COMMON¥]
"MACROCHANGEFAIL"="yes"

（環境設定パラメーターの詳細については(2)を参照）

ファイルを保存し，次のコマンドを実行する。

jbssetcnf /etc/opt/jp1ajs2/conf/Common.conf

jbssetcnfコマンドのパスは，「/opt/jp1base/bin/jbssetcnf」です。
jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/AJS2を再起動する。
変更した構成定義の内容が反映されます。

(2)　環境設定パラメーター一覧

表16-22　環境設定パラメーター一覧

定義キー | 環境設定パラメーター | 定義内容
[{JP1_DEFAULT|論理ホスト名}¥JP1AJS2COMMON]※ | "MACROCHANGEFAIL"= | イベントジョブ，および実行登録時に指定したマクロ変数の展開失敗時の動作

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

(3)　定義内容

"MACROCHANGEFAIL"="{yes|no}"

ジョブ実行時，マクロ変数の引き継ぎ情報の展開に失敗した場合に，状態を「起動失敗」にするかどうかを指定します。

yes

ジョブ実行時，マクロ変数の引き継ぎ情報の展開に失敗した場合に，状態を「起動失敗」にし，展開に失敗したマクロ変数が確認できるエラーメッセージを日立統合ログおよび実行結果詳細に出力します。

no

ジョブ実行時，マクロ変数の引き継ぎ情報の展開に失敗しても，マクロ変数に定義した情報をそのまま文字列として扱い，処理を続行します。

デフォルトは「no」です。

16.20　マクロ変数の引き継ぎ情報がNULL文字列の場合の置き換え方法の設定

マクロ変数の引き継ぎ情報は，イベントジョブで受信したイベント情報やJP1/AJS2 - Scenario Operationとの連携機能を使用している場合の定義情報として使用します。マクロ変数の詳細については，マニュアル「JP1/Automatic Job Management System 2 解説　4.1.2 実行登録時のマクロ変数値の指定」を参照してください。また，イベントジョブでのマクロ変数の定義例については，マニュアル「JP1/Automatic Job Management System 2 解説　3.2.4(6) イベントジョブの受信情報の引き継ぎ」を参照してください。

イベントジョブで受信したイベント情報をマクロ変数として定義しておき，後続ジョブまたは後続ジョブネットに引き継ぐことができます。後続ジョブに引き継ぐ情報を引き継ぎ情報といいます。マクロ変数の定義例については，マニュアル「JP1/Automatic Job Management System 2 解説　3.2.4(6) イベントジョブの受信情報の引き継ぎ」を参照してください。

マクロ変数として引き継いだ情報がNULL文字列のときに，マクロ変数の前後に文字列がなくマクロ変数だけを指定している場合，次に示す2種類の動作が選択できます。

マクロ変数名をそのまま文字列として扱う（デフォルトの動作）

NULL文字列に置き換える

それぞれの動作を次に示します。

マクロ変数名を文字列として扱う場合

引き継ぎ情報がNULL文字列でマクロ変数の前後に文字列がない場合
［?AJS2（マクロ変数名）?］→［?AJS2（マクロ変数名）?］

引き継ぎ情報がNULL文字列でマクロ変数の前後に文字列がある場合
［aaa?AJS2（マクロ変数名）?bbb］→［aaabbb］
［ccc?AJS2（マクロ変数名）?］→［ccc］
［?AJS2（マクロ変数名）?ddd］→［ddd］

NULL文字列に置き換える場合

引き継ぎ情報がNULL文字列でマクロ変数の前後に文字列がない場合
［?AJS2（マクロ変数名）?］→［］

引き継ぎ情報がNULL文字列でマクロ変数の前後に文字列がある場合
［aaa?AJS2（マクロ変数名）?bbb］→［aaabbb］
［ccc?AJS2（マクロ変数名）?］→［ccc］
［?AJS2（マクロ変数名）?ddd］→［ddd］

この設定は，実行先サービスに「JP1/AJS2」を指定したジョブが対象です。実行先サービスに「JP1/AJS2 Queueless Agent」を指定した場合，オプションの設定とは関係なくマクロ変数名をNULL文字列に置き換えます。また，この設定は，JP1/AJS2 07-11以前からマクロ変数を指定できる次の定義項目にだけ有効です。

UNIXジョブ

コマンド文

スクリプトファイル名

パラメーター

環境変数

PCジョブ

実行ファイル名

パラメーター

環境変数

JP1/AJS2 07-50以降で，JP1/AJS2 - Scenario Operationと連携するために新たに指定できる項目となった定義項目では，オプションの設定とは関係なくマクロ変数名をNULL文字列に置き換えます。マクロ変数名を文字列として扱う設定（デフォルトの動作）の場合，07-11以前からの定義項目と07-50以降で追加された定義項目とでは，置き換えたあとの結果が異なります。

文字列として扱う指定（デフォルトの動作）の場合の例

07-11以前からの定義項目：［?AJS2AAA?］→［?AJS2AAA?］

07-50以降で追加された定義項目：［?AJS2AAA?］→［］

JP1/AJS2 - Scenario Operationとの連携機能を使用している場合に，07-11以前からの定義項目と，07-50以降で追加された定義項目の動作を合わせる必要がある場合は，マクロ変数名をNULL文字列に置き換えるように設定してください。

なお，マクロ変数の前後に必ず文字列を指定する運用の場合，またマクロ変数名がそのまま文字列に置き換わることを期待する運用の場合，この設定を行う必要はありません。

マクロ変数の引き継ぎ情報がNULL文字列の場合の置き換え方法の設定手順を次に示します。

＜この節の構成＞

(1)　定義手順

(2)　定義パラメーター一覧

(3)　定義内容

(1)　定義手順

JP1/AJS2のサービスを停止する。
次のコマンドを実行して，プロセスがすべて停止していることを確認します。

# /etc/opt/jp1ajs2/jajs_stop※
# /opt/jp1ajs2/bin/jajs_spmd_status

注※

自動停止の設定が行われていることを確認してください。

viなどのテキストエディターで，「(2) 定義パラメーター一覧」の定義パラメーターを記述した設定ファイルを作成する。
設定ファイルのファイル名は任意です。

ファイルを保存し，次のコマンドを実行する。

jbssetcnf 設定ファイル名

jbssetcnfコマンドのパスは，「/opt/jp1base/bin/jbssetcnf」です。
jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/AJS2を再起動する。
設定ファイルに記述した内容が反映されます。

(2)　定義パラメーター一覧

表16-23　マクロ変数の引き継ぎ情報がNULL文字列の場合の置き換え方法の定義パラメーター

定義キー | 環境設定パラメーター | 定義内容
[{JP1_DEFAULT|論理ホスト名}¥JP1NBQCLIENT¥Process]※ | "MacroOptionReplaceMode"= | マクロ変数の引き継ぎ情報がNULL文字列の場合の置き換え方法の設定

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

(3)　定義内容

"MacroOptionReplaceMode"=dword:0|1

前後に文字列がないマクロ変数の引き継ぎ情報がNULL文字列の場合に，マクロ変数名をNULL文字列に置き換えるかどうかを指定します。

0

マクロ変数名をNULL文字列に置き換えず，指定されたマクロ変数名をそのままの文字列として使用する場合に指定します。JP1/AJS2 07-11以前からの動作と同じです。

1

マクロ変数名をNULL文字列に置き換える場合に指定します。

デフォルトは「0」です。

16.21　ラージファイルを監視するための設定

ファイル監視ジョブでラージファイル（2ギガバイト以上のファイル）を監視したり，判定ジョブでラージファイルを判定したりするための設定手順を次に示します。

＜この節の構成＞

(1)　定義手順

(2)　定義パラメーター一覧

(3)　定義内容

(1)　定義手順

JP1/AJS2のサービスを停止する。
次のコマンドを実行して，プロセスがすべて停止していることを確認します。

# /etc/opt/jp1ajs2/jajs_stop※
# /opt/jp1ajs2/bin/jajs_spmd_status

注※

自動停止の設定が行われていることを確認してください。

viなどのテキストエディターで，「(2) 定義パラメーター一覧」の定義パラメーターを記述した設定ファイルを作成する。
設定ファイルのファイル名は任意です。

ファイルを保存し，次のコマンドを実行する。

jbssetcnf 設定ファイル名

jbssetcnfコマンドのパスは，「/opt/jp1base/bin/jbssetcnf」です。
jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/AJS2を再起動する。
設定ファイルに記述した内容が反映されます。

(2)　定義パラメーター一覧

表16-24　ラージファイルを監視・判定するための定義パラメーター

定義キー | 環境設定パラメーター | 定義内容
[{JP1_DEFAULT|論理ホスト名}¥JP1AJS2COMMON]※ | "LARGEFILEUSE"= | ラージファイル対応の動作設定

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

(3)　定義内容

"LARGEFILEUSE"="{yes|no}"

ファイル監視ジョブでラージファイルを監視，および判定ジョブでラージファイルを判定するかどうかを指定します。

yes

ファイル監視ジョブでサイズが2ギガバイト以上のファイルを監視，および判定ジョブでサイズが2ギガバイト以上のファイルの有無を判定できます。

no

ファイル監視ジョブでサイズが2ギガバイト以上のファイルは監視できません。「no」を指定して，2ギガバイト以上のファイルを監視対象に指定した場合，ファイル監視ジョブの実行時にエラーメッセージが統合トレースログに出力され，ジョブは異常終了します。ただし，実行ホストのOSがLinux（IPF）の場合，エラーメッセージの出力やジョブの異常終了はしませんが，ファイル変更の誤検知などの不正な動作をするおそれがあります。このため，監視対象ファイルには2ギガバイト以上のファイルを指定しないでください。

判定ジョブでサイズが2ギガバイト以上のファイルの有無を判定できません。「no」を指定して，2ギガバイト以上のファイルを判定条件で指定した場合，OSがLinux（IPF）以外の場合は常にファイルがないものとして判定されます。

デフォルトは「no」です。

16.22　エージェントの障害回復待ち時間を短縮する設定方法

JP1/AJS2では，ジョブ（キューレスジョブを除くPCジョブ・UNIXジョブ，JP1/AJS2上で実行するQUEUEジョブ，アクションジョブ，およびカスタムジョブ）の実行ホスト（エージェントホスト）が障害状態になった場合や通信障害が発生した場合，即時に異常検知とはしないで，ある程度の待ち時間を設けて通信リトライすることで，エージェントホスト上のシステム障害や通信障害状態が回復するのを待ちます。これによって，一時的な障害による，回復可能な業務停止を防止しています。通常，障害回復待ち時間はデフォルトで10分です。

ただし，運用によっては障害が発生した場合は回復を待つことよりも，直ちに異常を検知して早急なリカバリーを優先させる場合があります。その場合は障害回復待ち時間を短縮することで，早急な障害検知ができます。

エージェントホストの障害回復待ち時間を短縮する設定方法について次に説明します。

＜この節の構成＞

(1)　定義手順

(2)　定義パラメーター一覧

(3)　定義内容

(1)　定義手順

JP1/AJS2のサービスを停止する。
次のコマンドを実行して，プロセスがすべて停止していることを確認します。

# /etc/opt/jp1ajs2/jajs_stop※
# /opt/jp1ajs2/bin/jajs_spmd_status

注※

自動停止の設定が行われていることを確認してください。

クラスタ運用をしている場合は，論理ホストのJP1/AJS2のサービスも停止してください。

viなどのテキストエディターで，「(2) 定義パラメーター一覧」の定義パラメーターを記述した設定ファイルを作成する。
設定ファイルのファイル名は任意です。

ファイルを保存し，次のコマンドを実行する。

jbssetcnf 設定ファイル名

jbssetcnfコマンドのパスは，「/opt/jp1base/bin/jbssetcnf」です。
jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

注意事項

クラスタ運用をしている場合は，実行系・待機系の両方でこの設定をしてください。

JP1/AJS2を再起動する。
設定ファイルに記述した内容が反映されます。

(2)　定義パラメーター一覧

表16-25　エージェントの障害回復待ち時間の設定のための定義パラメーター一覧

定義キー | 環境設定パラメーター | 定義内容
[{JP1_DEFAULT|論理ホスト名}¥JP1NBQMANAGER¥Job]※ | "QueuingJobRecoveryTime"= | キューイング中のジョブに対するエージェントの障害回復待ち時間（単位：秒）
[{JP1_DEFAULT|論理ホスト名}¥JP1NBQMANAGER¥Job]※ | "ExecutingJobRecoveryTime"= | 実行中のジョブに対するエージェントの障害回復待ち時間（単位：秒）

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

(3)　定義内容

"QueuingJobRecoveryTime"=dword:設定値

キューイング中のジョブに対するエージェントの障害回復待ち時間を16進数で指定します。

指定できる範囲は0000001E～00000E10（10進数で30～3600）（単位：秒）です。※

デフォルトは「00000258」（10進数で600）で10分です。

注※

ジョブが実行されていない時間帯は，ジョブの異常を数十秒の間隔で監視しているため，ジョブの異常検知が数十秒遅れる場合があります。

"ExecutingJobRecoveryTime"=dword:設定値

実行中のジョブに対するエージェントの障害回復待ち時間を16進数で指定します。

指定できる範囲は0000001E～00000E10（10進数で30～3600）（単位：秒）です。

デフォルトは「00000258」（10進数で600）で10分です。※

注※

デフォルトの動作では，ジョブの異常検知までに実行中のジョブの状態確認を最大で3回実行します。また，実行中のジョブに対するエージェントの障害回復待ち時間をエージェント監視インターバル未満に設定した場合は，実行中のジョブの状態確認を実行する前に障害回復待ち時間に到達するため，実行中のジョブの状態確認を最大で2回実行します。障害検知までの合計時間の内訳は次のようになります。

障害検知までの合計時間 ≒

（エージェント監視インターバル × 1回）

＋ （通信時間 × 2回）

＋ 障害発生時間から最初の状態確認までの時間

また，エージェント監視インターバル，TCP/IP通信接続エラーのリトライ間隔，リトライ回数を短く変更すると，障害検知までの合計時間はさらに短くなります。エージェント監視インターバルの設定については，「14.2.2 マネージャー環境（JP1/AJS2 - Manager）で設定する内容」を参照してください。TCP/IP通信接続エラーのリトライ間隔，およびリトライ回数の設定の詳細については，「16.17 TCP/IP通信接続エラーのリトライ間隔・回数の変更」を参照してください。

エージェント監視インターバルを使用したポーリングはエージェントホストごとに行います。したがって，エージェント監視インターバルの設定値を短くしてポーリング回数が増えるとエージェントホスト数に比例して通信回数が増えますので，設定を変更する場合は十分に注意してください。また，TCP/IP通信接続エラーのリトライ間隔，リトライ回数を変更する際にも注意事項がありますので十分に確認してください。

16.23　ジョブ情報削除処理に関する設定

JP1/AJS2では，ジョブ情報削除基準時刻およびJP1/AJS2起動時に，ジョブ実行環境で使用するISAMデータベースからジョブ情報保存日数を経過したジョブを削除します。

ジョブ情報削除処理に関して，運用形態に合わせた設定をしてください。

ジョブ情報削除処理非同期オプションの設定
ジョブ情報の削除処理を非同期で行う場合に指定します。

ジョブ情報の保存時間の設定
ジョブの保存日数を0日にしている場合に，ジョブが終了してから削除するまでの時間を指定します。

JP1/AJS2起動時にジョブ情報削除処理を抑止する設定
ジョブ情報の保存日数を1日以上設定している場合に，JP1/AJS2サービス起動時にジョブ情報の削除処理を抑止するように設定します。

詳細については，マニュアル「JP1/Automatic Job Management System 2 設計・運用ガイド　8.1.7 ジョブ情報削除処理の注意事項」を参照してください。

＜この節の構成＞

16.23.1　ジョブ情報削除処理非同期オプションの設定

16.23.2　ジョブ情報の保存時間の設定

16.23.3　JP1/AJS2起動時にジョブ情報削除処理を抑止する設定

16.23.1　ジョブ情報削除処理非同期オプションの設定

ジョブ情報の削除処理を非同期で行う場合の設定手順を次に示します。

＜この項の構成＞

(1)　定義手順

(2)　定義パラメーター一覧

(3)　定義内容

(1)　定義手順

JP1/AJS2のサービスを停止する。
次のコマンドを実行して，プロセスがすべて停止していることを確認します。

# /etc/opt/jp1ajs2/jajs_stop※
# /opt/jp1ajs2/bin/jajs_spmd_status

注※

自動停止の設定が行われていることを確認してください。

viなどのテキストエディターで，「(2) 定義パラメーター一覧」の定義パラメーターを記述した設定ファイルを作成する。
設定ファイルのファイル名は任意です。

ファイルを保存し，次のコマンドを実行する。

jbssetcnf 設定ファイル名

jbssetcnfコマンドのパスは，「/opt/jp1base/bin/jbssetcnf」です。
jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/AJS2を再起動する。
設定ファイルに記述した内容が反映されます。

(2)　定義パラメーター一覧

表16-26　ジョブ情報削除処理非同期オプション設定の定義パラメーター

定義キー | 環境設定パラメーター | 定義内容
[{JP1_DEFAULT|論理ホスト名}¥JP1NBQMANAGER¥Database]※ | "DeleteFlashOption"= | ジョブ情報削除処理非同期オプション

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

(3)　定義内容

"DeleteFlashOption"=dword:設定値

ジョブ情報の削除について非同期で実行するかどうかを指定します。

0

ジョブ情報の削除を非同期で実行する場合に指定します。

1

ジョブ情報の削除を同期で実行する場合に指定します。

デフォルトは「1」です。このパラメーターは，JP1/AJS2の新規のインストール時および新規のセットアップ時に「0」が設定されます。

16.23.2　ジョブ情報の保存時間の設定

ジョブの保存日数を0日にしている場合に，ジョブが終了してから削除するまでの時間を設定する手順を次に示します。

＜この項の構成＞

(1)　定義手順

(2)　定義パラメーター一覧

(3)　定義内容

(1)　定義手順

JP1/AJS2のサービスを停止する。
次のコマンドを実行して，プロセスがすべて停止していることを確認します。

# /etc/opt/jp1ajs2/jajs_stop※
# /opt/jp1ajs2/bin/jajs_spmd_status

注※

自動停止の設定が行われていることを確認してください。

viなどのテキストエディターで，「(2) 定義パラメーター一覧」の定義パラメーターを記述した設定ファイルを作成する。
設定ファイルのファイル名は任意です。

ファイルを保存し，次のコマンドを実行する。

jbssetcnf 設定ファイル名

jbssetcnfコマンドのパスは，「/opt/jp1base/bin/jbssetcnf」です。
jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/AJS2を再起動する。
設定ファイルに記述した内容が反映されます。

(2)　定義パラメーター一覧

表16-27　ジョブ情報の保存時間設定の定義パラメーター

定義キー | 環境設定パラメーター | 定義内容
[{JP1_DEFAULT|論理ホスト名}¥JP1NBQMANAGER¥Database]※ | "PreserveMinute"= | ジョブ情報の保存時間

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

(3)　定義内容

"PreserveMinute"=dword:設定値

ジョブ情報の保存時間を16進数で指定します。

指定できる範囲は0000000A～000005A0（10進数で10～1440）（単位：分）です。

デフォルトは「dword:0000000A」（10進数で10）です。

16.23.3　JP1/AJS2起動時にジョブ情報削除処理を抑止する設定

ジョブ情報の保存日数を1日以上設定している場合に，JP1/AJS2サービス起動時にジョブ情報の削除処理を抑止するように設定します。

＜この項の構成＞

(1)　定義手順

(2)　定義パラメーター一覧

(3)　定義内容

(4)　JP1/AJS2起動時にジョブ情報削除処理を抑止する設定と動作

(1)　定義手順

JP1/AJS2のサービスを停止する。
次のコマンドを実行して，プロセスがすべて停止していることを確認します。

# /etc/opt/jp1ajs2/jajs_stop※
# /opt/jp1ajs2/bin/jajs_spmd_status

注※

自動停止の設定が行われていることを確認してください。

viなどのテキストエディターで，「(2) 定義パラメーター一覧」の定義パラメーターを記述した設定ファイルを作成する。
設定ファイルのファイル名は任意です。

ファイルを保存し，次のコマンドを実行する。

jbssetcnf 設定ファイル名

jbssetcnfコマンドのパスは，「/opt/jp1base/bin/jbssetcnf」です。
jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/AJS2を再起動する。
設定ファイルに記述した内容が反映されます。

(2)　定義パラメーター一覧

表16-28　JP1/AJS2起動時にジョブ情報削除処理を抑止する設定の定義パラメーター

定義キー | 環境設定パラメーター | 定義内容
[{JP1_DEFAULT|論理ホスト名}¥JP1NBQMANAGER¥Database]※ | "StartUpDelete"= | JP1/AJS2起動時にジョブ情報削除処理を抑止する定義

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

(3)　定義内容

"StartUpDelete"=dword:設定値

JP1/AJS2起動時にジョブ情報削除処理を抑止するかどうかを指定します。

0

JP1/AJS2サービス起動時にジョブ情報削除の基準時刻を基点として，保存日数を超えているジョブ情報を削除する場合に指定します。

JP1/AJS2サービス起動時，ジョブ情報削除の基準時刻からJP1/AJS2サービス起動時刻までの間に保存日数を超えたジョブ情報については削除しません。

前回のジョブ情報削除の基準時刻にJP1/AJS2サービスが停止していてジョブ情報削除処理が実施されなかった場合に，ジョブ情報削除の基準時刻を基点として保存日数を超えているジョブ情報が残っていることがあります。その場合は，JP1/AJS2サービス起動時に，これらのジョブ情報だけを削除します。

1

JP1/AJS2サービス起動時にJP1/AJS2サービス起動時刻を基点として，保存日数を超えているジョブ情報をジョブ情報削除処理で削除する場合に指定します。

JP1/AJS2サービス起動時，ジョブ情報削除の基準時刻からJP1/AJS2サービス起動時刻までの間に保存日数を超えたジョブ情報がある場合，これらのジョブ情報を削除します。

前回のジョブ情報削除の基準時刻にJP1/AJS2サービスが停止していてジョブ情報削除処理が実施されなかった場合に，ジョブ情報削除の基準時刻を基点として保存日数を超えているジョブ情報が残っていることがあります。その場合は，JP1/AJS2サービス起動時に，これらのジョブ情報も削除します。

2

JP1/AJS2サービス起動時のジョブ情報削除処理を抑止する場合に指定します。

ただし，ジョブ情報削除の基準時刻にJP1/AJS2サービスを停止する運用の場合はこの設定をしないでください。

ジョブ情報削除の基準時刻にJP1/AJS2サービスが停止していると，ジョブ情報削除の基準時刻を基点として保存日数を超えているジョブ情報が削除されません。そのため，ジョブ実行環境データベースのディスク占有量が増加し続けます。ジョブ実行環境データベースのディスク占有量が増加すると，JP1/AJS2サービスの起動に失敗したり，ジョブが実行できなくなったりするといった影響が出るおそれがあります。

デフォルトは「1」です。

このパラメーターは，JP1/AJS2の新規のインストール時および新規のセットアップ時に「0」が設定されます。

(4)　JP1/AJS2起動時にジョブ情報削除処理を抑止する設定と動作

JP1/AJS2起動時にジョブ情報削除処理を抑止する設定と，削除処理を行うかどうかの関係について次に示します。

表16-29　JP1/AJS2起動時にジョブ情報削除処理を抑止する設定と削除処理を行うかどうかの関係

JP1/AJS2起動時にジョブ情報削除処理を抑止する設定 | JP1/AJS2起動時のジョブ情報削除処理 | 削除対象のジョブ情報の基点となる時刻
0 | ○※ | 基準時刻
1 | ○ | JP1/AJS2サービス起動時刻
2 | × | －

（凡例）

○：削除処理を行う

×：削除処理を行わない

－：該当なし

注※

前回のジョブ情報削除の基準時刻にジョブ情報が削除されていれば，JP1/AJS2サービス起動時のジョブ情報削除処理ではジョブ情報を削除しません。

16.24　新規インストール後に以前のバージョンの設定に戻す方法

JP1/AJS2 - Manager 08-00以降，またはJP1/AJS2 - Agent 08-00以降を新規にインストールする場合，08-00より前のバージョンと動作環境の設定が異なります。このため，08-00より前のバージョンのJP1/AJS2と混在させて動作させるような場合，08-00より前のバージョンの動作環境の設定に戻し，統一した動作環境で動作させることができます。

＜この節の構成＞

16.24.1　JP1/AJS2 - Managerの設定を以前のバージョンの設定に戻す

16.24.2　JP1/AJS2 - Agentの設定を以前のバージョンの設定に戻す

16.24.1　JP1/AJS2 - Managerの設定を以前のバージョンの設定に戻す

新規にインストールしたJP1/AJS2 - Manager 08-00以降の設定を08-00より前のバージョンの設定に戻す手順を次に示します。

JP1/AJS2のサービスを停止する。
次のコマンドを実行して，プロセスがすべて停止していることを確認します。

# /etc/opt/jp1ajs2/jajs_stop※
# /opt/jp1ajs2/bin/jajs_spmd_status

注※

自動停止の設定が行われていることを確認してください。

次のファイルをコピーしてajs2_0750.confを作成する。
/etc/opt/jp1ajs2/conf/ajs2_0750.conf.model

ajs2_0750.confをviなどのテキストエディターで開き，必要に応じて次の項目を編集する。

論理ホスト名

スケジューラーサービス名

ファイルを保存し，次のコマンドを実行する。

jbssetcnf 保存先ディレクトリ/ajs2_0750.conf

jbssetcnfコマンドのパスは，「/opt/jp1base/bin/jbssetcnf」です。
jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/AJS2を再起動する。
08-00より前のバージョンの設定に戻ります。

16.24.2　JP1/AJS2 - Agentの設定を以前のバージョンの設定に戻す

新規にインストールしたJP1/AJS2 - Agent 08-00以降の設定を08-00より前のバージョンの設定に戻す手順を次に示します。

JP1/AJS2のサービスを停止する。
次のコマンドを実行して，プロセスがすべて停止していることを確認します。

# /etc/opt/jp1ajs2/jajs_stop※
# /opt/jp1ajs2/bin/jajs_spmd_status

注※

自動停止の設定が行われていることを確認してください。

次のファイルをコピーしてajs2_0750.confを作成する。
/etc/opt/jp1ajs2/conf/ajs2_0750.conf.model

ajs2_0750.confをviなどのテキストエディターで開き，必要に応じて次の項目を編集する。

論理ホスト名

スケジューラーサービス名

ファイルを保存し，次のコマンドを実行する。

jbssetcnf 保存先ディレクトリ/ajs2man_0750.conf

jbssetcnfコマンドのパスは，「/opt/jp1base/bin/jbssetcnf」です。
jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/AJS2を再起動する。
08-00より前のバージョンの設定に戻ります。

16.25　ジョブ実行多重度到達を確認するメッセージを出力する設定

エージェントホストで実行中のジョブ数が，ジョブ実行多重度に達しているために後続のジョブの状態がキューイングのままとなり，ジョブが実行されるまでに時間が掛かることがあります。

ジョブ実行多重度に達しているためにジョブが登録できない場合に，次に示すメッセージを統合トレースログに出力するようにあらかじめ設定しておくことで，ジョブの実行に時間が掛かった要因がジョブ実行多重度到達であるかどうかを確認できます。

KAVU4310-I　エージェント(エージェントホスト名)で実行中のジョブ数がジョブ実行多重度（ジョブ実行多重度）に達しています（ホスト名：ホスト名，ジョブ番号：ジョブ番号）

この設定を行って，ジョブの状態がキューイングになっているにもかかわらず，このメッセージが出力されない場合は，次に示すどれかの要因が考えられますので，エージェントまたはキューの状態やジョブの実行先ホストの状態を確認してください。

ジョブ実行多重度に「0」が設定されている場合
jpqagtshowコマンドでジョブ実行多重度（CUREXECHGNUM）を確認してください。

キュー（デフォルトキューを含む）の設定でジョブの取出口が閉じている場合
jpqqueshowコマンドでジョブの取出口（EXITSTATUS）の状態を確認してください。

エージェントホストが停止，または障害状態になっている場合
エージェントホストでJP1/AJS2サービスが停止していないか，また，何らかの障害が発生していないかエージェントホスト上の統合トレースログを確認してください。また，マネージャーホストと通信できる状態かを確認してください。

排他実行リソースを指定したジョブでリソースの解放待ちになっている場合
jpqresshowコマンドでSTATUSがEXECUTINGになっているジョブが存在しないかを確認してくいださい。

ジョブ実行多重度の詳細については，マニュアル「JP1/Automatic Job Management System 2 設計・運用ガイド　8.1.19 ジョブ実行多重度に関する注意事項」を参照してください。

ジョブ実行多重度到達を確認するメッセージを出力するための設定手順を次に示します。

＜この節の構成＞

(1)　定義手順

(2)　定義パラメーター一覧

(3)　定義内容

(1)　定義手順

JP1/AJS2のサービスを停止する。
次のコマンドを実行して，プロセスがすべて停止していることを確認します。

# /etc/opt/jp1ajs2/jajs_stop※
# /opt/jp1ajs2/bin/jajs_spmd_status

注※

自動停止の設定が行われていることを確認してください。

viなどのテキストエディターで，「(2) 定義パラメーター一覧」の定義パラメーターを記述した設定ファイルを作成する。
設定ファイルのファイル名は任意です。

ファイルを保存し，次のコマンドを実行する。

jbssetcnf 設定ファイル名

jbssetcnfコマンドのパスは，「/opt/jp1base/bin/jbssetcnf」です。
jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/AJS2を再起動する。
設定ファイルに記述した内容が反映されます。

(2)　定義パラメーター一覧

表16-30　ジョブ実行多重度到達を確認するメッセージを出力する設定のための定義パラメーター一覧

定義キー | 環境設定パラメーター | 定義内容
［{JP1_DEFAULT|論理ホスト名}¥JP1NBQMANAGER¥Job］※ | "MaximumExecJobLogOption"= | ジョブ実行多重度到達を確認するメッセージを出力する設定
"MaximumExecJobLogInterval"= | ジョブ実行多重度到達を確認するメッセージを出力する間隔

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

(3)　定義内容

"MaximumExecJobLogOption"=dword:設定値

ジョブ実行多重度到達を確認するメッセージを出力するかどうかを指定します。

0

ジョブ実行多重度到達を確認するメッセージを出力しません。

1

ジョブ実行多重度到達を確認するメッセージを出力します。

デフォルトは「0」です。

"MaximumExecJobLogInterval"=dword:設定値

ジョブ実行多重度到達を確認するメッセージを出力する間隔を16進数で指定します。

指定できる範囲は0000003C～00015180（10進数で60～86400）（単位：秒）です。

デフォルトは「00000258」（10進数で600）で10分です。

最初にKAVU4310-Iメッセージを出力したあと，この設定値の間隔（デフォルト10分）の間は，ジョブのキューイング状態が続いてもKAVU4310-Iメッセージは出力されません。この設定値に指定した時間を過ぎてもジョブのキューイング状態が続いている場合は，再度KAVU4310-Iメッセージがこの設定値の間隔で出力されます。

16.26　JP1/AJS2から起動される子プロセスを，SIGCHLDシグナルを受信する設定（SIG_DFL）に変更する方法

UNIX環境でJP1/AJS2のUNIXジョブ※，アクションジョブを実行する場合，ジョブの実行ユーザーが使用するログインシェルによっては，ジョブが異常終了したり，意図しない実行結果になったりすることがあります。これは，JP1/AJS2から起動される子プロセスが，SIGCHLDシグナルを無視する（SIG_IGN）設定で起動されるためです。SIGCHLDシグナルを受信するデフォルト（SIG_DFL）で実行できるようにするための設定方法を次に示します。なお，JP1/AJS2で設定される子プロセスのシグナルについては，「(3) JP1/AJS2で設定する子プロセスのシグナル」を参照してください。

注※

ジョブの実行先サービスに［JP1/AJS2 Queueless Agent］を指定した場合を除きます。

注意事項

JP1/AJS2 08-00以降を新規インストールする場合は，SIGCHLDシグナルを受信する設定になっています。以降で説明している設定は必要ありません。

JP1/AJS2 07-50以前のバージョンからJP1/AJS2 08-00以降をバージョンインストールする場合は，JP1/AJS2 07-50以前の設定が引き継がれます。SIGCHLDシグナルを受信する設定に変更する場合は，以降で説明する設定が必要です。

＜この節の構成＞

(1)　設定方法1

(2)　設定方法2

(3)　JP1/AJS2で設定する子プロセスのシグナル

(1)　設定方法1

JP1/AJS2から上記に該当するアプリケーションを起動する場合は，ジョブ実行ユーザーのログインシェルにsh，csh，ksh（Linuxの場合はcsh）を使用する，またはそのシェルを経由してアプリケーションを起動させてください。

(2)　設定方法2

(a)　定義手順

JP1/AJS2のサービスを停止する。
次のコマンドを実行して，プロセスがすべて停止していることを確認します。

# /etc/opt/jp1ajs2/jajs_stop※
# /opt/jp1ajs2/bin/jajs_spmd_status

注※

自動停止の設定が行われていることを確認してください。

viなどのテキストエディターで，（b）の定義パラメーターを記述した設定ファイルを作成する。
設定ファイルのファイル名は任意です。

ファイルを保存し，次のコマンドを実行する。

jbssetcnf 設定ファイル名

jbssetcnfコマンドのパスは，「/opt/jp1base/bin/jbssetcnf」です。
jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/AJS2を再起動する。
設定ファイルに記述した内容が反映されます。

注意事項

SIGCHLDシグナルを受信する設定（SIG_DFL）に変更する場合，ジョブを実行するホスト上で設定してください。

(b)　定義パラメーター一覧

表16-31　JP1/AJS2から起動される子プロセスを，SIGCHLDシグナルを受信する設定（SIG_DFL）に変更する定義パラメーター

定義キー | 環境設定パラメーター | 定義内容
[{JP1_DEFAULT|論理ホスト名}¥JP1NBQAGENT¥Job]※ | "IsSigchldDefault"= | JP1/AJS2から起動される子プロセスを，SIGCHLDシグナルを受信する設定（SIG_DFL）に変更する定義

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

(c)　定義内容

"IsSigchldDefault"=dword:00000000|00000001

SIGCHLDを受信するデフォルト（SIG_DFL）で実行するかどうかを指定します。

0

SIGCHLDシグナルを無視する場合に指定します。

1

デフォルト（SIG_DFL）で実行する場合に指定します。

デフォルトは「0」です。

このパラメーターは，JP1/AJS2の新規のインストール時および新規のセットアップ時に「1」が設定されます。

(3)　JP1/AJS2で設定する子プロセスのシグナル

表16-32　JP1/AJS2で設定する子プロセスのシグナル

シグナル名 | プロセス生成時の設定 | 動作
SIGHUP | SIG_DFL（デフォルト） | A
SIGINT | SIG_DFL（デフォルト） | A
SIGQUIT | SIG_DFL（デフォルト） | A
SIGILL | SIG_DFL（デフォルト） | A
SIGTRAP | SIG_DFL（デフォルト） | C，G
SIGIOT | SIG_DFL（デフォルト） | C，G
SIGEMT | SIG_DFL（デフォルト） | G
SIGFPE | SIG_DFL（デフォルト） | C
SIGBUS | SIG_DFL（デフォルト） | A，G
SIGSEGV | SIG_DFL（デフォルト） | C
SIGSYS | SIG_DFL（デフォルト） | G
SIGPIPE | SIG_DFL（デフォルト） | A
SIGALRM | SIG_DFL（デフォルト） | A
SIGTERM | SIG_DFL（デフォルト） | A
SIGUSR1 | SIG_DFL（デフォルト） | A
SIGUSR2 | SIG_DFL（デフォルト） | A
SIGCHLD | SIG_DFL（デフォルト）※1 | B
SIG_IGN（無視）※2 | H
SIGPWR | SIG_DFL（デフォルト） | A，G
SIGVTALRM | SIG_DFL（デフォルト） | A，G
SIGPROF | SIG_DFL（デフォルト） | A，G
SIGIO | SIG_DFL（デフォルト） | A，G
SIGWINCH | SIG_DFL（デフォルト） | B，G
SIGTSTP | SIG_DFL（デフォルト） | D
SIGCONT | SIG_DFL（デフォルト） | I
SIGTTIN | SIG_DFL（デフォルト） | D
SIGTTOU | SIG_DFL（デフォルト） | D
SIGURG | SIG_DFL（デフォルト） | BG
SIGLOST | SIG_DFL（デフォルト） | AG

（凡例）

A：デフォルトの動作は，プロセスの終了（terminate the process）

B：デフォルトの動作は，このシグナルの無視（ignore the signal）

C：デフォルトの動作は，コアダンプ（dump core）

D：デフォルトの動作は，プロセスのストップ（stop the process）

E：キャッチできないシグナル

F：無視できないシグナル

G：POSIX.1に準拠しないシグナル

H：無視

I：デフォルトの動作は，プロセスのストップからの再開（restart the process）

注※1

JP1/AJS2 08-00以降のバージョンを新規インストールした場合はSIG_DFL（デフォルト）が設定されます。

注※2

JP1/AJS2 07-50以前からJP1/AJS2 08-00以降へバージョンアップインストールした場合は，SIG_IGN（無視）が設定されます。

16.27　サブミットジョブの実行順序の入れ替わりを防止する設定

サブミットジョブの実行順序の入れ替わりを防止するための設定方法について説明します。

＜この節の構成＞

(1)　定義手順

(2)　定義パラメーター一覧

(3)　定義内容

(1)　定義手順

JP1/AJS2のサービスを停止する。
次のコマンドを実行して，プロセスがすべて停止していることを確認します。

# /opt/jp1ajs2/bin/jajs_spmd_status

viなどのエディターで，「(2) 定義パラメーター一覧」の定義パラメーターを記述した設定ファイルを作成する。
設定ファイルのファイル名は任意です。

ファイルを保存し，次のコマンドを実行する。

jbssetcnf 設定ファイル名

jbssetcnfコマンドのパスは，「/opt/jp1base/bin/jbssetcnf」です。
jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/AJS2を再起動する。
設定ファイルに記述した内容が反映されます。

(2)　定義パラメーター一覧

表16-33　サブミットジョブの実行順序の入れ替わりを防止する設定の定義パラメーター

定義キー | 環境設定パラメーター | 定義内容
[{JP1_DEFAULT|論理ホスト名}¥JP1NBQMANAGER¥Job]※ | "PreventChangeJobOrder"= | サブミットジョブの実行順序の入れ替わりを防止する設定

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定してください。

(3)　定義内容

"PreventChangeJobOrder"=dword: 00000000|00000001

サブミットジョブの実行順序の入れ替わりを防止するかを指定します。

0

サブミットジョブの実行順序の入れ替わりを防止しない場合に指定します。

1

サブミットジョブの実行順序の入れ替わりを防止する場合に指定します。

デフォルトは「0」です。

注意事項

サブミットジョブの実行順序の入れ替わりを防止するためにPreventChangeJobOrderに「1」を設定した場合に，ジョブを配信する処理が変更されますが，次の設定が行われていないと実行順序の入れ替わりを防止できません。

ジョブをサブミットしたキューに接続されているエージェント数は一つである。

エージェントのジョブ実行多重度が1に設定されている。

また，ジョブの実行順序を制御するために，ジョブ実行性能が数パーセントほど低下するおそれがあります。

16.28　ジョブ情報列挙時にジョブ実行制御マネージャー（jpqman）のメモリー消費量を少なくする設定

ジョブ実行マネージャー（jpqman）では，ジョブ情報列挙時に，列挙数に応じてメモリーを消費しているため，列挙数が増加すると統合トレースログにKAVU4280-Eのメッセージを出力して次の関数またはコマンドが失敗する場合があります。この場合，ジョブ情報列挙時にジョブ実行制御マネージャーのメモリー消費量を少なくする設定を行うことで回避できる場合があります。

jpqjobshowコマンド

jpqendjobshowコマンド

JpqOpenEnumJob関数※

JpqOpenEndEnumJob関数※

注※

関数機能を使用できるのは，Version 7i以前の環境でプログラムを作成している場合です。詳細については，マニュアル「JP1/Automatic Job Management System 2 設計・運用ガイド　9.10 関数機能を使用している場合の注意事項」を参照してください。

ジョブ情報列挙時にジョブ実行制御マネージャーのメモリー消費量を少なくするための設定手順を次に示します。

＜この節の構成＞

(1)　定義手順

(2)　定義パラメーター一覧

(3)　定義内容

(1)　定義手順

JP1/AJS2のサービスを停止する。
次のコマンドを実行して，プロセスがすべて停止していることを確認します。

# /opt/jp1ajs2/bin/jajs_spmd_status

viなどのエディターで，「(2) 定義パラメーター一覧」の定義パラメーターを記述した設定ファイルを作成する。
設定ファイルのファイル名は任意です。

ファイルを保存し，次のコマンドを実行する。

jbssetcnf 設定ファイル名

jbssetcnfコマンドのパスは，「/opt/jp1base/bin/jbssetcnf」です。
jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/AJS2を再起動する。
設定ファイルに記述した内容が反映されます。

(2)　定義パラメーター一覧

表16-34　ジョブ情報列挙時にジョブ実行制御マネージャーのメモリー消費量を少なくする設定の定義パラメーター

定義キー | 環境設定パラメーター | 定義内容
[{JP1_DEFAULT|論理ホスト名}¥JP1NBQMANAGER¥Job]※ | "EnumJobSaveMemory"= | ジョブ情報列挙時にジョブ実行制御マネージャーのメモリー消費量を少なくする設定

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定してください。

(3)　定義内容

"EnumJobSaveMemory"=dword: 00000000|00000001

ジョブ情報列挙時にジョブ実行制御マネージャーのメモリー消費量を少なくするかを指定します。

0

ジョブ情報列挙時に，ジョブ実行制御マネージャーが列挙数に応じてメモリーを消費する場合に指定します。

1

ジョブ情報列挙時に，ジョブ実行制御マネージャーのメモリー消費量を少なくする場合に指定します。

デフォルトは「0」です。

注意事項

ジョブ情報列挙時のメモリー消費量の見積もりは，次のとおりです。

0を設定した場合
メモリー消費量は，ジョブ1件当たり最大で約100キロバイトです。

1を設定した場合
メモリー消費量は，ジョブの列挙数にかかわらず，最大で約60メガバイトです。

16.29　ジョブ実行制御のマネージャープロセスに対する通信タイムアウト時間の変更

ジョブ実行制御のマネージャープロセスに対して次の要求をする際，要求する側は通信タイムアウト時間（デフォルト10分）を設定してマネージャープロセスと通信します。

ジョブネット（スケジューラー）によるジョブの登録，キャンセル，およびジョブの状態確認

ジョブの実行に使用するコマンド（jpqxxxxコマンド）によるジョブの操作

ジョブの実行に使用する関数（Jpqxxxx関数）によるジョブの操作

ジョブ実行制御のマネージャープロセスとの通信処理で時間が掛かり，通信タイムアウトが発生すると，ジョブの実行やコマンド要求が失敗します。

通信タイムアウトが発生する要因には，主に次のものがあります。

実行したジョブの転送ファイルや結果ファイルのファイルサイズが大きい

jpqendjobshowコマンド（終了ジョブ情報を列挙するコマンド）で列挙するジョブ数が多い
jpqendjobshowコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 2 コマンドリファレンス　1. コマンド　jpqendjobshow」を参照してください。

jpqjobshowコマンド（未終了ジョブ情報を列挙するコマンド）で列挙するジョブ数が多い
jpqjobshowコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 2 コマンドリファレンス　1. コマンド　jpqjobshow」を参照してください。

ジョブネット（スケジューラー）によるジョブの登録，キャンセル，およびジョブの状態確認の際に通信タイムアウトが発生すると，ジョブ※が異常終了します。この場合，統合トレースログには，次のメッセージが出力されます。

注※

イベントジョブおよびジョブの実行先サービスに［JP1/AJS2 Queueless Agent］を指定した場合を除きます。

KAVU0220-E マネージャーからの応答が返ってきません

jpqxxxxコマンドで通信タイムアウトが発生すると，標準エラー出力に次のメッセージが出力されます。

KAVU0953-E マネージャーからの応答が返ってきません

通信タイムアウトによるコマンド要求やジョブの実行失敗は，通信タイムアウト時間を長く設定することで回避できることがあります。ジョブネット（スケジューラー）によるジョブの登録，キャンセル，またはジョブの状態確認の際に通信タイムアウトを回避するには，ジョブを登録するマネージャーホストで通信タイムアウト時間を長く設定してください。また，ジョブの実行に使用するコマンドや関数の場合は，コマンドや関数を実行するクライアントホストで通信タイムアウト時間を長く設定してください。

通信タイムアウト時間を変更する設定方法について説明します。

＜この節の構成＞

(1)　定義手順

(2)　定義パラメーター一覧

(3)　定義内容

(4)　注意事項

(1)　定義手順

JP1/AJS2のサービスを停止する。
次のコマンドを実行して，プロセスがすべて停止していることを確認します。

# /opt/jp1ajs2/bin/jajs_spmd_status

viなどのテキストエディターで，「(2) 定義パラメーター一覧」の定義パラメーターを記述した設定ファイルを作成する。
設定ファイルのファイル名は任意です。

ファイルを保存し，次のコマンドを実行する。

jbssetcnf 設定ファイル名

jbssetcnfコマンドのパスは，「/opt/jp1base/bin/jbssetcnf」です。
jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/AJS2を再起動する。
設定ファイルに記述した内容が反映されます。

(2)　定義パラメーター一覧

表16-35　ジョブ実行制御のマネージャープロセスに対する通信タイムアウト時間の設定の定義パラメーター

定義キー | 環境設定パラメーター | 定義内容
[{JP1_DEFAULT|論理ホスト名}¥JP1NBQCLIENT¥Network]※ | "CommunicateTimeout"= | ジョブ実行制御のマネージャープロセスに対する通信タイムアウト時間（単位：ミリ秒）

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定します。

(3)　定義内容

"CommunicateTimeout"=dword:設定値

通信タイムアウト時間を16進数で指定します（単位：ミリ秒）。

指定できる範囲は000927c0～0036EE80（10進数で600000～3600000）です。

デフォルトは「000927c0（10進数で600000（10分））」です。

(4)　注意事項

通信タイムアウト時間を長く設定すると，通信処理中にコマンドやジョブに異常が発生した場合の障害検知までの時間も長くなります。そのため，後続ジョブの実行の遅延などが発生しやすくなります。通信タイムアウト時間を変更する場合は，設定値を十分に検証した上で設定してください。

16.30　JP1/AJS2のサービスが停止してもイベントジョブの実行を継続させる設定

イベントジョブについては，イベントジョブ実行継続オプションを使用することによって，JP1/AJS2のサービスが停止しても，そのとき実行中だったものは再起動後もそのまま状態を引き継ぎ，実行を継続できます。

ここでは，イベントジョブ実行継続オプションを有効にする手順について説明します。機能の詳細については，マニュアル「JP1/Automatic Job Management System 2 設計・運用ガイド　8.5.8 JP1/AJS2のサービスが停止してもイベントジョブの実行を継続させる」を参照してください。

＜この節の構成＞

(1)　定義手順

(2)　定義パラメーター一覧

(3)　定義内容

(1)　定義手順

JP1/AJS2のサービスを停止する。
次のコマンドを実行して，プロセスがすべて停止していることを確認します。

# /etc/opt/jp1ajs2/jajs_stop※
# /opt/jp1ajs2/bin/jajs_spmd_status

注※　自動停止の設定がされていることを確認します。

viなどのエディターで，「(2) 定義パラメーター一覧」の定義パラメーターを記述した設定ファイルを作成する。
設定ファイルのファイル名は任意です。

ファイルを保存し，次のコマンドを実行する。

jbssetcnf 設定ファイル名

jbssetcnfコマンドのパスは，「/opt/jp1base/bin/jbssetcnf」です。
jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/AJS2を再起動する。
設定ファイルに記述した内容が反映されます。

(2)　定義パラメーター一覧

表16-36　JP1/AJS2のサービスが停止してもイベントジョブの実行を継続させる設定の定義パラメーター

定義キー | 環境設定パラメーター | 定義内容
[{JP1_DEFAULT|論理ホスト名}¥JP1AOMMANAGER]※ | "EvJobExecContinue"= | イベントジョブ実行継続オプション

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定してください。

(3)　定義内容

"EvJobExecContinue"="{Y|N}"

実行ホストのJP1/AJS2のサービスを再起動したときに，イベントジョブの実行を継続するかどうかを指定します。

Y

イベントジョブの実行を継続します。

N

イベントジョブの実行を終了します。

デフォルトは「N」です。

注意事項

JP1/AJS2 - Managerが08-50より前のバージョンの場合，イベントジョブ実行継続オプションを使用できません。

イベントジョブ実行継続オプションは，物理・論理ホストのマネージャー単位で設定してください。

16.31　イベント・アクション制御エージェント起動通知の送信に失敗した場合に再送を行う設定

イベントジョブや起動条件付きジョブネットを実行登録すると，実行ホストのJP1/AJS2は実行元のマネージャーホスト名を記憶し，自身が起動した際にその旨をイベント・アクション制御マネージャーに通知します。この通知をイベント・アクション制御エージェント起動通知と呼びます（以降，この章では起動通知と表記します）。

エージェントから起動通知を受けたマネージャーは，そのエージェントで実行中のイベントジョブ（起動条件付きジョブネットを含む）の実行状態について，マネージャー・エージェント間での整合を取る通信を行います。

エージェントが起動通知の送信に失敗した場合，マネージャー・エージェント間の通信が行われないため，マネージャー・エージェント間でイベントジョブ（起動条件付きジョブネット含む）の実行状態が一致しなくなることがあります。この場合，JP1/AJS2 - Viewで起動条件付きジョブネットの状態が監視中と表示されても，実際にはエージェントでは監視が行われていない状態になります。そのため，監視対象のイベントが発生してもイベントは検知されず，マネージャー側でイベントジョブが終了しないことや，起動条件付きジョブネットが起動しないことがあります。

イベントジョブや起動条件付きジョブネットを実行したまま，次のような状況でエージェントホストのJP1/AJS2サービスを再起動する運用を行う場合は，「(1) 定義手順」に従って，あらかじめ環境設定パラメーターを設定してください。

エージェントがJP1/AJS2以外のプログラムによってシステム全体が高負荷な状況で，エージェントホストのJP1/AJS2サービスを再起動する

ネットワークで一時的な通信障害が発生している状況で，エージェントホストのJP1/AJS2サービスを再起動する

なお，エージェントが記憶しているマネージャーホスト名はjpoagoecコマンドで確認できます。使用しない不要なマネージャーホストがある場合は，同コマンドで削除してから，環境設定パラメーターを設定してください。jpoagoecコマンドについては，マニュアル「JP1/Automatic Job Management System 2 コマンドリファレンス　1. コマンド　jpoagoec」を参照してください。

注意事項

エージェントが不要なマネージャーホストを記憶している状態で環境設定パラメーターを設定し，エージェントのJP1/AJS2サービスを起動すると，不要なマネージャーに対しても起動通知の送信に失敗した場合に通知を再送するようになるため，ほかのマネージャーから実行されたイベントジョブや起動条件付きジョブネットの開始が遅れたり，イベントの検知が遅れたりすることがあります。

＜この節の構成＞

(1)　定義手順

(2)　定義パラメーター

(3)　定義内容

(1)　定義手順

JP1/AJS2のサービスを停止する。
次のコマンドを実行して，プロセスがすべて停止していることを確認します。

# /etc/opt/jp1ajs2/jajs_stop※
# /opt/jp1ajs2/bin/jajs_spmd_status

注※　自動停止の設定がされていることを確認します。

viなどのエディターで，「(2) 定義パラメーター一覧」の定義パラメーターを記述した設定ファイルを作成する。
設定ファイルのファイル名は任意です。

ファイルを保存し，次のコマンドを実行する。

jbssetcnf 設定ファイル名

jbssetcnfコマンドのパスは，「/opt/jp1base/bin/jbssetcnf」です。
jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/AJS2を再起動する。
設定ファイルに記述した内容が反映されます。

(2)　定義パラメーター

表16-37　イベント・アクション制御エージェント起動通知の送信に失敗した場合に再送を行う設定の定義パラメーター

定義キー | 環境設定パラメーター | 定義内容
[{JP1_DEFAULT|論理ホスト名}¥JP1AOMAGENT]※ | "RetryAgtStartNotification"= | 起動通知の送信に失敗した場合に起動通知の再送を行うための定義

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定してください。

(3)　定義内容

"RetryAgtStartNotification"="{Y|N}"

起動通知を再送するかどうかを指定します。

Y

起動通知の送信に失敗した場合，起動通知を再送します。

N

起動通知の送信に失敗した場合でも，起動通知を再送しません。

デフォルトは「N」です。

16.32　ジョブ実行時のファイル権限チェックでアクセス制御リストやセカンダリーグループの設定を有効にする

ジョブ実行時のファイルのアクセス権限チェックで，ファイルパーミッションだけでなくアクセス制御リストやセカンダリーグループの設定も有効にする場合の設定手順について次に示します。

この設定は，エージェントホスト単位に行ってください。なお，この設定はUNIXジョブに対してだけ有効になります。

注意事項

エージェントホストのJP1/AJS2 - Agent（またはJP1/AJS2 - Manager）のバージョンが08-10以前の場合は設定できません。

＜この節の構成＞

(1)　定義手順

(2)　定義パラメーター

(3)　定義内容

(1)　定義手順

JP1/AJS2のサービスを停止する。
次のコマンドを実行して，プロセスがすべて停止していることを確認します。

# /etc/opt/jp1ajs2/jajs_stop※
# /opt/jp1ajs2/bin/jajs_spmd_status

注※　自動停止の設定がされていることを確認します。

viなどのエディターで，「(2) 定義パラメーター一覧」の定義パラメーターを記述した設定ファイルを作成する。
設定ファイルのファイル名は任意です。

ファイルを保存し，次のコマンドを実行する。

jbssetcnf 設定ファイル名

jbssetcnfコマンドのパスは，「/opt/jp1base/bin/jbssetcnf」です。
jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/AJS2を再起動する。
設定ファイルに記述した内容が反映されます。

(2)　定義パラメーター

表16-38　ジョブ実行時のファイルのアクセス権限をチェックする方法を設定する定義パラメーター

定義キー | 環境設定パラメーター | 定義内容
[{JP1_DEFAULT|論理ホスト名}¥JP1NBQAGENT¥Job]※ | "FileAccessPermissionMode"= | UNIXジョブ実行時のファイルのアクセス権限をチェックする方法の設定

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定してください。

(3)　定義内容

"FileAccessPermissionMode"=dword:設定値

UNIXジョブ実行時の，次に示すファイルのアクセス権限についてチェックする方法を指定します。

スクリプトファイル

環境変数ファイル

標準入力ファイル

標準出力ファイル

標準エラー出力ファイル

転送先ファイル

0

各ファイルのアクセス権限について，ファイルパーミッションの設定に基づいてチェックします。アクセス制御リストやセカンダリーグループの設定に基づくチェックは行いません。

1

スクリプトファイルのアクセス権限について，ファイルパーミッション，アクセス制御リスト，およびセカンダリーグループの設定に基づいてチェックします。

スクリプトファイル以外のファイルのアクセス権限については，ファイルパーミッションに基づくチェックだけ行います。

2

各ファイルのアクセス権限について，ファイルパーミッション，アクセス制御リスト，およびセカンダリーグループの設定に基づいてチェックします。

デフォルトは「0」です。

注意事項

FileAccessPermissionModeを1または2に変更する場合，デフォルトではアクセス制御リストやセカンダリーグループが設定されていても実行できていたジョブが起動失敗となることがあります。ファイルパーミッションと，アクセス制御リストやセカンダリーグループの設定との差異を考慮した上，ジョブの起動に影響がないように注意して設定してください。

16.33　エージェントホスト名の名前解決オプションの設定

hostsファイルやDNSが正しく設定されていないなど，マネージャーホスト上でエージェントホスト名の名前解決ができない場合があります。その状態でマネージャーやエージェントのJP1/AJS2サービスを起動または停止すると，次の現象が発生することがあります。

実行登録したイベントジョブが「実行中」状態になるまでに長い時間が掛かる。

イベントジョブまたは起動条件で監視しているイベントの検知が遅れる。

イベントジョブまたは起動条件付きジョブネットに対して強制終了などの操作をしても，ジョブの状態が変わるまでに長い時間が掛かる。

マネージャーのJP1/AJS2サービスの停止に長い時間が掛かる。

マネージャーのJP1/AJS2サービスの起動に長い時間が掛かる。

上記の現象を回避したい場合は，エージェントホスト名の名前解決オプションを設定してください。

なお，すべてのエージェントホスト名の名前解決ができる環境では，このオプションを設定する必要はありません。

オプションを有効にする設定方法について次に説明します。

＜この節の構成＞

(1)　定義手順

(2)　定義パラメーター一覧

(3)　定義内容

(1)　定義手順

JP1/AJS2のサービスを停止する。
次のコマンドを実行して，プロセスがすべて停止していることを確認します。

# /etc/opt/jp1ajs2/jajs_stop※
# /opt/jp1ajs2/bin/jajs_spmd_status

注※

自動停止の設定がされていることを確認してください。

viなどのエディターで，「(2) 定義パラメーター一覧」の定義パラメーターを記述した設定ファイルを作成する。
設定ファイルのファイル名は任意です。

ファイルを保存し，次のコマンドを実行する。

jbssetcnf 設定ファイル名

jbssetcnfコマンドのパスは，「/opt/jp1base/bin/jbssetcnf」です。
jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/AJS2を再起動する。
設定ファイルに記述した内容が反映されます。

(2)　定義パラメーター一覧

表16-39　エージェントホストの名前解決オプション設定の定義パラメーター一覧

定義キー | 環境設定パラメーター | 定義内容
[JP1_DEFAULT¥JP1AOMMANAGER]※ | "_AgentStartStopResolveMode"= | エージェントホストの名前解決オプション

注※

このパラメーターの設定は，物理ホストおよびすべての論理ホストに対して有効です。

(3)　定義内容

"_AgentStartStopResolveMode"="{optimized|normal}"

エージェントホストの名前解決処理を最適化するかどうかを指定します。

optimized

エージェントホスト名の名前解決処理を最適化する場合に指定します。ただし，名前解決できるのは，イベントジョブや起動条件付きジョブネットを実行しているエージェントホストだけです。

normal

エージェントホスト名の名前解決処理を最適化しない場合に指定します。

デフォルトは「normal」です。

16.34　イベント・アクション制御のプロセス間通信でのデータ到着待ちタイムアウト化オプションの設定

ネットワークへの高負荷または回線不良などによって，イベント・アクション制御のプロセス間通信が正常にできない場合，次のような現象が発生することがあります。

ジョブの実行登録や強制終了などの操作を実行しても状態が変わらない。

ジョブネットがスケジュールで指定した時刻になっても開始されない。

イベントジョブまたは起動条件で監視しているイベントが検知されない。

ajsstopコマンドを実行してもスケジューラーサービスが停止しない。

JP1/AJS2サービスの停止に長い時間が掛かる。

上記の現象を回避したい場合は，イベント・アクション制御のプロセス間通信でのデータ到着待ちタイムアウト化オプションを設定してください。

オプションを有効にする設定方法について次に説明します。

＜この節の構成＞

(1)　定義手順

(2)　定義パラメーター一覧

(3)　定義内容

(1)　定義手順

JP1/AJS2のサービスを停止する。
次のコマンドを実行して，プロセスがすべて停止していることを確認します。

# /etc/opt/jp1ajs2/jajs_stop※
# /opt/jp1ajs2/bin/jajs_spmd_status

注※

自動停止の設定がされていることを確認してください。

viなどのエディターで，「(2) 定義パラメーター一覧」の定義パラメーターを記述した設定ファイルを作成する。
設定ファイルのファイル名は任意です。

ファイルを保存し，次のコマンドを実行する。

jbssetcnf 設定ファイル名

jbssetcnfコマンドのパスは，「/opt/jp1base/bin/jbssetcnf」です。
jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/AJS2を再起動する。
設定ファイルに記述した内容が反映されます。

(2)　定義パラメーター一覧

表16-40　データの到着待ちタイムアウト化オプション設定の定義パラメーター一覧

定義キー | 環境設定パラメーター | 定義内容
[JP1_DEFAULT¥JP1AOMAGENT]※ | "RecvTimeout"= | イベントジョブのソケット通信時のデータ到着待ちタイムアウト化オプション

注※

このパラメーターの設定は，物理ホストおよびすべての論理ホストに対して有効です。

(3)　定義内容

"RecvTimeout"="{Y|N}"

イベント・アクション制御のプロセス間通信で，通信データが何らかの理由によって受信側に到着しない場合に，データの到着待ちを打ち切ってほかの処理を行えるようにするかどうかを指定します。

通信環境が不安定な場合などに指定しますが，通常は指定する必要はありません。

Y

データが一定時間到着しない場合にデータ受信処理をタイムアウトさせます。

N

データの到着まで待機します。

デフォルトは「N」です。

16.35　イベントジョブを実行する場合のマネージャーホスト名を固定化する設定

イベントジョブを実行すると，マネージャーはイベントジョブの実行先のエージェントと通信します。その通信では，マネージャーはエージェントが複数のマネージャーを区別できるように，マネージャーホスト名を送信します。マネージャーホスト名は，マネージャーのJP1/AJS2サービスを起動した際に取得しています。

通常は，意図してホスト名を変更しないかぎり，マネージャーのJP1/AJS2サービスの再起動前と再起動後で，取得したホスト名が変わることはありません。しかし，DNSなどの名前解決に関するOSの設定を変更した場合など，何らかの要因によって，JP1/AJS2サービスの再起動前と再起動後で，取得したホスト名で使用されている英文字が，大文字から小文字または小文字から大文字に変わることがあります。

イベントジョブの実行先のエージェントは，マネージャーホスト名の英文字の大文字と小文字を区別するため，ホスト名の英文字が大文字から小文字，または小文字から大文字に変わると，結果としてマネージャーホスト名が変わることになり，次の問題が発生することがあります。

起動条件付きジョブネットを実行したままマネージャーのJP1/AJS2サービスを再起動すると，その後に発生した監視対象のイベントを重複して検知する。

イベントジョブ実行継続オプションを有効にしている状態で，イベントジョブを実行したままマネージャーのJP1/AJS2サービスをホットスタートで再起動すると，一つのイベントに対して不当に複数回イベントを検知する。
イベントジョブ実行継続オプションについては，「16.30 JP1/AJS2のサービスが停止してもイベントジョブの実行を継続させる設定」を参照してください。

この問題を回避するには，マネージャーホスト名固定化オプション（環境設定パラメーターFixedHostnameForAgent）を有効に設定してください。マネージャーホスト名固定化オプションを有効に設定すると，イベント・アクション制御マネージャーは常に小文字のホスト名を送信するようになります。

注意事項

起動条件付きジョブネットを実行中，またはイベントジョブ実行継続オプションを有効にしている状態でイベントジョブを実行したまま，マネージャーホスト名固定化オプションを変更した場合，マネージャーホスト名の英文字が大文字から小文字，または小文字から大文字に変化することになります。

すでに実行されている起動条件付きジョブネット，またはイベントジョブのジョブの管理状態に不整合が発生し，一つのイベントに対してジョブネットが不当に複数回起動することがあります。

そのような現象を回避するため，マネージャーホスト名固定化オプションを設定，または変更する場合，次の手順のとおり実施してください。

起動条件付きジョブネット，またはイベントジョブを実行しているエージェントホストのJP1/AJS2サービスを停止する。

手順1のエージェントホストでjpoagoecコマンドを実行し，マネージャーホスト名固定化オプションを有効にするマネージャーホスト名を削除する。jpoagoecコマンドについては，マニュアル「JP1/Automatic Job Management System 2 コマンドリファレンス　1. コマンド　jpoagoec」を参照してください。

マネージャーホストで，マネージャーホスト名固定化オプションを設定する。
設定方法については，「(1) 定義手順」を参照してください。

手順2のエージェントホストのJP1/AJS2サービスをコールドスタートで起動する。

オプションを有効にする設定方法について次に説明します。

＜この節の構成＞

(1)　定義手順

(2)　定義パラメーター一覧

(3)　定義内容

(1)　定義手順

JP1/AJS2のサービスを停止する。
次のコマンドを実行して，プロセスがすべて停止していることを確認します。

# /etc/opt/jp1ajs2/jajs_stop※
# /opt/jp1ajs2/bin/jajs_spmd_status

注※

自動停止の設定がされていることを確認してください。

viなどのエディターで，「(2) 定義パラメーター一覧」の定義パラメーターを記述した設定ファイルを作成する。
設定ファイルのファイル名は任意です。

ファイルを保存し，次のコマンドを実行する。

jbssetcnf 設定ファイル名

jbssetcnfコマンドのパスは，「/opt/jp1base/bin/jbssetcnf」です。
jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/AJS2を再起動する。
設定ファイルに記述した内容が反映されます。

(2)　定義パラメーター一覧

表16-41　マネージャーホスト名固定化オプション設定の環境設定パラメーター

定義キー | 環境設定パラメーター | 定義内容
[{JP1_DEFAULT|論理ホスト名}¥JP1AOMMANAGER]※ | "FixedHostnameForAgent"= | マネージャーホスト名固定化オプション

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定してください。

(3)　定義内容

"FixedHostnameForAgent"="{Y|N}"

イベント・アクション制御のプロセス間通信で，マネージャーホスト名を常に小文字で使用するかどうかを指定します。

Y

マネージャーホスト上で求まるホスト名をすべて小文字に変換したものが，イベント・アクション制御の通信に使用されます。

N

マネージャーホスト上で求まるホスト名を変換しないで，イベント・アクション制御の通信に使用されます。

デフォルトは「N」です。

16.36　エージェント自動定義機能で作成されるキュー属性値をカスタマイズする設定

エージェント自動定義機能で作成されるエージェントの属性値を，あらかじめ構成定義情報でカスタマイズできます。この設定は，エージェント自動定義機能を使用して作成されるすべてのエージェントの属性値に対して有効です。

エージェント自動定義機能で作成されるエージェントの属性値をあらかじめ構成定義情報でカスタマイズするには，構成定義ファイルを作成します。エージェント自動定義機能で作成されるエージェントの属性値をあらかじめ構成定義情報でカスタマイズする手順を次に示します。

＜この節の構成＞

(1)　定義手順

(2)　定義パラメーター一覧

(3)　定義内容

(1)　定義手順

JP1/AJS2のサービスを停止する。
次のコマンドを実行して，プロセスがすべて停止していることを確認します。

# /etc/opt/jp1ajs2/jajs_stop※
# /opt/jp1ajs2/bin/jajs_spmd_status

注※

自動停止の設定がされていることを確認してください。

viなどのエディターで，「(2) 定義パラメーター一覧」の定義パラメーターを記述した構成定義ファイルを作成する。
構成定義ファイルのファイル名は任意です。

ファイルを保存し，次のコマンドを実行する。

jbssetcnf 設定ファイル名

jbssetcnfコマンドのパスは，「/opt/jp1base/bin/jbssetcnf」です。
jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/AJS2のサービスを再起動する。
構成定義ファイルに記述した内容が反映されます。

(2)　定義パラメーター一覧

表16-42　エージェント自動定義時のキュー属性値カスタマイズ定義パラメーター一覧

定義キー | 環境設定パラメーター | 定義内容
[{JP1_DEFAULT|論理ホスト名}¥JP1NBQMANAGER¥Agent]※ | "AutoCreateExecJobs"= | エージェント自動定義時のジョブの実行多重度
"AutoCreateMaxJobs"= | エージェント自動定義時のジョブ数の最大値
"AutoCreateWarnJobs"= | エージェント自動定義時のジョブ数の警告値
"AutoCreatePriority"= | エージェント自動定義時のエージェント優先順位

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定してください。

(3)　定義内容

"AutoCreateExecJobs"=dword:エージェント自動定義時のジョブの実行多重度

エージェント自動定義時に作成されるエージェントのジョブ実行多重度を16進数で指定します。

指定できる範囲は00000001～00000400（10進数で1～1,024）です。

デフォルトは「dword:00000005」（10進数で5）です。

ここで指定した多重度は24時間共通の設定です。30分単位で設定したい場合は，jpqagtaltコマンドを使用して変更してください。

"AutoCreateMaxJobs"=dword:エージェント自動定義時のジョブ数の最大値

エージェント自動定義時に作成されるデフォルトキューのジョブの最大数を16進数で指定します。

指定できる範囲は00000001～FFFFFFFF（10進数で1～4,294,967,295）です。

デフォルトは「dword:00000064」（10進数で100）です。

"AutoCreateWarnJobs"=dword:エージェント自動定義時のジョブ数の警告値

エージェント自動定義時に作成されるデフォルトキューのジョブの警告数を16進数で指定します。

指定できる範囲は00000001～FFFFFFFF（10進数で1～4,294,967,295）です。

デフォルトは「dword:00000050」（10進数で80）です。

"AutoCreatePriority"=dword:エージェント自動定義時のエージェント優先順位

エージェント自動定義時に作成されるデフォルトキューのエージェント優先順位を16進数で指定します。

指定できる範囲は00000001～00000010（10進数で1～16）です。

デフォルトは「dword:00000001」（10進数で1）です。

16.37　ユーザー情報取得時のリトライを変更する設定

JP1/AJS2では，ジョブ※開始時または終了時に，ジョブ実行OSユーザーの情報を取得します。OSユーザーの追加，削除，またはOSユーザーのパスワードの変更などによって一時的にOSのパスワードファイルからユーザー情報が参照できないと，統合トレースログにKAVU7533-Eメッセージ（キューレスジョブの場合はKAVS1888-Eメッセージ，またはKAVS1884-Eメッセージ）が出力されて，ジョブが起動失敗または異常検出終了となります。

OSのパスワードファイルの参照を一定の間隔でリトライすることで，ジョブの起動失敗や異常検出終了となることを防ぐことができます。

通常，この値は変更する必要はありません。

注※

UNIXジョブ，アクションジョブ，カスタムジョブ，およびJP1/AJS2上で実行するQUEUEジョブが該当します。jpqjobsubコマンドで実行するサブミットジョブも含まれます。

設定手順を次に示します。この設定はジョブの実行先ホスト上で行ってください。

＜この節の構成＞

(1)　定義手順

(2)　定義パラメーター一覧

(3)　定義内容

(4)　注意事項

(1)　定義手順

JP1/AJS2のサービスを停止する。
次のコマンドを実行して，プロセスがすべて停止していることを確認します。

ジョブの実行先サービスに［JP1/AJS2］を指定している場合
# /etc/opt/jp1ajs2/jajs_stop※
# /opt/jp1ajs2/bin/jajs_spmd_status

注※

自動停止の設定がされていることを確認してください。

ジョブの実行先サービスに［JP1/AJS2 Queueless Agent］を指定している場合
# /opt/jp1ajs2/bin/ajsqlstop
# /opt/jp1ajs2/bin/ajsqlftpstop※
# /opt/jp1ajs2/bin/ajsqlstatus

注※

JP1/AJS2 - Managerだけ実行する必要があります。

viなどのエディターで，「(2) 定義パラメーター一覧」の定義パラメーターを記述した設定ファイルを作成する。
設定ファイルのファイル名は任意です。

ファイルを保存し，次のコマンドを実行する。

jbssetcnf 設定ファイル名

jbssetcnfコマンドのパスは，「/opt/jp1base/bin/jbssetcnf」です。
jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

JP1/AJS2を再起動する。
設定ファイルに記述した内容が反映されます。

(2)　定義パラメーター一覧

表16-43　エージェントホストのユーザー情報取得時のリトライを変更する設定のための定義パラメーター一覧

定義キー | 環境設定パラメーター | 定義内容
[{JP1_DEFAULT|論理ホスト名}¥JP1NBQAGENT¥Job]※ | "GetPasswd_RetryCount "= | ジョブの実行先サービスに［JP1/AJS2］を指定している場合に，OSのパスワードファイルからユーザー情報の取得に失敗した場合にリトライする回数
"GetPasswd_RetryInterval"= | ジョブの実行先サービスに［JP1/AJS2］を指定している場合に，OSのパスワードファイルからユーザー情報の取得に失敗した場合にリトライする間隔
[JP1_DEFAULT|論理ホスト名¥JP1QLAGENT]※ | "AJSQL_GETPASSWD_AGTRETRYCOUNT"= | ジョブの実行先サービスに［JP1/AJS2 Queueless Agent］を指定している場合に，キューレスエージェントサービスでOSのパスワードファイルからユーザー情報の取得に失敗した場合にリトライする回数
"AJSQL_GETPASSWD_AGTRETRYINTERVAL"= | ジョブの実行先サービスに［JP1/AJS2 Queueless Agent］を指定している場合に，キューレスエージェントサービスでOSのパスワードファイルからユーザー情報の取得に失敗した場合にリトライする間隔

注※

{JP1_DEFAULT|論理ホスト名}の部分は，物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は「論理ホスト名」を指定してください。

表16-44　マネージャーホストのユーザー情報取得時のリトライを変更する設定のための定義パラメーター

定義キー | 環境設定パラメーター | 定義内容
[JP1_DEFAULT¥JP1QLAGENT] | "AJSQL_GETPASSWD_FTPRETRYCOUNT"= | ジョブの実行先サービスに［JP1/AJS2 Queueless Agent］を指定している場合に，キューレスファイル転送サービスで，OSのパスワードファイルからユーザー情報の取得に失敗した場合にリトライする回数
"AJSQL_GETPASSWD_FTPRETRYINTERVAL"= | ジョブの実行先サービスに［JP1/AJS2 Queueless Agent］を指定している場合に，キューレスファイル転送サービスで，OSのパスワードファイルからユーザー情報の取得に失敗した場合にリトライする間隔

(3)　定義内容

"GetPasswd_RetryCount"= dword:リトライ回数

ジョブの実行先サービスに［JP1/AJS2］を指定している場合に，OSのパスワードファイルからユーザー情報の取得に失敗したときにリトライする回数を16進数で指定します。

指定できる範囲は00000000～0000000A（10進数で0～10）です。

デフォルトは「dword:00000002」（10進数で2）です。

「0」を指定した場合は，リトライしません。

通常，この値は変更する必要はありません。

"GetPasswd_RetryInterval"= dword:リトライ間隔

ジョブの実行先サービスに［JP1/AJS2］を指定している場合に，OSのパスワードファイルからユーザー情報の取得に失敗したときにリトライする間隔を16進数で指定します。

指定できる範囲は00000000～00002710（10進数で0～10,000）（単位：ミリ秒）です。

デフォルトは「dword:000003E8」（10進数で1,000）です。

「0」を指定した場合は，すぐにリトライします。

通常，この値は変更する必要はありません。

"AJSQL_GETPASSWD_AGTRETRYCOUNT"= dword:リトライ回数

ジョブの実行先サービスに［JP1/AJS2 Queueless Agent］を指定している場合に，キューレスエージェントサービスでOSのパスワードファイルからユーザー情報の取得に失敗したときにリトライする回数を16進数で指定します。

指定できる範囲は00000000～0000000A（10進数で0～10）です。

デフォルトは「dword:00000002」（10進数で2）です。

「0」を指定した場合は，リトライしません。

通常，この値は変更する必要はありません。

"AJSQL_GETPASSWD_AGTRETRYINTERVAL"= dword:リトライ間隔

ジョブの実行先サービスに［JP1/AJS2 Queueless Agent］を指定している場合に，キューレスエージェントサービスでOSのパスワードファイルからユーザー情報の取得に失敗したときにリトライする間隔を16進数で指定します。

指定できる範囲は00000000～00002710（10進数で0～10,000）（単位：ミリ秒）です。

デフォルトは「dword:000003E8」（10進数で1,000）です。

「0」を指定した場合は，すぐにリトライします。

通常，この値は変更する必要はありません。

"AJSQL_GETPASSWD_FTPRETRYCOUNT"= dword:リトライ回数

ジョブの実行先サービスに［JP1/AJS2 Queueless Agent］を指定している場合に，キューレスファイル転送サービスでユーザー情報の取得に失敗したときにリトライする回数を16進数で指定します。

指定できる範囲は00000000～0000000A（10進数で0～10）です。

デフォルトは「dword:00000002」（10進数で2）です。

「0」を指定した場合は，リトライしません。

通常，この値は変更する必要はありません。

"AJSQL_GETPASSWD_FTPRETRYINTERVAL"= dword:リトライ間隔

ジョブの実行先サービスに［JP1/AJS2 Queueless Agent］を指定している場合に，キューレスファイル転送サービスでOSのパスワードファイルからユーザー情報の取得に失敗したときにリトライする間隔を16進数で指定します。

指定できる範囲は00000000～00002710（10進数で0～10,000）（単位：ミリ秒）です。

デフォルトは「dword:000003E8」（10進数で1,000）です。

「0」を指定した場合は，すぐにリトライします。

通常，この値は変更する必要はありません。

(4)　注意事項

OSユーザーが登録されていない場合も設定したリトライ回数およびリトライ間隔によるリトライが実施されるため，ジョブの起動失敗や異常検出終了となるまで時間が掛かります。OSユーザーが正しく登録されていることを確認してください。

キューレスジョブの場合，リトライ中は新たなキューレスジョブを開始できなくなります。そのため，リトライ期間を長く設定するとジョブ実行の遅延につながります。運用に影響を与えない範囲でリトライ期間を変更してください。

17.　ログ情報の採取

この章では，JP1/AJS2の障害発生時の調査分析に有効なログ情報の採取方法について説明します。

＜この章の構成＞

17.1　ログ情報の採取方法

17.1　ログ情報の採取方法

＜この節の構成＞

(1)　環境設定手順

(2)　注意事項

(1)　環境設定手順

UNIXの場合，ログ情報を採取するための「資料採取ツール」をJP1/AJS2 - ManagerおよびJP1/AJS2 - Agentで提供します。

資料採取ツールは，JP1/AJS2 - Manager，JP1/AJS2 - Agentをインストールしたあと，別のディレクトリにコピーしてから使用してください。

注意

JP1/AJS2 Consoleを使用する場合，JP1/AJS2 - Managerの資料採取ツールの環境設定をしていれば，JP1/AJS2 Console AgentおよびJP1/AJS2 Console Viewでの設定は不要です。

資料採取ツールの環境設定をしていない場合は，次の手順に従って設定をしてください。

資料採取ツールを使用するための環境設定手順を次に示します。

資料採取ツールを任意のディレクトリにコピーする。
コマンド指定例を次に示します。

　cp /opt/jp1ajs2/lib/sample_script/_04  /home/jp1ajs2/trouble.sh

コピーした資料採取ツールを編集するための権限を設定する。
コマンド指定例を次に示します。

　chmod  +rw  /home/jp1ajs2/trouble.sh

資料採取ツールを編集して，ユーザー固有のファイル名に変更する。
資料採取ツールの編集には，エディターを使用してください。
次に資料採取ツールに記述されているデフォルト値を示します。このデフォルト値と異なる場合，資料採取ツールの記述を変更してください。

統合トレースログファイル格納ディレクトリ
HNTRLOG="/opt/hitachi/HNTRLib/spool"
HNTR2LOG="/var/opt/hitachi/HNTRLib2/spool"

ユーザーマッピング・認証設定ファイル格納ディレクトリ
AUTHSV="/etc/opt/jp1base/conf/user_acl"

syslogファイルおよびsyslogファイル格納ディレクトリ※1
SYSLOGFILE="/var/adm/syslog/syslog.log"：HP-UXの場合
SYSLOGFILE="/var/adm/messages"：Solarisの場合
SYSLOGFILE="/var/adm/syslog"：AIXの場合
SYSLOGFILE="/var/log/messages*"：Linuxの場合

OSシステムファイル
SYSTEMFILES="./etc/hosts ./etc/services ./etc/passwd"※2，※3

組み込みDB運用ディレクトリPDDIR
#PDDIR="/opt/HiRDB_J"※4

データベース格納ディレクトリ
DATABASE="./var/opt/jp1ajs2/database[sq]*"※3，※5

ジョブエラー情報ディレクトリ
JOBINF="./var/opt/jp1ajs2/jobinf"※3※6

JP1/AJS2 Console Manager用データディレクトリ
JP1AJS2CMDB="/var/opt/jp1ajs2cm/database"※3，※7

注※1

syslogファイルおよびsyslogファイル格納ディレクトリはシステムによって設定が変更されているおそれがあります。システムの設定に合ったsyslogファイルまたはsyslogファイルだけが格納されているディレクトリを必ず設定してください。

注※2

OSシステムファイルを採取しない場合は，採取しないファイルの名称を削除してください。

注※3

ファイル名を変更する場合は，先頭に「.（ピリオド）」を付けて，ルートディレクトリからの相対パスで指定してください。

注※4

スケジューラーデータベースに組み込みDBを使用している場合，組み込みDBのトレース情報を採取するには，コメントを削除し，組み込みDB運用ディレクトリ（PDDIR）を記述してください。デフォルトは「/opt/HiRDB_J」です。組み込みDB運用ディレクトリを変更している場合は，該当ディレクトリに変更してください。

注※5

デフォルト設定のディレクトリ名は削除しないでください。物理ホストでスケジューラーサービスを追加し，このディレクトリ下にないデータベースディレクトリを指定している場合は，そのディレクトリの名称を先頭に「.（ピリオド）」を付けて追記してください。

（例）

　　DATABASE="./var/opt/jp1ajs2/database ./adddir/database2"

論理ホストだけで運用している場合で，デフォルトで設定されるディレクトリより変更を加えている場合は，手順4で，ADDFILEに共有ディスク上のデータベースディレクトリが含まれるディレクトリの名称を記述してください。DATABASEは変更しないでください。

注※6

物理ホストのスケジューラーサービスの設定で，ジョブエラー情報ディレクトリを変更または追加している場合は修正してください。論理ホストだけで運用している場合で，デフォルトで設定されるディレクトリより変更を加えている場合は，手順4で，ADDFILEに共有ディスク上のジョブエラー情報ディレクトリが含まれるディレクトリの名称を記述してください。

注※7

物理ホストのJP1/AJS2 Console Managerのデータディレクトリの設定を変更している場合は，修正してください。論理ホストのデータディレクトリについては，手順4でADDFILEに指定してください。

資料採取ツールにデフォルトで記述されている各ログファイルの格納ディレクトリについては，マニュアル「JP1/Automatic Job Management System 2 設計・運用ガイド　17.2.4 ログファイルおよびディレクトリ一覧」および「JP1/Base 運用ガイド」の付録に記載されている，ファイルおよびディレクトリ一覧を参照してください。

クラスタ運用時，論理ホストの出力ディレクトリの設定をデフォルトから変更した場合や，そのほかの情報を採取したい場合は，資料採取ツールをカスタマイズする。
資料採取ツールをエディターで開き，「変更後の共有ディレクトリ」の情報を採取できるようにします。

　　　：
　　　：
ADDFILE="/変更後の共有ディレクトリ/jp1ajs2"
ADDFILE="$ADDFILE /変更後の共有ディレクトリ/jp1base/log /変更後の共有ディレクトリ/jp1base/conf"
　　　：
　　　：

(2)　注意事項

07-10以降の資料採取ツールと07-10より前のバージョンの資料採取ツールでは，次の表に示す相違があります。

表17-1　資料採取ツールの相違点

機能
07-10以降
07-10より前のバージョン

次の資料の採取

エラーログ情報※1

/etc/environmentファイルの情報※1

データベースディレクトリのファイルリスト情報

core解析に必要な情報※2

採取する。
採取しない。

論理ホストの指定
資料採取ツールの実行時に論理ホスト名を指定する。
資料採取ツールの環境設定で，論理ホストごとの情報格納フォルダを設定する。

初期調査ファイルの分離
初期調査ファイルとその他のファイルを分離して出力する。
初期調査に必要なファイルが分散して出力される。

注※1

AIXの場合だけ採取します。

注※2

Linuxでは，次の注意事項があります。

Linuxでは，デフォルト設定でコアファイル出力時の最大サイズが「0」となっている場合があるため，コアダンプが出力されないおそれがあります。

このため，Linuxでコアダンプが出力できるように，jajs_startおよびjajs_start.clusterスクリプトにデフォルトで，次の設定をしています。

if [ 'uname' = Linux ]; then

ulimit -c unlimited

fi

この設定が使用しているホストのセキュリティポリシーに反する場合は，これらのファイルの設定を次のようにコメント化してください。

このコメント化の設定を行った場合は，JP1/AJS2のプロセスがセグメンテーション障害やバス障害などのコアダンプ出力契機に，コアダンプが出力されず調査が行えない場合があります。

#if [ 'uname' = Linux ]; then

# ulimit -c unlimited

#fi

07-10より前のバージョンの資料採取ツールをカスタマイズして，既存の情報以外の情報を取得していた場合，07-10以降にバージョンアップしても07-10以降の資料採取ツールには反映されません。

18.　クラスタシステム運用時のセットアップ

この章では，JP1/AJS2をクラスタシステムで運用する場合のセットアップ方法について説明します。

なお，クラスタシステムとは，これまでJP1のマニュアルで「系切り替えシステム」と呼ばれていたものと同じです。

＜この章の構成＞

18.1　クラスタ運用の前提

18.2　クラスタ運用の概要

18.3　クラスタシステム運用時のインストールとセットアップ

18.4　クラスタ運用の環境設定

18.5　クラスタ運用時の注意事項

18.1　クラスタ運用の前提

JP1/AJS2をクラスタシステムで使用する場合，次に示す前提条件があります。

クラスタソフトは，次に示す2～4を制御できるプログラムであること。

実行系から待機系へ引き継ぎ可能な共有ディスクが使用できること。
詳細には次に示す条件を満たすこと。

JP1を起動する前に，共有ディスクが割り当てられること。

JP1を実行中に，共有ディスクの割り当てが解除されないこと。

JP1を停止したあとに，共有ディスクの割り当てが解除されること。

実行系ノード以外からは共有ディスクをアクセスできないよう排他制御されていること。

システムダウンなどでファイルが消えないよう，ジャーナル機能を持つファイルシステムなどでファイルを保護すること。

フェールオーバーしてもファイルに書き込んだ内容が保証されて引き継がれること。

フェールオーバー時に共有ディスクを使用中のプロセスがあっても，強制的にフェールオーバーできること。

共有ディスクの障害を検知した場合の回復処置はクラスタソフトなどが制御し，回復処置をJP1が意識する必要がないこと。回復処置の延長での起動や停止が必要な場合は，クラスタソフトからJP1に起動や停止の実行要求をすること。

論理IPアドレスとして次に示す条件を満たすこと。

引き継ぎ可能な論理アドレスを使って通信できること。

論理ホスト名から論理アドレスが一意に求まること。

JP1を起動する前に，論理アドレスが割り当てられること。

JP1を実行中に，論理アドレスが削除されないこと。

JP1を実行中に，論理ホスト名と論理アドレスの対応が変更されないこと。

JP1を停止したあとに，論理アドレスが削除されること。

ネットワーク障害を検知した場合の回復処置はクラスタソフトなどが制御し，JP1が回復処理を意識する必要がないこと。また，回復処置の延長でJP1の起動や停止が必要な場合は，クラスタソフトからJP1に起動や停止の実行要求をすること。

多重起動する場合，論理ホストごとに一つずつのIPアドレスが割り当てられていること。

論理ホスト名が，hostsファイルやネームサーバに設定され，TCP/IP通信ができるようになっていること。DNS運用の場合には，JP1ホスト名として別名定義が必要になることがあるため，論理ホスト名として，FQDN形式でないJP1ホスト名が使用可能で，その論理ホストがネットワーク内で認識できることが必要。

前提であるJP1/Baseが，クラスタシステムを使用できる環境になっていること。

スケジューラーデータベースに組み込みDBを使用する場合，ホスト名に関して次に示す制限がある。

組み込みDB環境を構築するホストのホスト名をjp1hosts定義ファイルに登録しても，組み込みDBで使用するホスト名として有効にならない。

組み込みDB環境を構築するホストのホスト名には，エイリアス名を使用できない。

組み込みDBが稼働できるホストのホスト名は，最大32バイトとなる。したがって，組み込みDB環境を構築するホストは，実行系の物理ホスト名および論理ホスト名共に1～32バイトで設定する必要がある。

18.2　クラスタ運用の概要

JP1/AJS2のクラスタ運用の運用例を説明します。なお，クラスタシステムや，同時に利用するアプリケーションプログラム（JP1のプログラムを含みます）は，この形態に対応していないことがあります。各プログラムのマニュアルで確認してください。

＜この節の構成＞

18.2.1　基本的な運用方法

18.2.1　基本的な運用方法

クラスタシステムでフェールオーバーさせる場合の基本的な運用方法を説明します。フェールオーバーをする場合，JP1/AJS2では，フェールオーバーする単位ごとに論理ホスト名を割り当てて運用することになります。この論理ホスト名を使用して，フェールオーバーする単位ごとの多重起動および管理対象システムにアクセスします。

論理ホスト名には，「18.1 クラスタ運用の前提」で示した前提条件に基づいて割り当てられたホスト名を使用してください。DNS運用の場合は，FQDN形式でないホスト名を使用してください。

論理ホスト名を指定することで，サービス（デーモン）の起動およびコマンドの実行が論理ホストごとにできるようになります。論理ホスト名は次のどちらかの方法で指定します。

環境変数JP1_HOSTNAME

各コマンドの論理ホスト指定オプション（通常は-hオプションです。詳細は各コマンドの説明を参照してください）
論理ホスト指定オプションが指定されていない場合，各コマンドは，環境変数JP1_HOSTNAMEに設定された論理ホスト名を使用して実行されます。なお，「JP1_HOSTNAME=""」と設定した場合は無視されます。

18.3　クラスタシステム運用時のインストールとセットアップ

クラスタ運用に対応するためのインストールおよびセットアップについて説明します。

＜この節の構成＞

18.3.1　クラスタ運用時のインストール

18.3.2　クラスタ運用時のセットアップ

18.3.3　クラスタ運用時の組み込みDBのインストール（JP1/AJS2 - Manager）

18.3.4　クラスタ運用時の組み込みDBのセットアップ（JP1/AJS2 - Manager）

18.3.5　クラスタ運用時の監視方法

18.3.1　クラスタ運用時のインストール

実行系と待機系の両方のローカルディスク上にJP1/AJS2をインストールしてください。

注意

共有ディスク上には，JP1/AJS2をインストールしないでください。

18.3.2　クラスタ運用時のセットアップ

JP1/AJS2をクラスタ運用するシステムを構築する場合の，UNIXホストのセットアップについて説明します。

クラスタ運用時のセットアップ手順を次の図に示します。

図18-1　クラスタ運用時のセットアップ手順

実行系と待機系のJP1シリーズプログラムは，同じドライブおよび同じディレクトリにインストールしてください。図中の，JP1/BaseおよびJP1/AJS2シリーズプログラムのセットアップについては，「13. セットアップ」を参照してください。また，クラスタシステムのセットアップについては，使用するクラスタシステムのドキュメントを参照してください。

ここでは，クラスタ運用に必要な設定項目について説明します。説明中のコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 2 コマンドリファレンス　1. コマンド」を参照してください。

なお，JP1/AJS2でクラスタシステムのセットアップをする前に，必ずJP1/Baseでクラスタシステムをセットアップしておいてください。

また，クラスタ運用する場合は，使用するクラスタソフトへの対応を確認してからセットアップおよび運用してください。

18.3.3　クラスタ運用時の組み込みDBのインストール（JP1/AJS2 - Manager）

JP1/AJS2 - Managerでスケジューラーデータベースとして組み込みDBを使用する場合には，実行系，待機系それぞれのローカルディスク上に，組み込みDBをインストールしてください。

組み込みDBのインストール方法については，「12.3 組み込みDBのインストール」を参照してください。

注意

共有ディスク上には，組み込みDBをインストールしないでください。

18.3.4　クラスタ運用時の組み込みDBのセットアップ（JP1/AJS2 - Manager）

＜この項の構成＞

(1)　必要なファイルシステム容量の見積もり，および組み込みDBファイルシステム領域の準備

(2)　組み込みDBサーバの構築

(3)　JP1/AJS2の設定

(4)　クラスタソフトへの登録

(1)　必要なファイルシステム容量の見積もり，および組み込みDBファイルシステム領域の準備

領域作成時の注意事項

HA構成の場合は，組み込みDBファイルシステム領域を共有ディスク上のキャラクタ型スペシャルファイルに作成することをお勧めします。ファイルシステムを使用する場合は書き込み保証されないため，信頼性が低下しますので注意してください。また，ローカルディスクに30メガバイト程度の空きのある作業ディレクトリが必要です。

ここで用意するファイルシステム領域は，組み込みDBファイルシステム領域として確保する必要があるものです。JP1/AJS2で使用するデータベースディレクトリ（ジョブ実行環境用およびスケジューラーユニット管理用）は別途必要です。

次の例を基に，ファイルシステム領域へのアクセスセキュリティを設定してください。

UNIXファイルシステムを使用する場合（ディレクトリ：/shdsk/RDAREA）

ファイルシステムを配置するディレクトリを共有ディスク上に作成します
（例）
mkdir /shdsk/RDAREA

ファイルシステム領域の権限を設定します
（例）
chown root : sys /shdsk/RDAREA
chmod 0755 /shdsk/RDAREA

キャラクタ型スペシャルファイルを使用する場合

論理ボリュームを適切なサイズで二つ作成します
構築する組み込みDBサーバの規模によって，必要なパーティションサイズが異なります。少なくとも次のサイズを確保してください。また，組み込みDBのシステムログ領域を二重化する場合は作成するパーティションは三つになります。

表18-1　組み込みDBサーバに必要なパーティションサイズ

規模
RDエリア用
（ajssys01）
システムファイル1用
（ajssys11）
システムファイル2用※
（ajssys17）

大規模
1,600メガバイト
3,402メガバイト
3,402メガバイト

中規模
800メガバイト
1,200メガバイト
1,200メガバイト

小規模
300メガバイト
702メガバイト
702メガバイト

注※
　組み込みDBのシステムログ領域を二重化する場合に必要となります。

各ボリュームの権限を設定します
（例）
chown root:sys /dev/vg00/rembdb00 /dev/vg00/rembdb01 /dev/vg00/rembdb02
chmod 0755 /dev/vg00/rembdb00 /dev/vg00/rembdb01 /dev/vg00/rembdb02

(2)　組み込みDBサーバの構築

ajsembdbbuildスクリプトを使用して，組み込みDBサーバを構築します。

セットアップに使用するajsembdbbuildスクリプトは，/opt/jp1ajs2/toolsディレクトリにあります。

次に示す環境条件の構築例について説明します。

規模：大規模

ログ運用：システムログ運用（二重化あり）

実行系ホスト：physical1

待機系ホスト：physical2

論理ホスト：lhost

RDエリア作成パーティション：/dev/vg00/rembdb00（共有ディスク上）

システムファイル作成パーティション1：/dev/vg00/rembdb01（共有ディスク上）

システムファイル作成パーティション2：/dev/vg00/rembdb02（共有ディスク上）

作業ディレクトリ：/localdisk

組み込みDBのインストールディレクトリ：/opt/HiRDB_J

組み込みDBサーバ構築時の準備
組み込みDBサーバを構築する前に，論理IPアドレスを有効にし，共有ディスクが使用できる状態にしておいてください。また，スクリプト内から組み込みDBサービスを起動しますので，この時点では，組み込みDBサービスが起動していない状態であることを確認してください。

注意

セットアップスクリプト内から，組み込みDBシステム定義ファイルを動的に生成します。運用に応じて，オプションの指定が必要です。

セットアップスクリプトは，オプションを省略すると，規定の設定でセットアップします。マルチ組み込みDB環境を作成する場合など，既存の組み込みDBでの運用に影響を及ぼさないように注意して使用してください。マルチ組み込みDB環境でセットアップする場合は，ポート番号の重複・環境変数の設定に誤りがないことを確認して実行してください。ajsembdbbuildスクリプトの使用方法については，「20. セットアップ時に使用するコマンド　ajsembdbbuild」を参照してください。

組み込みDBが稼働できるホストのホスト名は，最大32バイトです。したがって，組み込みDB環境を構築するホストは，物理ホストおよび論理ホスト共に1～32バイトで設定してください。

実行系の組み込みDBサーバ環境の構築
ajsembdbbuildスクリプトを実行します。

ajsembdbbuild -l -a "ajssys01=/dev/vg00/rembdb00,ajssys11=/dev/vg00
/rembdb01,ajssys17=/dev/vg00/rembdb02" -ld /localdisk -br
 -r -mh lhost -eh physical1 -i /opt/HiRDB_J

注意

実行系でセットアップするときには-rオプションを指定してください。

明示的にオプションを指定しない場合は，ポート番号，テーブルプリフィックスなどは標準設定になりますので重複しないように注意してください。

-ld，-iオプションには共有ディスクを指定しないでください。

待機系の組み込みDBサーバ環境の構築
ajsembdbbuildスクリプトを実行します。

ajsembdbbuild -l -a "ajssys01=/dev/vg00/rembdb00,ajssys11=/dev/vg00
/rembdb01,ajssys17=/dev/vg00/rembdb02" -ld /localdisk -br
 -f -mh lhost -eh physical1 -i /opt/HiRDB_J

注意

-rオプションではなく，-fオプションを指定します。それ以外は実行系と同じオプションを指定してください。

待機系のホストのセットアップであっても，-ehオプションには実行系物理ホスト名を指定してください。

-ld，-iオプションには共有ディスクを指定しないでください。

(3)　JP1/AJS2の設定

JP1/AJS2スケジューラーデータベースの組み込みDB化は，ISAMからの移行によって構築します。このため，JP1/AJS2のデータベースをいったんISAMで構築してください。

JP1/BASE，JP1/AJS2の設定方法については，「18.4 クラスタ運用の環境設定」についても参照してください。

JP1/AJS2関連サービスの停止
JP1/AJS2の関連サービスが起動している場合，これらを停止してください。
物理ホスト・論理ホストすべてのJP1/AJS2サービスを停止します。
また，共有メモリーに記載されているスケジューラーサービスの情報をクリアします。すべてのサービスが停止したことを確認し，次のコマンドを実行します。

/opt/jp1ajs2/bin/ajsshmdel >/dev/null 2>&1
(Cシェルの場合：/opt/jp1ajs2/bin/ajsshmdel >&/dev/null)

組み込みDBへの移行（実行系）
スケジューラーサービスのデータベースの移行には，ajsembdbsetupスクリプトを使用します。ajsembdbsetupスクリプトは，/opt/jp1ajs2/toolsディレクトリにあります。ajsembdbsetupスクリプトの使用方法については，「20. セットアップ時に使用するコマンド　ajsembdbsetup」を参照してください。
スケジューラーサービスのデータベースを移行する場合は，いったんスケジューラーサービスのデータベースをISAMに変更する必要があります。
スケジューラーサービスのデータベースを組み込みDBからISAMに変更する方法については，マニュアル「JP1/Automatic Job Management System 2 設計・運用ガイド　15.14.2 スケジューラーデータベースで使用するDBMSを変更する」を参照してください。
スケジューラーサービスのデータベースをOracleからISAMに変更する方法については，「付録C Oracleデータベースの移行」を参照してください。
（例）
論理ホストlhostのスケジューラーサービスAJSROOT2で組み込みDBを使用する場合

ajsembdbsetup -mh lhost -F AJSROOT2 -ru l

JP1共通定義情報のコピー
実行系サーバで構築した論理ホスト環境をセットアップしたときに，JP1共通定義情報に論理ホストの定義情報が設定されます。新規インストールの場合，JP1共通定義情報の設定が実行系と待機系で同じになるように設定内容を実行系から待機系にコピーします。

(4)　クラスタソフトへの登録

組み込みDBのクラスタ開始モード

組み込みDBをセットアップ直後のpd_mode_confは，MANUAL1（常に手動起動）です。

構築する環境に応じて，組み込みDBのパラメーターpd_mode_confを編集してください。

MANUAL1：

手動起動します。ただし，組み込みDB異常終了後の再開始は自動起動になります。

MANUAL2：

手動起動します。

組み込みDBの定義ファイルの編集は，次の手順で行ってください。

・実行系

組み込みDBを使用しているスケジューラーサービスを停止する。

組み込みDBを停止する。

組み込みDBの定義ファイルを編集する。
定義ファイル：pdsys
定義パラメーター：set pd_mode_conf = MANUAL1 | MANUAL2
上記ファイルを格納しているディレクトリは，次に示す場所になります。
組み込みDB運用ディレクトリ/conf

組み込みDBを起動する。

組み込みDBを使用しているスケジューラーサービスを起動する。

・待機系

組み込みDBの定義ファイルを編集する。
定義ファイル：pdsys
定義パラメーター：set pd_mode_conf = MANUAL1 | MANUAL2
上記ファイルの格納しているディレクトリは次の場所になります。
組み込みDB運用ディレクトリ/conf

注意

組み込みDBの定義ファイルはajsembdbbuild実行時にディレクトリに作成され，環境を削除したときに削除されるのでユーザーが定義ファイルを直接編集する場合には注意が必要です。

クラスタ開始・停止スクリプトの設定

クラスタスクリプトでは，ajsembdbstartおよびajsembdbstopコマンドを実行するようにしてください。

注意

ajsembdbstartコマンド実行時には，オプションを指定しないでください。また，このコマンドは，JP1/AJS2サービスを起動するよりも先に実行する必要があります。

ajsembdbstopコマンド実行時には，-fおよび-qオプションを指定してください。また，このコマンドは，JP1/AJS2サービス停止後に実行する必要があります。

ajsembdbstartおよびajsembdbstopコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 2 コマンドリファレンス　1. コマンド」を参照してください。

18.3.5　クラスタ運用時の監視方法

＜この項の構成＞

(1)　JP1/AJS2の運用監視

(2)　スケジューラーサービスのデータベースに組み込みDBを使用している場合

(1)　JP1/AJS2の運用監視

クラスタ運用時，JP1/AJS2の起動状態を監視する場合は，jajs_spmd_statusコマンドを実行してください。

(2)　スケジューラーサービスのデータベースに組み込みDBを使用している場合

組み込みDBサービスで回復できない障害が発生して組み込みDBサービスが停止状態となった場合に，JP1/AJS2のサービスを停止させることで障害を検知するには，次の環境設定を行う必要があります。

環境設定パラメーターを設定する。
次の環境設定パラメーターを該当するスケジューラーサービスに設定してください。

環境設定パラメーター
値
説明

RDBCHECKINTERVAL
300
組み込みDBサービスとの接続確認を行い，切断を検知したときにスケジューラーサービスを自動的に停止させます。

AUTORESTARTCOUNT
0
スケジューラーサービスを構成するプロセスが異常終了した場合に，異常終了したプロセスを自動的に再起動する回数です。
ただし，異常要因は組み込みDBの障害に限らないため，ほかの障害時の回復運用に合わせて指定してください。

MASTERDABEND
yes
スケジューラーサービスの異常時に，スケジューラーサービス全体を異常終了させます。
スケジューラーサービスを多重起動している場合は，すべてのスケジューラーサービスを停止します。

環境設定パラメーターの詳細については，「14.1.3 スケジューラーサービス環境設定パラメーターの定義内容」を参照してください。
スケジューラーサービス環境の設定については，「14.1.1 スケジューラーサービス環境の設定手順」および「18.4.3 共通定義情報変更時の作業」を参照してください。

18.4　クラスタ運用の環境設定

クラスタ運用に対応するためのJP1/AJS2の環境設定について説明します。

＜この節の構成＞

18.4.1　クラスタシステムの環境設定の項目

18.4.2　クラスタシステムの環境設定の手順

18.4.3　共通定義情報変更時の作業

18.4.4　クラスタソフトへの登録

18.4.5　キューレスジョブ実行環境の設定

18.4.6　論理ホストの削除

18.4.7　論理ホストのスケジューラーサービスの多重起動の設定

18.4.8　論理ホスト環境のJP1/AJS2の起動および終了を制御する設定

18.4.1　クラスタシステムの環境設定の項目

ここでは，環境設定で設定する項目について説明します。実際の設定手順については「18.4.2 クラスタシステムの環境設定の手順」で説明します。

＜この項の構成＞

(1)　共有ディスクへの共有ファイルの作成

(2)　通信方式の設定

(3)　共通定義情報の設定

(1)　共有ディスクへの共有ファイルの作成

実行系・待機系の切り替え時に情報を共有するために，ディレクトリやファイルを共有ディスク上に作成します。作成するディレクトリの種類とディレクトリ名を次の表に示します。これらディレクトリは，jp1ajs2_setup_cluster実行時に-dオプションで指定した「共有ディレクトリ名/jp1ajs2」の下に自動的に作成されます。

表18-2　共有ディレクトリに作成するディレクトリの種類とディレクトリ名（JP1/AJS2 - Manager）

共有ディレクトリの種類 | ディレクトリ名
構成定義ファイル | 共有ディレクトリ名/jp1ajs2/conf
ジョブ実行環境ファイル | 共有ディレクトリ名/jp1ajs2/database
ジョブ情報ファイル | 共有ディレクトリ名/jp1ajs2/jobinf
ログファイル | 共有ディレクトリ名/jp1ajs2/log
システムファイル | 共有ディレクトリ名/jp1ajs2/sys
作業ファイル | 共有ディレクトリ名/jp1ajs2/tmp
バックアップファイル | 共有ディレクトリ名/jp1ajs2/backup
JP1/AJS2 Console Managerのデータディレクトリ | 共有ディレクトリ名/jp1ajs2cm/database※

注※

jp1ajs2_setup_cluster実行時に自動的に作成されませんので，JP1/AJS2 Console Managerをクラスタシステムで運用する場合にディレクトリを作成してください。

表18-3　共有ディレクトリに作成するディレクトリの種類とディレクトリ名（JP1/AJS2 - Agent）

共有ディレクトリの種類 | ディレクトリ名
構成定義ファイル | 共有ディレクトリ名/jp1ajs2/conf
ログファイル | 共有ディレクトリ名/jp1ajs2/log
システムファイル | 共有ディレクトリ名/jp1ajs2/sys
作業ファイル | 共有ディレクトリ名/jp1ajs2/tmp

共有ディレクトリは，JP1/Baseで論理ホストの環境設定時に指定したディレクトリを指定してください。論理ホストが異なる場合は，別のディレクトリを割り当ててください。論理ホストごとに割り当てたディレクトリ下に，共有するディレクトリやファイルを作成します。

（例）

論理ホスト「node0」の共有ディレクトリとして「/shdsk/node0」を指定する場合

/shdsk/node0/jp1ajs2/jp1ajs2/conf
/shdsk/node0/jp1ajs2/jp1ajs2/database
/shdsk/node0/jp1ajs2/jp1ajs2/jobinf
/shdsk/node0/jp1ajs2/jp1ajs2/log
/shdsk/node0/jp1ajs2/jp1ajs2/sys
/shdsk/node0/jp1ajs2/jp1ajs2/tmp
/shdsk/node0/jp1ajs2/jp1ajs2/backup
/shdsk/node0/jp1ajs2/jp1ajs2cm/database

(2)　通信方式の設定

通信で使用するTCP/IPソケットにIPアドレスをバインドする方法が設定されます。クラスタシステムで多重起動をする場合は，物理ホストも含めてすべてIPアドレスにバインドする方式を使用します。「18.4.2 クラスタシステムの環境設定の手順」に従うと，IPアドレスにバインドする方式が自動的に設定されます。

スケジューラーサービスの多重起動の設定でジョブ状態通知ポートのサービス名に対するポート番号を追加している場合は，ポート番号の設定をしてください。

(3)　共通定義情報の設定

JP1/AJS2，JP1/Base，JP1/IMでは，論理ホストごとの情報を共通定義情報としてローカルディスク上に持っており，論理ホストごとに同じ内容にしておく必要があります。

引き継がれる情報は，構成定義ファイルやジョブ実行環境ファイルなどです。

18.4.2　クラスタシステムの環境設定の手順

「18.4.1 クラスタシステムの環境設定の項目」で説明した項目を，コマンドで定義します。実行系と待機系でそれぞれ作業が必要です。

次に，環境設定のコマンドについて，実行系と待機系それぞれでの作業を説明します。なお，ここで説明する設定は，JP1/AJS2 - ManagerまたはJP1/AJS2 - Agentで実行してください。

環境設定の手順を次に示します。

＜この項の構成＞

(1)　実行系での作業（JP1/AJS2 - Manager）

(2)　待機系での作業（JP1/AJS2 - Manager）

(3)　実行系での作業（JP1/AJS2 - Agent）

(4)　待機系での作業（JP1/AJS2 - Agent）

(1)　実行系での作業（JP1/AJS2 - Manager）

JP1/Baseの実行系での設定作業をする。
JP1/Baseの作業については，マニュアル「JP1/Base 運用ガイド」を参照してください。

物理ホストをセットアップする。
「13.1.2 JP1/AJS2 - Managerのセットアップ」を参照して，物理ホストをセットアップしてください。
JP1/AJS2 Console ManagerおよびJP1/AJS2 Console Agentを使用する場合は，それぞれ次のコマンドを実行します。

/opt/jp1ajs2cm/bin/jp1ajs2cmsetup
/opt/jp1ajs2/bin/jp1ajs2casetup

すでに物理ホストのセットアップがされている場合は上記コマンドの実行は不要です。なお，JP1/AJS2 Consoleのサービスに対しては，自動起動および自動終了の設定が必要です。設定方法は「14.7.2(3) JP1/AJS2 Consoleサービスの自動起動および自動終了を設定する」を参照してください。

jp1ajs2_setup_clusterコマンドを実行して論理ホストを設定し，共有ディスク上に共有ファイル，共有ディレクトリを作成する。
すべての論理ホストと物理ホストのJP1/AJS2サービス，およびJP1/AJS2 Monitorサービスを停止したあと，jp1ajs2_setup_clusterコマンドを実行してください。
jp1ajs2_setup_clusterコマンドの入力形式を次に示します。

jp1ajs2_setup_cluster -h 論理ホスト名 [ -d 共有ディレクトリ名]
[ -n 数値] [ -m { cold|warm|hot }]

-hオプションには，JP1/Baseで設定した論理ホスト名を指定します。

-dオプションは，実行系の環境設定時には必ず指定してください。このオプションには，共有ディレクトリと共有ファイルを作成する，共有ディスク上のディレクトリを指定します。共有ディレクトリとして，「指定したディレクトリ名/jp1ajs2/」を作成し，ローカルディスクの定義ファイル（/etc/opt/jp1ajs2/conf/下のファイル）をコピーします。実行するときには，必ず共有ディスクをマウントしておいてください。省略した場合は，待機系の環境設定を行います。

-nオプションには，スケジューラーサービスの名前を，そのマシンで一意にするための識別番号を1～20の間で指定します。実行系の環境設定時にだけ有効です。省略した場合は「2」が仮定されて「AJSROOT2」が作成されるため，「AJSROOT2」が作成されていない場合にだけ省略してください。指定する場合は，物理ホストおよび論理ホストで使用していないスケジューラーサービスの識別番号を指定してください。
物理ホスト，またはjp1ajs2_setup_clusterコマンドを実行する論理ホスト上に，-nオプションで指定する識別番号と同じ番号のスケジューラーサービスがある場合は，警告メッセージが出力されますが，処理は正常終了します。jp1ajs2_setup_clusterコマンドを実行する論理ホストとは別の論理ホストにすでにあるスケジューラーサービスの識別番号と同じ番号を指定した場合は，メッセージを出力しないで正常終了します。
物理ホストにすでに「AJSROOT2」がある場合に，-nオプションに「2」を指定した場合の警告メッセージの出力例を次に示します。

<Warning> Duplicate with scheduler service(AJSROOT2) of physical host.

また，jp1ajs2_setup_clusterコマンドでセットアップ済みの論理ホストにすでに「AJSROOT2」がある場合に，-nオプションに「2」を指定した場合の警告メッセージの出力例を次に示します。

<Warning> Overwrite scheduler service(AJSROOT2) registry of the logical host.

論理ホストで使用済みのスケジューラーサービスの識別番号を指定すると，コマンドは環境を上書きして異常終了します。この場合，「-dオプションで指定した共有ディレクトリ/jp1ajs2」ディレクトリを削除したあと，コマンドを再実行してください。
なお，すでに指定されている識別番号は，jbsgetcnfコマンドで共通定義情報を取得し，共通定義パラメーターAJSSERVICEIDに設定されている値で確認できます。共通定義パラメーターAJSSERVICEIDは，スケジューラーサービスが複数設定されている場合には複数の設定値があります。そのため，物理ホストおよび論理ホストの共通定義を取得し，すべての定義で指定する識別番号が重複しないことを確認してください。

-mオプションには，スケジューラーサービスの起動モードを指定します。実行系の環境設定時にだけ有効です。省略した場合は，スケジューラーサービス環境設定ファイル（Schedule.conf）のSTARTMODEパラメーターに指定されている値を引き継ぎます。

jp1ajs2_setup_clusterコマンドの詳細については，「20. セットアップ時に使用するコマンド　jp1ajs2_setup_cluster（UNIX限定）」を参照してください。

JP1/AJS2 Console Managerの環境設定をする。
JP1/AJS2 Console Managerを使用している場合，次の手順でJP1/AJS2 Console Managerの環境設定をしてください。
なお，JP1/AJS2 Console Agentのクラスタ運用時の環境設定は，JP1/AJS2 Managerのクラスタ運用時のセットアップ中に実施されるため，JP1/AJS2 Console Agentのクラスタ運用時の環境設定は必要ありません。

1.　viなどのエディターで構成定義ファイルを作成する。

作成する構成定義ファイルの内容を次に示します。

[論理ホスト名¥JP1AJS2CONSOLEMANAGER]

"DATADIRECTORY"="論理ホストのデータディレクトリのパス"

論理ホスト名が「node0」で，論理ホストの共有ディレクトリが「/shdsk/node0」の場合の指定例を次に示します。

[node0¥JP1AJS2CONSOLEMANAGER]

"DATADIRECTORY"="/shdsk/node0/jp1ajs2cm/database"

2.　構成定義ファイルを任意のディレクトリに保存する。

ファイル名の例を次に示します。

jp1ajs2cm_node0.txt

3.　次に示すコマンドを実行して構成定義ファイルの情報を設定する。

jbssetcnf 構成定義ファイル名

jbssetcnfコマンドのパスは，「/opt/jp1base/bin/jbssetcnf」です。

jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

コマンドの指定例を次に示します。

jbssetcnf jp1ajs2cm_node0.txt

実行系のJP1/AJS2 - Managerで，JP1/AJS2データベースとして組み込みDBを使用する場合は組み込みDBをセットアップする。
JP1/AJS2データベースとして組み込みDBを使用する場合は，「15. スケジューラーデータベースに組み込みDBを使用する場合のセットアップ」を参照してください。

実行系のJP1/AJS2 - Managerで，論理ホストで使用するファイル・ディレクトリを作成するために，次のコマンドを実行する。

jpqimport -dt isam -ci ジョブ実行環境構成定義ファイル名 -mh 論理ホスト名

jpqimportコマンドの詳細については，「20. セットアップ時に使用するコマンド　jpqimport」を参照してください。

キューレスジョブを利用する場合は，キューレスジョブのセットアップをする。
次のコマンドを実行します。

マネージャー環境の場合

ajsqlsetup -h 論理ホスト名 -F スケジューラーサービス名

ajsqlsetupコマンドを実行すると，共有ディスク上にキューレスジョブの実行に必要なファイルを作成し，チェックしますので，必ず共有ディスクをマウントしてから実行してください。
ajsqlsetupコマンドの詳細については，「20. セットアップ時に使用するコマンド　ajsqlsetup」を参照してください。

JP1/AJS2サービス起動時のISAMファイル自動再編成機能を有効にする。
論理ホストの共有ディレクトリが「/shdsk/node0」の場合，「/shdsk/node0/jp1ajs2/conf/jp1ajs_spmd_pre.conf.model」ファイルを，jp1ajs_spmd_pre.confファイルにコピーします。

これで実行系での作業は終了です。

注意事項

設定は論理ホストごとに実施してください。

実行系の論理ホストの設定（jp1ajs2_setup_clusterコマンド）は，物理ホストのスケジューラーサービスの多重起動が設定されていない状態で実行してください。

論理ホストでスケジューラーサービスを多重起動する設定が必要な場合は，「18.4.7(1) スケジューラーサービスを多重起動する」を参照して設定してください。

実行系の論理ホストの設定（jp1ajs2_setup_clusterコマンド）を実行すると，物理ホストのjp1ajs_spmd.confファイルが論理ホストにコピーされます。そのため，物理ホストの設定を引き継いで，論理ホストに必要のないプロセスが起動されることがあります。物理ホストでjp1ajs_spmd.confファイルを編集している場合は，論理ホストのjp1ajs_spmd.confファイルを編集し，必要なプロセスだけが起動されるようにしてください。

(2)　待機系での作業（JP1/AJS2 - Manager）

物理ホストをセットアップする。
物理ホストをセットアップするには次のコマンドを実行します。

/opt/jp1ajs2/bin/jp1ajs2_setup

物理ホストをセットアップ済みの場合は，すべてのJP1/AJS2サービスを停止したあと，実行系と同様の手順でシステムの共有メモリーに記憶されているスケジューラーサービスの情報をクリアしてください。
JP1/AJS2 Console ManagerおよびJP1/AJS2 Console Agentを使用する場合は，それぞれ次のコマンドを実行します。

/opt/jp1ajs2cm/bin/jp1ajs2cmsetup
/opt/jp1ajs2/bin/jp1ajs2casetup

すでに物理ホストのセットアップがされている場合は上記コマンドの実行は不要です。なお，JP1/AJS2 Consoleのサービスに対しては，自動起動および自動終了の設定が必要です。設定方法は「14.7.2(3) JP1/AJS2 Consoleサービスの自動起動および自動終了を設定する」を参照してください。

実行系でのJP1/AJS2，JP1/Base，JP1/IMの作業を完了させたあと，実行系の共通定義情報を退避し，待機系に共通定義情報を設定する。
実行系での作業が完了したあと，実行系でjbsgetcnfコマンドを実行して，共通定義情報を退避します。その退避ファイルを待機系にコピーし，退避ファイルを引数に指定したjbssetcnfコマンドを実行します。実行するコマンドを次に示します。

実行系

jbsgetcnf -h 論理ホスト名 > 退避ファイル名

待機系

jbssetcnf 退避ファイル名

JP1/Baseの待機系での作業をする。
JP1/Baseの作業については，マニュアル「JP1/Base 運用ガイド」を参照してください。

jp1ajs2_setup_clusterコマンドを実行して，論理ホストを設定する。
jp1ajs2_setup_clusterコマンドの入力形式を次に示します。

jp1ajs2_setup_cluster -h 論理ホスト名

-hオプションには，JP1/Baseで設定した論理ホスト名を指定します。

キューレスジョブを利用する場合は，キューレスジョブのセットアップをする。
次のコマンドを実行します。

マネージャー環境の場合

ajsqlsetup -h 論理ホスト名 -F スケジューラーサービス名 -nc

これで待機系での作業は終了です。

注意事項

設定は論理ホストごとに実施してください。

論理ホストでスケジューラーサービスを多重起動する設定が必要な場合は，「18.4.7(1) スケジューラーサービスを多重起動する」を参照して設定してください。

(3)　実行系での作業（JP1/AJS2 - Agent）

JP1/Baseの実行系での設定作業をする。
JP1/Baseの作業については，マニュアル「JP1/Base 運用ガイド」を参照してください。

物理ホストをセットアップする。
「13.2.2 JP1/AJS2 - Agentのセットアップ」を参照して，物理ホストをセットアップしてください。

jp1ajs2_setup_clusterコマンドを実行して論理ホストを設定し，共有ディスク上に共有ファイル，共有ディレクトリを作成する。
jp1ajs2_setup_clusterコマンドの入力形式を次に示します。

jp1ajs2_setup_cluster -h 論理ホスト名 [ -d 共有ディレクトリ名]

-hオプションには，JP1/Baseで設定した論理ホスト名を指定します。
-dオプションは，実行系の環境設定時には必ず指定してください。このオプションには，共有ディレクトリと共有ファイルを作成する，共有ディスク上のディレクトリを指定します。共有ディレクトリとして，「指定したディレクトリ名/jp1ajs2/」を作成し，ローカルディスクの定義ファイル（/etc/opt/jp1ajs2/conf/下のファイル）をコピーします。実行するときには，必ず共有ディスクをマウントしておいてください。省略した場合は，待機系の環境設定を行います。

キューレスジョブを利用する場合は，キューレスジョブのセットアップをする。
次のコマンドを実行します。

ajsqlsetup -h 論理ホスト名

これで実行系での作業は終了です。

注意事項

設定は論理ホストごとに実施してください。

(4)　待機系での作業（JP1/AJS2 - Agent）

物理ホストをセットアップする。
物理ホストをセットアップするには次のコマンドを実行します。

/opt/jp1ajs2/bin/jp1ajs2_setup

実行系でのJP1/AJS2，JP1/Base，JP1/IMの作業を完了させたあと，実行系の共通定義情報を退避し，待機系に共通定義情報を設定する。
実行系での作業が完了したあと，実行系でjbsgetcnfコマンドを実行して，共通定義情報を退避します。その退避ファイルを待機系にコピーし，退避ファイルを引数に指定したjbssetcnfコマンドを実行します。実行するコマンドを次に示します。

実行系

   jbsgetcnf -h 論理ホスト名 > 退避ファイル名

待機系

   jbssetcnf 退避ファイル名

JP1/Baseの待機系での作業をする。
JP1/Baseの作業については，マニュアル「JP1/Base 運用ガイド」を参照してください。

jp1ajs2_setup_clusterコマンドを実行して，論理ホストを設定する。
jp1ajs2_setup_clusterコマンドの入力形式を次に示します。

jp1ajs2_setup_cluster -h 論理ホスト名

-hオプションには，JP1/Baseで設定した論理ホスト名を指定します。

キューレスジョブを利用する場合は，キューレスジョブのセットアップをする。
次のコマンドを実行します。

ajsqlsetup -h 論理ホスト名

これで待機系での作業は終了です。

注意事項

設定は論理ホストごとに実施してください。

18.4.3　共通定義情報変更時の作業

クラスタ運用の場合，論理ホストに対するJP1/Base，JP1/AJS2およびJP1/IMの共通定義情報を両系のホスト上で一致させる必要があります。実行系のホストでJP1/Base，JP1/AJS2，JP1/IMの設定が完了後，共通定義情報を変更したあと※に次に示す操作を実行するか，設定を両系のホストで実施して論理ホストの情報を一致させてください。なお，次に示す操作は，JP1/Base，JP1/AJS2およびJP1/IMすべての製品に影響を与えるので注意してください。

実行系

jbsgetcnf -h 論理ホスト名 > 退避ファイル名

待機系

jbssetcnf 退避ファイル名

注※

JP1/AJS2を使用している場合に，JP1/Base，JP1/AJS2およびJP1/IMの共通定義情報が更新されるタイミングを次に示します。

JP1/Baseのjbssetcnfコマンド（定義情報ファイル内の情報をレジストリーに登録するコマンド）で共通定義情報を変更したとき。

JP1/AJS2の次に示すコマンドで，JP1/AJS2の設定を変更したとき。
・jpqregguestuserコマンド
・jpqreguserコマンド

JP1/AJS2の次に示すコマンドで，JP1/AJS2のセットアップを行ったとき。
・jp1ajs2_setupコマンド
・jp1ajs2_setup_clusterコマンド
・ajs2setupコマンド
・ajsembdbsetupコマンド
・jp1ajs2casetupコマンド
・jp1ajs2cmsetupコマンド

JP1/Power Monitorのjaomajs2confsetコマンド（JP1/AJS2と連携して，JP1/AJS2でホストの電源を制御する場合に必要な環境を設定するコマンド）で，JP1/AJS2との連携を設定したとき。

18.4.4　クラスタソフトへの登録

使用するクラスタソフトに，論理ホストのJP1/AJS2サービスを登録してください。登録方法の詳細については，各クラスタソフトのドキュメントを参照してください。また，登録の際は次の点に注意してください。

JP1/AJS2サービスは，使用するIPアドレスおよび共有ディスクと一緒に，実行系から待機系に引き継がれるようにしてください。アプリケーションプログラムも一緒に引き継がれるように設定してください。

IPアドレスおよび共有ディスクが引き継がれ，待機系のJP1/Baseが起動したあとに，JP1/AJS2が起動するようにしてください。

JP1/AJS2 Consoleを使用する場合，JP1/AJS2 Consoleのサービスをクラスタソフトに登録する必要はありません。

クラスタソフトへの登録に必要なJP1/AJS2の情報を次の表に示します。

表18-4　クラスタソフトへの登録に必要なJP1/AJS2の情報

登録する機能
説明

起動
JP1/AJS2を起動します。

使用するコマンド

jajs_start.cluster

使用例

jajs_start.cluster 論理ホスト名

起動コマンドの終了タイミング

起動コマンドは，JP1/AJS2が起動するのを待って終了します。ただし，何らかの問題によってタイムアウト時間（標準60秒）を過ぎても起動処理が完了しない場合は，起動処理の途中でコマンドを終了します。この場合，起動処理は中断しないで処理を続けている状態のままコマンドを終了します。

起動コマンドの結果判定

JP1/AJS2を起動した結果は，後述する動作監視によって判定してください。

jajs_start.clusterコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 2 コマンドリファレンス　1. コマンド　jajs_start.cluster（UNIX限定）」を参照してください。

停止
JP1/AJS2を停止します。

使用するコマンド

jajs_stop.cluster

使用例

jajs_stop.cluster 論理ホスト名

起動コマンドの終了タイミング

停止コマンドは，JP1/AJS2が停止するのを待って終了します。ただし，何らかの問題によってタイムアウト時間（標準60秒）を過ぎても停止処理が完了しない場合は，停止処理の途中でコマンドを終了します。この場合，停止処理は中断しないで処理を続けている状態のままコマンドを終了します。

停止コマンドの結果判定

JP1/AJS2を停止した結果は，後述する動作監視によって判定してください。

jajs_stop.clusterコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 2 コマンドリファレンス　1. コマンド　jajs_stop.cluster（UNIX限定）」を参照してください。

動作監視
JP1/AJS2が正常に動作しているかどうかを監視します。
JP1/AJS2の障害時にフェールオーバーする必要がない場合，この機能は登録しません。

使用するコマンド

jajs_spmd_status

使用例

jajs_spmd_status -h 論理ホスト名

動作監視の結果判定

各戻り値の判定方法を次に示します。

戻り値=0（正常）
JP1/AJS2は正常に動作しています。

戻り値=1（エラー）
回復できないエラーが発生しました。異常と判定してください。

戻り値=4（一部停止）
JP1/AJS2の一部のプロセスが何らかの問題によって停止しています。異常と判定してください。

戻り値=8（すべて停止）
JP1/AJS2のプロセスが何らかの問題によって停止しています。異常と判定してください。

戻り値=12（リトライ可能エラー）
jajs_spmd_statusコマンドによる動作状態の確認中に，リトライによって復旧できるエラーが発生しました。一定回数を限度に，動作状態の確認をリトライしてください。

jajs_spmd_statusコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 2 コマンドリファレンス　1. コマンド　jajs_spmd_status」を参照してください。

強制停止
JP1/AJS2を強制的に停止し，使用中のリソースを解放します。

使用するコマンド

jajs_killall.cluster

使用例

jajs_killall.cluster 論理ホスト名

jajs_killall.clusterコマンドを実行すると，JP1/AJS2の各プロセスを強制的に停止します。停止コマンドを実行しても処理が終了しないなど，問題が発生した場合に限って実行してください。jajs_killall.clusterコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 2 コマンドリファレンス　1. コマンド　jajs_killall.cluster（UNIX限定）」およびマニュアル「JP1/Automatic Job Management System 2 設計・運用ガイド　16.4.1 JP1/AJS2強制停止シェルスクリプト（jajs_killall.cluster）」を参照してください。

18.4.5　キューレスジョブ実行環境の設定

デフォルトでは，キューレスジョブに関する処理は有効になっていません。運用形態に合わせて，jajs_start.clusterコマンドとjajs_stop.clusterコマンドを編集してください。

＜この項の構成＞

(1)　系切り替え時にキューレスエージェントサービスを停止しない運用

(2)　系切り替え時にキューレスエージェントサービスを停止する運用

(3)　注意事項

(1)　系切り替え時にキューレスエージェントサービスを停止しない運用

論理ホストをアタッチ，デタッチして系切り替えを実施します。

物理ホストと論理ホストを同時に使用する場合，または複数の論理ホストを同時に使用する場合は，この設定を適用してください。

(a)　jajs_start.clusterの編集

viなどのエディターで次のファイルを開く。

/etc/opt/jp1ajs2/jajs_start.cluster

ファイルに記述されている，次の網掛け部分を削除する。

ファイルを閉じる。

補足事項

手順2で(1)の「: #」を削除した場合，論理ホストのアタッチに失敗した際にJP1/AJS2サービスの起動処理を中止します。起動処理を継続したい場合は，「: #」を削除しないでください。

(b)　jajs_stop.clusterの編集

viなどのエディターで次のファイルを開く。

/etc/opt/jp1ajs2/jajs_stop.cluster

ファイルに記述されている，次の網掛け部分を削除する。

ファイルを閉じる。

補足事項

手順2で(2)の「: #」を削除した場合，論理ホストのデタッチに失敗した際に，エラーコードとして1を返却します。

手順2で(3)の「: #」を削除した場合，論理ホストのデタッチに失敗した際に，停止処理を中止します。停止処理を継続したい場合は，「: #」を削除しないでください。

手順2の(3)の「: #」を削除する場合，(2)の「: #」も削除してください。

(2)　系切り替え時にキューレスエージェントサービスを停止する運用

キューレスエージェントサービスを停止して，系切り替えを実施します。

論理ホストだけを使用する運用の場合は，この設定を適用してください。

(a)　jajs_start.clusterの編集

viなどのエディターで次のファイルを開く。

/etc/opt/jp1ajs2/jajs_start.cluster

ファイルに記述されている，次の網掛け部分を削除する。

ファイルを閉じる。

補足事項

手順2で(1)の「: #」を削除した場合，論理ホストのアタッチに失敗した際にJP1/AJS2サービスの起動処理を中止します。起動処理を継続したい場合は，「: #」を削除しないでください。

(b)　jajs_stop.clusterの編集

viなどのエディターで次のファイルを開く。

/etc/opt/jp1ajs2/jajs_stop.cluster

ファイルに記述されている，次の網掛け部分を削除する。

ファイルを閉じる

補足事項

手順2で(2)の「: #」を削除した場合，論理ホストのデタッチに失敗した際に，エラーコードとして1を返却します。

手順2で(3)の「: #」を削除した場合，論理ホストのデタッチに失敗した際に，停止処理を中止します。停止処理を継続したい場合は，「: #」を削除しないでください。

手順2の(3)の「: #」を削除する場合，(2)の「: #」も削除してください。

(3)　注意事項

「: #」を削除する前に，内容を確認してください。

バージョンアップインストールの場合は，jajs_start.cluster.modelファイル，およびjajs_stop.cluster.modelファイルをコピーし，運用に合わせて，編集してください。編集したファイルをjajs_start.cluster，jajs_stop.clusterに置き換えてください。

環境設定パラメーターAJSQL_ATTACHの値を「yes」に設定して論理ホストをアタッチする場合，系切り替え時にクラスタソフトなどで系切り替え元のキューレスエージェントサービスを停止し，系切り替え先のキューレスエージェントサービスを起動する必要があります。
このため，物理ホストや系切り替え元のキューレスエージェントサービスにアタッチしているほかの論理ホストで実行していたキューレスジョブが，起動失敗，異常検出終了，または終了状態不明となるおそれがあります。
複数のホストでキューレスジョブを実行する運用の場合は，AJSQL_ATTACHを使用しないで，この設定を使用してください。環境設定パラメーターAJSQL_ATTACHについては，「14.4.3 キューレスジョブ実行環境設定ファイルの環境設定パラメーターの定義内容」を参照してください。

キューレスエージェントサービスから物理ホストをデタッチした状態で論理ホストだけを運用しないでください。
キューレスジョブの起動失敗時に出力するエラーメッセージ，およびジョブ実行時に標準エラー出力に出力した内容がマネージャーホストへ通知されない場合があります。

キューレスジョブ実行内部ログファイルは，物理ホスト，論理ホストに関係なく，ローカルディスク上に作成されます。実行系，および待機系それぞれでキューレスジョブ実行内部ログファイルのサイズを設定してください。
また，キューレスジョブ実行内部ログファイルを共有ディスク上に作成した場合，ログが適切に出力されないおそれがあります。必ずローカルディスク上に作成してください。

18.4.6　論理ホストの削除

論理ホストの削除は，実行系・待機系の両方で実行します。論理ホストの削除手順を次に示します。

＜この項の構成＞

(1)　JP1/AJS2 - Manager

(2)　JP1/AJS2 - Agent

(1)　JP1/AJS2 - Manager

jajs_spmd_stopコマンドを実行して，JP1/AJS2サービスを停止する。
物理ホストのJP1/AJS2マネージャーも含め，すべてのJP1/AJS2サービスを停止してください。

次に示すコマンドを実行して，JP1/AJS2 Monitorサービスを停止する。

ajsinetd_startstop stop

ajsinetd_startstopコマンドのパスは，「/etc/opt/jp1ajs2/ajsinetd_startstop」です。

ajsshmdelコマンドを実行して，共有メモリー情報を削除する。
ajsshmdelコマンドのパスは，「/opt/jp1ajs2/bin/ajsshmdel」です。

（例）shの場合

ajsshmdel >/dev/null 2>&1

（例）cshの場合

ajsshmdel >&/dev/null

環境設定情報から論理ホストを削除する。
JP1/Baseの「jbsunsetcnf -i -h 論理ホスト名」コマンドを実行してください。jbsunsetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。
JP1/Baseを削除しないで，JP1/AJS2だけの論理ホスト上の共通定義情報を削除したい場合は，次に示すコマンドを実行して情報を削除してください。

jbsunsetcnf  -i -h 論理ホスト名 -c JP1AJS2
jbsunsetcnf  -i -h 論理ホスト名 -c JP1NBQAGENT
jbsunsetcnf  -i -h 論理ホスト名 -c JP1NBQMANAGER
jbsunsetcnf  -i -h 論理ホスト名 -c JP1NBQCLIENT
jbsunsetcnf  -i -h 論理ホスト名 -c JP1NBQNOTIFY
jbsunsetcnf  -i -h 論理ホスト名 -c JP1AOMMANAGER
jbsunsetcnf  -i -h 論理ホスト名 -c JP1AOMAGENT
jbsunsetcnf  -i -h 論理ホスト名 -c JP1AJSMANAGER
jbsunsetcnf  -i -h 論理ホスト名 -c JP1AJS2COMMON
jbsunsetcnf  -i -h 論理ホスト名 -c JP1QLAGENT
jbsunsetcnf  -i -h 論理ホスト名 -c JP1AJS2CONSOLEMANAGER

なお上記コマンドの実行時，設定されている情報がない場合は，次のメッセージが出力されることがありますが，無視してください。

KAVA0405-I　The specified -cで指定した文字列 does not exist [論理ホスト名]. Processing Stops.

共有ディスク上の共有ファイルおよびディレクトリを削除する。
jbsunsetcnfコマンドを実行すると，JP1/Base，JP1/IMおよびJP1/AJS2の論理ホスト情報が削除されます。ただし，共有ディスク上の共有ファイルおよび共有ディレクトリは削除されません。手動で削除してください。

JP1/AJS2の物理ホストの共通定義情報をクラスタ未設定の状態に変更する。
すべての論理ホストを削除した場合，次の手順でJP1/AJS2の物理ホストの共通定義情報をクラスタシステム未設定の状態に変更してください。

1. viなどのエディターで構成定義ファイルを作成する。

作成する構成定義ファイルの内容を次に示します。

[JP1_DEFAULT¥JP1NBQAGENT¥Process]

"IsHA"=dword:00000000

[JP1_DEFAULT¥JP1NBQCLIENT¥Process]

"IsHA"=dword:00000000

[JP1_DEFAULT¥JP1NBQMANAGER¥Process]

"IsHA"=dword:00000000

[JP1_DEFAULT¥JP1NBQNOTIFY¥Process]

"IsHA"=dword:00000000

環境設定パラメーターの詳細については，「14.2 ジョブ実行環境の設定」を参照してください。

2. 構成定義ファイルを任意のディレクトリに保存する。

ファイル名の例：jp1ajs2_delete_cluster.txt

3. 次に示すコマンドを実行し，構成定義ファイルの情報を設定する。

jbssetcnf 構成定義ファイル名

jbssetcnfコマンドのパスは，「/opt/jp1base/bin/jbssetcnf」です。

jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

コマンドの指定例を次に示します。

jbssetcnf jp1ajs2_delete_cluster.txt

環境変数としてJP1_HOSTNAMEを設定している場合は削除する。

(2)　JP1/AJS2 - Agent

jajs_spmd_stopコマンドを実行して，JP1/AJS2サービスを停止する。
物理ホストのJP1/AJS2エージェントも含め，すべてのJP1/AJS2サービスを停止してください。

環境設定情報から論理ホストを削除する。
JP1/Baseの「jbsunsetcnf -i -h 論理ホスト名」コマンドを実行してください。jbsunsetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。
JP1/Baseを削除しないで，JP1/AJS2だけの論理ホスト上の共通定義情報を削除したい場合は，次に示すコマンドを実行して情報を削除してください。

jbsunsetcnf  -i -h 論理ホスト名 -c JP1AJS2
jbsunsetcnf  -i -h 論理ホスト名 -c JP1NBQAGENT
jbsunsetcnf  -i -h 論理ホスト名 -c JP1NBQMANAGER
jbsunsetcnf  -i -h 論理ホスト名 -c JP1NBQCLIENT
jbsunsetcnf  -i -h 論理ホスト名 -c JP1NBQNOTIFY
jbsunsetcnf  -i -h 論理ホスト名 -c JP1AOMAGENT
jbsunsetcnf  -i -h 論理ホスト名 -c JP1AJS2COMMON
jbsunsetcnf  -i -h 論理ホスト名 -c JP1QLAGENT

なお上記コマンドの実行時，設定されている情報がない場合は，次のメッセージが出力されることがありますが，無視してください。

KAVA0405-I　The specified -cで指定した文字列 does not exist [論理ホスト名]. Processing Stops.

共有ディスク上の共有ファイルおよびディレクトリを削除する。
jbsunsetcnfコマンドを実行すると，JP1/Base，JP1/IMおよびJP1/AJS2の論理ホスト情報が削除されます。ただし，共有ディスク上の共有ファイルおよび共有ディレクトリは削除されません。手動で削除してください。

JP1/AJS2の物理ホストの共通定義情報をクラスタ未設定の状態に変更する。

1. viなどのエディターで構成定義ファイルを作成する。

作成する構成定義ファイルの内容を次に示します。

[JP1_DEFAULT¥JP1NBQAGENT¥Process]

"IsHA"=dword:00000000

[JP1_DEFAULT¥JP1NBQCLIENT¥Process]

"IsHA"=dword:00000000

[JP1_DEFAULT¥JP1NBQMANAGER¥Process]

"IsHA"=dword:00000000

[JP1_DEFAULT¥JP1NBQNOTIFY¥Process]

"IsHA"=dword:00000000

環境設定パラメーターの詳細については，「14.2 ジョブ実行環境の設定」を参照してください。

2. 構成定義ファイルを任意のディレクトリに保存する。

ファイル名の例：jp1ajs2_delete_cluster.txt

3. 次に示すコマンドを実行し，構成定義ファイルの情報を設定する。

jbssetcnf 構成定義ファイル名

jbssetcnfコマンドのパスは，「/opt/jp1base/bin/jbssetcnf」です。

jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

コマンドの指定例を次に示します。

jbssetcnf jp1ajs2_delete_cluster.txt

環境変数としてJP1_HOSTNAMEを設定している場合は削除する。

18.4.7　論理ホストのスケジューラーサービスの多重起動の設定

スケジューラーサービスの多重起動を設定するためには，まず，追加するスケジューラーサービスの名称などの情報を設定します。次に，そのスケジューラーサービス用のデータベースを新規に作成します。

スケジューラーサービスの多重起動の設定手順，および追加したスケジューラーサービスの削除手順を次に示します。

＜この項の構成＞

(1)　スケジューラーサービスを多重起動する

(2)　追加したスケジューラーサービスを削除する

(1)　スケジューラーサービスを多重起動する

スケジューラーサービスの多重起動の設定手順を次に示します。

(a)　実行系での作業

JP1/AJS2のサービスを停止する。
次のコマンドを実行して，論理ホストのプロセスがすべて停止していることを確認します。

jajs_spmd_stop -h 論理ホスト名
jajs_spmd_status -h 論理ホスト名

次に示すコマンドを実行して，JP1/AJS2 Monitorサービスを停止する。

ajsinetd_startstop stop

ajsinetd_startstopコマンドのパスは，「/etc/opt/jp1ajs2/ajsinetd_startstop」です。

次のファイルをviなどのエディターで開く。

論理ホストの共有ディレクトリ/jp1ajs2/conf/Schedule.conf

Schedule.conf（スケジューラーサービス環境設定ファイル）に書かれている内容の詳細については，「14.1.2 スケジューラーサービス環境設定ファイルの環境設定パラメーター一覧」または「14.1.3 スケジューラーサービス環境設定パラメーターの定義内容」を参照してください。

スケジューラーサービスの多重起動のために必要な項目を追加する。
Schedule.confの[論理ホスト名¥AJSMANAGER¥スケジューラーサービス名]の内容を参考にして，追加するスケジューラーサービスの環境を設定します。設定内容は，ファイルの最後に追加します。
なお，退避情報ディレクトリ（環境設定パラメーターAJSBKUROOTで設定するディレクトリ）以外は，自ホスト内（物理ホストとすべての論理ホスト）に設定されている，ほかのスケジューラーサービスが使用するディレクトリと重複しないようにしてください。また，ほかのスケジューラーサービスが使用するディレクトリの配下にも設定しないでください。

（例）
論理ホスト名が「node0」，論理ホストの共有ディレクトリが「/shdsk/node0」の論理ホストに，「AJSROOT3」という スケジューラーサービスを追加する場合

[node0¥JP1AJSMANAGER¥AJSROOT3]
"AJSBKUROOT"="/shdsk/node0/jp1ajs2/backup/schedule3"
"AJSCHARCODE"="SJIS"
"AJSDBDIRECTORY"="/shdsk/node0/jp1ajs2/database/schedule/AJSROOT3"
"AJSDBTYPE"="ISAM"
"AJSLOG"="all"
"AJSSERVICEID"=dword:00000003
"AJSSYSLOG"="none"
"AJSTMPDIR"="/shdsk/node0/jp1ajs2/tmp/schedule3"
"AUTOSTART"="yes"
"EXECDEFER"="oneday"
"HNTRLOGLEVEL"="error"
"ISAMWRITEMODE"="flush"
"JOBINFDIR"="/shdsk/node0/jp1ajs2/jobinf3"
"JOBLOG"="all"
"JOBSTATUSPORT"="jp1ajs2report3"
"JOBSYSLOG"="none"
"NETLOG"="all"
"NETSYSLOG"="none"
"OPELOG"="all"
"OVERSCHEDULE"="exec"
"RDBAUTHID"=""
"RDBUSER"=""
"SESSIONTIMEOUT"=dword:00000078
"STARTMODE"="warm"
"SUPPRESS"="none"
"SYSLOGCODE"="C"
"TABLENAMEPOSTFIX"=""
"TABLENAMEPREFIX"="AJS"

ファイルを保存し，次のコマンドを実行する。

jbssetcnf 設定ファイル名

jbssetcnfコマンドのパスは，「/opt/jp1base/bin/jbssetcnf」です。
jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

手順3で設定したディレクトリをmkdirコマンドなどで共有ディスクに作成する。

手順3のJOBSTATUSPORTパラメーターに指定したジョブ状態通知ポートのサービス名に対するポート番号を設定する。
/etc/servicesファイルをエディターなどで開き，ポート番号を追加します。このとき，既存のポート番号と重複しないようにしてください。
（例）ポート番号を「20248」として設定する場合

  jp1ajs2report3 20248/tcp

次のコマンドを実行して，追加したスケジューラーサービス用のJP1/AJS2データベースを作成する。

ajssetup -F スケジューラーサービス名 [-mh 論理ホスト名]

（例）
論理ホスト名「node0」に「AJSROOT3」スケジューラーサービスのスケジューラーデータベースを作成する場合

  ajssetup -F AJSROOT3 -mh node0

キューレスジョブを利用する場合は，キューレスジョブのセットアップをする。
次のコマンドを実行します。

  ajsqlsetup -F スケジューラーサービス名 -h 論理ホスト名

組み込みDBを使用する場合は組み込みDBに移行する。
組み込みDBセットアップツール（ajsembdbsetupスクリプト）を使用して，標準データベースを組み込みDBに移行します。
組み込みDBへの移行手順については，「15. スケジューラーデータベースに組み込みDBを使用する場合のセットアップ」を参照してください。

スケジューラーサービスを追加したJP1/AJS2のサービスおよびJP1/AJS2 Monitorサービスを再起動する。
設定した内容でスケジューラーサービスが追加され，起動します。

(b)　待機系での作業

実行系の共通定義情報を待機系に設定する。
実行系での作業が完了したあと，実行系でjbsgetcnfコマンドを実行し，共通定義情報を退避します。その退避ファイルを待機系にコピーし，退避ファイルを引数に指定してjbssetcnfコマンドを実行します。
実行するコマンドを次に示します。
実行系

  jbsgetcnf -h 論理ホスト名 > 退避ファイル名

待機系

  jbssetcnf 退避ファイル名

(a)の実行系での作業の手順7で追加したポート番号を待機系に設定する。
/etc/servicesファイルをエディターなどで開き，ポート番号を追加します。このとき，実行系で設定したポート番号と同じ番号を追加するようにしてください。
（例）ポート番号を「20248」として設定する場合

  jp1ajs2report3 20248/tcp

次に示すコマンドを実行して，JP1/AJS2 Monitorサービスを停止・再起動する。

ajsinetd_startstop stop
ajsinetd_startstop start

ajsinetd_startstopコマンドのパスは，「/etc/opt/jp1ajs2/ajsinetd_startstop」です。

多重起動時のコマンド実行についての補足事項

スケジューラーサービスを多重起動している場合，「-F スケジューラーサービス名」オプションを指定しないでコマンドを実行すると，デフォルトのスケジューラーサービスに対する操作となります。

環境変数AJSCONFにスケジューラーサービス名を指定しておくと，-Fオプションを省略できます。

(2)　追加したスケジューラーサービスを削除する

スケジューラーサービスの削除は，実行系・待機系の両方で実行します。追加したスケジューラーサービスの削除手順を次に示します。

jajs_spmd_stopコマンドを実行して，JP1/AJS2サービスを停止する。
物理ホストのJP1/AJS2マネージャーも含め，すべてのJP1/AJS2サービスを停止してください。

次に示すコマンドを実行して，JP1/AJS2 Monitorサービスを停止する。

ajsinetd_startstop stop

ajsinetd_startstopコマンドのパスは，「/etc/opt/jp1ajs2/ajsinetd_startstop」です。

ajsshmdelコマンドを実行して，共有メモリー情報を削除する。
ajsshmdelコマンドのパスは，「/opt/jp1ajs2/bin/ajsshmdel」です。
（例）shの場合

  /opt/jp1ajs2/bin/ajsshmdel >/dev/null 2>&1

（例）cshの場合

  /opt/jp1ajs2/bin/ajsshmdel >&/dev/null

スケジューラーサービスを追加したときに作成したディレクトリを削除する。

論理ホストの環境設定情報をファイルに退避する。
次に示すコマンドを実行します。

jbsgetcnf -h 論理ホスト名 > 退避ファイル名

jbsgetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

削除するスケジューラーサービスの名称を指定し，環境設定情報から削除する。
次に示すコマンドを実行します。

  jbsunsetcnf -h 論理ホスト名 -c JP1AJSMANAGER -n 削除するスケジューラーサービス名

JP1/AJS2サービスおよびJP1/AJS2 Monitorを起動する。
手順1および手順2で停止したサービスを再起動し，スケジューラーサービスが削除されていることを確認します。

18.4.8　論理ホスト環境のJP1/AJS2の起動および終了を制御する設定

論理ホスト環境のJP1/AJS2サービス（デーモン）の起動および終了時に，JP1/AJS2を制御する設定方法について説明します。

＜この項の構成＞

(1)　キューレスエージェントサービス，キューレスファイル転送サービスの設定

(2)　JP1/AJS2 Check Managerサービス，JP1/AJS2 Check Agentサービスの設定

(3)　JP1/AJS2の起動時にJP1/AJS2のプロセスの状態を出力する設定

(4)　JP1/AJS2の停止時にJP1/AJS2 Monitorサービスを停止する設定

(5)　JP1/AJS2が起動および停止するまでの待ち時間を調整する

(1)　キューレスエージェントサービス，キューレスファイル転送サービスの設定

キューレスエージェントサービス，キューレスファイル転送サービスの起動および停止については，「18.4.5 キューレスジョブ実行環境の設定」を参照してください。

(2)　JP1/AJS2 Check Managerサービス，JP1/AJS2 Check Agentサービスの設定

JP1/AJS2 Check Managerサービス，JP1/AJS2 Check Agentサービスの起動および停止の設定方法について説明します。

(a)　JP1/AJS2 Check Managerサービス，JP1/AJS2 Check Agentサービスの起動を設定する

viなどのエディターで次のファイルを開く。

/etc/opt/jp1ajs2/jajs_start.cluster

ファイルに記述されている，次の網掛け部分を削除する。

ファイルを閉じる。

(b)　JP1/AJS2 Check Managerサービス，JP1/AJS2 Check Agentサービスの停止を設定する

viなどのエディターで次のファイルを開く。

/etc/opt/jp1ajs2/jajs_stop.cluster

ファイルに記述されている，次の網掛け部分を削除する。

ファイルを閉じる。

(3)　JP1/AJS2の起動時にJP1/AJS2のプロセスの状態を出力する設定

JP1/AJS2の起動時にJP1/AJS2のプロセスの状態を出力する設定方法について説明します。

viなどのエディターで次のファイルを開く。

/etc/opt/jp1ajs2/jajs_start.cluster

ファイルに記述されている，次の網掛け部分を削除する。

ファイルを閉じる。

(4)　JP1/AJS2の停止時にJP1/AJS2 Monitorサービスを停止する設定

JP1/AJS2の停止時にJP1/AJS2 Monitorサービスを停止する設定方法について説明します。

viなどのエディターで次のファイルを開く。

/etc/opt/jp1ajs2/jajs_stop.cluster

ファイルに記述されている，次の網掛け部分を削除する。

ファイルを閉じる。

(5)　JP1/AJS2が起動および停止するまでの待ち時間を調整する

(a)　JP1/AJS2が起動するまでの待ち時間を調整する

jajs_start.clusterコマンドは，JP1/AJS2の起動を確認するまで最大で60秒待ちます。ISAMファイル自動再編成機能の設定をした場合などには，JP1/AJS2が60秒以内に起動しないおそれがあります。この場合は，JP1/AJS2の起動を確認するまでの待ち時間を調整する必要があります。

JP1/AJS2の起動時間が140秒掛かる場合を例として，JP1/AJS2の起動を確認するまでの待ち時間の設定方法について説明します。

viなどのエディターで次のファイルを開く。

/etc/opt/jp1ajs2/jajs_start.cluster

ファイルに記述されている，次の網掛け部分を変更する。

ファイルを閉じる。

(b)　JP1/AJS2が停止するまでの待ち時間を調整する

jajs_stop.clusterコマンドは，JP1/AJS2の停止を確認するまで最大で60秒待ちます。JP1/AJS2が60秒以内に停止しない場合は，JP1/AJS2の停止を確認するまでの待ち時間を調整する必要があります。

JP1/AJS2の停止時間が140秒掛かる場合を例として，JP1/AJS2の停止を確認するまでの待ち時間の設定方法について説明します。

viなどのエディターで次のファイルを開く。

/etc/opt/jp1ajs2/jajs_stop.cluster

ファイルに記述されている，次の網掛け部分を変更する。

ファイルを閉じる。

18.5　クラスタ運用時の注意事項

＜この節の構成＞

(1)　JP1/AJS2全体に対する注意事項

(2)　ジョブ実行環境に関する注意事項

(3)　イベント起動に関する注意事項

(4)　キューレスジョブ実行環境に関する注意事項

(5)　定義内容の事前チェック機能に関する注意事項

(1)　JP1/AJS2全体に対する注意事項

クラスタシステムでJP1/AJS2のセットアップを実施する場合は，物理ホストおよび既存の論理ホストで動作しているJP1/AJS2のサービスを必ず停止してください。JP1/AJS2のサービスを停止しないままセットアップを実施した場合，JP1/AJS2のサービスが正しく動作しなくなります。この場合は，サーバを再起動して回復させてください。

JP1/AJS2のスケジューラーデータベース（ISAM），ジョブ実行環境データべース（ISAM），および内部ファイルの二重化はサポートしていません。ミラーディスク，RAIDディスクなどを利用して，ディスクシステム自体で信頼性を確保してください。

クラスタシステムでJP1/AJS2を多重起動する場合，多重起動する論理ホストの数だけ，システムのリソースが必要となります。

クラスタシステム運用時，JP1/AJS2サービスを構成するプロセスが異常終了した場合にサービスの縮退運転をしないで停止することができます。
論理ホスト上のJP1/AJS2サービス起動時に使用するjajs_spmdコマンドに-HAオプションを指定して起動したときは，JP1/AJS2サービスを構成するプロセスが異常終了すると，縮退運転しないで停止します。

JP1/AJS2 Monitorサービス，キューレスエージェントサービス，キューレスファイル転送サービス，JP1/AJS2 Console Managerサービス，JP1/AJS2 Console Agentサービスはマシンに一つのサービスです。しかし，クラスタソフトによる共有ディスクおよび論理IPアドレスの移動に伴い，論理ホストごとに処理を切り分けることで，クラスタシステムに対応しています。

環境変数JP1_HOSTNAMEが設定されている環境で，物理ホストの停止・起動を行う場合は，一時的に環境変数JP1_HOSTNAMEを削除した，シェルなどから実行するようにしてください。なお，自動起動および自動終了する場合の設定については，「14.7.2(8) 環境変数JP1_HOSTNAMEに依存しないJP1/AJS2サービスの自動起動および自動終了を設定する」を参照してください。

論理ホスト対応のJP1/AJS2サービスを停止しても，JP1/AJS2のプロセスが終了しないことがあります。このような場合に強制的にプロセスを終了させたいときは，jajs_killall.clusterコマンドを使用してください。なお，このコマンドを使ったプロセスの強制終了は，正規の方法でJP1/AJS2のプロセスを終了できない場合にだけ使用してください。jajs_killall.clusterコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 2 コマンドリファレンス　1. コマンド　jajs_killall.cluster（UNIX限定）」を参照してください。

(2)　ジョブ実行環境に関する注意事項

クラスタシステム運用時，実行系で実行中のジョブがある状態でデーモンを停止した場合，実行中のジョブは強制終了されてから待機系に移行します。しかし，強制終了されたジョブの状態は，待機系ではすぐには終了状態とは認識されません。数分後に終了状態になります。

JP1/OJE for VOS3と連携するために，jpqreguserコマンドでVOS3ユーザー情報を登録する場合は，実行系ホストおよび待機系ホストの両方にユーザー情報を登録する必要があります。実行系ホストのユーザー情報を追加・変更・削除した場合は，「20. セットアップ時に使用するコマンド　jpqreguser」のクラスタシステムで運用する場合の注意事項に記載している手順に従い，待機系ホストのユーザー情報を追加・変更・削除してください。

(3)　イベント起動に関する注意事項

07-10より前のバージョンで，すでにクラスタシステム運用がセットアップされている環境から，07-10以降にバージョンアップした場合，論理ホストのイベント起動のファイル更新モードは非同期となります。論理ホストのイベント起動のファイル更新モードを同期モードにするには，イベント・アクション定義ファイル（JP1/AJS2 - Manager，またはJP1/AJS2 - Agent）の環境設定パラメーターのファイル更新モード（FileWriteMode）で同期（sync）を設定して，jbssetcnfコマンドで反映してください。また，07-10以降にバージョンアップ後に，クラスタシステム運用のセットアップを行うと，論理ホストのイベント起動のファイル更新モードは同期となります。論理ホストのイベント起動のファイル更新モードを非同期モードにするには，クラスタシステム運用のセットアップ後にイベント・アクション定義ファイル（JP1/AJS2 - Manager，またはJP1/AJS2 - Agent）の環境設定パラメーターのファイル更新モード（FileWriteMode）で非同期（nosync）を設定して，jbssetcnfコマンドで反映してください。

07-10-/Cより前のバージョンで，すでにクラスタシステム運用がセットアップされている環境から，07-10-/C以降にバージョンアップした場合，論理ホストのイベント起動の詳細プロセス終了時オプションは「N」となります。
また，07-10-/Cへバージョンアップ後に，クラスタシステム運用のセットアップを行うと，論理ホストのイベント起動の詳細プロセス終了時オプションは「Y」となります。必要に応じて上記の設定を変更してください。

メールシステム連携およびメッセージキューシステム連携を使用している場合，物理ホストまたは論理ホストのうち，どれか一つのJP1/AJS2だけで連携できます。論理ホストで連携する場合でも，連携機能の環境設定は物理ホストに定義してください。
ただし，UNIXホストでのメールシステム連携でメール受信監視ジョブを実行する場合だけ，イベント・アクション定義ファイル（EVAction.conf）のメールシステム連携機能を使用するかどうかを定義する環境設定パラメーターExecModeを物理ホストで設定してください。
それ以外の環境設定パラメーターは，論理ホストで設定してください。
環境設定パラメーターの詳細については，マニュアル「JP1/Automatic Job Management System 2 連携ガイド　2.3.2 メール受信監視ジョブのための環境設定をする」を参照してください。
なお，メールシステム連携およびメッセージキューシステム連携は多重起動できないため，待機系ではこれらの連携ができません。

(4)　キューレスジョブ実行環境に関する注意事項

キューレスジョブ実行環境に関する注意事項の詳細については，「18.4.5 キューレスジョブ実行環境の設定」を参照してください。

(5)　定義内容の事前チェック機能に関する注意事項

定義内容の事前チェック機能に関する注意事項については，マニュアル「JP1/Automatic Job Management System 2 設計・運用ガイド　8.1.16 本番運用前のJP1/AJS2定義内容のチェックと注意事項」を参照してください。

19.　アンインストール

この章では，JP1/BaseおよびJP1/AJS2のアンインストールについて説明します。

＜この章の構成＞

19.1　JP1/Baseのアンインストール

19.2　JP1/AJS2シリーズプログラムのアンインストール

19.3　組み込みDBのアンインストール

19.1　JP1/Baseのアンインストール

JP1/Baseをアンインストールする場合，自動アンインストール機能を使用してください。JP1/Baseのアンインストール機能を使用すると，統合トレースログ機能（HTNRLib2）もアンインストールされます。

JP1/Baseのアンインストールの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

なお，JP1/Baseは，JP1/AJS2のアンインストール後にアンインストールしてください。JP1/AJS2がアンインストールできなくなることがあります。

19.2　JP1/AJS2シリーズプログラムのアンインストール

この節では，JP1/AJS2シリーズプログラム（JP1/AJS2 - Manager，JP1/AJS2 - Agent）のアンインストール方法を，インストール先ホストのOSごとに説明します。

注意

JP1/AJS2をアンインストールすると，JP1/AJS2のプログラムが削除され，ユーザー環境（データベースや環境設定ファイルなど）そのものも削除されます。そのため，JP1/AJS2をアンインストール後に，新たにJP1AJS2をインストールすると，すべて最初から設定し直す必要があります。
なお，JP1/AJS2を論理ホスト上で構築している場合，アンインストールしても論理ホスト上のユーザー環境（データベースや環境設定ファイルなど）は削除されません。必要に応じて「18.4.6 論理ホストの削除」に記載されている手順に従って，論理ホストを削除してください。

JP1/AJS2のアンインストール前にJP1/Baseがアンインストールされると，JP1/AJS2のアンインストールができません。JP1/AJS2のアンインストール実行前に必ずJP1/Baseがインストールされていることを確認してください。

クラスタ運用を行っている場合は，JP1/AJS2のアンインストールの前にJP1/Baseで論理ホストの削除を実行してください。論理ホストの削除の詳細については，「18.4.6 論理ホストの削除」を参照してください。

JP1/AJS2シリーズプログラムのアンインストールをするときには，次に示すディレクトリ配下から他のディレクトリに移動してください。アンインストール後にディレクトリが残っていた場合は，削除してください。

JP1/AJS2 - Manager
/etc/opt/jp1ajs2，/opt/jp1ajs2，/var/opt/jp1ajs2，/etc/opt/jp1ajs2cm，/opt/jp1ajs2cm，/var/opt/jp1ajs2cm

JP1/AJS2 - Agent
/etc/opt/jp1ajs2，/opt/jp1ajs2，/var/opt/jp1ajs2

組み込みDBのアンインストールについての注意事項

組み込みDBをインストールした場合，組み込みDBをアンインストールしたあと，作成したファイルを手動で削除してください。組み込みDBのアンインストール方法については，「19.3 組み込みDBのアンインストール」を参照してください。

＜この節の構成＞

19.2.1　HP-UXの場合のアンインストール

19.2.2　Solarisの場合のアンインストール

19.2.3　AIXの場合のアンインストール

19.2.4　Linuxの場合のアンインストール

19.2.1　HP-UXの場合のアンインストール

HP-UXの場合のアンインストール手順を説明します。

JP1/AJS2シリーズプログラムをアンインストールするホストにスーパーユーザーでログインするかまたはsuコマンドでユーザーをスーパーユーザーに変更する。

すべてのプログラムを終了する。
既存のJP1シリーズのプログラムが動作している場合，必ず停止しておいてください。

次のコマンドを実行して，Hitachi PP Installerを起動する。

/etc/hitachi_setup

Hitachi PP Installerが起動され，初期画面が表示されます。

初期画面で「D」を入力する。
アンインストールできるプログラムの一覧が表示されます。

アンインストールするJP1/AJS2シリーズプログラムを選択し，「D」を入力する。
選択したプログラムがアンインストールされます。なお，プログラムを選択するには，カーソルを移動させ，スペースバーで選択します。

アンインストールが正常終了したら，「Q」を入力する。
Hitachi PP Installerの初期画面に戻ります。

必要に応じて，JP1/AJS2で作成したユーザーファイルを削除する。

19.2.2　Solarisの場合のアンインストール

Solarisの場合のアンインストール手順を説明します。

JP1/AJS2シリーズプログラムをアンインストールするホストにスーパーユーザーでログインするかまたはsuコマンドでユーザーをスーパーユーザーに変更する。

すべてのプログラムを終了する。
既存のJP1シリーズのプログラムが動作している場合，必ず停止しておいてください。

次のコマンドを実行して，Hitachi PP Installerを起動する。

/etc/hitachi_setup

Hitachi PP Installerが起動され，初期画面が表示されます。

初期画面で「D」を入力する。
アンインストールできるプログラムの一覧が表示されます。

アンインストールするJP1/AJS2シリーズプログラムを選択し，「D」を入力する。
選択したプログラムがアンインストールされます。なお，プログラムを選択するには，カーソルを移動させ，スペースバーで選択します。

アンインストールが正常終了したら，「Q」を入力する。
Hitachi PP Installerの初期画面に戻ります。

必要に応じて，JP1/AJS2で作成したユーザーファイルを削除する。

19.2.3　AIXの場合のアンインストール

AIXの場合のアンインストール手順を説明します。

JP1/AJS2シリーズプログラムをアンインストールするホストにスーパーユーザーでログインするかまたはsuコマンドでユーザーをスーパーユーザーに変更する。

すべてのプログラムを終了する。
既存のJP1シリーズのプログラムが動作している場合，必ず停止しておいてください。

次のコマンドを実行して，Hitachi PP Installerを起動する。

/etc/hitachi_setup

Hitachi PP Installerが起動され，初期画面が表示されます。

初期画面で「D」を入力する。
アンインストールできるプログラムの一覧が表示されます。

アンインストールするJP1/AJS2シリーズプログラムを選択し，「D」を入力する。
選択したプログラムがアンインストールされます。なお，プログラムを選択するには，カーソルを移動させ，スペースバーで選択します。

アンインストールが正常終了したら，「Q」を入力する。
Hitachi PP Installerの初期画面に戻ります。

必要に応じて，JP1/AJS2で作成したユーザーファイルを削除する。

19.2.4　Linuxの場合のアンインストール

Linuxの場合のアンインストール手順を説明します。

JP1/AJS2シリーズプログラムをアンインストールするホストにスーパーユーザーでログインするかまたはsuコマンドでユーザーをスーパーユーザーに変更する。

すべてのプログラムを終了する。
既存のJP1シリーズのプログラムが動作している場合，必ず停止しておいてください。

次のコマンドを実行して，Hitachi PP Installerを起動する。

/etc/hitachi_setup

Hitachi PP Installerが起動され，初期画面が表示されます。

初期画面で「D」を入力する。
アンインストールできるプログラムの一覧が表示されます。

アンインストールするJP1/AJS2シリーズプログラムを選択し，「D」を入力する。
選択したプログラムがアンインストールされます。なお，プログラムを選択するには，カーソルを移動させ，スペースバーで選択します。

アンインストールが正常終了したら，「Q」を入力する。
Hitachi PP Installerの初期画面に戻ります。

必要に応じて，JP1/AJS2で作成したユーザーファイルを削除する。

19.3　組み込みDBのアンインストール

組み込みDBのアンインストール手順を次に示します。

組み込みDBが稼働中かどうかをajsembdbstatusコマンドで確認する。

組み込みDBが稼働中の場合は，組み込みDBをajsembdbstopコマンドで正常終了させる。

ajsembdbunsetコマンドを実行して，組み込みDBのOSへの登録を解除する。

アンインストールを実行する。
組み込みDBをアンインストールするときは，Hitachi PP Installerを使います。

20.　セットアップ時に使用するコマンド

この章では，JP1/AJS2のセットアップ時に使用するコマンドを説明します。

JP1/AJS2のコマンドの記述形式および文法規則はWindowsとUNIXで共通です（ただし，使用できるコマンド，指定できるオプションが，Windowsで実行する場合とUNIXで実行する場合とで異なることもあります）。

Windowsの場合，コマンドプロンプトからコマンドを実行します。また，JP1/Scriptを使用して，JP1/AJS2のコマンド用スクリプトファイルを作成することもできます。JP1/Scriptで作成したスクリプトファイルを使用すると，スクリプト処理の開始時刻を指定したり，システムの起動時にスクリプトを自動的に実行させたりできます。JP1/Scriptについては，マニュアル「JP1/Script（Windows(R)用）」を参照してください。

UNIXの場合，制御端末からコマンドを実行します。

＜この章の構成＞

コマンドの記述形式

環境変数一覧

セットアップ時に使用するコマンド一覧

ajs_adapter_setup

ajscasetup（Windows限定）

ajschksetup

ajscmsetup（Windows限定）

ajscvsetup

ajsembdbbuild

ajsembdbrpsetup

ajsembdbidlist

ajsembdbsetup

ajsembdbunset

ajsembdbvrupd

ajsovsetup

ajsqlsetup

ajssetup

ajssosetup

ajswoarelsetup

jp1ajs2_setup（UNIX限定）

jp1ajs2_setup_cluster（UNIX限定）

jp1ajs2casetup（UNIX限定）

jp1ajs2cmsetup（UNIX限定）

jpomailrecv（UNIX限定）

jpqexport

jpqimport

jpqregguestuser

jpqreguser

jpqshmake（UNIX限定）

コマンドの記述形式

ここでは，コマンドの記述形式として，コマンドの指定方法と，コマンドの文法の説明に使用する記号について説明します。

コマンドの指定方法

コマンドの指定形式を次に示します。

(1)を「オプション」と呼びます。(2)を「引数」と呼びます。

次に，引数の指定方法を説明します。

最初にオプションを指定し，次にジョブネットワーク要素名などの任意名を指定します。オプションの前に任意名を指定すると，システムは指定内容をすべて任意名として処理します。

オプションを複数指定する場合，指定順序は任意です。

一つのオプションに対し，値を複数指定する場合は，値間を「,（コンマ）」で区切ります。

値のないオプションは連続して指定できます。

（例）

「-a-b-c」を，「-abc」と指定できます。

値のない2バイトのオプションは，連続して指定できません。

（例）

「-a-ab」を，「-aab」と指定したり，「-cd -cf」を，「-cdcf」と指定したりすることはできません。

オプションを連続して指定する場合，最後のオプションには値を指定できます。

（例）

「-abc xyz」の「xyz」は，オプションcの値となります。

値を持たないオプションに値を指定した場合，システムはその値以降をすべて任意名として処理します。

期待しないオプションを指定した場合，エラーになります。

任意名にユニット名を指定する場合の注意事項については，後述の「ユニット名の指定方法」を参照してください。

任意名に総称名を指定する場合の注意事項については，後述の「総称名の指定方法」を参照してください。

最初の任意名（上記のコマンド指定例の場合，「任意名X」）に「-」で始まる文字列を指定したい場合は，「--△₁任意名X」と指定します（システムは，--△₁以降を任意名として処理します）。なお，2番目以降の任意名には，--△₁の指定は不要です。

（例）

二つの任意名（「-jobA」および「-jobB」）を続けて指定する場合は，「-- -jobA -jobB」と指定します。

任意名には正規表現が使用できます。

期待する数以上の任意名を指定した場合，エラーになります。

引数に指定する文字は，大文字・小文字が区別されます。大文字・小文字の使い分けに注意してください。

ユニット名の指定方法

コマンド引数の任意名としてユニット名を指定する方法について説明します。

ユニット名の指定形式を次に示します。

論理ホスト名を指定できるコマンドの場合（他ホストのユニットにリモートアクセスする場合）

[[論理ホスト名:][スケジューラーサービス名]:]ジョブネットワーク要素名[:@実行ID]

論理ホスト名を指定できないコマンドの場合（自ホストのユニットにローカルアクセスする場合）

[[スケジューラーサービス名]:]ジョブネットワーク要素名[:@実行ID]

次に，各項目について説明します。

論理ホスト名

論理ホスト名を指定できるコマンドと，指定できないコマンドがあります。詳細は各コマンドの説明を参照してください。

自ホスト内に複数の論理ホスト名を持つ場合，スケジューラーサービス名と環境変数JP1_HOSTNAMEの指定によって該当する論理ホスト名が特定されます。したがって，論理ホスト名を指定する必要はありません。指定した場合，自ホスト内であってもTCP/IPプロトコルによる通信が発生するため，認証の設定が必要になります。

論理ホスト名を省略した場合，指定したスケジューラーサービス名の先頭に環境変数AJSMANAGERHOSTの内容が補われます。

環境変数AJSMANAGERHOSTを設定していない場合，自ホスト内として扱われ，環境変数JP1_HOSTNAMEに指定した論理ホスト名のサービスとします。

環境変数JP1_HOSTNAMEを指定していない場合，JP1/Baseの環境設定で定義した，自ホストの論理ホスト名が仮定されます。なお，「論理ホスト名」に「JP1_HOSTNAME_DEFAULT」が設定されている場合，システムのホスト名（gethostname）が仮定されます。

スケジューラーサービス名

スケジューラーサービス名を省略した場合，-Fオプションに指定したスケジューラーサービス名が仮定されます。-Fオプションを省略した場合，指定したジョブネットワーク要素名の先頭に環境変数AJSCONFの内容が補われます。環境変数AJSCONFを設定していない場合は，デフォルトのスケジューラーサービス名が仮定されます。

ジョブネットワーク要素名

ジョブネットワーク要素名には，ジョブグループ名，ジョブネット名，ジョブ名を指定します。これらは完全名で指定することもできます。

完全名は，先頭が「/」で，ルートジョブグループからそのジョブネットワーク要素までの名称を「/」で区切って指定したものです。ジョブネットワーク要素の完全名は，JP1/AJS2の中で一意に管理されています。

ジョブネットワーク要素名を完全名で指定しなかった場合，指定した名称の先頭に環境変数AJSPATHの内容が補われます。環境変数AJSPATHを設定していない場合は，指定した名称の先頭に「/」が補われます。

実行ID

実行IDを指定できるコマンドと，指定できないコマンドがあります。詳細は各コマンドの説明を参照してください。

実行IDは，ジョブネットを登録するとき，最上位ジョブネットの実行予定の一つに対して一つ割り振られる番号のことで，JP1/AJS2 - Viewやajsshowコマンドで確認できます。実行IDを指定できるコマンドで，実行IDの指定を省略すると，各コマンドが操作の対象とする世代を自動的に判定します。ジョブネットの世代の自動判定については，マニュアル「JP1/Automatic Job Management System 2 解説　4.2 ジョブネットの世代管理」を参照してください。

総称名の指定方法

任意名を指定する場合に，総称名（「*」や「?」など）で指定できる場合があります。

例えば，ジョブネット（net1）中にジョブ（job1，job2，job3，job4）が定義されている場合，ジョブネット（net1）中のすべてのジョブを操作対象にしたいときは，「net1/*」と指定できます。

任意名に総称名を指定できる場合と，できない場合があります。詳細は各コマンド，ジョブの説明を参照してください。

コマンドの文法の説明に使用する記号

コマンドの文法の説明に使用する記号を次の表に示します。

表20-1　コマンドの文法の説明に使用する記号

記号
意味と例

|
（ストローク）
複数の項目に対して項目間の区切りを示し，「または」の意味を示します。

（例）

「A|B|C」は，「A，B，またはC」を示します。

{　}
（波括弧）
この記号で囲まれている複数の項目の中から，一組の項目を必ず選択します。項目と項目の区切りは「|」で示します。

（例）

「{A|B|C}」は，「A，B，またはCのどれかを必ず指定する」ことを示します。

[　]
（角括弧）
この記号で囲まれている項目は，任意に指定できます（省略できます）。

（例）

「[A]」は，「必要に応じてAを指定する」ことを示します（必要でない場合は，Aを省略できます）。

「[B|C]」は，「必要に応じてB，またはCを指定する」ことを示します（必要でない場合は，BおよびCを省略できます）。

...
（点線）
この記号の直前に示された項目を繰り返して複数指定できます。なお，項目を複数指定する場合は，項目の区切りに1バイトの空白文字（半角スペース）を使用します。

（例）

「A B...」は，「Aのあとに，Bを複数指定できる」ことを示します。

_
（下線）
括弧で囲まれているすべての項目を省略したときに，システムが採用する値を示します。

（例）

「[A|B]」は，「AおよびBを指定しなかった場合，システムはAを採用する」ことを示します。

コマンド共通の注意事項

デーモンの文字コードと異なる文字コードでコマンドを実行すると，統合トレースログにそれぞれの文字コードでメッセージが出力されます。

コマンド実行時の環境変数

論理ホストのJP1/AJS2サービスに対するコマンドを実行する場合は，環境変数JP1_HOSTNAMEに論理ホスト名を指定してください。

ジョブネットやジョブを操作するコマンドでは，ジョブネットワーク要素のアクセス権限を，コマンド実行時のOSユーザー名で判断します。OSユーザー名とJP1ユーザー名が異なる場合は，環境変数JP1_USERNAMEにJP1ユーザー名を設定してください。

コマンド実行時に使用される環境変数については，表20-2を参照してください。

環境変数一覧

JP1/AJS2のコマンド実行時に使用される環境変数を示します。

JP1/AJS2のコマンド実行時に使用される環境変数

コマンド実行時に使用される環境変数を次に示します。

表20-2　コマンド実行時に使用される環境変数の一覧

環境変数名
内容
参照契機

AJSMANAGERHOST
操作先ホストの論理ホスト名
ジョブネットワーク要素を操作するコマンド※，およびajsstatusコマンドで，オブジェクト名指定時に論理ホスト名が省略された場合。

JP1_HOSTNAME
自ホストの論理ホスト名
JP1/AJS2が自ホストの論理ホスト名を参照する場合。
または，コマンド実行時に操作対象の論理ホストを参照する場合（コマンドのオプションとして，論理ホスト名を指定しなかった場合）。

AJSCONF
スケジューラーサービス名
オブジェクト名指定時に，スケジューラーサービス名が省略され，かつ，-Fオプションのスケジューラーサービス名が省略された場合。

AJSPATH
AJSパス名
ジョブネットワーク要素を操作するコマンド※に，ユニット名が完全名で指定されなかった場合（ジョブグループ名として利用します）。

JP1_USERNAME
JP1ユーザー名
ジョブネットワーク要素を操作するコマンド※でユーザーのアクセス権限取得時に，OSのユーザー名と異なるJP1ユーザー名を利用する場合。

LANG
言語種別
出力するテキストの言語種別を切り分ける場合。
Windowsの場合はホストの設定に依存するため，利用されません。
ジョブネットワーク要素を操作するコマンド※を実行する場合，コマンドの実行対象ユニットが定義されているスケジューラーサービスのAJSCHARCODEパラメーターの設定と同じ言語種別を設定してください。

TZ
タイムゾーン
スケジュールを計算する場合や，日時を表示する場合。

注※

「ジョブネットワーク要素を操作するコマンド」については，マニュアル「JP1/Automatic Job Management System 2 コマンドリファレンス　1. コマンド　コマンド一覧」を参照してください。

環境変数には，JP1/AJS2で設定されるもの（ジョブ実行時に設定される環境変数，ジョブ定義時に指定した環境変数，ジョブ定義時に環境変数ファイルとして指定したファイル内の環境変数）のほかに，ジョブ定義時に指定したコマンド文やスクリプトファイル，ローカルログインスクリプト，システムログインスクリプトにも設定できます。これらの中で同じ環境変数があった場合，次に示す優先順位に従って有効になります（優先順位がいちばん高いのは1です）。

Windowsの場合

環境変数※1に指定した環境変数

環境変数ファイル※2に指定した環境変数

システム環境変数

UNIXの場合

ジョブ定義時に指定したコマンドやスクリプトファイルでの定義

ローカルログインスクリプトでの定義

システムログインスクリプトでの定義

環境変数※1に指定した環境変数

環境変数ファイル※2に指定した環境変数

注※1

JP1/AJS2 - Viewの画面の環境変数に指定した変数，またはjpqjobsubコマンドの-envオプションに指定した変数

注※2

JP1/AJS2 - Viewの画面の環境変数ファイルに指定した変数，またはjpqjobsubコマンドの-evオプションに指定した変数ファイル

セットアップ時に使用するコマンド一覧

この節では，JP1/AJS2をセットアップするために使用するコマンドの一覧を次の表に示します。

各コマンドの詳細説明は，次の節以降にアルファベット順に記載しています。Windowsの場合だけ使用できるコマンド，UNIXの場合だけ使用できるコマンドがあります。注意してください。

表20-3　セットアップに使用するコマンドの一覧

機能
コマンド名
Windows
UNIX
必要な実行権限
提供している製品

JP1/AJS2のインストール後，実行環境を設定する。
jp1ajs2_setup※1
－
○
UNIX：
スーパーユーザー
M,A

JP1/AJS2 - Manager，およびJP1/AJS2 - Agentの論理ホストに対応した動作環境をセットアップする。
jp1ajs2_setup_cluster※1
－
○
UNIX：
スーパーユーザー
M,A

スケジューラーサービスが使用するデータベースをセットアップする。
サスペンド機能をセットアップする。
ajssetup
○
○
Windows：
Administrators
UNIX：
スーパーユーザー
M

既存のISAMデータベースを組み込みDBに移行する。
ajsembdbsetup
○
○
Windows：
Administrators
UNIX：
スーパーユーザー
M

組み込みDBの設定およびJP1/AJS2用領域を作成する。
ajsembdbbuild
○
○
Windows：
Administrators
UNIX：
スーパーユーザー
M

JP1/AJS2 - ManagerをJP1/AJS2 - Datareplicator運用用にセットアップする。
ajsembdbrpsetup
○
○
Windows：Administrators
UNIX：スーパーユーザー
M

組み込みDBをアンセットアップする。
ajsembdbunset
○
○
Windows：Administrators
UNIX：スーパーユーザー
M

メール配信機能を設定する。
jpomailrecv
－
○
なし
M,A

現時点でのジョブ実行環境をファイルに出力する。
jpqexport
○
○
Windows：
Administrators
UNIX：
スーパーユーザー
M

ジョブ実行環境構成定義ファイル（jpqsetup.conf）を使用して，ジョブ実行環境（ジョブ実行エージェント，キュー，および排他実行リソース）を一括定義する。
jpqimport
○
○
Windows：
Administrators
UNIX：
スーパーユーザー
M

JP1ユーザーとして仮定したユーザーの情報を登録する。
jpqregguestuser※1
○
○
Windows：
Administrators
UNIX：
スーパーユーザー
M

VOS3ユーザーのユーザー情報を登録する。
jpqreguser※1
○
○
なし
（Windows Server 2008の場合，-aオプション指定時以外はAdministrators）
M,A

共有メモリーのセグメント数の増加を抑止
jpqshmake※2
－
○
UNIX：
スーパーユーザー
M,A

キューレスジョブ実行環境をセットアップする。
ajsqlsetup
○
○
Windows：
Administrators
UNIX：
スーパーユーザー
M,A

JP1/AJS2 Console Managerのセットアップをする。
ajscmsetup
○
－
Windows：
Administrators
M

JP1/AJS2 Console Agentのセットアップをする。
ajscasetup
○
－
Windows：
Administrators
M

JP1/AJS2 Console Viewのセットアップをする。
ajscvsetup
○
－
Windows：
Administrators
V

JP1/AJS2 Console Managerのセットアップをする。
jp1ajs2cmsetup※1
－
○
UNIX：
スーパーユーザー
M

JP1/AJS2 Console Agentのセットアップをする。
jp1ajs2casetup※1
－
○
UNIX：
スーパーユーザー
M

JP1/IMと連携するためのアダプターコマンド設定ファイルを作成または削除する。
ajs_adapter_setup
○
○
Windows：
Administrators
UNIX：
スーパーユーザー
M

JP1/Cm2またはhp OpenViewの登録ファイルを設定する。
ajsovsetup※3
○
○
Windows：
Administrators
UNIX：
スーパーユーザー
M,A,V

スケジューラーサービスをJP1/AJS2 - Web Operation Assistantから一括監視させる設定をする。
ajswoarelsetup
○
○
Windows：Administrators権限
UNIX：
スーパーユーザー権限
M

JP1/AJS2定義内容の事前チェック機能の実行環境を設定する。
ajschksetup
○
○
Windows：Administrators権限
UNIX：
スーパーユーザー権限
M,A

JP1/AJS2 - Scenario Operationとの連携機能をセットアップする。
ajssosetup
○
○
Windows：Administrators権限
UNIX：
スーパーユーザー権限
M

（凡例）

○：提供している。

－：提供していない。

M：JP1/AJS2 - Manager

A：JP1/AJS2 - Agent

V：JP1/AJS2 - View

注※1

JP1/Baseを前提とするJP1シリーズの製品の稼働中には，このコマンドを実行しないでください。

注※2

JP1/AJS2 06-71-/G以前のバージョンからバージョンアップインストールした場合，セットアップ後に一度実行すれば，その後は実行する必要はありません。また，新規インストール時は実行する必要はありません。

注※3

Windows Server 2008およびWindows Server 2008（IPF）では提供していません。

ajs_adapter_setup

形式

ajs_adapter_setup
    {-i|-u}

機能

JP1/IMと連携するためのアダプターコマンド設定ファイル（Adapter_HITACHI_JP1_AJS2.conf）を作成または削除します。

実行権限

Windowsの場合：Administrators権限

UNIXの場合：スーパーユーザー権限

引数

-i

アダプターコマンド設定ファイルをアダプターコマンド設定ファイル格納先に作成します。このオプションを設定すると，JP1/IMがJP1/AJS2の定義情報を収集できるようになります。

-u

アダプターコマンド設定ファイルをアダプターコマンド設定ファイル格納先から削除します。

アダプターコマンド設定ファイル格納先

Windowsの場合

JP1/Baseのインストール先フォルダ¥plugin¥conf¥

UNIXの場合

/opt/jp1base/plugin/conf/

注意事項

JP1/Baseがインストールされていない（アダプターコマンド設定ファイルの作成先のパスがない）場合，-iオプションでアダプターコマンド設定ファイルの作成を実行してもアダプターコマンド設定ファイルの作成は行われません。

オプションを省略した場合，-iが仮定されます。

クラスタシステムでJP1/IMと連携してJP1/AJS2の定義情報を収集する場合，実行系と待機系の両方のシステムでこのコマンドを実行してください。

Windows Server 2008のマシンでこのコマンドを実行する際には，コマンドプロンプトを管理者として起動する必要があります。コマンドプロンプトを起動する際は，Windowsの［スタート］メニューの［コマンドプロンプト］を右クリックし，ショートカットメニューから［管理者として実行］を選択してください。なお，UAC機能が無効の場合は，コマンドプロンプトを管理者として起動する必要はありません。

戻り値

0 | 正常終了。
0以外の値 | 異常終了。

ajscasetup（Windows限定）

形式

ajscasetup
    [-i|-u]

機能

JP1/AJS2 Console Agentを使用するかどうかを設定します。このコマンドを実行すると，JP1/AJS2 Console Agentサービスを追加，または削除します。

実行権限

Administrators権限

格納先ディレクトリ

JP1/AJS2 - Managerのインストール先フォルダ¥bin¥

引数

-i

JP1/AJS2 Console Agentを使用できるようにします（JP1/AJS2 Console Agentサービスを追加します）。

-u

JP1/AJS2 Console Agentを使用できないようにします（JP1/AJS2 Console Agentサービスを削除します）。

注意事項

このコマンドはWindowsだけで実行できます。UNIXでは実行できません。

JP1/AJS2 - Managerをインストールした直後は，JP1/AJS2 Console Agentは使用できない状態です。JP1/AJS2 Console Agentを使用する場合は，必ずこのコマンドを実行し，使用できる状態にしてください。

Windows Server 2008のマシンでこのコマンドを実行する際には，コマンドプロンプトを管理者として起動する必要があります。コマンドプロンプトを起動する際は，Windowsの［スタート］メニューの［コマンドプロンプト］を右クリックし，ショートカットメニューから［管理者として実行］を選択してください。なお，UAC機能が無効の場合は，コマンドプロンプトを管理者として起動する必要はありません。

戻り値

0 | 正常終了。
0以外の値 | 異常終了。

補足事項

このコマンドのメッセージは英文で出力されます。

ajschksetup

形式

JP1/AJS2 - Managerの場合

ajschksetup
    [{[-m][-a]|[-u]}]

JP1/AJS2 - Agentの場合

ajschksetup
    [{[-a]|[-u]}]

機能

定義内容の事前チェック機能の実行環境を設定します。このコマンドによって設定される情報を次に示します。

サービスの登録

定義内容の事前チェック機能の実行で使用する次のサービスを登録します。

登録するサービス名 | JP1/AJS2 - Manager | JP1/AJS2 - Agent
JP1/AJS2 Check Managerサービス | ○ | －
JP1/AJS2 Check Agentサービス | ○ | ○

通信ポートの設定

定義内容の事前チェック機能の実行で使用する次の通信ポートをservicesファイルに登録します。

通信ポート（サービス名：ポート番号） | JP1/AJS2 - Manager | JP1/AJS2 - Agent
定義内容の事前チェック機能の実行（JP1/AJS2 Check Manager：23138） | ○ | －
定義内容の事前チェック機能の実行（JP1/AJS2 Check Agent：23139） | ○ | ○

構成定義情報の設定

定義内容の事前チェック機能の実行で使用する構成定義情報を設定します。

設定情報
JP1/AJS2 - Manager
JP1/AJS2 - Agent

定義キー
環境設定
パラメーター

[JP1_DEFAULT¥JP1AJS2¥CHECK]

Windows
"AJSCHK_CHECKFILE"=JP1/AJS2 - Managerのインストール先フォルダ¥log¥ajscheckfile.txt

UNIX
"AJSCHK_CHECKFILE"=/var/opt/jp1ajs2/log/ajscheckfile.txt

○
－

Windows
"AJSCHK_LOGDIR"=JP1/AJS2 - ManagerおよびJP1/AJS2 - Agentのインストール先フォルダ¥log

UNIX
"AJSCHK_LOGDIR"=/var/opt/jp1ajs2/log

○
○

"AJSCHK_LOGSIZE"=dword:00001000
○
○

Windows
"AJSCHK_TRACELOGFILE"=JP1/AJS2 - ManagerおよびJP1/AJS2 - Agentのインストール先フォルダ¥log¥tracelog.ch

UNIX
"AJSCHK_TRACELOGFILE"=/var/opt/jp1ajs2/log/tracelog.ch

○
○

"AJSCHK_CHARCODE"={none|C|SJIS|EUC|UTF-8※}
○
○

（凡例）

○：設定できる。

－：設定できない。

注※

UTF-8文字コードはLinuxのJP1/AJS2 - Agentでだけ指定できます。

実行権限

Windowsの場合：Administrators権限

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

JP1/AJS2 - Managerのインストール先フォルダ¥bin¥

JP1/AJS2 - Agentのインストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1ajs2/bin/

引数

-m

JP1/AJS2 - Managerの定義内容の事前チェック機能をセットアップします。

JP1/AJS2 - Managerの場合だけ指定できます。JP1/AJS2 - Agentでは指定できません。

-uオプションとは同時に指定できません。

-a

JP1/AJS2 - Agentの定義内容の事前チェック機能をセットアップします。

-uオプションとは同時に指定できません。

-u

定義内容の事前チェック機能の設定を削除します。

Windowsの場合，管理ツールのサービス一覧からJP1/AJS2 Check Managerサービス，およびJP1/AJS2 Check Agentサービスを削除します。

-m，-aオプションとは同時に指定できません。

注意事項

Windows環境で-uオプションを指定してサービスを削除する場合，JP1/AJS2 Check Managerサービス，およびJP1/AJS2 Check Agentサービスが停止している状態で実行してください。

設定の種別を示すオプション（-m，-a，-u）を省略した場合，次のオプションが仮定されます。

JP1/AJS2 - Managerの場合：-m，-a

JP1/AJS2 - Agentの場合：-a

Windows Server 2008のマシンでこのコマンドを実行する際には，コマンドプロンプトを管理者として起動する必要があります。コマンドプロンプトを起動する際は，Windowsの［スタート］メニューの［コマンドプロンプト］を右クリックし，ショートカットメニューから［管理者として実行］を選択してください。なお，UAC機能が無効の場合は，コマンドプロンプトを管理者として起動する必要はありません。

戻り値

0 | 正常終了。
0以外の値 | 異常終了。

使用例

JP1/AJS2 - Managerで，JP1/AJS2 Check ManagerサービスおよびJP1/AJS2 Check Agentサービスをセットアップします。

ajschksetup -m -a

ajscmsetup（Windows限定）

形式

ajscmsetup
    [-i|-u]

機能

JP1/AJS2 Console Managerを使用するかどうかを設定することによって，JP1/AJS2 Console Managerサービスを追加または削除します。

実行権限

Administrators権限

格納先ディレクトリ

JP1/AJS2 Consoleのインストール先フォルダ¥bin¥

引数

-i

JP1/AJS2 Console Managerが使用できるようにします（JP1/AJS2 Console Managerサービスを追加します）。

-u

JP1/AJS2 Console Managerが使用できないようにします（JP1/AJS2 Console Managerサービスを削除します）。

注意事項

このコマンドはWindowsだけで実行できます。UNIXでは実行できません。

JP1/AJS2 - Managerをインストールした直後は，JP1/AJS2 Console Managerは使用できない状態です。JP1/AJS2 Console Managerを使用する場合は，必ずこのコマンドを実行し，使用できる状態にしてください。

Windows Server 2008のマシンでこのコマンドを実行する際には，コマンドプロンプトを管理者として起動する必要があります。コマンドプロンプトを起動する際は，Windowsの［スタート］メニューの［コマンドプロンプト］を右クリックし，ショートカットメニューから［管理者として実行］を選択してください。なお，UAC機能が無効の場合は，コマンドプロンプトを管理者として起動する必要はありません。

戻り値

0 | 正常終了。
0以外の値 | 異常終了。

ajscvsetup

形式

ajscvsetup
    [-i|-u]

機能

JP1/AJS2 Console Viewを使用するかどうかを設定します。このコマンドを実行すると，次のことが実施されます。

Windowsの［スタート］メニューにJP1/AJS2 Console Viewのショートカットを作成，または削除する。

JP1/IM - Viewがインストールされているときは，JP1/IM - Viewの［統合機能メニュー］画面にJP1/AJS2 Console Viewのノードを追加，または削除する。

実行権限

Administrators権限

格納先ディレクトリ

JP1/AJS2 - Viewのインストール先フォルダ¥bin¥

引数

-i

Windowsの［スタート］メニューにJP1/AJS2 Console Viewのショートカットを作成します。この引数を指定してコマンドを実行すると，［スタート］－［プログラム］－［JP1_Automatic Job Management System 2 - View］に［業務監視］というショートカットが追加されます。

JP1/IM - Viewがインストールされているときは，JP1/IM - Viewの［統合機能メニュー］画面にJP1/AJS2 Console Viewのノードを追加します。
この引数を指定してコマンドを実行すると，［統合機能メニュー］画面のツリーエリアで［統合管理］－［ジョブシステム運用］－［業務監視］というノードが追加されます。

-u

Windowsの［スタート］メニューからJP1/AJS2 Console Viewのショートカットを削除します。

JP1/IM - Viewがインストールされているときは，JP1/IM - Viewの［統合機能メニュー］画面からJP1/AJS2 Console Viewのノードを削除します。

注意事項

JP1/AJS2 - Viewをインストールした直後は，JP1/AJS2 Console Viewは使用できない状態です。JP1/AJS2 Console Viewを使用する場合は，必ずこのコマンドを実行し，使用できる状態にしてください。
セットアップしないでajscon.exeを実行し，JP1/AJS2 Console Viewを起動すると，次のメッセージが表示されます。
「KAVC4016-E セットアップがされていないためJP1/AJS2 Console Viewは使用できません。」

JP1/AJS2 - Viewのインストール後に，［スタート］－［プログラム］で表示される，JP1/AJS2 - Viewのメニューの位置や名称を変更した場合は，［スタート］メニューにJP1/AJS2 Console Viewのショートカットが作成されません。その場合は，ajsconコマンドでJP1/AJS2 Console Viewを起動してください。

Windows VistaおよびWindows Server 2008のマシンでこのコマンドを実行する際には，コマンドプロンプトを管理者として起動する必要があります。コマンドプロンプトを起動する際は，Windowsの［スタート］メニューの［コマンドプロンプト］を右クリックし，ショートカットメニューから［管理者として実行］を選択してください。なお，UAC機能が無効の場合は，コマンドプロンプトを管理者として起動する必要はありません。

戻り値

0 | 正常終了。
0以外の値 | 異常終了。

ajsembdbbuild

形式

ajsembdbbuild
    [-l|-m|-s]
    {
     {-d 組み込みDBデータ領域ディレクトリ
       [,システム領域ディレクトリ1
        [,システム領域ディレクトリ2]] |
      -a ajssys01=データ領域パーティション
       ,ajssys11=システム領域パーティション1
        [,ajssys17=システム領域パーティション2]
         -d 組み込みDB作業領域ディレクトリ
     } |
     {{-r|-f}
      {-d 組み込みDBデータ領域ディレクトリ
        [,システム領域ディレクトリ1
         [,システム領域ディレクトリ2]] |
       -a ajssys01=データ領域パーティション
        ,ajssys11=システム領域パーティション1
         [,ajssys17=システム領域パーティション2]
      }
      -ld 組み込みDB作業領域ディレクトリ
      -mh 論理ホスト名
      -eh 実行系物理ホスト名
     }
    }
    [-p ポート番号]
    -i 組み込みDB運用ディレクトリ
    [-bs [-bl アンロードログファイル作成ディレクトリ] |
     -br [-bl アンロードログファイル作成ディレクトリ] ]
    [-rs]
    [-c]
    [-lc 組み込みDBサーバ文字コード種別]
    [-id セットアップ識別子]

形式1（物理ホストの標準的なセットアップ）

ajsembdbbuild
    [-l|-m|-s]
    -d 組み込みDBデータ領域ディレクトリ
      [,システム領域ディレクトリ1]
    [-p ポート番号]
    -i 組み込みDB運用ディレクトリ
    [-rs]
    [-c]
    [-lc 組み込みDBサーバ文字コード種別]
    [-id セットアップ識別子]

形式2（物理ホストでバックアップとシステムログで運用を行うセットアップ）

ajsembdbbuild
    [-l|-m|-s]
    -d 組み込みDBデータ領域ディレクトリ
      ,システム領域ディレクトリ1
          [,システム領域ディレクトリ2]
    [-p ポート番号]
    -i 組み込みDB運用ディレクトリ
    {-bs|-br}
    [-rs]
    [-c]
    [-lc 組み込みDBサーバ文字コード種別]
    [-id セットアップ識別子]

形式3（物理ホストでバックアップとアンロードログファイルで運用を行うセットアップ）

ajsembdbbuild
    [-l|-m|-s]
    -d 組み込みDBデータ領域ディレクトリ
      ,システム領域ディレクトリ1
        [,システム領域ディレクトリ2]
    [-p ポート番号]
    -i 組み込みDB運用ディレクトリ
    {-bs -bl アンロードログファイル作成ディレクトリ|
     -br -bl アンロードログファイル作成ディレクトリ}
    [-rs]
    [-c]
    [-lc 組み込みDBサーバ文字コード種別]
    [-id セットアップ識別子]

形式4（物理ホストでRAWファイルを使用したセットアップ）

ajsembdbbuild
    [-l|-m|-s]
    -a ajssys01=データ領域パーティション
      ,ajssys11=システム領域パーティション1
    -d 組み込みDB作業領域ディレクトリ
    [-p ポート番号]
    -i 組み込みDB運用ディレクトリ
    [-rs]
    [-c]
    [-lc 組み込みDBサーバ文字コード種別]
    [-id セットアップ識別子]

形式5（物理ホストでRAWファイルを使用し，バックアップとシステムログで運用を行うセットアップ）

ajsembdbbuild
    [-l|-m|-s]
    -a ajssys01=データ領域パーティション
      ,ajssys11=システム領域パーティション1
        [,ajssys17=システム領域パーティション2]
    -d 組み込みDB作業領域ディレクトリ
    [-p ポート番号]
    -i 組み込みDB運用ディレクトリ
    [-bs|-br]
    [-rs]
    [-c]
    [-lc 組み込みDBサーバ文字コード種別]
    [-id セットアップ識別子]

形式6（物理ホストでRAWファイルを使用し，バックアップとアンロードログファイルで運用を行うセットアップ）

ajsembdbbuild
    [-l|-m|-s]
    -a ajssys01=データ領域パーティション
      ,ajssys11=システム領域パーティション1
        [,ajssys17=システム領域パーティション2]
    -d 組み込みDB作業領域ディレクトリ
    [-p ポート番号]
    -i 組み込みDB運用ディレクトリ
    {-bs -bl アンロードログファイル作成ディレクトリ |
     -br -bl アンロードログファイル作成ディレクトリ}
    [-rs]
    [-c]
    [-lc 組み込みDBサーバ文字コード種別]
    [-id セットアップ識別子]

形式7（論理ホストの標準的なセットアップ）

ajsembdbbuild
    [-l|-m|-s]
    {-r|-f}
    -d 組み込みDBデータ領域ディレクトリ
      [,システム領域ディレクトリ1]
    -ld 組み込みDB作業領域ディレクトリ
    -mh 論理ホスト名
    -eh 実行系物理ホスト名
    [-p ポート番号]
    -i 組み込みDB運用ディレクトリ
    [-rs]
    [-c]
    [-lc 組み込みDBサーバ文字コード種別]
    [-id セットアップ識別子]

形式8（論理ホストでバックアップとシステムログで運用を行うセットアップ）

ajsembdbbuild
    [-l|-m|-s]
    {-r|-f}
    -d 組み込みDBデータ領域ディレクトリ
      ,システム領域ディレクトリ1
        [,システム領域ディレクトリ2]
    -ld 組み込みDB作業領域ディレクトリ
    -mh 論理ホスト名
    -eh 実行系物理ホスト名
    [-p ポート番号]
    -i 組み込みDB運用ディレクトリ
    {-bs|-br}
    [-rs]
    [-c]
    [-lc 組み込みDBサーバ文字コード種別]
    [-id セットアップ識別子]

形式9（論理ホストでバックアップとアンロードログファイルで運用を行うセットアップ）

ajsembdbbuild
    [-l|-m|-s]
    {-r|-f}
    -d 組み込みDBデータ領域ディレクトリ
      ,システム領域ディレクトリ1
        [,システム領域ディレクトリ2]
    -ld 組み込みDB作業領域ディレクトリ
    -mh 論理ホスト名
    -eh 実行系物理ホスト名
    [-p ポート番号]
    -i 組み込みDB運用ディレクトリ
    {-bs -bl アンロードログファイル作成ディレクトリ |
     -br -bl アンロードログファイル作成ディレクトリ}
    [-rs]
    [-c]
    [-lc 組み込みDBサーバ文字コード種別]
    [-id セットアップ識別子]

形式10（論理ホストでRAWファイルを使用したセットアップ）

ajsembdbbuild
    [-l|-m|-s]
    {-r|-f}
    -a ajssys01=データ領域パーティション
      ,ajssys11=システム領域パーティション1
    -ld 組み込みDB作業領域ディレクトリ
    -mh 論理ホスト名
    -eh 実行系物理ホスト名
    [-p ポート番号]
    -i 組み込みDB運用ディレクトリ
    [-rs]
    [-c]
    [-lc 組み込みDBサーバ文字コード種別]
    [-id セットアップ識別子]

形式11（論理ホストでRAWファイルを使用し，バックアップとシステムログで運用を行うセットアップ）

ajsembdbbuild
    [-l|-m|-s]
    {-r|-f}
    -a ajssys01=データ領域パーティション
      ,ajssys11=システム領域パーティション1
        [,ajssys17=システム領域パーティション2]
    -ld 組み込みDB作業領域ディレクトリ
    -mh 論理ホスト名
    -eh 実行系物理ホスト名
    [-p ポート番号]
    -i 組み込みDB運用ディレクトリ
    {-bs|-br}
    [-rs]
    [-c]
    [-lc 組み込みDBサーバ文字コード種別]
    [-id セットアップ識別子]

形式12（論理ホストでRAWファイルを使用し，バックアップとアンロードログファイルで運用を行うセットアップ）

ajsembdbbuild
    [-l|-m|-s]
    {-r|-f}
    -a ajssys01=データ領域パーティション
      ,ajssys11=システム領域パーティション1
        [,ajssys17=システム領域パーティション2]
    -ld 組み込みDB作業領域ディレクトリ
    -mh 論理ホスト名
    -eh 実行系物理ホスト名
    [-p ポート番号]
    -i 組み込みDB運用ディレクトリ
    {-bs -bl アンロードログファイル作成ディレクトリ|
     -br -bl アンロードログファイル作成ディレクトリ}
    [-rs]
    [-c]
    [-lc 組み込みDBサーバ文字コード種別]
    [-id セットアップ識別子]

機能

JP1/AJS2用に組み込みDBサーバの環境を構築し，組み込みDBサーバの起動を行います。

クラスタ構成時の環境構築の場合は，実行系ホストおよび待機系ホストの両方で実行します。

実行権限

Windowsの場合：Administrators権限

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

JP1/AJS2 - Managerのインストール先フォルダ¥tools¥

UNIXの場合

/opt/jp1ajs2/tools/

引数

-l|-m|-s

データベースモデルを次の3種類の中から選択します。

-l
次のような大規模システム用のモデルです。

総ユニット数：40,000～100,000程度

1日に実行されるジョブ数・ジョブネット総数：25,000～50,000

ディスク容量の目安：5,002メガバイト

-m
次のような中規模システム用のモデルです。

総ユニット数：10,000～40,000程度

1日に実行されるジョブ数・ジョブネット総数：10,000～25,000

ディスク容量の目安：2,000メガバイト

-s
次のような小規模システム用のモデルです。

総ユニット数：～10,000程度

1日に実行されるジョブ数・ジョブネット総数：～10,000

ディスク容量の目安：1,002メガバイト

デフォルトは-l（大規模モデル）です。

-d 組み込みDBデータ領域ディレクトリ [,システム領域ディレクトリ1 [,システム領域ディレクトリ2]]

組み込みDBのデータ領域およびシステム領域に通常ファイルを使用する場合に指定します。

組み込みDBデータ領域ディレクトリ
組み込みDBのデータ領域格納ディレクトリを指定します。ここで指定したディレクトリに組み込みDBのデータ領域を確保して，JP1/AJS2スケジューラーデータベースの実体を格納します。
後述のシステム領域ディレクトリ1を指定しない場合は，組み込みDBのシステム領域も確保してシステムファイルを同時に格納します。

システム領域ディレクトリ1
ログ運用を行う（-bsオプションを指定する）場合は，システム領域ディレクトリ1も同時に指定してください。ここで指定したディレクトリに組み込みDBのシステム領域を確保して，システムファイルを格納します。

システム領域ディレクトリ2
ログ運用を行いさらにログファイルを二重化する（-brオプションを指定する）場合は，システム領域ディレクトリ2も同時に指定してください。この指定によってシステムファイルが二重化されます。

各ディレクトリは，信頼性向上の観点からそれぞれ別ボリュームのディレクトリに設定することをお勧めします。

クラスタ構成（-rまたは-fオプションを指定する）のときの環境構築の場合は，共有ディスク上のディレクトリを指定してください。

各ディレクトリ名称は絶対パス50バイト以内とし，空白文字を含む場合はパス全体を「""」で囲んでください。

なお，複数のディレクトリを指定する場合は-dオプションの値全体を「""」で囲み，個々のディレクトリ名称は「""」で囲まないでください。

-a ajssys01=データ領域パーティション ,ajssys11=システム領域パーティション1 [,ajssys17=システム領域パーティション2]

組み込みDBのデータ領域およびシステム領域にRAWファイルを使用する場合に指定します。

ajssys01=データ領域パーティション
組み込みDBのデータ領域用パーティションを指定します。ここで指定したパーティションにJP1/AJS2スケジューラーデータベースの実体を格納します。

ajssys11=システム領域パーティション1
ログ運用を行う（-bsまたは-brオプションを指定する），ログ運用を行わない（-bsおよび-brオプションを指定しない）に関係なく，システム領域パーティション1も同時に指定してください。ここで指定したパーティションに組み込みDBのシステムファイルを格納します。

ajssys17=システム領域パーティション2
ログ運用を行い，さらにログファイルを二重化する（-brオプションを指定する）場合は，システム領域パーティション2も同時に指定してください。この指定によってシステムファイルが二重化されます。

このオプションの指定例を次に示します。

Windowsの場合

Dドライブをデータ領域パーティション，Eドライブをシステム領域パーティション1として割り当てる場合

-a "ajssys01=¥¥.¥D:,ajssys11=¥¥.¥E:"

Dドライブをデータ領域パーティション，Eドライブをシステム領域パーティション1，Fドライブをシステム領域パーティション2として割り当てる場合

-a "ajssys01=¥¥.¥D:,ajssys11=¥¥.¥E:,ajssys17=¥¥.¥F:"

UNIXの場合

/dev/vg00/rdsk0をデータ領域パーティション，/dev/vg00/rdsk1をシステム領域パーティション1として割り当てる場合

-a "ajssys01=/dev/vg00/rdsk0,ajssys11=/dev/vg00/rdsk1"

/dev/vg00/rdsk0をデータ領域パーティション，/dev/vg00/rdsk1をシステム領域パーティション1，/dev/vg00/rdsk2をシステム領域パーティション2として割り当てる場合

-a "ajssys01=/dev/vg00/rdsk0,ajssys11=/dev/vg00/rdsk1,ajssys17=/dev/vg00/rdsk2"

クラスタ構成（-rまたは-fオプションを指定する）のときの環境構築の場合は，共有ディスク上のパーティションを指定してください。

各パーティション名称は絶対パス50バイト以内として，-aオプションの値全体を「""」で囲んでください。

パーティション名称に対するシンボリックリンク名称は使用しないでください。

-d 組み込みDB作業領域ディレクトリ

クラスタ構成ではない（-r，-fオプションをどちらも指定しない）場合でRAWファイルを使用する環境を構築する（-aオプションを指定する）ときに指定します。組み込みDBが使用する作業用の領域として，通常ファイルシステムのディレクトリ名称を指定します。

ディレクトリ名称は絶対パス50バイト以内とし，空白文字を含む場合はパス全体を「""」で囲んでください。

指定するディレクトリのファイルシステム上には，40メガバイトの空き容量を確保してください。

-r

クラスタ構成時に実行系ホストの環境を構築する場合に指定します。同時に，論理ホスト名（-mhオプション）と組み込みDB作業領域ディレクトリ（-ldオプション）の指定が必要となります。

組み込みDBのデータ領域およびシステム領域を格納するための共有ディスクは，実行系ホスト側にマウントされている必要があります。また，論理ホストにアクセスできる状態になっている必要があります。

-f

クラスタ構成時に待機系ホストの環境を構築する場合に指定します。同時に，論理ホスト名（-mhオプション）と組み込みDB作業領域ディレクトリ（-ldオプション）の指定が必要となります。

組み込みDBサーバの設定だけを行い，データ領域の作成や組み込みDBサーバの起動は行いません。ただし，組み込みDBのデータ領域およびシステム領域（-aまたは-dオプション）の指定内容は，実行系ホストの環境構築時と同一の内容を指定してください。

-ld 組み込みDB作業領域ディレクトリ

クラスタ構成（-rまたは-fオプションを指定する）の環境構築の場合に指定します。組み込みDBが使用する作業用の領域として，物理ホスト上の通常ファイルシステムのディレクトリ名称を指定します。共有ディスク上のディレクトリは指定しないでください。

ディレクトリ名称は絶対パス50バイト以内とし，空白文字を含む場合はパス全体を「""」で囲んでください。

指定するディレクトリのファイルシステム上には，40メガバイトの空き容量を確保してください。

-mh 論理ホスト名

クラスタ構成（-rまたは-fオプションを指定する）の環境構築の場合に指定します。論理ホスト名を指定してください。指定できる文字数は，1～32（単位：バイト）です。

-eh 実行系物理ホスト名

クラスタ構成（-rまたは-fオプションを指定する）の環境構築の場合に指定します。実行系ホストのオペレーティングシステムがTCP/IPホスト名として認識しているホスト名（hostnameコマンドで出力されるホスト名）を指定してください。指定できる文字数は，1～32（単位：バイト）です。

待機系ホストの環境構築（-fオプションを指定する）でも，このオプションには実行系の物理ホスト名を指定することに注意してください。

-p ポート番号

組み込みDBサーバで使用するポート番号を指定します。

システム内で使用されていないポート番号を指定する必要があります。特にほかのJP1製品で組み込みDBを使用している場合は，重複しないように注意してください。

省略した場合は「22200」が仮定されます。

-i 組み込みDB運用ディレクトリ

組み込みDBの運用ディレクトリとなるディレクトリの名称を指定します。単一の組み込みDBサーバで運用する場合は，組み込みDBをインストールしたディレクトリを指定してください。

同一マシン内に複数の組み込みDBサーバを共存させて運用する場合は次に示すとおりになります。

一つ目の組み込みDBサーバ環境構築

組み込みDBのインストールディレクトリ
上述の単一の組み込みDBサーバで運用する場合と同様に，組み込みDBをインストールしたディレクトリを指定してください。

二つ目以降の組み込みDBサーバ環境構築

Windowsの場合

組み込みDBのインストールディレクトリ
追加インストール済みの組み込みDBについて，それぞれのインストールディレクトリに指定したディレクトリを指定してください。

UNIXの場合

新規組み込みDB運用ディレクトリ
新たに構築する組み込みDBサーバの運用ディレクトリとして用いるディレクトリの名称を指定します。所有者がrootである空のディレクトリを指定してください。

ディレクトリ名称は絶対パスで指定し，空白文字を含む場合はパス全体を「""」で囲んでください。

クラスタ構成（-rまたは-fオプションを指定する）の環境構築の場合に，共有ディスク上のディレクトリを指定しないでください。

UNIXの場合はこのオプションを省略できます。省略した場合は/opt/HiRDB_Jが仮定されます。

-bs

ログ運用を行い，ログファイルを二重化しない場合に指定します。

-br

ログ運用を行い，ログファイルを二重化する場合に指定します。

-bl アンロードログファイル作成ディレクトリ

データベースの回復にアンロードログを使用する場合に指定します。アンロードログファイルを作成するディレクトリを指定してください。-bsまたは-brオプションを同時に指定していない場合はエラーとなります。

ディレクトリ名称は絶対パスで指定し，空白文字を含む場合はパス全体を「""」で囲んでください。

組み込みDBのアンロードログファイルを取得する運用方法については，マニュアル「JP1/Automatic Job Management System 2 設計・運用ガイド　3.5.7 アンロードログ運用」を参照してください。

-rs

組み込みDBを再インストールまたはバージョンアップしたときに指定します。OSに必要な情報を登録します。

このオプションはUNIXの場合にだけ有効となります。Windowsの場合は指定する必要はありません。指定した場合は無視して処理を終了します。

-c

JP1/AJS2をバージョンアップした場合に指定します。組み込みDBで使用する設定ファイルを最新のものに更新します。新規インストール，および設定ファイルを更新したくない場合は指定しないでください。

一度設定ファイルを更新した場合，古い設定ファイルは上書きされてしまうので注意が必要です。

-lc 組み込みDBサーバ文字コード種別

UNIX版だけで指定できるオプションです。

組み込みDBサーバの文字コードを指定します。

このオプション省略時は，HP-UXおよびAIXの場合はsjis，Solarisの場合はujis，Linuxの場合はutf-8が仮定されます。

sjis
組み込みDBサーバの文字コードをSJIS（シフトJIS）でセットアップします。

ujis
組み込みDBサーバの文字コードをEUCでセットアップします。

lang-c
組み込みDBサーバの文字コードをC（7ビットASCII）でセットアップします。

utf-8
組み込みDBサーバの文字コードをUTF-8でセットアップします。

規定以外の文字コードを指定すると，KFPS00060-Eメッセージが出力されます。

組み込みDBサーバの文字コードは，スケジューラーサービスの文字コードと必ず一致させてください。

-id セットアップ識別子

組み込みDBを識別するセットアップ識別子を「_JAn」（nは0～9またはA～Z）の4文字で指定します。

Windowsの場合は，組み込みDBをインストールするときに指定したセットアップ識別子と同じ値を指定してください。

UNIXの場合は，規定値の範囲内で任意です。

このオプションを省略した場合は，_JA0が仮定されます。また，このオプションは，-rsオプションを指定した場合，無視されます。

登録済みのセットアップ識別子および組み込みDB運用ディレクトリは，ajsembdbidlistコマンドで確認できます。ajsembdbidlistコマンドの詳細は，「20. セットアップ時に使用するコマンド　ajsembdbidlist」を参照してください。

注意事項

組み込みDBサーバの再構築を行う場合，ajsembdbunsetコマンドを実行して組み込みDBサーバの情報を初期化したあとに実施してください。また，組み込みDBサーバを削除する場合もajsembdbunsetコマンドを実行してください。
なお，ajsembdbunsetコマンドを実行すると，スケジューラーサービスが組み込みDBにアクセスしていても強制的に組み込みDBサーバの情報を初期化してしまうので実行時には注意が必要です。
ajsembdbunsetコマンドについては，「20. セットアップ時に使用するコマンド　ajsembdbunset」を参照してください。

ajsembdbbuildは，スクリプトで実装されています。このため，オプションに不当に長い文字列や不正な文字列や値を指定すると，予期せぬエラーが発生することがあります。オプション指定値は，DBMSおよびJP1/AJS2で規定されている範囲内の文字列または数値を指定してください。

ajsembdbbuildスクリプトを実行するときは，OSのファイルシステムの設定で，扱えるファイルの最大サイズを，2ギガバイトより大きな値，または無制限に設定してください。
特に，AIXでは，デフォルトのファイルサイズ制限が1ギガバイトになっているため，注意してください。

-blオプションに指定したディレクトリ名称に誤りがある場合でも，組み込みDBのシステムは起動完了となる場合があります。-blオプションを指定した場合はWindowsイベントログまたはsyslogを参照して，組み込みDBのエラーメッセージ（KFPS01150-E）が出力されていないか確認してください。

ログ運用を行う（-bsまたは-brオプションを指定する）場合で，回復にシステムログを使用し，アンロードログを使用しない（-blオプションを指定しない）場合，運用を続けるに従ってアンロード待ちのログファイルが増加していきます。この状態を放置したまま運用を続けると，すべてのログファイルがアンロード待ちとなり組み込みDBが異常終了します。
また，組み込みDBの仕様で，組み込みDBの停止および起動を行うとログファイルのスワップが行われ，使用されていたログファイルがアンロード待ちの状態になります。すべてのログファイルがアンロード待ちの状態で組み込みDBの停止および起動を行うと，組み込みDBが起動できなくなります。
このため定期的にajsembdbbackupコマンドを実行して，アンロード待ち状態を解除する必要があります。
組み込みDBのシステムログファイルの状態を確認する場合は，ajsembdbstatusコマンドの-lオプションを実行してください。
ajsembdbstartコマンドがシステムログファイル不足でエラーになった場合，ajsembdbaddlogコマンドでシステムファイルを二つ以上追加し，組み込みDBを起動したあとにajsembdbbackupコマンドを実行してバックアップを取るようにしてください。
ajsembdbstatusコマンドの詳細は，マニュアル「JP1/Automatic Job Management System 2 コマンドリファレンス　1. コマンド　ajsembdbstatus」を，ajsembdbaddlogコマンドの詳細は，マニュアル「JP1/Automatic Job Management System 2 コマンドリファレンス　1. コマンド　ajsembdbaddlog」を参照してください。

組み込みDB運用ディレクトリなどのパス名称には，全角文字および特殊記号を使用しないでください。

ajsembdbbuildコマンドが，エラーメッセージ（KAVS2124-E）を出力して終了した場合，ajsembdbunsetコマンドに-iオプションを指定して環境を削除してから，ajsembdbbuildコマンドを再実行してください。

このコマンドを同時に複数実行しないでください。同時に複数実行した場合，次に示す現象が起こるおそれがあります。

不当なメッセージを出力したり，本来出力するはずのメッセージを出力しなかったりするなど，メッセージ出力が不正になる。

このコマンドが，不当にエラーになる。

構成定義情報が不正になり，JP1/AJS2が運用できなくなる。

組み込みDB環境を構築するホストのホスト名を，hostsファイルまたはDNSに登録してください。また,クラスタ環境の場合は,実行系の物理ホスト名および論理ホスト名共にhostsファイルまたはDNSに登録してください。

組み込みDB環境を構築するホストのホスト名をjp1hosts定義ファイルに登録しても，組み込みDBで使用するホスト名として有効になりません。

組み込みDB環境を構築するホストのホスト名には，エイリアス名を使用しないでください。

組み込みDBが稼働できるホストのホスト名は，最大32バイトです。したがって，組み込みDB環境を構築するホストは，物理ホスト名および論理ホスト名共に1～32バイトで設定してください。

Windows Server 2008のマシンでこのコマンドを実行する際には，コマンドプロンプトを管理者として起動する必要があります。コマンドプロンプトを起動する際は，Windowsの［スタート］メニューの［コマンドプロンプト］を右クリックし，ショートカットメニューから［管理者として実行］を選択してください。なお，UAC機能が無効の場合は，コマンドプロンプトを管理者として起動する必要はありません。

Windows Server 2008でUAC機能が無効の場合に，Administrators権限のないユーザーでこのコマンドを実行すると，メッセージKAVS2124-Eが出力されてコマンドは異常終了します。Administrators権限のあるユーザーでajsembdbunset -iコマンドを実行して環境を削除してから，このコマンドを再実行してください。

戻り値

0 | 正常終了。
0以外 | 異常終了。

エラー発生時の対処

スクリプトを実行し，問題がある場合は終了コード，エラーメッセージ，終了メッセージの順で標準出力ファイルに出力されます。問題が発生した場合は次の表に従って問題を対処し，再セットアップしてください。

コード
メッセージID
原因
対処方法

1
KFPX29601
-a，または-dオプションの指定が誤っている。
-aまたは-dに指定した引数を見直してください。

3
KFPX29603
指定されたディレクトリは組み込みDB運用ディレクトリではない。
-iオプションに組み込みDBの運用ディレクトリを指定してください。

4
KFPX29604
組み込みDBの運用ディレクトリが指定されていない。

5
KFPX29605
ポート番号が重複している。
-pオプションに指定するポート番号が，ほかで使用しているポート番号と重複しないように指定してください。

6
KFPX29606
システム共通定義に誤りがある。
システム共通定義などの設定ファイルを手動で変更した際に発生します。問題点を修正してください。

7
KFPX29607
ファイルが存在しない。
スクリプトを実行する環境を見直してください。-ldに指定した引数を見直してください。

8
KFPX29608
ファイルオープンに失敗。

9
KFPX29609
ファイルの読み取りに失敗。

10
KFPX29610
ファイルの生成に失敗。

11
KFPX29611
ディレクトリの作成に失敗。

12
KFPX29612
表・システム領域不足。

13
KFPX29613

14
KFPX29614

15
KFPX29615

16
KFPX29616
表・システム領域作成時エラー。
スクリプトを実行する環境を見直してください。-blに指定した引数を見直してください。
OSのファイルシステムの設定で，扱えるファイルの最大サイズが2ギガバイト以下に設定されている場合は，2ギガバイトより大きな値，または無制限に設定し直してください。

17
KFPX29617
システム領域初期化エラー。
スクリプトを実行する環境を見直してください。-blに指定した引数を見直してください。

18
KFPX29618
組み込みDB起動・表領域初期化エラー。
スクリプトを実行する環境を見直してください。-blに指定した引数を見直してください。組み込みDBが必要とするシステムリソースが不足しています。マニュアル「JP1/Automatic Job Management System 2 設計・運用ガイド　4.2.5 カーネルパラメーターを見積もる」を参照して確認してください。

19
KFPX29619
組み込みDBの内部エラー。
組み込みDBの運用ディレクトリに指定したディレクトリを退避し，システム管理者に連絡してください。

20
KFPX29620
一時ファイル作成エラー。
スクリプトを実行する環境を見直してください。-blに指定した引数を見直してください。

21
KFPX29621
ファイルの書式が不正。
システム共通定義などの設定ファイルを手動で変更した際に発生します。問題点を修正してください。

22
KFPX29622
システム領域の指定が不正。

23
KFPX29623
組み込みDBの内部エラー。
組み込みDBの運用ディレクトリに指定したディレクトリを退避し，システム管理者に連絡してください。

24
KFPX29624
KFPS00031
環境セットアップ済みである。
ajsembdbunsetコマンドを実行し，環境を削除してからセットアップしてください。

25
KFPX29625
メモリー不足。
十分なメモリーを確保した上で再セットアップしてください。

26
KFPX29626
組み込みDBの内部エラー。
組み込みDBの運用ディレクトリに指定したディレクトリを退避し，システム管理者に連絡してください。

27
KFPX29627

－
KFPS00031
組み込みDBがセットアップ済みである。
ajsembdbunsetコマンドを実行し，前回の組み込みDBの情報を削除してください。

－
KFPS05089
-iオプションに指定したディレクトリが存在しない。
組み込みDB運用ディレクトリを指定してください。

－
Bad directory specified in -i option
Windowsの場合：
-iに指定した組み込みDBの運用ディレクトリが不正です。
UNIXの場合：
-iに指定したディレクトリが存在しません。
Windowsの場合
-iに正しい組み込みDBの運用ディレクトリを指定してください。
UNIXの場合
-iに存在するディレクトリを指定してください。

－
There is an error in the specification of the setup identifier.
セットアップ識別子の指定が間違っています。
または，すでに登録されているセットアップ識別子を指定しています。
セットアップ識別子の指定を確認して再実行してください。セットアップ識別子は，「_JAn」（nは0～9またはA～Z）の4文字で指定します。
登録済みのセットアップ識別子は，ajsembdbidlistコマンドで確認できます。

－
Failed to register the configuration definition.
構成定義の登録に失敗しました。
ajsembdbunsetコマンドを実行して環境を削除してください。そのあと，コマンドの実行権限を確認して，再度実行してください。

ajsembdbrpsetup

形式

ajsembdbrpsetup
    [-mh 論理ホスト名]
    [-F スケジューラーサービス名]
    [-d データベース拡張領域格納ディレクトリ名
        [,システムログ領域ディレクトリ名1
            [,システムログ領域ディレクトリ名2]]]
    [-l|-m|-s]
    [-r]
    [-e]
    [-c]

機能

JP1/AJS2システムにJP1/AJS2 - Datareplicatorを導入している場合に使用するコマンドです。

JP1/AJS2 - Datareplicatorでレプリケーションができるように，組み込みDBが拡張されます。拡張することによって，次の情報が格納されるようになります。

ジョブ実行制御DBの情報

ジョブ実行結果の詳細情報

イベントジョブの監視情報

引き継ぎ情報の実行結果詳細情報

ただし，ジョブ実行制御DBの情報はセットアップ前の情報を引き継ぎますが，その他については情報を引き継げません。

このコマンドは，必ずJP1/AJS2の運用を停止させてから実行してください。

スケジューラーサービスのデータベース種別が組み込みDBではない場合，このコマンドは実行できません。

JP1/AJS2 - Datareplicatorのセットアップ手順については，マニュアル「JP1/Automatic Job Management System 2 - Datareplicator」を参照してください。

実行権限

Windowsの場合：Administrators権限

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

JP1/AJS2 - Managerのインストール先フォルダ¥tools¥

UNIXの場合

/opt/jp1ajs2/tools/

引数

-mh 論理ホスト名

処理の対象とするJP1論理ホスト名を指定します。指定できる文字数は，1～32（単位：バイト）です。

省略した場合，環境変数JP1_HOSTNAMEの設定があれば，環境変数値が仮定されます。環境変数JP1_HOSTNAMEの指定がない場合は，物理ホストが仮定されます。

物理ホストを明示的に指定したい場合は，JP1_DEFAULTを指定してください。

-F スケジューラーサービス名

レプリケーションの対象とするスケジューラーサービス名を指定します。指定できる文字数は，1～30（単位：バイト）です。

省略した場合，デフォルトのスケジューラーサービス名が仮定されます。

-d データベース拡張領域格納ディレクトリ名[,システムログ領域ディレクトリ名1[,システムログ領域ディレクトリ名2]]

拡張するデータベース領域とシステムログ領域を格納するディレクトリ名を指定します。

拡張する領域は，物理ホストまたは論理ホスト内で共通の領域となるので，ホスト内で初めてこのコマンドを実行したときだけ作成されます。このため，物理ホストまたは論理ホスト内で初めてこのコマンドを実行する場合は，-dオプションを必ず指定してください。物理ホストまたは論理ホスト内ですでにこのコマンドを実行している場合，-dオプションは指定できません。指定した場合はエラーとなり，コマンドは実行できません。

ディレクトリ名指定時の注意事項を次に示します。

絶対パスで120バイト以内で指定してください。

存在するディレクトリを指定してください。

-rオプションと同時に指定する場合は，Windowsでは「¥¥.¥ドライブ名:」，UNIXでは絶対パスで指定し，必ずシステムログ領域ディレクトリ名1を指定してください。

（例）Windowsで，データベース拡張領域格納に「D:」ドライブ，システムログ領域に「E:」ドライブを指定する場合

-d ¥¥.¥D:,¥¥.¥E:

（例）UNIXで，データベース拡張領域格納に/dev/vg00/rdsk1，システムログ領域に/dev/vg00/rdsk2，二重化するシステムログ領域に/dev/vg00/rdsk3を指定する場合

-d /dev/vg00/rdsk1,/dev/vg00/rdsk2,/dev/vg00/rdsk3

空白を含む場合は，ディレクトリ名を「""」で括ってください。

複数のディレクトリを指定する場合は，次の例のように-d以降の記述全体を「""」で括ってください。個々のディレクトリ名称は空白を含んでいても，「""」で括らないでください。

（例）組み込みDBのシステムログを二重化している場合

-d "データ領域格納ディレクトリ名称,システム領域ディレクトリ名称1,システム領域ディレクトリ名称2"

クラスタ環境の実行系で実行する場合は，共有ディスクを指定してください。

データベース拡張領域格納ディレクトリ名

拡張データベース領域を格納するディレクトリを指定します。ディレクトリ名に，ajsembdbbuildコマンドで指定したデータベース領域の格納ディレクトリと別のディレクトリを指定しても，問題ありません。ただし，-rオプションと同時に指定する場合は，必ずほかの用途で使用していないRAWファイル（キャラクタ型スペシャルファイル）を指定してください。

データベース領域ファイル名

ajssys05
ジョブ実行制御DB情報，およびイベントジョブ監視情報が格納されます。

ajssys06
ジョブの実行結果詳細情報，および引き継ぎ情報の実行結果詳細情報が格納されます。

なお，-rオプションと同時に指定している場合は，これらのファイルを作成しないで，指定したRAWファイル（キャラクタ型スペシャルファイル）に格納します。

表20-4　データベース拡張領域格納ディレクトリに必要な容量

項番 | 規模※ | 必要空き容量（メガバイト）
1 | 大規模 | 約6,500
2 | 中規模 | 約3,600
3 | 小規模 | 約1,700

注※

規模とは，-l（大規模）-m（中規模），または-s（小規模）のことを指します。

システムログ領域ディレクトリ名1,システムログ領域ディレクトリ名2

システムログ領域を格納するディレクトリを指定します。システムログ領域格納ディレクトリ1を省略した場合，データベース拡張領域格納ディレクトリが仮定されます。

システムログ領域格納ディレクトリ2は，組み込みDBのシステムログを二重化している場合，必ず指定してください。二重化していない場合は，指定できません。

システムログ領域ファイル

システムログ領域格納ディレクトリ1には，次のファイルが作成されます。

ajssys023

ajssys024

ajssys025

ajssys026

システムログ領域格納ディレクトリ2には，次のファイルが作成されます。ただし，システムログ領域格納ディレクトリ2を指定しなかった場合は，作成されません。

ajssys027

ajssys028

ajssys029

ajssys030

なお，-rオプションと同時に指定している場合は，指定したRAWファイル（キャラクタ型スペシャルファイル）にログが格納されます。

表20-5　システムログ領域ディレクトリに必要な容量

項番 | 規模※ | 必要空き容量（メガバイト）
1 | 大規模 | 約2,300
2 | 中規模 | 約800
3 | 小規模 | 約500

注※

規模とは，-l（大規模）-m（中規模），または-s（小規模）のことを指します。

このオプションは，-eと同時に指定しないでください。

-l|-m|-s

拡張するデータベースのデータベースモデルを次の3種類の中から選択します。

-l 大規模

-m 中規模

-s 小規模

このオプションは，-dオプションを指定している場合に有効となります。省略した場合，-lが仮定されます。ただし，-eと同時に指定しないでください。

l，m，sはそれぞれajsembdbbuildのデータベースモデル，大・中・小規模に対応しています。ajsembdbbuildで指定したデータベースモデルの規模と同じオプションを指定してください。

なお，データベースモデル，大・中・小規模で作成される領域のセグメントの全体量は次のとおりです。

表20-6　ajsembdbrpsetupのデータベースモデル，大・中・小規模で作成される領域のセグメントの全体量

データベースの
領域と名称
小規模※
（セグメント）
中規模※
（セグメント）
大規模※
（セグメント）

データ領域AJS2RPHDATA
6,500
19,000
38,000

データ領域AJS2RPSDATA
3,000

注※

1セグメント=10ページ=122,880バイト

-r

領域の作成でRAWファイル（キャラクタ型スペシャルファイル）を使用する場合に指定します。

このオプションは，-dオプションと同時に指定してください。また，-eと同時に指定しないでください。

-e

指定したスケジューラーサービスを組み込みDB拡張前の環境に戻します。

次に示す情報は削除されますので，注意してください。

ジョブ実行制御DBの情報

ジョブ実行結果の詳細情報

イベントジョブの監視情報

引き継ぎ情報の実行結果詳細情報

ただし，次に示す情報は，物理ホストまたは論理ホスト内で組み込みDBを拡張して運用しているすべてのスケジューラーサービスが，組み込みDB拡張前の環境に戻したときに削除されます。

ジョブ実行制御DBの情報

イベントジョブの監視情報

引き継ぎ情報の実行結果詳細情報

このオプションは，-d，-l，-m，-s，-r，-cと同時に指定しないでください。

-c

データベース領域ファイルをすべて初期化する場合に指定します。

すべて初期化する場合，指定する規模に応じたサイズでデータベース領域ファイルを作成します。このため，データベース領域ファイルの作成に時間が掛かります。

すべて初期化しない場合，必要最小限のサイズでデータベース領域ファイルを作成します。運用中に領域が不足した場合，領域ファイルのサイズが自動的に拡張されます。拡張できる領域ファイルの最大サイズは，規模に応じて変わります。

クラスタの実行系ホストでコマンドを実行する場合に，必ず指定してください。指定しないでコマンドを実行しても正常終了しますが，運用中にサーバマシンに障害が発生すると，ファイルが破壊されるおそれがあります。

このオプションは，-dと同時に指定してください。また，-eと同時に指定しないでください。

表20-7　各テーブルに設定されるデータベース領域（AJS2RPHDATA）に対する空き領域の再利用機能の再利用開始ポイント

テーブル名 | 各テーブルで設定される空き領域の再利用機能の再利用開始ポイント
JPQSYSINFO | データベース領域AJS2RPHDATA全体のセグメントの5%
JPQAGTINFO
JPQSCHINFO
JPQQUEINFO
JPQCONINFO
JPQRESINFO
JPQJOBINFO | データベース領域AJS2RPHDATA全体のセグメントの15%
JPQJOBCTRL | データベース領域AJS2RPHDATA全体のセグメントの10%
JPQENVINFO
JPQTRANSINFO
JPQNFYINFO
EVSYS | データベース領域AJS2RPHDATA全体のセグメントの15%

表20-8　各テーブルに設定されるデータベース領域（AJS2RPSDATA）に対する空き領域の再利用機能の再利用開始ポイント

テーブル名 | 各テーブルで設定される空き領域の再利用機能の再利用開始ポイント
AJSJOBINF | データベース領域AJS2RPSDATA全体のセグメントの10%

注

テーブル名は，テーブルプリフィックスを標準の「AJS」としている場合の名称です。

注意事項

このコマンドを実行する前に，JP1/AJS2サービスを停止してください。また，JP1/AJS2 Monitorサービス，およびJP1/AJS2 Console Agentサービスを含め，組み込みDBにアクセスしているサービスはすべて停止してください。このコマンドでは，組み込みDBを再起動するため，これらのサービスを停止しないでこのコマンドを実行した場合，組み込みDBを停止できず，長時間待ちが発生することがあります。

このコマンドを実行する前に，JP1/AJS2の組み込みDBを必ず起動しておいてください。起動していない場合，エラーが出力され，コマンドを実行できません。

物理ホストまたは論理ホスト内で複数のスケジューラーサービスにセットアップする場合，次に示すスケジューラーサービスの環境設定を共通にする必要があります。

組み込みDBアクセスユーザー

組み込みDBアクセスユーザーパスワード

スケジューラーサービスの組み込みDB認可識別子は「root」である必要があります。「root」でない場合は，組み込みDBを再構築してください。組み込みDBを再構築する場合に，組み込みDB認可識別子および組み込みDB認可識別子パスワードは指定しないでください。

このコマンドでは組み込みDBを起動または停止するため，このコマンドがエラーで終了した場合は，組み込みDBが停止中となっているおそれがあります。コマンドを再実行する場合も，組み込みDBが起動中であることを確認してから再実行してください。

このコマンドはスクリプトで実装されています。このため，オプションに不当に長い文字列や不正な文字列または値を指定すると，予期しないエラーが発生することがあります。オプション指定値は，DBMSおよびJP1/AJS2で規定されている範囲内の文字列または数値を指定してください。

このコマンドを同時に複数実行しないでください。同時に複数実行した場合，次に示す現象が起こるおそれがあります。

不当なメッセージを出力したり，本来出力するはずのメッセージを出力しなかったりするなど，メッセージ出力が不正になる。

このコマンドが，不当にエラーになる。

構成定義情報が不正になり，JP1/AJS2が運用できなくなる。

組み込みDB環境が不正になり，組み込みDBが運用できなくなる。

ジョブ実行環境が不正になり，ジョブ運用ができなくなる。

OSのファイルシステムの設定では，扱えるファイルの最大サイズを2ギガバイトより大きな値，または無制限に設定してください。特にAIXでは，デフォルトのファイルサイズ制限が1ギガバイトになっているため，注意してください。

クラスタの実行系で，このコマンドを実行した場合は，構成定義を待機系と一致させる必要があります。次に示す操作で一致させてください。
実行系

 jbsgetcnf -h 論理ホスト名 > 退避ファイル名

待機系

 jbssetcnf 退避ファイル名

このコマンドを実行すると，ジョブ実行制御DBのデータはファイル※に保存され，ISAMのデータベースファイルからはデータが削除されます。セットアップ後，運用に問題がなければ必要に応じてデータが保存されたファイル※を削除してください。

注※

Windowsの場合

物理ホストの場合

JP1/AJS2 - Managerのインストール先フォルダ¥tmp¥JP1_DEFAULT_AJS_JPQTable.dbk

論理ホストの場合

JP1/AJS2 - Managerのインストール先フォルダ¥tmp¥論理ホスト名_AJS_JPQTable.dbk

UNIXの場合

物理ホストの場合

/var/opt/jp1ajs2/tmp/JP1_DEFAULT_AJS_JPQTable.dbk

論理ホストの場合

/var/opt/jp1ajs2/tmp/論理ホスト名_AJS_JPQTable.dbk

-eオプションを指定してこのコマンドを実行し，組み込みDBを拡張前の環境に戻しても，ISAMのジョブ実行制御DBのデータは回復されません。データを回復するには，コマンド実行前にジョブ実行制御DBのバックアップを行い，コマンド実行後にジョブ実行制御DBのリカバリーを行う必要があります。
次に示す操作を行ってください。

ジョブ実行制御DBをバックアップする。
jpqexport -dt replication -co ジョブ実行制御DB退避ファイル名 [-mh 論理ホスト名]

組み込みDBを拡張前の環境に戻す。

キュー情報データベース格納フォルダのファイルを削除する。
Windowsの場合
物理ホストの場合
　del JP1/AJS2 - Managerのインストール先フォルダ¥jp1ajs2¥database¥queue¥*
論理ホストの場合
　del 共有フォルダ¥jp1ajs2¥database¥queue¥*

UNIXの場合
物理ホストの場合
　rm /var/opt/jp1ajs2/database/queue/*
論理ホストの場合
　rm 共有ディレクトリ/jp1ajs2/database/queue/*

ジョブ実行制御DBをリカバリーする。
jpqimport -dt isam -ci ジョブ実行制御DB退避ファイル名 [-mh 論理ホスト名]

戻り値

0 | 正常終了。
0以外の値 | 異常終了。

エラー発生時の対処

コマンド実行時にエラーが発生する場合があります。エラーが発生した場合は次の表に従って問題を対処し，再実行してください。

メッセージID
原因
対処方法

KAVS0103-E
指定されたオプションおよびオプションに指定した値が不正です。
オプションおよびオプションに指定する値を確認して，再実行してください。

KAVS0108-E
コマンドを実行する権限がありません。
Administrators権限またはスーパーユーザー権限を持つユーザーが再実行してください。

KAVS0187-E
指定したホストには，スケジューラーサービスが定義されていません。
ホスト名が正しいことを確認して，再実行してください。

KAVS0190-E
指定したホスト名またはスケジューラーサービス名が存在しません。
ホスト名またはスケジューラーサービス名が正しいことを確認して，再実行してください。

KAVS0902-E
コマンドを実行するためのメモリーが不足しています。
現象発生時に稼働しているプロセスの状態を確認し，見積もり値以上のメモリーがあるか確認してください。
UNIXの場合は，マニュアル「JP1/Automatic Job Management System 2 設計・運用ガイド　4.2.5 カーネルパラメーターを見積もる」を参照し，カーネルパラメーターのメモリーに関する設定値が，見積もり値以上になっているか確認してください。

KAVS0903-E

構成定義に値が設定されていないか，または値を取得できません。

構成定義を設定できません。

構成定義の値を確認し，再実行してください。

実行するユーザーの権限が正しいか確認して，再実行してください。

KAVS0930-E
組み込みDBへの接続が占有されています。
組み込みDBへの接続をすべて解除して，再実行してください。

KAVS0982-E
データベースの接続数の上限を超えています。
データベースに接続しているほかのプロセスを停止したあとに，再実行してください。

KAVS0983-E
組み込みDB認可識別子，または組み込みDB認可識別子パスワードが「root」ではないおそれがあります。
組み込みDBの再セットアップが必要です。
再セットアップ時には組み込みDB認可識別子および認可識別子パスワードを指定しないでください。

KAVS0996-E
指定されたオプションおよび値が不正です。
オプションおよびオプションに指定する値を修正してください。

KAVS1003-E
構成定義の指定が不正です。
詳細情報に示す構成定義のキーの値を確認して，再実行してください。

KAVS2101-E
組み込みDBが停止しています。
組み込みDBを起動して，再実行してください。

KAVS2102-E
組み込みDBが起動処理中，または停止処理中です。
組み込みDBを起動した状態にして，再実行してください。

KAVS2104-E
スケジューラーサービスには組み込みDBがセットアップされていません。
スケジューラーサービスのデータベース種別がEmbedDBであること，および組み込みDBがセットアップされていることを確認し，再実行してください。

KAVS2115-E
スケジューラーサービスにセットアップしている組み込みDB，またはセットアップ識別子に登録された組み込みDBが，アンインストールされているおそれがあります。
組み込みDBがアンインストールされている場合は，インストールおよびセットアップを実施したあと，再実行してください。
アンインストールされていない場合は，組み込みDBの環境が削除されているおそれがあるため，セットアップしたあと，再実行してください。

KAVS2116-E
指定したオプションに誤りがあります。
詳細情報に示すオプションまたはオプションの値が正しいことを確認して，再実行してください。

KAVS2118-Q
組み込みDBを停止しましたが，組み込みDBの状態が停止中になるのを確認できませんでした。
処理を続行する場合は，ajsembdbstatusによって，組み込みDBが停止したのを確認してから，「y」を入力してください。処理を中断する場合は，「n」を入力してください。この場合，コマンドを再実行するには，ajsembdbstartによって組み込みDBを起動する必要があります。

KAVS4210-E
すでにセットアップされています。
再セットアップする場合は，ajsembdbrpsetup -eでアンセットアップしたあと，再実行してください。

KFPA11723-E
組み込みDBが停止しています。
組み込みDBを起動してください。

KFPA11561-E
指定された認可識別子は有効ではありません。
スケジューラーサービスの組み込みDBを再セットアップしてください。再セットアップ時には，組み込みDB認可識別子と組み込みDB認可識別子パスワードを指定しないでください。再セットアップしたあと，再実行してください。

KFPA11563-E
KFPA11732-E
組み込みDBにほかのユーザーがアクセスしているため，排他待ちタイムアウトになりました。
組み込みDBへのアクセスをすべて停止してから再実行してください。

なお，KAVSで始まるメッセージの詳細については，マニュアル「JP1/Automatic Job Management System 2 メッセージ　2.3 KAVSで始まるメッセージ（スケジューラーに関するメッセージ）」を参照してください。

使用例

物理ホストで初めてスケジューラーサービス（ここでは「AJSROOT1」）をレプリケーションの対象として，組み込みDBを拡張します。このとき，組み込みDBは大規模で構築されていて，拡張するデータベース領域を「/dev/EMBDB」に作成します。

ajsembdbrpsetup -F AJSROOT1 -d /var/EMBDB

物理ホストですでに組み込みDBが拡張されていて，スケジューラーサービス（ここでは「AJSROOT2」）もレプリケーションの対象として，組み込みDBを拡張します。このとき，組み込みDBは大規模で構築されています。

ajsembdbrpsetup -F AJSROOT2

物理ホストで初めてスケジューラーサービス（ここでは「AJSROOT1」）をレプリケーションの対象として，組み込みDBを，RAWファイルを使用して拡張します。このとき，組み込みDBは大規模で構築されていて，拡張するデータベース領域を「/dev/vg00/rdsk1」に作成します。

ajsembdbrpsetup -F AJSROOT1 -d /dev/vg00/rdsk1 -r -l

クラスタ構成の論理ホスト（ここでは「lhost」）で，初めてスケジューラーサービス（ここでは「AJSROOT1」）をレプリケーションの対象として，組み込みDBを拡張します。
このとき，組み込みDBは大規模で構築されていて，拡張するデータベース領域を「/shdsk/RDAREA」に作成します。

実行系

 ajsembdbrpsetup -mh lhost -F AJSROOT1 -d /shdsk/RDAREA -l -c
 jbsgetcnf -h lhost > 退避ファイル名

待機系

 jbssetcnf 退避ファイル名※

注※　退避ファイルは，実行系で取得したファイルを使用します。

物理ホストのスケジューラーサービス（ここでは「AJSROOT1」）を組み込みDB拡張前の環境に戻します。

ajsembdbrpsetup -F AJSROOT1 -e

ajsembdbidlist

形式

ajsembdbidlist

機能

構成定義に登録されている，組み込みDBを操作するコマンドに必要な情報を表示します。

表示される情報は次のとおりです。

セットアップ識別子と組み込みDB運用ディレクトリの関連づけ

スケジューラーサービスと組み込みDB運用ディレクトリの関連づけ

なお，このコマンドは，JP1/AJS2および組み込みDBの稼働状態に関係なく実行できます。

実行権限

Windowsの場合：Administrators権限

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

JP1/AJS2 - Managerのインストール先フォルダ¥tools¥

UNIXの場合

/opt/jp1ajs2/tools/

表示形式

次の形式で構成定義に登録されている情報を表示します。

セットアップ識別子と組み込みDB運用ディレクトリの関連づけ

スケジューラーサービスと組み込みDB運用ディレクトリの関連づけ

表示する情報は次のとおりです。

タイトルおよびコマンド実行日付を表示します。

構成定義に登録されているセットアップ識別子，および組み込みDB運用ディレクトリを表示します。各項目は空白1文字で区切られます。

論理ホスト名を表示します。なお，物理ホストの場合は「JP1_DEFAULT」と表示します。

構成定義に登録されているスケジューラーサービス名，セットアップ識別子，および組み込みDB運用ディレクトリを表示します。各項目は空白1文字で区切られます。

表示内容の終了を示します。

表示例

_JA0～_JA2までは，それぞれAJSROOT1，AJSROOT2，ROOT3でajsembdbsetupコマンドまで完了（ISAMからの移行完了）し，_JA3は，ajsembdbbuildコマンドまで（DB環境の構築まで）完了している場合の表示例を次に示します。

*** Embeddb setup-id list 2006/04/18 08:15:00
_JA0 C:¥win32app¥hitachi¥hirdb_e_JA0
_JA1 C:¥win32app¥hitachi¥hirdb_e_JA1
_JA2 C:¥win32app¥hitachi¥hirdb_e_JA2
_JA3 C:¥win32app¥hitachi¥hirdb_e_JA3

Host-Name:JP1_DEFAULT
AJSROOT1 _JA0 C:¥win32app¥hitachi¥hirdb_e_JA0

Host-Name:LHOST1
AJSROOT2 _JA1 C:¥win32app¥hitachi¥hirdb_e_JA1
ROOT3 _JA2 C:¥win32app¥hitachi¥hirdb_e_JA2
--

注意事項

Windows Server 2008のマシンでこのコマンドを実行する際には，コマンドプロンプトを管理者として起動する必要があります。コマンドプロンプトを起動する際は，Windowsの［スタート］メニューの［コマンドプロンプト］を右クリックし，ショートカットメニューから［管理者として実行］を選択してください。なお，UAC機能が無効の場合は，コマンドプロンプトを管理者として起動する必要はありません。

戻り値

0 | 正常終了。 | 登録情報を表示しました（表示すべき情報がない場合も含みます）。
4 | 異常終了。 | オプション不正。
8 | 異常終了。 | 構成定義の読み込みに失敗。

エラー発生時の対処

このコマンドの実行時に発生するエラーとその対処方法を次に示します。

メッセージID・メッセージ | 原因 | 対処方法
KAVS2116-E There is an error in the specified option. Illegal option(オプション) exists. | 指定したオプションに誤りがあります。不正なオプションが指定されています。 | オプションを確認して再度実行してください。
KAVS0903-E System error occurred. : Get Conf NG | 構成定義の読み込みに失敗しました。 | コマンド実行権限を確認して再度実行してください。再度実行しても発生する場合は，システム管理者に連絡してください。

ajsembdbsetup

形式

ajsembdbsetup
    [-mh 論理ホスト名]
    [-F サービス名]
    [-p 組み込みDB通信ポート]
    [-m [-s PDSENDMEMSIZE] [-r PDRECVMEMSIZE]]
    [-ct 最大待ち合わせ時間]
    [-tp テーブル名プリフィックス]
    [-q]
    [-c]
    [-ru { l | m | s }]
    [-id セットアップ識別子]

機能

JP1/AJS2スケジューラーサービスの，既存のISAMデータベースを組み込みDBに移行します。

組み込みDBの標準インストールをして，JP1/AJS2を新規インストールした場合は，すべてのオプション指定を省略できます。この場合，物理ホストのスケジューラーサービスの「AJSROOT1」を組み込みDBに移行します。

実行権限

Windowsの場合：Administrators権限

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

JP1/AJS2 - Managerのインストール先フォルダ¥tools¥

UNIXの場合

/opt/jp1ajs2/tools/

引数

-mh 論理ホスト名

処理対象とするJP1論理ホスト名を指定します。指定できる文字数は，1～32（単位：バイト）です。

省略した場合，環境変数JP1_HOSTNAMEの設定があれば，環境変数値が仮定されます。環境変数JP1_HOSTNAMEの指定がない場合は，物理ホストが仮定されます。

-F サービス名

処理対象とするスケジューラーサービスのサービス名を指定します。

省略した場合，環境変数AJSCONFの設定があれば，環境変数値が仮定されます。環境変数AJSCONFの指定がない場合は，デフォルトのスケジューラーサービスが仮定されます。

-p 組み込みDB通信ポート

組み込みDB接続ポートを10進数で指定します。

省略した場合，「22200」が仮定されます。

構成定義のRDBPORTパラメーターに設定されます。

指定できる値の範囲は5,001～65,535となります。

-m [-s PDSENDMEMSIZE] [-r PDRECVMEMSIZE]

組み込みDBのプロセス間メモリー通信機能で使用する，メモリー通信に使用する送信バッファサイズ，およびメモリー通信に使用する受信バッファサイズを指定する場合に指定します。

構成定義のRDBIPC，RDBSENDMEMSIZE，およびRDBRECVMEMSIZEパラメーターに設定されます。

-s
メモリー通信に使用する送信バッファサイズを10進数で指定します。

-r
メモリー通信に使用する受信バッファサイズを10進数で指定します。

-sまたは-rオプションで指定できる値の範囲は，それぞれ4～2,097,152となります。

-sまたは-rオプションを省略した場合は，組み込みDBの標準値で動作します。

JP1/AJS2での最適値は，送信バッファサイズ=100，受信バッファサイズ=100です。

-mオプションを省略した場合はプロセス間メモリー通信機能を使用して-s，-rオプション指定の有無にかかわらず送信バッファサイズ=100，受信バッファサイズ=100を設定します。

-ct 最大待ち合わせ時間

RDB接続待ち合わせを打ち切る時間を，0～60（単位：分）の範囲の値で指定します。

省略した場合，「1」が仮定されます。

「0」を指定した場合は，RDB接続待ち合わせ機能が無効になります。

このオプションに，0～60以外の値を指定した場合，不正な値が構成定義に設定され，JP1/AJS2起動時にKAVS1003-Eが出力されることがあります。また，スクリプト実行中にKAVA0334-Eエラーが出力される場合もあります。

-tp テーブル名プリフィックス

JP1/AJS2スケジューラーデータベースのテーブル名プリフィックスを4バイト以内で指定します。

省略した場合，「AJS」が仮定されます。

構成定義TABLENAMEPREFIXパラメーターの設定が変更されます。

-q

スキーマ作成をスキップする場合に指定してください。例えば，同一組み込みDB内に複数のスケジューラーサービスを構築する際，二つ目以降に設定するスケジューラーサービスをセットアップする場合に指定します。また，ajsembdbsetupスクリプト実行時に，スキーマ作成に成功し，それ以降のテーブル作成時にエラーが発生した場合などにもこのオプションを指定する必要があります。

なお，初めてセットアップする場合はテーブル作成時にエラーが発生しますので，このオプションは指定しないでください。

-c

スキーマ作成が成功し，それ以降のテーブル作成処理などでエラーが発生したあとに再セットアップを行う場合に，-qオプションと同時に指定してください。

-ru { l | m | s }

空き領域の再利用機能を使用する場合に指定します。l，m，sと同時に指定した場合，再利用開始ポイントを指定することができます。

-ruを省略した場合は，-ru lが仮定されます。

-ruの後ろに空き領域の再利用機能の再利用開始ポイントを指定します。データ領域の使用率がここで指定したポイントに達した場合，空き領域の再利用機能が動作します。

l，m，sはそれぞれajsembdbbuildのデータベースモデル，大・中・小規模に対応しています。ajsembdbbuildで指定したデータベースモデルの規模と同じオプションを指定してください。

各テーブルに設定されるデータベース領域に対する空き領域の再利用機能の再利用開始ポイントは次のとおりになります。

表20-9　各テーブルに設定されるデータベース領域に対する空き領域の再利用機能の再利用開始ポイント

テーブル名 | 各テーブルで設定される空き領域の再利用機能の再利用開始ポイント
AJSUNIT | データベース領域AJS2DATA全体のセグメントの10%
AJSARROW
AJSBODY
AJSSCH
AJSCAL
AJSPERF
AJSENTRY
AJSGEN
AJSSTAT | データベース領域AJS2DATA全体のセグメントの20%

注

テーブル名は，テーブルプリフィックスを標準の「AJS」としている場合の名称です。

なお，ajsembdbbuildのデータベースモデル，大・中・小規模で作成される領域のセグメントの全体量は次のとおりです。

表20-10　ajsembdbbuildのデータベースモデル，大・中・小規模で作成される領域のセグメントの全体量

データベース領域・名称 | 小規模 | 中規模 | 大規模
データ領域AJS2DATA | 4,940 | 14,920 | 30,800

-id セットアップ識別子

組み込みDBを識別するセットアップ識別子を「_JAn」（nは0～9またはA～Z）の4文字で指定します。ajsembdbbuildコマンドの-idオプションで指定した値を指定してください。

このオプションを省略した場合は，_JA0が仮定されます。

注意事項

このスクリプトを実行する前に，JP1/AJS2 - Managerホストで論理ホストを含め，すべてのJP1/AJS2サービス，JP1/AJS2 Monitorサービス，およびJP1/AJS2 Console Agentサービスを停止してください。サービスを停止しないでこのスクリプトを使用した場合でも，正常終了する場合があるので注意してください。

このスクリプトを実行すると，移行前のISAMのデータベースファイルを格納しているディレクトリにバックアップフォルダを作成し，その後，組み込みDBに移行します。セットアップ後，運用に問題がなければ必要に応じてバックアップフォルダを削除してください。

ajsembdbsetupは，スクリプトで実装されています。このため，オプションに不当に長い文字列や不正な文字列や値を指定すると，予期せぬエラーが発生することがあります。オプション指定値は，DBMSおよびJP1/AJS2で規定されている範囲内の文字列または数値を指定してください。

スケジューラーデータベースのセットアップに必要のない構成定義の指定に誤りがある場合でも，KAVS1003-Eメッセージが出力されます。このメッセージが複数回出力されても，このスクリプトが正常終了した場合にはセットアップ処理は完了していますので，再セットアップの必要はありません。このスクリプト終了後，KAVS1003-Eメッセージに従い構成定義の誤りを訂正してください。

UNIXで文字コードを変更して環境を構築するときは，環境変数のLANGを正しく設定してください。

一度スケジューラーサービスのデータベースをISAMから組み込みDBに移行に成功したあとに，何らかの理由でajsembdbsetupを再実行する際は，組み込みDBとして設定されたスケジューラーサービスを，一度ISAMに変更し直す必要があります。

ajsembdbsetupを実行し，組み込みDBサーバへのアクセスでエラーが発生した場合，組み込みDB接続時のエラー情報が，ajsembdbsetupを実行したときの作業ディレクトリにトレースファイル（pderr1.trcおよびpderr2.trc）として作成されます。スクリプトの再実行によって，正常終了した場合は，これらのファイルを削除してください。

このコマンドを同時に複数実行しないでください。同時に複数実行した場合，次に示す現象が起こるおそれがあります。

スケジューラーデータベースが不正になり，使用できなくなる。

このコマンドが，不当にエラーになる。

構成定義情報が不正になり，JP1/AJS2が運用できなくなる。

Windows Server 2008のマシンでこのコマンドを実行する際には，コマンドプロンプトを管理者として起動する必要があります。コマンドプロンプトを起動する際は，Windowsの［スタート］メニューの［コマンドプロンプト］を右クリックし，ショートカットメニューから［管理者として実行］を選択してください。なお，UAC機能が無効の場合は，コマンドプロンプトを管理者として起動する必要はありません。

Windows Server 2008でUAC機能が無効の場合に，Administrators権限のないユーザーでこのコマンドを実行すると，メッセージKAVS0190-Eが出力されてコマンドは異常終了します。Administrators権限のあるユーザーでこのコマンドを再実行してください。

戻り値

0 | 正常終了。
0以外 | 異常終了。

エラー発生時の対処

スクリプト実行時にエラーが発生する場合があります。エラーが発生した場合は次の表に従って問題に対処し，再実行してください。

メッセージID
原因
対処方法

BACKUP
ERROR
ISAMのデータベースファイルのバックアップに失敗。
サービス稼働中にスクリプトを実行した場合など，移行前のISAMファイルのバックアップに失敗しました。ISAMファイルを必要に応じて手動で削除してください。
次に示す拡張子のファイルがISAMファイルとなりますので，それ以外のファイルを削除しないように注意してください。

・Windowsの場合

拡張子が「.DRF」，「.KDF」，「.K01」，「.K02」のファイル

・UNIXの場合

拡張子が「.DAT」，「.DEF」，「.K01」，「.K02」のファイル

DBTYPE
ERROR
移行元スケジューラーサービスのデータベース種別がISAMではない。
移行元スケジューラーサービスのデータベース種別をISAMにしてください。
このスクリプトを使用した再セットアップ時にこのメッセージが出力された場合は，次のように対処してください。

スケジューラーサービスを停止します。

バックアップされたISAMファイルをデータベースディレクトリへ戻します。

ajsembdbsetupスクリプトで，組み込みDBへの移行を行います。ajsembdbsetupスクリプトに-q，-cオプションを指定してください。

Invalid value specified in -ct option.
-ctオプションの引数に指定できない値が設定されている。
-ctオプションの引数に0から60以内の整数を指定してください。

KAVS0178-E
テーブルが作成済みである。
-q，-cオプションを同時に指定して再実行してください。

KAVS0190-E
ホストには指定されたスケジューラーサービスが定義されていない。
-Fオプションにすでに存在しているスケジューラーサービス名を指定してください。

KAVS0985-E
データベースに接続できない。
次の問題が考えられます。

組み込みDBサーバが起動していない。

-pオプションで指定したポート番号が組み込みDBのポート番号と一致していない。

これらの問題を解決してから再実行してください。

KAVS0936-E
スキーマはすでに定義されている。
スキーマが作成済みの場合は，-qオプションを指定して再実行してください。

KAVS0981-E
テーブルが見つからない。
ISAMのデータベースファイルがありません。あらかじめ，ISAMでセットアップされている必要があります。

KAVS0996-E
指定されたオプションおよび値が不正。
オプションおよびオプションに指定する値を修正してください。

KAVS1003-E
構成定義に誤った指定がある。
オプションで指定した値を正しい値に修正して再実行してください。

KFPA11723-E
組み込みDBが停止している。
組み込みDBを起動してください。

KFPA11204-E
表がない。
-tpの値を見直して，正しいテーブルプリフィックスを指定してください。
上記のことを見直して再実行してください。

KFPA11563-E
KFPA11732-E
組み込みDBにほかのユーザーがアクセスしているため，排他待ちタイムアウトになった。
組み込みDBへのアクセスをすべて停止してから再実行してください。

The embedded DB work directory associated with the setup identifier specified by the -id option is invalid.
-idオプションに指定したセットアップ識別子に関連づけられている組み込みDB運用ディレクトリが不正。
構成定義に設定されている組み込みDB運用ディレクトリに正しい値を指定し，再実行してください。
登録済みのセットアップ識別子および組み込みDB運用ディレクトリは，ajsembdbidlistコマンドで確認できます。
ajsembdbidlistコマンドの詳細は，「20. セットアップ時に使用するコマンド　ajsembdbidlist」を参照してください。

The setup identifier specified with the -id option is not registered.
-idオプションで指定したセットアップ識別子は登録されていない。
登録済みのセットアップ識別子を指定し，再実行してください。なお，登録済みのセットアップ識別子および組み込みDB運用ディレクトリは，ajsembdbidlistコマンドで確認できます。
ajsembdbidlistコマンドの詳細は，「20. セットアップ時に使用するコマンド　ajsembdbidlist」を参照してください。

Failed to register the configuration definition.
構成定義の登録に失敗した。
-q，-cオプションを同時に指定して再実行してください。

なお，KAVSで始まるメッセージの詳細については，マニュアル「JP1/Automatic Job Management System 2 メッセージ　2.3 KAVSで始まるメッセージ（スケジューラーに関するメッセージ）」を参照してください。

ajsembdbunset

形式

ajsembdbunset
     {-r[-e]|-e[-r]}
     [-id 組み込みDBセットアップ識別子]
     [-i 組み込みDB運用ディレクトリ名称]

形式1（OSに登録された組み込みDBを解除：UNIX限定）

ajsembdbunset
     -r
     [-id 組み込みDBセットアップ識別子]
     [-i 組み込みDB運用ディレクトリ名称]

形式2（組み込みDBの再構築）

ajsembdbunset
     -e
     [-id 組み込みDBセットアップ識別子]
     [-i 組み込みDB運用ディレクトリ名称]

機能

組み込みDBをアンセットアップします。

組み込みDBの稼働状態に関係なく実行できます。また，アンセットアップする組み込みDBにスケジューラーデータベースを作成しているすべてのスケジューラーサービスが停止中の場合だけ実行できます。

実行権限

Windowsの場合：Administrators権限

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

JP1/AJS2 - Managerのインストール先フォルダ¥tools¥

UNIXの場合

/opt/jp1ajs2/tools/

引数

-r

組み込みDBをバージョンアップする場合に指定します。

このオプションはUNIX限定オプションです。

このオプションを指定して実行すると，指定したディレクトリで運用されている組み込みDBのOS登録を解除します。組み込みDBのデータは削除されません。

-e

組み込みDBを再構築する場合に指定します。

組み込みDBのデータを削除しますので，データを保存しておきたい場合は，事前にデータを退避してください。

UNIXの場合，-eオプションを指定したときは，指定したディレクトリで運用されている組み込みDBのOS登録の解除も行います。

-id 組み込みDBセットアップ識別子

組み込みDBを識別するセットアップ識別子を「_JAn」（nは0～9またはA～Z）の4文字で指定します。

このオプションを省略した場合は，_JA0が仮定されます。

登録済みのセットアップ識別子および組み込みDB運用ディレクトリは，ajsembdbidlistコマンドで確認できます。

ajsembdbidlistコマンドの詳細は，「20. セットアップ時に使用するコマンド　ajsembdbidlist」を参照してください。

-i 組み込みDB運用ディレクトリ名称

組み込みDBの運用ディレクトリ名称を指定します。

このオプションは，ajsembdbbuildコマンドが正常に終了しなかった場合など，-idオプションを指定したアンセットアップが行えない場合だけ使用してください。

注意事項

このコマンドを実行した場合，次に示すメッセージが出力されます。
出力メッセージ：ssss Embeddb DELETE?(y/n):
ssss：セットアップ識別子
環境削除の確認メッセージですので，問題ない場合は「y」を入力してください。

このコマンドを実行する場合，指定した運用ディレクトリが正しいかを確認してください。

このスクリプトを実行する前に，JP1/AJS2 - Managerホストで論理ホストを含め，すべてのJP1/AJS2サービス，JP1/AJS2 Monitorサービス，およびJP1/AJS2 Console Agentサービスを停止してください。サービスを停止しないでこのスクリプトを使用した場合でも，正常終了する場合があるので注意してください。

このコマンドは，スケジューラーサービスが起動していても，組み込みDBを強制的に終了させてしまうため，スケジューラーサービスが起動しているかどうかを確認する必要があります。

このコマンドはスクリプトで実装されています。このため，オプションに不当に長い文字列や不正な文字列や値を指定すると，予期しないエラーが発生することがあります。オプション指定値は，DBMSおよびJP1/AJS2で規定されている範囲内の文字列または数値を指定してください。

このコマンドを同時に複数実行しないでください。同時に複数実行した場合，次に示す現象が起こるおそれがあります。

不当なメッセージを出力したり，本来出力するはずのメッセージを出力しなかったりするなど，メッセージ出力が不正になる。

このコマンドが，不当にエラーになる。

-rオプションだけの実行でOS登録を解除したあとは，組み込みDBのバージョンアップ作業が終了するまで，組み込みDB操作コマンドは使用できません。使用した場合，KAVS2115-Eエラーになります。

クラスタ運用時，このコマンドは実行系ホストと待機系ホストの両方で実行してください。実行系ホスト（ajsembdbbuildコマンドの-ehオプションに指定したホスト）では，共有ディスクをマウントした状態で実行してください。なお，このコマンドを実行する場合は，実行系ホストから実行してください。実行系ホストで実行する前に待機系ホストで共有ディスクをマウントした状態でこのコマンドを実行するとKFPS04619-Eエラーになります。その場合は，実行系ホストに共有ディスクをマウントしてこのコマンドを実行したあと，待機系ホストで-iオプションを指定して再度このコマンドを実行してください。

組み込みDBを強制停止させている場合は，いったん起動して正常停止させたあとに実行してください。

Windows Server 2008のマシンでこのコマンドを実行する際には，コマンドプロンプトを管理者として起動する必要があります。コマンドプロンプトを起動する際は，Windowsの［スタート］メニューの［コマンドプロンプト］を右クリックし，ショートカットメニューから［管理者として実行］を選択してください。なお，UAC機能が無効の場合は，コマンドプロンプトを管理者として起動する必要はありません。

Windows Server 2008でUAC機能が無効の場合に，Administrators権限のないユーザーでこのコマンドを実行すると，コマンドは正常終了しますが，アンセットアップは正常に行われません。Administrators権限のあるユーザーでこのコマンドを再実行してください。

戻り値

0 | 正常終了。
0以外の値 | 異常終了。

エラー発生時の対処

コマンドエラー発生時は，次に示す表に従って対処してください。

メッセージID | 現象 | 対処方法
KAVS0996-E | 指定したオプションに誤りがあります。 | オプションの指定内容を見直してください。
KAVS2104-E | 組み込みDBがセットアップされていません。 | すでに組み込みDBの環境は削除されています。
KAVS2115-E | 組み込みDBがインストールされていません。 | 削除する組み込みDBがインストールされていません。
KAVS2116-E | 指定したオプションに誤りがあります。 | メッセージに出力されているオプションを見直して再実行してください。
KAVS2117-E | コマンド実行時にエラーが発生しました。 | 保守情報に出力されているメッセージを参照してください。

ajsembdbvrupd

形式

Windowsの場合

ajsembdbvrupd
     [-mh 論理ホスト名]
     [-F スケジューラーサービス名]
     [-id セットアップ識別子]
     -i 組み込みDB運用ディレクトリ

UNIXの場合

ajsembdbvrupd
     [-mh 論理ホスト名]
     [-F スケジューラーサービス名]
     [-id セットアップ識別子]
     [-i 組み込みDB運用ディレクトリ]

機能

バージョン7の組み込みDB環境を08-00以降にバージョンアップしたあと，組み込みDBを操作するコマンド実行するために，必要な情報を構成定義に登録します。

なお，このコマンドは，JP1/AJS2および組み込みDBが停止している状態で実行してください。

実行権限

Windowsの場合：Administrators権限

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

JP1/AJS2 - Managerのインストール先フォルダ¥tools¥

UNIXの場合

/opt/jp1ajs2/tools/

引数

-mh 論理ホスト名

-iオプションで指定する組み込みDBを使用するスケジューラーサービスの論理ホスト名を指定します。指定できる文字数は，1～32（単位：バイト）です。このオプションが省略された場合は，環境変数JP1_HOSTNAMEが参照されます。また，このオプションが省略され，かつ，環境変数JP1_HOSTNAMEが設定されていない場合は，物理ホスト（JP1_DEFAULT）が仮定されます。

-mhオプション | ○ | × | ×
環境変数JP1_HOSTNAME | × | ○ | ×
コマンドの解釈 | 指定値が有効になります。 | 環境変数JP1_HOSTNAMEに設定されている値が有効になります。 | 物理ホスト（JP1_DEFAULT）を仮定します。

（凡例）

○：指定する

×：指定しない

-F スケジューラーサービス名

-iオプションで指定する組み込みDBを使用するスケジューラーサービス名を指定します。

なお，すでに組み込みDB運用ディレクトリとの関連づけが行われているスケジューラーサービスが指定された場合は，エラーとなります。

このオプションが省略された場合，環境変数AJSCONFに設定されているスケジューラーサービス名が仮定されています。また，オプションが省略され，かつ，環境変数AJSCONFが設定されていない場合は，デフォルトスケジューラーサービス名が仮定されます。

-Fオプション | ○ | × | × | ×
環境変数AJSCONF | × | ○ | × | ×
デフォルトスケジューラーサービス | × | × | ○ | ×
コマンドの解釈 | 指定値が有効になります。 | 環境変数AJSCONFに設定されている値が有効になります。 | デフォルトスケジューラーサービスに設定されている値が有効になります。 | スケジューラーサービス未指定のエラーになります。

（凡例）

○：指定する

×：指定しない

-id セットアップ識別子

組み込みDBを識別するセットアップ識別子を「_JAn」（nは0～9またはA～Z）の4文字で指定します。

Windowsの場合は，組み込みDBをインストールするときに指定したセットアップ識別子と同じ値を指定してください。UNIXの場合は，規定値の範囲内で任意です。

このオプションを省略した場合は，_JA0が仮定されます。

なお，登録済みのセットアップ識別子を指定した場合，登録されているセットアップ識別子に関連づけられている組み込みDB運用ディレクトリと-iオプションで指定された組み込みDB運用ディレクトリが同じディレクトリの場合は，そのまま情報を登録する処理が行われます。異なるディレクトリの場合は，KAVS2116-Eのメッセージを出力して終了します。

例えば，スケジューラーサービスAJSROOT1とAJSROOT2が同じ組み込みDB運用ディレクトリを使用する場合，次のように-iオプションに同じ値を指定してajsembdbvrupdコマンドを実行します。

ajsembdbvrupd -F AJSROOT1 -id _JA0 -i C:¥win32app¥hitachi¥hirdb_e_JA0
ajsembdbvrupd -F AJSROOT2 -id _JA0 -i C:¥win32app¥hitachi¥hirdb_e_JA0

ただし，次のように-iオプションに指定する値が異なった場合は，KAVS2116-Eのエラーとなります。

ajsembdbvrupd -F AJSROOT1 -id _JA0 -i C:¥win32app¥hitachi¥hirdb_e_JA0
ajsembdbvrupd -F AJSROOT2 -id  JA0 -i C:¥win32app¥hitachi¥hirdb_~1

登録済みのセットアップ識別子および組み込みDB運用ディレクトリは，ajsembdbidlistコマンドで確認できます。ajsembdbidlistコマンドの詳細は，「20. セットアップ時に使用するコマンド　ajsembdbidlist」を参照してください。

-i 組み込みDB運用ディレクトリ

-mhオプション，-Fオプションで指定したスケジューラーサービス，および-idオプションで指定したセットアップ識別子に関連づける組み込みDB運用ディレクトリを指定します。

組み込みDB運用ディレクトリは，絶対パスで指定してください。また，空白を含むパスを指定する場合は，パス全体を「"（ダブルクォーテーションマーク）」で囲んでください。

なお，UNIXの場合は，このオプションを省略できます。省略した場合は，/opt/HiRDB_Jが仮定されます。

注意事項

このコマンドは，スクリプトで実装されています。そのため，オプションに不当に長い文字列や不正な文字列や値を指定すると，予期しないエラーが発生することがあります。オプション指定値は，DBMSおよびJP1/AJS2で規定されている範囲内の文字列または数値を指定してください。

このコマンドを同時に複数実行しないでください。同時に複数実行した場合，次に示す現象が起こるおそれがあります。

このコマンドが，不当にエラーになる。

構成定義情報が不正になり，JP1/AJS2が運用できなくなる。

戻り値

0 | 正常終了。 | 構成定義の登録に成功。
4 | 異常終了。 | オプション不正。
8 | 異常終了。 | 構成定義の登録に失敗。

エラー発生時の対処

このコマンド実行時に発生するエラーとその対処方法を次に示します。

メッセージID・メッセージ
原因
対処方法

KAVS2116-E There is an error in the specified option. Options(オプション) are needed.
指定したオプションに誤りがあります。必須または必要なオプションがありません。
オプションを確認して再度実行してください。

KAVS2116-E There is an error in the specified option. Illegal option(オプション) exists.
指定したオプションに誤りがあります。不正なオプションが指定されています。
オプションを確認して再度実行してください。

KAVS2116-E There is an error in the specified option. Value of option (オプション) is not specified.
指定したオプションに誤りがあります。オプションの値が指定されていません。
オプションを確認して再度実行してください。

KAVS2116-E There is an error in the specified option. Option(オプション) appears twice or more.
指定したオプションに誤りがあります。オプションが2回以上指定されています。
オプションを確認して再度実行してください。

KAVS2116-E There is an error in the specified option. Invalid value for option(オプション).
指定したオプションに誤りがあります。オプションの値に誤りがあります。
オプションを確認して再度実行してください。

オプションに「-i」が表示された場合，-iオプションに指定された組み込みDB運用ディレクトリが不正です。
-iオプションに正しい組み込みDB運用ディレクトリを指定してください。

オプションに「-id」が表示された場合，-idオプションに指定されたセットアップ識別子の指定が誤っています。セットアップ識別子は，「_JAn」（nは0～9またはA～Z）の4文字で指定します。または，指定したセットアップ識別子は，すでに異なる組み込みDB運用ディレクトリで登録されています。
-idオプションに正しいセットアップ識別子を指定してください。また，登録済みのセットアップ識別子は，ajsembdbidlistコマンドで確認してください。

オプションに「-mh,-F」が表示された場合，次の要因が考えられます。

-mh，-Fオプションで指定した論理ホスト名またはスケジューラーサービス名がない

データベース種別が組み込みDBではない

すでに組み込みDB運用ディレクトリが関連づけられている

-mh，-Fオプションに正しい論理ホスト名またはスケジューラーサービス名を指定してください。または，組み込みDB運用ディレクトリと関連づけられていないスケジューラーサービス名を指定してください。

KAVS0903-E System error occurred. : Set Conf NG
構成定義の登録に失敗しました。
コマンド実行権限を確認して再度実行してください。再度実行しても発生する場合は，システム管理者に連絡してください。

ajsovsetup

形式

ajsovsetup

機能

JP1/Cm2またはhp OpenViewの登録ファイルを設定します。

設定するファイルは次の5種類です。

アプリケーション管理ファイル

フィールド定義ファイル

トラップアクション定義ファイル

信任コマンド定義ファイル

拡張MIB定義ファイル（UNIX限定）

実行権限

Windowsの場合：Administrators権限

UNIXの場合：スーパーユーザー権限

注意事項

HP-UX（IPF版を除く）またはSolarisでNNMと連携する場合，このコマンドは，環境変数LANGにJP1/Cm2またはhp OpenViewのセットアップ言語を設定したあと，実行してください。使用できる文字コードを次に示します。

| 日本語 | 英語
シフトJISコード | EUCコード | ASCIIコード
HP-UX | ja_JP.SJIS | ja_JP.eucJP | C
Solaris | ja_JP.PCK | ja，またはjapanese | C

なお，環境変数LANGを指定しなかった場合，「C」が仮定されます。

UNIXの場合，このコマンドを実行すると拡張MIB定義ファイルにJP1/AJS2のMIB定義情報を登録します。登録したMIB定義情報を有効にするためには，SNMPエージェントの再起動が必要です。
SNMPエージェントの再起動については，マニュアル「JP1/Cm2/Extensible SNMP Agent」を参照してください。

戻り値

0 | 正常終了。
0以外の値 | 異常終了。

補足事項

コマンドに引数を指定する必要はありません（指定しても無視されます）。

使用例

JP1/Cm2またはhp OpenViewの登録ファイルを設定します。

ajsovsetup

ajsqlsetup

形式

JP1/AJS2 - Managerの場合

ajsqlsetup
    [-h 論理ホスト名]
    [-F スケジューラーサービス名]
    [-nc]
    [[-m][-a]]|[-r]|[-u]

JP1/AJS2 - Agentの場合

ajsqlsetup
    [-h 論理ホスト名]
    [-a]|[-u]

機能

キューレスジョブ実行環境をセットアップします。このコマンドによって設定される情報を次に示します。

サービスの登録

キューレスジョブの実行で使用する次のサービスを登録します。

サービス | JP1/AJS2 - Manager | JP1/AJS2 - Agent
キューレスエージェントサービス | ○※1 | ○※1
キューレスファイル転送サービス | ○※2 | －

サービスの依存関係の設定

JP1/AJS2サービスと，キューレスエージェントサービスまたはキューレスファイル転送サービスとの依存関係を設定します。

JP1/AJS2サービスが依存するサービス | JP1/AJS2 - Manager | JP1/AJS2 - Agent
キューレスエージェントサービス | ○※3 | －
キューレスファイル転送サービス | ○※2 | －

通信ポートの設定

キューレスジョブの実行で使用する次の通信ポートをservicesファイルに登録します。

通信ポート（サービス名：ポート番号） | JP1/AJS2 - Manager | JP1/AJS2 - Agent
キューレスジョブの実行（jp1ajs2qlagt：20300） | ○ | ○
キューレスファイルの転送（jp1ajs2qlftp：20301） | ○ | ○

構成定義情報の設定

キューレスジョブ実行で使用する構成定義情報の設定をします。

設定情報
JP1/AJS2 - Manager
JP1/AJS2 - Agent

定義キー
環境設定
パラメーター

[JP1_DEFAULT¥JP1AJSMANAGER]
"QLMANCHARCODE"=UTF-8
○※4
－

[JP1_DEFAULT¥JP1AJSMANAGER¥スケジューラーサービス名]
または
[論理ホスト名¥JP1AJSMANAGER¥スケジューラーサービス名]
"QLJOBUSE"dword:00000001
○※2
－

"QUEUELESSMULTIREQ"dword:00000001
○※2
－

[JP1_DEFAULT¥JP1QLAGENT]

Windowsの場合
"AJSQL_JOBMAX"=dword:00000005

UNIXの場合
"AJSQL_JOBMAX"=dword:00000400

○※1
○※1

Windowsの場合
"AJSQL_JOBWAITMAX"=dword:00000800

UNIXの場合
"AJSQL_JOBWAITMAX"=dword:00000000

○※1
○※1

Windows
"AJSQL_TRACELOGFILE"=JP1/AJS2 - ManagerおよびJP1/AJS2 - Agentのインストール先フォルダ¥log¥tracelog.ql

UNIX
"AJSQL_TRACELOGFILE"=/var/opt/jp1ajs2/log/tracelog.ql

○※1
○※1

[JP1_DEFAULT¥JP1QLAGENT]
または
[論理ホスト名¥JP1QLAGENT]
物理ホストの場合

Windows
"AJSQL_LOGFILE"=JP1/AJS2 - ManagerおよびJP1/AJS2 - Agentのインストール先フォルダ¥log

UNIX
"AJSQL_LOGFILE"=/var/opt/jp1ajs2/log

論理ホストの場合

Windows
"AJSQL_LOGFILE"=共有ディレクトリ¥log

UNIX
"AJSQL_LOGFILE"=共有ディレクトリ/log

○※1
○※1

"AJSQL_LOGSIZE"=dword:00002000
○※1
○※1

物理ホストの場合

Windows
"AJSQL_STATFILE"=JP1/AJS2 - ManagerおよびJP1/AJS2 - Agentのインストール先フォルダ¥log¥ajsqlstat.dat

UNIX
"AJSQL_STATFILE" =/var/opt/jp1ajs2/log/ajsqlstat.dat

論理ホストの場合

Windows
"AJSQL_STATFILE"=共有ディレクトリ¥log¥ajsqlstat.dat

UNIX
"AJSQL_STATFILE"=共有ディレクトリ/log/ajsqlstat.dat

○※1
○※1

"AJSQL_STATSIZE"=dword:00000800
○※1
○※1

ジョブID管理ファイルの作成

キューレスジョブ実行で，キューレスジョブに付加するジョブIDを管理するファイルを作成します。

ファイル名
JP1/AJS2 - Manager
JP1/AJS2 - Agent

Windows
スケジューラーサービスのDBディレクトリ¥AJSQLJID.dat

UNIX
スケジューラーサービスのDBディレクトリ/AJSQLJID.dat

○※2
－

（凡例）

○：設定できる。

－：設定できない。

注※1

JP1/AJS2 - Manager上またはJP1/AJS2 - Agent上でエージェント機能を使用する場合，-aオプションを指定したときだけ設定されます。

注※2

JP1/AJS2 - Manager上でマネージャー機能を使用する場合，-mオプションを指定したときだけ設定されます。

注※3

JP1/AJS2 - Manager上でエージェント機能を使用する場合，-aオプションを指定したときだけ設定されます。

注※4

Linux版のJP1/AJS2 - Manager上でマネージャー機能を使用する場合，-mオプションを指定したときだけ設定されます。

実行権限

Windowsの場合：Administrators権限

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

JP1/AJS2 - Managerのインストール先フォルダ¥bin¥

JP1/AJS2 - Agentのインストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1ajs2/bin/

引数

-h 論理ホスト名

クラスタ環境で使用する場合，セットアップする論理ホスト名（JP1/Baseで設定した論理ホスト名）を指定します。

省略した場合，物理ホストが仮定されます。ただし，環境変数JP1_HOSTNAMEが指定されている場合は，その値が仮定されます。

物理ホストを明示的に指定する場合は，オプションに「JP1_DEFAULT」を指定してください。

このオプションは，-m，-a，-rオプションを指定したときに有効です。

-F スケジューラーサービス名

セットアップする対象のスケジューラーサービス名を指定します。

このオプションは，JP1/AJS2 - Managerの場合だけ指定できます。JP1/AJS2 - Agentでは指定できません。

省略した場合，デフォルトスケジューラーサービスが仮定されます。ただし，環境変数AJSCONFが指定されている場合は，その値が仮定されます。

このオプションは，-m，-rオプションを指定したときに有効です。

-nc

共有ディスク上で，ジョブID管理ファイルの作成およびファイルの有無のチェックを行いません。クラスタ環境の待機系セットアップ時にだけ指定してください。-mオプション指定時に有効なオプションです。

-m

キューレスジョブのマネージャー機能をセットアップします。

このオプションは，JP1/AJS2 - Managerの場合だけ指定できます。JP1/AJS2 - Agentでは指定できません。

このオプションは-r，-uオプションと同時には指定できません。

-a

キューレスジョブのエージェント機能をセットアップします。

このオプションは-r，-uオプションと同時には指定できません。

-r

JP1/AJS2サービスを停止し，-Fオプションまたは環境変数AJSCONFに指定したスケジューラーサービスに対するキューレスジョブのマネージャー機能を無効にします。マネージャー機能を無効にしたスケジューラーサービスからは，キューレスジョブを送信できません。

このオプションは，JP1/AJS2 - Managerの場合だけ指定できます。JP1/AJS2 - Agentでは指定できません。

このオプションは-m，-a，-uオプションと同時には指定できません。

-u

JP1/AJS2サービスを停止し，JP1/AJS2サービスからキューレスジョブ実行環境の設定を削除します。

Windowsの場合，Windowsの［管理ツール］のサービス一覧からキューレスエージェントサービス（JP1/AJS2 Queueless Agent）およびキューレスファイル転送サービス（JP1/AJS2 Queueless File Transfer）を削除します。

このオプションは-r，-m，-aオプションと同時には指定できません。

注意事項

-mオプションを指定してマネージャー機能をセットアップする場合，または-aオプションを指定してエージェント機能をセットアップする場合は，JP1/AJS2サービスが停止している状態で実行してください。また，ajsqlsetupコマンドによってすでにキューレスエージェントサービスおよびキューレスファイル転送サービスが登録されている場合は，それらのサービスもすべて停止している状態で実行してください。

-rオプションを指定してキューレスジョブ機能の設定を無効にする場合，または-uオプションを指定してキューレスジョブ実行環境の設定を削除する場合は，JP1/AJS2の運用を停止した状態で実行してください。JP1/AJS2が運用中であってもキューレスジョブ機能の無効化や削除を優先するため，JP1/AJS2サービス，キューレスエージェントサービスおよびキューレスファイル転送サービスが停止します。そのため，JP1/AJS2の運用に影響がでるおそれがあります。

設定の種別を示すオプション（-m，-a，-r，-u）を省略した場合，次のオプションが仮定されます。

JP1/AJS2 - Managerの場合：-m，-a

JP1/AJS2 - Agentの場合：-a

07-50と同様のオプションで運用する場合， 07-50互換オプションを適用する。
次の手順に従ってください。

ajs2ql_0750.conf.modelをajs2ql_0750.confにコピーする。

ajs2ql_0750.confを必要に応じて編集する。

jbssetcnfコマンドを実行する。

（例）

jbssetcnf ajs2_0750.conf

［マネージャー環境設定］ダイアログボックスでマネージャー環境を設定した場合，または［エージェント環境設定］ダイアログボックスでエージェント環境を設定した場合，キューレスジョブ実行環境には08-00より前のバージョンの構成定義情報が設定されていることがあります。ajsqlstatusコマンドを実行して，キューレスジョブ実行環境に期待する情報が設定されていることを確認してください。
08-00より前のバージョンの構成定義情報を次の表に示します。

定義キー
環境設定パラメーター

[JP1_DEFAULT¥JP1QLAGENT]
"AJSQL_JOBMAX"=dword:00000400

"AJSQL_JOBWAITMAX"=dword:00000000

[JP1_DEFAULT¥JP1QLAGENT]
または
[論理ホスト名¥JP1QLAGENT]
"AJSQL_LOGSIZE"=dword:00001000

"AJSQL_STATSIZE"=dword:00000000

Windows Server 2008のマシンでこのコマンドを実行する際には，コマンドプロンプトを管理者として起動する必要があります。コマンドプロンプトを起動する際は，Windowsの［スタート］メニューの［コマンドプロンプト］を右クリックし，ショートカットメニューから［管理者として実行］を選択してください。なお，UAC機能が無効の場合は，コマンドプロンプトを管理者として起動する必要はありません。

戻り値

0 | 正常終了。
0以外の値 | 異常終了。

ajssetup

形式

ajssetup
    [-F サービス名]
    [-t|-c|[-m]]
    [-mh 論理ホスト名]

機能

スケジューラーサービスが使用するデータベースをセットアップします。

組み込みDBの場合

対応するスケジューラーサービスのRDBアクセスユーザーおよびパスワードを，環境設定時（構成定義）に指定した内容に変更します。

ISAMの場合

スケジューラーサービスが使用するデータベースのテーブルを作成します。

環境設定時に指定した内容とは，Windowsの場合は，［マネージャー環境設定］ダイアログボックスの［スケジューラーファイルの構成］タブで指定した内容です。UNIXの場合は，構成定義で指定した内容です。

サスペンド機能をセットアップします。

実行権限

Windowsの場合：Administrators権限

UNIXの場合：スーパーユーザー権限

引数

-F サービス名

処理対象とする，スケジューラーサービスのサービス名を指定します。

指定できる文字数は，1～30（単位：バイト）です。

省略した場合，デフォルトサービス名が仮定されます。

-t

ISAMの場合

スケジューラーサービスが使用するデータベースのテーブルを作成します。

-c

組み込みDBの場合

環境設定時（構成定義）で設定したRDBアクセスユーザー（RDBUSER），パスワード（RDBPASSWORD）を組み込みDBの管理情報に追加，またはすでに組み込みDBの管理情報に存在するRDBアクセスユーザーのパスワードを変更する場合に指定します。

対応するスケジューラーサービスのRDBアクセスユーザーについて，環境設定時（構成定義）に指定したRDBアクセスユーザーが存在する場合は，RDBアクセスユーザーのパスワードを変更します。RDBアクセスユーザーが存在しない場合は，RDBアクセスユーザーを追加します（変更前のユーザーは，DBMS上に残ります）。

このオプションを指定する場合は，DBA権限を持つユーザーの認可識別子，およびパスワードを環境変数PDUSERに定義しておく必要があります。

すでに稼働しているスケジューラーサービスの構成で，RDBアクセスユーザー（RDBUSER），パスワード（RDBPASSWORD）を変更した場合はこのオプションを指定してコマンドを実行する必要があります。

ISAMの場合

このオプションは指定しないでください。指定するとエラーになります。

-m

サスペンド機能を有効にします。

ジョブネットの実行登録中に定義を変更する場合は，必ず指定してください。インストール直後は，サスペンド機能は無効になっています。

サスペンド機能のセットアップ時には，スケジューラーサービスが使用するデータベースはセットアップされません。サスペンド機能をセットアップする前に，スケジューラーサービスが使用するデータベースをセットアップしておいてください。

-mh 論理ホスト名

環境変数JP1_HOSTNAMEの代わりに論理ホスト名を指定できます。このオプションを指定すると，環境変数JP1_HOSTNAMEの値よりこのオプション値の方が優先されます。

オプション値に，JP1_DEFAULTと指定することで，明示的に物理ホストを指定することもできます。物理ホストのマシン名をオプション値に指定しても，物理ホストの設定はできません。

注意事項

コマンドを実行する前に，次のことを実施してください。
Windowsの場合は，JP1/AJS2サービスとJP1/AJS2 Monitorサービスを停止してください。
UNIXの場合は，JP1/AJS2サービスとajsinetdプロセスを停止し，ajsshmdelコマンドを実行してください。

このコマンドは，同時に複数実行できません。一つずつ実行されるように指定してください。

-tオプションを指定してコマンドを実行した際にエラーになった場合は，まず，トラブルを解決し，コマンド実行によって作成されたテーブルをすべて削除してください。その後，コマンドを再実行し，テーブルを作成してください。
同様に，-tオプションを指定してテーブルを作成したあと，テーブルを再作成したい場合も，作成済みのテーブルをすべて削除したあと，実施してください。

組み込みDBを使用する場合，DBA権限を持つユーザーの認可識別子およびパスワードを環境変数PDUSERに定義してからコマンドを実行してください。

組み込みDB使用時に，RDBユーザーパスワードとして不正なパスワードを指定してエラーになった場合は，RDBユーザーパスワードを変更したあとで，-cオプションを指定してコマンドを実行すれば，正しく処理されます。

キューレスジョブを使用して運用を行っているシステムでスケジューラーサービスのデータベースを再作成した場合は（JP1/AJS2をアンインストールして再度インストールした場合も含みます），キューレスジョブ実行環境の再設定を行ってください。

再作成後もキューレスジョブを使用する場合
ajsqlsetup -F スケジューラーサービス名

再作成後はキューレスジョブを使用しない場合
ajsqlsetup -r -F スケジューラーサービス名

Windows Server 2008のマシンでこのコマンドを実行する際には，コマンドプロンプトを管理者として起動する必要があります。コマンドプロンプトを起動する際は，Windowsの［スタート］メニューの［コマンドプロンプト］を右クリックし，ショートカットメニューから［管理者として実行］を選択してください。なお，UAC機能が無効の場合は，コマンドプロンプトを管理者として起動する必要はありません。

戻り値

0 | 正常終了。
4～124で4の倍数値 | 異常終了。

使用例

スケジューラーサービス（service1）が使用するテーブルを作成します。

ajssetup -F service1

ajssosetup

形式

ajssosetup
     [-h 論理ホスト名]
     [-F スケジューラーサービス名]
     -g JP1資源グループ名
     {-i シナリオ管理グループ名|-u}
     [-nc]

機能

JP1/AJS2 - Scenario Operationとの連携機能（シナリオ管理グループの作成，環境設定）を有効または無効にします。

このコマンドによって設定される情報を次に示します。

構成定義情報の設定

JP1/AJS2 - Scenario Operationとの連携可否，およびシナリオ管理グループ名を構成定義情報として設定します。

定義キー
環境設定パラメーター

[JP1_DEFAULT¥JP1AJSMANAGER¥スケジューラーサービス名]
または
[論理ホスト名¥JP1AJSMANAGER¥スケジューラーサービス名]

-iオプション指定時
"SORELATION"=dword:00000001
"SOGROUP"="-iオプションの引数値"

-uオプション指定時
"SORELATION"="dword:00000000
"SOGROUP"=""

実行権限

Windowsの場合：Administrators権限

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

JP1/AJS2 - Managerのインストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1ajs2/bin/

引数

-h 論理ホスト名

クラスタ環境で使用する場合，セットアップする論理ホスト名（JP1/Baseで設定した論理ホスト名）を指定します。

指定できる文字数は1～255（単位：バイト）です。

省略した場合，物理ホストが仮定されます。ただし，環境変数JP1_HOSTNAMEが指定されている場合は，その値が仮定されます。物理ホストを明示的に指定する場合は，「JP1_DEFAULT」を指定してください。また，論理ホスト名として，IPアドレスは指定できません。

-F スケジューラーサービス名

シナリオ管理グループを作成するスケジューラーサービス名を指定します。

指定できる文字数は，1～30（単位：バイト）です。

このオプションを省略した場合，環境変数AJSCONFの内容が仮定されます。環境変数AJSCONFを設定していない場合は，デフォルトのスケジューラーサービス名が仮定されます。

-g JP1資源グループ名

シナリオ管理グループに設定するJP1資源グループ名を指定します。

指定できる文字数は1～63（単位：バイト）です。

指定できる文字は，英数字，および「_（アンダーバー）」です。指定を「""」とした場合は，アクセス権限の対象になりません。

ここで指定したJP1資源グループ名は，一度セットアップしたあとは変更できません。

このオプションは，-u，-ncオプションと同時に指定した場合，無視されます。

このオプションは，-iオプションが-ncオプションと同時に指定されていない場合，必ず指定してください。

-i シナリオ管理グループ名

JP1/AJS2 - Scenario Operationとの連携機能をセットアップするときに指定します。指定できるシナリオ管理グループ名の文字数は，1～30（単位：バイト）です。

使用できない文字を次に示します。

全体で使用できない文字：「/」「;」「:」「=」「,」「(」「)」タブ 半角スペース

先頭に使用できない文字：「.」「@」

ここで指定したシナリオ管理グループ名は，一度セットアップしたあとは変更できません。

作成されるシナリオ管理グループの詳細定義のデフォルト値は，ジョブグループと異なります。詳細定義のデフォルト値の差異を次の表に示します。その他の項目については，ジョブグループと同じです。

このオプションを-ncと同時に指定しない場合は，-gオプションを必ず指定してください。

表20-11　詳細定義のデフォルト値の差異

項目 | シナリオ管理グループ | ジョブグループ
カレンダー情報・週間標準値（日～土） | すべて運用日 | 定義なし
基準日指定 | 日付指定 | なし
基準日（日付指定） | 1日 | 指定なし
月区分 | 当月 | なし
基準時刻設定 | する | しない
基準時刻 | 0時0分 | 指定なし

-u

シナリオ管理グループを削除し，JP1/AJS2 - Scenario Operationとの連携を無効にします。シナリオ管理グループ配下に登録済みユニットが含まれる場合，またはシナリオ管理グループ配下が参照・更新されている場合はシナリオ管理グループを削除できません。

-nc

シナリオ管理グループを作成または削除しないで,環境設定パラメーターだけ変更します。クラスタ環境の退避系セットアップ時にだけ指定してください。

このオプションを-gオプションと同時に指定した場合，-gオプションは無視されます。

オプションの組み合わせ

コマンドに指定できるオプションの組み合わせを次の表に示します。

表20-12　指定できるオプションの組み合わせ

オプション | -h | -F | -g | -i | -u | -nc
-h | － | ○ | ○ | ○ | ○ | ○
-F | ○ | － | ○ | ○ | ○ | ○
-g | ○ | ○ | － | ○※ | ○ | ○
-i | ○ | ○ | ○※ | － | × | ○
-u | ○ | ○ | ○ | × | － | ○
-nc | ○ | ○ | ○ | ○ | ○ | －

（凡例）

○：同時に指定できる。

×：同時に指定できない。

－：該当しない。

注※

-iオプションを指定した場合，-gオプションの指定が必須。

注意事項

Windows Server 2008のマシンでこのコマンドを実行する際には，コマンドプロンプトを管理者として起動する必要があります。コマンドプロンプトを起動する際は，Windowsの［スタート］メニューの［コマンドプロンプト］を右クリックし，ショートカットメニューから［管理者として実行］を選択してください。なお，UAC機能が無効の場合は，コマンドプロンプトを管理者として起動する必要はありません。

戻り値

0 | 正常終了。
0以外 | 異常終了。

エラー発生時の対処

コマンド実行時に発生するエラーと対処方法について次の表に示します。

表20-13　エラー発生時の原因と対処方法

メッセージID
原因
対処方法

KAVS0101-E
KAVS0102-E
KAVS0103-E
KAVS0104-E
KAVS0116-E
KAVS0785-E
指定されたオプションおよび値が不正である。
オプションおよびオプションに指定する値を修正してから実行する。

KAVS0162-E
KAVS0291-E
指定されたオプションの値または環境変数が不正である。
指定されたオプションの値または環境変数を正しく設定してから実行する。

KAVS0108-E
コマンドを実行するユーザーに権限がない。
Administratorsまたはスーパーユーザー権限を持つユーザーで実行する。

KAVS0119-E
シナリオ管理グループ配下が他で使用されているため，シナリオ管理グループを削除できない。
使用が終了してから実行する。

KAVS0582-E
環境変数の値が不正である。
環境変数を修正するか，または対応するオプション-h,-Fを指定してから実行する。

KAVS0622-E
シナリオ管理グループ配下に登録されているジョブネットがあるため，シナリオ管理グループを削除できない。
シナリオ管理グループ配下にある登録されているジョブネットをすべて登録解除してから実行する。

KAVS0652-E
-iで指定したユニット名がすでに存在する。
-iで指定するユニット名を変更するか，または同じ名前のユニットを削除してから実行する。

KAVS0654-E
シナリオ管理グループ配下を参照・更新中である。
参照・更新が終了してから実行する。

KAVS0902-E
コマンドを実行するためのメモリーが不足している。
十分なメモリーを確保してから実行する。

KAVS0986-E
文字コードの変換によって，引数の文字最大長を超えた。
データベースのキャラクターセットと，JP1/AJS2で使用する文字コードを統一してから実行する。

KAVS0987-E
データベース操作の実行権限がない。
適切な権限を持ったユーザーを指定してから実行する。

KAVS0992-E
レジストリーキーに対して権限がない。
レジストリーキーに権限を持つユーザーで実行する。

KAVS1003-E
構成定義が不正である。
構成定義を正しく設定してから実行する。

KAVS1724-E
指定したスケジューラーサービスがセットアップされていない。
JP1/AJS2サービスまたはJP1/AJS2 Monitorサービスのどちらかを起動してから，またはajssetupコマンドを実行してから，実行する。

KAVS3600-E
すでにセットアップされている。
-uオプションを指定してアンセットアップしてから実行する。

使用例

JP1/AJS2 - Scenario Operationとの連携を行うため，スケジューラーサービスAJSROOT1にシナリオ管理グループ（JP1AJS2SOGROUP）を作成します。このとき，JP1資源グループ名にJP1_AJS_Admin権限が設定されたJP1_AJS2_SOを定義します。

ajssosetup -F AJSROOT1 -g JP1_AJS2_SO -i JP1AJS2SOGROUP

ajswoarelsetup

形式

ajswoarelsetup
    [-h 論理ホスト名]
    [-F スケジューラーサービス名]
    {-i 監視元ホスト名|-u}

機能

スケジューラーサービスをJP1/AJS2 - Web Operation Assistantから監視するかどうかを設定します。このコマンドによって設定される情報を次に示します。

構成定義情報の設定

スケジューラーサービスをJP1/AJS2 - Web Operation Assistantから監視するための構成定義情報の設定をします。

定義キー
環境設定パラメーター

[JP1_DEFAULT¥JP1AJSMANAGER¥スケジューラーサービス名]
または
[論理ホスト名¥JP1AJSMANAGER¥スケジューラーサービス名]
・-iオプション指定時
　　"WOARELATION"=dword:00000001
　　"WOAHOST"="-iオプションの引数値"
・-uオプション指定時
　　"WOARELATION"="dword:00000000
　　"WOAHOST"=""

実行権限

Windowsの場合：Administrators権限

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

JP1/AJS2 - Managerのインストール先フォルダ¥bin

UNIXの場合

/opt/jp1ajs2/bin

引数

-h 論理ホスト名

監視対象のJP1論理ホスト名を指定します。

省略した場合，環境変数JP1_HOSTNAMEの設定があれば，環境設定値が仮定されます。環境変数JP1_HOSTNAMEの指定がない場合は，物理ホストが仮定されます。論理ホスト名として，IPアドレスを指定することはできません。

-F スケジューラーサービス名

監視対象のスケジューラーサービスのサービス名を指定します。指定できる文字数は，1～30（単位：バイト）です。

省略した場合，環境変数AJSCONFの設定があれば，環境変数値が仮定されます。

環境変数AJSCONFの指定がない場合は，デフォルトのスケジューラーサービスが仮定されます。

-i 監視元ホスト名

スケジューラーサービスを，指定された監視元ホスト上のJP1/AJS2 - Web Operation Assistantから監視できるようにします。指定できる監視元ホスト名の文字数は，1～255（単位：バイト）です。監視元ホスト名には，JP1/AJS2 - Web Operation Assistantマシンのホスト名（コンピュータ名）を指定します。

-u

スケジューラーサービスをJP1/AJS2 - Web Operation Assistantから監視できないようにします。

注意事項

このコマンドで指定した監視対象のスケジューラーサービスは，一つの監視元ホストでだけ監視できます。
なお，同一のスケジューラーサービスに対して，監視元ホストを変更して複数回コマンドを実行した場合，最後にコマンドで指定した監視元ホストが有効になります。

監視元のホスト名を変更した場合，このコマンドで変更後のホスト名を再設定してください。変更後のホスト名を設定するまで，監視元ホスト上のJP1/AJS2 - Web Operation Assistantから監視できないので注意してください。

Windows Server 2008のマシンでこのコマンドを実行する際には，コマンドプロンプトを管理者として起動する必要があります。コマンドプロンプトを起動する際は，Windowsの［スタート］メニューの［コマンドプロンプト］を右クリックし，ショートカットメニューから［管理者として実行］を選択してください。なお，UAC機能が無効の場合は，コマンドプロンプトを管理者として起動する必要はありません。

戻り値

0 | 正常終了。
0以外の値 | 異常終了。

使用例

スケジューラーサービス（service1）を，監視元ホスト（host1）上のJP1/AJS2 - Web Operation Assistantから監視する。

ajswoarelsetup -i host1 -F service1

jp1ajs2_setup（UNIX限定）

形式

jp1ajs2_setup

機能

JP1/AJS2のインストール後，実行環境を設定します。

このコマンドが設定する情報を次に示します。

JP1/AJS2の構成定義情報
このコマンドを使わない場合，jbssetcnfコマンド（JP1/Baseのコマンド）を実行してください。

ジョブ実行環境情報
このコマンドを使わない場合，jpqimportコマンド（JP1/AJS2のコマンド）を実行してください。

JP1/AJS2のポート番号
/etc/servicesファイルに設定されます。
設定しようとしたポート番号がすでに/etc/servicesファイルに設定されている場合，「Service（サービス名）portポート番号/tcpalreadyused.」というメッセージが出力されます。このメッセージは，設定しようとしたポート番号が/etc/servicesファイルのコメント中に設定されている場合にも出力されます。既存のポート番号と重複しないポート番号を設定したあと，このコマンドを再実行してください。

実行権限

スーパーユーザー権限

注意事項

このコマンドはUNIXだけで実行できます。Windowsでは実行できません。

JP1/Baseを前提とするJP1シリーズの製品の稼働中には，このコマンドを実行しないでください。

07-00以降のJP1/AJS2 - ManagerおよびJP1/AJS2 - Agentでは，新規インストールする際に，このコマンドが実行されます。インストール時のセットアップ処理で問題が発生した場合は，補助的にこのコマンドを使用して，セットアップしてください。インストール後に一度実行すれば，そのあとは実行する必要はありません。

戻り値

0 | 正常終了。
0以外の値 | 異常終了。

jp1ajs2_setup_cluster（UNIX限定）

形式

jp1ajs2_setup_cluster
    -h 論理ホスト名
    [-d 共有ディレクトリ名]
    [-n 値]
    [-m {cold|warm|hot}]
    [-v]

機能

JP1/AJS2 - Manager，およびJP1/AJS2 - Agentの論理ホストに対応した動作環境をセットアップします。クラスタシステムの運用環境のセットアップ時には，実行系，および待機系それぞれで実行してください。

このコマンドで実行系をセットアップする場合，事前に，JP1/Baseの物理ホスト環境，および論理ホスト環境のセットアップを実施しておく必要があります。

また，このコマンドで実行系のJP1/AJS2 - Managerをセットアップする場合は，物理ホストのスケジューラーサービスが一つだけの状態で実行してください。

このコマンドが行うセットアップの内容を次に示します。

JP1/AJS2 - Manager

実行系のセットアップ

JP1共通定義情報に論理ホストの定義情報を設定します。

共有ディスクに論理ホストの定義ファイル，実行環境を作成します。定義ファイルは，物理ホスト環境から複写されます（すべてのファイルが複写されるわけではありません）。

ISAMデータベースの書き込みモードを「sync」に設定します。

イベント起動のファイル更新モードを「sync」に設定します。

JP1/AJS2の起動モードを設定します。

論理ホスト，および物理ホストの通信方式をIPバインド方式に変更します。

イベント起動の詳細プロセス終了時オプションを「Y」に設定します。

待機系のセットアップ

論理ホスト，および物理ホストの通信方式をIPバインド方式に変更します。

JP1/AJS2 - Agent

実行系のセットアップ

JP1共通定義情報に論理ホストの定義情報を設定します。

共有ディスクに論理ホストの定義ファイル，実行環境を作成します。定義ファイルは，物理ホスト環境から複写されます（すべてのファイルが複写されるわけではありません）。

イベント起動のファイル更新モードを「sync」に設定します。

論理ホスト，および物理ホストの通信方式をIPバインド方式に変更します。

イベント起動の詳細プロセス終了時オプションを「Y」に設定します。

待機系のセットアップ

論理ホスト，および物理ホストの通信方式をIPバインド方式に変更します。

実行権限

スーパーユーザー権限

引数

-h 論理ホスト名

セットアップする論理ホスト名（JP1/Baseで設定した論理ホスト名）を指定します。

指定できる文字数は，1～63（単位：バイト）です。

このオプションに指定した論理ホスト名で環境が作成されます。

-d 共有ディレクトリ名

実行系から待機系に引き継ぐ情報を格納する共有ディスクの，マウント先のディレクトリ名を指定します。

指定できる文字数は，1～165（単位：バイト）です。

このオプションは，実行系のセットアップ時には必ず指定してください。

省略した場合，待機系としてセットアップされます。

共有ディレクトリとして「指定した共有ディレクトリ名/jp1ajs2」が作成され，その下に論理ホストの環境定義ファイルや実行環境が作成されます。コマンド実行前に，必ず共有ディスクをマウントしておいてください。

-n 値

スケジューラーサービスの識別番号を指定します。この値がスケジューラーサービスの識別番号になります。また，AJSROOTnの名称のスケジューラーサービスが作成されます。

指定できる値は，1～20です。

省略した場合，常に「2」が仮定されて「AJSROOT2」が作成されるため，AJSROOT2が作成されていない場合にだけ省略してください。なお，AJSROOT1は物理ホスト環境で使用します。

指定する場合は，物理ホストおよび論理ホストで使用していないスケジューラーサービスの識別番号を指定してください。

物理ホスト，またはjp1ajs2_setup_clusterコマンドを実行する論理ホスト上に，-nオプションで指定する識別番号と同じ番号のスケジューラーサービスがある場合は，警告メッセージが出力されますが処理は正常終了します。jp1ajs2_setup_clusterコマンドを実行する論理ホストとは別の論理ホストにすでにあるスケジューラーサービスの識別番号と同じ番号を指定した場合は，メッセージは出力されないで正常終了します。どちらの場合も，同一のスケジューラーサービスが作成されているため，正常に動作しません。この場合は，不要な論理ホストを削除してください。

論理ホストの削除は，「18.4.6 論理ホストの削除」を参照ください。

なお，すでに指定されている識別番号は，jbsgetcnfコマンドで共通定義情報を取得し，共通定義パラメーターAJSSERVICEIDに設定されている値で確認できます。共通定義パラメーターAJSSERVICEIDは，スケジューラーサービスが複数設定されている場合には複数の設定値があります。そのため，物理ホストおよび論理ホストの共通定義を取得し，すべての定義で指定する識別番号が重複しないことを確認してください。

このオプションは，実行系のセットアップ時にだけ指定できます。

-m {cold|warm|hot}

スケジューラーサービスの起動方法を指定します。

cold
スケジューラーサービスをコールドスタートします。

warm
スケジューラーサービスをウォームスタートします。

hot
スケジューラーサービスをホットスタートします。

このオプションは，実行系のセットアップ時にだけ指定できます。

省略した場合，スケジューラーサービス環境設定ファイル（Schedule.conf）のSTARTMODEパラメーターに指定している値が仮定されます。

-v

処理状況を表示します。

注意事項

このコマンドはUNIXだけで実行できます。Windowsでは実行できません。

このコマンドを実行する前に，必ず物理ホストのJP1を停止しておいてください。

このコマンドを実行して作成されたスケジューラーサービスのスケジューラーデータベースはISAMでセットアップされます。
スケジューラーデータベースとして組み込みDBを使用する場合は，このコマンドを実行したあとに，それぞれのRDB用にセットアップし直してください。
スケジューラーデータベースとして組み込みDBを使用する場合は，「15.1 組み込みDBを使用する場合の準備」を参照してください。

このコマンドは，物理ホストのjp1ajs_spmd.confファイルを論理ホストにコピーします。そのため，物理ホストの設定を引き継いで，論理ホストに必要のないプロセスが起動されることがあります。物理ホストでjp1ajs_spmd.confファイルを編集している場合は，論理ホストのjp1ajs_spmd.confファイルを編集し，必要なプロセスだけが起動されるようにしてください。

戻り値

0 | 正常終了。
1 | 異常終了。

使用例

JP1/AJS2の動作環境のセットアップします。

セットアップ時の条件を次に示します。

論理ホスト名
lnode0

共有ディレクトリ名
/shdsk/lnode0

スケジューラーサービス名
AJSROOT2

スケジューラーサービスの起動方法
ホットスタート
（フェールオーバー時にジョブネットやジョブの状態を引き継ぐ）

実行系セットアップのコマンド指定例

# jp1ajs2_setup_cluster -h lnode0 -d /shdsk/lnode0 -n 2 -m hot

待機系セットアップのコマンド指定例

# jp1ajs2_setup_cluster -h lnode0

jp1ajs2casetup（UNIX限定）

形式

jp1ajs2casetup

機能

JP1/AJS2 - Managerのインストール後，JP1/AJS2 Console Agentの実行環境を設定します。このコマンドが設定する情報を次に示します。

JP1/AJS2 Console Agentの構成定義情報

JP1/AJS2 Consoleのポート番号
/etc/servicesファイルに設定されます。
設定しようとしたポート番号がすでに/etc/servicesファイルに設定されている場合，「Service（サービス名）portポート番号/tcp already used.」というメッセージが出力されます。このメッセージは，設定しようとしたポート番号が/etc/servicesファイルのコメント中に設定されている場合にも出力されます。既存のポート番号と重複しないポート番号を設定したあと，このコマンドを再実行してください。

実行権限

スーパーユーザー権限

格納先ディレクトリ

/opt/jp1ajs2/bin/

注意事項

このコマンドはUNIXだけで実行できます。Windowsでは実行できません。

JP1/AJS2 Console Agentの機能を使用する場合に実行してください。JP1/AJS2 - Managerのインストール後に一度実行すれば，その後は実行する必要はありません。

JP1/Baseを前提製品とするJP1シリーズのプログラムの稼働中には，このコマンドは実行しないでください。

戻り値

0 | 正常終了。
0以外の値 | 異常終了。

jp1ajs2cmsetup（UNIX限定）

形式

jp1ajs2cmsetup

機能

JP1/AJS2 - Managerのインストール後，JP1/AJS2 Console Managerの実行環境を設定します。このコマンドが設定する情報を次に示します。

JP1/AJS2 Console Managerの構成定義情報

JP1/AJS2 Consoleのポート番号
/etc/servicesファイルに設定されます。
設定しようとしたポート番号がすでに/etc/servicesファイルに設定されている場合，「Service（サービス名）portポート番号/tcp already used.」というメッセージが出力されます。このメッセージは，設定しようとしたポート番号が/etc/servicesファイルのコメント中に設定されている場合にも出力されます。既存のポート番号と重複しないポート番号を設定したあと，このコマンドを再実行してください。

実行権限

スーパーユーザー権限

格納先ディレクトリ

/opt/jp1ajs2cm/bin/

注意事項

このコマンドはUNIXだけで実行できます。Windowsでは実行できません。

JP1/AJS2 Console Managerを使用する場合は，JP1/AJS2 - Managerのインストール後に必ず実行してください。JP1/AJS2 - Managerのインストール後に一度実行すれば，その後は実行する必要はありません。

JP1/Baseを前提製品とするJP1シリーズのプログラムの稼働中には，このコマンドは実行しないでください。

戻り値

0 | 正常終了。
0以外の値 | 異常終了。

jpomailrecv（UNIX限定）

形式

jpomailrecv
    -u 監視ユーザー名
    [-t リトライ打ち切り時間]

機能

SMTPメールサーバのエイリアスを利用してメールを取得し，メール受信監視独自のメールファイルを作成したり，排他制御を実行したりするための，メール配信機能を設定します。

実行権限

なし

引数

-u 監視ユーザー名

EVAction.conf（イベント・アクション定義ファイル）のUserNameに指定したユーザー名を指定します。

指定できる文字数は，1～256（単位：バイト）です。

-t リトライ打ち切り時間

編集しようとしたメールファイルに排他制御が設定されている場合に，編集のリトライを打ち切る時間を指定します。

指定できる値は，1～1,440（単位：分）です。省略した場合，リトライは無制限になります。

注意事項

イベント・アクション実行環境設定ファイル（EVAction.conf）のUserNameには，コマンドの監視ユーザー名と同じユーザー名を記述してください。また，コマンドの実行前に，jbssetcnfコマンドでイベント・アクション実行環境設定ファイル（EVAction.conf）をシステムに反映してください。jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

コマンド実行時にエラーが発生した場合や，編集のリトライを打ち切った場合，受信したメールは送信元に返信されます（ロックファイルの削除に失敗した場合を除く）。

このコマンドは，必ずエイリアスファイルに記述し，SMTPメールサーバから起動してください。手動で直接起動した場合の動作については保証できません。

エイリアスファイルに記述する際は，コマンド全体を「"」で囲んでください。

使用例1

EVAction.conf（イベント・アクション定義ファイル）のUserNameを「mailuser」と指定している場合に，リトライ打ち切り時間を10分とします。

mailuser:"|/opt/jp1ajs2/bin/jpomailrecv -u mailuser -t 10"

使用例2

EVAction.conf（イベント・アクション定義ファイル）のUserNameを「user1」と指定している場合に，リトライを打ち切りません。

user1:user1,"|/opt/jp1ajs2/bin/jpomailrecv -u user1"

jpqexport

形式

jpqexport
    -dt {isam|replication}
    -co ファイル名
    [-mh 論理ホスト名]
    [-dp データベース格納ディレクトリ名]

機能

現時点でのジョブ実行環境（ジョブ実行エージェント，キュー，および排他実行リソース）をファイルに出力します。

実行権限

Windowsの場合：Administrators権限

UNIXの場合：スーパーユーザー権限

引数

-dt {isam|replication}

使用するデータベースを宣言します。

isam
ISAMを利用したジョブ実行用構成定義情報データベースを使用することを宣言します。

replication
JP1/AJS2 - Datareplicator運用用のジョブ実行用構成定義情報データベースを使用することを宣言します。

-co ファイル名

ジョブ実行環境を出力するファイル名を，フルパスで指定します。

指定できる文字数は，1～511（単位：バイト）です。

-mh 論理ホスト名

論理ホスト名として，マネージャーホスト名を指定します。

指定できる文字数は，1～255（単位：バイト）です。

省略した場合，物理ホスト名が仮定されます。

このオプションは，最初に指定してください。

-dp データベース格納ディレクトリ名

ジョブ実行用構成定義情報データベースであるISAMファイルを格納しているディレクトリ名を指定します。

指定できる文字数は，1～511（単位：バイト）です。

省略した場合，環境設定時にジョブ実行環境のデータベース格納ディレクトリとして定義したディレクトリ名が仮定されます。

注意事項

ジョブ実行環境を出力するファイルは，情報の上書きができません。ジョブ実行環境をファイルに出力する前には，必ず作成済みのファイルを削除または退避しておいてください。

ジョブ実行環境のファイルへの出力処理は，構成定義によっては，数十分掛かる場合があります。

-mhオプションを省略した場合，環境変数JP1_HOSTNAMEは参照しません。論理ホストで運用している場合は，-mhオプションは省略しないでください。

このコマンドとjajs_maintain -m managerを同時に実行しないでください。

JP1/AJS2 - Datareplicator運用環境で，次のオプションは指定できません。
-dt isam

JP1/AJS2 - Datareplicator運用環境以外で，次のオプションは指定できません。
-dt replication

Windows Server 2008のマシンでこのコマンドを実行する際には，コマンドプロンプトを管理者として起動する必要があります。コマンドプロンプトを起動する際は，Windowsの［スタート］メニューの［コマンドプロンプト］を右クリックし，ショートカットメニューから［管理者として実行］を選択してください。なお，UAC機能が無効の場合は，コマンドプロンプトを管理者として起動する必要はありません。

戻り値

0 | 正常終了。
1 | 引数の指定が不適切である。
130 | 指定したファイル，またはパスがない。
131 | 指定したファイルは作成済みである。
133 | 指定したファイルへのアクセス権限がない。
135 | データベースがない。または，システム資源が不足している。
137 | データベース格納ディレクトリがない。
138 | データベースへのアクセス権限がない。
140 | ジョブ実行環境を出力する権限（Administrators権限（Windowsの場合），またはスーパーユーザー権限（UNIXの場合））がない。
141 | 環境設定が不適切である。または，論理ホスト名が不適切である。
145 | メモリーが不足している。
146 | ディスク容量が不足している。
147 | 内部的要因エラーが発生した。
149 | データベースのサイズが2GBを超えているため処理が行えない。
150 | データベースへ接続できない。

jpqimport

形式

jpqimport
    -dt {isam|replication}
    -ci ジョブ実行環境構成定義ファイル名
    [-mh 論理ホスト名]
    [-dp データベース格納ディレクトリ名]

機能

ジョブ実行環境構成定義ファイル（jpqsetup.conf）使用して，ジョブ実行環境（ジョブ実行エージェント，キュー，および排他実行リソース）を一括定義します。

他ホストのエージェントでジョブを実行する場合は，ジョブ実行環境のジョブ実行エージェントを定義する必要があります。

また，次の場合は，キューを作成する必要があります。

目的別にキューを作成し，クライアントからのジョブの登録（サブミット）を受け付ける場合

ジョブを分散実行する場合

JP1/NQSEXECおよびJP1/OJE for VOS3からのジョブを受け付ける場合

実行権限

Windowsの場合：Administrators権限

UNIXの場合：スーパーユーザー権限

引数

-dt {isam|replication}

使用するデータベースを宣言します。

isam
ISAMを利用したジョブ実行用構成定義情報データベースを使用することを宣言します。

replication
JP1/AJS2 - Datareplicator運用用のジョブ実行用構成定義情報データベースを使用することを宣言します。

-ci ジョブ実行環境構成定義ファイル名

使用するジョブ実行環境構成定義ファイル名（jpqsetup.conf）を指定します。

指定できる文字数は，1～511（単位：バイト）です。

なお，ジョブ実行環境構成定義ファイルの定義方法については，後述の「ジョブ実行環境構成定義ファイル（jpqsetup.conf）の定義方法」を参照してください。

-mh 論理ホスト名

論理ホスト名として，マネージャーホスト名を指定します。

指定できる文字数は，1～255（単位：バイト）です。

省略した場合，物理ホスト名が仮定されます。

-dp データベース格納ディレクトリ名

ジョブ実行用構成定義情報データベースである，ISAMファイルを格納するディレクトリ名を指定します。

指定できる文字数は，1～511（単位：バイト）です。

省略した場合，環境設定時にジョブ実行環境のデータベース格納ディレクトリとして定義したディレクトリ名が仮定されます。

注意事項

このコマンドで一括定義したジョブ実行環境のうち，エージェント定義はUNIXジョブ，PCジョブ，アクションジョブ，カスタムジョブ，およびイベントジョブで使用します。また，キュー定義はQUEUEジョブで，排他実行リソース定義はサブミットジョブで使用します。
キューレスジョブでは，エージェント定義およびキュー定義は使用しません。

ジョブ実行用構成定義情報データベースは，情報の上書きができません。ジョブ実行用構成定義情報データベースを再作成する前には，必ずJP1/AJS2を停止し，作成済みのデータベースを削除または退避してください。削除するファイルは，-dpオプションに指定するディレクトリ以下すべて（環境設定時に指定したデータベース格納ディレクトリ以下すべて）です。
Windowsの場合は［エクスプローラ］などで削除してください。
UNIXの場合はrmコマンドで削除してください。

-ciオプションに指定するファイル内で使用する文字コード※は，JP1/AJS2の運用時に使用する文字コードと同じ文字コードを使用してください。

注※

Windowsの場合は，［マネージャー環境設定］ダイアログボックスの［論理ホスト共通］タブで指定した［文字コード種別］の内容。

UNIXの場合は，スケジューラーサービス環境設定ファイル（Schedule.conf）のAJSCHARCODEパラメーターで指定した文字コード。

-dpオプションでデータベース格納ディレクトリ名を指定した場合は，指定したディレクトリ名を環境設定時にも指定する必要があります。
Windowsの場合は，［マネージャー環境設定］ダイアログボックスの［ジョブ実行制御］タブの［データベース格納ディレクトリ名］に指定します。
UNIXの場合は，ジョブ実行環境設定ファイル（Queue.conf）のDatabasePathパラメーターに指定します。

同じ論理ホスト上のJP1/AJS2が起動している間にこのコマンドを実行すると，エラーになります。

ジョブ実行環境の一括定義の処理は，構成定義によっては，数十分掛かる場合があります。

ジョブ実行環境を再作成するとき，残っているジョブの標準出力・標準エラー出力ファイルを削除します。ジョブを大量に実行したあとに，ジョブ実行環境を再作成するとこれらのファイルの削除のためにコマンドの実行時間が長くなる場合があります。

コマンドを使ってエージェント・キュー・排他実行リソースを追加したり，削除したりし，かつ，環境設定で最大定義数を小さくした場合，jpqexportコマンドで出力したジョブ実行環境構成定義ファイルを使用しても，jpqimportコマンドでジョブ実行環境を一括定義できないおそれがあります。例えば，共通定義情報のエージェントの最大定義数を30に設定した環境で，エージェントIDが100のエージェントをジョブ実行環境構成定義ファイルに定義してjpqimportコマンドを実行すると，jpqimportコマンドはエラーになります。
この場合，ジョブ実行環境構成定義ファイルに定義されているエージェントID，キューID，排他実行リソースIDが，環境設定時に指定した最大定義数以下になるように，ジョブ実行環境構成定義ファイルの記述を修正してください。その後，jpqimportコマンドを再実行してください。

「#」を行頭に記載することで，その行はコメントとして扱われます。ただし，「#」は必ず行頭に記載してください。パラメーターのあとに記載するとエラーとなります。

-mhオプションを省略した場合，環境変数JP1_HOSTNAMEは参照しません。論理ホストで運用している場合は，-mhオプションは省略しないでください。

JP1/AJS2 - Datareplicator運用環境で，次のオプションは指定できません。
-dt isam

JP1/AJS2 - Datareplicator運用環境以外で，次のオプションは指定できません。
-dt replication

JP1/AJS2 - Datareplicator運用環境での実行時は，データベース格納ディレクトリ内に作成済みのISAMデータベースが残っていても自動的に削除されます。

Windows Server 2008のマシンでこのコマンドを実行する際には，コマンドプロンプトを管理者として起動する必要があります。コマンドプロンプトを起動する際は，Windowsの［スタート］メニューの［コマンドプロンプト］を右クリックし，ショートカットメニューから［管理者として実行］を選択してください。なお，UAC機能が無効の場合は，コマンドプロンプトを管理者として起動する必要はありません。

戻り値

0 | 正常終了。
1 | 引数の指定が不適切である。
130 | ジョブ実行環境構成定義ファイル，またはパスがない。
132 | ジョブ実行環境構成定義ファイルの記述内容が不適切である。
133 | ジョブ実行環境構成定義ファイルへのアクセス権限がない。
135 | システム資源が不足しているため，データベースを作成できない。
136 | データベースがすでに作成されている。
137 | データベース格納ディレクトリがない。
138 | データベースへのアクセス権限がない。
140 | ジョブ実行環境を一括定義する権限（Administrators権限（Windowsの場合），またはスーパーユーザー権限（UNIXの場合））がない。
141 | 環境設定が不適切である。または，論理ホスト名が不適切である。
142 | 同じ論理ホスト上のマネージャーホストが起動している。
145 | メモリーが不足している。
146 | ディスク容量が不足している。
147 | 内部的要因エラーが発生した。
149 | データベースのサイズが2GBを超えているため処理が行えない。
150 | データベースへ接続できない。
151 | RDAREA不正，もしくはRDAREAがない。
152 | JP1/AJS2 - Datareplicatorの状態の取得に失敗した。
153 | コマンドを実行できる状態でない。

補足事項

ジョブ実行エージェント，キューおよび排他実行リソースを追加および削除するなど，ジョブ実行環境の構成定義を変更したい場合は，次に示すどちらかの方法で対応してください。

JP1/AJS2サービスを停止してから，このコマンドを使ってジョブ実行用構成定義情報データベースを再作成する。ジョブをリモート実行していた場合は，リモートホストのJP1/AJS2サービスも停止する。

ジョブの運用を停止せず，次に示すコマンドを使って構成定義を変更する。
jpqagtadd：エージェントの追加
jpqagtdel：エージェントの削除
jpqagtalt：エージェントの属性変更
jpqagtlink：キューとエージェントの接続・接続先エージェントの優先順位変更
jpqagtunlink：キューとエージェントの接続解除
jpqqueadd：キューの追加
jpqquedel：キューの削除
jpqquealt：キューの属性変更
jpqqueopen：キューのオープン
jpqqueclose：キューのクローズ
jpqresadd：排他実行リソースの追加
jpqresdel：排他実行リソースの削除

エイリアス名を使用してエージェントを作成すると，1台のマネージャーホスト上に複数のエージェントを作成できます。その際は，エイリアス名でアドレス解決（pingコマンドが正常に終了）できることを確認してください。

ジョブ実行環境構成定義ファイル（jpqsetup.conf）の定義方法

ジョブ実行環境構成定義ファイルには，次に示す3種類の情報を定義します。

エージェント定義

キュー定義

排他実行リソース定義

次に，各情報の定義方法を説明します。

エージェント定義

形式

$agent $エージェントID {エージェントホスト名|$system}
[exec_jobs 多重度設定開始時刻 多重度設定終了時刻
    ジョブ実行多重度]...
def_queue $デフォルトキューのID
[max_jobs キュー内のジョブ数の最大値]
[warn_jobs キュー内のジョブ数の警告値]
[queue_ent {open|close}]
[queue_exit {open|close}]
[connect $エージェントID 優先順位]...
$end

引数

$agent $エージェントID {エージェントホスト名|$system}

ジョブ実行エージェントホスト名を指定します。

$agent：固定

$エージェントID：「$an（nはマネージャーホスト内でユニークな値，0以外の値）」の形式で指定する。nは，環境設定時に指定したエージェント定義数以下の値を指定する（例えば，エージェント定義数を256とした場合，nには256以下の値を指定する。257以上の値を指定すると，エラーになる）。

エージェントホスト名：255バイト以内の文字列

$system：マネージャーホスト上のジョブ実行エージェント

exec_jobs 多重度設定開始時刻 多重度設定終了時刻 ジョブ実行多重度

ジョブ実行多重度を指定します。省略した場合，1日のジョブ実行多重度に0が仮定されます。

ジョブ実行多重度を指定することによって，このエージェントホストで同時に実行できるジョブ数を制限できます。同時実行数が制限されるジョブは，標準ジョブ（UNIXジョブ，PCジョブ，QUEUEジョブ），アクションジョブ，およびカスタムジョブです。同時に実行しようとしたジョブ数が，実行多重度に達した場合，実行多重度を超えた分のジョブは，実行中のジョブが終了するまでキューイング（実行待ち）の状態となります。

ジョブ実行多重度が0の場合，ジョブは実行できません。ジョブを実行する場合は1以上を指定してください。

多重度設定開始時刻：「hhmm」の形式で指定する。hhに指定できる値は，00～23（単位：時）。mmに指定できる値は，00，または30（単位：分）。

多重度設定終了時刻：「hhmm」の形式で指定する。hhに指定できる値は，00～23（単位：時）。mmに指定できる値は，00，または30（単位：分）。

ジョブ実行多重度：0～4,294,967,295の値

def_queue $デフォルトキューのID

デフォルトキューのIDを指定します。

デフォルトキューとは，エージェントホスト名を指定してジョブを実行する場合に必要なキューです。ジョブをサブミットする際，ジョブのサブミット先や実行先としてエージェントホスト名を指定すると，ジョブはそのエージェントホストのデフォルトキューにサブミットされます。

$デフォルトキューのID：デフォルトキューのIDを，「$qn（nは，デフォルトキューのIDおよびデフォルトキュー以外のキューのIDを合わせてマネージャーホスト内でユニークな値，0以外の値）」の形式で指定する。nは，環境設定値のキュー定義数以下の値を指定する（例えば，キュー定義数を256とした場合，nには256以下の値を指定する。257以上の値を指定すると，エラーになる）。

max_jobs キュー内のジョブ数の最大値

デフォルトキューにためておくことができるジョブ数の最大値を指定します。省略した場合，4,294,967,295が仮定されます。ただし，この設定にかかわらず，システム内の最大ジョブ数と同数のジョブがキュー中に残っていると，サブミットに失敗します。

この設定は，実際に実行中になったジョブも含みます。ジョブ数は，jpqqueshowコマンドの-qオプションで表示される「QUEUING」と「EXECUTING」の両方を合わせた値です。

キュー内のジョブ数の最大値：1～4,294,967,295の値

warn_jobs キュー内のジョブ数の警告値

デフォルトキュー内のジョブ数が，デフォルトキューにためておくことができるジョブ数の最大値に近づいたことを知らせる警告値を指定します。省略した場合，4,294,967,295が仮定されます。この設定（省略時の仮定値を含む）は，デフォルトキュー内のジョブ数を対象としており，実際に実行中になったジョブも含みます。jpqqueshowコマンドの-ahオプションで確認すると「QUEUING」「EXECUTING」の両方を合わせたジョブ数になります。

ジョブ数が警告値に達すると，警告メッセージ「KAVU4516-W」が統合トレースログに出力されます。

キュー内のジョブ数の警告値：1～4,294,967,295の値（ただし，キュー内のジョブ数の最大値と等しいか，または小さい値）

queue_ent {open|close}

デフォルトキューの，ジョブの受付口の状態を指定します。受付口が閉じている場合，デフォルトキューにジョブを投入できません。省略した場合，openが仮定されます。

open：受付口を開く。

close：受付口を閉じる。

queue_exit {open|close}

デフォルトキューの，ジョブの取出口の状態を指定します。取出口が閉じている場合，デフォルトキューでジョブを実行できません。ジョブはデフォルトキューにたまります。省略した場合，openが仮定されます。

open：取出口を開く。

close：取出口を閉じる。

connect $エージェントID 優先順位

デフォルトキューに接続するエージェントホストのIDを指定します。エージェントIDは複数指定できます。省略した場合，エージェントホスト名を指定したジョブは実行できません。

$エージェントID：接続するエージェントホストのIDを，「$an」の形式で指定する。

優先順位：1～16の値（優先順位がいちばん低いのが1，いちばん高いのが16）。優先順位が高いほど，ジョブが優先的に実行される。

$end

エージェント情報の終端を指定します。

$end：固定

記述例

$agent $a1 $system
exec_jobs 0000 0730 10
exec_jobs 0730 2000 1
exec_jobs 2000 0000 5
def_queue $q1
max_jobs 10
warn_jobs 5
queue_ent open
queue_exit open
connect $a1 1
$end

$agent $a2 agent1
exec_jobs 0000 0000 10
def_queue $q2
max_jobs 10
warn_jobs 5
queue_ent open
queue_exit open
connect $a1 1
connect $a2 2
$end

キュー定義

形式

$queue $キューID キュー名
[max_jobs キュー内のジョブ数の最大値]
[warn_jobs キュー内のジョブ数の警告値]
[queue_ent {open|close}]
[queue_exit {open|close}]
[connect $エージェントID 優先順位]...
$end

引数

$queue $キューID キュー名

キュー名を指定します。

エージェント名は大文字・小文字が区別されませんが，キュー名は大文字・小文字が区別されますので注意してください。

$queue：固定

$キューID：「$qn（nは，デフォルトキューのIDおよびデフォルトキュー以外のキューのIDを合わせてマネージャーホスト内でユニークな値，0以外の値）」の形式で指定する。nは，環境設定時に指定したキュー定義数以下の値を指定する（例えば，キュー定義数を256とした場合，nには256以下の値を指定する。257以上の値を指定すると，エラーになる）。

キュー名：63バイト以内の文字列

max_jobs キュー内のジョブ数の最大値

キューにためておくことができるジョブ数の最大値を指定します。省略した場合，4,294,967,295が仮定されます。ただし，この設定にかかわらず，システム内の最大ジョブ数と同数のジョブがキュー中に残っていると，サブミットに失敗します。

この設定は，実際に実行中になったジョブも含みます。ジョブ数は，jpqqueshowコマンドの-qオプションで表示される「QUEUING」と「EXECUTING」の両方を合わせた値です。

キュー内のジョブ数の最大値：1～4,294,967,295の値

warn_jobs キュー内のジョブ数の警告値

キュー内のジョブ数が，キューにためておくことができるジョブ数の最大値に近づいたことを知らせる警告値を指定します。省略した場合，4,294,967,295が仮定されます。

この設定は，実際に実行中になったジョブも含みます。ジョブ数は，jpqqueshowコマンドの-qオプションで表示される「QUEUING」と「EXECUTING」の両方を合わせた値です。

ジョブ数が警告値に達すると，警告メッセージ「KAVU4516-W」が統合トレースログに出力されます。

キュー内のジョブ数の警告値：1～4,294,967,295の値（ただし，キュー内のジョブ数の最大値と等しいか，または小さい値）

queue_ent {open|close}

キューの，ジョブの受付口の状態を指定します。受付口が閉じている場合，キューにジョブを投入できません。省略した場合，openが仮定されます。

open：受付口を開く。

close：受付口を閉じる。

queue_exit {open|close}

キューの，ジョブの取出口の状態を指定します。取出口が閉じている場合，キューでジョブを実行できません。ジョブはキューにたまります。省略した場合，openが仮定されます。

open：取出口を開く。

close：取出口を閉じる。

connect $エージェントID 優先順位

キューに接続するエージェントホストのIDを指定します。エージェントIDは複数指定できます。省略した場合，キュー名を指定したジョブは実行できません。

$エージェントID：接続するエージェントホストのIDを，「$an」の形式で指定する。

優先順位：1～16の値（優先順位がいちばん低いのが1，いちばん高いのが16）。優先順位が高いほど，ジョブが優先的に実行される。

$end

キュー情報の終端を指定します。

$end：固定

記述例

$queue $q3 queue1
max_jobs 10
warn_jobs 5
queue_ent open
queue_exit close
connect $a1 1
connect $a2 2
$end

排他実行リソース定義

形式

$res $排他実行リソースID 排他実行リソース名
$end

引数

$res $排他実行リソースID 排他実行リソース名

排他実行リソース名を指定します。

$res：固定

$排他実行リソースID：「$rn（nはマネージャーホスト内でユニークな値，0以外の値）」の形式で指定する。nは，環境設定時に指定した排他実行リソース定義数以下の値を指定する（例えば，排他実行リソース定義数を256とした場合，nには256以下の値を指定する。257以上の値を指定すると，エラーになる）。

排他実行リソース名：63バイト以内の文字列

$end

排他実行リソース情報の終端を指定します。

$end：固定

記述例

$res $r1 DAT_System
$end

$res $r2 Temp_File01
$end

jpqregguestuser

形式

jpqregguestuser
    [-lh 論理ホスト名] [{-lu ユーザー名|-d}]

機能

JP1ユーザー仮定機能を使用する場合，指定したJP1/AJS2ホストの環境設定に，JP1仮定ユーザーを一つだけ登録します。また，登録したJP1仮定ユーザー情報を表示します。

なお，このコマンドで設定した内容を反映させるには，コマンド実行後にJP1/AJS2の再起動が必要です。

実行権限

Windowsの場合：Administrators権限

UNIXの場合：スーパーユーザー権限

引数

-lh 論理ホスト名

JP1仮定ユーザー情報を登録する，JP1/AJS2ホストの論理ホスト名として，マネージャーホスト名を指定します。

指定できる文字数は，1～255（単位：バイト）です。

省略した場合，自ホスト名が仮定されます。

-lu ユーザー名

仮定するJP1ユーザーのユーザー名を小文字で指定します。

指定できる文字数は，1～31（単位：バイト）です。

省略した場合，JP1仮定ユーザー情報に登録しません。このとき，すでにJP1ユーザーが仮定されている場合は，標準出力ファイルにメッセージ（現在登録済みのJP1仮定ユーザー名）を出力します。

なお，新しく仮定しようとするJP1ユーザーのユーザー名と，すでに仮定しているJP1ユーザーのユーザー名が同一になる場合は，新しく仮定しようとするJP1ユーザーの情報が上書きされます。

-d

登録済みのJP1仮定ユーザー情報を削除します。

このオプションを指定すると，JP1ユーザー仮定機能は使用できません。

注意事項

JP1/Baseを前提とするJP1シリーズの製品の稼働中には，このコマンドを実行しないでください。

JP1ユーザーのユーザー名を指定するときは，小文字を使用しください。大文字を使用した場合は小文字で登録されるので注意してください。小文字で登録されることによって，新しく仮定しようとするJP1ユーザーのユーザー名が，すでに仮定しているJP1ユーザーのユーザー名と同一名称になる場合，登録されている情報に対して上書きをします。

JP1ユーザー仮定機能を使用する場合は，このコマンドで指定したJP1仮定ユーザーをユーザーマッピングに登録してください。また，ジョブを実行するエージェントホストにも登録が必要です。なお，ユーザー権限レベルの設定は，実行したい操作に合わせてください。

コマンドの使用目的，手順，その他の注意事項については，「7.4 JP1ユーザー仮定機能の設定」（Windowsの場合），または「16.3 JP1ユーザー仮定機能の設定」（UNIXの場合）を参照してください。

Windows Server 2008のマシンでこのコマンドを実行する際には，コマンドプロンプトを管理者として起動する必要があります。コマンドプロンプトを起動する際は，Windowsの［スタート］メニューの［コマンドプロンプト］を右クリックし，ショートカットメニューから［管理者として実行］を選択してください。なお，UAC機能が無効の場合は，コマンドプロンプトを管理者として起動する必要はありません。

戻り値

0 | 正常終了。
1 | 引数の指定が不適切である。
140 | このコマンドを実行する権限がない。
145 | メモリー不足が発生した。
147 | 内部的要因エラーが発生した。
160 | 登録されていないJP1仮定ユーザー情報を削除しようとしている。
172 | JP1仮定ユーザー登録状態が不正である。

補足事項

このコマンドの実行によってJP1ユーザーを仮定できるのは，JP1/AJS2のジョブ実行制御で提供しているコマンドです。

JP1ユーザーとしてあらかじめ仮定したユーザーを登録しておくことで，OSユーザーがJP1ユーザーとして登録されていないユーザーであっても，仮定したJP1ユーザーの権限を使用してJP1/AJS2の操作ができます。なお，実行するOSユーザーがJP1ユーザーとして登録されている場合は，そのJP1ユーザーを使用します。

jpqreguser

形式1

jpqreguser
    [-lh 論理ホスト名]
    [-lu ユーザー名]
    -rh 接続するJP1/OJE for VOS3ホスト名
    -ru 接続するJP1/OJE for VOS3ホスト上のユーザー名
    [-rg 接続するJP1/OJE for VOS3ホスト上のグループ名]

機能1

JP1/OJE for VOS3との連携を開始する前に，ジョブの操作元のJP1/AJS2ホストに，VOS3ユーザーのユーザー情報を登録します。また，登録したユーザー情報を変更します。

登録するユーザーおよび登録するホストは，JP1/AJS2 - ViewでQUEUEジョブを実行する場合と，コマンドを使用してジョブを実行する場合で異なります。詳細は，マニュアル「JP1/Automatic Job Management System 2 連携ガイド　8.3 QUEUEジョブまたはサブミットジョブを実行するためのセットアップ」を参照してください。

形式2

jpqreguser
    [-lh 論理ホスト名]
    [-lu ユーザー名]
    -d
    -rh 接続するJP1/OJE for VOS3ホスト名

機能2

登録したユーザー情報を削除します。

形式3

jpqreguser
    [-lh 論理ホスト名]
    -a

機能3

登録したユーザー情報の一覧を表示します。

実行権限

Windows Server 2008で機能1および機能2を実行する場合：Administrators権限

-luオプションを指定する場合
Windowsの場合：Administrators権限
UNIXの場合：スーパーユーザー権限

その他の場合：なし

引数

-lh 論理ホスト名

ユーザー情報を登録する，JP1/AJS2ホストの論理ホスト名を指定します。

指定できる文字数は，1～255（単位：バイト）です。省略した場合，自ホスト名が仮定されます。

-lu ユーザー名

JP1/OJE for VOS3ホストのジョブを操作するときに使用するユーザー名を指定します。

指定できる文字数は，1～63（単位：バイト）です。

JP1ユーザーまたはOSユーザーを指定します。どちらを指定するかは，ジョブの要求元ユーザーに合わせて指定してください。次のように，場合によってジョブの要求元ユーザーが異なります。

ジョブネットでQUEUEジョブを定義して実行する場合：JP1ユーザー

サブミットジョブで実行する場合：OSユーザー

省略した場合，ログインしているユーザー名が仮定されます。

このオプションは，Administrators権限（Windowsの場合），またはスーパーユーザー権限（UNIXの場合）を持つユーザーだけが指定できます。

-rh 接続するJP1/OJE for VOS3ホスト名

接続するJP1/OJE for VOS3ホスト名を指定します。

指定できる文字数は，1～255（単位：バイト）です。

-ru 接続するJP1/OJE for VOS3ホスト上のユーザー名

-rhオプションで指定したホストのジョブを操作するときに使用する，JP1/OJE for VOS3ホスト上のユーザー名を指定します。

指定できる文字数は，1～32（単位：バイト）です。

-rg 接続するJP1/OJE for VOS3ホスト上のグループ名

-ruオプションで指定したユーザーが所属するJP1/OJE for VOS3上のグループ名を指定します。

指定できる文字数は，1～32（単位：バイト）です。省略した場合，グループなしと仮定されます。

-d

登録済みのユーザー情報を削除します。

-luオプションを指定して登録したユーザー情報を削除する場合は，-luオプションを指定してください。

-luオプションを省略して登録したユーザー情報を削除する場合は，ユーザーを登録する際に指定したパスワードの入力が必要です。

-a

ユーザー情報の一覧を表示します。

注意事項

JP1/Baseを前提とするJP1シリーズの製品の稼働中には，このコマンドを実行しないでください。

JP1/OJE for VOS3ホストにジョブをサブミットしたり，サブミットしたジョブを削除したりしたい場合は，必ず事前にユーザー情報を登録しておいてください。ただし，ユーザー情報を登録しなくても，JP1/OJE for VOS3ホストのジョブ情報を参照することはできます。

ユーザー情報の登録時，情報変更時，および削除時は，パスワードの入力が必要です。

ユーザー情報の登録時は，接続するJP1/OJE for VOS3ホスト上のユーザーに対応するパスワードを入力してください。

ユーザー情報の変更時は，登録時に指定したVOS3ユーザーに対応するパスワードを入力してください。別のVOS3ユーザーに変更する場合は，新しいVOS3ユーザーに対応するパスワードも入力してください。

ユーザー情報の削除時は，登録時に指定したVOS3ユーザーに対応するパスワードを入力してください。

-luオプションを指定して登録したユーザー情報を変更，削除する場合，パスワードを入力する必要はありません。

大文字・小文字が異なるだけのユーザー名は，1件しか登録できません。

Windows Server 2008のマシンでこのコマンドを実行する際（-aオプション指定時以外）には，コマンドプロンプトを管理者として起動する必要があります。コマンドプロンプトを起動する際は，Windowsの［スタート］メニューの［コマンドプロンプト］を右クリックし，ショートカットメニューから［管理者として実行］を選択してください。なお，UAC機能が無効の場合は，コマンドプロンプトを管理者として起動する必要はありません。

クラスタシステムで運用する場合の注意事項

クラスタシステムで運用する場合は，実行系ホストおよび待機系ホストの両方にユーザー情報を設定する必要があります。実行系ホストのユーザー情報を追加・変更・削除した場合は，次の手順に従って待機系ホストのユーザー情報を追加・変更・削除してください。

実行系ホストで次のコマンドを実行して定義情報を保存する。
jbsgetcnf -h 論理ホスト名 > 定義情報ファイル名
jbsgetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

待機系ホストで次のコマンドを実行し，バックアップとして定義情報を退避する。
jbsgetcnf -h 論理ホスト名 > 退避ファイル名

待機系ホストで次のコマンドを実行し，登録済みのユーザー情報を削除する。
jbsunsetcnf -h 論理ホスト名 -c JP1NBQCLIENT -n Profile
jbsunsetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

待機系ホストで手順1で保存した定義情報ファイルを使用し，次のコマンドを実行する。
jbssetcnf 手順1で保存した定義情報ファイル
jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

待機系ホストでJP1/AJS2を再起動する。
定義情報ファイルに記述した内容が反映されます。

戻り値

0
正常終了。

1
引数の指定が不適切である。

160
登録されていないユーザー情報を削除しようとしている。

165
次の場合のどれか。

Windows Server 2008で，Administrators権限を持たないユーザーが機能1または機能2を実行しようとした

Windows Server 2008以外の実行ホストで，管理者権限（Administrators権限（Windowsの場合）またはスーパーユーザー権限（UNIXの場合））を持たないユーザーが-luオプションを指定した

166
パスワードが一致しないため，ユーザー情報を更新・削除できない。

170
メモリー不足が発生した。

171
このコマンドを実行する権限がない。

172
内部的要因エラーが発生した。

jpqshmake（UNIX限定）

形式

jpqshmake
    [論理ホスト名]

機能

次のどちらかの条件の場合に発生する共有メモリーのセグメント数の増加を抑止します。

サービス起動時にjajs_killall.clusterコマンドを実行する。

サービス起動時にjpqagtdmnプロセスが異常終了する。

なお，このコマンドはJP1/AJS2 06-71-G1以前のバージョンから上書きインストールした場合に，セットアップ後に一度だけ実行してください。新規インストールの場合，実行する必要はありません。

詳細については，「13.5.1 ジョブ実行制御で使用する共有メモリーについて」を参照してください。

実行権限

UNIXの場合：スーパーユーザー権限

引数

論理ホスト名

JP1/AJS2を起動する論理ホスト環境の論理ホスト名を指定します。

指定できる文字数は，1～255（単位：バイト）です。

クラスタ構成の論理ホストの場合だけ， この引数を指定します。

戻り値

0 | 正常終了。
0以外の値 | 異常終了。

付録

＜この付録の構成＞

付録A　インストールおよびセットアップ時の作業チェック

付録B　環境変数および環境変数ファイルを定義する場合の注意事項

付録C　Oracleデータベースの移行

付録D　HiRDBからのデータベースの移行

付録E　誤った環境設定パラメーターを設定したときの回復方法

付録F　08-00以降で設定する環境設定項目の推奨値

付録G　各バージョンの変更内容

付録H　（3020-3-K23-43）の変更内容

付録I　用語解説

付録A　インストールおよびセットアップ時の作業チェック

＜この節の構成＞

付録A.1　インストールおよびセットアップ時のチェックリスト（Windowsホストの場合）

付録A.2　インストールおよびセットアップ時のチェックリスト（UNIXホストの場合）

付録A.1　インストールおよびセットアップ時のチェックリスト（Windowsホストの場合）

JP1/AJS2のインストールおよびセットアップ時のチェックリストを示します。

＜この項の構成＞

(1)　JP1/AJS2 - Manager用（ISAMデータベースを使用する場合）のチェックリスト

(2)　JP1/AJS2 - Manager用（組み込みDBを使用する場合）のチェックリスト

(3)　JP1/AJS2 - Agent用のチェックリスト

(4)　JP1/AJS2 - View用のチェックリスト

(1)　JP1/AJS2 - Manager用（ISAMデータベースを使用する場合）のチェックリスト

インストールおよびセットアップ時のチェックリストを次に示します。

表A-1　インストールおよびセットアップ時のチェックリスト（JP1/AJS2 - Manager用（ISAMデータベースを使用する場合））

分類 | 作業内容 | Base | AJS2 | 確認
インストール | JP1/Baseのインストール | ○ | － |
JP1/AJS2 - Managerのインストール | － | ○ |
ユーザー情報の設定 | 認証サーバの設定 | ○※1 | － |
JP1ユーザーの登録 | ○※1 | － |
JP1権限レベルの設定 | ○※1 | － |
ユーザーマッピング | ○※1 | － |
サービスアカウントの設定 | JP1/AJS2サービスアカウントの設定 | － | △※2 |
論理ホストの設定 | ［マネージャー環境設定］ダイアログボックスでの定義 | － | ○※1 |
スケジューラーサービス環境の設定 | ［マネージャー環境設定］ダイアログボックスの［論理ホスト共通］タブでの定義 | － | △※2 |
［マネージャー環境設定］ダイアログボックスの［スケジューラーサービス制御］タブでの定義 | － | △※2 |
［マネージャー環境設定］ダイアログボックスの［スケジューラーファイルの構成］タブでの定義 | － | △※2 |
［マネージャー環境設定］ダイアログボックスの［スケジューラーファイルの構成2］タブでの定義 | － | △※2 |
［マネージャー環境設定］ダイアログボックスの［スケジューラーログの設定］タブでの定義 | － | △※2 |
［マネージャー環境設定］ダイアログボックスの［スケジューラーオプション］タブでの定義 | － | △※2 |
ジョブ実行環境の設定 | ［マネージャー環境設定］ダイアログボックスの［ジョブ実行環境］タブでの定義 | － | △※2 |
イベントサービス環境の設定 | ［マネージャー環境設定］ダイアログボックスの［イベント起動］タブでの定義 | － | △※2 |
キューレスジョブ実行環境の設定 | ［マネージャー環境設定］ダイアログボックスの［キューレスジョブ実行環境］タブでの定義 | － | △※2 |
JP1/AJS2 Console環境の設定 | JP1/AJS2 Console Manager環境設定ファイル（ajs2cm.conf）の設定・変更 | － | △※2 |
ユーザー環境の設定 | トレースログファイルの拡張 | － | △ |
その他の環境設定 | スケジューラーサービスの多重起動の設定 | － | △ |
ISAMファイルの自動再編成機能の設定 | － | △ |
スケジューラーサービスの統合トレースログ出力レベルの変更 | － | △ |
ネストジョブネット定義パラメーター出力時のスケジュールルールの出力方法の変更 | － | △ |
スケジューラートレースログファイルの名称変更 | － | △ |
JP1/AJS2 - Managerの運用方法をサブミットジョブの登録や操作に限定するときの設定 | － | △ |
サスペンド機能の設定 | － | △ |

（凡例）

Base：JP1/Baseで実施する作業

AJS2：JP1/AJS2で実施する作業

○：必須の作業

△：必要に応じて実施する作業

－：該当しない作業

注※1

07-00以降のJP1/BaseおよびJP1/AJS2を新規導入する場合は，作業は不要です。デフォルトで設定されている値を変更する場合だけ作業してください。

注※2

すべてデフォルトで設定されている値をそのまま使用する場合は，作業は不要です。デフォルトで設定されている値を変更する場合だけ作業してください。

(2)　JP1/AJS2 - Manager用（組み込みDBを使用する場合）のチェックリスト

インストールおよびセットアップ時のチェックリストを次に示します。

表A-2　インストールおよびセットアップ時のチェックリスト（JP1/AJS2 - Manager用（組み込みDBを使用する場合））

分類 | 作業内容 | Base | AJS2 | 確認
インストール | JP1/Baseのインストール | ○ | － |
JP1/AJS2 - Managerのインストール | － | ○ |
組み込みDBのインストール | － | ○ |
ユーザー情報の設定 | 認証サーバの設定 | ○※1 | － |
JP1ユーザーの登録 | ○※1 | － |
JP1権限レベルの設定 | ○※1 | － |
ユーザーマッピング | ○※1 | － |
組み込みDB環境の設定 | 組み込みDBサーバの設定およびセットアップ | － | ○ |
サービスアカウントの設定 | JP1/AJS2サービスアカウントの設定 | － | △※2 |
論理ホストの設定 | ［マネージャー環境設定］ダイアログボックスでの定義 | － | ○ |
スケジューラーサービス環境の設定 | ［マネージャー環境設定］ダイアログボックスの［論理ホスト共通］タブでの定義 | － | △ |
［マネージャー環境設定］ダイアログボックスの［スケジューラーサービス制御］タブでの定義 | － | △ |
［マネージャー環境設定］ダイアログボックスの［スケジューラーファイルの構成］タブでの定義 | － | ○ |
［マネージャー環境設定］ダイアログボックスの［スケジューラーファイルの構成2］タブでの定義 | － | △※2 |
［マネージャー環境設定］ダイアログボックスの［スケジューラーログの設定］タブでの定義 | － | △※2 |
［マネージャー環境設定］ダイアログボックスの［スケジューラーオプション］タブでの定義 | － | △※2 |
ジョブ実行環境の設定 | ［マネージャー環境設定］ダイアログボックスの［ジョブ実行環境］タブでの定義 | － | △※2 |
イベントサービス環境の設定 | ［マネージャー環境設定］ダイアログボックスの［イベント起動］タブでの定義 | － | △※2 |
キューレスジョブ実行環境の設定 | ［マネージャー環境設定］ダイアログボックスの［キューレスジョブ実行環境］タブでの定義 | － | △※2 |
JP1/AJS2 Console環境の設定 | JP1/AJS2 Console Manager環境設定ファイル（ajs2cm.conf）の設定・変更 | － | △※2 |
ユーザー環境の設定 | トレースログファイルの拡張 | － | △ |
その他の環境設定 | スケジューラーサービスの多重起動の設定 | － | △ |
ISAMファイルの自動再編成機能の設定 | － | △ |
スケジューラーサービスの統合トレースログ出力レベルの変更 | － | △ |
ネストジョブネット定義パラメーター出力時のスケジュールルールの出力方法の変更 | － | △ |
スケジューラートレースログファイルの名称変更 | － | △ |
JP1/AJS2 - Managerの運用方法をサブミットジョブの登録や操作に限定するときの設定 | － | △ |
サスペンド機能の設定 | － | △ |

（凡例）

Base：JP1/Baseで実施する作業

AJS2：JP1/AJS2で実施する作業

○：必須の作業

△：必要に応じて実施する作業

－：該当しない作業

注※1

07-00以降のJP1/BaseおよびJP1/AJS2を新規導入する場合は，作業は不要です。デフォルトで設定されている値を変更する場合だけ作業してください。

注※2

すべてデフォルトで設定されている値をそのまま使用する場合は，作業は不要です。デフォルトで設定されている値を変更する場合だけ作業してください。

(3)　JP1/AJS2 - Agent用のチェックリスト

インストールおよびセットアップ時のチェックリストを次に示します。

表A-3　インストールおよびセットアップ時のチェックリスト（JP1/AJS2 - Agent用）

分類 | 作業内容 | Base | AJS2 | 確認
インストール | JP1/Baseのインストール | ○ | － |
JP1/AJS2 - Agentのインストール | － | ○ |
ユーザー情報の設定 | JP1ユーザーの登録 | ○※ | － |
JP1権限レベルの設定 | ○※ | － |
ユーザーマッピング | ○※ | － |
サービスアカウントの設定 | JP1/AJS2サービスアカウントの設定 | － | △※ |
論理ホストの設定 | ［マネージャー環境設定］ダイアログボックスでの定義 | － | ○※ |
ジョブ実行環境の設定 | ［マネージャー環境設定］ダイアログボックスの［ジョブ実行環境］タブでの定義 | － | △※ |
イベントサービス環境の設定 | ［マネージャー環境設定］ダイアログボックスの［イベント起動］タブでの定義 | － | △※ |
キューレスジョブ実行環境の設定 | ［マネージャー環境設定］ダイアログボックスの［キューレスジョブ実行環境］タブでの定義 | － | △※ |
ユーザー環境の設定 | トレースログファイルの拡張 | － | △ |

（凡例）

Base：JP1/Baseで実施する作業

AJS2：JP1/AJS2で実施する作業

○：必須の作業

△：必要に応じて実施する作業

－：該当しない作業

注※

すべてデフォルトで設定されている値をそのまま使用する場合は，作業は不要です。デフォルトで設定されている値を変更する場合だけ作業してください。

(4)　JP1/AJS2 - View用のチェックリスト

インストールおよびセットアップ時のチェックリストを次に示します。

表A-4　インストールおよびセットアップ時のチェックリスト（JP1/AJS2 - View用）

分類 | 作業内容 | Base | AJS2 | 確認
インストール | JP1/AJS2 - Viewのインストール | － | ○ |
統合トレースログ機能の起動 | 統合トレースログ機能（HNTRLib2）の起動 | － | △※1 |
JP1/AJS2 - Viewの環境設定 | ［環境設定］ダイアログボックスでの定義 | － | △※2 |

（凡例）

Base：JP1/Baseで実施する作業

AJS2：JP1/AJS2で実施する作業

○：必須の作業

△：必要に応じて実施する作業

－：該当しない作業

注※1

1台のホストにJP1/AJS2 - Viewだけをインストールして，JP1/AJS2 - Viewホストとして使用する場合は，必須の作業になります。

注※2

すべてデフォルトで設定されている値をそのまま使用する場合は，作業は不要です。デフォルトで設定されている値を変更する場合だけ作業してください。

付録A.2　インストールおよびセットアップ時のチェックリスト（UNIXホストの場合）

JP1/AJS2のインストールおよびセットアップ時のチェックリストを示します。

＜この項の構成＞

(1)　JP1/AJS2 - Manager用（ISAMデータベースを使用する場合）のチェックリスト

(2)　JP1/AJS2 - Manager用（組み込みDBを使用する場合）のチェックリスト

(3)　JP1/AJS2 - Agent用のチェックリスト

(1)　JP1/AJS2 - Manager用（ISAMデータベースを使用する場合）のチェックリスト

インストールおよびセットアップ時のチェックリストを次に示します。

表A-5　インストールおよびセットアップ時のチェックリスト（JP1/AJS2 - Manager用（ISAMデータベースを使用する場合））

分類 | 作業内容 | Base | AJS2 | 確認
インストール | JP1/Baseのインストール | ○ | － |
JP1/AJS2 - Managerのインストール | － | ○ |
ユーザー情報の設定 | 認証サーバの設定 | ○※1 | － |
JP1ユーザーの登録 | ○※1 | － |
JP1権限レベルの設定 | ○※1 | － |
ユーザーマッピング | ○※1 | － |
スケジューラーサービス環境の設定 | スケジューラーサービス環境環境設定ファイル（Schedule.conf）の設定・変更 | － | △※2 |
ジョブ実行環境の設定 | ジョブ実行環境設定ファイル（Queue.conf）の設定・変更 | － | △※2 |
イベントサービス環境の設定 | イベント・アクション定義ファイル（EVAction.conf）の設定・変更 | － | △※2 |
キューレスジョブ実行環境の設定 | キューレスジョブ実行環境設定ファイル（Queueless.conf）の設定・変更 | － | △※2 |
JP1/AJS2 Console環境の設定 | JP1/AJS2 Console Manager環境設定ファイル（ajs2cm.conf）の設定・変更 | － | △※2 |
システム環境の設定 | 言語環境の設定 | － | △ |
ユーザー環境の設定 | コマンドおよびライブラリー検索パスの設定 | － | △ |
ログインスクリプトの変更 | － | △ |
カーネルパラメーターの調整 | － | △ |
トレースログファイルの拡張 | － | △ |
その他の環境設定 | スケジューラーサービスの多重起動の設定 | － | △ |
JP1/AJS2サービスの自動起動および自動終了の設定 | － | △ |
ISAMファイル自動再編成機能の設定 | － | △ |
JP1/AJS2 - Managerの運用方法をサブミットジョブの登録や操作に限定するときの設定 | － | △ |
サスペンド機能の設定 | － | △ |

（凡例）

Base：JP1/Baseで実施する作業

AJS2：JP1/AJS2で実施する作業

○：必須の作業

△：必要に応じて実施する作業

－：該当しない作業

注※1

07-00以降のJP1/BaseおよびJP1/AJS2を新規導入する場合は，作業は不要です。デフォルトで設定されている値を変更する場合だけ作業してください。

注※2

すべてデフォルトで設定されている値をそのまま使用する場合は，作業は不要です。デフォルトで設定されている値を変更する場合だけ作業してください。

(2)　JP1/AJS2 - Manager用（組み込みDBを使用する場合）のチェックリスト

インストールおよびセットアップ時のチェックリストを次に示します。

表A-6　インストールおよびセットアップ時のチェックリスト（JP1/AJS2 - Manager用（組み込みDBを使用する場合））

分類 | 作業内容 | Base | AJS2 | 確認
インストール | JP1/Baseのインストール | ○ | － |
JP1/AJS2 - Managerのインストール | － | ○ |
組み込みDBのインストール | － | ○ |
ユーザー情報の設定 | 認証サーバの設定 | ○※1 | － |
JP1ユーザーの登録 | ○※1 | － |
JP1権限レベルの設定 | ○※1 | － |
ユーザーマッピング | ○※1 | － |
組み込みDB環境の設定 | 組み込みDBサーバの設定およびセットアップ | － | ○ |
スケジューラーサービス環境の設定 | スケジューラーサービス環境環境設定ファイル（Schedule.conf）の設定・変更 | － | △ |
ジョブ実行環境の設定 | ジョブ実行環境設定ファイル（Queue.conf）の設定・変更 | － | △※2 |
イベントサービス環境の設定 | イベント・アクション定義ファイル（EVAction.conf）の設定・変更 | － | △※2 |
キューレスジョブ実行環境の設定 | キューレスジョブ実行環境設定ファイル（Queueless.conf）の設定・変更 | － | △※2 |
JP1/AJS2 Console環境の設定 | JP1/AJS2 Console Manager環境設定ファイル（ajs2cm.conf）の設定・変更 | － | △※2 |
システム環境の設定 | 言語環境の設定 | － | △ |
ユーザー環境の設定 | コマンドおよびライブラリー検索パスの設定 | － | △ |
ログインスクリプトの変更 | － | △ |
カーネルパラメーターの調整 | － | △ |
トレースログファイルの拡張 | － | △ |
その他の環境設定 | スケジューラーサービスの多重起動の設定 | － | △ |
JP1/AJS2サービスの自動起動および自動終了の設定 | － | △ |
ISAMファイル自動再編成機能の設定 | － | △ |
JP1/AJS2 - Managerの運用方法をサブミットジョブの登録や操作に限定するときの設定 | － | △ |
サスペンド機能の設定 | － | △ |

（凡例）

Base：JP1/Baseで実施する作業

AJS2：JP1/AJS2で実施する作業

○：必須の作業

△：必要に応じて実施する作業

－：該当しない作業

注※1

07-00以降のJP1/BaseおよびJP1/AJS2を新規導入する場合は，作業は不要です。デフォルトで設定されている値を変更する場合だけ作業してください。

注※2

すべてデフォルトで設定されている値をそのまま使用する場合は，作業は不要です。デフォルトで設定されている値を変更する場合だけ作業してください。

(3)　JP1/AJS2 - Agent用のチェックリスト

インストールおよびセットアップ時のチェックリストを次に示します。

表A-7　インストールおよびセットアップ時のチェックリスト（JP1/AJS2 - Agent用）

分類 | 作業内容 | Base | AJS2 | 確認
インストール | JP1/Baseのインストール | ○ | － |
JP1/AJS2 - Agentのインストール | － | ○ |
ユーザー情報の設定 | JP1ユーザーの登録 | ○※ | － |
JP1権限レベルの設定 | ○※ | － |
ユーザーマッピング | ○※ | － |
ジョブ実行環境の設定 | ジョブ実行環境設定ファイル（Queue.conf）の設定・変更 | － | △※ |
イベントサービス環境の設定 | イベント・アクション定義ファイル（EVAction.conf）の設定・変更 | － | △※ |
キューレスジョブ実行環境の設定 | キューレスジョブ実行環境設定ファイル（Queueless.conf）の設定・変更 | － | △※ |
システム環境の設定 | 言語環境の設定 | － | △ |
ユーザー環境の設定 | コマンドおよびライブラリー検索パスの設定 | － | △ |
ログインスクリプトの変更 | － | △ |
カーネルパラメーターの調整 | － | △ |
トレースログファイルの拡張 | － | △ |

（凡例）

Base：JP1/Baseで実施する作業

AJS2：JP1/AJS2で実施する作業

○：必須の作業

△：必要に応じて実施する作業

－：該当しない作業

注※

すべてデフォルトで設定されている値をそのまま使用する場合は，作業は不要です。デフォルトで設定されている値を変更する場合だけ作業してください。

付録B　環境変数および環境変数ファイルを定義する場合の注意事項

＜この節の構成＞

付録B.1　環境変数を定義するときの注意事項

付録B.2　環境変数ファイルを定義するときの注意事項

付録B.1　環境変数を定義するときの注意事項

ジョブ実行時に使用する環境変数を定義する場合の注意事項を示します。

なお，環境変数の一覧については，マニュアル「JP1/Automatic Job Management System 2 コマンドリファレンス　1. コマンド　環境変数一覧」を参照してください。

環境変数は「環境変数名=値」の形式で指定してください。複数指定する場合は，「環境変数名=値」ごとに改行文字で区切ってください。

（例）

環境変数名1=ABCD<改行>

環境変数名2=EFGH<改行>

<改行>は改行コードで区切り，「；」や「：」などの文字は使用しないでください。

「環境変数名=値」の形式以外の文字列は指定しないでください。ジョブを実行するホストのOSによってはジョブが異常終了することがあります。

「AJS」で始まる環境変数（例：AJSxxxx（xxxxは任意の文字列））は，システムで予約しているため，大文字・小文字にかかわらず，使用しないでください。

「JP1」で始まる環境変数（例：JP1xxxx（xxxxは任意の文字列））は，システムで予約しているため，大文字・小文字にかかわらず，使用しないでください。

次に示す環境変数は，ジョブ定義の「環境変数」や「環境変数ファイル名」に指定するファイルの中に設定できません。

AJSENV

AJSPRE_ST

AJSPRE_RC

AJSNETNAME

AJSJOBNAME

AJSHOST

AJS_AJSCONF

AJSEXDATE

AJSEXECID

AJSEXECPID

JP1JobName

JP1JobID

JP1UserName

HOME

SHELL

LANG

LOGNAME

MAIL

PATH

環境変数には，JP1/AJS2で設定されるもの（ジョブ実行時に設定される環境変数，ジョブ定義時に指定した環境変数，ジョブ定義時に環境変数ファイルとして指定したファイル内の環境変数）のほかに，ジョブ定義時に指定したコマンド文やスクリプトファイル，ローカルログインスクリプト，システムログインスクリプトにも設定できます。これらの中で同じ環境変数があった場合，次に示す優先順位に従って有効になります（優先順位がいちばん高いのは1です）。

Windowsの場合

1.　環境変数※1に指定した環境変数

2.　環境変数ファイル※2に指定した環境変数

3.　システム環境変数

UNIXの場合

1.　ジョブ定義時に指定したコマンドやスクリプトファイルでの定義

2.　ローカルログインスクリプトでの定義

3.　システムログインスクリプトでの定義

4.　環境変数※1に指定した環境変数

5.　環境変数ファイル※2に指定した環境変数

　注※1

JP1/AJS2 - Viewのダイアログボックスで環境変数に指定した変数，またはjpqjobsubコマンドの-envオプションに指定した変数

　注※2

JP1/AJS2 - Viewのダイアログボックスで環境変数ファイルに指定した変数，またはjpqjobsubコマンドの-evオプションに指定した変数ファイル

JP1/AJS2 - View のダイアログボックスで環境変数を定義する場合，またはjpqjobsubコマンドの-envオプションで，次の例のように値に環境変数を参照する指定はできません。
環境変数'xyz'には'%abc%'がそのまま文字列として設定されます。

（例）

abc=1

xyz=%abc%

環境変数の値を参照する指定をする場合は，実行するジョブのバッチファイルまたはスクリプトファイルで指定してください。

注意

Windowsの場合，JP1/AJS2は，通常，JP1/AJS2サービスとして起動されるため，ユーザー環境変数は読み込みません。JP1/AJS2からジョブを起動する際は，JP1/AJS2サービス起動時に読み込んだシステム環境変数を設定します。ただし，クラスタシステムをセットアップすると，MSCSから起動したJP1/AJS2サービス（論理ホストだけ）ではユーザー環境変数が有効になります。これは，MSCSの仕様でMSCSがユーザー環境変数を読み込むためです。MSCS以外のクラスタソフトについては仕様を確認してください。

なお，JP1/AJS2サービス起動時に読み込む環境変数は，システム環境変数のほかに，OSが起動する際に設定する環境変数を含みます。ログインスクリプトに指定した環境変数は読み込みません。

付録B.2　環境変数ファイルを定義するときの注意事項

ジョブ実行時に使用する環境変数ファイルに環境変数名を定義する前に，実行するホスト側のOSで有効な名称かどうか確認してください。

定義した環境変数名が，実行するホスト上で扱えない名称の場合は，環境変数ファイルに指定した内容は無効になります。この場合，ホスト側では環境変数は設定されません。

次に，ジョブ実行時に使用する環境変数ファイルに環境変数を定義する場合の文法上の注意事項を示します。

＜この項の構成＞

(1)　Windows環境で環境変数ファイルを定義するときの注意事項

(2)　UNIX環境で環境変数ファイルを定義するときの注意事項

(1)　Windows環境で環境変数ファイルを定義するときの注意事項

環境変数名は，行の先頭から記載してください。

環境変数は「環境変数名=値」の形式で指定してください。複数指定する場合は，「環境変数名=値」ごとに改行文字で区切ってください。

（例）

環境変数名1=ABCD<改行>

環境変数名2=EFGH<改行>

<改行>は改行コードで区切り，「；」や「：」などの文字は使用しないでください。

「環境変数名=値」の形式以外の文字列は指定しないでください。ジョブを実行するホストのOSによってはジョブが異常終了することがあります。

値は，"="以降から改行コードまでを一つとします。

「AJS」で始まる環境変数（例：AJSxxxx（xxxxは任意の文字列））は，システムで予約しているため，大文字・小文字にかかわらず，使用しないでください。

「JP1」で始まる環境変数（例：JP1xxxx（xxxxは任意の文字列））は，システムで予約しているため，大文字・小文字にかかわらず，使用しないでください。

次の例のように値に環境変数を参照する指定はできません。
環境変数'xyz'には'%abc%'がそのまま文字列として設定されます。

（例）

abc=1

xyz=%abc%

環境変数の値を参照する指定をする場合は，実行するジョブのバッチファイルで指定してください。

(2)　UNIX環境で環境変数ファイルを定義するときの注意事項

環境変数名は，行の先頭から記載してください。

環境変数は「環境変数名=値」の形式で指定してください。複数指定する場合は，「環境変数名=値」ごとに改行文字で区切ってください。

（例）

環境変数名1=ABCD<改行>

環境変数名2=EFGH<改行>

<改行>は改行コードで区切り，「；」や「：」などの文字は使用しないでください。

「環境変数名=値」の形式以外の文字列は指定しないでください。ジョブを実行するホストのOSによってはジョブが異常終了することがあります。

値は，"="以降から改行コードまでを一つとします。

「AJS」で始まる環境変数（例：AJSxxxx（xxxxは任意の文字列））は，システムで予約しているため，大文字・小文字にかかわらず，使用しないでください。

「JP1」で始まる環境変数（例：JP1xxxx（xxxxは任意の文字列））は，システムで予約しているため，大文字・小文字にかかわらず，使用しないでください。

次に示す環境変数は，JP1/AJS2で値が設定されているため，環境変数ファイルの中に指定しないでください。

HOME

SHELL

LANG

LOGNAME

MAIL

PATH

次の例のように値に環境変数を参照する指定はできません。
環境変数'xyz'には'$abc'がそのまま文字列として設定されます。

（例）

abc=1

xyz=$abc

環境変数の値を参照する指定をする場合は，実行するジョブのスクリプトファイルで指定してください。

付録C　Oracleデータベースの移行

06-71以前のJP1/AJS2 - ManagerでスケジューラーデータベースにOracleを使用している場合，Oracleデータベースの内容を退避し，ISAMまたは組み込みDBに回復する必要があります。

データベースの変更方法については，マニュアル「JP1/Automatic Job Management System 2 設計・運用ガイド　15.14.2 スケジューラーデータベースで使用するDBMSを変更する」を参照してください。

付録D　HiRDBからのデータベースの移行

バージョン7以前のJP1/AJS2のスケジューラーデータベースにHiRDBを設定している場合，08-00を使用するためにはHiRDBから組み込みDBへ移行する必要があります。

データベースをHiRDBから組み込みDBへ移行するには，HiRDBデータベース移行ツールを使用します。

ここでは，HiRDBデータベース移行ツール，および移行手順について説明します。

＜この節の構成＞

付録D.1　HiRDBデータベース移行ツールの内容

付録D.2　HiRDBデータベース移行ツールを使用したHiRDBデータベースの移行手順

付録D.3　HiRDBから組み込みDBに移行する場合に注意すること

付録D.1　HiRDBデータベース移行ツールの内容

HiRDBデータベース移行ツールとして，ajshirdbportコマンドを提供しています。ajshirdbportコマンドの詳細を次に示します。

＜この項の構成＞

(1)　形式

(2)　機能

(3)　実行権限

(4)　格納先ディレクトリ

(5)　引数

(6)　注意事項

(7)　エラー発生時の対処

(8)　戻り値

(9)　出力例

(1)　形式

ajshirdbport
    [-mh 論理ホスト名]
    -F サービス名
    -p 組み込みDB通信ポート
    [-q]
    [-ru {l|m|s}]
    -id セットアップ識別子
    [-c]
    [-tp テーブル名プリフィックス]

形式1（組み込みDBへの標準的な移行）

ajshirdbport
    [-mh 論理ホスト名]
    -F サービス名
    -p 組み込みDB通信ポート
     [-ru {l|m|s}]
     -id セットアップ識別子

形式2（スケジューラーサービスのデータベースとして使用されている組み込みDBへの移行）

ajshirdbport
    [-mh 論理ホスト名]
    -F サービス名
    -p 組み込みDB通信ポート
    -q
    [-ru {l|m|s}]
    -id セットアップ識別子
    [-tp テーブル名プリフィックス]

形式3（組み込みDBへの移行が中断された場合）

ajshirdbport
    [-mh 論理ホスト名]
    -F サービス名
    -p 組み込みDB通信ポート
    -q
    [-ru {l|m|s}]
    -id セットアップ識別子
    [-tp テーブル名プリフィックス]
    -c

(2)　機能

JP1/AJS2スケジューラーサービスに設定されたデータベースをHiRDBから組み込みDBに移行します。

このコマンドは，HiRDBがスケジューラーサービスのデータベースとして設定されている状態で実行してください。

(3)　実行権限

Windowsの場合：Administrators権限

UNIXの場合：スーパーユーザー権限

(4)　格納先ディレクトリ

Windowsの場合

JP1/AJS2 - Managerインストール先フォルダ¥tools¥

UNIXの場合

/opt/jp1ajs2/tools/

(5)　引数

-mh 論理ホスト名

処理対象とするJP1論理ホスト名を指定します。指定できる文字数は，1～32（単位：バイト）です。

省略した場合，環境変数JP1_HOSTNAMEの設定があれば，環境変数の値を仮定します。環境変数JP1_HOSTNAMEの指定がない場合は，物理ホストを仮定します。

-F サービス名

処理対象とするスケジューラーサービスのサービス名を指定します。

HiRDBがセットアップされているスケジューラーサービス名を指定してください。

-p {組み込みDB通信ポート}

組み込みDBの接続ポートを10進数で指定します。

ajsembdbbuild -pオプションに指定したポート番号を指定してください。

構成定義のRDBPORTパラメーターに設定されます。

指定できる値の範囲については，「14.1.3 スケジューラーサービス環境設定パラメーターの定義内容」のRDBPORTパラメーターを参照してください。

-q

スキーマ作成をスキップする場合に指定します。

移行先の組み込みDBに，すでにスケジューラーサービスが設定されている場合に指定します。また，ajshirdbportコマンド実行時，スキーマ作成に成功してテーブル作成時にエラーが発生した場合などにも，このオプションを指定する必要があります。

移行先の組み込みDBにスケジューラーサービスを初めてセットアップする場合は，テーブル作成時にエラーとなるので，このオプションを指定しないでください。

-c

スキーマ作成が成功したあと，テーブル作成処理などでエラーが発生した際に再セットアップをする場合に指定します。

-tp テーブル名プリフィックス

JP1/AJS2スケジューラーデータベースのテーブル名プリフィックスを4バイト以内で指定します。

移行先の組み込みDBがほかのスケジューラーサービスのデータベースに設定されている場合，そのスケジューラーサービスのテーブル名プリフィックスと重複しないように値を設定してください。

-Fオプションで指定したスケジューラーサービスの構成定義TABLENAMEPREFIXパラメーターの値を仮定します。

このオプションを指定した場合，構成定義のTABLENAMEPREFIXパラメーターの設定が変更されます。

-ru {l|m|s}

空き領域の再利用機能を使用する場合に指定します。l，m，sと同時に指定した場合，再利用開始ポイントを指定することができます。

-ruを省略した場合は，-ru lが仮定されます。

-ruの後ろに空き領域の再利用機能の再利用開始ポイントを指定します。データ領域の使用率がここで指定したポイントに達した場合，空き領域の再利用機能が動作します。

l，m，sはそれぞれajsembdbbuildコマンドのデータベースモデル，大・中・小規模に対応しています。ajsembdbbuildコマンドで指定したデータベースモデルの規模と同じオプションを指定してください。

各テーブルに設定される，データベース領域に対する空き領域の再利用機能の再利用開始ポイントは，次のとおりです。

項番
テーブル名
各テーブルで設定される空き領域の再利用機能の
再利用開始ポイント

1
AJSUNIT
データベース領域AJS2DATA全体のセグメントの10%

2
AJSARROW

3
AJSBODY

4
AJSSCH

5
AJSCAL

6
AJSPERF

7
AJSENTRY

8
AJSGEN

9
AJSSTAT
データベース領域AJS2DATA全体のセグメントの20%

注

テーブル名は,テーブルプリフィックスを標準の"AJS"としている場合の名称です。

なお，ajsembdbbuildコマンドのデータベースモデル，大・中・小規模で作成される領域のセグメントの全体量は次の表のとおりです。

項番 | データベース領域 | 大規模 | 中規模 | 小規模
1 | AJS2DATA | 30,800 | 14,920 | 4,940

-id セットアップ識別子

組み込みDBを識別するセットアップ識別子を「_JAn」（nは0～9またはA～Z）の4文字で指定します。ajsembdbbuildコマンドの-idオプションで指定した値を指定してください。

(6)　注意事項

このコマンドを実行する前に，ajsembdbbuildコマンドを実行し，組み込みDBサーバの構築を行ってください。ajsembdbbuildコマンドが正常終了していない場合，データベースの移行が正しく行えません。

JP1/AJS2が提供しているHiRDB簡易セットアップスクリプトで環境を構築し，RDエリアの拡張を行っている場合は，ajsembdbbuildコマンドを実行して組み込みDBサーバを構築したあと，ajsembdbaddareaコマンドを実行して，領域を拡張してください。HiRDB簡易セットアップスクリプトを使用していない場合は，マニュアル「JP1/Automatic Job Management System 2 設計・運用ガイド　4.3 データベース領域を見積もる」を参照し，必要な容量を拡張してください。領域を拡張しない場合，ajshirdbportコマンド実行中に，組み込みDBの容量不足でエラーとなるおそれがあります。

このコマンドを実行する前に，JP1/AJS2 - Managerホストで論理ホストを含め，すべてのJP1/AJS2サービスおよびJP1/AJS2 Monitorサービスを停止してください。また，JP1/AJS2 Consoleを使用している場合は，JP1/AJS2 Console Agentサービスも停止してください。サービスを停止しないでこのコマンドを使用した場合でも，正常終了する場合があるので注意してください。

ajshirdbportコマンドは，スクリプトで実装されています。このため，オプションに不当に長い文字列や不正な文字列や値を指定すると，予期しないエラーが発生することがあります。オプション指定値は，DBMSおよびJP1/AJS2で規定されている範囲内の文字列または数値を指定してください。

スケジューラーデータベースのセットアップに必要のない構成定義の指定に誤りがある場合でも，KAVS1003-Eメッセージが出力されます。このメッセージが複数回出力されても，このコマンドが正常終了した場合にはセットアップ処理は完了していますので，再セットアップの必要はありません。コマンド終了後，KAVS1003-Eメッセージに従い構成定義の誤りを訂正してください。

UNIXで文字コードを変更して環境を構築するときは，環境変数LANGを正しく設定してください。

ajshirdbportコマンドを実行し，組み込みDBサーバへのアクセスでエラーが発生した場合，組み込みDB接続時のエラー情報が，ajshirdbportコマンドを実行したときの作業ディレクトリにトレースファイル（pderr1.trcおよびpderr2.trc）として作成されます。コマンドの再実行によって，正常終了した場合は，これらのファイルを削除してください。

(7)　エラー発生時の対処

コマンド実行時にエラーが発生する場合があります。エラーが発生した場合は次の表に従って問題に対処し，再実行してください。

メッセージID
原因
対処方法

DBTYPE
ERROR
移行元スケジューラーサービスのデータベース種別がHiRDBではありません。
移行元のデータベース種別を確認してください。
このコマンドはHiRDBからの移行を行う場合だけ使用できます。

KAVS0101-E
指定したオプションに引数が指定されていません。
オプションに値を指定して，コマンドを再実行してください。

KAVS0178-E
テーブルが作成済みです。
-tpオプションに指定している値が，すでに存在するスケジューラーサービスのテーブルプリフィックスの値と重複していないか確認してください。テーブルの作成中，または容量不足などで処理が中断され，再実行したときにこのメッセージが出力された場合は，-qオプションと-cオプションを同時に指定して再実行してください。

KAVS0190-E
ホストには指定されたスケジューラーサービスが定義されていません。
-Fオプションに，すでに存在しているスケジューラーサービス名を指定してください。

KAVS0985-E
データベースに接続できません。
次の問題が考えられます。

HiRDBまたは組み込みDBサーバが起動していない。

-pオプションで指定したポート番号が組み込みDBのポート番号と一致していない。

これらの問題を解決してから再実行してください。

KAVS0936-E
スキーマはすでに定義されています。
スキーマが作成済みの場合は，-qオプションを指定して再実行してください。

KAVS0996-E
指定されたオプションおよび値が不正です。
オプションおよびオプションに指定する値を修正してください。

KAVS1003-E
構成定義に誤った指定があります。
オプションで指定した値を正しい値に修正して，再実行してください。

KFPA11723-E
組み込みDBまたはHiRDBが停止しています。
組み込みDBまたはHiRDBを起動してください。

KFPA11204-E
表がありません。
-tpオプションの値を見直して，正しいテーブルプリフィックスを指定してください。また，HiRDBがスケジューラーサービスのデータベースとして接続できる状態であるか確認してください。

KFPA11563-E
KFPA11732-E
組み込みDBまたはHiRDBにほかのユーザーがアクセスしているため，排他待ちタイムアウトになりました。
組み込みDBへのアクセスをすべて停止してから再実行してください。

The embedded DB work directory associated with the setup identifier specified by the -id option is invalid.
-idオプションに指定したセットアップ識別子に関連づけられている組み込みDB運用ディレクトリが不正です。
構成定義に設定されている組み込みDB運用ディレクトリに正しい値を指定し，再実行してください。登録済みのセットアップ識別子および組み込みDB運用ディレクトリは，ajsembdbidlistコマンドで確認できます。ajsembdbidlistコマンドの詳細は，「20. セットアップ時に使用するコマンド　ajsembdbidlist」を参照してください。

The setup identifier specified with the -id option is not registered.
-idオプションで指定したセットアップ識別子は，登録されていません。
登録済みのセットアップ識別子を指定し，再実行してください。なお，登録済みのセットアップ識別子および組み込みDB運用ディレクトリは，ajsembdbidlistコマンドで確認できます。ajsembdbidlistコマンドの詳細は，「20. セットアップ時に使用するコマンド　ajsembdbidlist」を参照してください。

Failed to register the configuration definition.
構成定義の登録に失敗しました。
-qオプションと-cオプションを同時に指定して再実行してください。

なお，KAVSで始まるメッセージの詳細については，マニュアル「JP1/Automatic Job Management System 2 メッセージ　2.3 KAVSで始まるメッセージ（スケジューラーに関するメッセージ）」を参照してください。

(8)　戻り値

0 | 正常終了。
0以外 | 異常終了。

(9)　出力例

スケジューラーサービスAJSROOT2をセットアップ識別子_JA2（ポート番号22201）の組み込みDBに対して実行した場合

C:¥Program Files¥HITACHI¥JP1AJS2¥tools>ajshirdbport -F AJSROOT2 -p 22201 -id _JA2
[1/12]CREATE SCHEMA OK
[2/12]CREATE TABLES OK
[3/12]SHIFT TABLE UNIT
EXPORT OK
IMPORT OK
[4/12]SHIFT TABLE ARROW
EXPORT OK
IMPORT OK
[5/12]SHIFT TABLE BODY
EXPORT OK
IMPORT OK
[6/12]SHIFT TABLE SCH
EXPORT OK
IMPORT OK
[7/12]SHIFT TABLE CAL
EXPORT OK
IMPORT OK
[8/12]SHIFT TABLE STAT
EXPORT OK
IMPORT OK
[9/12]SHIFT TABLE ENTRY
EXPORT OK
IMPORT OK
[10/12]SHIFT TABLE GEN
EXPORT OK
IMPORT OK
[11/12]SHIFT TABLE PERF
EXPORT OK
IMPORT OK
[12/12]SHIFT CONFIGURATION OK
C:¥Program Files¥HITACHI¥JP1AJS2¥tools>

スケジューラーサービスAJSROOT2をすでにスケジューラーサービスのデータベースとして使用されているセットアップ識別子_JA3（ポート番号22202）の組み込みDBに対してテーブルプリフィックス「AJS2」を指定して実行した場合

C:¥Program Files¥HITACHI¥JP1AJS2¥tools>ajshirdbport -F AJSROOT2 -p 22202 -id _JA3 -tp AJS2 -q
[1/12]CREATE SCHEMA SKIP
[2/12]CREATE TABLES OK
[3/12]SHIFT TABLE UNIT
EXPORT OK
IMPORT OK
[4/12]SHIFT TABLE ARROW
EXPORT OK
IMPORT OK
[5/12]SHIFT TABLE BODY
EXPORT OK
IMPORT OK
[6/12]SHIFT TABLE SCH
EXPORT OK
IMPORT OK
[7/12]SHIFT TABLE CAL
EXPORT OK
IMPORT OK
[8/12]SHIFT TABLE STAT
EXPORT OK
IMPORT OK
[9/12]SHIFT TABLE ENTRY
EXPORT OK
IMPORT OK
[10/12]SHIFT TABLE GEN
EXPORT OK
IMPORT OK
[11/12]SHIFT TABLE PERF
EXPORT OK
IMPORT OK
[12/12]SHIFT CONFIGURATION OK

すでにスケジューラーサービスのデータベースとして使用されている組み込みDBに対して実行した場合（エラーケース）

C:¥Program Files¥HITACHI¥JP1AJS2¥tools>ajshirdbport -F AJSROOT2 -p 22201 -id _JA2
KAVS0936-E スキーマはすでに定義されています

付録D.2　HiRDBデータベース移行ツールを使用したHiRDBデータベースの移行手順

JP1/AJS2データベースで組み込みDBを使用できるようにするための移行手順を次に示します。

なお，移行元のHiRDBで，スケジューラーサービスが運用できることを確認してください。また，HiRDBのサービスは，停止しないでください。

JP1/AJS2 - Managerをバージョンアップする。
JP1/AJS2 - Managerのバージョンアップについては，「2.2 JP1/AJS2シリーズプログラムのインストール」（Windowsの場合），または「12.2 JP1/AJS2シリーズプログラムのインストール」（UNIXの場合）を参照してください。

組み込みDBをインストールする。
組み込みDBのインストールについては，「2.3 組み込みDBのインストール」（Windowsの場合），または「12.3 組み込みDBのインストール」（UNIXの場合）を参照してください。

JP1/AJS2 - Managerホストで，論理ホストを含め，すべてのJP1/AJS2サービス，JP1/AJS2 Monitorサービスが停止していることを確認し，起動している場合はサービスを停止する。
また，JP1/AJS2 Consoleを使用している場合は，JP1/AJS2 Console Agentサービスが停止していることを確認し，起動している場合はサービスを停止します。

組み込みDBサーバを構築するために，組み込みDBセットアップコマンド（ajsembdbbuildコマンド）を実行する。
組み込みDBセットアップコマンドについては，「20. セットアップ時に使用するコマンド　ajsembdbbuild」を参照してください。
JP1/AJS2が提供しているHiRDB簡易セットアップスクリプトで環境を構築し，RDエリアの拡張を行っている場合は，ajsembdbbuildコマンドを実行して組み込みDBサーバを構築したあと，ajsembdbaddareaコマンドを実行して，領域を拡張してください。HiRDB簡易セットアップスクリプトを使用していない場合は，マニュアル「JP1/Automatic Job Management System 2 設計・運用ガイド　4.3 データベース領域を見積もる」を参照し，必要な容量を拡張してください。領域を拡張しない場合，ajshirdbportコマンド実行中に，組み込みDBの容量不足でエラーとなるおそれがあります。

HiRDBデータベース移行ツール（ajshirdbportコマンド）を実行する。
データベース移行ツールで指定するオプションとHiRDBで指定している設定との対応は次のとおりです。

-p 組み込みDB通信ポート

HiRDBのシステム共通定義（pdsys）のパラメーター「pd_name_port」，環境変数PDPORT，JP1/AJS2の構成定義RDBPORTパラメーターに設定されている値に相当します。

-tp テーブル名プリフィックス

JP1/AJS2の構成定義TABLENAMEPREFIXに設定されている値に相当します。

その他のHiRDBの設定，JP1/AJS2の構成定義については，「付録D.3(2) HiRDBから組み込みDBに移行した場合に変更される設定」を参照してください。

これでHiRDBから組み込みDBへの移行は終了です。

必要に応じて，HiRDBに設定したJP1/AJS2のテーブル，インデクス，およびRDエリアなどを削除してください。

JP1/AJS2で作成するテーブル名およびインデクス名は次のとおりです。

表D-1　JP1/AJS2で作成するテーブル名称

項番 | テーブルプリフィックス | テーブル固定名称 | テーブルポストフィックス
1 | TABLENAMEPREFIXの値 | UNIT | TABLENAMEPOSTFIXの値
2 | ARROW
3 | BODY
4 | SCH
5 | CAL
6 | STAT
7 | ENTRY
8 | GEN
9 | PERF

表D-2　JP1/AJS2で作成するインデクス名称

項番 | テーブルプリフィックス | インデクス固定名称 | テーブルポストフィックス
1 | TABLENAMEPREFIXの値 | UNITINDEX1 | TABLENAMEPOSTFIXの値
2 | UNITINDEX2
3 | ARROWINDEX1
4 | BODYINDEX1
5 | SCHINDEX1
6 | CALINDEX1
7 | STATINDEX1
8 | ENTRYINDEX1
9 | GENINDEX1
10 | PERFINDEX1
11 | PERFINDEX2

テーブルおよびインデクスの命名規則は，次のとおりです。

テーブル名

TABLENAMEPREFIXの値＋テーブル固定名称＋TABLENAMEPOSTFIXの値

インデクス名

TABLENAMEPREFIXの値＋インデクス固定名称＋TABLENAMEPOSTFIXの値

テーブル，インデクスの削除については，HiRDBのマニュアルを参照してください。

HiRDBセットアップツールでRDエリアを作成した場合，次の名称のRDエリアが作成されます。

AJS2DATA

AJS2INDX

RDエリアの削除については，HiRDBのマニュアルを参照してください。

スケジューラーサービスのデータベースに指定していたHiRDBが不要である場合は，HiRDBのアンインストールを行ってください。また，HiRDB/Run Timeが不要である場合は，HiRDB/Run Timeのアンインストールを行ってください。

HiRDBおよびHiRDB/Run Timeのアンインストール方法については，HiRDBのマニュアルを参照してください。

付録D.3　HiRDBから組み込みDBに移行する場合に注意すること

＜この項の構成＞

(1)　HiRDBから組み込みDBに移行する場合に注意すること

(2)　HiRDBから組み込みDBに移行した場合に変更される設定

(1)　HiRDBから組み込みDBに移行する場合に注意すること

JP1/AJS2が提供しているHiRDB簡易セットアップスクリプトで環境を構築し，RDエリアの拡張を行っている場合は，ajsembdbbuildコマンドを実行して組み込みDBサーバを構築したあと，ajsembdbaddareaコマンドを実行して，領域を拡張してください。HiRDB簡易セットアップスクリプトを使用していない場合は，マニュアル「JP1/Automatic Job Management System 2 設計・運用ガイド　4.3 データベース領域を見積もる」を参照し，必要な容量を拡張してください。領域を拡張しない場合，ajshirdbportコマンドの実行中に，組み込みDBの容量不足でエラーとなるおそれがあります。

組み込みDBは，JP1/AJS2 - Managerと同一ホストに環境を構築する必要があるため，リモート接続を行うことはできません。HiRDB/Run Timeを使用して，リモート接続で運用を行っている場合，次の図のように，JP1/AJS2 - Managerと同一ホストにスケジューラーデータベースである組み込みDBが格納されることになります。

図D-1　リモート環境の移行

HiRDBから組み込みDBに移行を行う場合，次の図のように，移行先となる組み込みDBの構築に必要な容量，およびデータの移行時にHiRDBで使用していたデータ容量と同等の空き領域が必要となります。

図D-2　データベースの移行に必要な容量

移行する場合，十分な空き容量を用意してから実施してください。組み込みDBの構築に必要な容量は，マニュアル「JP1/Automatic Job Management System 2 設計・運用ガイド　4.3.2 組み込みDBのデータベース領域を見積もる」を参照してください。

HiRDBの環境が構築されている環境に，組み込みDBの環境を構築する場合，リソース不足となる場合があります。組み込みDBで必要なシステムリソースにHiRDBの環境構築時に追加したリソースを加算した値を設定してください。組み込みDBで必要なシステムリソースについては，製品添付のドキュメント（リリースノート，Readme.txt，またはソフトウェア添付資料）を参照してください。

(2)　HiRDBから組み込みDBに移行した場合に変更される設定

HiRDBから組み込みDBへデータベースを変更した場合の，スケジューラーデータベースのアクセスに関する構成定義の変更についての有無を次の表に示します。

表D-3　移行前，移行後の構成定義の内容

項番
構成定義
バージョン7（HiRDB）
バージョン8（組み込みDB）

1

AJSDBTYPE

HiRDB
EmbedDB

2

TABLENAMEPREFIX

AJS（任意）
変更なし

3

TABLENAMEPOSTFIX

（任意）
変更なし

4

RDBAUTHID

（任意）
root

5

RDBUSER

（任意）
ajs2

6

RDBPASSWORD

（任意）
指定なし

7

RDBCHECKINTERVAL※1

（任意）
変更なし

8

RDBHOST

HiRDBホスト名
組み込みDBホスト名

9

RDBPORT

HiRDBポート番号
組み込みDBポート番号

10

RDBIPC※2

（任意）
変更なし

11

RDBSENDMEMSIZE※3

（任意）
変更なし

12

RDBRECVMEMSIZE※3

（任意）
変更なし

13

RDBCONNECTWAITTIME※4

（任意）
変更なし

注※1

JP1/AJS2の最適値として，新規のインストール時および新規のセットアップ時に「300」が設定されます。特に問題がなければ，この値に変更することをお勧めします。

注※2

JP1/AJS2の最適値として，新規のセットアップ時に「MEMORY」が設定されます。特に問題がなければ，この値に変更することをお勧めします。

注※3

JP1/AJS2の最適値として，新規のセットアップ時に「100」が設定されます。特に問題がなければ，この値に変更することをお勧めします。

注※4

JP1/AJS2の最適値として，新規のセットアップ時に「1」が設定されます。特に問題がなければ，この値に変更することをお勧めします。

組み込みDBに移行した場合は，空き領域の再利用機能を使用します。

付録E　誤った環境設定パラメーターを設定したときの回復方法

環境設定パラメーターを誤って定義した場合の回復手順について説明します。

＜この節の構成＞

付録E.1　Windowsの場合

付録E.2　UNIXの場合

付録E.1　Windowsの場合

環境設定パラメーターを誤って設定した場合は，次の手順に従って回復してください。

誤って定義した環境設定パラメーターと正しい環境設定パラメーターの例を次に示します。

誤って定義した環境設定パラメーター

[JP1_DEFAULT¥JP1NBQAGENT¥Variable]
"USSER-ENVIRONMENT1"="ENVIRONMENT-VALUE1"

正しい環境設定パラメーター

[JP1_DEFAULT¥JP1NBQAGENT¥Variable]
"USER-ENVIRONMENT1"="ENVIRONMENT-VALUE1"

上記の誤って定義した環境設定パラメーターの削除手順と，正しい環境設定パラメーターの設定手順を次に示します。

次のコマンドを実行して定義情報を退避する。

物理ホストの場合

 jbsgetcnf > 定義情報ファイル名

論理ホストの場合

 jbsgetcnf -h 論理ホスト名 > 定義情報ファイル名

jbsgetcnfコマンドのパスは，「JP1/Baseのインストール先フォルダ¥bin¥jbsgetcnf」です。
jbsgetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

次のコマンドを実行してVariableサブキーを削除する。

物理ホストの場合

 jbsunsetcnf -h JP1_DEFAULT -c JP1NBQAGENT -n Variable

論理ホストの場合

 jbsunsetcnf -h 論理ホスト名 -c JP1NBQAGENT -n Variable

jbsunsetcnfコマンドのパスは，「JP1/Baseのインストール先フォルダ¥bin¥jbsunsetcnf」です。
jbsunsetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

1で退避した定義情報を編集する。
変更前

[JP1_DEFAULT¥JP1NBQAGENT¥Variable]
"JP1AJS2_JPOEXEPATH"="C:¥Program Files¥HITACHI¥JP1AJS2¥bin"
"JP1AJS2_JPQNOP"="C:¥Program Files¥HITACHI¥JP1AJS2¥bin¥jpqnop.exe"
"JP1AJS2_JPWDEXEPATH"="C:¥Program Files¥Hitachi¥JP1PowerMonitor¥bin"
"USSER-ENVIRONMENT1"="ENVIRONMENT-VALUE1"

変更後

[JP1_DEFAULT¥JP1NBQAGENT¥Variable]
"JP1AJS2_JPOEXEPATH"="C:¥Program Files¥HITACHI¥JP1AJS2¥bin"
"JP1AJS2_JPQNOP"="C:¥Program Files¥HITACHI¥JP1AJS2¥bin¥jpqnop.exe"
"JP1AJS2_JPWDEXEPATH"="C:¥Program Files¥Hitachi¥JP1PowerMonitor¥bin"

注

既存の定義パラメーターは削除しないで，誤って追加した個所を削除してください。

論理ホスト環境を変更する場合には，「JP1_DEFAULT」を論理ホスト名で指定します。

ファイルを保存し，次のコマンドを実行して定義を回復する。

jbssetcnf 定義情報ファイル名

jbssetcnfコマンドのパスは，「JP1/Baseのインストール先フォルダ¥bin¥jbssetcnf」です。
jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。
環境設定パラメーターの追加前の状態に戻ります。

メモ帳などのテキストエディターで，次の内容を定義した定義情報ファイルを作成する。

[JP1_DEFAULT¥JP1NBQAGENT¥Variable]
"USER-ENVIRONMENT1"="ENVIRONMENT-VALUE1"

ファイルを保存し，次のコマンドを実行する。

jbssetcnf 定義情報ファイル名

JP1/AJS2を再起動する。
定義情報ファイルに記述した内容が反映されます。

付録E.2　UNIXの場合

環境設定パラメーターを誤って設定した場合は，次の手順に従って回復してください。

誤って定義した環境設定パラメーターと正しい環境設定パラメーターの例を次に示します。

誤って定義した環境設定パラメーター

[JP1_DEFAULT¥JP1NBQAGENT¥Variable]
"USSER-ENVIRONMENT1"="ENVIRONMENT-VALUE1"

正しい環境設定パラメーター

[JP1_DEFAULT¥JP1NBQAGENT¥Variable]
"USER-ENVIRONMENT1"="ENVIRONMENT-VALUE1"

上記の誤って定義した環境設定パラメーターの削除手順と，正しい環境設定パラメーターの設定手順を次に示します。

次のコマンドを実行して定義情報を退避する。

物理ホストの場合

 jbsgetcnf > 定義情報ファイル名

論理ホストの場合

 jbsgetcnf -h 論理ホスト名 > 定義情報ファイル名

jbsgetcnfコマンドのパスは，「/opt/jp1base/bin/jbsgetcnf」です。
jbsgetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

次のコマンドを実行してVariableサブキーを削除する。

物理ホストの場合

 jbsunsetcnf -h JP1_DEFAULT -c JP1NBQAGENT -n Variable

論理ホストの場合

 jbsunsetcnf -h 論理ホスト名 -c JP1NBQAGENT -n Variable

jbsunsetcnfコマンドのパスは，「/opt/jp1base/bin/jbsunsetcnf」です。
jbsunsetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

1で退避した定義情報を編集する。
変更前

[JP1_DEFAULT¥JP1NBQAGENT¥Variable]
"JP1AJS2_JPOEXEPATH"="C:¥Program Files¥HITACHI¥JP1AJS2¥bin"
"JP1AJS2_JPQNOP"="C:¥Program Files¥HITACHI¥JP1AJS2¥bin¥jpqnop.exe"
"JP1AJS2_JPWDEXEPATH"="C:¥Program Files¥Hitachi¥JP1PowerMonitor¥bin"
"USSER-ENVIRONMENT1"="ENVIRONMENT-VALUE1"

変更後

[JP1_DEFAULT¥JP1NBQAGENT¥Variable]
"JP1AJS2_JPOEXEPATH"="C:¥Program Files¥HITACHI¥JP1AJS2¥bin"
"JP1AJS2_JPQNOP"="C:¥Program Files¥HITACHI¥JP1AJS2¥bin¥jpqnop.exe"
"JP1AJS2_JPWDEXEPATH"="C:¥Program Files¥Hitachi¥JP1PowerMonitor¥bin"

注

既存の定義パラメーターは削除しないで，誤って追加した個所を削除してください。

論理ホスト環境を変更する場合には，「JP1_DEFAULT」を論理ホスト名で指定します。

ファイルを保存し，次のコマンドを実行して定義を回復する。

jbssetcnf 定義情報ファイル名

jbssetcnfコマンドのパスは，「/opt/jp1base/bin/jbssetcnf」です。
jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。
環境設定パラメーターの追加前の状態に戻ります。

viなどのテキストエディターで，次の内容を定義した定義情報ファイルを作成する。

[JP1_DEFAULT¥JP1NBQAGENT¥Variable]
"USER-ENVIRONMENT1"="ENVIRONMENT-VALUE1"

ファイルを保存し，次のコマンドを実行する。

jbssetcnf 定義情報ファイル名

JP1/AJS2を再起動する。
定義情報ファイルに記述した内容が反映されます。

付録F　08-00以降で設定する環境設定項目の推奨値

08-00以降では，新規のインストール・セットアップ時に，環境設定項目の推奨値が自動的に設定されます。バージョンアップの場合には，以前の設定が引き継がれるため，推奨値で運用する場合には個別に設定してください。

設定方法の詳細については，「3. セットアップ」（Windowsの場合），または「13. セットアップ」（UNIXの場合）を参照してください。

＜この節の構成＞

(1)　スケジューラーサービスに関する環境設定

(2)　ジョブ実行環境に関する環境設定

(3)　イベントジョブ起動に関する環境設定

(4)　キューレスジョブ実行環境に関する環境設定

(1)　スケジューラーサービスに関する環境設定

スケジューラーサービスに関する環境設定のパラメーター，デフォルト値，および推奨値を次の表に示します。

表F-1　スケジューラーサービスに関する環境設定

設定内容とパラメーター
（表示項目）
デフォルト値
08-00以降で設定する
推奨値

"VRSHIFT_INTRERUN"
V6
V5

"MONSYSLOG"
[JP1/AJS2 - Monitorサービスログのイベントログの出力]
none
all

"LOGSIZE"
[スケジューラーログファイルのサイズ]
dword:00001400
dword:00002800

"RDBCHECKINTERVAL"
[切断検知する間隔]
dword:00000000
dword:0000012C

"LOGINFOALL"
[スケジューラーログとイベントログの出力情報]
no
yes

"LOGHEADER"
[スケジューラーサービスログのプロセスID出力]
none
PID

"INFOLOG"
[スケジューラーサービスログの情報用ログ出力]
none
all

"UNITDEFINERELOAD"
[ユニット定義変更の即時適用]
no
yes

"INHERITCONDHOLD"
[起動条件付きジョブネットの保留属性を引き継がない]
V6
no

"AJSPRINTNETSCHPRF"
yes
no

"CONDEXECDEFER"
yes
no

"BACKGROUNDLEAVE"
no
yes

"NONRELOADHOLDING"
no
yes

(2)　ジョブ実行環境に関する環境設定

ジョブ実行環境に関する環境設定のパラメーター，デフォルト値，および推奨値を次の表に示します。

表F-2　ジョブ実行環境に関する環境設定

設定内容とパラメーター
（表示項目）
デフォルト値
08-00以降で設定する
推奨値

"PreserveTerm"
[ジョブ情報保存日数]
dword:00000007
dword:00000001

"DeleteFlashOption"
1
0

"StartUpDelete"
1
0

"IsSigchldDefault"
dword:00000000
dword:00000001

(3)　イベントジョブ起動に関する環境設定

イベントジョブ起動に関する環境設定のパラメーター，デフォルト値，および推奨値を次の表に示します。

表F-3　イベントジョブ起動に関する環境設定

設定内容とパラメーター
（表示項目）
デフォルト値
08-00以降で設定する
推奨値

"MacVarDQuotation"
N
Y

"LogSize_jpomanager"
dword:000A0000
dword:00200000

"LogSize_jpomgrsub"
dword:000A0000
dword:00100000

"LogNumFiles_jpomanager"
dword:00000008
dword:00000006

"LogNumFiles_jpomgrsub"
dword:00000006
dword:00000008

"FilewatchinfContinue"
[ファイル監視ジョブの情報の引き継ぎ]
N
Y

"EVProcessHA"=
[詳細プロセス終了時の処理]
N
Y

"LogSize_jpoagent"
dword:00060000
dword:00100000

"LogSize_jpoagtsub"
dword:00060000
dword:00100000

"LogSize_jpocwtflMain"
dword:00140000
dword:00200000

"LogSize_jpoeventwatch"
dword:000A0000
dword:00100000

"LogSize_jpocwttmMain"
dword:00020000
dword:00040000

"LogNumFiles_jpoeventwatch"
dword:00000004
dword:00000008

"LogNumFiles_jpocwttmMain"
dword:00000002
dword:00000006

(4)　キューレスジョブ実行環境に関する環境設定

推奨値が設定されるキューレスジョブ実行環境に関する環境設定パラメーター，および該当するパラメーターの08-00より前のデフォルト値と08-00以降で設定する推奨値を次の表に示します。

なお，08-00以降のデフォルト値は，推奨値と同じ値になります。

表F-4　キューレスジョブ実行環境に関する環境設定

設定内容とパラメーター
（表示項目）
08-00より前の
デフォルト値
08-00以降で設定する推奨値
（08-00以降のデフォルト値）

"AJSQL_JOBMAX"
[キューレスエージェントサービス内での最大同時ジョブ実行数]
dword:00000400
Windowsの場合：dword:00000005
UNIXの場合：dword:00000400

"AJSQL_JOBWAITMAX"
[キューレスエージェントサービス内での最大待ちジョブ数]
dword:00000000
Windowsの場合：dword:00000800
UNIXの場合：dword:00000000

"AJSQL_LOGSIZE"
[キューレスログファイルサイズ]
dword:00001000
dword:00002000

"AJSQL_STATSIZE"
[ステータスファイルサイズ]
dword:00000000
dword:00000800

"AJSQL_CJOBMAX"
[クラス内での最大同時ジョブ実行数]
dword:00000400
Windowsの場合：dword:00000005
UNIXの場合：dword:00000400

"AJSQL_CJOBWAITMAX"
[クラス内での最大待ちジョブ数]
dword:00000000
Windowsの場合：dword:00000800
UNIXの場合：dword:00000000

付録G　各バージョンの変更内容

各バージョン（07-00以降）での変更点を次に示します。

＜この節の構成＞

付録G.1　08-50の変更内容

付録G.2　08-10の変更内容

付録G.3　08-00の変更内容

付録G.4　07-50の変更内容

付録G.5　07-11の変更内容

付録G.6　07-10の変更内容

付録G.7　07-00の変更内容

付録G.1　08-50の変更内容

08-50での変更点をプログラムごとに示します。

＜この項の構成＞

(1)　JP1/AJS2 - Managerの変更内容

(2)　JP1/AJS2 - Agentの変更内容

(3)　JP1/AJS2 - Viewの変更内容

(1)　JP1/AJS2 - Managerの変更内容

ジョブを実行所要時間によって終了遅延監視する機能を追加した。

ジョブネットコネクタで異なるスケジューラーサービス間のルートジョブネットの実行順序を制御できるようにした。

定義内容の事前チェックで，チェック対象のジョブネット配下にユニット間の実行順序不正があった場合，該当するユニット名をチェック結果格納ファイルに出力するようにした。

UNIXジョブ実行時のファイル権限チェックで，ファイルパーミッションのほか，アクセス制御リストやセカンダリーグループの設定を有効にする機能を追加した。

実行ホストのJP1/AJS2サービスが停止してもイベントジョブの実行を継続させる機能を追加した。

ジョブネットの実行登録状態を登録予定情報としてエクスポート／インポートする機能を追加した。

UNIXホストのメッセージキュー（TP1/LiNK，TP1/Message Queue，MQSeries）連携をサポート対象外とした。

Windows Server 2008，Windows Server 2008（IPF）をサポート対象OSとした。

(2)　JP1/AJS2 - Agentの変更内容

UNIXジョブ実行時のファイル権限チェックで，ファイルパーミッションのほか，アクセス制御リストやセカンダリーグループの設定を有効にする機能を追加した。

UNIXホストのメッセージキュー（TP1/LiNK，TP1/Message Queue，MQSeries）連携をサポート対象外とした。

Windows Server 2008，Windows Server 2008（IPF）をサポート対象OSとした。

(3)　JP1/AJS2 - Viewの変更内容

ジョブを実行所要時間によって終了遅延監視する機能を追加した。

ジョブネットコネクタで異なるスケジューラーサービス間のルートジョブネットの実行順序を制御できるようにした。

［フィルタの設定］ダイアログボックスに，［デイリースケジュール］ウィンドウおよび［マンスリースケジュール］ウィンドウで，保留予定ユニットを「保留中」のユニットとしてフィルター表示させるオプションを追加した。

Windows Server 2008をサポート対象OSとした。

付録G.2　08-10の変更内容

08-10での変更点をプログラムごとに示します。

＜この項の構成＞

(1)　JP1/AJS2 - Managerの変更内容

(2)　JP1/AJS2 - Viewの変更内容

(1)　JP1/AJS2 - Managerの変更内容

ルートジョブネットの実行順序を制御するジョブネットコネクタを追加した。

ジョブネット定義変更など，操作履歴の詳細をスケジューラーログに出力するオプションを追加した。

スケジューラーログからログを抽出するajslogprintコマンドを追加した。

(2)　JP1/AJS2 - Viewの変更内容

ルートジョブネットの実行順序を制御するジョブネットコネクタを定義，操作，監視できるようにした。

任意のジョブまたはジョブネットの先行・後続ユニットを強調表示する機能を追加した。

Windows Vistaをサポート対象OSとした。

付録G.3　08-00の変更内容

08-00での変更点をプログラムごとに示します。

＜この項の構成＞

(1)　JP1/AJS2 - Managerの変更内容

(2)　JP1/AJS2 - Agentの変更内容

(3)　JP1/AJS2 - Viewの変更内容

(1)　JP1/AJS2 - Managerの変更内容

インストール・セットアップ時に，環境設定項目の推奨値を設定するようにした。

ファイル監視ジョブで2ギガバイトを超えるファイル（ラージファイル）を監視できるようにした。

JP1/AJS2 - Viewの接続状況をajsstatusコマンドで出力できるようにした。

組み込みDBを制御する次のコマンドを追加した。

ajsembdbaddareaコマンド（組み込みDBのデータベース領域の拡張）

ajsembdbaddlogコマンド（組み込みDBのログ領域の拡張）

ajsembdbcancelコマンド（組み込みDBの操作コマンドの実行中断）

ajsembdboplogコマンド（組み込みDBのログ操作）

ajsembdbreclaimコマンド（組み込みDBのメンテナンス）

ajsembdbrorgコマンド（組み込みDBのデータのアンロード・リロード）

ajsembdbrstrコマンド（組み込みDBのバックアップ・リストア）

ajsembdbstartコマンド（組み込みDBの開始）

ajsembdbstatusコマンド（組み込みDBの監視）

ajsembdbstopコマンド（組み込みDBの停止）

ajsembdbunsetコマンド（組み込みDBのアンセットアップ）

なお，ajsembdbreclaimコマンドのサポートに合わせて，空きページ回収に掛かる実行時間を改善した。

JP1/AJS2 - Datareplicatorと連携して別ホストへのDBレプリケーションをできるようにした。

JP1/AJS2 - Configurationと連携して構成情報を管理できるようにした。

JP1/IM - Planning Operationと連携してオペレーションジョブを実行できるようにした。

JP1/Performance Management - Agent Option for JP1/AJS2と連携して稼働状況を分析できるようにした。

jajs_startコマンド，およびjajs_start.clusterコマンドでJP1/AJS2起動時にプロセスの起動状態を確認できるようにした（UNIX限定）。

使用できる言語にUnicode（UTF-8）を追加した（Linux限定）。

Windows 2000，Windows XP Professional，およびWindows Server 2003で提供していた関数を廃止した。

Windows 2000，Windows XP Professional，Windows Server 2003，およびWindows Server 2003（IPF）で提供していた次のコマンドを廃止した。

jsubcmdコマンド

jsubwinコマンド

(2)　JP1/AJS2 - Agentの変更内容

インストール・セットアップ時に，環境設定項目の推奨値を設定するようにした。

ファイル監視ジョブで2ギガバイトを超えるファイル（ラージファイル）を監視できるようにした。

使用できる言語にUnicode（UTF-8）を追加した（Linux限定）。

(3)　JP1/AJS2 - Viewの変更内容

JP1/AJS2 - Configuration Managerと連携できるようにした。

JP1/IM - Planning Operation用のオペレーションジョブを操作できるようにした。

アイコンを変更した。

付録G.4　07-50の変更内容

07-50での変更点をプログラムごとに示します。

＜この項の構成＞

(1)　JP1/AJS2 - Managerの変更内容

(2)　JP1/AJS2 - Agentの変更内容

(3)　JP1/AJS2 - Light Editionの変更内容

(4)　JP1/AJS2 - Viewの変更内容

(1)　JP1/AJS2 - Managerの変更内容

JP1/AJS2 - Scenario Operation Managerとの連携機能をサポートした。

実行登録時にマクロ変数の引き継ぎ情報を指定できる機能を追加した。

判定ジョブで変数の判定をできるようにした。

起動条件付きジョブネットが異常終了したときの実行抑止機能を追加した。

ユニット定義を開発環境から本番環境に移行したとき，本番環境上で最終チェックとして使用できる定義内容の事前チェック機能を追加した。

イベント・アクション制御マネージャーに未処理のデータが大量に蓄積して遅延が発生した場合に，イベント・アクション制御マネージャーが保持している情報を削除できるjpomanevresetコマンドを追加した。また，問題の発生している起動条件とエージェントを特定する方法として，送信頻度の高いエージェントと起動条件の情報を表示するjpomanevshowコマンド追加した。

(2)　JP1/AJS2 - Agentの変更内容

ユニット定義を開発環境から本番環境に移行したとき，本番環境上で最終チェックとして使用できる定義内容の事前チェック機能を追加した。

(3)　JP1/AJS2 - Light Editionの変更内容

実行登録時にマクロ変数の引き継ぎ情報を指定できる機能を追加した。

判定ジョブで変数の判定をできるようにした。

起動条件付きジョブネットが異常終了したときの実行抑止機能を追加した。

ユニット定義を開発環境から本番環境に移行したとき，本番環境上で最終チェックとして使用できる定義内容の事前チェック機能を追加した。

イベント・アクション制御マネージャーに未処理のデータが大量に蓄積して遅延が発生した場合に，イベント・アクション制御マネージャーが保持している情報を削除できるjpomanevresetコマンドを追加した。また，問題の発生している起動条件とエージェントを特定する方法として，送信頻度の高いエージェントと起動条件の情報を表示するjpomanevshowコマンド追加した。

(4)　JP1/AJS2 - Viewの変更内容

JP1/AJS2 - Scenario Operation Managerとの連携機能をサポートした。

実行登録時にマクロ変数の引き継ぎ情報を指定できる機能を追加した。

判定ジョブで変数の判定をできるようにした。

起動条件付きジョブネットが異常終了したときの実行抑止機能を追加した。

［JP1/AJS2 - View］ウィンドウに，［追加］，［日時変更］，［即時実行］，［変更解除］の操作を実行できるオプションを追加した。

付録G.5　07-11の変更内容

07-11での変更点をプログラムごとに示します。

＜この項の構成＞

(1)　JP1/AJS2 - Managerの変更内容

(2)　JP1/AJS2 - Light Editionの変更内容

(3)　JP1/AJS2 - Viewの追加・変更機能

(1)　JP1/AJS2 - Managerの変更内容

Cm2連携でJP1/Cm2/NNM 07-10と連携できるようにした。

デスクトップヒープ領域の消費を抑える機能を追加した（Windows限定）。

スケジューラーサービスのデータベースへの接続の最大待ち合わせ時間を指定できる機能を追加した。

(2)　JP1/AJS2 - Light Editionの変更内容

Cm2連携でJP1/Cm2/NNM 07-10と連携できるようにした。

デスクトップヒープ領域の消費を抑える機能を追加した。

スケジューラーサービスのデータベースへの接続の最大待ち合わせ時間を指定できる機能を追加した。

(3)　JP1/AJS2 - Viewの追加・変更機能

［貼り付け（拡張）］メニューコマンドを追加し，ジョブネットワーク要素と関連線を同時に複写できるようにした。

複数のジョブネット要素から一つのジョブネットワーク要素に対して関連線を引けるようにした。

Cm2連携でJP1/Cm2/NNM 07-10と連携できるようにした。

JP1/AJS2 Console ViewからJP1/AJS2 - Viewの［ジョブネットモニタ］ウィンドウを表示するとき，すでに起動されているJP1/AJS2 - Viewがあれば，そのJP1/AJS2 - View上で［ジョブネットモニタ］ウィンドウを起動する機能を追加した。

付録G.6　07-10の変更内容

07-10での変更点をプログラムごとに示します。

＜この項の構成＞

(1)　JP1/AJS2 - Managerの変更内容

(2)　JP1/AJS2 - Agentの変更内容

(3)　JP1/AJS2 - Light Editionの変更内容

(4)　JP1/AJS2 - Client Toolkitの変更内容

(5)　JP1/AJS2 - Viewの追加・変更機能

(1)　JP1/AJS2 - Managerの変更内容

Linux版JP1/Automatic Job Management System 2 - Managerをサポートした。

統合トレースログだけに出力していたメッセージをsyslogにも出力できるようにした（UNIX限定）。

資料採取ツールで次の機能を追加した。

論理ホスト名を指定できるようにした。

採取できる資料を限定できる機能を追加した。

採取できる資料を追加した。

メッセージの説明を改善した。

障害時に緊急で実行できる緊急実行コマンドを追加した。

受信するファイルのファイルサイズなどに制限を掛けて，一部のジョブの処理でシステム全体に影響が出ないように運用するための機能を追加した。

イベント・ジョブ情報，待機情報ファイルの更新時に同期書き込みを行う機能を追加した。

MQ Series連携時の監視間隔を秒単位で設定する機能を追加した。

Cm2連携でJP1/Cm2/NNM 07-01と連携し，Windows XP上で動作できるようにした。

Cm2連携でJP1/Cm2/NNM 07-01と連携し，Solaris 9上で動作できるようにした。

Cm2連携で，JP1/Cm2/NNM 07-10およびhp OpenView NNM 6.41との連携をサポートした。

TCP/IP通信接続エラーのリトライ間隔・回数を変更できるようにした。

ジョブを配信するエージェントホストの決定方式を設定できるようにした。

イベント・アクション制御の詳細プロセスがシグナル終了した場合，すべての詳細プロセスを停止してイベント・アクション制御のエージェントプロセスを終了する機能を追加した。

提供する関数の対応するコンパイラーとして，Microsoft(R) Visual C++ .NET Version 2003を追加した。

ajsshowコマンドで終了状態の保留属性を表示できるようにした。

ajsshowコマンドのフォーマット指示子指定で，未来世代数を出力できるようにした。

ajsnameコマンドでユニットIDからユニット完全名を出力する機能を追加した。

(2)　JP1/AJS2 - Agentの変更内容

資料採取ツールで次の機能を追加した。

論理ホスト名を指定できるようにした。

採取できる資料を限定できる機能を追加した。

採取できる資料を追加した。

メッセージの説明を改善した。

MQ Series連携時の監視間隔を秒単位で設定する機能を追加した。

イベント・アクション制御の詳細プロセスがシグナル終了した場合，すべての詳細プロセスを停止してイベント・アクション制御のエージェントプロセスを終了する機能を追加した。

イベント・ジョブ情報，待機情報ファイルの更新時に同期書き込みを行う機能を追加した。

統合トレースログだけに出力していたメッセージをsyslogにも出力できるようにした（UNIX限定）。

(3)　JP1/AJS2 - Light Editionの変更内容

統合トレースログだけに出力していたメッセージをsyslogにも出力できるようにした（UNIX限定）。

資料採取ツールで次の機能を追加した。

論理ホスト名を指定できるようにした。

採取できる資料を限定できる機能を追加した。

採取できる資料を追加した。

メッセージの説明を改善した。

受信するファイルのファイルサイズなどに制限を掛けて，一部のジョブの処理でシステム全体に影響が出ないように運用するための機能を追加した。

障害時に緊急で実行できる緊急実行コマンドを追加した。

イベント・ジョブ情報，待機情報ファイルの更新時に同期書き込みを行う機能を追加した。

MQ Series連携時の監視間隔を秒単位で設定する機能を追加した。

Cm2連携でJP1/Cm2/NNM 07-01と連携し，Windows XP上で動作できるようにした。

Cm2連携でJP1/Cm2/NNM 07-01と連携し，Solaris 9上で動作できるようにした。

TCP/IP通信接続エラーのリトライ間隔・回数を変更できるようにした。

イベント・アクション制御の詳細プロセスがシグナル終了した場合，すべての詳細プロセスを停止してイベント・アクション制御のエージェントプロセスを終了する機能を追加した。

提供する関数の対応するコンパイラーとして，Microsoft(R) Visual C++ .NET Version 2003を追加した。

ajsshowコマンドで終了状態の保留属性を表示できるようにした。

ajsshowコマンドのフォーマット指示子指定で，未来世代数を出力できるようにした。

ajsnameコマンドでユニットIDからユニット完全名を出力する機能を追加した。

(4)　JP1/AJS2 - Client Toolkitの変更内容

資料採取ツールで次の機能を追加した。

採取できる資料を追加した。

メッセージの説明を改善した。

(5)　JP1/AJS2 - Viewの追加・変更機能

資料採取ツールで次の機能を追加した。

論理ホスト名を指定できるようにした。

採取できる資料を限定できる機能を追加した。

採取できる資料を追加した。

メッセージの説明を改善した。

標準カスタムジョブに，Cosminexus Managerと連携するジョブ（クラス名：COSMNGSV，COSMNGAP）を追加した。

JP1/AJS2 - Viewのログファイルの上限値を拡張した。

JP1/AJS2 Console Viewのログファイルの上限値を拡張した。

JP1/AJS2 - Viewで，繰り返し出力していたログ情報をまとめて出力するようにした。

JP1/AJS2 Console Viewで，繰り返し出力していたログ情報をまとめて出力するようにした。

Windows版のJP1/AJS2 - Viewで［スタート］メニューに［ヘルプ］メニューを追加した。

Cm2連携でJP1/Cm2/NNM 07-01と連携し，Windows XP上で動作できるようにした。

Cm2連携でJP1/Cm2/NNM 07-01と連携し，Solaris 9上で動作できるようにした。

付録G.7　07-00の変更内容

＜この項の構成＞

(1)　JP1/AJS2 - Managerの変更内容

(2)　JP1/AJS2 - Advanced Managerの変更内容

(3)　JP1/AJS2 - Light Editionの変更内容

(4)　JP1/AJS2 - Agentの変更内容

(5)　JP1/AJS2 - Viewの変更内容

(1)　JP1/AJS2 - Managerの変更内容

JP1/AJS2を一時的に縮退させ，運用している業務を途切れることなく，ISAMデータベース（スケジューラーデータベースおよびジョブ実行環境データベース）を再編成できる機能をサポートした。

ISAMデータベースを並列に再編成できるようにした。

追加できるスケジューラーサービスの数を，9から20に変更した。

ajsshowなどのコマンド（参照系コマンド）の実行時期や，操作系のコマンドのサービスへの処理要求履歴を，操作ログとしてスケジューラーログに出力するオプションをサポートした。

ジョブネットの保存世代数を，99から999に変更した。

JP1/AJS2のコールドスタート時に，ジョブ実行環境のデータベースを削除して，JP1/AJS2の起動時間が短くなるようにした。

ジョブ実行制御の環境設定で，ユーザープロファイル情報を有効にする機能をサポートした。

ジョブ情報の保存日数を0日にした場合で，ジョブが異常終了しても，保存時間を変更することで対処できるようにした。

JP1/AJS2起動時にジョブ情報削除処理を抑止できるようにした。

イベントジョブを使用する場合，DNS環境（FQDN形式のホスト名）でも運用できるようにした。

引き継ぎ情報中の「"（ダブルクォーテーションマーク）」の有無を意識しないで，イベントジョブの受信情報をマクロ変数として，標準ジョブやアクションジョブのパラメーターに引き継げるようにした。

JP1/Baseで対応した拡張正規表現を，JP1/Baseの設定に合わせて，イベント受信監視ジョブ，ログファイル監視ジョブ，およびWindowsイベントログ監視ジョブで使用できるようにした。

キューレスジョブを実行できる機能をサポートした。

以前のバージョン（06-71）で別製品であったJP1/AJS2 - Consoleを統合した。

JP1/AJS2 - Consoleで業務スコープを階層化できる機能を追加した。

JP1/AJS2 - Consoleで監視オブジェクトに対して操作できる機能を追加した。

JP1/AJS2 - Consoleで任意の画像を背景として表示できる機能を追加した。

JP1/AJS2 - Consoleで監視オブジェクトと業務スコープのアイコンを任意のアイコンに変更できる機能を追加した。

JP1/AJS2 - Consoleで保留属性が設定されている監視オブジェクトを色で識別できる機能を追加した。

JP1/AJS2 - Consoleで監視オブジェクトの状態を任意のタイミングで更新できる機能を追加した。

JP1/AJS2 - Consoleで監視オブジェクトの監視方法に次のモードを追加した。

当日時刻予定優先

全世代時刻予定優先

JP1/AJS2 - Consoleの定義情報を標準出力ファイルに出力するコマンド（ajscmprint）を追加した。

ジョブネットの実行所要時間に対する終了遅延の監視ができる機能をサポートした。

ajsprintコマンドのフォーマット指示子指定で，ユニットの作成日時を出力できるようにした。

ajsshowコマンドのフォーマット指示子指定で，ユニットに設定されたコメントを出力できるようにした。

ajsshowコマンドのフォーマット指示子指定で，ジョブが異常終了した場合に，異常終了ジョブまたはその後続ユニットから再実行した場合に掛かる実行所要時間の推定値を出力できるようにした。

イベントジョブが，打ち切り時間で終了するときの終了状態を選択できるようにした。

JP1イベント送信ジョブにイベントの到達確認機能をサポートした。

JP1イベント受信監視ジョブに過去のイベントを検索する機能をサポートした。

(2)　JP1/AJS2 - Advanced Managerの変更内容

JP1/AJS2で使用できるデータベース種別として，組み込みDB（HiRDB）をサポートした。

(3)　JP1/AJS2 - Light Editionの変更内容

JP1/AJS2を一時的に縮退させ，運用している業務を途切れことなく，ISAMデータベース（スケジューラーデータベースおよびジョブ実行環境データベース）を再編成できる機能をサポートした。

ISAMデータベースを並列に再編成できるようにした。

追加できるスケジューラーサービスの数を，9から20に変更した。

ajsshowなどのコマンド（参照系コマンド）の実行時期や，操作系のコマンドのサービスへの処理要求履歴を，操作ログとしてスケジューラーログに出力するオプションをサポートした。

ジョブネットの保存世代数を，99から999に変更した。

JP1/AJS2のコールドスタート時に，ジョブ実行環境のデータベースを削除して，JP1/AJS2の起動時間が短くなるようにした。

ジョブ実行制御の環境設定で，ユーザープロファイル情報を有効にする機能をサポートした。

ジョブ情報の保存日数を0日にした場合で，ジョブが異常終了しても，保存時間を変更することで対処できるようにした。

JP1/AJS2起動時にジョブ情報削除処理を抑止できるようにした。

イベントジョブを使用する場合，DNS環境（FQDN形式のホスト名）でも運用できるようにした。

引き継ぎ情報中の「"（ダブルクォーテーションマーク）」の有無を意識しないで，イベントジョブの受信情報をマクロ変数として，標準ジョブやアクションジョブのパラメーターに引き継げるようにした。

JP1/Baseで対応した拡張正規表現を，JP1/Baseの設定に合わせて，イベント受信監視ジョブ，ログファイル監視ジョブ，およびWindowsイベントログ監視ジョブで使用できるようにした。

以前のバージョン（06-71）で別製品であったJP1/AJS2 - Consoleを統合した。

JP1/AJS2 - Consoleで業務スコープを階層化できる機能を追加した。

JP1/AJS2 - Consoleで監視オブジェクトに対して操作できる機能を追加した。

JP1/AJS2 - Consoleで任意の画像を背景として表示できる機能を追加した。

JP1/AJS2 - Consoleで監視オブジェクトと業務スコープのアイコンを任意のアイコンに変更できる機能を追加した。

JP1/AJS2 - Consoleで保留属性が設定されている監視オブジェクトを色で識別できる機能を追加した。

JP1/AJS2 - Consoleで監視オブジェクトの状態を任意のタイミングで更新できる機能を追加した。

JP1/AJS2 - Consoleで監視オブジェクトの監視方法に次のモードを追加した。

当日時刻予定優先

全世代時刻予定優先

JP1/AJS2 - Consoleの定義情報を標準出力ファイルに出力するコマンド（ajscmprint）を追加した。

ジョブネットの実行所要時間に対する終了遅延の監視ができる機能をサポートした。

ajsprintコマンドのフォーマット指示子指定で，ユニットの作成日時を出力できるようにした。

ajsshowコマンドのフォーマット指示子指定で，ユニットに設定されたコメントを出力できるようにした。

ajsshowコマンドのフォーマット指示子指定で，ジョブが異常終了した場合に，異常終了ジョブまたはその後続ユニットから再実行した場合に掛かる実行所要時間の推定値を出力できるようにした。

イベントジョブが，打ち切り時間で終了するときの終了状態を選択できるようにした。

JP1イベント送信ジョブにイベントの到達確認機能をサポートした。

JP1イベント受信監視ジョブに過去のイベントを検索する機能をサポートした。

(4)　JP1/AJS2 - Agentの変更内容

引き継ぎ情報中の「"（ダブルクォーテーションマーク）」の有無を意識しないで，イベントジョブの受信情報をマクロ変数として，標準ジョブやアクションジョブのパラメーターに引き継げるようにした。

キューレスジョブを実行できる機能をサポートした。

JP1イベント送信ジョブにイベントの到達確認機能をサポートした。

イベントジョブが，打ち切り時間で終了するときの終了状態を選択できるようにした。

JP1イベント受信監視ジョブに過去のイベントを検索する機能をサポートした。

JP1/AJS2 - Agentの起動時に認証サーバへのアクセスを行わないようにした（07-00-/C以降）。

(5)　JP1/AJS2 - Viewの変更内容

ユーザー共通プロファイルを利用して，JP1/AJS2 - Viewの環境を設定できるようにした。

［ジョブネットエディタ］ウィンドウと［ジョブネットモニタ］ウィンドウのマップエリアに表示される，ユニット名を任意の位置で改行できるようにした。

ダイアログボックスのデフォルト値を変更できるようにした。

次に示す場所の表示項目（カラム）を選択できるようにした。

［JP1/AJS2 - View］ウィンドウのリストエリア

［デイリースケジュール］ウィンドウの実行結果リスト

［マンスリースケジュール］ウィンドウの実行結果リスト

［JP1/AJS2 - View］ウィンドウで複数のユニットを選択して，編集や操作が行える機能を追加した。

保留属性が設定されているユニットを色で識別できる機能を追加した。

［実行結果詳細］ダイアログボックスのサイズを変更できる機能を追加した。

［JP1/AJS2 - View］ウィンドウと［メインスコープ］ウィンドウ間でJP1/AJS2のユニット定義をJP1/AJS2 - Consoleの監視オブジェクトとして自動作成する機能を追加した。

任意のアイコンイメージを使用できる機能を追加した。

JP1/IM - Viewから［ジョブネットモニタ］ウィンドウを起動した場合に，指定したジョブを直接マップエリアに表示する機能を追加した。

付録H　（3020-3-K23-43）の変更内容

3020-3-K23-43の変更内容を次の表に示します。

表H-1　（3020-3-K23-43）の変更内容

項番
変更個所
追加・変更内容

1
全体
64ビット版Windows環境の場合の，プログラムのインストール先ディレクトリおよび各種ファイルの格納先を追加した。

2
4.1.4
ログファイルの設定についての説明に，最低でも1日分のログを保存できるサイズを指定するよう促す記述を追加した。

3
4.2.1
4.2.2
次の環境設定パラメーターを追加した。

MergeEnvMode

4
5.1.3 表5-5，
15.1.3 表15-5
ajsembdbbuildコマンド，ajsembdbbackupコマンド，およびajsembdbrstrコマンドの実行時に必要となるオプションの内容を変更した。

5
7.1
16.1
ジョブ実行時のワークパスを変数として定義する設定の説明，および定義手順を変更した。

6
7.3
転送元ファイルの検索パスを定義する際に停止するサービスを変更した。

7
7.28
WOW64環境でジョブを実行する際にファイルシステムリダイレクトを無効にする設定についての注意事項を変更した。

8
7.29
キューレスジョブが戻り値128で異常検出終了となる問題を回避するための定義手順を変更した。

9
7.36
拡張子が4バイト以上の実行ファイルのジョブを実行するための設定についての説明を追加した。

10
7.37
16.33
エージェントホスト名の名前解決オプションの設定についての説明を追加した。

11
7.38
16.34
イベント・アクション制御のプロセス間通信でのデータ到着待ちタイムアウト化オプションの設定についての説明を追加した。

12
7.39
ジョブ実行時のログオンリトライを変更する設定についての説明を追加した。

13
7.40
16.35
イベントジョブを実行する場合のマネージャーホスト名を固定化する設定についての説明を追加した。

14
7.41
システム環境変数とジョブ定義の環境変数が重複した場合に，ジョブ定義の環境変数を有効にするための設定についての説明を追加した。

15
9.4.1
jp1ajs2hasetup.exe実行時に作成されるフォルダのセキュリティについての注意事項を追加した。

16
9.4.2
18.4.2
クラスタシステムの環境設定の手順（実行系での作業）の説明を変更した。

17
14.1.3
環境設定パラメーターNETLOGの設定値allについての説明を変更した。

18
14.2.2
14.2.3
次の環境設定パラメーターの説明を追加した。

GetPasswd_RetryCount

GetPasswd_RetryInterval

19
14.4.2
14.4.3
次の環境設定パラメーターの説明を追加した。

AJSQL_GETPASSWD_FTPRETRYCOUNT

AJSQL_GETPASSWD_FTPRETRYINTERVAL

AJSQL_GETPASSWD_AGTRETRYCOUNT

AJSQL_GETPASSWD_AGTRETRYINTERVAL

AJSQL_AGTWORKPATH

AJSQL_CJOBMAX

AJSQL_CJOBWAITMAX

20
14.7.2(9)
組み込みDBの自動起動および自動終了の設定方法についての説明を追加した。

21
14.7.4
スケジューラーサービスの統合トレースログ出力レベルの変更方法についての説明を追加した。

22
14.7.5
ネストジョブネット定義パラメーター出力時のスケジュールルールの出力方法の変更方法についての説明を追加した。

23
14.7.6
スケジューラートレースログファイルの名称の変更方法についての説明を追加した。

24
16.2
転送元ファイルの検索パスの定義手順を変更した。

25
16.10
標準出力ファイル名と標準エラー出力ファイル名に同じファイル名を指定する場合の注意事項を変更した。

26
16.26(3)
JP1/AJS2で設定する子プロセスのシグナルの動作に，プロセスのストップからの再開（restart the process）を追加した。

27
16.36
ユーザー情報取得時のリトライ回数およびリトライ間隔の変更方法を追加した。

28
16.37
エージェント自動定義機能で作成されるキュー属性値をカスタマイズする設定の説明を追加した。

29
18.4.4
クラスタソフトへの登録についての説明を変更した。

30
18.4.8
論理ホストのJP1/AJS2の起動および終了を制御する設定についての説明を追加した。

31
20.
ajsembdbbuild
ajsembdbsetup
ajsembdbunset
Windows Server 2008でUAC機能が無効の場合の注意事項を追加した。

32
20.
ajsovsetup
設定するファイルに，信任コマンド定義ファイルを追加した。

33
20.
ajsqlsetup

-rオプションの説明を変更した。

-mオプションまたは-aオプションを指定する場合の注意事項を変更した。

-rオプションまたは-uオプションを指定する場合の注意事項を変更した。

34
20.
jp1ajs2_setup_cluster（UNIX限定）

実行系のJP1/AJS2 - Managerをセットアップする場合の説明を追加した。

引数-n 値で指定する，スケジューラーサービスの識別番号についての説明を変更した。

35
20.
jpomailrecv（UNIX限定）
イベント・アクション実行環境設定ファイルについての注意事項を追加した。

36
20.
jpqimport

コマンドの機能説明を変更した。

コマンドを使ってエージェント・キュー・排他実行リソースを追加したり，削除したりし，かつ環境設定で最大定義数を小さくした場合の注意事項の説明を変更した。

エージェント定義のジョブ実行多重度指定の説明に，ジョブ実行多重度が0の場合にジョブを実行できない旨を追加した。

エージェント定義およびキュー定義の，デフォルトキューのジョブ受付口状態指定の説明に，受付口が閉じている場合はデフォルトキューにジョブを投入できない旨を追加した。

エージェント定義およびキュー定義の，デフォルトキューのジョブ取出口状態指定の説明に，取出口が閉じている場合はデフォルトキューでジョブを実行できない旨を追加した。

37
付録B.1
付録B.2(1)
付録B.2(2)
環境変数を指定するときの形式についての注意事項を追加・変更した。

付録I　用語解説

（英字）

AJS2ユニット監視オブジェクト

JP1/AJS2の業務の状態を監視するためのオブジェクトです。業務には，JP1/AJS2 - Managerのホストのルートジョブネットを指定します。このオブジェクトで監視内容を定義し，監視モードに切り替えることでオブジェクト（業務）を監視できるようになります。

AJSPATH

JP1/AJS2で使用するパスを定義するための環境変数です。環境変数を指定しておくと，コマンドでジョブネット名を指定するときに完全パス名の指定が不要になります。

HITSENSER Data Mart Server

データマート（データウェアハウスのデータから目的に合わせて必要なデータを抽出した，利用目的ごとのデータベース）の作成，変更，および運用の自動化をプログラミングなしで実現するソフトウェアです。HITSENSER Data Mart Serverで定義した運用情報をJP1/AJS2のジョブネットに登録することで，データマートをスケジュールに従って運用できます。

hp OpenView

ネットワークの構成，性能，および障害を管理する，ヒューレット・パッカード社の統合ネットワーク管理プログラムの総称です。

JP1/AJS2 - Definition Assistant

Excelのテンプレートで編集した大量のJP1/AJS2の定義情報を，マネージャーホストに登録したり，マネージャーホストに登録されているJP1/AJS2の定義情報を，Excelのテンプレートに取得したりできるプログラムです。JP1/AJS2 - Definition Assistantで提供されている，Excelのテンプレートを定義情報管理テンプレートといいます。一覧表形式の定義情報管理テンプレートでは，オートフィルやオートフィルターなどのExcelの機能を使って，効率良く定義情報の入力や編集ができます。

JP1/AJS2 - Print Option

JP1/AJS2のジョブネットやスケジュールの情報を，ジョブネット定義情報，実行予実績確認表，実行結果確認表などの帳票レイアウトの形式で表示したり，印刷したりするためのプログラムです。また，JP1/AJS2のジョブネットやスケジュールの情報をCSV形式で出力できます。

JP1/AJS2 - Web Operation Assistant

複数のマネージャーホスト上で実行されているユニットの状態や結果を，Webブラウザー上に一覧表示するプログラムです。操作したいジョブやジョブネットをWebブラウザー上で選択して再実行などの操作をしたり，ジョブネットモニタを起動して状態や結果を確認したりできます。

JP1/AJS2 Console Agent

JP1/AJS2 Console Agentは，JP1/AJS2 Console Managerで指示された自ホストの監視対象（ルートジョブネット）の状態を定期的に監視するコンポーネントです。監視対象の状態に変更があれば，JP1/AJS2 Console Managerに通知します。

JP1/AJS2 Console Manager

JP1/AJS2 Console Managerは，JP1/AJS2 Console Viewで定義された監視対象の定義情報を保存したり，JP1/AJS2 Console Agentに指示して，監視対象の状態を取得したりするコンポーネントです。

JP1/AJS2 Console View

GUIで監視対象を定義するコンポーネントです。定義した情報は，JP1/AJS2 Console Managerに保存されます。また，JP1/AJS2 Console AgentからJP1/AJS2 Console Managerに通知された監視対象の状態を表示して監視します。JP1/AJS2 Console Managerにログインして使用します。

JP1/AJS2 for Enterprise Applications

R/3以外のシステムからR/3システムのジョブを制御するプログラムです。R/3ジョブの投入，削除，および監視ができます。

JP1/AJS2のジョブネット定義時にJP1/AJS2 for Enterprise Applicationsのカスタムジョブをジョブネットに登録すると，JP1/AJS2からR/3ジョブを自動実行できます。

なお，JP1/AJS2 for Enterprise Applicationsは，JP1/Application Manager for R/3を名称変更したものです。

JP1/AJS2 for Mainframe

JP1/AJS2と連携して，メインフレームのジョブスケジューラーが管理する大規模なジョブネットを実行するためのプログラムです。メインフレームのジョブスケジューラーが管理するジョブネットとJP1/AJS2が管理するジョブネットの定義，監視，操作方法の統一と一元管理ができます。

JP1/AJS2 for Oracle E-Business Suite

Oracle E-Business Suite以外のシステムからOracle E-Business Suiteにアクセスして，業務の実行を依頼する（コンカレント要求を発行する）プログラムです。

また，JP1/AJS2のジョブネットにJP1/AJS2 for Oracle E-Business Suiteのカスタムジョブを登録すると，JP1/AJS2からコンカレント要求を発行できます。

また，JP1/AJS2のスケジュール定義機能を利用すると，コンカレント要求の処理サイクルや実行日を指定できます。

なお，JP1/AJS2 for Oracle E-Business Suiteは，JP1/Application Manager for Oracle E-Business Suiteを名称変更したものです。

JP1/AJS2 for Web Service

WebサービスシステムとJP1/AJS2システムを仲介し，JP1/AJS2でWebサービスを一連の業務として実行させるためのプログラムです。

Webアプリケーションサーバ上のWebサービスをJP1/AJS2のジョブとして実行できます。

JP1/AJS2 for 活文PDFstaff

活文PDFstaffと連携し，PDF変換を行います。作成するPDFファイルには，パスワード，印刷禁止/許可などの操作制限，ヘッダー・フッター，透かし文字などのセキュリティ情報を設定できます。

JP1/Base

イベントサービス機能を提供するプログラムです。サービスの起動順序を制御したり，JP1イベントを送受信したりできます。また，JP1/Baseは，JP1/IM，JP1/AJS2，およびJP1/Power Monitorの前提プログラムです。JP1/IM，およびJP1/AJS2を使ったシステムを導入する場合，JP1ユーザーの操作を制限する機能を提供します。

JP1/Cm2

ネットワークの構成，性能，および障害を管理するための統合ネットワーク管理プログラムの総称です。

JP1/FTP

業務と連携したファイル送受信，ファイルのスケジュール伝送，ファイル受信後のプログラムの自動起動など，ファイル伝送業務を効率的に運用するためのプログラムです。また，ファイル伝送状態を監視できるため，ファイル伝送業務の信頼性を向上できます。

JP1/IM

分散システムを集中的に監視するためのプログラムです。分散システム内での業務の実行状況や障害などの情報を表すJP1イベントを，JP1/IM - Viewの画面を通じて監視できます。

JP1/NETM/DM

ソフトウェアの配布およびクライアントの管理を，ネットワークを利用し一括して行うシステムの総称です。

JP1/NETM/DMのコマンドインターフェースを使用してJP1/AJS2と連携すると，ソフトウェアの配布などを自動化できます。

JP1/NQSEXEC

定型的なバッチ処理を分散システム上で実行し，バッチジョブを効率良く運用するためのプログラムです。

JP1/OJE for Midrange Computer

WindowsホストやUNIXホストからAS/400にバッチジョブを投入したり，AS/400からWindowsホストやUNIXホストにバッチジョブを投入したりするためのプログラムです。

JP1/OJE for VOS1

JP1/AJS2と連携して，WindowsおよびUNIXと，メインフレーム（VOS1）間のバッチジョブを実行したり監視したりするプログラムです。

JP1/OJE for VOS3

JP1/AJS2と連携して，WindowsおよびUNIXと，メインフレーム（VOS3）間のバッチジョブを実行したり監視したりするプログラムです。

JP1/OJE for VOSK

JP1/AJS2と連携して，WindowsおよびUNIXと，メインフレーム（VOSK）間のバッチジョブを実行したり監視したりするプログラムです。

JP1/Power Monitor

ホストを自動的に起動・終了するプログラムです。スケジュールを設定してホストを起動・終了したり，離れた場所にあるホストを起動・終了したりできます。

JP1/Script

Windows上でジョブを制御するスクリプト（バッチファイル）を作成して実行するためのプログラムです。JP1/AJS2と連携すると，ジョブを自動運転できます。

JP1イベント

システム内で何らかの事象が発生した際に，その事象の発生を通知する情報です。JP1イベントは，JP1/Baseを経由して，ほかのシステムなどに通知されます。

JP1権限レベル

JP1/AJS2で定義した業務やイベントなどの管理対象（資源）に対して，JP1ユーザーがどのような操作をできるかを表した名称です。JP1/Baseで定義します。

JP1資源グループ

JP1/AJS2の各ユニットに対するJP1ユーザーのアクセスを制御するために，ユニットに設定する名称です。

JP1ユーザー

JP1/AJS2またはJP1/IMを使用するときのユーザー名です。JP1ユーザーとして認証サーバに登録すると，管理対象（資源）へのアクセスが制御されます。

MAPI（Messaging Application Programming Interface）

Windows用の標準的なメッセージングAPIです。

MIME（Multipurpose Internet Mail Extensions）

SMTPの拡張機能で，ASCIIデータ以外のデータを送受信する場合に使います。

メールシステム間でのデータ送受信の方法や，メールを転送するために交換する制御メッセージのフォーマットなどを定めています。

MQSeries

IBM社の製品で，メッセージキューを使って，同一のプラットフォームまたは異なるプラットフォーム間でメッセージをやり取りするためのプログラムです。

MQ文字列

TP1/Message QueueおよびMQSeriesで定義されている文字列です。

MQ文字列には次の文字が指定できます。

A～Z，a～z（英文字）

0～9（アラビア数字）

.（ピリオド）

/（スラント）

_（アンダーバー）

%（パーセント）

MSMQ

Microsoft Message Queue Serverの略で，Windows上でメッセージキューイング機能を実現するソフトウェアです。

SMTP（Simple Mail Transfer Protocol）

UNIXのネットワークで一般的に使われているプロトコルです。このプロトコルは，TCP/IP上で異なるシステム間でのASCIIデータの転送を実現するための規約です。

SUP

TP1/LiNKまたはTP1/Server Baseのクライアントとなるプログラムのことです。JP1/AJS2では，SUPを使用してメッセージキュー連携機能を実現しています。メッセージキュー連携機能を使用するときは，TP1/LiNKまたはTP1/Server BaseのSUPにJP1/AJS2のユーザーサーバを設定しておきます。

TP1/LiNK

オープンシステムでトランザクション処理，およびサーバの処理分散化を実現するソフトウェアです。JP1/AJS2では，これらの機能のうちトランザクション処理を使用しています。

TP1/Message Queue

TP1/LiNKまたはTP1/Server Baseと連携して，メッセージキューイング機能を実現するソフトウェアです。OpenTP1システムに組み込み，異なるアプリケーション同士でプログラム間通信ができます。TP1/Message Queueは一連のメッセージキューイング機能のプログラム間でメッセージ送受信が簡単にできます。また，TP1/Message Queueは，OpenTP1システムのメッセージキューマネージャーの役割を持ち，メッセージキューの管理およびメッセージの送受信をします。

TP1/Server Base

オープンシステムでトランザクション処理，およびサーバの処理分散化を実現するソフトウェアです。JP1/AJS2では，これらの機能のうちトランザクション処理を使用しています。

Windows Messaging機能

電子メールを送受信するためのインターフェースを提供する機能です。Windows Messagingを使うと，オンラインサービスから受け取ったデータなど，さまざまな種類の情報を管理，アクセス，および共有することができます。

（ア行）

アクションジョブ

メールやメッセージキューを送信したり，JP1/IMやJP1/Cm2に状態を知らせるイベントを送信したりするジョブです。

異常終了

ジョブネットの異常終了は，ジョブネットに定義した処理の一部が正しく実行されず，その時点でジョブネットを終了することです。障害が発生した部分からあとに定義されている処理は実行されず，ジョブネットは中断されます。

ジョブの異常終了は，ジョブが正しく実行されず，処理を途中で中断することです。

組み込みDBシステムの異常終了は，組み込みDBシステムに対して何らかの障害が発生した場合に，組み込みDBシステム停止操作が実行されていないのに，稼働状態だった組み込みDBシステムが停止状態または再起動中断状態に遷移することです。詳細については，マニュアル「JP1/Automatic Job Management System 2 設計・運用ガイド　8.7 組み込みDBの動作に関する知識」を参照してください。

異常終了しきい値

ジョブが正常終了したか異常終了したかを，ジョブの終了コードで判断するための値です。

イベント

メールの受信や，ファイルの更新など，システム内で起こる特定の事象のことで，ジョブやジョブネットなどの実行契機となります。イベントの発生は，イベントジョブを使って監視します。

イベントジョブ

システム内の特定の事象の発生を監視するジョブです。イベントジョブを開始すると，ファイルの更新やメッセージの受信などを監視し始めます。

打ち切り時間

ジョブを実行したとき，ジョブからの応答がなかったり終了しなかったりした場合に，ジョブを強制的に打ち切るまでの時間です。

運用日

ジョブネットを実行する日です。

エージェントホスト

エージェントホストとは，マネージャーホストから依頼されたジョブを実行するホストです。このホストには，JP1/AJS2 - Agentをインストールします。なお，JP1/AJS2 - ManagerもJP1/AJS2 - Agentの機能を持っているため，エージェントホストにJP1/AJS2 - Managerをインストールすることもできます。

エージェントホストは，マネージャーホストからジョブの依頼を受け，ジョブを実行します。ジョブの実行が終わると，エージェントホストは，実行ファイルの実行結果（戻り値）を受け取り，ジョブの実行結果をマネージャーホストに転送します。

（カ行）

確定実行登録

スケジュール定義に基づいてあらかじめ実行日時を算出しておき，その日時に従ってジョブネットを起動し，処理を開始する場合の実行登録方法です。

確定スケジュール

確定実行登録時に決められた，絶対日時で確定しているスケジュールのことです。

カスタムジョブ

ある特定の機能を持つジョブを実行するように，あらかじめ定義されたジョブです。ファイル転送やメインフレームへのジョブ依頼など，標準カスタムジョブとして提供しているもののほかに，業務の中でよく使うジョブをカスタムジョブとして登録しておくこともできます。カスタムジョブとして登録する場合，専用のアイコンの形，絵，またはジョブ情報入力のためのダイアログボックスが作成できます。

なお，カスタムジョブを使用する場合は，そのジョブに必要なプログラムをインストールしておく必要があります。

カレンダー情報

業務の運用日と休業日についての情報です。ジョブグループごとに定義できます。この情報によって，ジョブグループ中のジョブネットを実行する日と実行しない日が決定します（ただし，休業日振り替え実行が定義されている場合は，休業日でもジョブネットを実行します）。

また，運用日に合わせて，基準日と月区分，基準時刻の設定もできます。

環境設定パラメーター

JP1/AJS2の運用に必要な各種情報を設定するためのパラメーターで，環境設定ファイルの中に記述します。例えば，ジョブネットワーク要素を作成するディレクトリを指定したり，syslogメッセージの出力の要否を指定したりします。

環境設定ファイル

スケジューラーサービスの環境やジョブの実行環境など，JP1/AJS2の運用に必要な情報を設定するファイルです。

起算スケジュール

実行開始日時，処理サイクル，および休業日の振り替えに従って決められた次回実行予定日を起点日として扱い，新たに次回実行予定日を算出したい場合に定義するスケジュールのことです。

起算猶予日数

起算後の次回実行予定日が休業日の場合に，実行予定日を探す期間を日数で定義したもののことです。

基準時刻

JP1/AJS2を運用するときの，日付の境となる時刻です。

例えば，基準時刻を「8時」と設定すると，7時59分までは前日扱いとなります。

基準日

カレンダー情報で，月の開始日として指定した日のことです。

起動条件

特定の事象を契機としてジョブネットを実行させる場合に，どのような条件が成立したときにジョブネットを実行させるか定義したもののことです。

キュー

実行登録されたジョブを一時的にためておくところです。ジョブは，登録された順番でキューに並び，そのキューに接続されているエージェントに対して順次転送され，実行されます。

大量のジョブが同時に実行されシステムの性能が低下しないよう，キューは，エージェントで同時に実行するジョブの数を制御します。

キューイングジョブ

キューへジョブを直接登録して実行依頼する形態のジョブです。

休業日

ジョブネットを実行しない日です。ただし，休業日振り替え実行が定義されている場合はジョブネットを実行します。

キューレスジョブ

キューを使わず，マネージャーから直接エージェントへ送られて実行されるジョブです。キューでのジョブの管理を省略し処理を簡略化しているため，通常のジョブに比べて処理性能が向上し，一定の時間に，より多くのジョブを実行できます。

ジョブネットに定義するPCジョブ，およびUNIXジョブをキューレスジョブとして定義できます。

キューレスジョブ実行環境

キューレスジョブ実行環境は，JP1/AJS2のマネージャー（スケジューラーサービスとキューレスファイル転送サービス）とキューレスエージェント（キューレスエージェントサービス）で構成され，キューレスジョブの実行を管理します。

キューレスジョブを使用する場合は，ajsqlsetupコマンドでキューレスジョブ実行環境をセットアップしておく必要があります。セットアップされたキューレスジョブ実行環境は，環境設定パラメーターで設定できます。

強制終了

実行中のユニットを強制終了します。

ルートジョブネットを強制終了した場合，実行中のジョブをすべて強制終了し，ジョブネットを中断します。

組み込みDB管理者（DB管理者）

組み込みDBで，各種権限の付与および取り消しを行う権限を持っているユーザー（DBA権限所持ユーザー）を示します。

組み込みDBの内部で管理されているユーザーです。

組み込みDBサービス

Windows上での組み込みDB使用環境を提供するサービスです。組み込みDBを使用するには，このサービスを開始する必要があります。サービス名称は「HiRDB/EmbeddedEdition セットアップ識別子」です。

組み込みDBシステム管理者

組み込みDB運用ディレクトリおよび組み込みDBファイルシステム領域（データ領域，システム領域）の所有者であり，組み込みDBの各コマンドを実行することができるユーザーを示します。

OS上で管理されているユーザーです。

組み込みDB操作コマンド

ajsembdbで始まる名称のコマンドの総称です。

クラスタシステム

クラスタシステムとは，複数のサーバシステムを連携して一つのシステムとして運用するシステムで，障害が発生しても業務を継続できるようにすることを目的としています。業務を実行中のサーバ（実行系）で障害が発生すると，待機していた別のサーバ（待機系）が業務の処理を引き継ぎます。実行「系」から待機「系」へ業務を切り替えるので，「系切り替えシステム」とも呼びます。

なお，クラスタシステムという用語には，並列処理による負荷分散機能という意味もありますが，このマニュアルでは，系を切り替えて業務の中断を防ぐ機能のことだけを指します。

計画実行登録

スケジュール定義に基づいてジョブネットを起動し，処理を開始する場合の実行登録方法です。

系切り替えシステム

クラスタシステムを参照してください。

警告終了

ジョブネットに定義した処理の一部が正しく実行されないままジョブネットを終了することです。ジョブネットは中断されず，最後まで実行されます。

発生した障害が，ジョブネットを中断するほど重大でない場合に，この終了方法にします。

警告終了しきい値

ジョブが警告終了したかを判断するための値です。

件名

メール中のSubject:に記述される文字列です。JP1/AJS2では，件名にASCII文字列以外も設定できますが，接続しているメールシステムによってはASCII文字列以外を扱えない場合もあります。

後続ジョブ

あるジョブ，またはジョブネットの直後に実行するジョブのことです。

後続ジョブネット

あるジョブ，またはジョブネットの直後に実行するジョブネットのことです。

（サ行）

サーバリンクジョブ

JP1/AJS2で定義したジョブネットをメインフレームで管理するために，JP1/AJS2 for Mainframeで定義するジョブネットです。サーバリンクジョブネットは，JP1/AJS2のルートジョブネットと関連づけられます。

サスペンド

ルートジョブネット，およびルートジョブネットの下位にあるユニットの実行を抑止することです。

実行登録中のルートジョブネットの下位にある定義を変更するときに，定義処理と実行制御処理のすれ違いなどの誤動作を防止するために，ルートジョブネットをサスペンドする必要があります。ルートジョブネットをサスペンドすることで，実行制御処理と同期を取って定義を変更できます。

サブミット

ジョブの実行を依頼することです。

サブミットジョブ

jpqjobsubコマンドを使用して登録する標準ジョブのことです。

しきい値

ジョブの終了状態を判断するための値です。ジョブには，異常終了しきい値と警告終了しきい値を定義できます。

実行ID

最上位ジョブネットの実行予定の一つに対して一つ割り振られる番号のことです。

従属ジョブ

判定ジョブの判定結果が真のときに実行するジョブのことです。

従属ジョブネット

判定ジョブの判定結果が真のときに実行するジョブネットのことです。

ジョブ

コマンド，シェルスクリプト，Windows実行ファイルなどの集まりです。

ジョブグループ

複数の業務を分類して管理するためのフォルダです。

ジョブ実行環境

ジョブ実行環境は，JP1/AJS2のマネージャーとエージェントから構成されます。

マネージャーのジョブ実行環境では，ジョブを登録するキューやジョブを実行するエージェントの定義情報（ジョブの実行多重度，最大ジョブ数など），ジョブの配信方法，ジョブの実行結果などを管理します。

エージェントのジョブ実行環境では，主にジョブの実行方法を管理します。

これらのジョブ実行環境は，ISAMデータベースと環境設定パラメーターで管理されます。

なお，キューレスジョブの場合は，キューレスジョブ実行環境で管理します。

ジョブ多重度

同時に実行できるジョブの数のことです。

ジョブネット

実行順序を関連づけたジョブの集まりです。ジョブネットを実行すると，ジョブネット中のジョブが実行順序に従って自動的に実行されます。

ジョブネットエディタウィンドウ

ジョブネットを新規に作成したり，作成済みのジョブネットを編集したりするウィンドウのことです。

ジョブネットコネクタ

ルートジョブネットの実行順序を制御するためのジョブネットワーク要素です。対象のルートジョブネットと接続関係を持ち，その終了や開始を待ち合わせます。

ジョブネットモニタウィンドウ

ジョブネットやジョブの実行状況や実行の詳細結果を表示したり，ジョブネットやジョブを操作したりするウィンドウです。

ジョブネットワーク要素

ジョブネットワークを定義するための要素です。これらの要素を総称して「ユニット」とも呼びます。

処理サイクル

ジョブネットの実行開始日から，次の実行開始日までの間隔のことです。処理サイクルを定義しておくと，定期的にジョブネットを実行できます。

スケジューラーサービス

ジョブネットを実行するスケジュールを管理し，スケジュールに従って，処理を実行します。スケジューラーサービスは，スケジューラーサービス名と同じ名称のルートジョブグループ配下のユニットを管理します。

スケジューラーサービスは，一つのマネージャーで複数起動できます。スケジューラーサービスを複数起動すると，スケジューラーサービスごとにルートジョブグループを管理できるようになります。例えば，スケジューラーサービスを業務ごとに分けて起動すると，それぞれのスケジューラーサービスが，ほかのスケジューラーサービスの影響を受けることなく，独立して業務（ジョブネットおよびジョブ）を並行実行できます。

スケジュールルール

ジョブネットの実行開始日時や処理サイクルなどの情報です。一つのジョブネットに144個までスケジュールルールを定義できます。

正常終了

ジョブネットの正常終了は，ジョブネットに定義した処理がすべて正しく実行されて，ジョブネットが終了することです。

ジョブの正常終了は，ジョブが正しく実行されて終了することです。

先行ジョブ

あるジョブ，またはジョブネットの直前に実行されるジョブのことです。

先行ジョブネット

あるジョブ，またはジョブネットの直前に実行されるジョブネットのことです。

相関識別子

ユーザーが任意の目的で使用できるメッセージ中の項目です。メッセージ識別子と同じように，メッセージを識別するために使用します。相関識別子は，送信元が設定した文字コードで格納されています。

相互関係

送受信するメッセージを識別するために使用する情報です。相互関係は，送信元が設定した文字コードで受信されます。

即時実行登録

実行登録と同時にジョブネットを起動し，処理を開始する場合の実行登録方法です。

（タ行）

退避ファイル

JP1/AJS2で定義したジョブネットワーク要素を格納したファイルです。

退避ボックス

退避ファイルを格納するためのディレクトリまたはフォルダです。

デイリースケジュールウィンドウ

1日ごとの実行予定，実行状況，および実行結果を表示するためのウィンドウです。

デフォルトキュー

ジョブを実行するために，エージェントホストと対で作成するキューです。このキューは必ず作成しておく必要があります。

ジョブを実行する際，ジョブのサブミット先や実行先としてエージェントホスト名を指定すると，ジョブはそのエージェントホストのデフォルトキューにサブミットされます。

（ナ行）

ネストジョブネット

ジョブネット中に定義したジョブネットです。

（ハ行）

排他実行リソース

複数のジョブの同時実行を抑止したい場合に，おのおののジョブで同じリソース名（排他実行リソース名）を指定しておき，同時実行を抑止することです。

判定ジョブ

指定された条件を判定し，判定結果が真であれば，従属ジョブ（ジョブネット）を実行するジョブです。

判定値

ジョブが正常終了したか異常終了したかを判断するための値です。

標準ジョブ

標準ジョブとは，実行ファイルや実行先ホスト名などを指定して処理を実行させるジョブのことです。標準ジョブには次の3種類があります。

UNIXジョブ

PCジョブ

QUEUEジョブ

物理ホスト

クラスタシステムを構成する各サーバに固有な環境のことです。物理ホストの環境は，系切り替え時にもほかのサーバに引き継がれません。

プランニンググループ

複数のルートジョブネットを計画的に切り替えて実行するためのユニットです。プランニンググループの直下に異なる定義内容のルートジョブネットを複数作成し，それぞれに異なったスケジュールを定義することで，指定したスケジュールに従って自動的にジョブネットを切り替えて実行できます。

振り替え

スケジュールに従って決められた次回実行予定日が休業日だった場合に，ほかの日にジョブネットを実行させることです。

振り替え猶予日数

振り替え日が休業日の場合に，振り替え日を探す期間を日数で定義したもののことです。

閉塞状態

障害の発生などによってジョブネットが開始または終了できず，実行状況や次回実行予定が確認できない状態になっていることです。この場合，実行登録を解除して，登録し直す必要があります。

ホストリンクジョブネット

メインフレームのジョブスケジューラーで管理されているジョブネットをJP1/AJS2で監視するために，JP1/AJS2で定義するジョブネットです。ホストリンクジョブネットは，JP1/AJS2 for Mainframeの「ネットグループ」という管理単位を介して，メインフレームのジョブネットと関連づけられます。

（マ行）

マクロ変数

後続ジョブでイベント受信情報を参照するために定義する変数です。イベントジョブに情報を引き継ぐためのマクロ変数名を定義し，引き継ぐイベントのマクロ変数を後続ジョブで指定します。

マクロ変数は「?AJS2xxxxxxxxx?:引き継ぎ情報名」の形式で指定します。

マネージャージョブグループ

JP1/AJS2 - Managerから，別のJP1/AJS2 - Managerの業務を監視するためのジョブグループです。

マネージャージョブネット

JP1/AJS2 - Managerから，別のJP1/AJS2 - Managerの業務を監視するためのジョブネットです。

マネージャーホスト

マネージャーホストは，ジョブネットの定義情報やスケジュール情報をデータベースで管理し，ジョブの実行をエージェントホストに依頼して実行させます。マネージャーホストには，JP1/AJS2 - Managerをインストールします。

マネージャーホストでは，定義されたスケジュール情報を基に，ジョブネットの実行予定が作成されます。実行開始時刻になると，マネージャーホストは，ジョブとして定義された実行ファイルを起動して，ジョブ定義情報をエージェントホストに転送し，エージェントホストにジョブを実行させます。実行が終わると，エージェントホストでのジョブの実行結果を受け取り，データベースに反映します。その反映された情報を基に，後続ジョブを実行したり，次回の実行予定を作成したりします。

マンスリースケジュールウィンドウ

1か月ごとの実行予定や実行結果を表示するためのウィンドウです。

メール受信パラメーターファイル

ユーザーが設定したメール受信監視パラメーターを記録したファイルです。拡張子は，「.prm」です。このファイルは，ユーザーがメール受信イベントジョブを定義したときに自動的に作成されます。

メール送信パラメーターファイル

ユーザーが設定したメール送信パラメーターを記録したファイルです。拡張子は，「.prm」です。このファイルは，ユーザーがメール送信アクションジョブを定義したときに自動的に作成されます。

メールフィルターアプリケーション

メールの形式を変換するためのプログラムまたはシェルスクリプトです。

メール連携でRFC822形式以外のメールを使うには，文字コードを変換するためのメールフィルターアプリケーションが必要です。

メッセージキュー

アプリケーションプログラムからのメッセージを登録しておくファイルのことです。メッセージキューマネージャーによって管理されます。メッセージキューには，受信したメッセージを格納する入力キューと，ほかのシステムへ送信するメッセージを格納する出力キューがあります。また，入力キューと出力キューは同一キューを使用することもできます。

メッセージキューイング機能

メッセージキューマネージャーの機能で，アプリケーションプログラム間のメッセージ送受信をメッセージキューと呼ばれるキューを使用して処理することです。アプリケーションプログラムは，メッセージキューに対して送信または受信の処理をします。メッセージがメッセージキューに登録されたあとは，メッセージキューマネージャーがメッセージの処理をするためアプリケーションプログラムの負荷が軽くなります。また，相手側プログラムが受信したことを自アプリケーション側で待つ必要がないため，プログラム間の非同期処理を実行することができます。

メッセージ識別子

MQSeriesのメッセージ記述子という情報の中の1項目です。メッセージ識別子は，送信元が設定した文字コードで格納されています。メッセージ識別子は，メッセージを特定するためのメッセージIDなどを設定しておくところとして利用されます。

（ヤ行）

ユーザー共通プロファイル

JP1ユーザーが共通に使用できるように，JP1/AJS2 - Viewの環境設定情報を保存したファイルです。管理者は，ユーザー共通プロファイルをJP1/AJS2 - Managerに保存しておき，必要に応じて，JP1ユーザーがこのファイルをダウンロードすることで，JP1/AJS2 - Viewの環境をJP1ユーザー間で共通の設定にすることができます。

多くのJP1ユーザーに同じ環境でJP1/AJS2 - Viewを使わせたい場合に役に立ちます。

ユニット

ジョブネットワーク要素の総称です。

ユニットID

一つのユニットに対して一つ割り振られる番号です。

ユニット定義パラメーターファイル

ユニット定義パラメーターを格納したテキストファイルです。コマンドでジョブネットワーク要素を定義する場合の入力情報になります。

予定情報ファイル

予定情報パラメーターを格納したテキストファイルです。コマンドでジョブネットを確定実行登録する場合の入力情報になります。

（ラ行）

リカバリージョブ

先行するジョブ，またはジョブネットが異常終了したときに実行されるジョブです。

リカバリージョブネット

先行するジョブ，またはジョブネットが異常終了したときに実行されるジョブネットです。

リストファイル

送受信したメールの内容の抜粋をリスト形式で記録したファイルです。

論理ホスト

クラスタシステムでの運用時にJP1の実行環境となる論理上のサーバのことです。障害の発生時には，論理ホスト単位で系が切り替わります。

論理ホストは専用のIPアドレスを持ち，系切り替え時にはそのIPアドレスを引き継いで動作します。そのため，障害で物理的なサーバが切り替わった場合も，クライアントからは同じIPアドレスでアクセスでき，一つのサーバが常に動作しているように見えます。

索引

[記号]
[数字]
[Ａ][Ｂ][Ｃ][Ｄ][Ｅ][Ｆ][Ｇ][Ｈ][Ｉ][Ｊ][Ｌ][Ｍ][Ｎ][Ｏ][Ｐ][Ｑ][Ｒ][Ｓ][Ｔ][Ｕ][Ｖ][Ｗ]
[ア行][カ行][サ行][タ行][ナ行][ハ行][マ行][ヤ行][ラ行]

(記号)

_AgentStartStopResolveMode

_AgentStartStopResolveMode

”（ダブルクォーテーションマーク）を含むデータをイベントジョブの引き継ぎ情報に使用するための設定（UNIXホストの場合）

”（ダブルクォーテーションマーク）を含むデータをイベントジョブの引き継ぎ情報に使用するための設定（Windowsホストの場合）

(数字)

07-00の変更内容

07-10の変更内容

07-11の変更内容

07-50の変更内容

08-00の変更内容

08-10の変更内容

08-50の変更内容

2ギガバイト以上のファイルを監視・判定するための設定（UNIXホストの場合）

(英字)

(Ａ)

AfterForkPipeTimeout

AfterForkPipeTimeout

AfterForkPipeTimeout

AIXの場合のアンインストール

AIXの場合のインストール

ajs_adapter_setup

ajs2ca.conf

ajs2ca.conf

ajs2cm.conf

ajs2cm.conf

AJS2ユニット監視オブジェクト

AJSBKUROOT

ajscasetup（Windows限定）

AJSCHARCODE

AJSCHK_CHARCODE

AJSCHK_CHARCODE

AJSCHK_CHECKFILE

AJSCHK_CHECKFILE

AJSCHK_LOGDIR

AJSCHK_LOGDIR

AJSCHK_LOGSIZE

AJSCHK_LOGSIZE

AJSCHK_TRACELOGFILE

AJSCHK_TRACELOGFILE

ajschksetup

ajscmsetup（Windows限定）

AJSCONF

ajscvsetup

AJSDBDIRECTORY

AJSDBTYPE

ajsembdbbuild

ajsembdbidlist

ajsembdbrpsetup

ajsembdbsetup

ajsembdbunset

ajsembdbvrupd

AJSINETDLOGSIZE

AJSLOG

AJSLOGFILE1

AJSLOGFILE2

AJSLOGOUTPUTEXTEND

AJSLOGOUTPUTYEAR

AJSMANAGERHOST

ajsovsetup

AJSPATH

AJSPATH

AJSPRINTNETSCHPRF

AJSQL_AGTWORKPATH

AJSQL_ATTACH

AJSQL_CHARCODE

AJSQL_CJOBMAX

AJSQL_CJOBMAX

AJSQL_CJOBMAX

AJSQL_CJOBWAITMAX

AJSQL_CJOBWAITMAX

AJSQL_CJOBWAITMAX

AJSQL_CLUSTERREQ

AJSQL_CLUSTERREQ

AJSQL_CONNECTCOUNT

AJSQL_CONNECTINT

AJSQL_CONNECTTIMEOUT

AJSQL_CREATEWINDOWSTATION

AJSQL_CREATEWINDOWSTATION

AJSQL_CREATEWINDOWSTATION

AJSQL_EXECCURRENTSCRIPT

AJSQL_EXECLOG

AJSQL_EXECLOG_AGTPATH

AJSQL_EXECLOG_FTPPATH

AJSQL_GETPASSWD_AGTRETRYCOUNT

AJSQL_GETPASSWD_AGTRETRYCOUNT

AJSQL_GETPASSWD_AGTRETRYINTERVAL

AJSQL_GETPASSWD_AGTRETRYINTERVAL

AJSQL_GETPASSWD_FTPRETRYCOUNT

AJSQL_GETPASSWD_FTPRETRYCOUNT

AJSQL_GETPASSWD_FTPRETRYINTERVAL

AJSQL_GETPASSWD_FTPRETRYINTERVAL

AJSQL_JOBMAX

AJSQL_JOBWAITMAX

AJSQL_LOADUSERPROFILE

AJSQL_LOADUSERPROFILE

AJSQL_LOADUSERPROFILE

AJSQL_LOGFILE

AJSQL_LOGSIZE

AJSQL_NOATTACHREQ

AJSQL_STATFILE

AJSQL_STATSIZE

AJSQL_TRACELOGFILE

AJSQL_VARDQUOTEADD

ajsqlsetup

AJSSERVICEID

ajssetup

ajssosetup

AJSSYSLOG

AJSTMPDIR

ajswoarelsetup

AlartContentJob

AUTHLOG

AUTHSYSLOG

AutoCreate

AutoCreateExecJobs

AutoCreateExecJobs

AutoCreateExecJobs

AutoCreateMaxJobs

AutoCreateMaxJobs

AutoCreateMaxJobs

AutoCreatePriority

AutoCreatePriority

AutoCreatePriority

AutoCreateWarnJobs

AutoCreateWarnJobs

AutoCreateWarnJobs

AUTORESTARTCOUNT

AUTOSTART

(Ｂ)

BACKGROUNDLEAVE

(Ｃ)

CHARCODE

CHARCODE

ColdStartMode

COMMANDEVENT

CommunicateRetryCount

CommunicateRetryCount

CommunicateRetryInterval

CommunicateRetryInterval

CommunicateTimeout

CommunicateTimeout

CommunicateTimeout

CommunicateTimeout

CONDEXECDEFER

ConnectTimeout

ConnectTimeout

(Ｄ)

DatabasePath

DATADIRECTORY

DATADIRECTORY

DB管理者

DEFAULTSERVICENAME

DeleteFlashOption

DeleteFlashOption

DeleteFlashOption

DISABLE_FS_REDIRECTION

DISABLE_FS_REDIRECTION

DISABLE_FS_REDIRECTION

DISABLE_FS_REDIRECTION

DISABLE_FS_REDIRECTION

DISABLE_FS_REDIRECTION

DNSEstablish

DNSEstablish

(Ｅ)

ENABLE_LONG_EXT

ENABLEOPERATION

ENABLEOPERATION

EnumJobSaveMemory

EnumJobSaveMemory

EnumJobSaveMemory

EVAction.conf・JP1/AJS2 - Agent

EVAction.conf・JP1/AJS2 - Manager

EVENTRETRY

EventSequential

EventSequential

EvJobExecContinue

EvJobExecContinue

EvJobExecContinue

EvjobInfFile

EvjobInfFile

EVProcessHA

EVProcessHA

EXECDEFER

ExecutingJobRecoveryTime

ExecutingJobRecoveryTime

ExecutingJobRecoveryTime

(Ｆ)

FGRECONLMT

FGRECONLMT

FGRECONLMT

FileAccessPermissionMode

FileAccessPermissionMode

FileAccessPermissionMode

FilewatchinfContinue

FilewatchinfContinue

FilewatchinfContinue

FileWriteMode

FileWriteMode

FileWriteMode

FixedHostnameForAgent

FixedHostnameForAgent

FlashOption

(Ｇ)

GetPasswd_RetryCount

GetPasswd_RetryCount

GetPasswd_RetryCount

GetPasswd_RetryInterval

GetPasswd_RetryInterval

GetPasswd_RetryInterval

GWMAXCONNECTION

GWMAXCONNECTION

GWPROCESSHA

GWPROCESSHA

GWRESTARTCOUNT

GWRESTARTCOUNT

(Ｈ)

HIDEOTHERLHOST

HITSENSER Data Mart Server

HNTRLOGLEVEL

HNTRLOGLEVEL

HNTRLOGLEVEL

HNTRLOGLEVEL

HNTRLOGLEVEL

HowUseInfWhenHA

HowUseInfWhenHA

HP-UXの場合のアンインストール

HP-UXの場合のインストール

hp OpenView

(Ｉ)

INFOLOG

InformationWhenShutDown

InformationWhenShutDown

INHERITCONDHOLD

IPC_CONNECTTIMEOUT

IPC_CONNECTTIMEOUT

IPC_LOCALTIMEOUT

IPC_TIMEOUT

IPC_TIMEOUT

IPC_TIMEOUT

IPCRETRYCOUNT

IPCRETRYCOUNT

IPCRETRYCOUNT

IPCRETRYINTERVAL

IPCRETRYINTERVAL

IPCRETRYINTERVAL

IsAccessTokenCache

IsAccessTokenCache

IsAccessTokenCache

ISAMWRITEMODE

ISAMの設定

ISAMファイル自動再編成機能の設定（UNIXホストの場合）

ISAMファイル自動再編成機能の設定（Windowsホストの場合）

IsCacheCmdSearchPath

IsCacheCmdSearchPath

IsExecFindExecutable

IsExecFindExecutable

IsExecFindExecutable

IsHA

IsHA

IsHA

IsHA

IsHA

IsHA

IsLimitCoreSize

IsLimitCoreSize

IsLimitCpuTime

IsLimitCpuTime

IsLimitDataSize

IsLimitDataSize

IsLimitFileSize

IsLimitFileSize

IsLimitMemorySize

IsLimitMemorySize

IsLimitNoFile

IsLimitNoFile

IsLimitStackSize

IsLimitStackSize

IsLimitWorkSize

IsLimitWorkSize

IsSigchldDefault

IsSigchldDefault

IsSigchldDefault

IsUseWorkPath

IsUseWorkPath

(Ｊ)

JOBDELAYWARNMSG

JOBEXECIPCBUFSIZE

JOBINFDIR

JOBLOG

JOBSTATUSPORT

JOBSYSLOG

JP1_AJS_Admin

JP1_AJS_Admin

JP1_AJS_Editor

JP1_AJS_Editor

JP1_AJS_Guest

JP1_AJS_Guest

JP1_AJS_Manager

JP1_AJS_Manager

JP1_AJS_Operator

JP1_AJS_Operator

JP1_HOSTNAME

JP1_JPQ_Admin

JP1_JPQ_Admin

JP1_JPQ_Operator

JP1_JPQ_Operator

JP1_JPQ_User

JP1_JPQ_User

JP1_USERNAME

JP1/AJS2 - Agentのセットアップ（UNIXホストの場合）

JP1/AJS2 - Agentのセットアップ（Windowsホストの場合）

JP1/AJS2 - Definition Assistant

JP1/AJS2 - Manager起動時の自動起動

JP1/AJS2 - Managerの運用方法をサブミットジョブの登録や操作に限定するときの設定（UNIXホストの場合）

JP1/AJS2 - Managerの運用方法をサブミットジョブの登録や操作に限定するときの設定（Windowsホストの場合）

JP1/AJS2 - Managerのセットアップ（UNIXホストの場合）

JP1/AJS2 - Managerのセットアップ（Windowsホストの場合）

JP1/AJS2 - Print Option

JP1/AJS2 - Viewで必要なセットアップ（Windowsホストの場合）

JP1/AJS2 - Viewの環境設定（Windowsホストの場合）

JP1/AJS2 - Web Operation Assistant

JP1/AJS2 Check Managerサービス，JP1/AJS2 Check Agentサービスの自動起動および自動終了を設定する

JP1/AJS2 Check Managerサービス，JP1/AJS2 Check Agentサービスの自動起動を設定する

JP1/AJS2 Check Managerサービス，JP1/AJS2 Check Agentサービスの自動終了を設定する

JP1/AJS2 Console Agent

JP1/AJS2 Console Agent環境設定ファイル

JP1/AJS2 Console Agent環境設定ファイル

JP1/AJS2 Console Agent環境の設定（UNIXホストの場合）

JP1/AJS2 Console Agent環境の設定（Windowsホストの場合）

JP1/AJS2 Console Agentサービスの自動起動および自動終了を設定する

JP1/AJS2 Console Agentサービスの自動起動を設定する

JP1/AJS2 Console Agentサービスの自動終了を設定する

JP1/AJS2 Console Agentの環境設定パラメーターの定義内容（UNIXホストの場合）

JP1/AJS2 Console Agentの環境設定パラメーターの定義内容（Windowsホストの場合）

JP1/AJS2 Console Agentのセットアップ（UNIXホストの場合）

JP1/AJS2 Console Agentのセットアップ（Windowsホストの場合）

JP1/AJS2 Console Manager

JP1/AJS2 Console Manager環境設定ファイル

JP1/AJS2 Console Manager環境設定ファイル

JP1/AJS2 Console Manager環境の設定（UNIXホストの場合）

JP1/AJS2 Console Manager環境の設定（Windowsホストの場合）

JP1/AJS2 Console Managerサービスの自動起動および自動終了を設定する

JP1/AJS2 Console Managerサービスの自動起動用スクリプトの設定

JP1/AJS2 Console Managerサービスの自動終了用スクリプトの設定

JP1/AJS2 Console Managerの環境設定パラメーターの定義内容（UNIXホストの場合）

JP1/AJS2 Console Managerの環境設定パラメーターの定義内容（Windowsホストの場合）

JP1/AJS2 Console Managerのセットアップ（UNIXホストの場合）

JP1/AJS2 Console Managerのセットアップ（Windowsホストの場合）

JP1/AJS2 Console View

JP1/AJS2 Console Viewの環境設定を変更する手順（Windowsホストの場合）

JP1/AJS2 Console Viewのセットアップ（Windowsホストの場合）

JP1/AJS2 Console環境の設定（UNIXホストの場合）

JP1/AJS2 Console環境の設定（Windowsホストの場合）

JP1/AJS2 for Enterprise Applications

JP1/AJS2 for Mainframe

JP1/AJS2 for Oracle E-Business Suite

JP1/AJS2 for Web Service

JP1/AJS2 for 活文PDFstaff

JP1/AJS2から起動される子プロセスを，SIGCHLDシグナルを受信する設定（SIG_DFL）に変更する方法

JP1/AJS2起動時にジョブ情報削除処理を抑止する設定

JP1/AJS2起動時にジョブ情報削除処理を抑止する設定

JP1/AJS2共通情報の設定（UNIXホストの場合）

JP1/AJS2サービス（JP1/AJS2 - Agent）の自動起動を設定する（UNIX限定）

JP1/AJS2サービス（JP1/AJS2 - Agent）の自動終了を設定する（UNIX限定）

JP1/AJS2サービス（JP1/AJS2 - Manager）の自動起動を設定する（UNIX限定）

JP1/AJS2サービス（JP1/AJS2 - Manager）の自動終了を設定する（UNIX限定）

JP1/AJS2サービスの自動起動および自動終了の設定（UNIXホストの場合）

JP1/AJS2シリーズのプログラム

JP1/AJS2シリーズのプログラム

JP1/AJS2シリーズプログラムが動作するOS一覧

JP1/AJS2シリーズプログラムが動作するOS一覧

JP1/AJS2定義内容の事前チェック機能の設定

JP1/AJS2定義内容の事前チェック機能の設定（UNIXホストの場合）

JP1/AJS2のコマンド実行時に使用される環境変数

JP1/AJS2の自動起動時にJP1/AJS2のプロセスの状態を出力する

JP1/Base

JP1/Baseのインストール

JP1/Cm2

JP1/FTP

JP1/IM

JP1/NETM/DM

JP1/NETM/DMを使ったリモートインストール（UNIXホストの場合）

JP1/NETM/DMを使ったリモートインストール（Windowsホストの場合）

JP1/NQSEXEC

JP1/OJE for Midrange Computer

JP1/OJE for VOS1

JP1/OJE for VOS3

JP1/OJE for VOSK

JP1/Power Monitor

JP1/Script

jp1ajs2_setup_cluster（UNIX限定）

jp1ajs2_setup（UNIX限定）

jp1ajs2casetup（UNIX限定）

jp1ajs2cmsetup（UNIX限定）

JP1イベント

JP1権限レベル

JP1権限レベル

JP1権限レベル

JP1権限レベルを設定する（UNIXホストのJP1/AJS2 - Manager）

JP1権限レベルを設定する（WindowsホストのJP1/AJS2 - Manager）

JP1資源グループ

JP1ユーザー

JP1ユーザー仮定機能（UNIXホストの場合）

JP1ユーザー仮定機能（Windowsホストの場合）

JP1ユーザーを登録する（UNIXホストのJP1/AJS2 - Manager）

JP1ユーザーを登録する（WindowsホストのJP1/AJS2 - Manager）

jpomailrecv（UNIX限定）

jpqexport

jpqimport

jpqregguestuser

jpqreguser

(Ｌ)

LANG

LARGEFILEUSE

LeastRecentlyUsed

LeastRecentlyUsed

LeastRecentlyUsed

LimitCoreSize

LimitCoreSize

LimitCpuTime

LimitCpuTime

LimitDataSize

LimitDataSize

LimitFileSize

LimitFileSize

LimitMemorySize

LimitMemorySize

LimitNoFile

LimitNoFile

LimitReceiveFileSize

LimitReceiveFileSize

LimitReceiveFileSize

LimitStackSize

LimitStackSize

LimitWorkSize

LimitWorkSize

Linuxの場合のアンインストール

Linuxの場合のインストール

LoadUserProfile

LoadUserProfile

LoadUserProfile

LOGDLOG

LOGDSYSLOG

LOGHEADER

LOGINFOALL

LogonUserRetryCount

LogonUserRetryInterval

LOGSIZE

(Ｍ)

MACROCHANGEFAIL

MACROCHANGEFAIL

MacroOptionReplaceMode

MacroOptionReplaceMode

MacroOptionReplaceMode

MacroOptionReplaceMode

MacVarDQuotation

MacVarDQuotation

MAPI

MASTERDABEND

MaximumAgent

MaximumContentJob

MaximumExecJobLogInterval

MaximumExecJobLogInterval

MaximumExecJobLogInterval

MaximumExecJobLogOption

MaximumExecJobLogOption

MaximumExecJobLogOption

MaximumQueue

MaximumResource

MAXSAVEGEN

MAXSESSION

MAXSESSION

MAXSESSION

MAXSESSION

MAXSESSION

MergeEnvMode

MergeEnvMode

MergeEnvMode

MFPOLLINTERVAL

MFUSERNAME

MIME

MONITORINGINVALIDHOLD

MONLOG

MONSYSLOG

MQSeries

MQ文字列

MSMQ

(Ｎ)

NETLOG

NETSYSLOG

NONRELOADHOLDING

NotfyJobStateCount

NotfyJobStateCount

NotfyJobStateCount

NotfyJobStateCount

NotfyJobStateInterval

NotfyJobStateInterval

NotfyJobStateInterval

NotfyJobStateInterval

(Ｏ)

ObserveInterval

OPELOG

Oracleデータベースの移行

OVERSCHEDULE

(Ｐ)

PipeComTimeout

PipeComTimeout

PipeComTimeout

PreserveMinute

PreserveMinute

PreserveMinute

PreserveTerm

PreventChangegJobOrder

PreventChangeJobOrder

PreventChangeJobOrder

(Ｑ)

QLMANCHARCODE

Queue.conf・JP1/AJS2 - Agent

Queue.conf・JP1/AJS2 - Manager

Queueless.conf

QUEUELESSMULTIREQ

QueuingJobRecoveryTime

QueuingJobRecoveryTime

QueuingJobRecoveryTime

(Ｒ)

RDBAUTHID

RDBCHECKINTERVAL

RDBCONNECTWAITTIME

RDBHOST

RDBIPC

RDBPASSWORD

RDBPORT

RDBRECVMEMSIZE

RDBSENDMEMSIZE

RDBUSER

RDBアクセスユーザー

RDB接続先ホスト

RDB接続ポート番号

RDB接続待ち合わせ機能

RDB認可識別子

RDBの設定

ReceiveFileOption

ReceiveFileOption

ReceiveFileOption

ReceiveFileSizeStatus

ReceiveFileSizeStatus

ReceiveFileSizeStatus

RECONNECTINTERVAL

RECONNECTINTERVAL

RecvTimeout

RecvTimeout

REFLOG

REMNETSERVICENAME

REQDAGTRECONNECTTIMEOUT

REQDAGTREQCONNECTTIMEOUT

RESTARTCLRTIME

RetryAgtStartNotification

RetryAgtStartNotification

RJCUSE

RJCUSE

RJCUSE

ROOTJOBNETSCHEDULERANGE

(Ｓ)

Schedule.conf

SESSIONTIMEOUT

SESSIONTIMEOUT

SESSIONTIMEOUT

SMTP

Solarisの場合のアンインストール

Solarisの場合のインストール

StandardTime

STARTMODE

StartUpDelete

StartUpDelete

StartUpDelete

SUBMITRETRYINTERVAL

SUP

SUPPRESS

SYSLOGCODE

SYSLOGCODE

SYSLOGCODE

SYSLOGJOBMSG

(Ｔ)

TABLENAMEPOSTFIX

TABLENAMEPREFIX

TCP/IP通信接続エラーのリトライ間隔・回数の変更（UNIXホストの場合）

TCP/IP通信接続エラーのリトライ間隔・回数の変更（Windowsホストの場合）

TP1/LiNK

TP1/Message Queue

TP1/Server Base

TRACELOGFILE

TRACELOGFILE

TRACELOGFILE

TRACELOGFILE

TRACELOGFILE

TZ

(Ｕ)

UNITDEFINERELOAD

(Ｖ)

VIEWSTATUSRANGE

Viewの状態取得範囲

Viewのスケジューラーサービス表示

VRSHIFT_IMMINT

VRSHIFT_INTRERUN

(Ｗ)

WaitInfFileOutDir

WaitInfFileOutDir

WaitInfFileOutDir

WARMSTARTMSG

Windows Messaging機能

WorkPath

WorkPath

WorkPath

WOW64環境でジョブを実行する際にファイルシステムリダイレクトを無効にする設定

(ア行)

(あ)

アクションジョブ

アンインストール（AIXの場合）

アンインストール（HP-UXの場合）

アンインストール（Linuxの場合）

アンインストール（Solarisの場合）

アンインストール（Windowsホストの場合）

アンインストール（組み込みDB）

アンロードレス運用

アンロードレス運用

アンロードログ運用

アンロードログ運用

(い)

異常終了

異常終了しきい値

一時ファイル用ディレクトリ名

イベント

イベント・アクション定義ファイル（JP1/AJS2 - Agent）

イベント・アクション定義ファイル（JP1/AJS2 - Agent）の環境設定パラメーターの定義内容

イベント・アクション定義ファイル（JP1/AJS2 - Manager）

イベント・アクション定義ファイル（JP1/AJS2 - Manager）の環境設定パラメーターの定義内容

［イベント起動］タブ（［エージェント環境設定］ダイアログボックス）

［イベント起動］タブ（［マネージャー環境設定］ダイアログボックス）

イベント起動に関する環境の設定（UNIXホストの場合）

イベント起動の設定（Windowsホストの場合）

イベント順序保証オプションの設定（UNIXホストの場合）

イベント順序保証オプションの設定（Windowsホストの場合）

イベントジョブ

イベント・ジョブ情報引継ぎディレクトリ名

イベント・ジョブ情報引継ぎディレクトリ名

イベントジョブのログサイズの設定の変更（UNIXホストの場合）

イベントジョブのログサイズの設定の変更（Windowsホストの場合）

イベントジョブを使用したDNS運用時にFQDN形式で運用する

イベントジョブを使用したDNS運用時にFQDN形式で運用する（UNIXホストの場合）

インストール（AIXの場合）

インストール（HP-UXの場合）

インストール（Linuxの場合）

インストール（Solarisの場合）

インストール（新規）（Windowsホストの場合）

インストール（バージョンアップ）（Windowsホストの場合）

インストール時の注意事項（UNIXホストの場合）

インストール時の注意事項（Windowsホストの場合）

(う)

打ち切り時間

上書きインストール（UNIXホストの場合）

上書きインストール（Windowsホストの場合）

運用日

(え)

［エージェント環境設定］ダイアログボックス

［エージェント環境設定］ダイアログボックス

［エージェント環境設定］ダイアログボックス

エージェント監視インターバル

エージェント自動定義機能で作成されるキュー属性値をカスタマイズする設定（Windowsホストの場合）

エージェント自動定義機能で作成されるキュー属性値をカスタマイズする設定（UNIXホストの場合）

エージェントの最大定義数

エージェントの障害回復待ち時間を短縮する設定方法（UNIXホストの場合）

エージェントの障害回復待ち時間を短縮する設定方法（Windowsホストの場合）

エージェントのパイプ通信タイムアウト値の変更（UNIX限定）

エージェントプロセス実行時のワークディレクトリ名

エージェントプロセス実行時のワークディレクトリ名

エージェントプロセスの設定

エージェントホスト

エージェントを自動定義する

(カ行)

(か)

カーネルパラメーター

確定実行登録

確定スケジュール

各バージョンの変更内容

カスタムジョブ

カレンダー情報

環境設定パラメーター

環境設定ファイル

環境変数LANG

環境変数一覧

環境変数ファイルを定義するときの注意事項

環境変数を定義するときの注意事項

完全名

(き)

起算スケジュール

起算猶予日数

基準時刻

基準日

起動条件

起動条件付きジョブネットの保留属性を引き継がない

キュー

キューイングジョブ

休業日

キューの最大定義数

キューレスエージェントサービス，キューレスファイル転送サービスの自動起動および自動終了を設定する

キューレスエージェントサービスの自動起動および自動終了を設定する

キューレスエージェントサービスの自動起動を設定する

キューレスエージェントサービスの自動終了を設定する

キューレスサービス内での最大同時ジョブ実行数（［エージェント環境設定］ダイアログボックス）

キューレスサービス内での最大同時ジョブ実行数（［マネージャー環境設定］ダイアログボックス）

キューレスサービス内での最大待ちジョブ数（［エージェント環境設定］ダイアログボックス）

キューレスサービス内での最大待ちジョブ数（［マネージャー環境設定］ダイアログボックス）

キューレスジョブ

キューレスジョブが戻り値128で異常検出終了となる問題を回避するための設定

キューレスジョブ環境でクラスを指定したジョブを実行するための設定（UNIXホストの場合）

キューレスジョブ環境でクラスを指定したジョブを実行するための設定（Windowsホストの場合）

キューレスジョブ環境でユーザープロファイルを必要とするジョブを実行するための設定（Windows限定）

キューレスジョブ実行環境

キューレスジョブ実行環境設定ファイルの環境設定パラメーターの定義内容

［キューレスジョブ実行環境］タブ（［エージェント環境設定］ダイアログボックス）

［キューレスジョブ実行環境］タブ（［マネージャー環境設定］ダイアログボックス）

キューレスジョブ実行環境の設定（UNIXホストの場合）

キューレスジョブ実行環境の設定（Windowsホストの場合）

キューレスジョブリクエスト多重度

キューレスファイル転送サービスの自動起動および自動終了を設定する

キューレスファイル転送サービスの自動起動を設定する

キューレスファイル転送サービスの自動終了を設定する

強制終了

(く)

組み込みDB稼働環境と運用方法（UNIXホストの場合）

組み込みDB稼働環境と運用方法（Windowsホストの場合）

組み込みDB環境の構築（UNIXホストの場合）

組み込みDB環境の構築（Windowsホストの場合）

組み込みDB管理者

組み込みDBサービス

組み込みDBシステム管理者

組み込みDB操作コマンド

組み込みDBのアンインストールについての注意事項

組み込みDBのアンインストールについての注意事項

組み込みDBのインストール（AIXの場合）

組み込みDBのインストール（HP-UXの場合）

組み込みDBのインストール（Linuxの場合）

組み込みDBのインストール（Solarisの場合）

組み込みDBのインストール（UNIXホストの場合）

組み込みDBのインストール（Windowsホストの場合）

組み込みDBのクラスタソフトへの登録（UNIXホストの場合）

組み込みDBのクラスタソフトへの登録（Windowsホストの場合）

組み込みDBの再セットアップ（UNIXホストの場合）

組み込みDBの再セットアップ（Windowsホストの場合）

組み込みDBの自動起動を設定する

組み込みDBの自動終了を設定する

組み込みDBのセットアップ（UNIXホストの場合）

組み込みDBのセットアップ（Windowsホストの場合）

組み込みDBのセットアップ手順（UNIXホストの場合）

組み込みDBのセットアップ手順（Windowsホストの場合）

組み込みDBへの移行（UNIXホストの場合）

組み込みDBへの移行（Windowsホストの場合）

組み込みDBを上書きインストールする（UNIXホストの場合）

組み込みDBを上書きインストールする（Windowsホストの場合）

組み込みDBを使用する場合の準備（UNIXホストの場合）

組み込みDBを使用する場合の準備（Windowsホストの場合）

組み込みDBを新規にインストールする（UNIXホストの場合）

組み込みDBを新規にインストールする（Windowsホストの場合）

クラスタ運用時のセットアップ手順

クラスタ運用時のセットアップ手順

クラスタ運用の前提

クラスタ構成時の組み込みDBの設定変更（UNIXホストの場合）

クラスタ構成時の組み込みDBの設定変更（Windowsホストの場合）

クラスタ構成時の実行系組み込みDBのセットアップ（UNIXホストの場合）

クラスタ構成時の実行系組み込みDBのセットアップ（Windowsホストの場合）

クラスタ構成時の待機系組み込みDBのセットアップ（UNIXホストの場合）

クラスタ構成時の待機系組み込みDBのセットアップ（Windowsホストの場合）

クラスタシステム

クラスタシステム運用時のインストールとセットアップ（Windowsホストの場合）

クラスタシステムの環境設定の項目

クラスタシステムの環境設定の項目

クラスタシステムの環境設定の手順

クラスタシステムの環境設定の手順

繰り越し方法

(け)

計画実行登録

系切り替えシステム

系切り替え時の情報の引き継ぎ

系切り替え時の情報の引き継ぎ

警告終了

警告終了しきい値

言語環境の設定（UNIXホストの場合）

検索パス（転送元ファイル・UNIXホストの場合）

検索パス（転送元ファイル・Windowsホストの場合）

件名

(こ)

後続ジョブ

後続ジョブネット

コールドスタート時のデータベースの初期化

コマンド実行時に使用される環境変数の一覧

コマンドの指定方法

(サ行)

(さ)

サーバリンクジョブ

サービス起動モード

再起動回数をクリアするまでの時間

最大同時セション数

最大待ち合わせ時間

サスペンド

サスペンド機能の設定（UNIXホストの場合）

サスペンド機能の設定（Windowsホストの場合）

サブミット

サブミットジョブ

サブミットジョブの実行順序の入れ替わりを防止する設定（UNIXホストの場合）

サブミットジョブの実行順序の入れ替わりを防止する設定（Windowsホストの場合）

(し)

しきい値

資源グループ

システム内の警告ジョブ数

システム内の最大ジョブ数

システムログ運用（アンロードレス運用）

システムログ運用（アンロードレス運用）

実行ID

シャットダウン時の情報引継ぎ方法

シャットダウン時の情報引継ぎ方法

従属ジョブ

従属ジョブネット

受信用メモリサイズ

詳細プロセス終了時の処理

詳細プロセス終了時の処理

ジョブ

ジョブ・イベントジョブのエラーメッセージをsyslogに出力するための設定

ジョブエラー情報ディレクトリ名

ジョブグループ

ジョブ結果ファイルの二重受信防止の設定（UNIXホストの場合）

ジョブ結果ファイルの二重受信防止の設定（Windowsホストの場合）

ジョブ実行環境

ジョブ実行環境構成定義ファイル（jpqsetup.conf）の定義方法

ジョブ実行環境設定ファイル（JP1/AJS2 - Agent）

ジョブ実行環境設定ファイル（JP1/AJS2 - Agent）の環境設定パラメーターの定義内容

ジョブ実行環境設定ファイル（JP1/AJS2 - Manager）

ジョブ実行環境設定ファイル（JP1/AJS2 - Manager）の環境設定パラメーターの定義内容

［ジョブ実行環境］タブ（［エージェント環境設定］ダイアログボックス）

［ジョブ実行環境］タブ（［マネージャー環境設定］ダイアログボックス）

ジョブ実行環境の設定（UNIXホストの場合）

ジョブ実行環境の設定（Windowsホストの場合）

ジョブ実行環境のリソースを制限する場合の注意事項

ジョブ実行環境のリソースを制限する場合の注意事項

ジョブ実行時にアクセストークンを再利用するための設定（Windowsホストの場合）

ジョブ実行時のワークパスを変数として定義する（UNIXホストの場合）

ジョブ実行時のワークパスを変数として定義する（Windowsホストの場合）

ジョブ実行多重度到達を確認するメッセージを出力する設定（UNIXホストの場合）

ジョブ実行多重度到達を確認するメッセージを出力する設定（Windowsホストの場合）

ジョブ状態通知ポートのサービス名

ジョブ情報削除処理に関する設定（UNIXホストの場合）

ジョブ情報削除処理に関する設定（Windowsの場合）

ジョブ情報削除処理非同期オプションの設定

ジョブ情報削除処理非同期オプションの設定

ジョブ情報削除の基準時刻

ジョブ情報の保存（［エージェント環境設定］ダイアログボックス）

ジョブ情報の保存（［マネージャー環境設定］ダイアログボックス）

ジョブ情報の保存時間の設定

ジョブ情報の保存時間の設定

ジョブ情報保存日数

ジョブ情報列挙時にジョブ実行制御マネージャー（jpqman）のメモリー消費量を少なくする設定（UNIXホストの場合）

ジョブ情報列挙時にジョブ実行制御マネージャー（jpqman）のメモリー消費量を少なくする設定（Windowsホストの場合）

ジョブ多重度

ジョブネット

ジョブネットエディタウィンドウ

ジョブネットコネクタ

ジョブネット定義・実行時のJP1権限レベル

ジョブネット定義・実行時のJP1権限レベル

ジョブネットのスキップ

ジョブネットモニタウィンドウ

ジョブネットログのイベントログ出力

ジョブネットワーク要素

ジョブの結果ファイルの再送間隔・再送回数の変更（UNIXホストの場合）

ジョブの結果ファイルの再送間隔・再送回数の変更（Windowsホストの場合）

ジョブの実行・操作時のJP1権限レベル

ジョブの実行・操作時のJP1権限レベル

ジョブの標準出力と標準エラー出力を同時に確認する（UNIXホストの場合）

ジョブの標準出力と標準エラー出力を同時に確認する（Windowsホストの場合）

ジョブプロセス実行準備完了通知時のタイムアウト値の設定（UNIX限定）

ジョブログのイベントログ出力

ジョブを配信するエージェントホストの決定方式の設定（UNIXホストの場合）

ジョブを配信するエージェントホストの決定方式の設定（Windowsホストの場合）

ジョブをロングファイル名で実行するための設定（WindowsホストのJP1/AJS2 - Manager）

処理サイクル

資料採取ツール（UNIXホストの場合）

資料採取ツール（Windowsホストの場合）

新規インストール後に以前のバージョンの設定に戻す方法（UNIXホストの場合）

新規インストール後に以前のバージョンの設定に戻す方法（Windowsホストの場合）

(す)

［スケジューラーオプション］タブ（［マネージャー環境設定］ダイアログボックス）

スケジューラーサービス

スケジューラーサービス

スケジューラーサービス

スケジューラーサービス

スケジューラーサービス異常時の処理

スケジューラーサービス環境設定パラメーターの定義内容

スケジューラーサービス環境設定ファイル

スケジューラーサービス環境で設定できる環境設定パラメーターの一覧（Windows）

スケジューラーサービス環境の設定（UNIXホストの場合）

スケジューラーサービス環境の設定（Windowsホストの場合）

スケジューラーサービスの再起動回数

スケジューラーサービスの削除手順（UNIXホストの場合）

スケジューラーサービスの削除手順（Windowsホストの場合）

スケジューラーサービスの識別番号

［スケジューラーサービスの制御］タブ（［マネージャー環境設定］ダイアログボックス）

スケジューラーサービスの多重起動の設定（UNIXホストの場合）

スケジューラーサービスの多重起動の設定（Windowsホストの場合）

スケジューラーサービスの多重起動の設定手順（UNIXホストの場合）

スケジューラーサービスの多重起動の設定手順（Windowsホストの場合）

スケジューラーサービスの統合トレースログ出力レベルの変更（UNIXホストの場合）

スケジューラーサービスの統合トレースログ出力レベルの変更（Windowsホストの場合）

スケジューラーサービスログのイベントログ出力

スケジューラーサービスをウォームスタートで起動させたときに，実行中であったジョブまたはジョブネットの終了メッセージ，および終了イベントの出力有無の設定（UNIXホストの場合）

スケジューラーサービスをウォームスタートで起動させたときに，実行中であったジョブまたはジョブネットの終了メッセージ，および終了イベントの出力有無の設定（Windowsホストの場合）

スケジューラートレースログファイルの名称変更（UNIXホストの場合）

スケジューラートレースログファイルの名称変更（Windowsホストの場合）

［スケジューラーファイルの構成2］タブ（［マネージャー環境設定］ダイアログボックス）

［スケジューラーファイルの構成］タブ（［マネージャー環境設定］ダイアログボックス）

スケジューラーログ出力プロセスの開始・終了ログ出力

スケジューラーログとイベントログの出力情報

スケジューラーログの拡張出力

スケジューラーログの情報用ログ出力

［スケジューラーログの設定］タブ（［マネージャー環境設定］ダイアログボックス）

スケジューラーログの年号出力

スケジューラーログのプロセスID出力

スケジューラーログファイル

スケジューラーログファイル1の名称

スケジューラーログファイル2の名称

スケジュールルール

ステータスファイルサイズ（［エージェント環境設定］ダイアログボックス）

ステータスファイルサイズ（［マネージャー環境設定］ダイアログボックス）

ステータスファイル名（［エージェント環境設定］ダイアログボックス）

ステータスファイル名（［マネージャー環境設定］ダイアログボックス）

(せ)

正常終了

切断検知する間隔

セットアップに使用するコマンドの一覧

セットアップの手順（UNIXホストのJP1/AJS2 - Agent）

セットアップの手順（UNIXホストのJP1/AJS2 - Manager）

セットアップの手順（WindowsホストのJP1/AJS2 - Agent）

セットアップの手順（WindowsホストのJP1/AJS2 - Manager）

先行ジョブ

先行ジョブネット

(そ)

相関識別子

相互関係

総称名の指定方法

送信用メモリサイズ

即時実行登録

(タ行)

(た)

待機情報ファイル出力ディレクトリ名

待機情報ファイル出力ディレクトリ名

待機情報ファイル出力ディレクトリ名

退避情報ディレクトリ名

退避ファイル

退避ボックス

(て)

定義する内容と情報引き継ぎの実行（JP1/AJS2 - Agent）

デイリースケジュールウィンドウ

データファイル更新モード

データファイル更新モード

データベース格納ディレクトリ名

データベース種別

データベースディレクトリ名

テーブル名プリフィックス

デフォルトキュー

デフォルトスケジューラーサービス名

転送元ファイルの検索パスを定義する（UNIXホストの場合）

転送元ファイルの検索パスを定義する（Windowsホストの場合）

(と)

登録解除や保存世代数管理による世代削除処理方式の変更（UNIXホストの場合）

登録解除や保存世代数管理による世代削除処理方式の変更（Windowsホストの場合）

トレースログファイルの拡張（UNIXホストの場合）

トレースログファイルの拡張（Windowsホストの場合）

(ナ行)

(に)

認証サーバを指定する（UNIXホストのJP1/AJS2 - Manager）

認証サーバを指定する（WindowsホストのJP1/AJS2 - Manager）

(ね)

ネストジョブネット

ネストジョブネット定義パラメーター出力時のスケジュールルールの出力方法の変更（UNIXホストの場合）

ネストジョブネット定義パラメーター出力時のスケジュールルールの出力方法の変更（Windowsホストの場合）

(ハ行)

(は)

排他実行リソース

排他実行リソースの最大定義数

パスワード

判定ジョブ

判定値

(ひ)

標準ジョブ

(ふ)

ファイルおよびフォルダの変更方法

ファイル監視ジョブの状態引き継ぎオプションの設定（UNIXホストの場合）

ファイル監視ジョブの状態引き継ぎオプションの設定（Windowsホストの場合）

ファイル監視ジョブの情報の引き継ぎ

ファイル監視ジョブの情報の引き継ぎ

ファイル更新モード

ファイル更新モード

ファイル更新モード

ファイル受信制限をするための設定（UNIXホストの場合）

ファイル受信制限をするための設定（Windowsホストの場合）

物理ホスト

プランニンググループ

振り替え

振り替え猶予日数

(へ)

閉塞状態

(ほ)

ホストリンクジョブネット

(マ行)

(ま)

マクロ変数

マクロ変数の展開失敗時の動作の設定（UNIXホストの場合）

マクロ変数の展開失敗時の動作の設定（Windowsホストの場合）

マクロ変数の引き継ぎ情報がNULL文字列の場合の置き換え方法の設定（UNIXホストの場合）

マクロ変数の引き継ぎ情報がNULL文字列の場合の置き換え方法の設定（Windowsホストの場合）

［マネージャー環境設定］ダイアログボックス

［マネージャー環境設定］ダイアログボックス

［マネージャー環境設定］ダイアログボックス

マネージャージョブグループ

マネージャージョブネット

マネージャープロセス実行時のワークディレクトリ名

マネージャープロセスの設定

マネージャーホスト

マンスリースケジュールウィンドウ

(め)

メール受信パラメーターファイル

メール送信パラメーターファイル

メールフィルターアプリケーション

メッセージキュー

メッセージキューイング機能

メッセージ識別子

(も)

文字コード種別

文字コード種別の変更（UNIX限定）

(ヤ行)

(ゆ)

ユーザー共通プロファイル

ユーザー情報取得時のリトライを変更する設定（UNIX限定）

ユーザープロファイルを必要とするジョブを実行するための設定（Windows限定）

ユーザーマッピングを設定する（UNIXホストのJP1/AJS2 - Agent）

ユーザーマッピングを設定する（UNIXホストのJP1/AJS2 - Manager）

ユーザーマッピングを設定する（WindowsホストのJP1/AJS2 - Agent）

ユーザーマッピングを設定する（WindowsホストのJP1/AJS2 - Manager）

ユニット

ユニットID

ユニット定義パラメーターファイル

ユニット定義変更の即時適用

ユニット名の指定方法

(よ)

抑止機能の設定

予定情報ファイル

(ラ行)

(ら)

ラージファイル対応

ラージファイル対応

ラージファイルを監視・判定するための設定（UNIXホストの場合）

(り)

リカバリージョブ

リカバリージョブネット

リストファイル

リモートジョブネットスケジューラーサービス名

(る)

ルートジョブネットのスケジュール

(ろ)

ローカルRDBサーバとの通信方式

ログインスクリプトの変更

ログオン共有セション数

ログオンセションのプロセス起動方法

ログ出力の設定（［エージェント環境設定］ダイアログボックス）

ログ出力の設定（［マネージャー環境設定］ダイアログボックス）

ログ情報の採取方法（UNIXホストの場合）

ログ情報の採取方法（Windowsホストの場合）

ログファイルのサイズ（［エージェント環境設定］ダイアログボックス）

ログファイルのサイズ（［マネージャー環境設定］ダイアログボックス）

ログファイルの設定

ログフォルダ名（［エージェント環境設定］ダイアログボックス）

ログフォルダ名（［マネージャー環境設定］ダイアログボックス）

論理ホスト

［論理ホスト共通］タブ（［マネージャー環境設定］ダイアログボックス）

論理ホストのスケジューラーサービスの多重起動の設定（UNIXホストの場合）

■ 商標類

400は，米国およびその他の国におけるInternational Business Machines Corporationの商標です。
Active Directoryは，米国Microsoft Corporationの，米国およびその他の国における登録商標または商標です。
Adobeは，Adobe Systems Incorporated（アドビシステムズ社）の米国ならびに他の国における商標または登録商標です。
AIXは，米国およびその他の国におけるInternational Business Machines Corporationの商標です。
AS/400は，米国およびその他の国におけるInternational Business Machines Corporationの商標です。
CONNECT：Queueは，米国でのSterling Commerce,Inc.の登録商標です。
GIFは，米国CompuServe Inc.が開発したフォーマットの名称です。
HP NonStop Serverは，ヒューレット・パッカード社の商標です。
HP-UXは，米国Hewlett-Packard Companyのオペレーティングシステムの名称です。
INS-Cは，日本電信電話（株）のサービス名称です。
INS-Pは，日本電信電話（株）のサービス名称です。
Internet Explorerは，米国Microsoft Corporationの米国及びその他の国における登録商標または商標です。
Itaniumは，アメリカ合衆国およびその他の国におけるIntel Corporationの商標です。
Javaは，Oracle Corporation 及びその子会社，関連会社の米国 及びその他の国における登録商標または商標です。
Linuxは，Linus Torvalds氏の日本およびその他の国における登録商標または商標です。
Lotus Notesは，IBM Corporationの登録商標です。
Microsoftは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
Microsoft Excelは，米国Microsoft Corp.の商品名称です。
Microsoft Exchange Serverは，米国Microsoft Corp.の商品名称です。
Microsoft Mailは，米国Microsoft Corp.の商品名称です。
Microsoft Office Excelは，米国 Microsoft Corporation の商品名称です。
Microsoft SQL Serverは，米国Microsoft Corp.の商品名称です。
MQSeriesは，米国およびその他の国におけるInternational Business Machines Corporationの商標です。
MSPは，富士通株式会社の登録商標です。
MVSは，米国およびその他の国におけるInternational Business Machines Corporationの商標です。
Netscapeは，米国およびその他の国におけるNetscape Communications Corporationの登録商標です。
Netscape Navigatorは，米国およびその他の国におけるNetscape Communications Corporationの登録商標です。
OpenViewは，ヒューレット・パッカード社の商標です。
ORACLEは，Oracle Corporation 及びその子会社，関連会社の米国 及びその他の国における登録商標または商標です。
Outlookは，米国およびその他の国における米国Microsoft Corp.の登録商標です。
PA-RISCは，米国Hewlett-Packard Companyの商標です。
Pentiumは，アメリカ合衆国およびその他の国におけるIntel Corporationの商標です。
R/3は，SAP AGのドイツ及びその他の国における登録商標または商標です。
Red Hatは，米国およびその他の国でRed Hat,Inc. の登録商標若しくは商標です。
SAPは，SAP AGのドイツ及びその他の国における登録商標または商標です。
Solarisは，Oracle Corporation 及びその子会社，関連会社の米国 及びその他の国における登録商標または商標です。
SQL*Plusは，Oracle Corporation 及びその子会社，関連会社の米国 及びその他の国における登録商標または商標です。
UNIXは，The Open Groupの米国ならびに他の国における登録商標です。
Windowsは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
Windows Serverは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
Windows Vistaは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
活文，PDFstaffは，日立ソフトウェアエンジニアリング株式会社の登録商標です。
プログラムプロダクト「P-9312-2781」，「P-9312-2981」，「P-9D2C-6L81」には，米国Sun Microsystems, Inc.が著作権を有している部分が含まれています。
プログラムプロダクト「P-9312-2781」，「P-9312-2981」，「P-9D2C-6L81」には，UNIX System Laboratories, Inc.が著作権を有している部分が含まれています。