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
  1. public interface RASIMaskChangeGenerator
  2. 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

Modifier and Type Method and Description
  1. void
addMaskChangeListener(RASIMaskChangeListener listener)
Deprecated. Adds an object that wishes to be informed of changes in the message or trace mask configuration.
  1. void
addMessageEventClass(java.lang.String name)
Deprecated. Adds the name of a message event class which this object uses.
  1. void
addTraceEventClass(java.lang.String name)
Deprecated. Adds the name of a trace event class which this object uses.
  1. void
fireMaskChangedEvent(RASMaskChangeEvent mc)
Deprecated. Tells all RASIMaskChangeListeners that the message or trace mask has been changed.
  1. java.util.Hashtable
getConfig()
Deprecated. Gets the configuration of this object.
  1. java.util.Enumeration
getMaskChangeListeners()
Deprecated. Gets the set of objects that wish to be informed of changes in the message or trace mask configuration.
  1. java.util.Enumeration
getMessageEventClasses()
Deprecated. Gets the set of message event classes which this object uses.
  1. long
getMessageMask()
Deprecated. Gets the mask which defines the set of message types that will be processed.
  1. java.util.Enumeration
getTraceEventClasses()
Deprecated. Gets the set of trace event classes which this object uses.
  1. long
getTraceMask()
Deprecated. Gets the mask which defines the set of trace types that will be processed.
  1. 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.
  1. void
removeMessageEventClass(java.lang.String name)
Deprecated. Removes the name of a message event class from the list of classes which this object uses.
  1. void
removeTraceEventClass(java.lang.String name)
Deprecated. Removes the name of a trace event class from the list of classes which this object uses.
  1. void
setConfig(java.util.Hashtable ht)
Deprecated. Sets the configuration of this object.
  1. void
setMessageMask(long mask)
Deprecated. Sets the mask which defines the set of message types that will be processed.
  1. 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

  1. 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

  1. 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

  1. 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

  1. 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

  1. 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

  1. 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

  1. 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

  1. 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

  1. 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

  1. 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

  1. 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

  1. 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

  1. 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

  1. 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

  1. 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

  1. 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.