Файл настроек HLOG#

В основном каталоге установки ПО IngortechSCADA находится файл с названием hlog.dat.

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

Параметры#

Файл hlog.dat содержит набор элементов в одинаковом формате:

ИМЯ=ЗНАЧЕНИЕ

Где «ИМЯ» - название параметра файла, записанное латинскими буквами, «=» (символ равенства) разделяет имя параметра и его значения и «ЗНАЧЕНИЕ» - данные параметра.

Название параметра:

  1. Может начинаться и заканчиваться произвольным количеством символов пробела, которые будут проигнорированы.

  2. Может содержать как большие, так и маленькие буквы. Различия между ними в имени параметра не учитывается.

  3. Файл может содержать неограниченное количество параметров с одним и тем же именем. При загрузке будет использован последний из них.

Данные параметра могут содержать символы пробелов после знака «=» и после окончания текста значения. Эти пробелы учитываться не будут.

Строки, в которых первым значащим символом является символ «;» (точка с запятой) считаются комментариями. Такие строки, после символа «;» могут содержать любой произвольный текст и будут полностью проигнорированы при загрузке файла.

Пример

; Различия между большими и маленькими буквами в названии нет.
    rtCfgRestriction =  strict
; Параметр может начинаться не с первой позиции.
; Лишние пробелы между параметром и значением будут проигнорированы.

Список поддерживаемых параметров:

  • OverrideLogPath - Указывает каталог, который будет использоваться для сохранения лог файлов программ.

  • MaxLogLen - Устанавливает максимальный размер лог файла.

  • MaxLogAge - Устанавливает максимальный срок жизни лог файла в минутах.

  • RTCfgRestriction - Устанавливает глобальные ограничения на символы, которые разрешено использовать для имени переменной и контроллера.

  • SecondaryCfg - Устанавливает название каталога для поиска файлов настроек программ.

  • WorkoutLimit - Устанавливает максимальную дату использования ПО.

  • RTSCachePath - Устанавливает каталог сохранения файлов загружаемых с сервера.

OverrideLogPath#

OverrideLogPath = <КАТАЛОГ>

Значение по умолчанию:

(пустая стройка). Лог файлы будут создаваться в том же каталоге из которого запускаются программы.

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

  • Полный или относительный путь к каталогу, в котором необходимо создавать лог файлы.

  • Если указан относительный путь (имя каталога начинается не с указания буквы диска или сетевого имени), то путь будет рассчитан относительно каталога в котором расположен файл hlog.dat.

  • Если значение строки равно «-» (одиночному символу «минус»), то создание лог файлов будет запрещено.

Предупреждение

При запрете создания лог файлов с использованием символа «-», запрет действует для ВСЕХ программам, запускаемых из каталога, где расположен файл hlog.dat.

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

MaxLogLen#

MaxLogLen = ЗНАЧЕНИЕ[k|m|g]

Значение по умолчанию:

  1. Ограничение по размеру не используется.

Устанавливает максимальный размер лог файла. Если после значения указаны символы «К», «М» или «G», то значение интерпретируется как число в килобайтах, мегабайтах и гигабайтах соответственно.

Если значение ключа установлено в величину 0 (ноль), то ограничение на размер лог файла не используется.

Если ограничение установлено, при достижении размера лог файла указанной величины он будет переименован в соответствии со следующим форматом:

ПУТЬ/ИМЯ.999.log

Где «ПУТЬ» и «ИМЯ» будут использованы из соответствующих частей оригинального имени лог файла, а часть «999» примет числовое значение от 0 до 999 так, чтобы получилось уникальное имя файла.

Информация

Если одновременно установлены параметры MaxLogLen и MaxLogAge, то они работают одновременно. Сработает и обработается то ограничение, которое наступит раньше.

MaxLogAge#

MaxLogAge = МИНУТЫ

Значение по умолчанию:

  1. Ограничение по времени не используется.

Устанавливает максимальный срок жизни лог файла в минутах.

Если значение ключа установлено в величину 0 (ноль), то ограничение на время жизни не используется.

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

ПУТЬ/ИМЯ.999.log

Где «ПУТЬ» и «ИМЯ» будут использованы из соответствующих частей оригинального имени лог файла, а часть «999» примет числовое значение от 0 до 999 так, чтобы получилось уникальное имя файла.

Информация

Если одновременно установлены параметры MaxLogLen и MaxLogAge, то они работают одновременно. Сработает и обработается то ограничение, которое наступит раньше.

RTCfgRestriction#

RTCfgRestriction = strict|any

Значение по умолчанию:

strict

Устанавливает глобальные ограничения на символы, которые разрешено использовать для имени переменной и контроллера.

В качества значения параметра может быть указан текст «strict» или «any» (без кавычек). Любое другое содержимое параметра будет неверным и параметр будет проигнорирован.

strict:

Если установлено, то в именах переменных и контроллеров только латинские символы и символы пунктуации, такие как «_-+,.#».

any:

Если установлено, то в именах переменных и контроллеров разрешено использовать любые символы, кроме символов запрещенных для использования в именах файлов операционной системы (запрещены символы: :*?/).

Этот параметр используется:

  • Конфигуратором, при проверке конфигурации перед сохранением и отправкой.

  • РТС Сервером, при загрузке конфигурации с диска или приеме данных от клиентов.

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

SecondaryCfg#

SecondaryCfg = КАТАЛОГ

Значение по умолчанию:

. (точка) Файлы будут загружены из текущего каталога.

Устанавливает название каталога для поиска файлов настроек программ.

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

Имя каталога может быть указано как в относительном, так и в абсолютном виде. Если указан относительный каталог, то его полный путь будет вычислен относительно каталога файла hlog.dat.

Значение этого параметра влияет как на загрузку, так и на сохранения файлов настроек.

Этот параметр можно использовать в том случае, если запись в каталог расположения исполняемых файлов программ невозможна. Например, запрещена политикой операционной системы.

WorkoutLimit#

WorkoutLimit = ДАТА

Значение по умолчанию:

  • (знак минус) Параметр не используется.

Устанавливает максимальную дату использования ПО. Дата должна быть указана в формате: «ДД.ММ.ГГГГ».

RTSCachePath#

RTSCachePath = КАТАЛОГ

Значение по умолчанию:

«Cache».

Устанавливает каталог, который будет использоваться клиентским ПО RTS для сохранения файлов, загружаемых с сервера.