The Tcl logging manager library module has the file name logman.tcl. This module manages messages and allows the messages to be dynamically sent to either a local log file (using the personal logging API) or the system logger.

This module uses the personal logging API to send messages to a local log and the system logger API to send messages to the system logger.

Note that in this first version of the Tcl software built by Future Lab, the client/server modules are not included. This includes the system logger API.

This module contains the following global data:

• the current log name or destination (logman_name)
• is active flag (logman_flag)
• has this API been properly initialized at least once flag (logman_has_init)
• is destination the system_logger flag (logman_is_syslog)
• console output flag (logman_console_output)

Here is a list of functions in the logging manager library module:

• logman_start
• logman_end
• logman
• logman_is_active
• logman_get_name
• logman_console
• logman_get_console

Module Dependencies

The following modules are required along with this module:

• logger.tcl

Module Definition Files

This module requires the definition file:

• stdhead.tcl

Module Procedures

logman_start

Declaration  : proc logman_start {dest {apname ""}}
Parameters   :
      Name   : dest
      Type   : string
Description  : message destination

      Name   : apname
      Type   : string
      Default: empty
Description  : application name

Returns      : zero upon success, one (personal logging) or a sys_log code

This procedure will start logging through the log manager by either starting to log using a local log file or the system log interface depending on the contents of the message destination. The application name parameter is only required (always) for the system logger. If logging has been successfully started with a message destination at least once, you are allowed to pass an empty string for the message destination which indicates to re-start the same destination. This procedure returns a system log code if the system log was requested or zero upon success, one upon failure when the system log was not requested.

logman_end

Declaration  : proc logman_end {}

This procedure will stop the log manager and all logging.

logman

Declaration  : proc logman {mes}
Parameters   :
      Name   : mes
      Type   : string
Description  : message string

This procedure will output the message string through the log manager to the current destination. The message is only output if the log manager is active (by calling the procedure logman_start).

logman_is_active

Declaration  : proc logman_is_active {}

Returns      : 1 if active, 0 otherwise

This procedure will return the status of the log manager.

logman_get_name

Declaration  : proc logman_get_name {}

Returns      : current log name or destination

This procedure will obtain and return the current log name or destination.

logman_console

Declaration  : proc logman_console {flag}
Parameters   :
      Name   : flag
      Type   : boolean number
Description  : console output flag

This procedure will set whether logging output will be sent to the console/screen. Output will be turned off if the console output flag is zero. Any other value will cause console output to be turned on.

logman_get_console

Declaration  : proc logman_get_console {}

Returns      : 1 if console output is on, 0 otherwise

This procedure will return the current log console output flag.