com.tivoli.twg.engine
Class TWGManagedObject

java.lang.Object
  extended bycom.tivoli.twg.engine.TWGObject
      extended bycom.tivoli.twg.engine.TWGPersistentObject
          extended bycom.tivoli.twg.engine.TWGManagedObject
All Implemented Interfaces:
TWGBaseShadowedObject, TWGGetSetDescInterface, TWGGetSetInterface, TWGPersistentObjectSubclassRestorable, TWGShadowedObject
Direct Known Subclasses:
ChassisManagedObject, TWGClusterManagedObject, TWGNativeManagedObject, TWGSNMPDevice

public class TWGManagedObject
extends TWGPersistentObject
implements TWGShadowedObject, TWGGetSetDescInterface, TWGPersistentObjectSubclassRestorable

Base class for TWGManagedObj. This is the base class for managed objects. This class encapsolates common attributes of a managed object such as it's name and ID, and associated list containers such as Task, Database Table.


Field Summary
static java.lang.String CLASSNAME
          Our classname
static int CLIENT_SERVICE_NOT_SUPPORTED
          Result code for unsupported service error
static int CLIENT_SERVICE_START_FAILED
          Result code for service start error
static int CLIENT_SERVICE_START_SUCCEEDED
          Result code for successful client service start
static int CLIENT_SERVICE_STOP_FAILED
          Result code for service stop error
static int CLIENT_SERVICE_STOP_SUCCEEDED
          Result code for successful client service stop
protected static int MO_SHADOW_ATTRIB_FLAGS_OFF
           
protected static int MO_SHADOW_CNTTASK_OFF
           
protected static int MO_SHADOW_HDRLEN
           
protected static int MO_SHADOW_HDRLEN_001
           
protected static int MO_SHADOW_HDRLEN_OFF
           
protected static int MO_SHADOW_IMGSET_OFF
           
protected static int MO_SHADOW_OFFNAME_OFF
           
protected static int MO_SHADOW_OFFTASK_OFF
           
protected static int MO_SHADOW_PINGINT_OFF
           
protected static int MO_SHADOW_STATE_OFF
           
static int MOSTATE_ERROR_OFFLINE
           
static int MOSTATE_ERROR_ONLINE
           
static int MOSTATE_INDETERMINATE
           
static int MOSTATE_INVALID_OBJECT
          Object status consants.
static int MOSTATE_NORMAL_OFFLINE
           
static int MOSTATE_NORMAL_ONLINE
           
static int MOSTATE_UNKNOWN
           
static int MOSTATE_UNLICENSED
           
static java.lang.String SHADOWCLASSNAME
           
 
Fields inherited from class com.tivoli.twg.engine.TWGPersistentObject
CLASS_NAME, SIZEOF_BYTE, SIZEOF_CHAR, SIZEOF_DOUBLE, SIZEOF_FLOAT, SIZEOF_INT, SIZEOF_LONG, SIZEOF_SHORT
 
Constructor Summary
TWGManagedObject()
          Constructor for TWGManagedObject.
 
Method Summary
protected  void AddClientService(java.lang.String svcname)
          Add client service to service list
 void addDatabaseRecord()
          Add managed object database table row
 void addTask(long task_oid)
          Add a task to the task list using task object reference.
 void addTask(TWGTask task)
          Add a task to the task list using task object reference.
static void categorizedManagedObjectIDs(LongValueSet mo_ids, java.lang.String[] cls_list, LongValueSet[] mo_sets)
          Categorize managed objects by class
 void clearPingInterval()
          Clear ping interval.
 void ClientServiceStart(java.lang.String svcname, ClientServiceListener cslistener)
          Request client service start : start request is asynchronous, and provided listener will be have its ClientServiceStartCompleted() callback called when the start request is completed (success or failure).
 void ClientServiceStart(java.lang.String svcname, ClientServiceListener cslistener, TWGUser userid)
          Request client service start : start request is asynchronous, and provided listener will be have its ClientServiceStartCompleted() callback called when the start request is completed (success or failure).
 void ClientServiceStop(java.lang.String svcname, ClientServiceListener cslistener)
          Request client service stop : stop request is asynchronous, and provided listener will be have its ClientServiceStopCompleted() callback called when the stop request is completed (success or failure).
 void ClientServiceStop(java.lang.String svcname, ClientServiceListener cslistener, TWGUser userid)
          Request client service stop : stop request is asynchronous, and provided listener will be have its ClientServiceStopCompleted() callback called when the stop request is completed (success or failure).
 boolean containsTask(long taskOid)
          Check if task identifier exists in task list.
 boolean containsTask(TWGTask task)
          Check if task object reference exists in task list.
protected  void copyTo(TWGManagedObject managedObject)
          Copy instance data to another managed object.
 void Delete()
          Object delete - clean up references to existing instance
static void deregisterNewOSListener(com.tivoli.twg.engine.TWGManagedObjectOSListener osl)
          Deregister new OS type listener
 void Destroy()
          Object destroy - clean up persistent data for object
static java.util.List FindByAttributeValue(java.lang.String cname, java.lang.String aid, DataValue match_dv)
          Search for ManagedObjects with matching attribute from get/set object
static java.util.List FindByAttributeValue(java.lang.String cname, java.lang.String aid, java.lang.String match_string)
          Search for ManagedObjects with matching attribute from get/set object
 byte[] getAddressEntryRecord()
          Get address entry record for given managed object
 java.lang.String getAddressEntryShadowClass()
          Get address entry shadow class
 long getAgentPingInterval()
          Get agent ping interrval in milliseconds.
 int getAgentTimezoneOffset()
          Get agent timezone offset
static int[] getAllManagedObjectIDs()
          Get list of all managed object IDs (persistent IDs)
static TWGManagedObject[] getAllManagedObjects()
          Return list of all managed objects
 java.lang.String getAttributeDescription(java.lang.String id, java.util.Locale loc)
          Get description string for given attribute in given locale
 java.lang.String[] getAttributeIDList()
          Attribute ID enumeration : this method is expected to return a List of strings containing the String names of the attributes supported for a given object.
 int getAttributeType(java.lang.String id)
          Get type of attribute value for given attribute
 DataValue getAttributeValue(java.lang.String id, java.util.Locale loc)
          Get value of attribute with given ID
 java.lang.String getAttributeValueString(java.lang.String id, java.util.Locale loc)
          Get descriptive value string for given attribute in given locale
 java.lang.String[] GetClientServices()
          Request list of client services supported by given client.
 java.lang.String GetConShadowClass()
          Get name of console shadow class.
 StringValueSet getDatabaseList()
          Return the database table list.
 long getEventCorrelator()
          Get event correlator.
 com.tivoli.twg.engine.TWGManagedObjectFingerprint getFingerprint()
          Get fingerprint.
 int getImageSet()
          Get image set.
 int getLicenseVersionRequired(int prod_id)
          License version required for this MO instance : default is -1 if no license required, or License.getPrimaryServerLicenseVersion() if license required for License.PRIMARY_PRODUCT_ID.
