Файл конфигурации ключей запуска программы (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.
Обработка особых случаев:
-
файл конфигурации не найден, ключ
/cf=< имя файла >
не задан.Выдается сообщение
The configuration file < имя файла > not found
и программа продолжает работу, игнорируя настройку параметров из файла.
-
файл конфигурации не найден, ключ
/cf=< имя файла >
задан.Выдается сообщение
The configuration file < имя файла > not found
и программа завершается.
-
синтаксическая ошибка в файле конфигурации.
Выдается сообщение
Error in configuration file string: < строка с ошибкой >
и программа завершается.
-
Если заданы одноименные ключи в файле конфигурации и в командной строке запуска программы server, берется значение из командной строки.
Пример файла конфигурации:
#argument section .arg: /setstate=MONO /tcorrect=20 #environment section .env: SERVER_HOME= /home/linter/HOME SY00 = /home/linter/DB