IBM WebSphere Application ServerTM
Release 8

com.ibm.ras
Interface RASIMaskChangeGenerator

All Superinterfaces:
RASIObject, java.io.Serializable
All Known Subinterfaces:
RASIHandler, RASILogger, RASIMessageLogger, RASITraceLogger
All Known Implementing Classes:
RASLogger, RASMaskChangeGenerator, RASMessageLogger, RASTraceLogger, WsHandler, WsJrasMessageLogger, WsJrasTraceLogger

Deprecated. As of WAS 6.0, recommend using java.util.logging

public interface RASIMaskChangeGenerator
extends RASIObject

RASIMaskChangeGenerator defines the methods that must be implemented to control the message and trace masks and to generate mask change events. These events notify the listener that the state of the object's message or trace mask has changed.

RASIMaskChangeGenerator also provides methods that allow it to know which RASIEvent classes it can query to learn the event type values that might be used in its message or trace masks. This information can also be presented to a graphical program to display these event types to an end user.

This interface defines methods common to RASILoggers and RASIHandlers. It should not be necessary to implement this directly.


Method Summary
 void addMaskChangeListener(RASIMaskChangeListener listener)
          Deprecated. Adds an object that wishes to be informed of changes in the message or trace mask configuration.
 void addMessageEventClass(java.lang.String name)
          Deprecated. Adds the name of a message event class which this object uses.
 void addTraceEventClass(java.lang.String name)
          Deprecated. Adds the name of a trace event class which this object uses.
 void fireMaskChangedEvent(RASMaskChangeEvent mc)
          Deprecated. Tells all RASIMaskChangeListeners that the message or trace mask has been changed.
 java.util.Hashtable getConfig()
          Deprecated. Gets the configuration of this object.
 java.util.Enumeration getMaskChangeListeners()
          Deprecated. Gets the set of objects that wish to be informed of changes in the message or trace mask configuration.
 java.util.Enumeration getMessageEventClasses()
          Deprecated. Gets the set of message event classes which this object uses.
 long getMessageMask()
          Deprecated. Gets the mask which defines the set of message types that will be processed.
 java.util.Enumeration getTraceEventClasses()
          Deprecated. Gets the set of trace event classes which this object uses.
 long getTraceMask()
          Deprecated. Gets the mask which defines the set of trace types that will be processed.
 void removeMaskChangeListener(RASIMaskChangeListener listener)
          Deprecated. Removes an object from the list that wishes to be informed of changes in the message or trace mask configuration.
 void removeMessageEventClass(java.lang.String name)
          Deprecated. Removes the name of a message event class from the list of classes which this object uses.
 void removeTraceEventClass(java.lang.String name)
          Deprecated. Removes the name of a trace event class from the list of classes which this object uses.
 void setConfig(java.util.Hashtable ht)
          Deprecated. Sets the configuration of this object.
 void setMessageMask(long mask)
          Deprecated. Sets the mask which defines the set of message types that will be processed.
 void setTraceMask(long mask)
          Deprecated. Sets the mask which defines the set of trace types that will be processed.
 
Methods inherited from interface com.ibm.ras.RASIObject
getDescription, getGroup, getName, setDescription, setName
 

Method Detail

getConfig

java.util.Hashtable getConfig()
Deprecated. 
Gets the configuration of this object.

Specified by:
getConfig in interface RASIObject
Returns:
A Hashtable containing the configuration. This object inserts the following key/value pairs into the the configuration:

messageMask
The mask which selects the message types to be processed.
traceMask
The mask which selects the trace types to be processed.
messageEventClasses
A blank-delimited list of message event classes which this object uses.
traceEventClasses
A blank-delimited list of trace event classes which this object uses.

All values are Strings. Extensions to this object may add additional keys.


setConfig

void setConfig(java.util.Hashtable ht)
Deprecated. 
Sets the configuration of this object. This method is used by a RASManager to initialize a RAS object. It should not be necessary for an application to use this method.