static TWGManagedObject getManagedObjectByID(int oid)
          Get managed object by persistent object ID
static TWGManagedObject[] getManagedObjectsSupportingClientService(java.lang.String svcname)
          Return list of all managed objects supporting given client service
 TWGManagedObjectFactory getMof()
          Get managed object factory reference for this managed object.
 java.lang.String getName()
          Get object name.
 int getOEMID()
          Get OEM ID
 com.tivoli.twg.engine.TWGPing getPinger()
          Get "pinger" instance.
 long getPingInterval()
          Get ping interrval in milliseconds.
 long getPingInterval(boolean traverseParent)
          Get ping interrval in milliseconds.
 int getPingType()
          Get ping type supported.
 byte[] GetShadowRecord(java.util.Locale locale)
          Get buffer containing current values of the shadowed attributes to be delivered to the console shadow class.
 long GetShadowVersion()
          Get object state version.
 int getState()
          Get state of managed object.
 IntValueSet getTaskListAsIds()
          Get managed object's task list a value set object identifiers.
 int getTaskListSize()
          Get size of task list.
static boolean initializeRestoredLicenses()
          Initialize licenses for restored clients
static void initializeRestoredStatusGroups()
          Initialize standard status settings for restored clients
static void ipAddressChangeNotify(TWGManagedObject mo, java.lang.String[] oldAddressSet, java.lang.String[] newAddressSet)
          Send notifications of a TWGManagedObject IP address change to all listeners.
 boolean isAccessDenied()
          Test if managed object 'access denied' flag is set
 boolean isAccessRequestSupported()
          Test if managed object 'access request supported' flag is set
 boolean isAttribFlagSet(int attrib_mask)
          Test if attribute flags is set
 boolean isClientSecureSupported()
          Test if client secure/unsecure is supported
 boolean IsClientServiceSupported(java.lang.String svcname)
          Test for support for a given client service
 boolean isClientUnsecure()
          Test if client is currently unsecure
 boolean isConsoleDeletable()
          Test if managed object is console deletable
 boolean isConsoleRenamable()
          Test if managed object is console renameable
 boolean isEncryptionEnabled()
          Test if managed object 'encryption enabled' flag is set
 boolean isPowerdownSupported()
          Test if managed object 'powerdown supported' flag is set
 boolean isRestartSupported()
          Test if managed object 'restart supported' flag is set
 boolean isServerMO()
          Test if managed object 'itd server' flag is set
 boolean isShutdownSupported()
          Test if managed object 'shutdown supported' flag is set
 boolean isTMADetectable()
          Test if managed object 'tma detectable' flag is set
 boolean isTMADetected()
          Test if managed object 'tma detected' flag is set
 boolean isWakeOnLANSupported()
          Test if managed object 'wake-on-lan supported' flag is set
 boolean licenseGranted()
          Test if client has been granted license(s)
 boolean licenseRequired()
          Test if client requires license(s)
 void ObjectAddressEntryChangeNotify()
          Send notifications of a TWGManagedObject address entry change to all listeners
 void ObjectChangedNotify(int reason_code)
          Send notifications of a TWGManagedObject change to all listeners
 void ObjectCreateNotify()
          Send notifications of a TWGManagedObject create to all listeners
 void ObjectDestroyNotify()
          Send notifications of a TWGManagedObject delete to all listeners
 void ObjectStateChangeNotify(int old_state, int new_state)
          Send notifications of a TWGManagedObject state change to all listeners
 boolean processGrantRevokeLicense(boolean is_grant)
          Process request for grant or revoke of license(s).
static void registerClientServiceSubscriber(java.lang.String svc, TWGClientServiceListener listener)
          Add subscription to given client service
static void registerIPAddressChangeListener(com.tivoli.twg.engine.TWGManagedObjectIPAddressChangeListener listener)
          Register listener for TWGManagedObject IP address add/delete events
static void RegisterLifeCycleListener(TWGManagedObjectLifeCycleListener listener)
          Register listener for TWGManagedObject create/delete/modify events
static void registerNewOSListener(com.tivoli.twg.engine.TWGManagedObjectOSListener osl)
          Register new OS type listener
static void RegisterStateListener(TWGManagedObjectStateListener listener)
          Register listener for TWGManagedObject state changes
 void reissueLicenses()
          Reissue licenses for object, if needed
static void removeAllTaskAssociations(long task_oid)
          Remove a task from all task lists including the MOFs.
static void removeAllTaskAssociations(TWGTask task)
          Remove a task from all task lists including the MOFs.
protected  void RemoveClientService(java.lang.String svcname)
          Remove client service from service list
 void removeTask(long task_oid)
          Remove a task from the task list.
 void removeTask(TWGTask task)
          Remove a task from the task list.
protected  boolean ReplaceClientServiceList(StringValueSet svcnames)
          Replace client service list
protected  void reportOSTypeAndVersion(java.lang.String os, int os_major, int os_minor)
          Report OS type, major, and minor version : used for on-demand OS-based group creation
 void requestAccess(java.lang.String uid, java.lang.String pwd, java.lang.Object req_id_obj, TWGManagedObjectActionListener result_listener)
          Request access request of managed object : this method should be subclassed by managed object implementations which support access request
 int requestClientSecure(TWGSecureRequestListener listen, boolean do_unsecure)
          Request client secure/unsecure : notify result through listener provided
 void requestPowerdown(java.lang.Object req_id_obj, TWGManagedObjectActionListener result_listener)
          Request powerdown of managed object : this method should be subclassed by managed object implementations which support powerdown
 void requestRestart(java.lang.Object req_id_obj, TWGManagedObjectActionListener result_listener)
          Request restart of managed object : this method should be subclassed by managed object implementations which support restart
 void requestShutdown(java.lang.Object req_id_obj, TWGManagedObjectActionListener result_listener)
          Request shutdown of managed object : this method should be subclassed by managed object implementations which support shutdown
 void requestWakeOnLAN(java.lang.Object req_id_obj, TWGManagedObjectActionListener result_listener)
          Request wake-up of managed object : this method should be subclassed by managed object implementations which support wake-on-LAN
