付録C.1　組み込みDBを使用する場合の準備

• システム共通定義

組み込みDBシステム管理者が設定値を変更できるシステム共通定義のオペランドについて説明します。

システム共通定義ファイルのパス名を次に示します。このファイル中に設定されているオペランドの値を変更してください。

• Windowsの場合：組み込みDB運用ディレクトリ\conf\pdsys

• UNIXの場合：組み込みDB運用ディレクトリ/conf/pdsys

なお，次の表で[　]（角括弧）で囲まれているオペランドは，組み込みDBのセットアップ時点では記載されていません。必要に応じて追記してください。

注意事項

ここで説明していないオペランドの値は変更しないでください。変更した場合，JP1/AJS3が誤動作することがあります。

1）　pd_max_users = 最大同時接続数

〜〈符号なし整数〉((1〜2000))

組み込みDBに対する最大同時接続数を変更する場合に，このオペランドの設定値を変更します。このオペランドには，組み込みDBに対する最大同時接続数を指定します。組み込みDBへの接続要求数がこのオペランドの値を超えると，組み込みDBはそれ以上の接続要求を受け付けません（接続要求はエラーになります）。なお，JP1/AJS3では128を設定しています。

注意事項

• データベースを操作するコマンドを実行した場合，コマンドごとに組み込みDBの接続数を消費するため注意が必要です。

  組み込みDBへの接続数は，次のようにカウントされます。

  JP1/AJS3の動作	接続数のカウント
  JP1/AJS3 - Managerの起動	2
  スケジューラーサービスの起動	4
  ユニットを操作するコマンドの実行	1
  JP1/AJS3 - Viewからの接続	参照したスケジューラーサービス数
  組み込みDBを操作するコマンドの実行	2

  なお，JP1/AJS3 - ViewからJP1/AJS3のコマンドを実行する場合，JP1/AJS3 - Viewから組み込みDBへの接続で1，コマンドの実行で1をそれぞれ消費します。

• pd_max_usersの設定値を500より大きくする場合は，シンクポイントダンプファイルを拡張する必要があります。ajsembdbaddlogコマンドに-s 7，-r spdオプションを指定して3回実行し，シンクポイントダンプファイルを拡張してください。

  ajsembdbaddlogコマンドの指定例を次に示します。

  ajsembdbaddlog -s 7 -r spd -id _JF0 -d 任意のディレクトリ名称

  ajsembdbaddlogコマンドに指定するオプションについては，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス1　2. コマンド　ajsembdbaddlog」を参照してください。

2）　pd_service_port = クライアント接続用ポート番号

〜〈符号なし整数〉((5001〜65535))

組み込みDBサーバ側にファイアウォールが設置されている場合に，クライアント接続用ポート番号を指定します。指定するポート番号の規則を次に示します。

• ホスト内でユニークなポート番号

運用方法

• JP1/AJS3連携製品を使用する場合，必要に応じて設定してください。JP1/AJS3 - Managerではこのオペランドは使用しないので，設定する必要はありません。

• 同一マシン上で複数のサーバ，または複数のユニットを開始する場合は，それぞれの組み込みDBで異なったポート番号を指定してください。

注意事項

OSが自動的に割り当てるポート番号の範囲とは異なる番号を指定してください。OSが自動的に割り当てるポート番号の範囲はOSによって異なります。OSが自動的に割り当てるポート番号の範囲内の番号を指定した場合，その番号はほかのプログラムに使用されているおそれがあります。使用されていた場合，組み込みDBを開始できません。

3）　pd_mode_conf = 組み込みDBの開始方法

組み込みDBの開始方法を指定します。設定値を次に示します。デフォルトは「MANUAL2」です。通常，変更する必要はありません。

• AUTO

  OSを起動したときに自動で組み込みDBを開始します。組み込みDBが異常終了した場合も，自動で再開始します。

• MANUAL1

  OSを起動したときに自動で組み込みDBを開始しません。ただし，組み込みDBが異常終了した場合にかぎり，自動で再開始します。

• MANUAL2

  OSを起動したときに自動で組み込みDBを開始しません。MANUAL1とは異なり，組み込みDBが異常終了した場合でも自動で再開始しません。

4）　pd_utl_exec_time = 組み込みDBを操作するコマンドの実行監視時間

〜〈符号なし整数〉((0〜35791394))《0》（単位：分）

次の組み込みDBを操作するコマンドの実行時間を監視する場合に，その監視時間を分単位で指定します。

• ajsembdbreclaimコマンド

• ajsembdbrorgコマンド

