=======================================================
MCSG: cmsetlog reference
=======================================================
:Title:        MCSG: cmsetlog reference
:Author:       Douglas O'Leary <dkoleary@olearycomputers.com>
:Description:  MCSG: cmsetlog reference
:Date created: 06/2007
:Date updated: 07/2008
:Disclaimer:   Standard: Use the information that follows at your own risk.  If you screw up a system, don't blame it on me...

cmsetlog is a useful utility that sends MCSG log messages into a user 
specified log file in addition to the syslog facility. It's a user 
contributed program, so it'll be hiding in /usr/contrib/bin. You'll have to 
use this program to support the philosophy of breaking out your syslog files 
(pls see Syslog daemon configuration), if you follow it.

You'll have to figure out a way to reexecute this program every time the 
cluster or a node is restarted as the program doesn't restart by default. 
That effort, though, is left as an exercise for the reader.

Desired results and command lines to achieve them follow:

1. Log all MCSG messages to a specific log file as well as to the syslog 
   facility. ::

      cmsetlog -f ${mcsg_log_file}

2. Return to logging to the syslog facility only::

      cmsetlog -s

3. After specifying a log file, request a greater level of detail:: 

      cmsetlog ${1-6}

   NOTE: Anything over 2 is going to start logging LOTS of information - to 
   the point it'll log heartbeat arrivals. Be careful of log sizes!

4. Reset logging to the default level 0::

      cmsetlog -r