Specified by:
setConfig in interface RASIObject
Parameters:
ht - A Hashtable containing the configuration. This object searches for the following keys:

messageMask
The mask which selects the message types to be processed.
traceMask
The mask which selects the trace types to be processed.
messageEventClasses
A blank-delimited list of message event classes which this object uses.
traceEventClasses
A blank-delimited list of trace event classes which this object uses.

All values are Strings. If a key is not found, an internal default for that element is set instead. Extensions to this object may add additional keys.


getMessageMask

long getMessageMask()
Deprecated. 
Gets the mask which defines the set of message types that will be processed. Possible values are defined by the logical OR of the RASIMessageEvent TYPE_XXXX constants.

Returns:
The message mask.

setMessageMask

void setMessageMask(long mask)
Deprecated. 
Sets the mask which defines the set of message types that will be processed. Possible values are defined by the logical OR of the RASIMessageEvent TYPE_XXXX constants. The mask value is not validated against these types.

Parameters:
mask - The message mask.

getTraceMask

long getTraceMask()
Deprecated. 
Gets the mask which defines the set of trace types that will be processed. Possible values are defined by the logical OR of the RASITraceEvent TYPE_XXXX constants.

Returns:
The trace mask.

setTraceMask

void setTraceMask(long mask)
Deprecated. 
Sets the mask which defines the set of trace types that will be processed. Possible values are defined by the RASITraceEvent TYPE_XXXX constants. The mask value is not validated against these types.

Parameters:
mask - The trace mask.

addMaskChangeListener

void addMaskChangeListener(RASIMaskChangeListener listener)
Deprecated. 
Adds an object that wishes to be informed of changes in the message or trace mask configuration. If the listener is null or is already registered, this method does nothing.

Parameters:
listener - The mask change listener.

removeMaskChangeListener

void removeMaskChangeListener(RASIMaskChangeListener listener)
Deprecated. 
Removes an object from the list that wishes to be informed of changes in the message or trace mask configuration. If the listener is null or is not registered, this method does nothing.

Parameters:
listener - The mask change listener.

getMaskChangeListeners

java.util.Enumeration getMaskChangeListeners()
Deprecated. 
Gets the set of objects that wish to be informed of changes in the message or trace mask configuration.

Returns:
An Enumeration of mask change listeners. If no listeners are registered, the Enumeration is empty.

fireMaskChangedEvent

void fireMaskChangedEvent(RASMaskChangeEvent mc)
Deprecated. 
Tells all RASIMaskChangeListeners that the message or trace mask has been changed.

Parameters:
mc - A mask change event, indicating what has changed.

addMessageEventClass

void addMessageEventClass(java.lang.String name)
Deprecated. 
Adds the name of a message event class which this object uses. If the event class is null or is already registered, this method does nothing.

Parameters:
name - The event class name.

removeMessageEventClass

void removeMessageEventClass(java.lang.String name)
Deprecated. 
Removes the name of a message event class from the list of classes which this object uses. If the event class is null or is not registered, this method does nothing.

Parameters:
name - The event class name.

getMessageEventClasses

java.util.Enumeration getMessageEventClasses()
Deprecated. 
Gets the set of message event classes which this object uses.

Returns:
An Enumeration of RAS event class names. If no event classes are registered, the Enumeration is empty.

addTraceEventClass

void addTraceEventClass(java.lang.String name)
Deprecated. 
Adds the name of a trace event class which this object uses. If the event class is null or is already registered, this method does nothing.

Parameters:
name - The event class name.

removeTraceEventClass

void removeTraceEventClass(java.lang.String name)
Deprecated. 
Removes the name of a trace event class from the list of classes which this object uses. If the event class is null or is not registered, this method does nothing.

Parameters:
name - The event class name.

getTraceEventClasses

java.util.Enumeration getTraceEventClasses()
Deprecated. 
Gets the set of trace event classes which this object uses.

Returns:
An Enumeration of RAS event class names. If no event classes are registered, the Enumeration is empty.

IBM WebSphere Application ServerTM
Release 8