protected  void restoreData(TWGPersistentObjectDictionary dictionary, boolean resolveObjectReferences)
          Restore support for persistant object.
 void saveAndUpdateIfNeeded()
          request persistent and active console shadow function.
protected  void saveData(TWGPersistentObjectDictionary dictionary)
          Save support for persistant object.
 void setAccessDenied(boolean flg)
          Set managed object 'access denied' flag
 void setAccessRequestSupported(boolean flg)
          Set managed object 'access request supported' flag
 void setAgentPingInterval(long intr)
          Set agent ping interval, in milliseconds.
 void setAgentTimezoneOffset(int tz_off)
          Set agent timezone offset (GMT+minutes).
 void setAsServerMO(boolean flg)
          Set managed object 'itd server' flag
 boolean setAttributeValue(java.lang.String id, DataValue val)
          Set value of attribute with given ID
protected  void setClientSecureSupported(boolean supported)
          Set client client secure/unsecure support : used by subclasses
protected  void setClientUnsecureFlag(boolean is_unsec)
          Set client unsecure state : used by subclasses
 void setConsoleDeletable(boolean flg)
          Set managed object 'console deletable' flag
 void setConsoleRenamable(boolean flg)
          Set managed object 'console renamable' flag
 void setEncryptionEnabled(boolean flg)
          Set managed object 'encryption enabled' flag
 void setEventCorrelator(long correlator)
          Set event correlator.
 void setImageSet(int oid)
          Set image set.
 void setName(java.lang.String name)
          Set object name.
 void SetObjectID(long oid)
          Set object ID.
protected  void setOEMID(int oem)
          Set OEM ID : need to issue save() for persistent update
 void setPinger(com.tivoli.twg.engine.TWGPing pinger)
          Set "pinger" instance.
 void setPingInterval(long intr)
          Set ping interval, in milliseconds.
 void setPowerdownSupported(boolean flg)
          Set managed object 'powerdown supported' flag
 void setRestartSupported(boolean flg)
          Set managed object 'restart supported' flag
 void setShutdownSupported(boolean flg)
          Set managed object 'shutdown supported' flag
 void setState(int new_state)
          Set state of managed object.
 void setTMADetectable(boolean flg)
          Set managed object 'tma detectable' flag
 void setTMADetected(boolean flg)
          Set managed object 'tma detected' flag
 void setWakeOnLANSupported(boolean flg)
          Set managed object 'wake-on-lan supported' flag
 boolean startPing()
          Default ping method for managed object.
static boolean startPing(TWGManagedObject mo)
          Instigate a "ping" sequence for the given managed object instance.
static boolean startPing(TWGManagedObject mo, boolean reauth)
          Instigate a "ping" sequence for the given managed object instance.
 boolean startPingWithReauthenticate()
          Default ping with reauthenticate method for managed object.
static void synchronizedObjectWithDatabase()
          Synch database with managed objects : used during initialization to confirm existance of managed objects with state of database.
 java.lang.String toString()
          Returns a string representation of the object.
static void unregisterClientServiceSubscriber(java.lang.String svc, TWGClientServiceListener listener)
          Remove subscription to given client service
static void unregisterIPAddressChangeListener(com.tivoli.twg.engine.TWGManagedObjectIPAddressChangeListener listener)
          Unregister listener for TWGManagedObject IP address add/delete events
static void UnregisterLifeCycleListener(TWGManagedObjectLifeCycleListener listener)
          Unregister listener for TWGManagedObject create/delete/modify events
static void UnregisterStateListener(TWGManagedObjectStateListener listener)
          Unregister listener for TWGManagedObject state changes
 void updateNameInDatabaseRecord()
          Update name of managed object in database
 void UpdateShadowVersion()
          Update object state version.
 void updateStateInDatabaseRecord()
          Update state of managed object in database
 
Methods inherited from class com.tivoli.twg.engine.TWGPersistentObject
enableAsyncWrites, fromPersistID, initialize, isNewPersistentStore, isSaveRequired, PersistID, restore, restoreAll, save, save, setSaveRequired, terminate, toPersistID
 
Methods inherited from class com.tivoli.twg.engine.TWGObject
AllObjects, AllObjects, DumpTWGObjects, FindObject, isDeleted, isNewObject, isPersistent, isPersistent, isValid, isValid, ObjectID, setDistinctObjectID
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Field Detail

CLASSNAME

public static final java.lang.String CLASSNAME
Our classname

See Also:
Constant Field Values

SHADOWCLASSNAME

public static final java.lang.String SHADOWCLASSNAME
See Also:
Constant Field Values

MO_SHADOW_HDRLEN_001

protected static final int MO_SHADOW_HDRLEN_001
See Also:
Constant Field Values

MO_SHADOW_HDRLEN

protected static final int MO_SHADOW_HDRLEN
See Also:
Constant Field Values

MO_SHADOW_HDRLEN_OFF

protected static final int MO_SHADOW_HDRLEN_OFF
See Also:
Constant Field Values

MO_SHADOW_OFFNAME_OFF

protected static final int MO_SHADOW_OFFNAME_OFF
See Also:
Constant Field Values

MO_SHADOW_OFFTASK_OFF

protected static final int MO_SHADOW_OFFTASK_OFF
See Also:
Constant Field Values

MO_SHADOW_CNTTASK_OFF

protected static final int MO_SHADOW_CNTTASK_OFF
See Also:
Constant Field Values

MO_SHADOW_STATE_OFF

protected static final int MO_SHADOW_STATE_OFF
See Also:
Constant Field Values

MO_SHADOW_IMGSET_OFF

protected static final int MO_SHADOW_IMGSET_OFF
See Also:
Constant Field Values

MO_SHADOW_ATTRIB_FLAGS_OFF

protected static final int MO_SHADOW_ATTRIB_FLAGS_OFF
See Also:
Constant Field Values

MO_SHADOW_PINGINT_OFF

protected static final int MO_SHADOW_PINGINT_OFF
See Also:
Constant Field Values

MOSTATE_INVALID_OBJECT

public static final int MOSTATE_INVALID_OBJECT
Object status consants. The constants below indicate the current state of the managed object instance.

See Also:
Constant Field Values

MOSTATE_UNKNOWN

