Этот сайт посвящается администрированию баз данных OpenEdge Progress.
Не корысти ради, а познания для!

С уважением,
Валерий Башкатов

Сайт разработан при участии компании Progress Technologies, официального дистрибьютора Progress Software Corp. на территории стран СНГ и Латвии.

RSS подписка на обновления сайта

Поиск по сайту

Лучшие материалы

На сайте функционирует система коррекции ошибок. Обнаружив неточность в тексте, выделите её и нажмите Ctrl+Enter

Результаты опроса: Нужны ли книги по Progress OpenEdge на русском языке? (опрос проводился с мая 2009 по ноябрь 2010)

Да, нужны. Потому что будет легче понять материал - 268
Нет, не нужны. Достаточно материалов на английском языке - 10
Не знаю, мне всё равно - 6

А знаете ли вы что..

Параметры запуска баз данных

Основы баз данных OpenEdge
Защита данных
Поддержка и мониторинг базы данных
Команды запуска и останова
Параметры запуска баз данных
     Использование параметров запуска
     Параметры сервера базы данных OpenEdge
     Параметры типов серверов
     Параметр интернационализации сервера базы данных
     Параметры статистики сервера базы данных
     Параметр SSL подключения к базе данных
     Сетевые параметры сервера базы данных
     Категории использования параметров запуска
     Алфавитный список параметров запуска базы данных
        AdminServer Port (-adminport)
        After-image File Management Archive Directory List (-aiarcdir)
        After-image File Management Archive Directory Create (-aiarcdircreate)
        After-image File Management Archive Interval (-aiarcinterval)
        After-image Buffers (-aibufs)
        After-image Stall (-aistall)
        Blocks in Database Buffers (-B)
        Base Index (-baseindex)
        Base Table (-basetable)
        Before-image Buffers (-bibufs)
        Threshold Stall (-bistall)
        Recovery Log Threshold (-bithold)
        SQL Server Java Classpath (-classpath)
        Cluster Mode (-cluster)
        Conversion Map (-convmap)
        Case Table (-cpcase)
        Collation Table (-cpcoll)
        Internal Code Page (-cpinternal)
        Log File Code Page (-cplog)
        Print Code Page (-cpprint)
        R-code in Code Page (-cprcodein)
        Stream Code Page (-cpstream)
        Terminal Code Page (-cpterm)
        Direct I/O (-directio)
        Event Level (-evtlevel)
        Before-image Cluster Age (-G)
        Group Delay (-groupdelay)
        Host Name (-H)
        Hash Table Entries (-hash)
        No Crash Protection (-i)
        Index Range Size (-indexrangesize)
        Key Alias (-keyalias)
        Key Alias Password (-keyaliaspasswd)
        Lock Table Entries (-L)
        Auto Server (-m1)
        Manual Server (-m2)
        Secondary Login Broker (-m3)
        Maximum Clients per Server (-Ma)
        Maximum area number (-maxAreas)
        Maximum Dynamic Server (-maxport)
        Maximum JTA Transactions (-maxxids)
        Delayed BI File Write (-Mf)
        Minimum Clients per Server (-Mi)
        Minimum Dynamic Server (-minport)
        Maximum Servers (-Mn)
        Servers per Protocol (-Mp)
        Maximum Servers per Broker (-Mpb)
        VLM Page Table Entry Optimization (-Mpte)
        Shared-memory Overflow Size (-Mxs)
        Network Type (-N)
        Number of Users (-n)
        No Session Cache (-nosessioncache)
        Pending Connection Time (-PendConnTime)
        Parameter File (-pf)
        Pin Shared Memory (-pinshm)
        Configuration Properties File (-properties)
        Buffered I/O (-r)
        Service Name (-S)
        Semaphore Sets (-semsets)
        Server Group (-servergroup)
        Session Timeout (-sessiontimeout)
        Shared memory segment size (-shmsegsize)
        Spin Lock Retries (-spin)
        SSL (-ssl)
        Table Range Size (-tablerangesize)
        Century Year Offset (-yy)
Утилиты OpenEdge RDBMS
Виртуальные системные таблиц (VST)

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

Использование параметров запуска

Значение параметров запуска, установленные по умолчанию, можно менять в командной строке или включая новые значения в скрипты запуска. Так же для указания наборов параметров можно использовать файл параметров (.pf).

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

Каждая программ Прогресса использует файл параметров, который по умолчанию называется startup.pf. Этот файл расположен в директории DLC. Он должен находиться там, чтобы Прогресс работал правильно. Вы можете модифицировать этот файл для добавления/изменения набора параметров. Вы можете также создавать один или более дополнительных файлов параметров, которые будут загружены после загрузки startup.pf.

Примечание: В Windows вы можете определять имя файла запуска, используя переменную среды PROSTARTUP в progress.ini или реестре.

Для того чтобы вызвать дополнительный файл параметров, при старте Прогресса в командной строке используйте параметр запуска (–pf).

Вызов файла параметров из командной строки.

В UNIX:

pro sports -pf filename.pf

В Windows:

prowin32 -1 sports -pf filename.pf

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

Вызов файла параметров оператором CONNECT.

Используйте следующий синтаксис для вызова файла параметров оператором CONNECT в процедурах ABL:

CONNECT -pf sports.pf

Например, следующая процедура подключения использует файл параметров new_york.pf:

UPDATE ny_user ny_password BLANK.
CONNECT -pf new_york.pf -U VALUE(ny_user) -P VALUE(ny_passwd) NO-ERROR.
IF NOT CONNECTED("new_york") THEN
MESSAGE "Connection to New York office failed".

Вызов многочисленных файлов параметров

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

Когда подключение происходит к более чем одной базе данных, этот параметр должен быть указан после параметра –db (Physical Database Name). Если соединение происходит к более чем одной базе, то в первой строке будет параметр –db, а в последующих строках – параметры запуска, относящиеся к этой базе данных

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

Пример файла параметров:

-db /usr/disk0/newyork # new york central db
-B 200 # database buffers
-H nysystem -S nyserver # host, service
-L 10000 # lock table entries
# Остальные параметры получают значения по умолчанию

Этот формат используется для всех операционных систем. Следуйте следующим правилам при создании файла параметров:

Устанавливайте параметры и их аргументы в одной строке
Используйте максимум 40 символов в одной строке
Выделите параметры с синтаксисом UNIX
Используйте знак # для выделения комментариев. Прогресс проигнорирует данные в строке, следующие за этим знаком
Заключайте значения в одиночные или двойные кавычки
Параметры запуска не указанные в файле параметров принимают значения по умолчанию
Используйте ~ для определения управляющих символом, таких как указанных в следующей таблице:

Символ	Описание	Код
~nnn	Символ, имеющий восьмеричный код	-
~b	BS символ	~010
~t	HT (горизонтальная таб.)	~011
~n	LF (подача линии)	~012
~r	VT (перевод строки)	~013
~f	FF (подача формы)	~014
~E	ESC	~033

На Unix используйте обратную косую черту (\) вместо тильды (~).

Параметры сервера базы данных OpenEdge

Следующие параметры используются для оптимизации производительности сервера базы данных:

