itmcmd history

目的: 区切り文字で区切られたテキスト・ファイルへのヒストリー・データのロールオフを管理します。

構文の注: [ オプション ]  相互|排他的

ロールオフ:
  itmcmd history [ -h CANDLEHOME ] -C [ -L nnn[Kb|Mb] ] [ -t masks*,etc ] [ -D delim ] [ -H|+H ] [ -N n ]
  [ -i instance|-p tems_name ] [-x] prod_code

ロールオフのスケジューリング:
  itmcmd history -A?
  itmcmd history [ -h CANDLEHOME ] -A perday|0 [ -W days ] [ -L nnn[Kb|Mb] ] [ -t masks*,etc ] [ -D delim ] 
  [ -H|+H ] [ -N n ] [ -i instance|-p tems_name ] [-x] prod_code

オプションは、標準 UNIX 規則に従って、結合することやスペースを入れることができます。
次の 3 つは同じ意味です。

  -t "table list"  -ttable:list  -ttable,list

一般オプション:

  -h  CANDLEHOME ディレクトリー。値を指定せずに -h のみオプションとして入力すると、ヘルプが呼び出されます。

  -i instance  prod_code の特定インスタンスにより収集されたヒストリー・データを処理します。

  -p tems_name  TEMS tems_name により収集されたヒストリー・データを処理します。オプションです。
               このオプションでは、prod_code として "ms" を使用する必要があります。デフォルト
               のアクションでは、prod_code エージェントにより収集されたデータが処理されます。

  

  prod_code  ロールオフする製品の 2 文字の製品コード (例: mq)。

  -t  コンマ、コロン、スラッシュ、またはブランクで区切った、テーブルまたはその ksh
      パターンのリスト (ブランクで区切った場合、またはパターンをファイルと
      突き合わせる場合には、引用符で囲みます)。テーブル名は常に大文字ですが、-t
      では大/小文字の区別が無視されます。



  -x  出力ファイルで、SAMPLES 属性および INTERVAL 属性を除外します。

ロールオフの注:

  ロールオフは、製品について選択されたテーブルのヒストリー・ファイルを、スプレッドシート
  または類似の製品で使用される、区切り文字で区切られたファイルに変換します。
  ロールオフは、いつでも実行できます。エージェントがアクティブになっている必要は
  ありません。

  

  テーブル・リスト内の項目に意味があるか、または実際に使用されるかを確認するための検査
  はありません。各テーブルは、複数のテーブル・マスクがそのテーブルに一致した場合でも、
  itmcmd history -C の実行ごとに 1 回しかロールオフされません。



ロールオフのパラメーター:

  -C  この呼び出しがヒストリー・ロールオフ呼び出しであることを示します。必須です。

  -L  指定された Kb 数または Mb 数を超えるサイズのヒストリー・ファイルのみ処理します。
      サフィックスは、なし、K、Kb、M、Mb のいずれかを使用でき、指定がない場合には
      Kb と解釈されます。

  

  -H  列ヘッダーを除外します。デフォルトは「属性」です。

  +H  グループ (長いテーブル) 名を列ヘッダーに組み込みます。形式は、
      「Group_desc.Attribute」です。デフォルトは属性のみです。

  -N  0 から n までの世代の出力を保持します (デフォルトは 9 です)。

  -D  使用する出力区切り文字 (デフォルトはタブ文字です)。ブランクは、
      引用符で囲むか、エスケープしてください (例: -D ' ')。

ロールオフのスケジューリングの注:

  crontab (UNIX のスケジューリング機能) を使用する許可を得ている場合、crontab を
  介してヒストリー・ロールオフが実行されるように構成できます。詳しくは「man crontab」
  を参照してください。crontab エントリーは、それらを作成した UNIX ID に対して一意となっています。



  -A  この呼び出しがヒストリー・ロールオフのスケジューリング呼び出しであることを示します。必須です。
      crontab を介して、1 日に指定された回数だけロールオフを自動的に実行します。値は
      以下のようにする必要があります。



      -A n  n は 1 から 24 までです。24 の約数のうち最も近い約数に丸めた、1 日当たりの
       実行回数です (例えば、-A 7 は 3 時間ごとの実行を意味します)。



      -A 0  指定されたテーブル (複数可) に関するすべての自動ロールオフを取り消します。

      -A ?  すべてのテーブルに関するロールオフ crontab エントリーをリストします。

      itmcmd history は、現行の実行と以前の実行のテーブル・パターン・リストを比較します。
      現行の itmcmd history -A 呼び出しのテーブル・パターン・リストの項目ごとに、以前の
      パターンで可能な各拡張に対してではなく、以前の各パターンを定義した文字に対して
      パターンが比較されます。例:

        以前の呼び出し:  itmcmd history -A 2 -t quack*,moo*
        新しい呼び出し:  itmcmd history -A 1 -t   qua*,moo1*

        これは、1 日に 2 回の実行から 1 日に 1 回の実行に変更しようとするものです。
        quack* が一致しないテーブルに qua* が一致する可能性がありますが、qua* は quack* と
        一致するため、qua* は有効です。一方、moo* マスクと moo1* マスクはどちらもテーブル
        MOO123 などに一致しますが、moo1* はリテラル文字 moo* に一致しないため、moo* テーブルの
        1 日 2 回のロールオフは停止されません。例えば、次の指定は常に正常に機能します。

          itmcmd history -A0  # Cancel everything
          itmcmd history -A1 -t "tables I really want..."

        itmcmd history では、現行呼び出しのテーブルが既存の crontab エントリーに一致する
        場合、既存の日付、月、および (-W を省略した場合には) 曜日の設定が保持されます。
        これが必要な動作ではない場合は、エントリーを削除し、再作成してください。

        -D、-L、-H など、他のオプションは保持されません。これらは、それぞれの
        itmcmd history -A 呼び出しで再指定またはデフォルト設定する必要があります。

  

  -W  crontab 形式での曜日 (0=日曜日、1=月曜日... 6=土曜日)。このオプションに対する
      引数は、数値または数値の範囲をコンマで区切ったリストです。例: -W 1,3-5 は
      月曜日、水曜日、木曜日、金曜日を意味します。デフォルトは 1-6 (月曜日から土曜日
      まで) です。

   

   crontab の手動更新に関する注: itmcmd history -A は、itmcmd history ロールオフ
   の自動実行を管理するための最も簡単な方法です。一方、crontab を使用すると、
   itmcmd history -A では実現しないスケジューリングの柔軟性が実現します。crontab では、
   itmcmd history コマンドを手動で作成できます。ただし、itmcmd history -A を使用して
   これらのエントリーをリストまたは変更する場合、crontab エントリー内のコマンドの後の、
   ブランクで区切られた最初の語は「-Ct」にする必要があります。itmcmd history -A コマンドでは、
   後続の更新でこれらのスケジュール・オプションが保持されます。
