Creating a Session
To interact with a Universal Messaging Server, the first thing to do is configure and start a Universal Messaging Session object, which is effectively your logical and physical connection to one or more Universal Messaging Realms.
Configuring a Universal Messaging Session Object
A Universal Messaging session object is created using the Nirvana.createSession() function. Once created, a session can be started at will:
var mySession = Nirvana.createSession();
The Nirvana.createSession() function may be passed an optional configuration object as a parameter, as follows:
var mySession = Nirvana.createSession({
realms : [ "http://showcase.um.softwareag.com:80" ],
// this can be an array of realms
debugLevel : 4, // 1-9 (1 = noisy, 8 = severe, 9 = default = off)
sessionTimeoutMs : 10000,
enableDataStreams : false,
drivers : [ // an array of transport drivers in preferred order:
Nirvana.Driver.WEBSOCKET,
Nirvana.Driver.XHR_STREAMING_CORS,
Nirvana.Driver.XDR_STREAMING,
Nirvana.Driver.JSONP_LONGPOLL
]
});
For a full list of the parameters used in this configuration object, please see the JavaScript API Documentation for Nirvana.createSession().
Starting your Session
Once a session object has been created, the session may be started as follows:
var mySession = Nirvana.createSession();
mySession.start();
Session Start Callbacks
When a Universal Messaging Session is successfully started following a call to start(), an asynchronous callback will be fired. You can assign a function to be fired as follows:
function sessionStarted(s) {
console.log("Session started with ID " + s.getSessionID());
}
var mySession = Nirvana.createSession();
mySession.on(Nirvana.Observe.START, sessionStarted);
mySession.start();
For more details on methods available on a session object, please see the JavaScript API Documentation for the Universal Messaging Session object.