Параметр	Синтаксис	Назначение
After-image Buffers	-aibufs n	Определяет количество after-image буферов для работы AIW
After-image Stall	-aistall	Останавливает активность базы данных в случае отсутствия empty ai - файлов.
Blocks in Database Buffers	-B n	Определяет количество блоков в буферном пуле базы данных
Before-image Buffers	-bibufs n	Определяет количество bi буферов для работы BIW
Threshold Stall	-bistall	Останавливает активность базы данных и записывает сообщение в журнал событий, когда достигнуто пороговое значения размера bi – файла. Используется совместно с параметром –bithold.
Recovery Log Threshold	-bithold n	Определяет максимальный размер BI файла в MB
Direct I/O	-directio	Открывает все файлы в не буферизованном режиме.
Event Level	-evtlevel	Определяет уровень информации записываемой в Windows Application Event Log
Before-image Cluster Age	-G n	Определяет время ожидания в секундах, прежде чем база данных начнет повторно использовать BI кластер.
Group Delay	-groupdelay n	Определяет количество миллисекунда, которые транзакция ожидает перед завершением.
Hash Table Entries	-hash	Определяет количество хеш-таблиц для буферного пула
No Crash Protection	-i	Работа базы данных без обеспечения целостности и восстановления.
Lock Table Entries	-L n	Определяет возможное количество одновременно заблокированных записей.
Maximum Area number	-maxAreas n	Определяет максимальное количество доступных областей хранения
Delayed BI File Write	-Mf n	Задержка записи последнего BI файла с записями.
VLM Page Table Entry Optimization¹	-Mpte	Размещает разделяемую память кратную 8MB для поддержки VLM64.
Shared-memory Overflow Size	-Mxs n	Заменяет значение по умолчанию для области переполнения разделяемой памяти
Number of Users	-n n	Определяет максимальное количество пользователей, подключаемых к базе данных
Pin Shared Memory	-pinshm	Предотвращает подкачку содержимого разделяемой памяти на диск.
Semaphore Sets²	-semsets n	Изменение количества наборов семафоров доступных брокеру.
Shared memory segment size	-shmsegsize n	Определяет максимальный размер сегмента разделяемой памяти
Spin Lock Retries	-spin n	Определяет количество попыток процесса приобрести блокировку разделяемого ресурса перед началом паузы.

^1. Только Compaq Tru64.
^2. Только UNIX.

Параметры типов серверов

Используйте следующие параметры для указания типа сервера:

Параметр	Синтаксис	Назначение
Auto Server	-m1	Запуск автоматических серверов. Используется внутри брокера базы данных.
Manual Server	-m2	Ручной запуск сервера, после запуска брокера.
Secondary Login Broker	-m3	Запуск второстепенного брокера

Параметр интернационализации сервера базы данных

Следующие параметры используются для управления форматом работы с данными:

Параметр	Синтаксис	Назначение
Conversion Map	-convmap filename	Определяет conversion map
Case Table	-cpcase tablename	Определяет case table
Collation Table	-cpcoll tablename	Определяет collation table
Internal Code Page	-cpinternal codepage	Определяет кодовую страницу, используемую в памяти
Log File Code Page	-cplog codepage	Определяет кодовую страницу, используемую для записи сообщений в журнал событий.
Print Code Page	-cpprint codepage	Определяет кодовую страницу, используемую для вывода на печать
R-code in Code Page	-cprcodein codepage	Определяет кодовую страницу для чтения текстовых сегментов r-code.
Stream Code Page	-cpstream codepage	Опредлеяет кодовую страницу, используемую для потокового I/O.
Terminal Code Page	-cpterm codepage	Определяет кодовую страницу для символьного терминала

Параметры статистики сервера базы данных

Следующие параметры используется для сбора статистики по использованию таблиц и индексов базы данных:

Параметр	Синтаксис	Назначение
Base Index	-baseindex n	Определяет диапазон индексов, по которым собирается статистика. Используется совместно с параметром –indexrangesize.
Base Table	-basetable n	Определяет начальный номер таблицы начиная с которого будет собираться статистика в диапазоне таблиц. Используется совместно с параметром –tablerangesize.
Index Range Size	-indexrangesize n	Определяет количество индексов по которым будет собираться статистика.
Table Range Size	-tablerangesize n	Определяет количество таблиц по которым будет собираться статистика.

Параметр SSL подключения к базе данных

Используйте следующие параметры для управления использованием SSL:

Параметр	Синтаксис	Назначение
SSL	-ssl	Требует чтобы все подключения к брокеру использовали SSL протокол. Примечание: SSL сильно влияет на производительность в зависимости от используемого клиента, сервера, сетевых ресурсов и загрузки системы.
Key Alias	-keyalias key-alias-name	Определяет имя алиаса для private key и цифрового сертификата
Key Alias Password	-keyaliaspasswd key-alias-password	Определяет зашифрованный пароль для ключа алиаса
No Session Cache	-nosessioncache	Отключение использования SSL кэширования сессий
Session Timeout	-sessiontimeout n	Определяет отрезок времени в секундах, после которого SSL сессия кэшируется

Сетевые параметры сервера базы данных

Следующие параметры используется для установке брокеру необходимых сетевых настроек:

Параметр	Синтаксис	Назначение
AdminServer Port	-adminport { service-name \| port }	Соединение серверной группы и AdminServer
SQL Server Java™ Classpath	-classpath pathname	Определяет путь к Java™ используемым при старте SQL сервера
Host Name	-H host-name	Определяет удаленный хост
Maximum Clients Per Server	-Ma n	Определяет максимальное количество удаленных пользователей на сервер базы данных
Maximum Dynamic Server	-maxport n	Определяет верхний предел доступных портов в определенном диапозоне
Minimum Clients Per Server	-Mi n	Определяет минимальное количество удаленных пользователей на сервере, по достижении которого брокер может запустить дополнительный сервер.
Minimum Dynamic Server	-minport n	Определяет минимальный доступный порт в диапазоне портов
Maximum Servers	-Mn n	Определяет максимальное количество запускаемых брокером серверов для удаленных клиентов
Servers Per Protocol	-Mp n	Определяет максимальное количество серверов, обслуживающих удаленных пользователей, по одному протоколу
Maximum Servers Per Broker	-Mpb n	Определяет максимальное количество серверов, которые могут запустить брокеры для обслуживания удаленных клиентов по одному протоколу
Network Type	-N network-type	Определяет сетевой протокол соединения
Pending Connection Time	-PendConnTime n	Определяет количество времени, в течении которого клиент может соединиться с сервером, прежде чем брокер аннулирует резервирование этого клиента.
Configuration Properties File	-properties filename	Определяет файл свойств для AdminServer используемый при запуске сервера или группы серверов
Service Name	-S { service-name \| port-number }	Определяет сервис или номер порта используемый процессом брокера
Server Group	-servergroup name	Определяет логически объединенные процессы сервера для запуска
Century Year Offset	-yy n	Определяет начало столетнего периода, в котором в дате год указан двумя цифрами

Категории использования параметров запуска

Как говорилось ранее, параметры запуска делятся на следующие категории:

Тип использования	Назначение
Client Session (CS)	Запуск клиентских сессий
Client Session (CS)	Подключения к определенным базам данных
OpenEdge Database Server (DBS)	Запуск сервера или брокера
DataServer (DS)	Запуск серверов данных (DataServres) для работы с не OpenEdge базами данных

Некоторые параметры могут входить в более чем одну категорию.

Алфавитный список параметров запуска базы данных

Здесь детально описываются параметры запуска сервера базы данных OpenEdge (DBS) и клиентских подключения (CC). Описание параметров начинается с таблицы, отображающей синтаксис параметра, а затем начинается подробное его описание.

AdminServer Port (-adminport)

Операционная система и синтаксис:	UNIX, WINDOWS	-adminport service-name port
Категория	Макс. Значение	Мин. Значение	Single-user default	Multi-user default
DBS	-	-	-	-

service-name
имя сервиса, которое использует AdminServer
port
номер порта, который использует AdminServer для связи серверной группы. По умолчанию 7832.

Параметр используется для установления связи между серверной группой и AdminServer. AdmiServer использует это параметр непосредственно. Значение параметр –adminport должно соответствовать параметру –admin, который использовался при запуске AdminServer.

