Запуск и останов системы

CИСТЕМА БРОКЕРСКОГО ОБСЛУЖИВАНИЯ
TRANSAQ
Руководство по эксплуатации
Версия 4.9
Москва
1
Запуск и останов системы
Режим эксплуатации СБО TRANSAQ не предполагает круглосуточной работы
программных модулей. Шлюзы и сервер системы должны быть остановлены после
окончания торгов на торговых площадках и запущены заново в начале очередного
рабочего дня.
Запуск системы
Запуск программ производится в следующем порядке:
1. dfserver.exe (Кроме конфигураций с доступом к ТС ММВБ через шлюзы E-Stock).
2. Шлюзы TRANSAQ для доступных торговых площадок.
3. Сервер TRANSAQ.
ВНИМАНИЕ! Загрузка исходных данных для торгов должна быть произведена
до запуска сервера TRANSAQ!
Для запуска модулей СБО TRANSAQ может использоваться “пакетный”(bat) файл
команд.
Останов торговой системы
Останов программных модулей может производиться в произвольном порядке.
Время автоматического останова сервера устанавливается через АРМ Администратора
(параметр системы TRADE_SRV_SHUTDOWN_TIME)
Время автоматического останова шлюзов указывается в конфигурационном файле
gateway.ini (ключ SHUTDOWN_TIME).
После останова шлюзов Сервер TRANSAQ может продолжать обслуживать
информационные запросы пользователей.
Восстановление работоспособности при сбоях
В случае ошибок соединения сервера TRANSAQ со шлюзом, либо шлюза TRANSAQ с
ТС Биржи, соединение восстанавливается автоматически без участия оператора.
Трейдеры оповещаются о проблемах подключения к Бирже путем изменения цвета
индикатора состояния соединения. После восстановления соединения пользователи
получают актуальную информацию о рынке, а также о состоянии своих заявок и сделок.
В случае прекращения работы модуля TRANSAQ по причине аппаратного или
программного сбоя, он может быть запущен заново без выполнения каких либо
специальных действий с другими модулями.
ПРИМЕЧАНИЕ. Перезапуск модулей системы TRANSAQ может производиться при
помощи “пакетного” (bat) файла команд, используемого для запуска системы. При этом
повторный запуск работающих модулей не произведен не будет.
ВНИМАНИЕ! Рекомендуется производить ежедневное резервное копирование рабочей
базы данных средствами администрирования СУБД.
2
Шлюзы СБО TRANSAQ
Перечень файлов в рабочем каталоге
FondGW.exe, GkoGw ,RtsGW, FutGW.exe, OptGW.exe исполняемые модули шлюзов
TRANSAQ
gateway.ini конфигурационный файл шлюзов TRANSAQ
mtesrl.dll, services.dll, zlib.dll, mtesrl.ini файлы, поставляемые в составе УДПШ
ММВБ.
Конфиг урационный файл g atew ay.ini
Секция GATEWAY содержит общие параметры настройки шлюзов:
[GATEWAY]
; каталог для формирования журналов
LOG_PATH=.\logs
; время автоматического останова
SHUTDOWN_TIME=19:30
; пароль доступа к шлюзам
PASSWORD=5BAA61E459593F3F0682250B6CF833157EE68FD87F
Секция DFSERVER<n> содержит параметры настройки одного из шлюзов:
[DFSERVER1]
; наименование данной конфигурации шлюза
NAME=FOND_MICEX
; тип доступа к шлюзу ММВБ. EPTS=1 – через шлюз фирмы E-Stock, EPTS=0 – через
шлюз фирмы CMA
EPTS=0
; параметры подключения к шлюзу (зависят от типа доступа)
CONNECT=PORT=COM1;BAUDRATE=115200;SYNCTIME=1;TIMEOUT=40000
; TCP порт для подключения сервера TRANSAQ к данному шлюзу
SRV_PORT=4001
; TCP порт для подключения технического администратора TRANSAQ к данному шлюзу
TA_PORT=3601
; список запрашиваемых таблиц
; ВНИМАНИЕ! ИЗМЕНЯЕТСЯ ТОЛЬКО РАЗРАБОТЧИКОМ СИСТЕМЫ!
TABLES=6,29,8,1,26,7,3,28,4
Запуск шлюза
При запуске исполняемого модуля шлюза TRANSAQ, необходимо указать в качестве
параметра номер секции [DFSERVERn] файла gateway.ini, содержащей настройки
данного шлюза.
3
Показываются текущие настройки программы, затем производится подключение к ТС
Биржи. После успешного подключения, на экран выводится количество финансовых
инструментов, полученных от ТС Биржи (строка “Securities”).
В процессе работы модуля на экране отображается статистическая информация о
количестве выполненных запросов к ТС Биржи и количестве полученных объектов.
Останов шлюза
Для останова модуля активизируйте его консольное окно и введите символ 'e'.
При некоторых проблемах с последовательным портом, программа не может быть
остановлена таким способом. В этом случае воспользуйтесь командой «Закрыть»
системного меню окна программы, либо средствами операционной системы.
4
Сервер TRANSAQ
Сервер TRANSAQ реализует логику системы управления рисками брокерской системы,
обслуживает запросы трейдеров и администраторов по работе с заявками и торговыми
счетами, а также обеспечивает участников торгов данными о текущем состоянии рынка и
предоставляет доступ к информации об истории торгов.
Перечень файлов в рабочем каталоге программы
TradeSrv.exe исполняемый модуль программы
TradeSrv.ini конфигурационный файл
TradeSrv.pdb файл с отладочной информацией
Запуск программы
Загрузите исполняемый файл TradeSrv.exe
При запуске показываются текущие настройки программы, затем запрашивается
идентификатор пользователя и пароль для доступа к базе данных (если не задано в
TradeSrv.ini ) и пароль для подключения к шлюзам TRANSAQ (если не задан параметр
системы 'GATE_PASSWORD').
Если данные о входящих остатках на счетах клиентов еще не были загружены, оператор
получает уведомление об этом, и может принять решение о возможности продолжения
работы программы.
После подключения к серверу базы данных и шлюзам TRANSAQ и получении всех
необходимых данных, на экран выводится сообщение о готовности сервера обслуживать
запросы пользователей:
FULL CLIENT SERVING STARTED
Консоль сервера
Для управления сервером и получения информации о его состоянии, используются
следующие команды:
Команда
?
CONN
OUT
STT
TIME OFF
TIME ON
TRADE OFF
TRADE MAIN
TRADE ON
PROFILE
LOAD
BLOCKED
Действие
Отобразить список доступных команд консоли
Отобразить список пользователей, подключенных к серверу
Сформировать исходящие файлы
Отобразить статистику по заявкам и сделкам
Отключить расписание сервера. Может использоваться для того, чтобы избежать
остановки сервера в обычное (заданное в параметрах системы) время в случае продления
торгов на Бирже. При этом сервер должен быть остановлен по окончании торгов с
помощью команды DOWN
Включить режим работы сервера по расписанию
Запрет на выставление заявок всем трейдерам. Снятие заявок разрешено всем
Запрет на выставление заявок всем трейдерам кроме главных.
Снятие заявок разрешено всем
Включение обычного режима торгов после TRADE OFF или TRADE MAIN
Перезагрузка профилей клиента (после изменения файла с описанием профилей)
Перезагрузка данных о неснижаемых остатках
5
DOWN
Сформировать исходящие файлы и остановить сервер
Протоколы сервера TRANS AQ
Во время работы сервер TRANSAQ сохраняет в текстовые файлы следующие данные:
Наименование
файла
<mmdd>kf.txt
Содержимое файла
Когда формируется
Файл «Финансовые инструменты»
Содержит параметры доступных серверу
финансовых инструментов
<mmdd>ks.txt
Файл «Сделки».
Содержит список сделок, совершенных на момент
формирования файла по клиентским счетам,
зарегистрированным в СБО TRANSAQ.
Файл «Заявки».
Содержит список заявок, поданных на момент
формирования файла по клиентским счетам,
зарегистрированным в СБО TRANSAQ.
Файл «Адресные Заявки».
При выполнении команд OUT или
DOWN и в соответсвии с
параметрами системы
AUTO_EXPORT_TIME_LIST и
AUTO_EXPORT_INTERVAL
Аналогично <mmdd>kf.txt
<mmdd>kz.txt
<mmdd>kzrps.txt
<mmdd>ki.txt
<mmdd>ab.txt
<mmdd>mb.txt
<mmdd>ord.txt
<mmdd>saldos.txt
<yymmdd>TS.log
Файл «Заявки для исполнения»..
Файл «Остатки бумаг на торговых счетах ММВБ»
Файл «Остатки денежных средств на торговых
разделах ММВБ»
Файл всех заявок в формате Блокнота поручения
TRANSAQ
Файл текущих остатков на счетах клиентов в
формате TRANSAQ.
Протокол событий, зарегистрированных сервером
TRADE_
При выполнении команды OUT или
останове сервера
TRADE_
При выполнении команды OUT или
останове сервера
Аналогично <mmdd>kf.txt
Аналогично <mmdd>kf.txt
Аналогично <mmdd>kf.txt
TRADE_
При выполнении команды OUT или
останове сервера
При выполнении команды OUT или
останове сервера
В процессе работы сервера
TRADE_
Одновременно с сохранением протоколов в виде текстовых файлов, сервер TRANSAQ
ведет протоколирование транзакций клиентов по работе с заявками и сделок в базе
данных СБО TRANSAQ (см. описание параметров системы в АРМ Администратора
TRADE_SRV_LOG_SAVE_DAYS и TRADE_SRV_TRDADES_SAVE_DAYS)
ВНИМАНИЕ! Для корректной работы системы необходимо чтобы в указанных
каталогах находились протоколы сервера только за текущий год.
По окончании календарного года все файлы за прошедший год из каталога
журналов сервера необходимо перенести в другой каталог или удалить
Обновление АРМ трейдера
Доставка обновлений АРМ трейдера клиентам организуется с помощью сервера
TRANSAQ. Для этого необходимо в подкаталог ‘upload’ поместить
самораспаковывающийся архив, содержащий новую версию АРМ трейдера
(предоставляется разработчиком системы).
В имени файла обновления отражается номер сборки (build). Например, файл ‘tsq059.exe’
будет содержать обновление с номером сборки 059. При наличии в подкаталоге ‘upload’
нескольких архивов, пользователям будет передаваться версия с наибольшим номером
сборки. Файл с обновлением может быть помещен в подкаталог во время работы сервера.
Рассылка новой версии может быть прекращена путем удаления архива из каталога.
Рекомендуется не удалять предыдущую версию архива, чтобы клиенты, уже получившие
новую версию, при необходимости, могли вернуться к прежней версии программы.
6
Каталог
настрой
TRADE_
TRADE_
TRADE_
TRADE_
TRADE_
TRADE_
Загрузка исходных данных для
торгов
Назначение программы
Утилита saldos.exe предназначена для переноса необходимых данных из учетной
системы Брокера в базу данных системы TRANSAQ.
Перечень файлов в рабочем каталоге программы
saldos.exe исполняемый модуль программы;
saldos.ini конфигурационный файл программы saldos.exe;
saldos.log протокол результатов запусков программы.
Запуск программы
Поместите текстовый файл с данными в каталог, заданный ключом FILENAME файла
saldos.ini и запустите исполняемый модуль Saldos.exe
ВНИМАНИЕ! Если загрузка исходных данных производится после запуска сервера
TRANSAQ, то пользователь получает предупреждение о том, что сервер TRANSAQ
уже загрузил данные. Чтобы продолжить загрузку нужно ввести символ 'с’
(латиница)
При запуске saldos.exe с параметром /AUTO (saldos.exe /AUTO) такое предупреждение
не выдается. При этом сервер (если он запущен) автоматически получает команду
перечитать входящие остатки из БД.
При успешном подключении к серверу базы данных и открытии исходного файла,
данные загружаются в базу данных системы.
Перезагрузка входящих остатков при работающем
сервере
Если загрузка остатков была произведена при работающем сервере TRANSAQ и без
использования параметра /AUTO, то необходимо уведомить сервер о необходимости
перечитать остатки средств из базы данных выполнив команду "Перезагрузить
входящие остатки" (см. меню «Сервер» в АРМ Администратора).
Дозагрузка входящих остатков
Для отражения неторговых операций клиентов по деньгам/бумагам без удаления
существующих проводок необходимо:
1. В секции [SETTINGS] файла saldos.ini задать ключ DELETE_BEFORE_LOAD=0
7
2. Утилиту saldos.exe запускать с параметром: <имя файл новых проводок>, например:
saldos.exe new_money.txt
3. Если сервер TRANSAQ уже запущен, то в АРМ Администратора выполнить запрос
"Перезагрузить входящие остатки".
ПРИМЕЧАНИЕ. При запуске saldos.exe без параметра всегда производится загрузка
остатков из файла, заданного ключом FILENAME секции [FILE]. Перед началом
загрузки в этом режиме остатки на счетах клиентов обнуляются независимо от значения
параметра DELETE_BEFORE_LOAD
Загрузка исходящих остатков предыдущего торгового
дня
Если файл входящих остатков не был получен от учетной системы ко времени начала
торгов, то в качестве входящих остатков можно загрузить остатки на счетах клиентов на
момент останова сервера TRANSAQ.
Для этого необходимо запустить Saldos.exe с параметром /LTD
Saldos.exe /LTD
При этом оператору будет предложена возможность ввода нужной даты для поиска
файла остатков.
Для автоматической (без участия оператора) загрузки остатков на счетах клиентов на
момент предыдущего останова сервера нужно запустить Saldos.exe с параметром
/LTD_AUTO
Saldos.exe /LTD_AUTO
ВНИМАНИЕ! Данный режим загрузки невозможен при работающем сервере TRANSAQ.
Каталог для поиска файла с остатками задается в saldos.ini (ключ LTD_SALDOS_PATH в
секции [SETTINGS]). Например:
LTD_SALDOS_PATH=.\servers\logs\
Производится загрузка данных из файла с именем <ddmm>saldos.txt,
где <ddmm> - дата останова сервера. Например, 2104saldos.txt
Сохранение текущих операций по неторговым
движениям средств при перезагрузке входящих остатков
Для включения данного режима загрузки остатков необходимо в секции [SETTINGS]
файла saldos.ini установить значение ключа SAVE_ TODAYS_OPERATIONS = 1.
В этом случае при загрузке остатков будут удаляться только те операции
Администратора, которые имеют непустое значение поля «Код операции» (такие
операции трактуются как исправления неверного входящего остатка).
При этом сегодняшние операции Администратора с пустым кодом будут сохранены.
(такие операции трактуются как изменение средств клиента при правильном входящем
остатке)
8
Результаты работы программы
Для обеспечения возможности автоматической обработки результатов ее работы,
программа устанавливает одно из следующих значений ERRORLEVEL:

N >0- данные загружены успешно, при этом N строк было проигнорировано не по
причине установленных фильтров;

0 – все строки успешно загружены в базу данных;

(-1) – ошибки работы с базой данных;

(-2) – ошибки работы со входящим файлом;

(-3) – исполнение программы прервано пользователем.
При возникновении ошибок с отрицательным значением ERRORLEVEL изменение базы
данных не производится.
Ошибки интерпретации строк файла не прерывают работы программы и заносятся в
протокол (файл saldos.log).
9
10
Удаление инструментов с
истекшей датой исполнения.
Для обеспечения эффективной работы системы необходимо периодически (примерно 1 раз в 4
месяца) удалять инструменты с истекшей датой исполнения.
Для этого предназначен запрос 'Удалить погашенные инструменты'.
(см. АРМ Администратора, пункт "Запросы к БД" меню "Запросы")
Данный запрос должен исполняться только при незапущенном сервере TRANSAQ.
Просмотреть количество инструментов с истекшей датой исполнения можно с помощью запроса
'Кол-во погашенных инструментов'.
11