Доступные версии документации
Файл конфигурации ключей запуска программы (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
Заметили ошибку?
Выделите текст и нажмите Ctrl + Enter