By Joesciallo-Oracle on Feb 27, 2013
Choosing the Correct Event Notification Service Documentation
Recently we received an inquiry through the software forums about creating custom applications for Messaging Server dealing with message notifications. This started a conversation about the ENS documentation that I would like to clarify.
Sidebar: Event Notification Services, ENS, is the underlying publish-and-subscribe service available in Messaging Server. ENS provides a server and APIs for publishers and subscribers. A publisher makes an event available to the notification service. A subscriber tells the notification service that it wants to receive notifications of a specific event.
Going forward with Messaging Server 7 Update 4, you should be using the ENS C API as the simplest and most stable way to interact with
events provided by Messaging Server. The ENS C API is documented in the Current Event Notification Service C API Reference page.
And so we come to a source of confusion. The documentation for the older style API is still available on the Communications Suite wiki, and so if you search for say, "ENS API," you are likely to find it. I would link to it, but I really don't want to send anyone there. Indeed, that page will be removed shortly so as to not cause confusion anymore. Just to reiterate, use the ENS C API as documented in Current Event Notification Service C API Reference.
I hope this helps move beyond the "clear as mud" situation that we sometimes find ourselves in.