ajscalutil

形式

ajscalutil
     [-F スケジューラーサービス名]
     -b 年/月[/日] -e 年/月[/日]
     [-o|-a|-x|-v|
      -s {db|da|be|af},シフト日数[,シフト猶予日数] |
      -t {be|af}[,振り替え猶予日数] ]
     [-cg ジョブグループ名 | -cf カレンダー情報ファイル名]
     [-Xg ジョブグループ名 | -Xf カレンダー情報ファイル名]
     {-g ジョブグループ名 | -f カレンダー情報ファイル名}...

ページの先頭へ

形式1（運用日のOR条件でのマージ）

ajscalutil
     [-F スケジューラーサービス名]
     -b 年/月[/日] -e 年/月[/日]
     [-o] {-g ジョブグループ名 | -f カレンダー情報ファイル名}...

ページの先頭へ

形式2（運用日のAND条件でのマージ）

ajscalutil
     [-F スケジューラーサービス名]
     -b 年/月[/日] -e 年/月[/日]
     -a {-g ジョブグループ名 | -f カレンダー情報ファイル名}...

ページの先頭へ

形式3（運用日の除外）

ajscalutil
     [-F スケジューラーサービス名]
     -b 年/月[/日] -e 年/月[/日]
     -x
     {-g ジョブグループ名 | -f カレンダー情報ファイル名}
     {-Xg ジョブグループ名 | -Xf カレンダー情報ファイル名}

ページの先頭へ

形式4（運用日および休業日の反転）

ajscalutil
     [-F スケジューラーサービス名]
     -b 年/月[/日] -e 年/月[/日]
     -v
     {-g ジョブグループ名 | -f カレンダー情報ファイル名}

ページの先頭へ

形式5（運用日の前後シフト）

ajscalutil
     [-F スケジューラーサービス名]
     -b 年/月[/日] -e 年/月[/日]
     -s {db|da|be|af},シフト日数[,シフト猶予日数]
     [-cg ジョブグループ名 | -cf カレンダー情報ファイル名]
     {-g ジョブグループ名 | -f カレンダー情報ファイル名}

ページの先頭へ

形式6（休業日の振り替え）

ajscalutil
     [-F スケジューラーサービス名]
     -b 年/月[/日] -e 年/月[/日]
     -t {be|af}[,振り替え猶予日数]
     {-cg ジョブグループ名 | -cf カレンダー情報ファイル名}
     {-g ジョブグループ名 | -f カレンダー情報ファイル名}

ページの先頭へ

形式7（カレンダー情報の期間抽出）

ajscalutil
     [-F スケジューラーサービス名]
     -b 年/月[/日] -e 年/月[/日]
     {-g ジョブグループ名 | -f カレンダー情報ファイル名}

ページの先頭へ

機能

複数のカレンダー情報を組み合わせて計算し（これをカレンダー計算と呼びます），カレンダー情報ファイル形式で標準出力ファイルに出力します。出力した結果をajscalendarコマンドの-dfオプションに指定することで，組み合わせたカレンダー情報をジョブグループに定義できます。ajscalendarコマンドについては，「3. 通常の運用で使用するコマンド　ajscalendar」を参照してください。また，ajscalutilコマンドの-cf，-Xf，-fオプションに指定することで，複数のカレンダー計算の結果を組み合わせることができます。

なお，出力される情報は，運用日および休業日のユニット定義パラメーターです。ajscalutilコマンドに指定できるユニット定義パラメーターの形式については，注意事項を参照してください。

ページの先頭へ

実行権限

ジョブグループ名を指定する場合

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

• JP1_AJS_Admin権限

• JP1_AJS_Manager権限

• JP1_AJS_Editor権限

• JP1_AJS_Operator権限

• JP1_AJS_Guest権限

ジョブグループ名を指定しない場合

なし

ページの先頭へ

引数

ページの先頭へ

注意事項

• -s，-tオプションでは，-b，-eオプションで指定した期間の範囲から，シフト日数，シフト猶予日数，および振り替え猶予日数の分だけ，前後のカレンダー情報を，カレンダー計算に使用します。-s，-tオプションを指定する場合，カレンダー計算の元となるカレンダー情報は，余裕を持った期間を指定してください。

  

  この図では，振り替え猶予日数が「31」であるため，出力期間の5月だけでなく，その前後の月についても，カレンダー計算の対象にされます。

  このため，このコマンドを複数回に分けて実行する場合は，シフトや振り替えを考慮して期間を設定しておき，使用する期間のカレンダー情報を必要に応じて抽出してください。

• -cf，-Xf，-fオプションに指定するカレンダー情報ファイル名にstdinを指定できるのは，1回のコマンド実行で1回だけです。

• -cf，-Xf，-fオプションに指定するカレンダー情報ファイル内に指定できるユニット定義パラメーターに，同一日を指定した場合，あとから指定した定義内容が有効になります。

• -cf，-Xf，-fオプションに指定するカレンダー情報ファイル内に指定できるユニット定義パラメーターには，特定の運用日を示すパラメーター（op=yyyy/mm/dd;），または特定の休業日を示すパラメーター（cl=yyyy/mm/dd;）のどちらかを指定してください。

  • yyyy：指定できる値は，1994〜2036（単位：西暦年）です。

  • mm：指定できる値は，1（または01）〜12（単位：月）です。

  • dd：指定できる値は，1（または01）〜31（単位：日）です。

• ユニット定義パラメーターは，1行に一つだけ指定してください。カレンダー情報ファイルに半角空白，タブ文字やその他の指定できない文字が含まれる場合，および指定できる形式以外でユニット定義パラメーターを指定した場合，その行を不正なユニット定義パラメーターとして無視し，KAVS0603-Eメッセージを出力して処理を続行します。