このオペランドで指定した監視時間を超えてもコマンドが終了しない場合は，標準エラー出力にメッセージKAVS2117-Eが出力され，実行中のコマンドが異常終了します。

利点

夜間バッチジョブなどで，コマンドの実行中に何らかの障害（通信障害，ディスク障害など）によってコマンドが無応答状態になった場合に，指定した時間でコマンドを異常終了させることができます。

指定値の目安

このオペランドは無応答障害に対処することが目的であり，データベースのメンテナンス処理時間の監視を目的としていません。したがって，このオペランドの指定値には，コマンド実行時間の実績値の最大値に余裕を持たせた値を指定してください。例えば，ajsembdbreclaimコマンドの最大実行時間が60分程度で，ajsembdbrorgコマンドの最大実行時間が90分程度の場合，pd_utl_exec_timeには余裕を持って120を指定してください。これは，通常90分で終了する処理が30分を過ぎても応答が返ってこないときは無応答障害のおそれがあると判断しています。なお，コマンドの最大実行時間に加算する30分という時間は，1スケジューラーデータベースとエージェント管理用データベースを対象にメンテナンスすることを想定した値です。メンテナンス処理では，ほかのデータベースアクセス（ジョブ実行やユニットを操作するコマンドなどの処理）があった場合，それらの処理の完了に1分間の待ち合わせを行います。そのため，加算する時間は「処理対象のテーブル数＊2＊1」分で見積もった値に余裕を持たせた時間を目安として指定してください。

組み込みDBに作成するテーブルについては，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　2.6.3 JP1/AJS3のデータベーステーブル」を参照してください。

5)　TZ タイムゾーン

〜〈文字列〉

組み込みDB関連のメッセージ（KFPで始まるメッセージ）の日付・時刻情報のタイムゾーンを指定します。デフォルトは「JST-9」です。

このオペランドには，OSのタイムゾーンと同じ値を指定してください。

• シングルサーバ定義

組み込みDBシステム管理者が設定値を変更できるシングルサーバ定義のオペランドについて説明します。シングルサーバ定義ファイルのパス名を次に示します。このファイル中に設定されているオペランドの値を変更してください。

• Windowsの場合：組み込みDB運用ディレクトリ\conf\ajs2

• UNIXの場合：組み込みDB運用ディレクトリ/conf/ajs2

注意事項

ここで説明していないオペランドの値は変更しないでください。変更した場合，JP1/AJS3が誤動作することがあります。

1）　pd_lck_pool_size = 排他制御用プールサイズ

〜〈符号なし整数〉（単位：キロバイト）((1〜2000000))

組み込みDB内の排他制御で使う共有メモリー領域の大きさをキロバイト単位で指定します。

なお，JP1/AJS3では，ajsembdbbuildコマンド，jajs_setupコマンド，またはjajs_setup_clusterコマンドで指定した規模によって，次の表に示す値を設定しています。

規模	コマンドのオプション	排他制御用プールサイズ
大規模	-l	60,000
中規模	-m	37,500
小規模	-s	15,000

運用方法

コマンドやJP1/AJS3 - Viewによってユニットを操作する場合，ユニット数に応じて，排他制御用のメモリー領域が使用されます。そのため，操作対象のユニット数などに応じて，排他制御用のメモリー領域を事前に見積もり，設定する必要があります。

一度に大量のユニットを操作することで排他制御用のメモリー領域が不足した場合，次のような現象が発生します。

• 統合ログ，syslog，またはWindowsイベントログにメッセージKAVS0902-Eおよびその保守情報にメッセージKFPA11912-Eが出力され，操作が異常終了する。

また，排他制御用のメモリー領域が不足したことで，スケジューラーサービスのデータベースアクセスが正常にできない場合，次のような現象が発生することがあります。

• メッセージKAVS0902-Eが出力され，ジョブやジョブネットが正常に実行できない。

• 統合ログ，syslog，またはWindowsイベントログにメッセージKAVS0230-Eが出力され，スケジューラーサービスが異常終了する。

上記の現象が発生する場合，排他制御用のメモリー領域が不足していることがあるため，次の内容を見直してください。

1. ajsdefineコマンドで定義しようとしているユニット定義，またはajsdeleteコマンドやJP1/AJS3 - Viewでユニットを削除しようとしているユニット定義のうち，最上位に定義されるユニットとその配下のユニット総数

2. ajscopyコマンドまたはJP1/AJS3 - Viewでのユニットのコピー操作で，コピー元として指定したユニットとその配下のユニット総数