After-image File Management Archive Directory List (-aiarcdir)

Операционная система и синтаксис:	UNIX, WINDOWS	-aiarcdir dirlist
Категория	Макс. Значение	Мин. Значение	Single-user default	Multi-user default
DBS	-	-	-	-

dirlist
Список каталогов, разделенных запятой, используемых для архивации ai – файлов формируемых AI File Management Utility. Имя каталогов не должны содержать пробелов.

Перед определением каталогов убедитесь, что они действительно существуют, в противном случае, лучше использовать параметр –aiarcdir совместно с параметром –aiarcdircreate, который при необходимости, создаст необходимые каталоги. Это параметр имеет смысл только при работе AI File Management.

After-image File Management Archive Directory Create (-aiarcdircreate)

Операционная система и синтаксис:	UNIX, WINDOWS	-aiarcdircreate
Категория	Макс. Значение	Мин. Значение	Single-user default	Multi-user default
DBS	-	-	-	-

Использование этого параметра гарантирует, что утилитой AI File Management будут созданы каталоги, определенные параметром –aiarcdir, в случае их отсутствия. Это параметр имеет смысл только при работе AI File Management.

After-image File Management Archive Interval (-aiarcinterval)

Операционная система и синтаксис:	UNIX, WINDOWS	-aiarcinterval n
Категория	Макс. Значение	Мин. Значение	Single-user default	Multi-user default
DBS	86400	120	-	120

^1. для синхронизированного метода, минимальное значение – 120. Для асинхронного метода, не указывайте этот параметр.

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

Минимальное время это 2 минуты, максимально – 24 часа. Если параметр не используется, то принудительное переключение экстентов возможно с помощью RFUTIL. Не зависимо от выбранного метода, архивирование заполненных ai экстентов происходит каждые пять секунд. Это параметр имеет смысл только при работе AI File Management.

After-image Buffers (-aibufs)

Операционная система и синтаксис:	UNIX, WINDOWS	-aibufs n
Категория	Макс. Значение	Мин. Значение	Single-user default	Multi-user default
DBS	-	1	-	20

n
количество after-image буферов.

Используйте этот параметр для установки количества ai - буферов. Этот параметр полезен только при работе AIW, поскольку он записывает заполненные ai – буфера на диск, тем самым обеспечивая доступность свободных буферов другим клиентам и процессам. Попробуйте, для начала, установить значение –aibufs в 1,5 раза больше чем значение параметра –bibufs или равное минимум 5.

Без работы AIW, любое изменение количества ai – буферов будет не значительно для базы данных.

After-image Stall (-aistall)

Операционная система и синтаксис:	UNIX, WINDOWS	-aistall
Категория	Макс. Значение	Мин. Значение	Single-user default	Multi-user default
DBS	-	-	-	-

Используйте этот параметр для приостановления активности базы данных когда все ai – файлы станут заполненными. –aistall прекращает любую активность в базе данных, пока AI экстенты не будут освобождены (empty) и вносит записи в журнал событий базы данных:

Can’t switch to after-image extent filename it is full. (3775)
Backup ai extent and mark it as empty (3776)

При использовании After-image файлов, всегда контролируйте их состояние, чтобы гарантировать, что ai – экстенты всегда будут доступны и не заполнятся все, заставляя останавливать активность базы. Без использования этого параметра, при заполнении всех ai – экстентов, база данных будет остановлена.

Blocks in Database Buffers (-B)

Операционная система и синтаксис:	UNIX, WINDOWS	-B n
Категория	Макс. Значение	Мин. Значение	Single-user default	Multi-user default
СС, DBS	1000000000 или 1250000001	10	20	(8 * -n) или 3000

^1. 1 000 000 000 для 64 битных платформ; 125 000 000 для 32 битных платформ. Максимальное значение также зависит от имеющихся ограничений операционной системы и доступной памяти.

n
количество блоков в буферном пуле базы данных.

Используйте этот параметр для указания количества блоков доступных буферному пулу базы данных. Оптимальное значение зависит от ваших приложений.

Base Index (-baseindex)

Операционная система и синтаксис:	UNIX, WINDOWS	-baseindex n
Категория	Макс. Значение	Мин. Значение	Single-user default	Multi-user default
DBS	-	-	-	-

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

Используйте Base Index (-baseindex) с параметром Index Range Size (-indexrangesize) для установки диапазона индексов, необходимых для сбора статистики. Для осуществления сбора статистики, используются Virtual System Tables (VST), статистика индексов хранится в таблице _IndexStat. Для получения номеров индексов, можно использовать следующий ABL код:

FOR EACH _file:
       DISPLAY _file._file-name.
       FOR EACH _index WHERE _index._file-recid = RECID(_file):
               DISPLAY _idx-num _index-name.
       END.
END.

Результат будет следующим:

File-Name
Filename

_idx-num Index-Name
       n1    index name1
       n2    index name2
       n3    index name3

Base Table (-basetable)

Операционная система и синтаксис:	UNIX, WINDOWS	-basetable n
Категория	Макс. Значение	Мин. Значение	Single-user default	Multi-user default
DBS	-	-	-	-

n
начальный номер таблицы в диапазоне таблиц для сбор статистики.

Используйте этот параметр совместно с параметром Table Range Size (-tablerangesize) для установки диапазона таблиц, необходимых для сбора статистики. Для осуществления сбора статистики, используются Virtual System Tables (VST), статистика таблиц хранится в таблице _TableStat. Для получения номеров таблиц, можно использовать следующий ABL код:

FOR EACH _file:
DISPLAY _file-num _file.
END.

Результат будет следующим:

_File-Number File-Name
       n1 table name1
       n2 table name2
       n3 table name3

Before-image Buffers (-bibufs)

Операционная система и синтаксис:	UNIX, WINDOWS	-bibufs n
Категория	Макс. Значение	Мин. Значение	Single-user default	Multi-user default
DBS	-	3	-	20

n
количество bi – буферов

Используйте параметр Before-image Buffers (-bibufs) для указания количество bi – буферов. Этот параметр полезен только если запущен Before-image Writer (BIW). BIW выполняет запись заполненных bi - буферов на диск, помечая буфера как пустые, а следовательно доступные другим клиентам и процессам. Без процесса BIW увеличение количества буферов будет иметь незначительный характер.

Threshold Stall (-bistall)

Операционная система и синтаксис:	UNIX, WINDOWS	-bistall
Категория	Макс. Значение	Мин. Значение	Single-user default	Multi-user default
DBS	-	-	-	-

Используйте параметр Threshold Stall (-bistall) совместно с параметром Recovery Log Threshold (-bithold) для приостановления активности базы данных, в случае заполнения всех bi – буферов, не прибегая к аварийному останову базы данных. При достижении порогового значения bi – файла, активность базы данных будет приостановлена, а в журнал событий будет внесена соответствующая запись.

Recovery Log Threshold (-bithold)

Операционная система и синтаксис:	UNIX, WINDOWS	-bithold n
Категория	Макс. Значение	Мин. Значение	Single-user default	Multi-user default
DBS	Зависит от системы¹	Зависит от системы¹	-	-

¹. Ограничено размером доступного дискового пространства.

n
целочисленное значение порогового значения в MB.

Используйте этот параметр для ограничения роста максимального размера BI файла. Рекомендуемое значение, это от 3% до 100 % от возможного размера BI файла, округленного до ближайшего кластера. Как только этот порог будет достигнут, база данных будет аварийно остановлена. Используйте совместно с этим параметром, параметр –bistall, и в результате, база данных не будет остановлена, а лишь будет приостановлена ее активность, пока BI экстенты не будут освобождены.

SQL Server Java Classpath (-classpath)

