Arbortext Command Language > Functions by Alphabetical Listing > composer_log
  
composer_log
composer_log (destination, severity, verbosity)
The composer_log function sets the preferences for the Event Log file. Use this log file to troubleshoot publishing problems.
destination specifies the output destination for publishing events:
Setting
Description
0
Outputs to the Java Console.
1
Outputs to the Event Log window.
string
Outputs a text file to the specified path.
severity specifies the minimum severity of output events to generate:
Setting
Description
$eventlog::SEVERITY_INFO
Includes all diagnostic events, including errors and warnings.
$eventlog::SEVERITY_WARNING
Includes errors and warnings, but no informational events. This is the default setting.
$eventlog::SEVERITY_ERROR
Includes errors only.
verbosity indicates the amount of contextual information to generate in the log:
Setting
Description
0
No contextual information.
1
Exception message.
2
Exception message and traceback. This is the default setting.
For example,
# Trace all possible publishing events to a file.
composer_log("c:\\temp\\event.log", $eventlog::SEVERITY_INFO, 2)
# Trace warnings and errors (but not informational events) to the
# java console and don’t include traceback information.
composer_log(0, $eventlog::SEVERITY_WARNING, 1);
# Trace only errors (but not warnings and informational events)
# to the event log.
composer_log(1, $eventlog::SEVERITY_ERROR);
Related Topics
XSL stylesheet error handling during publishing
get_composer_log_doc function
get_composer_log_contents function
show_composer_log function