Programming with the JRas framework
Use the JRas extensions to incorporate message logging and diagnostic trace into WebSphere Application Server applications.
Deprecated feature: The JRas framework described in this task and its sub-tasks is deprecated. However, we can achieve similar results using Java logging.depfeat
The JRas extensions allow message logging and diagnostic trace to work with WebSphere Application Server applications. They are based on the stand-alone JRas logging toolkit.
This topic references one or more of the application server log files. As a recommended alternative, we can configure the server to use the High Performance Extensible Logging (HPEL) log and trace infrastructure instead of using SystemOut.log , SystemErr.log, trace.log, and activity.log files on distributed and IBM i systems. We can also use HPEL in conjunction with the native z/OS logging facilities. If we are using HPEL, we can access all of the log and trace information using the LogViewer command-line tool from the server profile bin directory. See the information about using HPEL to troubleshoot applications for more information on using HPEL.
- Retrieve a reference to the JRas manager.
- Retrieve message and trace loggers by using methods on the returned manager.
- Call the appropriate methods on the returned message and trace loggers to create message and trace entries, as appropriate.
Subtopics
- JRas logging toolkit
The JRas logging toolkit provides diagnostic information to help the administrator diagnose problems or tune application performance. - JRas Extensions
JRas extensions are the collection of implementation classes that support JRas integration into the WAS environment. - JRas messages and trace event types
The basic JRas message and event types are not the same as those natively recognized by WebSphere Application Server, so the JRas types are mapped onto the types that are native to the runtime environment. We can control the way JRas message and trace events are processed using custom filters and message controls. - Instrument an application with JRas extensions
We can create an application using JRas extensions.