<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML//EN">
<BODY bgcolor="FFFFFF">
<title>
          CMS MessageLogger: Establishing File and Stream Destinations
</title>

<center>
<h1> <img src="header-public.gif" align="center"> </h1>

<font color=red>
<h1>Establishing File and Stream Destinations</h1>
</font>
</center>

<pre>
process TEST = {

  service = MessageLogger {
    <font color=red>vstring destinations = { "detailedInfo.txt"
			   , "critical.txt"
			   , "jobdebug.txt"
			   , "anotherfile.txt"
			   , "cout"
			   , "cerr"
			   }</font>
    vstring categories = { "unimportant"
			 , "trkwarning"
 			 , "serious_matter"
                         }
    PSet critical.txt = { string threshold = "ERROR"
                              PSet default = { int32 limit    = 10
			                       int32 timespan = 180
					     }
			      PSet serious_matter = { int32 limit = 100000 }
                        }
    PSet detailedInfo.txt = { string threshold = "INFO"
			      PSet default        = { int32 limit    =  10
					              int32 timespan =  60
					            }
			      PSet WARNING        = { int32 limit    = 100
			                              int32 timespan =  60 
					            }
			      PSet ERROR          = { int32 limit    = 100
			                              int32 timespan =  60 
					            }
			      PSet trkwarning     = { int32 limit    = 20
			                              int32 timespan = 1200
						    }
			      PSet unimportant    = { int32 limit    = 5 }
			      PSet serious_matter = { int32 limit    = 1000000 }
                            }
    PSet cerr     = { string threshold = "WARNING" }

    PSet jobdebug.txt =     { PSet default        = { int32 limit    = 1000000 }
                        }
    PSet anotherfile.txt =  { PSet serious_matter = { int32 limit    = 1000 } 
                            }
    PSet default = { int32 limit    = 10
                     int32 timespan = 60
		   }
  }

  untracked PSet maxEvents = {untracked int32 input = 10}
  path p = { myAnalysisModule }
  module myAnalysisModule = ModuleThatIssuesMessages { }
  source = EmptySource { }
}
</pre>


The <font color=red>vstring destinations = </font> {"detailedInfo.txt", ... }
parameter establishes one or more file (or ostream) destinations for the 
messages issued.  The destinations can be configured individually to establish
filtering of messages.  Since this is a <em> vstring</em> parameter, the 
names of the destinations are separated by commas.
<p>
In this case, we have specified four files (perhaps overkill in ordinary
circumstances, but we wished to use the four illustrate various configuration 
options).  We have also specified both cerr and cout; if this is done,
it is recommended that cout be re-directed to a file, otherwise the message
contents will be inter-mixed with those sent to cerr.
<p>
If messages are issued prior to the initiation of the MessageLogger service,
the configuration of these destinations will not yet have occurred.  Such
messages will be sent to cerr alone.

<p><center>
<img src="bar.gif"></center>

<p><center>
<a href="http://www.uscms.org/SoftwareComputing/index.html">
USCMS Software and Computing Home Page </a> - 
<a href="MessageLogger.html"> CMS MessageLogger Service Page </a> -
<a href="parameters.html#complete"> Configuration File </a>
</center>

<p>
      <hr>
      <address><a href="mailto:mf@fnal.gov">Mark Fischler</a></address>
<!-- hhmts start -->
Last modified: Dec 1, 2005
<!-- hhmts end -->
</body>








