IApp­Log

Object Model

The Application Log object is used to log application messages.

Remarks

With the properties and methods of an Application Log object, you can:

• Open a log group using the Open method.

• Set or get the logging properties using the LogID, Project, UserID, and SessionID properties.

• Log a formatted message using the Log and Error methods.

• Log a trace message using the Trace method.

• Log a metrics message using the Metric method.

All of the log methods return success, even if the log group is not available.

The log location is read from the registry:

HKEY_LOCAL_MACHINE\Software\SPSS\DimensionNet\Log\Directory

If the location setting cannot be read from the registry, the log group is created in the system temp directory.

The log filter is read from the registry:

HKEY_LOCAL_MACHINE\Software\SPSS\DimensionNet\Log\Filter

If the filter setting cannot be read from the registry, trace level message will be filtered by default.

The maximum number of log files is read from:

HKEY_LOCAL_MACHINE\Software\SPSS\DimensionNet\Log\MaxFiles

The default maximum number of files is 50.

The maximum file size is read from:

HKEY_LOCAL_MACHINE\Software\SPSS\DimensionNet\Log\MaxFileSizeInKB

The default maximum file size is 4096KB.

The log group settings can be overridden for each group by including settings in a sub-key with the same name as the group. For example, the following registry setting will override the default location for the IBD group:

HKEY_LOCAL_MACHINE\Software\SPSS\DimensionNet\Log\IBD\Directory = "c:\temp"

Groups

Operations
Error	Writes a formatted error entry to the log.
Log	Writes a formatted log entry to the log.
LogDetailed	Writes a formatted log entry to the log where all components of the entry can be specified
Metric	Writes a formatted metrics entry to the log.
Open	Opens an application log group.
Trace	Writes a formatted trace entry to the log.
Warning	Writes a formatted warning entry to the log.
Read-only Properties
IsActive	Read-only property that indicates whether the logger is active.
IsTraceEnabled	Read-only property that indicates whether trace logging is active.
Read/Write Properties
LogID	The LogID. (Default Property)
Project	The active project name.
SessionID	The Session ID.
UserID	The active user name.

Interface ID

The ID of the IAppLog interface is AA0F2A71-C887-4C54-887C-1F8E5E1BEA4B.