• カレンダー情報ファイルは，1行ごとに改行してください。

  指定例

  op=2016/05/01;<改行>
  cl=2016/05/02;<改行>
  ：
  cl=2016/05/30;<改行>
  op=2016/05/31;<改行>

  また，カレンダー情報ファイルの最後の行以外に改行だけの行が含まれる場合，その行を不正なユニット定義パラメーターとして無視し，KAVS0603-Eメッセージを出力して処理を続行します。改行だけの行の場合，KAVS0603-Eメッセージに表示される「オプション文字列」に文字列は出力されません。

• -cf，-Xf，-fオプションに指定するカレンダー情報ファイルに不正なユニット定義パラメーターが含まれる場合，その行を不正なユニット定義パラメーターとして無視し，KAVS0602-EメッセージまたはKAVS0603-Eメッセージを出力して処理を続行します。また，0バイトのファイルや有効なユニット定義パラメーターがないファイルなど，カレンダー情報ファイルではないファイルを一つでも指定した場合，カレンダー情報を計算しないで異常終了します。

• ジョブグループ名を指定している場合，カレンダー情報を出力できるのは，次のどちらかのユーザーです。

  • カレンダー情報の計算対象であるすべてのジョブグループに参照権限を与えられたユーザーで，かつそのジョブグループに上位のジョブグループがある場合，最上位のジョブグループから指定したジョブグループ名までのすべてのジョブグループに参照権限があるユーザー。

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

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

ページの先頭へ

戻り値

ページの先頭へ

補足事項

• -cg，-Xg，-gオプションでは，指定したジョブグループのカレンダー情報と，上位のすべてのジョブグループのカレンダー情報をマージしてから，カレンダーを計算します。マージした結果，運用日とも休業日とも定義されていない日付は，運用日として扱われます。

• -cf，-Xf，-fオプションに指定したカレンダー情報ファイルで，運用日または休業日と指定されていない日付は，運用日として扱われます。

ページの先頭へ

使用例1

複数のジョブグループ（/CAL/業務Aと/CAL/業務B）のカレンダー情報をOR条件で組み合わせて，標準出力ファイルに出力します。

ajscalutil -b 2016/4 -e 2017/3 -o -g /CAL/業務A -g /CAL/業務B

ページの先頭へ

使用例2

複数のジョブグループ（/CAL/業務Cと/CAL/業務D）のカレンダー情報をAND条件で組み合わせて，標準出力ファイルに出力します。

ajscalutil -b 2016/4 -e 2017/3 -a -g /CAL/業務C -g /CAL/業務D

ページの先頭へ

使用例3

ジョブグループ「/CAL/業務C」のカレンダー情報に，ジョブグループ「/CAL/業務E」の運用日を休業日として反映して，標準出力ファイルに出力します。

ajscalutil -b 2016/5 -e 2016/5 -x -g /CAL/業務C -Xg /CAL/業務E

ページの先頭へ

使用例4

ジョブグループ「/CAL/業務A」の運用日と休業日を反転して，標準出力ファイルに出力します。

ajscalutil -b 2016/5 -e 2016/5 -v -g /CAL/業務A

ページの先頭へ

使用例5

ジョブグループ「/CAL/業務A」のカレンダー情報を1日前にシフトして，標準出力ファイルに出力します。

ajscalutil -b 2016/5 -e 2016/5 -s db,1 -g /CAL/業務A

ページの先頭へ

使用例6

ジョブグループ「/CAL/業務F」のカレンダー情報を，ジョブグループ「/CAL/業務G」のカレンダー情報と比較し，2運用日分後ろにシフトして，標準出力ファイルに出力します。

ajscalutil -b 2016/5 -e 2016/5 -s af,2 -cg /CAL/業務G -g /CAL/業務F

ページの先頭へ

使用例7

ジョブグループ「/CAL/業務H」のカレンダー情報を，ジョブグループ「/CAL/業務G」のカレンダー情報と比較し，次の運用日に振り替えて，標準出力ファイルに出力します。

ajscalutil -b 2016/5 -e 2016/5 -t af -cg /CAL/業務H -g /CAL/業務G

ページの先頭へ

使用例8

締め日の2営業日後が定義されているカレンダー情報と，システムの運用日が定義されているカレンダー情報をOR条件で組み合わせて，標準出力ファイルに出力します。なお，カレンダー情報が次に示すジョブグループに定義されているものとします。

• 営業日が定義されているジョブグループ「/CAL/営業日」

• 締め日が定義されているジョブグループ「/CAL/締め日」

• システムの運用日が定義されているジョブグループ「/CAL/システム運用日」

この場合，ジョブグループ「/CAL/締め日」のカレンダー情報を，ジョブグループ「/CAL/営業日」のカレンダー情報と比較し，2運用日後ろにシフトして，カレンダー情報ファイル「C:\temp\cal.txt」に出力します。

次に，カレンダー情報ファイル「C:\temp\cal.txt」のカレンダー情報と，ジョブグループ「/CAL/システム運用日」のカレンダー情報をOR条件で組み合わせて，標準出力ファイルに出力します。

ajscalutil -b 2016/5 -e 2016/5 -s af,2 -cg /CAL/営業日 -g /CAL/締め日 > C:\temp\cal.txt
ajscalutil -b 2016/5 -e 2016/5 -o -g /CAL/システム運用日 -f "C:\temp\cal.txt"

ページの先頭へ

出力例

cl=2016/05/01;
op=2016/05/02;
cl=2016/05/03;
  :
cl=2016/05/29;
op=2016/05/30;
op=2016/05/31;

ページの先頭へ