Автоматизированная система расчетов за услуги связи «Fastcom» (стр. 7 )

Секция состоит из определений параметров. Каждая строка секции определяет один параметр, и должна соответствовать формату

  имя_параметра = значение параметра

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

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

Секция [global]

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

Допустимые параметры:

logfile	Путь к журнальному файлу	Обязательный параметр, указывающий полный путь и имя журнального файла. Значения по умолчанию нет.
home_folder	Домашний каталог приложения	Необязательный параметр. Каталог, из которого будут вызываться внешние команду и приложения (если не переопределено)
fastcom_home	Путь к клиенту АСР Fastcom	Путь к клиентской части АСР Fastcom, используется для поиска исходный файлов отчётов. При соединении с Oracle приложение устанавливает параметр настройки АСР  FASTCOM_HOME в указанное значение.
queues	Обработчики очередей	Коллекция, описывающая необходимые обработчики очередей и их количество. Например: ORAREP:5;CONVERT:1;OTHERS:2; Обработчики настраиваются в отдельных секциях. Значение по умолчанию: DEFAULT:1; Количество потоков обработки одного типа не может превышать количество процессорных ядер сервера более чем в два раза.

Секция  [constants]

       Для настройки экземпляра приложения Fastcom Report Dispatcher на конкретный сервер применяется механизм констант. Константа – именованное значение, задаваемое в конфигурационном файле приложения. Разработчик программы диспетчера отчётов может использовать константы в значениях параметров. Программа Fastcom Report Dispatcher заменяет вхождения констант в значения параметров на значения, заданные в конфигурационном файле. Например, для указания пути к каталогу Fastcom Client могут быть использованы константы %H и %/, например так:  SRC$DIR:%H%/REP.  При этом на разных экземплярах Fastcom Report Dispatcher и Fastcom Report Producer  параметр может быть преобразован, например, в:

H:\REP D:\FastcomClient\REP /opt/fastcom/frp/mnt/fastcom_client

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

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

Рекомендуется задать следующие константы:

Имя	Описание	Значение по-умолчанию
%	Используется для передачи символа % в значении параметра	%
/	Разделитель каталогов в пути файловой системы.	Устанавливается в зависимости от операционной системы ( символ / или \)
:	Разделитель каталогов в переменной окружения PATH	Устанавливается в зависимости от операционной системы (символ : или ;)
T	Каталог для временных файлов	Устанавливается в зависимости от операционной системы
H	Путь к каталогу, содержащему Fastcom Client (без завершающего слэша)	H:
J	Путь к каталогу, содержащему Preinstalled Oracle Client (без завершающего слеша)	J:
R	Каталог, в который необходимо помещать готовые оперативные отчёты (заказанные пользователями АСР «по-одному»)
P	Каталог, в который необходимо помещать готовые отчёты, формируемые пакетными процедурами

Секция [oracle]

В секции oracle указываются параметры соединения с базой данных Oracle Database. Эти же данные используются для запуска приложения SQL*Plus, если иное не указано в параметрах действия SQL$PLUS

Допустимые параметры:

username	Имя пользователя АСР	Рекомендуется создать отдельного пользователя АСР, и предоставить ему права на доступ ко всем таблицам. Допустимо использовать имя владельца схемы АСР Fastcom, если конфигурационный файл надёжно защищен от доступа посторонних
password	Пароль пользователя
database	Имя описания соединения в файле TNSNAMES. ORA	Допускается использование полного описания соединения вида (DESCRIPTION=….). Подробности в документации Oracle.
reconnect_delay	Таймаут переподключения	В случае неуспешного подключения Fastcom Repost Dispatcher подождет указанное количество секунд перед следующей попыткой соединения.

Секции [netdisk_N]

При запуске приложения Fastcom Report Dispatcher  в качестве сервиса Windows может возникнуть необходимость в подключении сетевых дисков, содержащих Fastcom Client, Oracle Client и разделяемое в Web-сервером дисковое пространство.

Для подключения дисков в конфигурационном файле может присутствовать несколько секций netdisk_N, где N – число.

