itmcmd history

Назначение: Управляет выгрузкой данных хронологии в текстовые файлы с разделителями.

Замечания по синтаксису: [ обязательно ]  | взаимоисключающие

Выгрузка:
  itmcmd history [ -h CANDLEHOME ] -C [ -L nnn[Kb|Mb] ] [ -t маски* и другое ] [ -D разделитель ] [ -H|+H ] [ -N n ]
  [ -i экземпляр|-p имя_tems ] [-x] код_продукта

Планирование выгрузки:
  itmcmd history -A?
  Выгрузка:
  itmcmd history [ -h CANDLEHOME ]  -A perday|0 [ -W дни ] [ -L nnn[Kb|Mb] ] [ -t маски* и другое ] [ -D разделитель ] [ -H|+H ] [ -N n ]
  [ -i экземпляр|-p имя_tems ] [-x] код_продукта

Опции можно объединять и разделять в соответствии со стандартными правилами UNIX.
Показанные ниже три записи имеют одинаковый смысл:

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

Общие опции:

  -h  CANDLEHOME - каталог. Если -h указано как только опция без значения, то будет вызвана справка. 

  -i экземпляр - обработать данные хронологии, собранные конкретным экземпляром продукта.

  -p имя_tems - обработать данные хронологии, собранные сервером TEMS, который указан опцией имя_tems. Необязательно.  В сочетании с этой опцией нужно
использовать код продукта "ms".  По умолчанию обрабатываются данные, собранные агентом код_продукта.

  код_продукта - двухсимвольный код продукта (например, mq) для продукта, который нужно выгрузить. 

  -t  Показать список таблиц или шаблонов ksh, разделенных запятыми, двоеточиями, косой чертой или пробелами; если имя, содержащее пробелы, или шаблон могут
совпадать с именем файла, то значение нужно заключить в кавычки). Имена таблиц всегда показаны в верхнем регистре, но опция -t игнорирует регистр. 

  -x  Исключить атрибуты SAMPLES и INTERVAL в выходном файле.

Замечания по выгрузке:

  Выгрузка преобразует файлы хронологии для выбранных таблиц продукта в файлы с разделителями для использования в электронных таблицах или в похожих
продуктах. Выгрузку можно выполнить в любой момент, причем агент необязательно должен быть активен. 

  Проверка осмысленности записи в таблице или фактического использования записи не выполняется. При выполнении itmcmd history -C каждая таблица будет выгружена
только один раз, даже если ей соответствует несколько маск таблицы.

Параметры выгрузки:

  -C  Указывает, что это вызов выгрузки хронологии. Обязательно.

  -L  Обработать файлы хронологии, размер которых больше указанного числа килобайт или мегабайт.
      Возможные суффиксы: K, Kb, M, Mb; если суффикс не указан, то подразумевается Kb. 

  -H  Исключить заголовки столбцов. Значение по умолчанию: "attribute".

  +H  Включить имена групп (в больших таблицах) в заголовки столбцов. Формат: "описание_группы.атрибут".  Значение по умолчанию - только attribute.

  -N  Сохранять 0-n версий выходных результатов; значение по умолчанию -9..

  -D  Выходной разделитель; по умолчанию - табуляция. .  Пробел нужно заключать в кавычки или удваивать (например, -D ' ').

Замечания по планированию выгрузки:

  Можно сконфигурировать выгрузку хронологии для выполнения посредством crontab (утилита планирования UNIX), если вы авторизованы для использования crontab.  
Дополнительную информацию смотрите в "man crontab". Записи crontab уникальны для создавшего их ID UNIX. 

  -A  Указывает, что это вызов планирования выгрузки хронологии.  Обязательно.  Автоматически запускает выгрузку заданное число раз в день посредством crontab.  Значения:

      -A n  n - число от 1 до 24. Число запусков в день, округленное до ближайшего делителя 24 (например, -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*

        Нужно перейти от двух вызовов в день к одному вызову в день. Поскольку qua* соответствует quack*, это будет работать, хотя могут быть найдены таблицы,
не соответствующие quack*. Однако moo1* не соответствует шаблону moo* и не остановит выгрузку таблиц moo* дважды в день, хотя обе маски соответствуют
таблице MOO123.  Следующая последовательность команд будет работать всегда:

          itmcmd history -A0  # Отменить все
          itmcmd history -A1 -t "нужные таблицы..."

        Команда itmcmd history сохраняет существующие значения даты, месяца и (если не указано -W) дня недели, если какая-либо таблица в текущем
вызове соответствует существующей записи crontab. Если это нежелательно, то удалите и заново создайте запись. 

        Остальные опции (например, -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, предоставляет возможность планирования. Можно вручную создать команды itmcmd history в crontab. Однако
чтобы команду itmcmd history -A можно было использовать для вывода списка этих записей или их изменения, первым отделенным пробелом словом после
команды в записи crontab должно быть "-Ct".  Команда itmcmd history -A сохраняет эти опции расписания при успешных обновлениях.
