Getting Started

Documentation

Glish

Learn More

Programming

Contact Us

Version 1.9 Build 1556

News	FAQ
Search	Home

logger.log - Function

	Package	utility
	Module	tasking
	Tool	logger

Add a message to the logging system

Synopsis
log(timeString, priority, message, origin, postglobally, postlocally, postcli)

Description
Add a message to the logging system. This is the preferred mechanism for Glish scripts to add messages to the logging message file. Note that although priority=SEVERE is allowed, we prefer that in general, the Glish fail mechanism is used for irrecoverable conditions.

Arguments

timeString	in	time
		Allowed:	String
		Default:	Current time
priority	in	Priority of message
		Allowed:	NORMAL|DEBUGGING|WARN|SEVERE
message	in	Message
		Allowed:	String
origin	in	source of the message
		Allowed:	string
		Default:	[=]
postglobally	in	Write into log table?
		Allowed:	Bool
		Default:	T
postlocally	in	Write to screen?
		Allowed:	Bool
		Default:	T
postcli	in	Show message in CLI window too?
		Allowed:	Bool
		Default:	F

Returns
Bool

Example

include 'logger.g';
dl.log('', 'SEVERE', 'File does not exist', 'file.open');