Взаимодействие с M3¶

Примечание

Взаимодействие с агентом M3 выполняется только при наличии в директории установки ПроАТМ файла m3agent.dll (устанавливается инсталлятором M3Agent).

Внимание

Не рекомендуется использовать версии агента M3 старше 1.0.202.152.

Основные функции¶

Передача в мониторинг M3 статусов оборудования (CIM, IDC, PIN и PRR).
Передача в мониторинг M3 счетчиков кассет купюроприемников.
Передача в мониторинг M3 сообщений NDC, дублируя отправляемые хосту данные.

Принцип работы¶

Для взаимодействия с системой мониторинга M3 от ЗАО «ЛАНИТ» используется агент мониторинга M3Agent. Агент M3 предоставляется производителем (ЗАО «ЛАНИТ»), устанавливается и работает независимо от терминального ПО.

Предусмотрен только односторонний режим работы, когда ПроАТМ отправляет в M3 необходимые мониторингу сообщения. Для взаимодействия используется набор утилит «MonitoringModule.exe» и «MultiplexerM3.exe», размещенных в директории установки ПроАТМ.

MonitoringModule.exe – устанавливает с ПроАТМ сетевое соединение (TCP/IP) и обменивается сообщениями подсистемы мониторинга ПроАТМ;
MultiplexerM3.exe – взаимодействует с MonitoringModule.exe через очередь сообщений «PROATM_MULTIPLEXER_QUEUE».

При запуске MultiplexerM3.exe запрашиваются актуальные статусы устройств (CIM, кассеты CIM, PRR, IDC и EPP). Наличие CIM и PRR являются критичными, при их отсутствии приложение MultiplexerM3.exe не будет выполнять функции интеграции с агентом M3.

События наблюдаемых устройств, а также статистика по кассетам, отслеживаются приложением MultiplexerM3.exe, которое передается системе мониторинга M3 посредством динамической библиотеки m3agent.dll, разработанной компанией «ЛАНИТ». Сообщения о подключении MultiplexerM3.exe к агенту «Ланит M3» фиксируются в системе логирования RedLabel с уровнем 65. Источник сообщений – «MultiplexerM3.exe».

Настройка и запуск¶

Все настройки выполняются после установки ПроАТМ. При отсутствии установленного агента M3 сделанные рабочие настройки не искажают работу терминального ПО.

Убедитесь, что в директории установки ПроАТМ размещен файл m3agent.dll.
Настройте номер УС в режиме РОП или проверьте значение параметра MACHINE_NO (для протокола NDC)/ TERMINAL_ID (для протокола ISO8583):
```
[HKEY_LOCAL_MACHINE\SOFTWARE\FS365\AuthorizationISO8583]
"TERMINAL_ID"="12345678"

[HKEY_LOCAL_MACHINE\SOFTWARE\FS365\NDC\CONFIG]
"MACHINE_NO"="123456"
```

Включите мониторинг:

[HKEY_LOCAL_MACHINE\SOFTWARE\FS365\Common]
"MONITORING_TYPE"="URALSIB"

Настройте номинальный ряд для отправки в M3:

[HKEY_LOCAL_MACHINE\SOFTWARE\FS365\MonitoringAgent]
"M3CimDenominationsToBeSent"="10 RUB, 50 RUB, 100 RUB, 200 RUB, 500 RUB, 1000 RUB, 2000 RUB, 5000 RUB"

При необходимости выполните дополнительную настройку агента мониторинга.
Добавьте запуск утилит «MonitoringModule.exe» и «MultiplexerM3.exe» после запуска «ogre.exe». Рекомендуется использовать механизм запуска пользовательских сценариев:
```
<actions seq="After_Ogre">
  <cmd wait="no" params='""'>C:\FS365\Applications\MonitoringModule.exe</cmd>
</actions>
<actions seq="After_Ogre">
  <cmd wait="no" params='""'>C:\FS365\Applications\MultiplexerM3.exe</cmd>
</actions>
```