composer

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);