public static final int MOSTATE_UNKNOWN
See Also:
Constant Field Values

MOSTATE_INDETERMINATE

public static final int MOSTATE_INDETERMINATE
See Also:
Constant Field Values

MOSTATE_ERROR_OFFLINE

public static final int MOSTATE_ERROR_OFFLINE
See Also:
Constant Field Values

MOSTATE_NORMAL_OFFLINE

public static final int MOSTATE_NORMAL_OFFLINE
See Also:
Constant Field Values

MOSTATE_ERROR_ONLINE

public static final int MOSTATE_ERROR_ONLINE
See Also:
Constant Field Values

MOSTATE_NORMAL_ONLINE

public static final int MOSTATE_NORMAL_ONLINE
See Also:
Constant Field Values

MOSTATE_UNLICENSED

public static final int MOSTATE_UNLICENSED
See Also:
Constant Field Values

CLIENT_SERVICE_START_SUCCEEDED

public static final int CLIENT_SERVICE_START_SUCCEEDED
Result code for successful client service start

See Also:
Constant Field Values

CLIENT_SERVICE_STOP_SUCCEEDED

public static final int CLIENT_SERVICE_STOP_SUCCEEDED
Result code for successful client service stop

See Also:
Constant Field Values

CLIENT_SERVICE_NOT_SUPPORTED

public static final int CLIENT_SERVICE_NOT_SUPPORTED
Result code for unsupported service error

See Also:
Constant Field Values

CLIENT_SERVICE_START_FAILED

public static final int CLIENT_SERVICE_START_FAILED
Result code for service start error

See Also:
Constant Field Values

CLIENT_SERVICE_STOP_FAILED

public static final int CLIENT_SERVICE_STOP_FAILED
Result code for service stop error

See Also:
Constant Field Values
Constructor Detail

TWGManagedObject

public TWGManagedObject()
Constructor for TWGManagedObject. This constructor performs base class initialization. Vector characteristics are established here.

Method Detail

toString

public java.lang.String toString()
Returns a string representation of the object.

See Also:
Object.toString()

copyTo

protected void copyTo(TWGManagedObject managedObject)
Copy instance data to another managed object.

Parameters:
managedObject - target managed object.

saveData

protected void saveData(TWGPersistentObjectDictionary dictionary)
                 throws TWGPersistentObjectSaveException
Save support for persistant object. This method saves all managed object fields that are persistant in nature.

Overrides:
saveData in class TWGPersistentObject
Throws:
TWGPersistentObjectSaveException - if error on save

restoreData

protected void restoreData(TWGPersistentObjectDictionary dictionary,
                           boolean resolveObjectReferences)
                    throws TWGPersistentObjectRestoreException
Restore support for persistant object. This method restores managed object fields that are persistant in nature.

Overrides:
restoreData in class TWGPersistentObject
Parameters:
resolveObjectReferences - used to indicate if object references should be resolved during restore.
Throws:
TWGPersistentObjectRestoreException - if restore error

SetObjectID

public void SetObjectID(long oid)
                 throws DuplicateObjectIDException
Set object ID. This method subclasses the TWGObject class's SetObjectID. This call is needed so that Managed object class instances can be registered with the appropriate TreeNode instances within the ManagedObjectFactory.

Overrides:
SetObjectID in class TWGObject
Parameters:
oid - - new object ID, or INVALID_OBJECT_ID if none
Throws:
DuplicateObjectIDException - if ID is duplicate

Destroy

public void Destroy()
             throws TWGObjectDestroyException
Object destroy - clean up persistent data for object

Overrides:
Destroy in class TWGPersistentObject
Throws:
TWGObjectDestroyException - if error during destroy

Delete

public void Delete()
Object delete - clean up references to existing instance

Overrides:
Delete in class TWGObject

setName

public void setName(java.lang.String name)
Set object name.

Parameters:
name - Name of this object.

getName

public java.lang.String getName()
Get object name.


getTaskListAsIds

public IntValueSet getTaskListAsIds()
Get managed object's task list a value set object identifiers.

Returns:
IntValueSet containing list of task object identifiers. The set may be returned with no entries (empty).

addTask

public void addTask(TWGTask task)
Add a task to the task list using task object reference.

Parameters:
task - Task object reference to be added to the task list.

addTask

public void addTask(long task_oid)
Add a task to the task list using task object reference.

Parameters:
task_oid - - task object ID to be added

removeTask

public void removeTask(TWGTask task)
Remove a task from the task list.

Parameters:
task - Task object reference to be removed.

removeTask

public void removeTask(long task_oid)
Remove a task from the task list.

Parameters:
task_oid - - object identity of task

removeAllTaskAssociations

public static void removeAllTaskAssociations(TWGTask task)
Remove a task from all task lists including the MOFs.

Parameters:
task - Task object reference to be removed

removeAllTaskAssociations

public static void removeAllTaskAssociations(long task_oid)
Remove a task from all task lists including the MOFs.

Parameters:
task_oid - - object identity of task

getTaskListSize

public int getTaskListSize()
Get size of task list.

Returns:
Total number of tasks associated with the managed object.

containsTask

public boolean containsTask(long taskOid)
Check if task identifier exists in task list.

Parameters:
taskOid - Task object ID to search for existance.
Returns:
TRUE: Task identifier was found in task list. FALSE: Task identifier was not found in task list.

containsTask

public boolean containsTask(TWGTask task)
Check if task object reference exists in task list.

Parameters:
task - Task object to search for existance.
Returns:
TRUE: Task object was found in task list. FALSE: Task object was not found in task list.

setState

public void setState(int new_state)
Set state of managed object.

Parameters:
new_state - New state of managed object. See "MOSTATE_xxx" constant declarations for valid states. Parameter not verified.

getState

public final int getState()
Get state of managed object.

Returns:
Current state of managed object.

UpdateShadowVersion

public void UpdateShadowVersion()
Update object state version. This method must call the TWGActiveConsole.nextShadowVersion() to update its internal state_version attribute (a 'long' instance variable). This method should be called by any methods of the object's class or subclasses which modify attributes which are send to the shadow objects on the console).

Specified by:
UpdateShadowVersion in interface TWGBaseShadowedObject

GetShadowVersion

public long GetShadowVersion()
Get object state version. This returns value of state_version.

Specified by:
GetShadowVersion in interface TWGBaseShadowedObject
Returns:
state_version attribute value

GetConShadowClass

