LogOutput

LogOutput writes a message to the tm1server.log file when an error of a specified severity level is encountered in a TurboIntegrator process.

This function is valid in TM1® TurboIntegrator processes only.

Prerequisite

To enable message logging from TurboIntegrator, you must add the TM1.TILogOutput debugger to the tm1-log.properties file and set the debugger to the desired level. For example, adding TM1.TILogOutput=DEBUG to tm1-log.properties enables logging for all severity levels. For details on the tm1-log.properties file, see Configuring and Enabling Server Message Logging in TM1 Operations.

Syntax

LogOutput('SeverityLevel', 'MessageString');
Argument Description
SeverityLevel The severity level that initiates logging to the tm1server.log file. Valid values for this argument are:
  • 'DEBUG'
  • 'INFO'
  • 'WARN'
  • 'ERROR'
  • 'FATAL'
MessageString The message you want to write to the tm1server.log file. The message string can be a string enclosed in single quotes or can be another TurboIntegrator function that returns a string.

Examples

LogOutput('WARN', 'TI process encountered a warning condition');
LogOutput('ERROR', TM1User() );