77 lines
3.0 KiB
HTML
77 lines
3.0 KiB
HTML
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<html>
|
|
<head>
|
|
<META http-equiv="Content-Type" content="text/html; charset=utf-8">
|
|
<LINK rel="stylesheet" type="text/css" href="../../../rzahg/ic.css">
|
|
|
|
<title>Set up for combined JRas operation</title>
|
|
</head>
|
|
|
|
<BODY>
|
|
<!-- Java sync-link -->
|
|
<SCRIPT LANGUAGE="Javascript" SRC="../../../rzahg/synch.js" TYPE="text/javascript"></SCRIPT>
|
|
|
|
<h6><a name="jrasetc"></a>Set up for combined JRas operation</h6>
|
|
|
|
<p>In combined mode, messages and trace are logged to both WebSphere Application Server - Express logs
|
|
and user-defined logs. The following sample assumes that you have written a user defined handler named
|
|
SimpleFileHandler and a user defined formatter named SimpleFormatter. It also assumes that you are not
|
|
using user defined types or events.</p>
|
|
|
|
<ol>
|
|
<li>Import the requisite JRas extensions classes:
|
|
<pre>
|
|
import com.ibm.ras.*;
|
|
import com.ibm.websphere.ras.*;
|
|
</pre>
|
|
</li>
|
|
<li>Import the user handler and formatter:
|
|
<pre>
|
|
import com.ibm.ws.ras.test.user.*;
|
|
</pre>
|
|
</li>
|
|
<li>Declare the logger references:
|
|
<pre>
|
|
private RASMessageLogger msgLogger = null;
|
|
private RASTraceLogger trcLogger = null;
|
|
</pre>
|
|
</li>
|
|
<li>Obtain a reference to the Manager, create the loggers and add the user handlers.
|
|
<p>Since loggers are named singletons, you can obtain a reference to the loggers in a number of places.
|
|
One logical candidate for servlets is the servlet init() method. Make sure that multiple instances of
|
|
the same user handler are not accidentally inserted into the same logger. Your initialization code must
|
|
handle this. The following sample is a message logger sample. The procedure for a trace logger is
|
|
similar.</p>
|
|
<pre>
|
|
com.ibm.websphere.ras.Manager mgr = com.ibm.websphere.ras.Manager.getManager();
|
|
msgLogger = mgr.createRASMessageLogger("Acme", "WidgetCounter",
|
|
"RasTest", myTestServlet.class.getName);
|
|
|
|
// Configure the message logger to use the message file
|
|
// defined in the ResourceBundle sample.
|
|
|
|
msgLogger.setMessageFile("acme.widgets.DefaultMessages");
|
|
|
|
// Create the user handler and formatter. Configure the formatter,
|
|
// then add it to the handler.
|
|
|
|
RASIHandler handler = new SimpleFileHandler("myHandler", "FileName");
|
|
RASIFormatter formatter = new SimpleFormatter("simple formatter");
|
|
formatter.addEventClass("com.ibm.ras.RASMessageEvent");
|
|
handler.addFormatter(formatter);
|
|
|
|
// Add the Handler to the logger. Add the logger to the list of
|
|
// the handlers listeners, then set the handlers
|
|
// mask, which will update the loggers composite mask appropriately.
|
|
// WARNING - there is an order dependency here that must be followed.
|
|
|
|
msgLogger.addHandler(handler);
|
|
handler.addMaskChangeListener(msgLogger);
|
|
handler.setMessageMask(RASIMessageEvent.DEFAULT_MESSAGE_MASK);
|
|
</pre>
|
|
</li>
|
|
</ol>
|
|
|
|
</body>
|
|
</html>
|