Взаимодействие с 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 сделанные рабочие настройки не искажают работу терминального ПО.

  1. Убедитесь, что в директории установки ПроАТМ размещен файл m3agent.dll.

  2. Настройте номер УС в режиме РОП или проверьте значение параметра 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"
    
  3. Включите мониторинг:

    [HKEY_LOCAL_MACHINE\SOFTWARE\FS365\Common]
    "MONITORING_TYPE"="URALSIB"
    
  4. Настройте номинальный ряд для отправки в M3:

    [HKEY_LOCAL_MACHINE\SOFTWARE\FS365\MonitoringAgent]
    "M3CimDenominationsToBeSent"="10 RUB, 50 RUB, 100 RUB, 200 RUB, 500 RUB, 1000 RUB, 2000 RUB, 5000 RUB"
    
  5. При необходимости выполните дополнительную настройку агента мониторинга.

  6. Добавьте запуск утилит «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>