Remote Event

The remote event service stores FTM SWIFT events from a remote application in the event database table and publishes those events to registered subscribers. This service expects a datagram as input. It does not send a response to the requesting client application, although in certain error situations it sends a report message.

The client application might force a negative action notification (NAN) report to be sent if there is a failure and might check the Response folder for information about the failure.

Service interface queue name

instance.ou.DNI_R_EVENT

Prerequisites

None.

Process

The Remote event service:
  • Enriches the datagram with configuration data.
  • Checks whether the datagram contains all mandatory elements.
  • Stores the event data in the event database table.
  • Publishes the event data to registered subscribers.

Error conditions

If an error occurs during processing, the Remote event service performs the following.
  • If one or more mandatory elements are missing or if an error occurs during the attempt to store the event data in the event database table, the following can occur:
    • If a database error occurred, the service encapsulates the original event data in event DNIE4005E and publishes the event.
    • If an error other than a database error occurred, the service encapsulates the original event data in event DNIE4004E and publishes the event.
    • If the Report field in the MQMD is set to MQRO_NAN, the service sends a report message to the client application. This report message is sent to the queue that is specified by the ReplyToQ and ReplyToQMgr fields in the MQMD.
    • The message broker transaction is committed.
  • If an error occurs during the attempt to publish the event data to registered subscribers, the service stores the event data in the FTM SWIFT trace and commits the message broker transaction.