ajscalendar

形式

ajscalendar
     [-F サービス名]
     [-lt {時:分|none|no}]
     [-ld {日|none|no|{sun|su|mon|mo|tue|
          tu|wed|we|thu|th|fri|fr|sat|sa}:n}]
     [-md {this|th|next|ne|none|no}]
     [-c]
     [-op {sun|su|mon|mo|tue|tu|wed|we|
          thu|th|fri|fr|sat|sa|
          {年/月/{日|
          {sun|su|mon|mo|tue|tu|wed|we|
          thu|th|fri|fr|sat|sa}[:n]}}}]
     [-cl {sun|su|mon|mo|tue|tu|wed|we|
          thu|th|fri|fr|sat|sa|
          {年/月/{日|
          {sun|su|mon|mo|tue|tu|wed|we|
          thu|th|fri|fr|sat|sa}[:n]}}}]
     [-no {sun|su|mon|mo|tue|tu|wed|we|
          thu|th|fri|fr|sat|sa|{年/月/{日|
          {sun|su|mon|mo|tue|
          tu|wed|we|thu|th|fri|fr|sat|sa}
          [:n]}}}]
     [-of 運用日情報ファイル名]
     [-cf 休業日情報ファイル名]
     [-nf 取消日情報ファイル名]
     [-df カレンダー情報ファイル名]
     [-d 年/月/日]
     [-R]
     ジョブグループ名...

ページの先頭へ

機能

ジョブグループにカレンダー情報を定義します。

ページの先頭へ

実行権限

次に示すJP1権限レベルのどれかを与えられたユーザー

• JP1_AJS_Admin権限

• JP1_AJS_Manager権限

• JP1_AJS_Editor権限

ページの先頭へ

引数

ページの先頭へ

注意事項

• カレンダー情報を定義できるのは，次のどちらかのユーザーです。

  • ジョブグループを定義したときに，またはその属性を変更したときに，更新権限を与えられているユーザーで，かつそのジョブグループに上位のジョブグループがある場合，上位のすべてのジョブグループに参照権限があるユーザー

  • Administrators権限またはスーパーユーザー権限を持つOSユーザーにマッピングしたJP1ユーザー

    ただし，環境設定パラメーターADMACLIMITをデフォルトから変更して「yes」と設定している場合は，Administrators権限またはスーパーユーザー権限を持つOSユーザーにマッピングしたJP1ユーザーであっても，参照権限および更新権限が必要です。

• 運用日情報ファイル，休業日情報ファイル，取消日情報ファイル，またはカレンダー定義情報ファイル内のカレンダー情報が規定する形式でない場合，ajscalendarコマンドはそれらの形式外情報を無視して処理を続行します。また，情報ファイルの最後には，必ず改行を指定してください。改行を指定しないと，最終行が形式外情報として無視され，ajscalendarコマンドが正常終了しても最終行に指定したカレンダー情報が定義されません。

• 運用日情報ファイル，休業日情報ファイル，取消日情報ファイル，カレンダー定義情報ファイルを同時に指定し，どれかのファイルの処理で異常が発生した場合，ajscalendarコマンドは異常が発生したファイルの処理を中断し，その他のファイルの処理を続行します。

  なお，ajscalendarコマンドは，正常に処理された情報ファイルのカレンダー情報だけを定義し，異常終了します。

• 運用日情報ファイル，休業日情報ファイル，取消日情報ファイル，カレンダー定義情報ファイルに何も定義されていない場合，該当するカレンダー情報は変更されません。

• ajscalendarコマンドや，JP1/AJS3 - Viewの［月間カレンダー編集］ウィンドウ，［年間カレンダー編集］ウィンドウを使って，あるジョブグループのカレンダー情報を同時に変更した場合，変更結果は保証できません。

• オプションと値との間は，必ず1バイト以上の空白文字で区切ってください。

• ajscalendarコマンドは，オプションを連続して指定できません。

  指定できる例：ajscalendar -c -F AJSROOT1 /GROUP

  指定できない例：ajscalendar -cF AJSROOT1 /GROUP

• 運用日情報ファイル，休業日情報ファイル，取消日情報ファイル，またはカレンダー定義情報ファイル内に有効なカレンダー情報が一つもなく，かつ有効なカレンダー定義オプションが一つも指定されていない場合，ajscalendarコマンドは異常終了します。