Операционная система и синтаксис:	UNIX, WINDOWS	-classpath pathname
Категория	Макс. Значение	Мин. Значение	Single-user default	Multi-user default
DBS	-	-	-	-

pathname
Определяет путевое имя для classpath.

Параметр используется для определения Java classpath, используемый при старте SQL сервера. SQL брокер базы данных использует этот параметр при запуске Java Virtual Machine (JVM) для выполнения хранимых процедур. По умолчанию, используется переменная окружающей среды CLASSPATH. Вы не можете использовать этот параметр непосредственно.

Cluster Mode (-cluster)

Операционная система и синтаксис:	UNIX, WINDOWS	-cluster qualifier
Категория	Макс. Значение	Мин. Значение	Single-user default	Multi-user default
DBS	-	-	-	-

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

Следующая таблица показывает возможны значения для qualifier:

Значение	Описание
startup	Указывает брокеру о необходимости переадресации запроса запуска кластерному менеджеру операционной системы. Кластерный менеджер запустит базу данных в соответствии с предоставленной информацией при активации кластерной защиты.
protected	Указывает брокеру запустить базу данных в составе кластера. Это значение используется кластерным менеджером с использованием файла параметров и указывает на то, что база данных будет защищена кластером в случае failover.

Параметр –cluster требует активации базы данных для работы в кластере. Если база данных не будет включена в кластер, параметр будет проигнорирован.

Conversion Map (-convmap)

Операционная система и синтаксис:	UNIX, WINDOWS	-convmap fiename
Категория	Макс. Значение	Мин. Значение	Single-user default	Multi-user default
CS, DBS	-	-	-	-

filename
путь к файлу CONVMAP.

Используйте параметр Conversion Map (-convmap) для идентификации CONVMAP файла используя его для code page conversions, collation orders и case conversions. По умолчанию, используется файл convmap.cp, находящийся в инсталляционном каталоге OpenEdge. Создать свой CONVMAP файл можно используя утилиту PROUITL с классификатором CODEPAGE-COMPILER.

Case Table (-cpcase)

Операционная система и синтаксис:	UNIX, WINDOWS	-cpcase tablename
Категория	Макс. Значение	Мин. Значение	Single-user default	Multi-user default
CS, DBS	-	-	Basic	Basic

tablename
имя case table в файле convmap.cp.

Используется для определения case table. Эта таблица устанавливает case rules для кодовой страницы в памяти, которая указывается параметром Internal Code Page (-cpinternal). Case rules используются функциями CAPS и LC. Также в символьном формате поля вы можете использовать восклицательный знак (!), чтобы преобразовывать все символы в верхний регистр во время ввода.

Для извлечения значения этого параметра во время работы, используйте System handle – SESSION.

Collation Table (-cpcoll)

Операционная система и синтаксис:	UNIX, WINDOWS	-cpcoll tablename
Категория	Макс. Значение	Мин. Значение	Single-user default	Multi-user default
CS, DBS	-	-	Basic	Basic

tablename
имя collation table в файле convmap.cp.

Параметр Collation Table (-cpcoll) идентифицирует сопоставляемую таблицу с кодовой таблицей в памяти, которая указывается параметром Internal Code Page (-cpinternal).

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

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

Для извлечения значения этого параметра во время работы, используйте System handle – SESSION.

Internal Code Page (-cpinternal)

Операционная система и синтаксис:	UNIX, WINDOWS	-cpinternal codepage
Категория	Макс. Значение	Мин. Значение	Single-user default	Multi-user default
CS, DBS, DS	-	-	iso8859-1	iso8859-1

codepage
Имя кодовой страницы используемой в памяти.

Параметр используется для идентификации кодовой страницы, используемой в памяти и для графических клиентов. Для графических клиентов, должна быть установлена та же кодовая страница, что используется операционной системой. По умолчанию, если параметр не используется, устанавливается кодовая страницы – iso8859-1. Для извлечения значения этого параметра во время работы, используйте System handle – SESSION с атрибутом CPINTERNAL.

Примечание: не используйте для параметра –cpinternal, 7 битные таблицы. 7 битные таблицы используются для преобразования данных из 7 битных в другие кодовые страницы. Нельзя использовать их для символьных преобразований в памяти и для баз данных.

Log File Code Page (-cplog)

Операционная система и синтаксис:	UNIX, WINDOWS	-cplog codepage
Категория	Макс. Значение	Мин. Значение	Single-user default	Multi-user default
CS, DBS, DS	-	-	-cpstream	-cpstream

codepage
Имя кодовой страницы используемой для записи сообщений в журнал событий базы данных.

Используется для указания кодовой страницы записываемых сообщений в журнал событий базы данных (.lg)ю Если значение не определено, по умолчанию определяется кодовая страница из параметра Stream Code Page (-cpstream).

Для извлечения значения этого параметра во время работы, используйте System handle – SESSION с атрибутом CPLOG.

Print Code Page (-cpprint)

Операционная система и синтаксис:	UNIX, WINDOWS	-cpprint codepage
Категория	Макс. Значение	Мин. Значение	Single-user default	Multi-user default
CS, DBS, DS	-	-	-cpstream	-cpstream

codepage
Имя кодовой страницы используемой для вывода на печать.

Используется для указания кодовой страницы для печати. При печати, кодовая страница в –cpprint имеет приоритет перед значением в параметре –cpstream.

Для извлечения значения этого параметра во время работы, используйте System handle – SESSION.

R-code in Code Page (-cprcodein)

Операционная система и синтаксис:	UNIX, WINDOWS	-cprcodein codepage
Категория	Макс. Значение	Мин. Значение	Single-user default	Multi-user default
CS, DBS, DS	-	-	-cpinternal	-cpinternal

codepage
Имя кодовой страницы используемой для чтения текстовых сегментов r-code файлов.

Используйте R-code In Code Page (-cprcodein), чтобы читать текстовые сегменты r-кода, написаные в кодовой странице, указанной –cprcodein, в кодовую страницу, указанную парметром Internal Code Page (-cpinternal).

Внимание: этот параметр предназначен для очень редких ситуаций, и обычно не используется.

OpenEdge RDBMS читает текстовые сегменты так, как будто они написаны в кодовой странице параметр –cprcodein, даже если они на самом деле написаны в иной кодовой странице. Например, если вы используете следующие параметры запуска и запускаете r-код написанный в кодировке IBM850, текстовые сегменты будут конвертированы из кодовой страницы ISO8859-1 в ibm861. Это может привести к некорректным результатам, поскольку правильная кодировка IBM850:

-cprcodein ISO8859-1 -cpinternal ibm861

Для извлечения значения этого параметра во время работы, используйте System handle – SESSION. Для определения кодовой страницы r-код файла, используйте RCODE-INFO.

Stream Code Page (-cpstream)

Операционная система и синтаксис:	UNIX, WINDOWS	-cpstream codepage
Категория	Макс. Значение	Мин. Значение	Single-user default	Multi-user default
CS, DBS, DS	-	-	ibm850	ibm850

codepage
Имя кодовой страницы используемой потокового ввода/вывода (I/O).

Используется для работы с потоками. Символьные терминалы используют кодовую страницу –cpstream, если не определены значения параметров Terminal Code Page (-cpterm), Print Code Page (-cpprint) или Log File Code Page (-cplog).

Поток ввода/вывода состоит из следующих элементов:

Терминалы (включая символьные терминалы и DOS Protected режим, но не включают графические интерфейсы или символьные интерфейсы Windows).
Файлы данных (.d).
Методы виджета EDITOR – READ-FILE, WRITE-FILE и INSERT-FILE.
Операторы INPUT FROM и OUTPUT TO.
Все компилируемые файлы (например, .p, .w, .i).
Файлы, генерируемы компилятором, - LISTING, XREF и PREPROCESS.

