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  实例  处理 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 时转出一次（即使多个表掩码与该表匹配）。


转出参数：

  -C  将此标识为历史记录转出调用。这是必需的。

  -L  只处理大小在指定千字节数或兆字节数以上的历史记录文件。
      后缀可以为空白、K、Kb、M 和 Mb，空白意味着后缀为 Kb。 

  -H  排除列标题。缺省值为“attribute”。

  +H  包含列标题中的组（长表）名称。格式为“Group_desc.Attribute”。缺省值只能是“attribute”。

  

  -N  保留 0-n 代输出（缺省值为 9。）。

  -D  要使用的输出定界符（缺省值为跳进字符。）。将空格用引号括起或进行转义（例如 -D ' '）。

转出调度说明：

  如果您有权使用 crontab，则可以配置历史记录转出以使其通过 crontab（UNIX 调度工具）运行。
请参阅“联机帮助 crontab”以获取详细信息。
  crontab 条目对创建它们的 UNIX 标识唯一。

  -A  将此标识为历史记录转出调度调用。这是必需的。每天将通过 crontab 以指定的次数自动运行转出。值必须为：

      -A n  n 是范围在 1-24 之间的数字。表示每天运行的次数，向上取整为最接近 24 的除数的数字（例如，-A 7 表示每三小时运行一次）。 

      -A 0  取消指定表的所有自动转出。


      -A ?  列出所有表的转出 crontab 条目。

      itmcmd history 将当前运行和较早运行的表模式的列表进行比较。
      对于此 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  # Cancel everything
          itmcmd history -A1 -t "tables I really want..."

        如果当前调用中的任何表与现有的 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 命令将在后续更新中保留这些调度选项。
