Unified Communications Suite: Creating Custom Applications Using ENS

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.

Comments:

Update 4? Where did update 3 go?

Posted by guest on February 28, 2013 at 03:14 PM MST #

re: 7.3, the docs say:

New ENS software should use the new simpler API starting with Messaging Server 7 Update 4 instead of this API. The sample code and libraries for this API are no longer included in packaging. If you have existing code that used this API, you can continue to do so, provided that you perform a manual copy of the necessary shared libraries from a legacy version of Messaging Server that used this API. For information on the new API, see Current Event Notification Service C API Reference.

For additional information, I'd check out the following knowledge article in MOS: Comms Suite ENS and JMQ Event Notification Services (Doc ID 1421043.1)

HTH,

Joe

Posted by Joe Sciallo on February 28, 2013 at 03:34 PM MST #

Post a Comment:
  • HTML Syntax: NOT allowed
About

Reporting about Unified Communications Suite Documentation, including news, Comms 101, documentation updates, and tips and tricks.

Search

Archives
« April 2014
SunMonTueWedThuFriSat
  
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
   
       
Today