Примечание: не используйте для параметра –cpinternal, 7 битные таблицы. 7 битные таблицы используются для преобразования данных из 7 битных в другие кодовые страницы. Нельзя использовать их для символьных преобразований в памяти и для баз данных.

Для извлечения значения этого параметра во время работы, используйте System handle – SESSION. Для определения кодовой страницы r-код файла, используйте RCODE-INFO.

Terminal Code Page (-cpterm)

Операционная система и синтаксис:	UNIX, WINDOWS	-cpterm codepage
Категория	Макс. Значение	Мин. Значение	Single-user default	Multi-user default
CS, DBS, DS	-	-	-cpstream	-cpstream

codepage
Имя кодовой страницы используемой символьными терминалами.

Этот параметр позволяет определять другую кодовую страницу, чем ту которую использует другие потоки ввода/вывода, указанную параметром Stream Code Page (-cpstream).

Примечание: для параметр –cpterm можно использовать 7 битные кодировки.

Для извлечения значения этого параметра во время работы, используйте System handle – SESSION. Для определения кодовой страницы r-код файла, используйте RCODE-INFO.

Direct I/O (-directio)

Операционная система и синтаксис:	UNIX, WINDOWS	-directio
Категория	Макс. Значение	Мин. Значение	Single-user default	Multi-user default
CS, DBS	-	-	Not enabled	Not enabled

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

Вы можете улучшить производительность, используя этот параметр. При использовании параметра -directio, необходимо увеличить размер буферного пула базы данных (-B), поскольку база данных не будет использовать буферный пул операционной системы. Соответственно, имеет смысл уменьшить размер буферного пула операционной системы, дабы компенсировать увеличение использование памяти базой данных.

Примечание: используйте Asynchronous Page Writers (APWs). Они улучшат производительность, выполняя операции разгрузки в фоновом режиме.

Event Level (-evtlevel)

Операционная система и синтаксис:	UNIX, WINDOWS	-evtlevel value
Категория	Макс. Значение	Мин. Значение	Single-user default	Multi-user default
CS, DBS	-	-	Normal	Normal

value
Используется для регулирования уровня записываемой информации в Windows Application Event Log.

Возможные значения:

None – запись событий не производится.
Brief – записываются сообщений об ошибках и предупреждения.
Normal – Сообщения об ошибках и предупреждения записываются в Event Log на ровне со всем другими сообщениями, пишущимися в журнал событий базы данных (.lg). Это значение по умолчанию.
Full – в Event Log пишутся все общения, включая ошибки, предупреждения, информационные сообщения и прочие сообщения, генерируемые Message Statement.

Before-image Cluster Age (-G)

Операционная система и синтаксис:	UNIX, WINDOWS	-G n
Категория	Макс. Значение	Мин. Значение	Single-user default	Multi-user default
DBS	32	-	60	60

n
время ожидания менеджера базы данных, в секундах.

Указывает время в секундах, которое ожидает менеджер базы данных, прежде чем заново использовать before-image кластер.

Group Delay (-groupdelay)

Операционная система и синтаксис:	UNIX, WINDOWS	-groupdelay n
Категория	Макс. Значение	Мин. Значение	Single-user default	Multi-user default
DBS	1000	-	-	1

n
количество секунд, ожидаемое транзакций перед завершением.

Используется для улучшения производительности, когда параметр Delayed BI File Write (-Mf) установлен в ноль. Когда Group Delay установлено в значение большее чем ноль, менеджер базы данных использует технику известную как Group Commit. При использовании Group Commit, транзакция буферизует свои примечания в BI файл и ожидает некоторое время, пока буфер не будет заполнен и сброшен на диск, или ожидает появления другой завершающейся транзакции, чтобы за один раз несколько транзакций были завершены одной синхронной записью. В таком режиме, Group Commit улучшает производительность в целом, хотя время выполнения индивидуальной транзакции и увеличивается.

Host Name (-H)

Операционная система и синтаксис:	UNIX, WINDOWS	-H { host-name \| localhost¹ }
Категория	Макс. Значение	Мин. Значение	Single-user default	Multi-user default
CS, DBS, DS	-	-	-	-

