jajs_maintain

形式

jajs_maintain
     [-h 論理ホスト名]
     [-F スケジューラーサービス名]
     {-m {manager|scheduler} | -show | -r start}
     [-x 再編成実施スケジューラーサービスの多重度]
     [-c 切断状況監視時間]

ページの先頭へ

機能

JP1/AJS3のISAMデータベースのメンテナンスを行います。

ページの先頭へ

実行権限

Windowsの場合：Administrators権限

UNIXの場合：スーパーユーザー権限

ページの先頭へ

引数

ページの先頭へ

注意事項

1. ジョブ実行環境をメンテナンスしている間は，ジョブの投入およびジョブの実行に使用するコマンドは実行できません。実行した場合，エラーメッセージKAVU0950-Eが標準エラー出力ファイルに出力されます。

2. 互換用ISAM構成でのマネージャー機能縮退モードおよびスケジューラーサービス縮退モードでのメンテナンスは，スケジューラーサービスを停止するため，スケジューラーサービス間の連携（リモートジョブネット，マネージャージョブネット，イベント連携およびリモートコマンドによるジョブまたはジョブネットの起動）を行っている場合には，このコマンドを実行した際にエラーが発生します。これらの連携機能を使用しない時間帯でメンテナンスを実施してください。

3. スケジューラーサービスのメンテナンス実施中に，JP1/AJS3 - View から接続してユニットを操作した場合は，「KAVV461-E 指定したスケジューラーサービスはメンテナンス中のため接続できません」というメッセージがメッセージボックスに出力されます。

   ユニットを操作するコマンドを実行した場合は，「KAVS1717-E メンテナンス中のため実行できません」というメッセージが標準エラー出力に出力されます。

4. このコマンドを実行すると，メンテナンスログファイルに再編成時のログ情報が格納されます。

   メンテナンス処理が異常終了した場合は，メンテナンスログファイルを参照し，メンテナンス処理が異常終了した原因を取り除いた上で，メンテナンス処理を再実行してください。

   メンテナンスログファイルの格納先は，マニュアル「JP1/Automatic Job Management System 3 トラブルシューティング　1.2.4 ログファイルおよびディレクトリ一覧」の「メンテナンスログファイル」を参照してください。

5. マネージャー機能が縮退中にJP1/AJS3サービスを停止した場合，縮退中に状態が変わったジョブの情報が消失します。縮退中にJP1/AJS3を停止しないでください。

6. JP1/AJS3停止時にマネージャー機能の縮退指定でコマンドを実行した場合，コマンドの終了に時間が掛かるため注意してください。

7. メンテナンスの対象となるスケジューラーサービスが運用中のとき，jajs_maintainコマンドの処理が何らかの原因で打ち切られると，スケジューラーサービスおよびイベント・アクション制御マネージャーの状態が，メンテナンス中のままになることがあります。回復するには，jajs_maintain -r start，ajsstartまたはjajs_spmdコマンドで該当するサービスを起動する必要があります。

   また，同じ条件で，ジョブ実行環境の状態がメンテナンス中のままになることがあります。回復するには，jajs_maintain -r startを実行する，またはJP1/AJS3サービスを再起動してください。

8. このコマンドに次の指定をした場合は，同時に複数実行しないでください。

   • -m manager

   • -m scheduler

   • -r start

9. このコマンドの-m manager指定と，次のコマンドまたはスクリプトを同時に実行しないでください。

   • jpqdbcondコマンドの-x，-k指定

   • jpqautocondスクリプト

10. ジョブ実行環境のコマンドやAPIが終了していない状態で-m manager指定を実行しないでください。

11. ジョブ実行環境のジョブ情報削除処理中に-m manager指定を実行しないでください。

    ジョブ情報削除処理中にマネージャー機能縮退モードでメンテナンスを実行した場合，ジョブ情報削除処理はメンテナンスが完了するまで中断されます。メンテナンスが完了すると，ジョブ情報削除処理が再開されます。

12. JP1/AJS3の起動処理中や停止処理中にjajs_maintain -m managerを実行しないでください。また，jajs_maintain -m manager実行中にJP1/AJS3の起動や停止を行わないでください。

13. このコマンドの-m manager指定とjpqexportコマンドを同時に実行しないでください。

14. このコマンドに次の指定をした場合は，ajsautocondスクリプトを同時に実行しないでください。

    • -m manager

    • -m scheduler

15. JP1/AJS3の起動処理中や停止処理中にjajs_maintain -showまたは-r startを実行した場合，統合ログにメッセージKAVU2227-EやメッセージKAVU0215-EまたはメッセージKAVU0220-Eが出力されることがあります。JP1/AJS3サービスの起動処理および停止処理と競合した場合に出力されるこれらのメッセージについては，実際の運用には問題ありませんが，jajs_maintainコマンドの実行に時間が掛かる場合があります。なお，コマンドが異常終了した場合は再度実行してください。

16. スケジューラーサービスのメンテナンスは，実行しようとしているすべてのジョブの実行依頼が完了してからスケジューラーサービスを停止します。このため，キューレスジョブ実行環境の設定で，最大同時ジョブ実行数の設定が0で，かつ最大待ちジョブ数が1以上になっている場合に，キューレスジョブ起動処理中にメンテナンスモードに入ると，スケジューラーサービスが停止処理に入れないため，jajs_maintainコマンドが終了できない状態になります。jajs_maintainコマンドはジョブを実行できる状態で実行してください。また，このような状態になった場合，ajsqlalterコマンドによって，最大同時ジョブ実行数の設定を 1 以上に変更してジョブを実行させてください。

17. イベントジョブ（起動条件内のものを含む）を実行中のスケジューラーサービスをメンテナンスする場合の注意事項については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（業務設計編）　7.6.8 イベントジョブを実行したままサービスを再起動する場合の注意事項」を参照してください。

ページの先頭へ

戻り値

0	正常終了。
0以外の値	異常終了。

ページの先頭へ

使用例

メンテナンス作業を定期的に実行する場合，jajs_maintainコマンドを，JP1/AJS3のジョブとして定義して実行できます。

毎年12月の最終運用日の23:00に，マネージャー機能を縮退モードにしてデータベースの再編成を行う場合，次のユニット定義情報パラメーターでジョブネットを定義し，計画実行を登録しておきます。WindowsおよびUNIXの例を次に示します。

• Windowsの場合

  unit=maintain-net;
  {
    ty=n;
    sd=1,12/*b;
    st=1,23:00;
    cy=1,(1,y);
    sh=1,ca;
    unit=maintain-job;
    {
      ty=pj;
      sc="jajs_maintain.exe";
      prm="-m manager";
    }
  }

• UNIXの場合

  unit=maintain-net;
  {
    ty=n;
    sd=1,12/*b;
    st=1,23:00;
    cy=1,(1,y);
    sh=1,ca;
    unit=maintain-job;
    {
      ty=j;
      te="/opt/jp1ajs2/bin/jajs_maintain -m manager";
    }
  }

ページの先頭へ