do-generate-event

Sends an Identity Manager user-defined event to the Novell® Auditing service. Identity Manager user defined event IDs must be between the range of 1000 to 1999. Valid event levels are defined in the table below. The remaining event data fields are provided by four <arg-string> elements with name attributes. The Novell Audit event structure contains two strings (text1, text2) along with one integer (value) and generic field (data). The two text fields are limited to 256 bytes and the data field can contain up to 3 KB of information.

Remarks

Level

Description

log-emergency

Events that cause the Metadirectory engine or Identity Manager driver to shut down.

log-alert

Events that require immediate attention.

log-critical

Events that can cause parts of the Metadirectory engine or Identity Manager driver to malfunction.

log-error

Events describing errors that can be handled by the Metadirectory engine or Identity Manager driver.

log-warning

Negative events not representing a problem.

log-notice

Events (positive or negative) an administrator can use to understand or improve use and operation.

log-info

Positive events of any importance.

log-debug

Events of relevance for support or engineers to debug operation of the Metadirectory engine or Identity Manager driver.

Tag

Description

text1

Text entered here is stored in the text1 event field.

text2

Text entered here is stored in the text2 event field.

value

Any number entered here is stored in the value1 event field.

data

Data entered here is stored in the blob event field.

Example

<do-generate-event id="1000" level="log-info">  <arg-string name="text1"> <token-text>User defined data for text1field</token-text> </arg-string> <arg-string name="text2"> <token-text>User defined data for text2field</token-text> </arg-string> <arg-string name="value"> <token-text>-602</token-text> </arg-string> <arg-string name="data"> <token-text>User defined blob data</token-text> </arg-string></do-generate-event >

Allowed Content

Element

Description

arg-string

String argument.

Attributes

Attribute

Possible Values

Default Value

disabled

true | false

True if this element is disabled.

false

id

CDATA

Identity Manager user-defined event ID (1000-2000). Supports variable expansion.

#REQUIRED

level

log-emergency | log-alert | log-critical | log-error | log-warning | log-notice | log-info | log-debug

Novell Audit log level.

log-info

notrace

true | false

True if this element should not be traced during execution of the policy.

false

Content Rule

( arg-string * )

Parent Elements

Element

Description

actions

Actions that are performed by a <rule>.

arg-actions

Actions argument.