¹. localhost не может быть применен для DataServer`ов.

host-name
   Имя (адрес) машины сервера базы данных. Это имя устанавливается на машине в фале TCP/IP hosts.

localhost
   Зарезервированное слово, которое определяет, что Database сервер связывается только с клиентами на машине сервера базы данных.

Hash Table Entries (-hash)

Операционная система и синтаксис:	UNIX, WINDOWS	-hash n
Категория	Макс. Значение	Мин. Значение	По умолчанию
CC, DBS	-	-	Приблизительно ј от значения –B.

n
количество хеш-таблиц используемых в буферном пуле.

Внимание: не используйте параметр –hash если это не предложено технической поддержкой.

No Crash Protection (-i)

Операционная система и синтаксис:	UNIX, WINDOWS	-i
Категория	Макс. Значение	Мин. Значение	По умолчанию
CC, DBS	-	-	-

Параметр применяется для запуска базы данных без обеспечения целостности и без работы механизмов восстановления. При его использовании, менеджер базы меньше записывает данных и bi блоков на диск. В этом режиме, некоторые процедуры (например, которые вносят большое количество изменений) работают значительно быстрее.

При запуске с параметром –i, поддержка отката транзакций остается. Следовательно, bi файл все еще используется, и он может по прежнему сильно вырасти в следствии работы долгоиграющей транзакции.

Используйте этот параметр для bulk data loading или для больших фоновых работ. Это так же уменьшает количество дисковых операции ввода и вывода. Первоначальная загрузка данных в базу, это хороший пример для использования параметра.

Внимание: Если в базе данных, запущенной с параметром –i, во время работы возникнут какие-либо ошибки, то восстановить ее вы сможете только из резервной копии.

Не используйте параметр –i, если у вас нет полной резервной копии базы данных и вы можете повторно запустить процедуру в случае системного сбоя. Если системный сбой произошел во время работы процедуры на базе данных с параметром –i, то восстановите базу данных и повторите запуск процедуры, предварительно устранив причины сбоя.

Index Range Size (-indexrangesize)

Операционная система и синтаксис:	UNIX, WINDOWS	-indexrangesize n
Категория	Макс. Значение	Мин. Значение	Single-user default	Multi-user default
DBS	-	-	-	-

n
количество индексов по которым будет собираться статистика.

Используется для определения количества индексов, по которым будет собираться статистика из виртуальных таблиц (VST).

Key Alias (-keyalias)

Операционная система и синтаксис:	UNIX, WINDOWS	-indexrangesize n
Категория	Макс. Значение	Мин. Значение	Single-user default	Multi-user default
DBS	-	-	-	default_server

key-alias-name
определяет используемое имя псевдонима для SSL private key/digital certificate в хранилище ключей.

Используется для указания псевдонима private - ключа или цифрового сертификата в хранилище ключей, вместо используемого по умолчанию.

Key Alias Password (-keyaliaspasswd)

Операционная система и синтаксис:	UNIX, WINDOWS	-keyaliaspasswd key-alias-password
Категория	Макс. Значение	Мин. Значение	Single-user default	Multi-user default
DBS	-	-	-	password¹

¹. Использованная фактическая величина является закодированной величиной строки “password”.

key-alias-password
определяет закодированный пароль псевдонима ключа SSL, для использования цифрового сертификата или private – ключа.

Используется для доступа к Key Alias, если Key Alias отличный от установленного по умолчанию. Значение key-alias-password должно быть зашифрованным. Для шифрования пароля можно использовать утилиту genpassword, находящуюся в каталоге bin установочного каталога OpenEdge.

Lock Table Entries (-L)

Операционная система и синтаксис:	UNIX, WINDOWS	-L n
Категория	Макс. Значение	Мин. Значение	Single-user default	Multi-user default
DBS	Ограничено доступной памятью	32	-	8192

n
количество одновременно блокируемых записей в таблице. Если значение будет указано не кратное 32, оно автоматически будет округлено в верх до ближайшего значения кратного 32.

Используется для ограничения количества одновременно блокируемых записей таблиц. На блокировку влияют SHARE-LOCK и EXCLUSIVE-LOCK. Увеличьте количество возможных блокировок если вы получили следующее сообщение:

SYSTEM ERROR: Record lock table too small. Increase -L parameter.

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

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

Заметьте, что при использовании оператора BREAK BY ( в DO, FOR EACH или REPEAT) блокируются две записи.

Каждая блокировка использует 64 байта.

Auto Server (-m1)

Операционная система и синтаксис:	UNIX, WINDOWS	-m1
Категория	Макс. Значение	Мин. Значение	Single-user default	Multi-user default
DBS	-	-	-	-

Используется для запуска авто сервера. OpenEdge использует авто сервер внутренне, для запуска удаленных пользовательских серверов. Это используется по умолчанию. Вы ни когда не должны использовать этот параметр непосредственно.

Manual Server (-m2)

Операционная система и синтаксис:	UNIX, WINDOWS	-m2
Категория	Макс. Значение	Мин. Значение	Single-user default	Multi-user default
DBS	-	-	-	-

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

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

Secondary Login Broker (-m3)

Операционная система и синтаксис:	UNIX, WINDOWS	-m3
Категория	Макс. Значение	Мин. Значение	Single-user default	Multi-user default
DBS	-	-	-	-

В сетевой среде, в которой более чем один брокер может использовать тот же протокол, используется параметр Secondary Login Broker (-m3) для запуска каждого вторичного брокера. Вторичный брокер так же регистрирует клиентов и запускает сервера удаленных пользователей.

Maximum Clients per Server (-Ma)

Операционная система и синтаксис:	UNIX, WINDOWS	-Ma n
Категория	Макс. Значение	Мин. Значение	Single-user default	Multi-user default
DBS	2048	1	-	5 users/server

n
максимальное количество пользователь на сервер базы данных. Значение по умолчанию определяется делением значения параметра Maximum Number of Users (-n) на значение параметра Maximum Number of Servers (-Mn).

Параметры Maximum Clients per Server (-Ma), Minimum Clients per Server (-Mi) и Maximum Servers (-Mn) используются только для баз доступных удаленным клиентам.

В большинстве случаев, заданное значение по умолчанию достаточно. Обратите внимание, что оно обычно очень высоко, потому что предполагается, что все пользователи являются удаленными, в то время как значение параметр –n включает и локальных пользователей. Если сервера окажутся перегруженными клиентами, изменить параметр –Mn для увеличения количества серверов.

Maximum area number (-maxAreas)

Операционная система и синтаксис:	UNIX, WINDOWS	-maxAreas n
Категория	Макс. Значение	Мин. Значение	Single-user default	Multi-user default
DBS	32000	Максимальное значение имеющих областей	32000	32000

n
максимальное количество областей.

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

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

При расширении базы данных с помощью PROSTRCT ADDONLINE, номера добавляемых областей должны быть меньше указанного предела параметром –maxAreas, в противном случае база данных не будет запущена.

Maximum Dynamic Server (-maxport)

Операционная система и синтаксис:	UNIX, WINDOWS	-maxport n
Категория	Макс. Значение	Мин. Значение	Single-user default	Multi-user default
DBS	Ограничено системой	Ограничено системой	-	2000

n
самый верхний номер порта в диапазоне портов.

Максимальный номер порта доступный для доступа клиентов к базе данных. Минимальный порт определяется параметром –minport. Сформированный параметрами –minport и –maxport диапазон портов, обеспечивает доступ клиента к серверу OpenEdge, через firewall. Некоторые операционные системы могут использовать порты из диапазона от 32 768 до 65 535. Использование портов из этого диапазона может привести к нежелательным результатам.

Maximum JTA Transactions (-maxxids)

Операционная система и синтаксис:	UNIX, WINDOWS	-maxxxids n
Категория	Макс. Значение	Мин. Значение	Single-user default	Multi-user default
DBS	32000	0, (-n/2)	-	100

n
максимальное количество одновременно работающих JTA транзакций.

JTA транзакции передаются для управления внешним транзакционным менеджером, для контроля выполнения и оката. OpenEdge SQL поддерживает Java Transaction API (JTA) таким образом, чтобы функционировать как менеджер ресурсов, как это определено в J2EE. Поскольку транзакции управляются внешним транзакционным менеджером, они могут работать достаточно долго. Используйте параметр –maxxxids для контроля одновременно работающих транзакций.

Delayed BI File Write (-Mf)

Операционная система и синтаксис:	UNIX, WINDOWS	-Mf n
Категория	Макс. Значение	Мин. Значение	Single-user default	Multi-user default
DBS	32 768	0	0¹	3

¹. по умолчанию 3 для фонового выполнения

n
Значение задержки в секундах прежде чем менеджер базы данных синхронно запишет на диск последние записи в BI файле в конце каждой транзакции. Он так же определяет интервал между проверками процессом брокера BI файла предмет записи изменения на диск. По умолчанию, установлено значение 3 для фоновых однопользовательских процессов и многопользовательских баз. В других случаях значение равно нулю (0).

Используйте этот параметр для улучшения производительности сильно загруженных систем. Использование –Mf не влияет на целостность базы данных. Тем не менее, при возникновении системного сбоя, есть вероятность потери последних нескольких транзакций (транзакции просто не успевают записаться в BI файл).

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

Не используйте параметр –Mf с незначительной загрузкой системы и активность базы. В этих случаях, дополнительные записи BI файла очень важны и не несут ни какой потери производительности. Но на сильно загруженных системах, BI запись менее важна и значительно ухудшает производительность (BI блоки в любом случае, достаточно быстро будут записаны на диск). Установка параметра –Mf, задерживает дополнительную BI запись, сохраняя одно действие записи на транзакцию, что значительно улучшает производительность. По умолчанию задержка записи BI файла имеется у фоновых процессов.

Последняя запись в BI файл только гарантирует запись на диск, когда пользователь покинет систему, или сервер или брокер будет нормально остановлен. Во многопользовательских системах, аргумент n определяет максимальный период в секундах, в течении которого завершенная транзакция может быть потеряна.

Minimum Clients per Server (-Mi)

Операционная система и синтаксис:	UNIX, WINDOWS	-Mi n
Категория	Макс. Значение	Мин. Значение	Single-user default	Multi-user default
DBS	-	1	-	1

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

Поскольку удаленные пользователи работают входят в базу, процесс брокера запускает только один процесс сервера для каждых n удаленных пользователей, пока максимальное количество серверов не будет достигнуто (-Mn). Если вы укажите значение 1 для –Mi, брокер будет запускать сервер для каждого удаленного пользователя. Последующие подключения удаленных пользователей, равномерно распределяется между запущенными серверами, пока не будет достигнут максимальный предел количества пользователей (-n) или максимальное количество пользователей на сервере (-Ma).

Обычно, можно оставить параметры –Mi и –Mn со значениями по умолчанию. Но если вы значительно увеличите –Mn, вам нужно увеличить и –Mi. Например, Если вы устанавливаете –Mn равным 10 для размещения 40 и более удаленных пользователей, увеличьте –Mi до 3 или 4, чтобы предотвратить ситуацию, когда 10 серверов будут запущены только для 10 удаленных пользователей.

Minimum Dynamic Server (-minport)

Операционная система и синтаксис:	UNIX, WINDOWS	-minport n
Категория	Макс. Значение	Мин. Значение	Single-user default	Multi-user default
DBS	-	1 025	-	1 025

n
самый младший номер порта в определенном диапазоне.

Минимальный номер порта доступный клиенту для подключения. Максимальное значение определяется параметром –maxport. Порты с номерами ниже 1025 обычно зарезервированы для систем TCP и UDP. Сформированный параметрами –minport и –maxport диапазон портов, обеспечивает доступ клиента к серверу OpenEdge, через firewall. Использование этого диапазона возможно только при ограничении доступа к серверу.

Maximum Servers (-Mn)

Операционная система и синтаксис:	UNIX, WINDOWS	-Mn n
Категория	Макс. Значение	Мин. Значение	Single-user default	Multi-user default
DBS	512	1	-	4

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

Используйте это параметр для ограничения количества серверов удаленных клиентов. Это вариант рассматривается когда множество серверов перегружены из-за большего количества клиентов. Параметр используется только для база данных, доступных удаленным клиентам. Так же, используйте параметр –Mi для регулирования актуального количества используемых серверов.

Servers per Protocol (-Mp)

Операционная система и синтаксис:	UNIX, WINDOWS	-Mp n
Категория	Макс. Значение	Мин. Значение	Single-user default	Multi-user default
DBS	Значение –Mn	1	-	Значение –Mn

n
количество серверов, которые может запустить брокера.

Параметр –Mp с параметром –m3 используется в сетях, которые работают с более чем одним протоколом. Этот параметр ограничивает количество серверов, которые брокер может запустить для одного протокола. Общее количество серверов для всех протоколов ограничено параметром –Mn.

Maximum Servers per Broker (-Mpb)

Операционная система и синтаксис:	UNIX, WINDOWS	-Mpb n
Категория	Макс. Значение	Мин. Значение	Single-user default	Multi-user default
DBS	-	-	-	-

n
количество серверов которые может запустить каждый брокер.

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

VLM Page Table Entry Optimization (-Mpte)

Операционная система и синтаксис:	UNIX, WINDOWS	-Mpte
Категория	Макс. Значение	Мин. Значение	Single-user default	Multi-user default
DBS	-	-	-	-

Используется для размещения разделяемой памяти кратной 8Mb при запуске сервера для поддержки VLM64. Его функция является двоичным ключом, который отличается от стандартного. Параметр запуска включает эту функцию.

Shared-memory Overflow Size (-Mxs)

Операционная система и синтаксис:	UNIX, WINDOWS	-Mxs n
Категория	Макс. Значение	Мин. Значение	Single-user default	Multi-user default
DBS	Определяется системой	1	-	16 384 + (# users * 300)/ 1024

n
размер переполнения разделяемой памяти в килобайтах.

Используйте параметр для замены значения по умолчанию. Область переполнения добавляется в область разделяемой памяти. Если область переполнения не достаточно большая, будет выдано следующее сообщение:

SYSTEM ERROR: Out of free shared memory. Use -Mxs to increase.

В зависимости от операционной системы, менеджер базы данных округляет размер области разделяемой памяти до 512 байт или 4 килобайт.

Network Type (-N)

Операционная система и синтаксис:	UNIX, WINDOWS	-N network-type
Категория	Макс. Значение	Мин. Значение	Single-user default	Multi-user default
CC, DBS	-	-	-	Определяется системой

network-type
определяет сетевой протокол соединения.

Определяет сетевой протокол соединения поддерживаемый OpenEdge RDBMS. TCP единственный поддерживаемый выбор.

Number of Users (-n)

Операционная система и синтаксис:	UNIX, WINDOWS	-n n
Категория	Макс. Значение	Мин. Значение	Single-user default	Multi-user default
DBS	10 000	-	-	20

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

-n должно быть достаточно большим, чтобы учитывать всех локальных и удаленных пользователей, а также все фоновые процессы (APW, BIW и AIW PROWDOG) и PROMON.

No Session Cache (-nosessioncache)

Операционная система и синтаксис:	UNIX, WINDOWS	-nosessioncache
Категория	Макс. Значение	Мин. Значение	Single-user default	Multi-user default
DBS	-	-	-	-

Используется для отключения кэширования SSL сессий.

Кэширование сессии позволяет клиенту многократно использовать предварительно установленное соединения, пока не истечет время кэша сессии. Данный параметр отключает эту возможность, которая установлена по умолчанию.

Pending Connection Time (-PendConnTime)

Операционная система и синтаксис:	UNIX, WINDOWS	-PendConnTime n
Категория	Макс. Значение	Мин. Значение	Single-user default	Multi-user default
DBS	-	-	-	0

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

Параметр используется для предотвращения ошибок подключения, связанных с проблемами в сети.

Когда клиент пытается подключиться к базе данных OpenEdge, RDBMS считает, что если клиент достиг брокера, он может также достичь сервер. Проблемы сети или неправильные настройки сетевых устройств могут помешать клиенту достичь сервера. В этом случае, брокер не осознает, что клиент не был подключен к серверу, и продолжает увеличивать счетчик подключенных пользователей. Для решения этой проблемы, OpenEdge брокеры используют “reservation” – счетчик, который они увеличивают каждый раз, когда они переадресовывают клиента на сервер.

Когда –PendConnTime используется, серверы следят за временными отметками в последних “reservation” отметках, и если период истек, брокер считает, что клиент не подключился. Брокер очищает “reservation” – счетчик, давая возможность подключения другим клиентам.

Parameter File (-pf)

Операционная система и синтаксис:	UNIX, WINDOWS	-pf filename
Категория	Макс. Значение	Мин. Значение	Single-user default	Multi-user default
СС, CS, DBS, DS	-	-	-	0

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

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

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

Pin Shared Memory (-pinshm)

Операционная система и синтаксис:	UNIX, WINDOWS	-pinshm
Категория	Макс. Значение	Мин. Значение	Single-user default	Multi-user default
DBS	-	-	-	-

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

Configuration Properties File (-properties)

Операционная система и синтаксис:	UNIX, WINDOWS	-properties filename
Категория	Макс. Значение	Мин. Значение	Single-user default	Multi-user default
DBS	-	-	-	-

filename
имя файла свойств.

Файл свойств используется AdminServer, чтобы определять параметры запуска при старте базы данных или группы серверов. По умолчанию используется файл $DLC/properties/conmgr.properties. Вы не можете использовать этот параметр непосредственно.

Buffered I/O (-r)

Операционная система и синтаксис:	UNIX, WINDOWS	-r
Категория	Макс. Значение	Мин. Значение	Single-user default	Multi-user default
CC	-	-	Unbuffered I/O	Unbuffered I/O

Используется для включения буферизованного ввода/вывода для before-image файла. В большинстве случаев, старайтесь не использовать этот параметр, потому что он может подвергнуть риску целостность базы данных.

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

Service Name (-S)

Операционная система и синтаксис:	UNIX, WINDOWS	-S { service-name \| port-number }
Категория	Макс. Значение	Мин. Значение	Single-user default	Multi-user default
CC, DBS	-	-	-	-

service-name
имя сервиса, используемое процессом брокера.

port-number
номер порта хоста, при использовании Progress Explore, это номер порта NameServer`а.

