Application components can define events that are either triggered at a specified time or triggered explicitly. Events are stored persistently in the Netscape Application Server, and are removed only when your application explicitly deletes them. Events are typically used to schedule routine administrative tasks, such as making back-ups or getting statistics.

• The IAppEventMgr interface manages application events. This interface defines methods for creating, registering, triggering, enabling, disabling, enumerating, and deleting events.
• The IAppEventObj interface represents the defined events an application supports. This interface defines methods not only for getting or setting attributes of an event, but also for adding, deleting, or enumerating actions of the event.

• the event's state (enabled or disabled)
• the execution mode (concurrent or serial) of the event's actions
• the time at which to trigger the event

• executes a specified servlet.
• executes a specified AppLogic.
• sends an email message.

• Added functionality

• Execution of multiple actions of any type. (IAppEvent supports only one action of each type.)
• In addition to executing an AppLogic and sending email, a triggered event can now execute a servlet as one of the supported action types.
• Synchronous or asynchronous triggering of events. (IAppEvent supports only synchronous triggering.)
• Execution of actions in the same order they are registered.
• Execution of actions either concurrently or serially.
• Support for passing an input IValList object to triggered events.
• Different interfaces
• Previously, application events were represented by an IValList object, and you used the IAppEvent interface to manage the events. Now an application event is represented by an IAppEventObj, and you use IAppEventMgr to manage and control the events.
• Separate actions and attributes
• Previously, attributes and actions were not distinguished. They were all treated as event properties and specified within a single IValList object. Now attributes are described by entries in one IValList object, and each action is represented by its own additional IValList object.
• IAppEventObj has methods for getting or setting attributes and for adding, deleting, or enumerating actions.

IAppEventMgr com.kivasoft.dlm.GXContext.GetAppEventMgr(
	IContext context);

public IAppEventObj createEvent(
   String pEventName)

pEventName. The name of the event to create.

public int deleteEvent(
   String pEventName)

pEventName. The name of the registered event to delete.

public int disableEvent(
   String pEventName)

pEventName. The name of the registered event to disable.

public int enableEvent(
   String pEventName)

pEventName. The name of the registered event to enable.

public IEnumObject enumEvents()

// Open /tmp/report-file for writing the report 

FileOutputStream outFile = null; 

try { 

   outFile = new FileOutputStream("/tmp/report-file"); 

} catch (IOException e) { 

} 

if (outFile == null) 

   return streamResult("Can not open /tmp/report-file<br>"); 



ObjectOutputStream p = null; 

try { 

   p = new ObjectOutputStream(outFile); 

} catch (IOException e) { 

} 

if (p == null) 

    return streamResult("Cannot create ObjectOutputStream<br>"); 



// get appevent manager 

IAppEventMgr appEventMgr = GetAppEventMgr(); 



// Get the Enumeration object for all registered appevents 

   IEnumObject enumObj = appEventMgr.enumEvents(); 



// Retrieve the count of registered appevents 

int count = enumObj.enumCount(); 

try { 

    p.writeObject("Number of Registered Events: "); 

    p.writeInt(count); 

} catch (IOException e) { 

    return streamResult("Failed to write to report file<br>"); 

} 



enumObj.enumReset(0); 



IObject eventObj = enumObj.enumNext(); 

while ((eventObj = enumObj.enumNext()) != null) { 

    if (eventObj instanceof IAppEventObj) { 

        IAppEventObj appEventObj = (IAppEventObj)eventObj; 



        // print each appEvent



        // get the name of the appevent

        String name = appEventObj.getName();

        try { 

            p.writeObject("\nDefinitions for AppEvent: "); 

            p.writeObject(name); 

            p.writeObject("\n"); 

        } catch (IOException e) { 

               return streamResult("Failed to write to report file<br>"); 

        } 



        // print the attributes..

        IValList attrs = appEventObj.getAttributes();

        attrs.resetPosition();

        // Iterate through all the GXVALs in the attr s valllist

        //   and print them

             ...

             ...

             ... 



        // enumerate through the actions

        enumActions = appEventObj.enumActions();



        // Retrieve the count of registered actions for this event 

        count = enumActions.enumCount(); 

        try { 

            p.writeObject("Number of Actions: "); 

            p.writeInt(count); 

        } catch (IOException e) { 

      return streamResult("Failed to write ActionCount to report file"); 

        } 



        enumActions.enumReset(0);

        IObject obj ;

        while ((obj = enumActions.enumNext()) != null) {

            // print each action

            if (obj instanceof IValList) { 

                IValList action = (IValList)obj; 



                action.resetPosition(); 

                // Iterate through all the GXVALs in the vallist 

                // and print them 

                     ...

                     ...

                     ... 

            }

        }

    }

}

public IAppEventObj getEvent(
   String pEventName)

pEventName. The name of the registered event.

public int registerEvent(
   IAppEventObj appEventObj)

appEventObj. The event object whose attributes and actions have been set.

static final java.lang.String eventName1 = "RepGenEvent"; 



// get the appevent manager 

IAppEventMgr appEventMgr = GXContext.GetAppEventMgr(context);



// create a appevent object

IAppEventObj appEventObj = appEventMgr.createEvent(eventName1);



// create ValList for attributes.

IValList attrs = GX.CreateValList(); 



// set the Action Mode to Serial for serial-execution of actions.

attrs.setValInt(GXConstants.GX_AE2_RE_KEY_ACTION_MODE,

      GX_AE2_RE_SA_FLAG.GX_AE2_RE_ACTION_SERIAL);



// set the appevent time to be 05:00:00 hrs everyday 

attrs.setValString(GXConstants.GX_AE2_RE_KEY_TIME, "5:0:0 */*/*"); 



// set the attributes

appEventObj.setAttributes(attrs);



// create ValLists for actions (2 applogic newrequest and 2 servlet).

IValList action1 = GX.CreateValList(); 

IValList action2 = GX.CreateValList(); 

IValList action3 = GX.CreateValList(); 

IValList action4 = GX.CreateValList(); 



// set action1 to run an appLogic 

action1.setValString(GXConstants.GX_AE2_RE_KEY_NREQ,

       "GUIDGX-{620CB09B-1A1D-1315-AD23-0800207B918B}"); 



// set action1 to run another appLogic 

action2.setValString(GXConstants.GX_AE2_RE_KEY_NREQ,

       "GUIDGX-{60A36CC0-9F69-11D2-9907-0060973797BF}"); 



// set action2 to run a servlet 

action3.setValString(GXConstants.GX_AE2_RE_KEY_SERVLET,

       "TxReportServlet");



// set action3 to run another servlet 

action4.setValString(GXConstants.GX_AE2_RE_KEY_SERVLET,

       "SummaryReportServlet");



// add actions in the order we want them to be executed

appEventObj.addAction(action1);

appEventObj.addAction(action2);

appEventObj.addAction(action3);

appEventObj.addAction(action4);



// Register the event 

if (appEventMgr.registerEvent(eventName1, appEventObj) != GXE.SUCCESS) 

   return streamResult("Cannot register RepGenEvent<br>"); 

public int triggerEvent(
   String pEventName,
   IValList pValList,
   boolean syncFlag)

pEventName. The name of the event to trigger.

pValList. The IValList object that specifies the input that is passed to the triggered event and its actions.

syncFlag. The boolean flag that indicates whether the event is to be triggered synchronously (value is true) or asynchronously (value is false).