public java.lang.String GetConShadowClass()
Get name of console shadow class. This returns the name of TWGConObject subclass which is used to hold the attributes shadowed to the console.

Specified by:
GetConShadowClass in interface TWGBaseShadowedObject
Returns:
com.tivoli.twg.engine.TWGConObject subclass which object shadows to

GetShadowRecord

public byte[] GetShadowRecord(java.util.Locale locale)
Get buffer containing current values of the shadowed attributes to be delivered to the console shadow class. This data is delivered along with the ObjectID (so the ObjectID shouldn't be included in the shadowed data record).

Specified by:
GetShadowRecord in interface TWGBaseShadowedObject
Parameters:
locale - - Locale of requested data
Returns:
byte array containing opaque data representation of attribute values to be delivered to the console shadow class.

setPingInterval

public void setPingInterval(long intr)
Set ping interval, in milliseconds. MOF sub-classes that have a ping type of "TWGPing.PING_TYPE_AGENT_DRIVES_INDIVIDUAL" should overide this method to intercept the ping interval. The overiding method should call this super method at some point in its processing.

Parameters:
intr - - new interval, in milliseconds

clearPingInterval

public void clearPingInterval()
Clear ping interval. This methods clears the ping interval in the instance causing the parent's ping interval to be used.


getPingInterval

public long getPingInterval()
Get ping interrval in milliseconds. This call will traverse the parent class chain and return the first non-deferred value.

Returns:
Interval, in milliseconds.

getPingInterval

public long getPingInterval(boolean traverseParent)
Get ping interrval in milliseconds.

Parameters:
traverseParent - TRUE: class chain will be traversed until a non-deferred ping interval is found. FALSE: Parent chain is not traversed. Instance ping interval is returned.
Returns:
Interval, in milliseconds.

setAgentPingInterval

public void setAgentPingInterval(long intr)
Set agent ping interval, in milliseconds.

Parameters:
intr - - new interval, in milliseconds

getAgentPingInterval

public long getAgentPingInterval()
Get agent ping interrval in milliseconds.

Returns:
Interval, in milliseconds.

getDatabaseList

public StringValueSet getDatabaseList()
Return the database table list.

Returns:
List of data base tables.

startPing

public static boolean startPing(TWGManagedObject mo)
Instigate a "ping" sequence for the given managed object instance. If the ping start failed, change the object's state to unknown.

Parameters:
mo - managed object instance on which to start the ping sequence.
Returns:
TRUE: ping request started. Ping request failed.

startPing

public static boolean startPing(TWGManagedObject mo,
                                boolean reauth)
Instigate a "ping" sequence for the given managed object instance. If the ping start failed, change the object's state to unknown.

Parameters:
mo - managed object instance on which to start the ping sequence.
reauth - whether reauthentication is requested
Returns:
TRUE: ping request started. Ping request failed.

startPing

public boolean startPing()
Default ping method for managed object.

Returns:
TRUE: Ping function supported. FALSE: Function not supported for this instance.

startPingWithReauthenticate

public boolean startPingWithReauthenticate()
Default ping with reauthenticate method for managed object. If not overridden, just calls managed object's startPing method which may have been overridden.

Returns:
TRUE: Ping function supported. FALSE: Function not supported for this instance.

getEventCorrelator

public long getEventCorrelator()
Get event correlator.

Returns:
long event correlator.

setEventCorrelator

public void setEventCorrelator(long correlator)
Set event correlator.

Parameters:
correlator - new event correlator.

saveAndUpdateIfNeeded

public void saveAndUpdateIfNeeded()
                           throws TWGPersistentObjectSaveException
request persistent and active console shadow function.

Throws:
TWGPersistentObjectSaveException

GetClientServices

public java.lang.String[] GetClientServices()
Request list of client services supported by given client.

Returns:
string list of client service names

IsClientServiceSupported

public boolean IsClientServiceSupported(java.lang.String svcname)
Test for support for a given client service

Parameters:
svcname - - service name to be tested
Returns:
true if supported, false if not

ClientServiceStart

public void ClientServiceStart(java.lang.String svcname,
                               ClientServiceListener cslistener,
                               TWGUser userid)
Request client service start : start request is asynchronous, and provided listener will be have its ClientServiceStartCompleted() callback called when the start request is completed (success or failure). Note: this callback CAN (but typically will not) occur before the StartClientService() method returns, and will often be called by a different thread. The default version simply indicates success if the service is supported, and failure if it is not supported. TWGManagedObject subclasses which support true client service activation (actually have to "act" in order to activate a service) should replace this method. The default method calls ClientServiceStart(String, ClientServiceListener) (ignores the user ID).

Parameters:
svcname - - service name
cslistener - - ClientServiceListener for service complete
userid - - user ID of requester (null if none)
Since:
Director V3.1

ClientServiceStart

public void ClientServiceStart(java.lang.String svcname,
                               ClientServiceListener cslistener)
Request client service start : start request is asynchronous, and provided listener will be have its ClientServiceStartCompleted() callback called when the start request is completed (success or failure). Note: this callback CAN (but typically will not) occur before the StartClientService() method returns, and will often be called by a different thread. The default version simply indicates success if the service is supported, and failure if it is not supported. TWGManagedObject subclasses which support true client service activation (actually have to "act" in order to activate a service) should replace this method.

Parameters:
svcname - - service name
cslistener - - ClientServiceListener for service complete

ClientServiceStop

public void ClientServiceStop(java.lang.String svcname,
                              ClientServiceListener cslistener,
                              TWGUser userid)
Request client service stop : stop request is asynchronous, and provided listener will be have its ClientServiceStopCompleted() callback called when the stop request is completed (success or failure). Note: this callback CAN (but typically will not) occur before the StopClientService() method returns, and will often be called by a different thread. The default version simply indicates success if the service is supported, and failure if it is not supported. TWGManagedObject subclasses which support true client service activation (actually have to "act" in order to activate/deactivate a service) should replace this method. The default method calls ClientServiceStop(String, ClientServiceListener) (ignores the user ID).

Parameters:
svcname - - service name
cslistener - - ClientServiceListener for service complete
userid - - user ID of requester (null if none)
Since:
Director V3.1

ClientServiceStop

public void ClientServiceStop(java.lang.String svcname,
                              ClientServiceListener cslistener)
Request client service stop : stop request is asynchronous, and provided listener will be have its ClientServiceStopCompleted() callback called when the stop request is completed (success or failure). Note: this callback CAN (but typically will not) occur before the StopClientService() method returns, and will often be called by a different thread. The default version simply indicates success if the service is supported, and failure if it is not supported. TWGManagedObject subclasses which support true client service activation (actually have to "act" in order to activate/deactivate a service) should replace this method.

Parameters:
svcname - - service name
cslistener - - ClientServiceListener for service complete

AddClientService

protected void AddClientService(java.lang.String svcname)
Add client service to service list

Parameters:
svcname - - service name to be added

RemoveClientService

protected void RemoveClientService(java.lang.String svcname)
Remove client service from service list

Parameters:
svcname - - service name to be removed

ReplaceClientServiceList

protected boolean ReplaceClientServiceList(StringValueSet svcnames)
Replace client service list

Parameters:
svcnames - - new set of service names
Returns:
true if value changed, false if no change

setImageSet

public void setImageSet(int oid)
Set image set.


getImageSet

public int getImageSet()
Get image set.

Returns:
image object ID.

setAgentTimezoneOffset

public void setAgentTimezoneOffset(int tz_off)
Set agent timezone offset (GMT+minutes).

Parameters:
tz_off - - agent's timezone offset (GMT+minutes)

getAgentTimezoneOffset

public int getAgentTimezoneOffset()
Get agent timezone offset

Returns:
agent timezone offset (GMT+minutes), TWGManagedObjectConstants.AGENT_TIMEZONE_OFF_UNKNOWN if unknown

RegisterStateListener

public static void RegisterStateListener(TWGManagedObjectStateListener listener)
Register listener for TWGManagedObject state changes

Parameters:
listener - - TWGManagedObjectStateListener to be registered

UnregisterStateListener

public static void UnregisterStateListener(TWGManagedObjectStateListener listener)
Unregister listener for TWGManagedObject state changes

Parameters:
listener - - TWGManagedObjectStateListener to be unregistered

RegisterLifeCycleListener

public static void RegisterLifeCycleListener(TWGManagedObjectLifeCycleListener listener)
Register listener for TWGManagedObject create/delete/modify events

Parameters:
listener - - TWGManagedObjectLifeCycleListener to be registered

UnregisterLifeCycleListener

public static void UnregisterLifeCycleListener(TWGManagedObjectLifeCycleListener listener)
Unregister listener for TWGManagedObject create/delete/modify events

Parameters:
listener - - TWGManagedObjectLifeCycleListener to be unregistered

registerIPAddressChangeListener

public static void registerIPAddressChangeListener(com.tivoli.twg.engine.TWGManagedObjectIPAddressChangeListener listener)
Register listener for TWGManagedObject IP address add/delete events

Parameters:
listener - - TWGManagedObjectIPAddressChangeListener to be registered

unregisterIPAddressChangeListener

public static void unregisterIPAddressChangeListener(com.tivoli.twg.engine.TWGManagedObjectIPAddressChangeListener listener)
Unregister listener for TWGManagedObject IP address add/delete events

Parameters:
listener - - TWGManagedObjectIPAddressChangeListener to be unregistered

ipAddressChangeNotify

public static void ipAddressChangeNotify(TWGManagedObject mo,
                                         java.lang.String[] oldAddressSet,
                                         java.lang.String[] newAddressSet)
Send notifications of a TWGManagedObject IP address change to all listeners.


ObjectCreateNotify

public void ObjectCreateNotify()
Send notifications of a TWGManagedObject create to all listeners


ObjectDestroyNotify

public void ObjectDestroyNotify()
Send notifications of a TWGManagedObject delete to all listeners


ObjectChangedNotify

public void ObjectChangedNotify(int reason_code)
Send notifications of a TWGManagedObject change to all listeners

Parameters:
reason_code - - change reason code

ObjectStateChangeNotify

public void ObjectStateChangeNotify(int old_state,
                                    int new_state)
Send notifications of a TWGManagedObject state change to all listeners

Parameters:
old_state - - previous state value
new_state - - new state value

ObjectAddressEntryChangeNotify

public void ObjectAddressEntryChangeNotify()
Send notifications of a TWGManagedObject address entry change to all listeners


getAddressEntryRecord

public byte[] getAddressEntryRecord()
Get address entry record for given managed object

Returns:
byte array containing address entry record, or null (unsupport)

getAddressEntryShadowClass

public java.lang.String getAddressEntryShadowClass()
Get address entry shadow class

Returns:
name of address entry shadow class (or null if unsupported)

getAllManagedObjectIDs

public static int[] getAllManagedObjectIDs()
Get list of all managed object IDs (persistent IDs)

Returns:
list of managed object IDs (persistent IDs)

getAttributeIDList

public java.lang.String[] getAttributeIDList()
Attribute ID enumeration : this method is expected to return a List of strings containing the String names of the attributes supported for a given object. Subclasses of base classes implementing the interface should report additional attributes by adding them to the list returned by the base class.

Specified by:
getAttributeIDList in interface TWGGetSetInterface

getAttributeValue

public DataValue getAttributeValue(java.lang.String id,
                                   java.util.Locale loc)
Get value of attribute with given ID

Specified by:
getAttributeValue in interface TWGGetSetInterface
Parameters:
id - - attribute ID requested
loc - - locale to use for value, if applicable
Returns:
value object, or null if no value

setAttributeValue

public boolean setAttributeValue(java.lang.String id,
                                 DataValue val)
Set value of attribute with given ID

Specified by:
setAttributeValue in interface TWGGetSetInterface
Parameters:
id - - attribute ID to be set
val - - attribute value to be set
Returns:
true if set successful, false if not successful

getAttributeType

public int getAttributeType(java.lang.String id)
Get type of attribute value for given attribute

Specified by:
getAttributeType in interface TWGGetSetInterface
Parameters:
id - - attribute ID
Returns:
DataValue type of attribute, or DataValue.NONE_TYPE if undefined

getAttributeDescription

public java.lang.String getAttributeDescription(java.lang.String id,
                                                java.util.Locale loc)
Get description string for given attribute in given locale

Specified by:
getAttributeDescription in interface TWGGetSetDescInterface
Parameters:
id - - attribute ID
loc - - locale to use for description
Returns:
description string, or null if not available

getAttributeValueString

public java.lang.String getAttributeValueString(java.lang.String id,
                                                java.util.Locale loc)
Get descriptive value string for given attribute in given locale

Specified by:
getAttributeValueString in interface TWGGetSetDescInterface
Parameters:
id - - attribute ID
loc - - locale to use for description
Returns:
descriptive string for attribute value, or null if not available

getManagedObjectByID

public static TWGManagedObject getManagedObjectByID(int oid)
Get managed object by persistent object ID

Parameters:
oid - - persistent object ID
Returns:
managed object, or null if not found

getFingerprint

public com.tivoli.twg.engine.TWGManagedObjectFingerprint getFingerprint()
Get fingerprint. Subclasses should override this method and return a TWGManagedObjectFingerprint object to identify this managed object instance.

Returns:
TWGManagedObjectFingerprint fingerprint of mananged object

getPinger

public com.tivoli.twg.engine.TWGPing getPinger()
Get "pinger" instance.

Returns:
TWGPing instance.

setPinger

public void setPinger(com.tivoli.twg.engine.TWGPing pinger)
Set "pinger" instance.

Parameters:
pinger - TWGPing instance.

getMof

public TWGManagedObjectFactory getMof()
Get managed object factory reference for this managed object. The actual mof reference is held in an instance variable for the managed object. This getter method should be used so that the "mof" reference variable is lazy initialized. This variable must be lazy initialized because of persistent restore bahavior.

Returns:
reference to managed object factory instance. Null is returned if the managed object factory is not found.

getPingType

public int getPingType()
Get ping type supported.

Returns:
Pingtype supported by MOF instance. See TWGPing class documentation. TWGPing.PING_TYPE_NOT_SUPPORTED TWGPing.PING_TYPE_SERVER_DRIVES_INDIVIDUAL TWGPing.PING_TYPE_AGENT_DRIVES_INDIVIDUAL

isConsoleDeletable

public boolean isConsoleDeletable()
Test if managed object is console deletable

Returns:
true if console deletable

setConsoleDeletable

public void setConsoleDeletable(boolean flg)
Set managed object 'console deletable' flag

Parameters:
flg - - new value, true if enabling

isConsoleRenamable

public boolean isConsoleRenamable()
Test if managed object is console renameable

Returns:
true if console renameable

setConsoleRenamable

public void setConsoleRenamable(boolean flg)
Set managed object 'console renamable' flag

Parameters:
flg - - new value, true if enabling

categorizedManagedObjectIDs

public static void categorizedManagedObjectIDs(LongValueSet mo_ids,
                                               java.lang.String[] cls_list,
                                               LongValueSet[] mo_sets)
Categorize managed objects by class

Parameters:
mo_ids - - set of managed object IDs (input), managed object IDs which were not categorized (output)
cls_list - - class list to be categorized around
mo_sets - - managed object sets containing IDs which matched corresponding cls_list entry (output)

getAllManagedObjects

public static TWGManagedObject[] getAllManagedObjects()
Return list of all managed objects

Returns:
array of managed object references

setShutdownSupported

public void setShutdownSupported(boolean flg)
Set managed object 'shutdown supported' flag

Parameters:
flg - - new value, true if enabling

isShutdownSupported

public boolean isShutdownSupported()
Test if managed object 'shutdown supported' flag is set

Returns:
true if shutdown is supported

setRestartSupported

public void setRestartSupported(boolean flg)
Set managed object 'restart supported' flag

Parameters:
flg - - new value, true if enabling

isRestartSupported

public boolean isRestartSupported()
Test if managed object 'restart supported' flag is set

Returns:
true if restart is supported

setPowerdownSupported

public void setPowerdownSupported(boolean flg)
Set managed object 'powerdown supported' flag

Parameters:
flg - - new value, true if enabling

isPowerdownSupported

public boolean isPowerdownSupported()
Test if managed object 'powerdown supported' flag is set

Returns:
true if powerdown is supported

setWakeOnLANSupported

public void setWakeOnLANSupported(boolean flg)
Set managed object 'wake-on-lan supported' flag

Parameters:
flg - - new value, true if enabling

isWakeOnLANSupported

public boolean isWakeOnLANSupported()
Test if managed object 'wake-on-lan supported' flag is set

Returns:
true if wake-on-lan is supported

setAccessDenied

public void setAccessDenied(boolean flg)
Set managed object 'access denied' flag

Parameters:
flg - - new value, true if enabling

isAccessDenied

public boolean isAccessDenied()
Test if managed object 'access denied' flag is set

Returns:
true if access denied is set

isEncryptionEnabled

public boolean isEncryptionEnabled()
Test if managed object 'encryption enabled' flag is set

Returns:
true if encryption enabled is set

setEncryptionEnabled

public void setEncryptionEnabled(boolean flg)
Set managed object 'encryption enabled' flag

Parameters:
flg - - new value, true if mo has encryption enabled

setAccessRequestSupported

public void setAccessRequestSupported(boolean flg)
Set managed object 'access request supported' flag

Parameters:
flg - - new value, true if enabling

isAccessRequestSupported

public boolean isAccessRequestSupported()
Test if managed object 'access request supported' flag is set

Returns:
true if access request is supported

setTMADetectable

public void setTMADetectable(boolean flg)
Set managed object 'tma detectable' flag

Parameters:
flg - - new value, true if mo supports tma presence check

isTMADetectable

public boolean isTMADetectable()
Test if managed object 'tma detectable' flag is set

Returns:
true if mo supports tma presence check

setTMADetected

public void setTMADetected(boolean flg)
Set managed object 'tma detected' flag

Parameters:
flg - - new value, true if tma found on mo

isTMADetected

public boolean isTMADetected()
Test if managed object 'tma detected' flag is set

Returns:
true if tma found on mo

setAsServerMO

public void setAsServerMO(boolean flg)
Set managed object 'itd server' flag

Parameters:
flg - - new value, true if mo is a server

isServerMO

public boolean isServerMO()
Test if managed object 'itd server' flag is set

Returns:
true if mo is an itd server

isAttribFlagSet

public boolean isAttribFlagSet(int attrib_mask)
Test if attribute flags is set

Parameters:
attrib_mask - - attribute flag mask
Returns:
true if flag is set

requestShutdown

public void requestShutdown(java.lang.Object req_id_obj,
                            TWGManagedObjectActionListener result_listener)
Request shutdown of managed object : this method should be subclassed by managed object implementations which support shutdown

Parameters:
req_id_obj - - arbitrary request ID object (passed back to result listener)
result_listener - - result listener

requestPowerdown

public void requestPowerdown(java.lang.Object req_id_obj,
                             TWGManagedObjectActionListener result_listener)
Request powerdown of managed object : this method should be subclassed by managed object implementations which support powerdown

Parameters:
req_id_obj - - arbitrary request ID object (passed back to result listener)
result_listener - - result listener

requestRestart

public void requestRestart(java.lang.Object req_id_obj,
                           TWGManagedObjectActionListener result_listener)
Request restart of managed object : this method should be subclassed by managed object implementations which support restart

Parameters:
req_id_obj - - arbitrary request ID object (passed back to result listener)
result_listener - - result listener

requestWakeOnLAN

public void requestWakeOnLAN(java.lang.Object req_id_obj,
                             TWGManagedObjectActionListener result_listener)
Request wake-up of managed object : this method should be subclassed by managed object implementations which support wake-on-LAN

Parameters:
req_id_obj - - arbitrary request ID object (passed back to result listener)
result_listener - - result listener

requestAccess

public void requestAccess(java.lang.String uid,
                          java.lang.String pwd,
                          java.lang.Object req_id_obj,
                          TWGManagedObjectActionListener result_listener)
Request access request of managed object : this method should be subclassed by managed object implementations which support access request

Parameters:
uid - - user ID
pwd - - password
req_id_obj - - arbitrary request ID object (passed back to result listener)
result_listener - - result listener

getManagedObjectsSupportingClientService

public static TWGManagedObject[] getManagedObjectsSupportingClientService(java.lang.String svcname)
Return list of all managed objects supporting given client service

Parameters:
svcname - - service name
Returns:
array of managed object references

registerClientServiceSubscriber

public static void registerClientServiceSubscriber(java.lang.String svc,
                                                   TWGClientServiceListener listener)
Add subscription to given client service

Parameters:
svc - - name of client service to listen for
listener - - listener to notify

unregisterClientServiceSubscriber

public static void unregisterClientServiceSubscriber(java.lang.String svc,
                                                     TWGClientServiceListener listener)
Remove subscription to given client service

Parameters:
svc - - name of client service to listen for
listener - - listener to notify

licenseRequired

public final boolean licenseRequired()
Test if client requires license(s)

Returns:
true if one or more required, false if none

licenseGranted

public final boolean licenseGranted()
Test if client has been granted license(s)

Returns:
true if licenses granted, false if not

initializeRestoredLicenses

public static boolean initializeRestoredLicenses()
Initialize licenses for restored clients

Returns:
true if sufficient licenses, false if not

initializeRestoredStatusGroups

public static void initializeRestoredStatusGroups()
Initialize standard status settings for restored clients


processGrantRevokeLicense

public final boolean processGrantRevokeLicense(boolean is_grant)
Process request for grant or revoke of license(s). save() should be called after this method is used successfully.

Parameters:
is_grant - - true if grant, false if revoke
Returns:
true if successful, false if not successful

isClientSecureSupported

public final boolean isClientSecureSupported()
Test if client secure/unsecure is supported

Returns:
true if function supported, false if not

isClientUnsecure

public final boolean isClientUnsecure()
Test if client is currently unsecure

Returns:
true if client unsecure, false if secure or unsupported

setClientSecureSupported

protected void setClientSecureSupported(boolean supported)
Set client client secure/unsecure support : used by subclasses

Parameters:
supported - - true if client secure/unsecure supported, false if not

setClientUnsecureFlag

protected void setClientUnsecureFlag(boolean is_unsec)
Set client unsecure state : used by subclasses

Parameters:
is_unsec - - true if client is secure, false if not secure

requestClientSecure

public int requestClientSecure(TWGSecureRequestListener listen,
                               boolean do_unsecure)
Request client secure/unsecure : notify result through listener provided

Parameters:
listen - - TWGSecureRequestListener to notify with result, null if not interested
do_unsecure - - true if unsecuring client, false if securing
Returns:
result code other than TWGSecureRequestListener.IN_PROGRESS means immediate result (no listener notification), else TWGSecureRequestListener.IN_PROGRESS means result will be listener reported

addDatabaseRecord

public void addDatabaseRecord()
Add managed object database table row


updateNameInDatabaseRecord

public void updateNameInDatabaseRecord()
Update name of managed object in database


updateStateInDatabaseRecord

public void updateStateInDatabaseRecord()
Update state of managed object in database


synchronizedObjectWithDatabase

public static void synchronizedObjectWithDatabase()
                                           throws TWGDbException
Synch database with managed objects : used during initialization to confirm existance of managed objects with state of database.

Throws:
TWGDbException

FindByAttributeValue

public static java.util.List FindByAttributeValue(java.lang.String cname,
                                                  java.lang.String aid,
                                                  java.lang.String match_string)
Search for ManagedObjects with matching attribute from get/set object

Parameters:
cname - - classname
aid - - attribute ID
match_string - - Attribute value
Returns:
true if match

FindByAttributeValue

public static java.util.List FindByAttributeValue(java.lang.String cname,
                                                  java.lang.String aid,
                                                  DataValue match_dv)
Search for ManagedObjects with matching attribute from get/set object

Parameters:
cname - - classname
aid - - attribute ID
match_dv - - List of matching attribute values
Returns:
true if match

getLicenseVersionRequired

public int getLicenseVersionRequired(int prod_id)
License version required for this MO instance : default is -1 if no license required, or License.getPrimaryServerLicenseVersion() if license required for License.PRIMARY_PRODUCT_ID.

Parameters:
prod_id - - product ID to be checked for

reissueLicenses

public void reissueLicenses()
Reissue licenses for object, if needed


getOEMID

public final int getOEMID()
Get OEM ID

Returns:
OEM ID of agent

setOEMID

protected final void setOEMID(int oem)
Set OEM ID : need to issue save() for persistent update

Parameters:
oem - - OEM ID

registerNewOSListener

public static void registerNewOSListener(com.tivoli.twg.engine.TWGManagedObjectOSListener osl)
Register new OS type listener

Parameters:
osl - - OS listener

deregisterNewOSListener

public static void deregisterNewOSListener(com.tivoli.twg.engine.TWGManagedObjectOSListener osl)
Deregister new OS type listener

Parameters:
osl - - OS listener

reportOSTypeAndVersion

protected void reportOSTypeAndVersion(java.lang.String os,
                                      int os_major,
                                      int os_minor)
Report OS type, major, and minor version : used for on-demand OS-based group creation

Parameters:
os - - OS type (@see com.tivoli.twg.engine.TWGManagedObjectConstants.ATTRIB_OS_TYPE)
os_major - - Major version
os_minor - - Minor version