Event Log - Write

Declaration

<AMEVENTLOG MESSAGE="text (message to log)" TYPE="text (options)" />

Description:

Logs the specified message to the Windows Event Log (not supported on Windows 95/98/ME). This activity can also specify a level value such as warning or error, in order to limit the events that are written to those that specify the error level.

Practical Usage

Provides a way to record user generated messages onto a central location. Can be used together with an Event Log trigger in order to control

Parameters

General

Property

Type

Required

Default

Markup

Description

Message

 

Yes

(Empty)

MESSAGE="Message to log"

The message to log.

Message type

Text

(options)

Yes

Information

  1. TYPE="information"

  2. TYPE="warning"

  3. TYPE="error"

The type of entry to log. The available options are:

  • Information (default) - The log entry will be categorized as information. This can be used to display general information or describe successful operation of an application, driver, or service.

  • Warning - The log entry will be categorized as a warning message, such as an event that is not necessarily significant, but may indicate a possible future problem.

  • Error - The log entry will be categorized as an error message. Can be used to indicate a significant problem such as loss of data or functionality.

Description

Error Causes

On Error

Example

NOTE: The sample AML code below can be copied and pasted directly into the Steps panel of the Task Builder.

Description: Report error event "There was a problem executing the application.".

<AMEVENTLOG MESSAGE="There was a problem executing the application." TYPE="error" />