SYN_REPORTEVENT

Write entries to the event log

WSupported on Windows

USupported on Unix

VSupported on OpenVMS

xcall SYN_REPORTEVENT(type, text)

Arguments

type

For Windows, one of the following Microsoft Windows event log types (ignored on Unix and OpenVMS):

D_EVENTLOG_SUCCESS

A successful operation.

D_EVENTLOG_ERROR_TYPE

A significant problem the user should know about, such as loss of functionality or data.

D_EVENTLOG_WARNING_TYPE

A problem that is not immediately significant but that may cause future complications (for example, resource consumption).

D_EVENTLOG_INFORMATION_TYPE

An infrequent but significant successful operation (for example, successful loading of a major server service).

D_EVENTLOG_AUDIT_SUCCESS

A security event that occurs when an audited access attempt is successful (for example, a successful log-on attempt).

D_EVENTLOG_AUDIT_FAILURE

A security event that occurs when an audited access attempt fails (for example, a failed attempt to open a file).

text

The text to be written to the event log. (a)

Discussion

The SYN_REPORTEVENT routine enables a Synergy program to report errors and other information to the system log (the event log on Windows, syslog on Unix, or the operator console on OpenVMS). It is most beneficial when used by services or detached programs.

Examples

xcall syn_reportevent(D_EVENTLOG_ERROR_TYPE, "My program had an error")