Logging and error messages

The interface logs operational messages during interface startup, data collection and recovery. Additional messages are logged if you enable debugging.

To view messages, open the Windows Event Viewer on the interface's installed machine and go to the Applications and Services Logs. Locate the log using the generic interface name. The management of the logs can be done through the Windows Event Viewer.

Streaming messages for a batch interface display in the following format where {_iD} is the Interface ID instance:

{timestamp:yyyy-MM-dd HH:mm:ss.fff} {logLevel,-11} {_iD}: {msg}

where {_iD} is the Interface ID instance.

Within the Windows Event Viewer, the Event ID displayed for each batch interface log is the Interface ID instance.

To enable debug output for troubleshooting, launch PI Event Frames Interface Manager (EFIM), select your interface instance, and go to the Operational Settings tab.

Operational settings

Local debug messages (/DB=<#>)

Specifies level of detail for logging as follows:

• 0: Log errors and warnings (default)

• 1: Log errors, warnings and major successes

• 2: Log all messages

• 3: Log all messages including Unirecord diagnostic message

Command line parameter reference

/db =[#]

(Optional) Enabled debugging output:

• 0: Log only errors and warnings (default)

• 1: Log errors, warnings and major success messages

• 2: Log all messages (most verbose)

• 3: Log all messages including Unirecord diagnostic message