3. ajsrestoreコマンドまたはJP1/AJS3 - Viewでの回復操作で，回復対象のユニットとその配下のユニット総数

4. ajsreleaseコマンドまたはJP1/AJS3 - Viewでのリリース操作で，リリース元として指定したルートジョブネットとその配下のユニット総数

5. ajsentryコマンドまたはJP1/AJS3 - Viewでの実行登録操作で，指定したルートジョブネットとその配下のユニット総数，または指定したジョブグループ配下に定義されたルートジョブネットとその配下のユニット総数

6. ajsrerunコマンドまたはJP1/AJS3 - Viewでの再実行で，指定したジョブネットとその配下のユニット総数

7. ajssuspendコマンドまたはJP1/AJS3 - Viewでサスペンド解除したルートジョブネットに追加したユニット総数

pd_lck_pool_sizeに指定した値と，次に示す式によって求めた値を比較し，pd_lck_pool_sizeの値が小さい場合は，式で求めた値に変更してください。

式で求めた値の方が小さい場合は，JP1/AJS3として必要なメモリーが不足していることが考えられます。マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　3. 見積もり」を確認し，メモリーの値を見直してください。

• 上記1.，2.，3.，4.の場合

  （a + b + c + d） / 4＊1.2

  a：(ジョブグループの総数＊2) + ジョブグループに定義されているカレンダー定義年数の総数

  b：(ジョブネットの総数＊2) + 全ジョブネットに対して定義されているスケジュールルールの総数

  c：ジョブの総数＊2

  d：ジョブ・ジョブネットに定義された関連線接続数の総数

• 上記5.，6.，7.の場合

  e / 4＊1.2

  e：ジョブ，ジョブネットの総数＊3

計算で使用するジョブネットがジョブネットリリース機能を使用している場合，計算には操作対象のジョブネット定義を使用してください。

注意事項

• このオペランドの指定値を大きい値に変更して，一度にデータベースの規模の目安以上のユニット数を操作すると，イベントログまたはsyslogにメッセージKFPS01220-Eを出力して組み込みDBが異常終了することがあります。そのため，一度に操作するユニット数を少なくするか，より大きい規模の組み込みDB環境の構築を検討してください。

  ユニット数の目安については，「付録B.1 データベース領域の見積もり」を参照してください。

• このオペランドの指定値を大きい値に変更すると，変更した分だけ組み込みDBのメモリー使用量が増加します。そのため，値を変更する場合は事前にメモリーに余裕があることを確認してください。

  また，UNIXの場合で，このオペランドの指定値を大きい値に変更したときはシステムリソースを調整してください。調整が必要なシステムリソースについては，リリースノートを参照してください。

  このオペランドの指定値が小さ過ぎると，JP1/AJS3のアクセスがエラーリターンすることがあります。

• パラメーターの設定値としては，2,000,000まで指定できますが，OSのメモリー管理によって連続した領域が確保できない場合は，組み込みDBの起動に失敗します。その場合は，連続した領域が確保できる値にチューニングしてください。

• システム定義の変更方法

システム定義の変更方法を次に示します。

1. JP1/AJS3サービスを停止する。

2. 操作対象の組み込みDBの起動状態を確認する。

   ajsembdbstatus -s ust -id _JF0※

3. 操作対象の組み込みDBが起動している場合，組み込みDBの正常停止を行う。停止している場合，一度起動してから正常停止を行う。

   組み込みDBを起動する場合

   ajsembdbstart -id _JF0※

   組み込みDBを正常停止する場合

   ajsembdbstop -id _JF0※

4. システム共通定義，またはシングルサーバ定義ファイルをテキストエディターで開く。

   問題が発生した場合に備えて，更新対象となるファイルのバックアップを取得してください。

5. オペランドの値を変更する。

6. 手順5で編集した内容を保存してファイルを閉じる。

7. クラスタ構成の場合は，変更したシステム共通定義，またはシングルサーバ定義ファイルを待機系ホストにコピーする。

8. JP1/AJS3サービスを開始する。

   このとき，組み込みDBも起動されます。

注※

-idオプションには，操作対象となる組み込みDBのセットアップ識別子を指定してください。Windowsで組み込みDBを起動する場合は，事前にJP1/AJS3 Database _JFn（nは0〜9またはA〜Zのどれか）サービスを開始してください。

注意事項

システム共通定義，またはシングルサーバ定義の編集時に，文字やスペースが全角になっていたり，不要な改行やスペースを挿入したりすると，JP1/AJS3サービスの起動に失敗します。