com.ibm.ras
Class RASMaskChangeGenerator
- java.lang.Object
com.ibm.ras.RASObject
com.ibm.ras.RASMaskChangeGenerator
Deprecated. As of WAS 6.0, recommend using java.util.logging
- public class RASMaskChangeGenerator
- extends RASObject
- implements RASIMaskChangeGenerator
RASMaskChangeGenerator
implements the
RASIMaskChangeGenerator
interface.
It is responsible for controlling the message and trace masks and for
informing RASIMaskChangeListener
that
a change has occurred in the object's message or trace mask.
RASMaskChangeGenerator
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 class provides common function to loggers and handlers and
is not intended to be instantiated directly. The
RASLogger
and Handler classes extend this class.
Field Summary
Constructor Summary
Constructor and Description |
---|
RASMaskChangeGenerator()
Deprecated. Creates a
RASMaskChangeGenerator .
|
RASMaskChangeGenerator(java.lang.String name)
Deprecated. Creates a
RASMaskChangeGenerator .
|
RASMaskChangeGenerator(java.lang.String name,java.lang.String desc)
Deprecated. Creates a
RASMaskChangeGenerator .
|
Method Summary
Modifier and Type | Method and Description |
---|---|
|
addMaskChangeListener(RASIMaskChangeListener listener)
Deprecated. Adds an object that wishes to be informed of changes in the
message or trace mask configuration.
|
|
addMessageEventClass(java.lang.String name)
Deprecated. Adds the name of a message event class which this object uses.
|
|
addTraceEventClass(java.lang.String name)
Deprecated. Adds the name of a trace event class which this object uses.
|
|
fireMaskChangedEvent(RASMaskChangeEvent mc)
Deprecated. Tells all
RASIMaskChangeListeners that the message or
trace mask has been changed.
|
|
getConfig()
Deprecated. Gets the configuration of this object.
|
|
getMaskChangeListeners()
Deprecated. Gets the set of objects that wish to be informed of changes in the
message or trace mask configuration.
|
|
getMessageEventClasses()
Deprecated. Gets the set of message event classes which this object uses.
|
|
getMessageMask()
Deprecated. Gets the mask which defines the set of message types that will be
processed.
|
|
getTraceEventClasses()
Deprecated. Gets the set of trace event classes which this object uses.
|
|
getTraceMask()
Deprecated. Gets the mask which defines the set of trace types that will be
processed.
|
|
init()
Deprecated. Initializes this object, setting default values.
|
|
messageMaskLongValue(java.lang.String types)
Deprecated. Gets a composite message mask by asking each of the
registered event classes to convert its known mask strings to a long
value.
|
|
messageMaskToString(long types)
Deprecated. Gets a composite message mask by asking each of the
registered event classes to convert its known mask to a string value.
|
|
removeMaskChangeListener(RASIMaskChangeListener listener)
Deprecated. Removes an object from the list that wishes to be informed of changes
in the message or trace mask configuration.
|
|
removeMessageEventClass(java.lang.String name)
Deprecated. Removes the name of a message event class from the list of
classes which this object uses.
|
|
removeTraceEventClass(java.lang.String name)
Deprecated. Removes the name of a trace event class from the list of
classes which this object uses.
|
|
setConfig(java.util.Hashtable ht)
Deprecated. Sets the configuration of this object.
|
|
setMessageMask(long mask)
Deprecated. Sets the mask which defines the set of message types that will be
processed.
|
|
setTraceMask(long mask)
Deprecated. Sets the mask which defines the set of trace types that will be
processed.
|
|
traceMaskLongValue(java.lang.String types)
Deprecated. Gets a composite trace mask by asking each of the
registered event classes to convert its known mask strings to a long
value.
|
|
traceMaskToString(long types)
Deprecated. Gets a composite trace mask by asking each of the
registered event classes to convert its known mask to a string value.
|
Methods inherited from class com.ibm.ras.RASObject |
---|
clone, getDescription, getGroup, getName, setDescription, setName |
Methods inherited from class java.lang.Object |
---|
equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Methods inherited from interface com.ibm.ras.RASIObject |
---|
getDescription, getGroup, getName, setDescription, setName |
Constructor Detail
RASMaskChangeGenerator
- public RASMaskChangeGenerator()
RASMaskChangeGenerator
- public RASMaskChangeGenerator(java.lang.String name)
RASMaskChangeGenerator
. The description of this object
is an empty string.
name
- The name of this object. RASMaskChangeGenerator
- public RASMaskChangeGenerator(java.lang.String name,
- java.lang.String desc)
RASMaskChangeGenerator
.
name
- The name of this object. desc
- The description of this object. Method Detail
init
- protected void init()
getConfig
- public java.util.Hashtable getConfig( )
getConfig
in interface RASIMaskChangeGenerator
getConfig
in interface RASIObject
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
.
The parent and extensions of this object may use additional keys.
setConfig
- public void setConfig(java.util.Hashtable ht)
RASManager
to initialize a RAS object.
It should not be necessary for an application to use this method.
setConfig
in interface RASIMaskChangeGenerator
setConfig
in interface RASIObject
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.
The parent and extensions of this object may use additional keys.
getMessageMask
- public long getMessageMask()
RASIMessageEvent
TYPE_XXXX
constants.
getMessageMask
in interface RASIMaskChangeGenerator
setMessageMask
- public void setMessageMask(long mask)
RASIMessageEvent
TYPE_XXXX
constants.
The mask value is not validated against these types.
setMessageMask
in interface RASIMaskChangeGenerator
mask
- The message mask. getTraceMask
- public long getTraceMask()
RASITraceEvent
TYPE_XXXX
constants.
getTraceMask
in interface RASIMaskChangeGenerator
setTraceMask
- public void setTraceMask(long mask)
RASITraceEvent
TYPE_XXXX
constants.
The mask value is not validated against these types.
setTraceMask
in interface RASIMaskChangeGenerator
mask
- The trace mask. addMaskChangeListener
- public void addMaskChangeListener( RASIMaskChangeListener listener)
null
or is already registered, this method does nothing.
addMaskChangeListener
in interface RASIMaskChangeGenerator
listener
- The mask change listener. removeMaskChangeListener
- public void removeMaskChangeListener( RASIMaskChangeListener listener)
null
or is not registered, this method does
nothing.
removeMaskChangeListener
in interface RASIMaskChangeGenerator
listener
- The mask change listener. getMaskChangeListeners
- public java.util.Enumeration getMaskChangeListeners( )
getMaskChangeListeners
in interface RASIMaskChangeGenerator
Enumeration
of mask change listeners. If
no listeners are registered, the Enumeration
is empty. fireMaskChangedEvent
- public void fireMaskChangedEvent( RASMaskChangeEvent mc)
RASIMaskChangeListeners
that the message or
trace mask has been changed.
fireMaskChangedEvent
in interface RASIMaskChangeGenerator
mc
- A mask change event, indicating what has changed. addMessageEventClass
- public void addMessageEventClass( java.lang.String name)
null
or is already
registered, this method does nothing.
addMessageEventClass
in interface RASIMaskChangeGenerator
name
- The event class name. removeMessageEventClass
- public void removeMessageEventClass( java.lang.String name)
null
or is not registered, this method does nothing.
removeMessageEventClass
in interface RASIMaskChangeGenerator
name
- The event class name. getMessageEventClasses
- public java.util.Enumeration getMessageEventClasses( )
getMessageEventClasses
in interface RASIMaskChangeGenerator
Enumeration
of RAS event class names. If
no event classes are registered, the Enumeration
is empty. addTraceEventClass
- public void addTraceEventClass( java.lang.String name)
null
or is already
registered, this method does nothing.
addTraceEventClass
in interface RASIMaskChangeGenerator
name
- The event class name. removeTraceEventClass
- public void removeTraceEventClass( java.lang.String name)
null
or is not registered, this method does nothing.
removeTraceEventClass
in interface RASIMaskChangeGenerator
name
- The event class name. getTraceEventClasses
- public java.util.Enumeration getTraceEventClasses( )
getTraceEventClasses
in interface RASIMaskChangeGenerator
Enumeration
of RAS event class names. If
no event classes are registered, the Enumeration
is empty. messageMaskLongValue
- public long messageMaskLongValue( java.lang.String types)
types
- A blank-delimited list of event types. messageMaskToString
- public java.lang.String messageMaskToString( long types)
types
- A message or trace mask. traceMaskLongValue
- public long traceMaskLongValue( java.lang.String types)
types
- A blank-delimited list of event types. traceMaskToString
- public java.lang.String traceMaskToString( long types)
types
- A message or trace mask.
RASMaskChangeGenerator
. The name and description of this object are empty strings.