When a user needs to schedule a job based on a custom event, the administrator configures properties in the shared configuration file, acserverconfig.xml, to set up a web service application for triggering the job to run. This section describes these properties.
The AC_CONFIG_HOME variable represents the path to the folder containing acserverconfig.xml. In a default BIRT iHub installation on Windows, performed using the graphical installer, in which the install folder is C:\Actuate, AC_CONFIG_HOME represents the following path:
In a cluster consisting of two or more nodes, AC_CONFIG_HOME represents the shared configuration directory the system administrator created before adding the second node to a cluster. For more information, see "Adding cluster nodes to a cluster," in Chapter 5, “Managing clusters,” in BIRT iHub System Administration Guide.
The administrator configures event-based job properties by specifying values for the following variables in acserverconfig.xml:
EventPollingInterval
Specifies the frequency in minutes that iHub checks for a system event. The default value is 5 minutes.
EventPollingDuration
Specifies the duration in minutes that BIRT iHub checks for an event. If the event does not occur within the allotted time, BIRT iHub marks it as expired. A user can customize this value when creating an event-driven schedule. This value applies to all types of system events. The default value is 300 minutes.
EventLagTime
Specifies the minutes that BIRT iHub scans for completed jobs to determine if an event occurred. For example, if you submit an event-based schedule with the default event lag time, BIRT iHub checks the status of jobs for the previous 60 minutes. If the event occurred within the previous 60 minutes, it sets the event status to satisfied.The default value is 60 minutes.
EnableCustomEventService
A flag that enables BIRT iHub custom event processing for a scheduled job. If the value is true, the service is enabled. If you change the value to false, all the existing instances of scheduled jobs using the custom event fail. This configuration value also affects the EnableEventService property value in the Actuate IDAPI GetVolumeProperties response. The default value is True.
CustomEventServiceIPAddress
Specifies the server name or IP address where the custom event service resides. The default value is localhost.
CustomEventServicePort
Specifies the number of a valid, used port for the custom event service. iHub uses an application container to host web services applications. The default value is 8700.
CustomEventServiceContextString
Specifies the context string of the request URL for sending a message to the custom event service. The default value is /acevent/servlet/AxisServlet.
EventPollingInterval