Подключение дисков производится начиная с секции netdisk_1 по порядку номеров: netdisk_2, netdisk_3 и т. д.  В случае если очередная секция netdisk_N не найдена,  просмотр следующих секций netdisk_(N+1) и т. д. не производится.

При подключении дисков следует учитывать следующее:

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

При сбое подключения выполнение приложение продолжается. Это позволят запускать Fastcom Report Dispatcher вручную с уже подключенными дисками (в целях отладки, например). При этом если диск реально не подключён, данный экземпляр приложения будет получать действия из очереди, и завершать их с ошибкой. Будьте внимательны! Используйте параметр critical после завершения настройки и отладки диспетчера отчётов.

Допустимые параметры:

url	Путь к сетевому ресурсу	Путь к сетевому ресурсу в формате \\сервер\имя ресурса
local	Локальное наименование	Идентификатор диска (буква), к которой нужно подключить сетевой ресурс. Например, J:  (двоеточие указывать обязательно)
username	Имя пользователя	Допустимо указывать в форматах: Имя_пользователя ДОМЕН\имя_пользователя Имя_пользователя@домен Выбор формата записи имени пользователя зависит от требований файлового сервера.
password	Пароль пользователя
critical	Критичный ресурс	Если параметр установлен в значение Y, то при сбое подключения сетевого ресурса программа завершится. В противном случае выполнение программы продолжается.

Секция [DEFAULT]

Настройка значений по умолчанию для обработчиков очереди.

Допустимые параметры:

Actions	Обрабатываемые действия	Коллекция действий, обрабатываемых потоком обработки. Формат коллекции: КОД_ДЕЙСТВИЯ:ВАРИАНТ;КОД_ДЕЙСТВИЯ:ВАРИАНТ; , где: КОД_ДЕЙСТВИЯ -  код действия по справочнику действий диспетчера отчётов; ВАРИАНТ – строка, определяющая обрабатываемые варианты действий. Строка «Вариант» сравнивается с полем «Вариант» очереди действий SQL-оператором LIKE. Значение «Вариант» конфигурационного файла может содержать метасимволы ‘%’ и ‘_’.
restart_after_jobs	Перезапуск обработчика после N действий	Обработчик будет перезапущен после выполнения определённого в данном параметре количества действий. При этом произойдёт сброс состояния сессии обработчика в Oracle Database. Возможность может быть использована в случае появления ошибок, вызванных обработкой предыдущих действий, а также с ошибками видов «утечка памяти» и «деградация производительности».
restart_after_seconds	Перезапуск обработчика через N секунд	Перезапуск обработчика через определённое данным параметром количество секунд. Значение по умолчанию – 86400 (1 сутки). Позволяет бороться с возможными проблемами видов «утечка памяти» и «деградация производительности»
restart_after_ seconds_rand	Случайное число к предыдущему параметру	Операция перезапуска обработчика достаточно ресурсоёмка для сервера Oracle Database. Чтобы избежать одновременного перезапуска множества потоков обработки к параметру restart_after_seconds добавляется случайное число в диапазоне от 0 до restart_after_seconds_rand
requery_delay	Частота опроса очереди	После завершения действия поток обработки несколько раз обращается к базе данных за следующим действием, перед тем как перейти в режим ожидания события. Параметр requery_delay определяет паузу между последовательными запросами в миллисекундах.
watchdog	Сторожевой таймер	Ошибка в коде отчёта или команды может привести к «зависанию» действия. Например, вызванное внешнее приложение может ожидать ввода с клавиатуры. Сторожевой таймер позволяет завершить поток выполнения действий в случае, если действие не выполнилось в течение заданного таймаута (в секундах). Внимание: состояние текущего действия в очереди задач для завершаемого потока не изменяется, и остаётся в значении «Выполняется».

Секции [КОД_ОБРАБОТЧИКА]

Для каждого обработчика, указанного в параметре queues секции [global] необходимо создать секцию с указанным в параметре queues наименованием. Например, при значении параметра queues = FIRST:1;SECOND:2; необходимо создать секции [FIRST] и [SECOND].