Используется для указания сервиса или номера порта, используемых для подключения к процессу брокера или используемого самим брокером на хост – машине. Вы должны использовать этот параметр когда:

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

Системный администратор должен зарегистрировать сервис в файле services.

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

Следующая таблица показывает, как брокер, сервер и удаленный клиент интерпретируют каждый параметр при использовании –S:

Модуль	Интерпретация
Брокер	Параметры применяются к соединениям, по которым брокер «слушает» запросы удаленных клиентов.
Сервер	Параметр применяются для подключения между сервером и удаленным клиентом.
Удаленный клиент	Параметры применяются для подключения к брокеру или серверу.

Для запуска многопользовательской сессии с удаленного узла, используется два параметра Host Name (-H) и Service Name (-S).

Semaphore Sets (-semsets)

Операционная система и синтаксис:	UNIX, WINDOWS	-semsets n
Категория	Макс. Значение	Мин. Значение	Single-user default	Multi-user default
DBS	Макс. кол. пользователей + 1	1	-	3

n
целочисленной значение, определяющее количество наборов семафоров для брокера.

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

Server Group (-servergroup)

Операционная система и синтаксис:	UNIX, WINDOWS	-servergroup name
Категория	Макс. Значение	Мин. Значение	Single-user default	Multi-user default
DBS	-	-	-	-

