itmcmd history

目的：管理將歷程資料轉出至具有分隔符號的文字檔。

語法附註：[ optional ]  mutually|exclusive

轉出：
  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 慣例來組合及區隔選項。
下列三項的意義相同：

  -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  您要轉出之產品的雙字元產品代碼（例如 mq）。 

  -t 表格清單或其 ksh 型樣，以逗點、冒號、斜線或空格區隔（如果以空格區隔請用引號括起，否則型樣可能會符合某個檔案）。表格名稱
      一律為大寫，但 -t 會不區分大小寫。

  -x  在輸出檔中排除 SAMPLES 和 INTERVAL 屬性。

轉出附註：

  轉出會將產品所選表格的歷程檔案轉換為具有分隔符號的檔案，以用於
  試算表或類似產品中。您可以隨時執行轉出；代理程式可以不在作用中。

  沒有執行任何檢查以確保表格清單中的項目有意義或可實際使用。
  每次執行 itmcmd history -C 時，只會轉出每個表格一次，即便
  有多個表格遮罩與其相符亦是如此。


轉出參數：

  -C  將此參數視為歷程轉出呼叫。必要參數。

  -L  只處理大小超過指定 KB 或 MB 數的歷程檔案。
      字尾可以是下列其中一個：無、K、KB、M、MB，「無」表示 KB。

  -H  排除直欄標頭。預設值是 "attribute"。

  +H  包括直欄標頭中的群組（長型表格）名稱。格式為
      "Group_desc.Attribute"。預設值為 attribute only。

  -N  保留第 0-n 代輸出（預設值為 9）。

  -D  要使用的輸出定界字元（預設值為定位點字元）。請括住或跳出
      空白（亦即  -D ' '）。

轉出排程附註：

  假設您已獲得使用 crontab（UNIX 排程機能）的授權，則可以將歷程轉出配置為
  透過 crontab 執行。如需詳細資訊，請參閱 "man crontab"。
  Crontab 項目對於建立它們的 UNIX ID 而言是唯一的。

  -A  將此參數視為歷程轉出排程呼叫。必要參數。每天透過
      Crontab 自動執行特定次數轉出。值必須是：

      -A n  n 是 1-24。每天的執行次數，四捨五入至 24 最接近的除數（例如，
            -A 7 表示每三小時執行一次）。


      -A 0  取消所有指定表格的自動轉出。

      -A ?  列出所有表格的轉出 crontab 項目。

      itmcmd history 會將目前執行的表格型樣清單與早期執行的清單進行比較。
      對於 THIS itmcmd history -A 呼叫的表格型樣清單中的每個項目，會將
      型樣定義每個較舊型樣的字元比較，但是不會與較舊型樣的每個可能擴充
      比較。範例：

        舊呼叫：itmcmd history -A 2 -t quack*,moo*
        新呼叫：itmcmd history -A 1 -t   qua*,moo1*

        目的是將每天執行 2 次變更為每天執行 1 次。因為 qua* 符合
        quack*，所以它會起作用，然而它還符合與 quack* 不相符的表格。
        但是 moo1* 與文字字元 moo* 不相符，因此不會停止 moo* 表格每天
        兩次的轉出，雖然兩個遮罩都符合表格 MOO123。若不確定，則下列項目會始終有效：


          itmcmd history -A0  # 全部取消
          itmcmd history -A1 -t "我想要的表格..."

        如果目前呼叫中的任何表格都符合現有 crontab 項目，則 itmcmd
        history 會保留現有日期、月份及（如果您省略 -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 指令
   會在進行後續更新時保留這些排程選項。
