Файл конфигурации ключей запуска программы (cf)
Синтаксис
 
/cf=< спецификация файла >
< спецификация файла >::=текстовая строка.
Описание

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

Секция ключей должна начинаться строкой.

.arg:

Секция переменных окружения должна начинаться строкой.

.env:

Каждая из секций может состоять из нескольких строк.

Синтаксис ключей такой же, как и в командной строке запуска управляющей программы server.

В файле конфигурации запуска можно задавать переменные окружения

 < имя переменной1 > = < значение1 > < имя переменной2 > = < значение2 >.

Допустимо использование кавычек для задания значений, содержащих пробелы. Кавычки должны закрываться на той же строке.

Конец строки считается разделителем, т.е. ключ или выражение вида

< имя переменной1 > = < значение1 > 

нельзя продолжать на следующую строку. Строки, начинающиеся символом #, игнорируются.

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

Имя файла конфигурации по умолчанию hotreserve.conf.

Порядок поиска файла конфигурации запуска программы такой же, как и порядок поиска файла nodetab (см. описание ключа /ntab), за исключением того, что поиск в каталогах, заданных переменными окружения SY00 и SERVER_HOME, не осуществляется.

С помощью ключа /cf=< путь к файлу конфигурации > можно задать полный путь файла. При этом имя файла может отличаться от значения по умолчанию. Если отсутствует файл, полный путь к которому задан, программа завершается.

Если файл найден, выдается сообщение при старте server:

Configuration file found: < путь к файлу >

Такое же сообщение записывается в log-файл с атрибутом MSG.

Обработка особых случаев:

  1. файл конфигурации не найден, ключ /cf=< имя файла > не задан.

    Выдается сообщение

    The configuration file < имя файла > not found

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

  2. файл конфигурации не найден, ключ /cf=< имя файла > задан.

    Выдается сообщение

    The configuration file < имя файла > not found

    и программа завершается.

  3. синтаксическая ошибка в файле конфигурации.

    Выдается сообщение

    Error in configuration file string: < строка с ошибкой >

    и программа завершается.

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

Пример файла конфигурации:

#argument section
.arg:
/setstate=MONO   /tcorrect=20

#environment section
.env:
SERVER_HOME= /home/linter/HOME
SY00 =  /home/linter/DB