name
определяет имя логически объединенных процессов серверов.

Определяемое имя, должно соответствовать имени группы серверов, указанном в файле conmgr.properties. Для сохранения имени группы в этом файле используется Progress Explorer. Нельзя редактировать файл conmgr.properties непосредственно. Для запуска базы данных с этой конфигурацией, используется или Progress Explorer или утилиты DBMAN.

Session Timeout (-sessiontimeout)

Операционная система и синтаксис:	UNIX, WINDOWS	-sessiontimeout n
Категория	Макс. Значение	Мин. Значение	Single-user default	Multi-user default
DBS	-	-	-	180

n
определяет количество секунд, в течении которых SSL сессия будет кэширована, по умолчанию 180 секунд.

Кэширование сессии, позволяет использовать установленное SSL соединении многократно, если подключение произошло до истечения времени соединения.

Shared memory segment size (-shmsegsize)

Операционная система и синтаксис:	UNIX, WINDOWS	-shmsegsize n
Категория	Макс. Значение	Мин. Значение	Single-user default	Multi-user default
DBS	Ограничено доступной памятью	128 для 32 бит ОС; 1024 для 64 бит.	-	128 для 32 бит ОС; 1024 для 64 бит.

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

Платформа	Значение в MB	Значение в GB¹
32-bit	128 (по умолчанию) 256 512 1024 2048 4096	- - - 1g 2g 4g
64-bit	1024 (по умолчанию) 2048 4096 8192 16384 32768	1g 2g 4g 8g 16g 32g

¹. если вы указываете значение в гигабайтах, необходимо добавлять символ “g”.

Используйте это параметр для определения размера самого большого сегмента разделяемой памяти, которые сервер может разместить. Размер сегмента разделяемой памяти влияет на производительность системы. Увеличение размера сегмента, уменьшает количество размещаемых сегментов, тем самым уменьшая потребление ресурсов необходимых для управления сегментами.

Spin Lock Retries (-spin)

Операционная система и синтаксис:	UNIX, WINDOWS	-spin n
Категория	Макс. Значение	Мин. Значение	Single-user default	Multi-user default
DBS	-	0	-	10 000, или 6 000 * #CPU¹

¹. для однопроцессорных систем – 10 000; для многопроцессорных – 6 000 * #CPU.

n
количество попыток приобретения блокировки перед приостановкой.

Используется для настройки механизма блокировок, системных семафоров и очередей. Если значение больше чем ноль (0), используется алгоритм spin lock для структуры данных в разделяемой памяти. Когда процесс должен блокировать структуры разделяемой памяти, он пытается сделать это n раз. Если по истечении n – ой попытки, процесс не смог получить блокировку, он будет приостановлен, или другими словами «заснет». Постепенно время паузы («сна»), при многократных неудачных попыток блокировки, возрастает. По истечении времени паузы, процесс «пробуждается» и повторяет попытку. И так по кругу.

Если установлено значение ноль (0), то вместо алгоритма spin lock будет использоваться система семафоров и очередей. Но в многопроцессорных системах алгоритм spin lock более эффективен чем работа семафоров.

Во многопроцессорных системах, по умолчанию, значение определяется исходя из: 6 000 * # CPU. Если наблюдается чрезмерная загрузка процессоров, уменьшите это значение. Если имеется множество быстрых процессоров, следующее значение может быть достаточным: 10 000 * # CPU.

Вы можете оценить эффективность –spin с помощью утилиты PROMON и опции R&D. Параметр –spin контролирует индикатор производительности называемый “resource waits”. Увеличивая значение –spin, вы можете уменьшить значение “resource waits”. Но имейте ввиду, при через мерном увеличении значения параметра, вы можете уменьшить значение “resource waits”, но при этом значительно увеличить загрузку процессоров.

Для определения значения “resource waits” необходимо:

Войти в меню утилиты PROMON и выбрать R&D.
Выбрать опцию 3 Other Display, и далее 1 Performance Indicators. Появится экран, на котором “resource waits” будет расположен последним в списке.

SSL (-ssl)

Операционная система и синтаксис:	UNIX, WINDOWS	-ssl
Категория	Макс. Значение	Мин. Значение	Single-user default	Multi-user default
DBS	-	-	-	-

Указывает о необходимости работы базы данных и клиентов с использованием Security Sockets Layer (SSL) для доступа к данным. SSL обеспечивает аутентификацию и шифровку однорангового TCP/IP соединения.

Примечание: SSL сильно влияет на производительности системы, причем не в лучшую сторону.

Table Range Size (-tablerangesize)

Операционная система и синтаксис:	UNIX, WINDOWS	-tablerangesize n
Категория	Макс. Значение	Мин. Значение	Single-user default	Multi-user default
DBS	-	-	-	-

n
количество таблиц по которым будет собираться статистика.

Используется для сбора статистики по таблицам базы данных из виртуальных таблиц (VST).

Century Year Offset (-yy)

Операционная система и синтаксис:	UNIX, WINDOWS	-yy n
Категория	Макс. Значение	Мин. Значение	Single-user default	Multi-user default
CC, DBS	-	-	1950	1950

n
четыре цифры года (например, 1990). По умолчанию – 1950.

Используется для указания начала 100 летнего периода, в котором в дате используется двузначное указание года.

Некоторые приложения OpenEdge резервируют только две цифры для указания года. Например, если –yy установлен в 1950, сервер определит только две цифры в года меньшие или большие 50. Если цифры больше 50, сервер предполагает что дата в двадцатом столетии. Если меньше 50, то предполагается что дата в двадцать первом столетии.

Примеры:

-yy	Год (как указан в формате DATE)	Результат функции Year
1900	50 – 99 00 – 49	1950 – 1999 1900 – 1949
1950	50 – 99 00 – 49	1950 – 1999 2000 – 2049
1980	80 – 99 00 – 79	1980 – 1999 2000 - 2079

Отметьте, как все значения года с двумя цифрами расширяются в 100 – летний период, в зависимости от –yy.

Для того чтобы оценить эффект от использования других значений –yy, измените значение и запустите следующую программу:

DEFINE VARIABLE ddate AS DATE.
DISPLAY "Enter date or Press F4 to end." WITH FRAME msg.
REPEAT:
       SET ddate LABEL "Date" WITH SIDE-LABELS.
       DISPLAY YEAR(ddate) FORMAT "9999" LABEL "=> Year"
       WITH SIDE-LABELS.
END.

Этот параметр обеспечивает тот же функционал что и атрибут SESSION:YEAR-OFFSET.

Follow @vbashkatov

© 2009 - 2011 Все права на материалы, находящиеся на сайте www.openedge.ru, охраняются в соответствии с законодательством РФ, в том числе, об авторском праве и смежных правах.
При любом использовании материалов сайта ссылка на источник обязательна.