|
The Microsoft Exchange Server 5.5 Event Service is a Microsoft Windows NT Service that runs the events.exe program on the Microsoft Exchange Server 5.5 machine. This service is installed as part of the Microsoft Exchange Server 5.5 setup, if it is a new installation of Microsoft Exchange Server 5.5. If you are running an update from a previous version of Microsoft Exchange Server 4.x/5.x this service is not installed by default. The event service uses a Microsoft Windows NT account (the default is the same as the Microsoft Exchange Service account). For more information about the installation, please take a look at The Secrets of Exchange Server Scripting and Routing, Installation.
| Component | Description |
|---|---|
| Event Configuration (Binding Data) | The system folder Folders\System Folders\Events Root\EventConfig_<Your Servername> holds an entry for each created Microsoft Scripting and Routing script, which is installed inside a particular public or private folder. This system folder is installed as part of the Microsoft Exchange Server 5.5 setup. |
| Event Service (events.exe) | The Microsoft Windows NT
service that runs the events.exe program on the Microsoft Exchange
Server5.5 machine. This service is installed as part of the
Microsoft Exchange Server 5.5 setup. The Microsoft Windows NT Account which is specified by the installation is used per default to run this service. However, you can use another account if you want. This specific account must be granted with Log on as a service rights in the Microsoft Windows NT User Manager. Start Microsoft Windows NT User Manager and choose Policies, User Rights, select Show Advanced User Rights, locate Log on as a service and add the account you want to use. The Event Service keeps track of the agents registered for every type of folder event. Because the agent called Microsoft Exchange Server 5.5 Agent Scripting has been registered for events in this folder, the Microsoft Exchange Server 5.5 Event Service instantiate an agent of this type. |
| Change List | The change list is a function used with the Incremental Change Synchronization (ICS). It is a mechanism to monitor, export, and import changed items (both hierarchy and content) between an external datasource and an information store or between two information stores. ICS is used within Microsoft Exchange Server 5.5 for local replication and for backup of information store data. |
| Server Folder (public folder or private folder) | The Microsoft
Exchange Server 5.5 folder where the script is saved and
which is monitored from the Microsoft Exchange Server 5.5
Event Service. This can be a particular public folder or a
private folder (e. g. the inbox of your mailbox). These
folders must be stored on the Microsoft Exchange Server 5.5
machine. Folders stored in local files (e. g. .pst files)
cannot be used. Each script does run on the server. If you have installed a script in a users private mailbox (e. g. the inbox), it is not necessary if the user is logged on or not. The script will always run, but it cannot access any resource of a local machine (e. g. a file on the users workstation). Each script uses intrinsic objects to get detailed information of the item. For more information, please take a look at Microsoft Exchange Server Event Service Objects. |
| Script Code | The script, stored as a hidden item in that folder where you have installed the Exchange Scripting Agent script. These scripts are only visible through the Agents tab in Microsoft Outlook 9x/2000 or through a MAPI utility like MDBVU32.EXE, which is included on the Microsoft Exchange Server 5.5 CD-ROM. |
| Scripting Agent (scripto.dll/ss.dll) | An ActiveX scripting
engine that processes scripts. This element is a Component Object
Model (COM) object that exposes the IExchangeEventHandler interface. You can bind a Microsoft Exchange Server 5.5 Scripting Agent script programmatically if you use the class ID "{69E54151-B371-11D0-BCD9-00AA00C1AB1C}" and some script code. This engine exposes the m>intrinsic objects, which can be used to get the information of the session, folder and message. For more information, please take a look at Microsoft Exchange Server Scripting Agent Events. |
| Routing Engine (exrteng.dll/exrtobj.dll) | An ActiveX scripting
engine that processes scripts. This element is a Component Object
Model (COM) object that exposes the IExchangeEventHandler interface. You can bind a Microsoft Exchange Server 5.5 Routing script programmatically if you use the class ID "{69E64151-B371-11D0-BCD9-00AA00C1AB1C}" and some script code. For more information, please take a look at The Secrets of Microsoft Exchange Server Scripting and Routing, Routing Architecture. |
If a specific event occurs in a folder, such as a timer event or creating, modifying, or deleting an item, the Exchange Scripting Agent script is fired. Microsoft Exchange Server 5.5 Scripting Agent scripts can be used in a particular private folder of a Microsoft Exchange Server 5,5 mailbox or a particular public folder.
There are four different types of events which can occur. Microsoft Exchange Server 5.5 Scripting Agent handles the following events:
| Event | Description |
|---|---|
| Folder_OnMessageCreated | Each time an item is created in a particular folder, this event is fired. This means if an item is copied, moved or created in a particular public or private folder or a new message arrives in a folder. |
| Folder_OnMessageDeleted | Each time an item is deleted in a particular folder, this event is fired. This means a user or rule deletes an existing item. |
| Message_OnChange | Each time an item is changed in a particular folder, this event is fired. This means an existing item is modified in a particular public or private folder. |
| Folder_OnTimer | Each time, which is specified in the Agents tab, this event is fired. You can specify timer events in the Agent tab of the particular public or private folder. This event can be used e. g. to check a folder for items older than a specific date. |
The Microsoft Exchange Server 5.5 event service exposes three, so called, intrinsic objects. These objects are passed to the Microsoft Exchange Server 5.5 Scripting Agent script and can be used to get detailed information of the item which has fired this event:
| Object | Description |
|---|---|
| EventDetails.Session | This is the CDO 1.x session object the agent is currently logged on as. For more information, please take a look at the CDO.HLP and AGENTS.HLP file, which are included on the Microsoft Exchange Server 5.5 CD-ROM. You can also download the most current of the CDO.HLP/AGENTS.HLP file version from CDOLive cdo.zip (1,065 Kbyte), agents.zip (206 Kbyte). |
| EventDetails.FolderID | The CDO 1.x entry ID of the folder where the script is fired. For more information, please take a look at the CDO.HLP and AGENTS.HLP file, which are included on the Microsoft Exchange Server 5.5 CD-ROM. You can also download the most current of the CDO.HLP/AGENTS.HLP file version from CDOLive cdo.zip (1,065 Kbyte), agents.zip (206 Kbyte). |
| EventDetails.MessageID | The CDO 1.x message ID of the particular message. If the event is a timer event the message ID is null. For more information, please take a look at the CDO.HLP and AGENTS.HLP file, which are included on the Microsoft Exchange Server 5.5 CD-ROM. You can also download the most current of the CDO.HLP/AGENTS.HLP file version from CDOLive cdo.zip (1,065 Kbyte), agents.zip (206 Kbyte). |