Content Comparison

(Introduced in version 15)

Message watermarking is a feature which allows a queue device to verify the source of a message. Each message is watermarked by the originating Connexion or Remote Agent system, and then validated immediately before processing within the final Connexion (or Remote Agent) system. This is useful in ensuring that all messages received into a queue are expected - eliminating the possibility of accidentally branching or forwarding a message to the wrong destination. 

VisioImage Added

The watermarking feature piggy-backs off the message 'Sending Facility' field (typically MSH-4) which is persisted across forwards, branches, and remote agent send operations. For example, if we are ingesting messages from a specific customer via a remote agent, and forwarding these messages to a data-center hosted downstream system, we would watermark the message on the remote agent side, and then verify the watermark before forwarding the receiving system. Alternately, we can safeguard against sending data to the wrong customer's remote agent by verifying messages received from a datacenter-hosted Connexion.

...

Now that we have watermarked our messages in the source system, navigate to the last queue in the last channel of the workflow. In this case we are sending from a customer's remote agent into Connexion. With the last queue selected, choose the 'settings' tab, then 'watermarking' tab.

Image Added

Set the 'Action' field to 'Verify Watermark'. In the 'Match List', enter a list of valid sending facilities (which you configured in the sending system). The default syntax is '+XXXXXXX' where the 'XXXXXXX' matches the tag you entered in the source system (field 3). The '+' character allows the matching of any string preceding the watermark tag. For example, '+C21145D0' will match 'SHM+C21145D0' and 'EPIC+C21145D0'. If you have left the sending facility field as default in the source system (field 2) then most likely you want to use the '+' option. If you have configured the sending facility in the source system or simply want to match on only one specific value, don't start your string with the '+' character. For example, 'SHM+C21145D0' is an exact match.

Note that a queue which is verifying a watermark will display the shield icon (3 in the image above).

Messages that fail a watermark test are moved to the error queue:

Image Modified

...