Файлы параметров
Поскольку количество параметров старта базы данных может быть очень большим, то их ввод в командной строке или описание в строке скрипта старта может стать достаточно утомительным занятием, и, главное, сложно управляемым процессом. Поэтому распространена практика применения файлов параметров, использование которых поможет избежать ввода параметров в процессе старта базы данных и сложного управления ими в скриптах. Все параметры описываются в едином файле, а потом этот файл используется в команде proserve.
Файл параметров представляет собой текстовый файл, в котором каждая строка содержит описание одного параметра и, если необходимо, его значение (некоторые параметры не имеют значений, так как представляют собой «флаги»). Параметры, которые не были указаны в файле параметров, получают значения по умолчанию.
Существует два способа создания файла параметров:
- С помощью любого текстового редактора.
- С использованием шаблона в Data Administration в Windows или в Data Dictionary в Unix.
Для создания файла параметров вручную в текстовом редакторе следуйте правилам:
- Для удобства чтения размещайте каждый параметр на отдельной строке.
- Убедитесь, что каждый параметр назван правильно (включая регистр) и имеет правильное значение, если оно обязательно.
- Используйте символ решётки (#) для собственных комментариев.
- Файл параметров может иметь любое имя с расширением «.pf».
Пример текстового файла параметров с комментариями:
#--------------------------------------------------------------------------- # Last update: Date 08/10/18 Time 17:45:12 # This is a parameter file for test #--------------------------------------------------------------------------- -B 2000 # buffers -H localhost # host-name -L 10000 # number-locks -Ma 10 # maximum-clients -Mi 3 # minimum-clients
Процедура создания файла параметров в Windows
Для создания файла параметров в Windows средствами СУБД OpenEdge необходимо выполнить следующие действия:
- Выполните Start -> All Programs -> OpenEdge -> Data Administration.
- В Data Administration выберите пункт верхнего меню Utilities -> Editor for Parameter Files.
- В поле Parameter File введите имя файла и щёлкните мышью по кнопке Ok. Примечание: имя файла не должно быть больше восьми символов. По умолчанию файл сохраняется в рабочий каталог OpenEdge (C:\OpenEdge\WRK в Proenv).
- Отредактируйте необходимые параметры, выделяя каждый и вводя необходимое значение.
- Для сохранения файла параметров щёлкните мышью по кнопке Ok.
Процедура создания файла параметров в UNIX
Для создания файла параметров в UNIX средствами СУБД OpenEdge необходимо выполнить следующие действия:
- В командной строке Proenv запустите Procedure Editor:
mpro
В данном случае командой mpro открывается только Procedure Editor без подключения к базе данных, с таким же успехом можно использовать команду pro, т.е. не имеет значения многопользовательский или однопользовательский режим используется.
- Нажмите клавишу F3 для активации верхнего меню.
- Используя клавиши со стрелками выберите пункт меню Tools -> Data Dictionary и нажмите Enter.
- Используя клавиши со стрелками выберите пункт Utilities -> Editor for Parameter Files и нажмите Enter.
- Введите имя файла с расширением .pf и нажмите клавишу F1.
- Прокручивая список параметров, введите необходимые значения.
- Для сохранения файла параметров нажмите клавишу F1, при необходимости введите свои комментарии, клавишей Tab выберите кнопку OK и нажмите клавишу Enter.
Вызов файла параметров
После создания файла параметров его можно вызвать для старта брокера с помощью команды старта или вызвать из другого файла параметров.
Для вызова файла параметра с помощью команд старта, таких как proserve или mpro, применяется параметр старта –pf.
Синтаксис команды:
proserve -pf [имя файла параметров].pf
Файл параметров можно вызвать из другого файла параметров. Это полезно когда необходимо установить отдельный набор глобальных параметров на уровне приложения или базы данных, и другой набор параметров, когда необходимо отдельным пользователям позволить использовать дополнительные параметры на клиентском уровне.
Приведём простой пример. Допустим, что файл параметров primary.pf устанавливает глобальные параметры для вашей базы данных, при этом для отдельных пользователей необходимо установить дополнительные параметры в отдельном файле myparam.pf, например, для работы с какой-то особой частью приложения.
Для вызова файла параметров myparam.pf из файла параметров primary.pf необходимо внутри primary.pf указать параметр -pf в качестве значения которого указать myparam.pf.
Пример:
#primary.pf #------------------------------------------------------------------- #В этом файле устанавливаются глобальные параметры для базы данных #------------------------------------------------------------------- -db test #база данных . . . -pf myparam.pf #другой файл параметров
Вызываемый файл параметров:
#myparam.pf -T /usr/tmp #расположение пользовательских временных файлов -mmax 1024 #максимальный объем памяти для R-кода