• 無効なカレンダー定義オプションが一つでも指定されている場合，ajscalendarコマンドは異常終了します。

• ajscalendarコマンドは，業務量が少ない時間帯に実行してください。ajscalendarコマンドの実行中は，カレンダー情報を定義するジョブグループと同一のスケジューラーサービスに実行登録されているルートジョブネットの実行を抑止するため，業務に影響を及ぼすおそれがあります。ただし，定義を変更する前に「監視中」状態になっている起動条件付きジョブネットは，ajscalendarコマンドの実行中に起動条件が成立すると実行されます。

• 当日のカレンダー情報を休業日から運用日に変更した場合，計画実行登録されたジョブネットでは，スケジュールの再計算によって当日の実行予定が生成され，ジョブが実行されることがあります。

ページの先頭へ

戻り値

0	正常終了。
4〜124で4の倍数値	異常終了。

ページの先頭へ

補足事項

• 次に示す条件が成立したあと，スケジュールが再計算されます。

  • 指定したジョブグループがあるスケジューラーサービスが起動している場合。

  • このコマンドが正常終了した場合。

• 運用日情報ファイル，休業日情報ファイル，取消日情報ファイルに格納するカレンダー情報である，「週間標準値」および「運用日，休業日，または取消日」の形式を次に示します。なお，形式は上記3種類の情報ファイルに共通です。情報ファイルの最後には，必ず改行を指定してください。改行を指定しないと，最終行が形式外情報として無視され，ajscalendarコマンドが正常終了しても最終行に指定したカレンダー情報が定義されません。

  週間標準値の形式

  sun|su：日曜日を指定します。

  mon|mo：月曜日を指定します。

  tue|tu：火曜日を指定します。

  wed|we：水曜日を指定します。

  thu|th：木曜日を指定します。

  fri|fr：金曜日を指定します。

  sat|sa：土曜日を指定します。

  運用日，休業日，または取消日の形式

  YYYY/MM/

  {DD{sun|su|mon|mo|tue|tu|wed|we|thu|th|fri|fr|sat|sa}[:n]}

  • YYYY

    指定できる値は，1994〜環境設定パラメーターSCHEDULELIMITの値（単位：西暦年）です。環境設定パラメーターSCHEDULELIMITの詳細については，マニュアル「JP1/Automatic Job Management System 3 構築ガイド　20.4.2(123) SCHEDULELIMIT」を参照してください。

  • MM

    指定できる値は，1〜12（単位：月）です。

  • DD

    指定できる値は，1〜31（単位：日）です。

  • n

    月初めを基準に何週目の曜日かを指定します。

    指定できる値は，1〜5（単位：週）です。

    なお，第5週がない月に5を指定した場合，カレンダー情報は無効になります。

• カレンダー情報のオプション（-op，-cl，および-noオプション）はあとに指定されたものが優先されます（例えば，「-op mon -cl mon -no mon」と指定した場合，「-no mon」が優先され，月曜日は取消日になります）。

• 週間標準値，運用日，休業日，および取消日を同時に指定した場合，運用日，休業日，および取消日が優先されます（例えば，「-op 2009/10/25 -cl sun」と指定した場合，「-op 2009/10/25」が優先され，2009年10月25日は運用日になります）。

• 運用日，休業日または取消日に曜日を指定した場合，該当する日付に変更してから，カレンダー情報として格納します。

• ジョブグループのカレンダー情報の設定を省略した場合は，上位のジョブグループまたはスケジューラーサービスのカレンダー情報を参照します。上位ジョブグループ，スケジューラーサービスすべてのカレンダー情報の設定が省略されている場合は，運用日が仮定されます。

ページの先頭へ

使用例1

ジョブグループ（/営業部）のカレンダー情報をいったん削除したあと，2009年10月分の休業日（土曜日と日曜日）を設定します。休業日は休業日情報ファイル（/tmp/calendar）に定義してあるものとします。

ajscalendar -c -cf /tmp/calendar /営業部

休業日情報ファイル（/tmp/calendar）の内容

2009/10/sat
2009/10/sun

ページの先頭へ

使用例2

ジョブグループ（/営業部）のカレンダー情報（日曜日と土曜日は週間標準値によって休業日とする。ただし，2009年10月は土曜日を運用日とする）を設定します。

ajscalendar -cl su -cl sa -op 2009/10/sa /営業部

ページの先頭へ