Previous Table of Contents Next


3.1.10.2 IDL


   //File DAISSession.idl #ifndef _DAIS_SESSION_IDL #define _DAIS_SESSION_IDL #pragma prefix "omg.org" #include <DAISCommon.idl>

   module DAIS {

   struct SessionStatus { string name; DateTime start_time; DateTime current_time; DateTime last_update_time; unsigned long group_count; long band_width;

   };

   interface ShutdownCallback {

   void shutdown_notify (

in string reason
);
};

   interface Session {

   readonly attribute SessionStatusstatus;

   attribute ShutdownCallback callback;

   void destroy(); };}; #endif // _DAIS_SESSION_IDL

   SessionStatus

   A struct holding session status.

Parameter Description
name Within the server unique name of the session.
start_time The time when the session was started. This time is not reset during the session lifetime.
current_time The current time as known by the server.
last_update_time The time when the server sent an event notification for this session.
group_count The current number of groups for a data access session or the number of event subscriptions for an alarms & event session.
band_width If held updated by the server the percentage bandwidth in use for communication with underlying RTUs or devices. A value of 100 or more indicates that more bandwidth for communication with devices is required than available. A value of -1 indicates the value is unknown by the server.

   ShutdownCallback

   An object implemented by clients and used by the server to indicate that it will shutdown soon. No further calls should be made and no further data callbacks should be expected.

   shutdown_notify()


   Session

   An interface representing a single conversation with the DAIS service. The interface is inherited into interfaces representing sessions supporting specific services, (for example, data access or alarms & events).

   status A read only attribute holding the SessionStatus. callback An attribute holding a reference to a ShutDownCallback object. A client that wants to

   receive shut down callbacks from a server shall update the attribute with a reference to a ShutDownCallback object.

   destroy()

   A method for deletion of the session object.