com.tivoli.twg.engine
Class TWGNativeManagedObject

java.lang.Object
  extended bycom.tivoli.twg.engine.TWGObject
      extended bycom.tivoli.twg.engine.TWGPersistentObject
          extended bycom.tivoli.twg.engine.TWGManagedObject
              extended bycom.tivoli.twg.engine.TWGNativeManagedObject
All Implemented Interfaces:
TWGBaseShadowedObject, TWGDistConfigAgentUpdate, TWGGetSetDescInterface, TWGGetSetInterface, TWGPersistentObjectSubclassRestorable, TWGShadowedObject

public class TWGNativeManagedObject
extends TWGManagedObject
implements TWGDistConfigAgentUpdate

Base class for representing Director native clients.


Field Summary
static java.lang.String CLASSNAME
           
static int ITD_V200_VERSION
          Version 2.00 value
 
Fields inherited from class com.tivoli.twg.engine.TWGManagedObject
CLIENT_SERVICE_NOT_SUPPORTED, CLIENT_SERVICE_START_FAILED, CLIENT_SERVICE_START_SUCCEEDED, CLIENT_SERVICE_STOP_FAILED, CLIENT_SERVICE_STOP_SUCCEEDED, MO_SHADOW_ATTRIB_FLAGS_OFF, MO_SHADOW_CNTTASK_OFF, MO_SHADOW_HDRLEN, MO_SHADOW_HDRLEN_001, MO_SHADOW_HDRLEN_OFF, MO_SHADOW_IMGSET_OFF, MO_SHADOW_OFFNAME_OFF, MO_SHADOW_OFFTASK_OFF, MO_SHADOW_PINGINT_OFF, MO_SHADOW_STATE_OFF, MOSTATE_ERROR_OFFLINE, MOSTATE_ERROR_ONLINE, MOSTATE_INDETERMINATE, MOSTATE_INVALID_OBJECT, MOSTATE_NORMAL_OFFLINE, MOSTATE_NORMAL_ONLINE, MOSTATE_UNKNOWN, MOSTATE_UNLICENSED, 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
TWGNativeManagedObject()
          Default constructor for native managed object
 
Method Summary
 void addDatabaseRecord()
          Add managed object database table row
static void AddUpdateSNID(int systag, byte[] snidbuf, int snidoff)
          Update existing SNID record, or add new one
 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).
protected  void copyTo(TWGManagedObject managedObject)
          Copy instance data to another managed object.
 void Delete()
          Destructor for TWGNativeManagedObject: remove object from lists
 void Destroy()
          Destroy for TWGNativeManagedObject: send delete to NetMgr
static void DumpAll()
          Dump info on all objects (debug)
static TWGNativeManagedObject FindByUniqueID(long uid)
          Find native managed object by unique id.
 java.util.Date getAgentDate()
          Get agent date
 java.lang.String getAgentDisplayVersion()
          Get displayable agent version string
 java.lang.String getAgentVersion()
          Get agent version string
 java.lang.String[] getAllMACAddrs()
          Return list of all known MAC addresses for the given object
static int[] GetAllSNIDTags()
          Return all SNID tags
 byte getArchType()
          Get arch_type
 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[] GetAvailablePaths()
          Return all available IPC paths
 java.lang.String getComputerName()
          Get computer name
 int getDesktopImageSet()
          Get desktop image set (may be overridden by subclass)
 com.tivoli.twg.engine.TWGManagedObjectFingerprint getFingerprint()
          Get fingerprint.
 StringValueSet getIPAddressList()
          Return list of TCPIP addresses currently being used by this native MO.
 int getLaptopImageSet()
          Get laptop image set (may be overridden by subclass)
 int getLicenseVersionRequired(int prod_id)
          License version required for this MO instance.
 byte[] getMACAddress()
          Get MAC Address
 java.lang.String GetPerferredPath()
          Get current preferred IPC path from server to client
 java.lang.String getPreferredPath()
          Get current preferred IPC path from server to client
 int getServerImageSet()
          Get server image set (may be overridden by subclass)
static com.tivoli.twg.netipc.SystemNodeItemData GetSNIDByTag(int systag)
          Get SNID by tag
 byte[] getUUID()
          Get UUID
 boolean IsClientServiceSupported(java.lang.String svcname)
          Test for support for a given client service
 void issueConfigRecordSynchronize(TWGDistConfigRecordHashcode[] recs, DistConfigAgentResult rslt)
          Starts synchronize of agent state to match given set of record definitions.
 void requestAccess(java.lang.String uid, java.lang.String pwd, java.lang.Object req_id_obj, TWGManagedObjectActionListener result_listener)
          Request access to 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)
          Method for restoring persistent object data.
protected  void saveData(TWGPersistentObjectDictionary dictionary)
          Method for saving persistent object data.
 void setArchType(byte new_val, boolean no_save)
          Set arch_type
 boolean setAttributeValue(java.lang.String id, DataValue val)
          Set value of attribute with given ID
 void setMACAddress(byte[] new_val, boolean no_save)
          Set MAC Address
 void setPingInterval(long intr)
          f7693 Set Ping Interval
 void SetUniqueID(long uid)
          Set unique ID: removed or add objects to common object list
 void setUUID(byte[] new_val, boolean no_save)
          Set UUID
 boolean startPing()
          Start ping : return true if supported
protected  boolean startPingInternal(boolean reauth)
          Start ping : return true if supported
 boolean startPingWithReauthenticate()
          Start ping with reauthenticate : return true if supported
protected  void startServiceRequest()
          Start service list request for native managed object (normal priority -- FIFO queuing)
protected  void startServiceRequest(boolean highPriority)
          Start service list request for native managed object
static void startServiceRequest(java.lang.String baseService)
          Perform a startServiceRequest() for all online objects that have the specified baseService.
static void synchronizedObjectWithDatabase()
          Synch database with managed objects : used during initialization to confirm existance of managed objects with state of database.
 long UniqueID()
          Return unique ID
protected  void updateAttributes()
          Update attribute flags
static void ValidateSNIDs(int[] systags)
          Validate records using tag list : remove all records which are not in list
 
Methods inherited from class com.tivoli.twg.engine.TWGManagedObject
AddClientService, addTask, addTask, categorizedManagedObjectIDs, clearPingInterval, containsTask, containsTask, deregisterNewOSListener, FindByAttributeValue, FindByAttributeValue, getAddressEntryRecord, getAddressEntryShadowClass, getAgentPingInterval, getAgentTimezoneOffset, getAllManagedObjectIDs, getAllManagedObjects, GetClientServices, GetConShadowClass, getDatabaseList, getEventCorrelator, getImageSet, getManagedObjectByID, getManagedObjectsSupportingClientService, getMof, getName, getOEMID, getPinger, getPingInterval, getPingInterval, getPingType, GetShadowRecord, GetShadowVersion, getState, getTaskListAsIds, getTaskListSize, initializeRestoredLicenses, initializeRestoredStatusGroups, ipAddressChangeNotify, isAccessDenied, isAccessRequestSupported, isAttribFlagSet, isClientSecureSupported, isClientUnsecure, isConsoleDeletable, isConsoleRenamable, isEncryptionEnabled, isPowerdownSupported, isRestartSupported, isServerMO, isShutdownSupported, isTMADetectable, isTMADetected, isWakeOnLANSupported, licenseGranted, licenseRequired, ObjectAddressEntryChangeNotify, ObjectChangedNotify, ObjectCreateNotify, ObjectDestroyNotify, ObjectStateChangeNotify, processGrantRevokeLicense, registerClientServiceSubscriber, registerIPAddressChangeListener, RegisterLifeCycleListener, registerNewOSListener, RegisterStateListener, reissueLicenses, removeAllTaskAssociations, removeAllTaskAssociations, RemoveClientService, removeTask, removeTask, ReplaceClientServiceList, reportOSTypeAndVersion, saveAndUpdateIfNeeded, setAccessDenied, setAccessRequestSupported, setAgentPingInterval, setAgentTimezoneOffset, setAsServerMO, setClientSecureSupported, setClientUnsecureFlag, setConsoleDeletable, setConsoleRenamable, setEncryptionEnabled, setEventCorrelator, setImageSet, setName, SetObjectID, setOEMID, setPinger, setPowerdownSupported, setRestartSupported, setShutdownSupported, setState, setTMADetectable, setTMADetected, setWakeOnLANSupported, startPing, startPing, toStr ing, unregisterClientServiceSubscriber, unregisterIPAddressChangeListener, UnregisterLifeCycleListener, UnregisterStateListener, updateNameInDatabaseRecord, UpdateShadowVersion, updateStateInDatabaseRecord
 
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
See Also:
Constant Field Values

ITD_V200_VERSION

public static final int ITD_V200_VERSION
Version 2.00 value

See Also:
Constant Field Values
Constructor Detail

TWGNativeManagedObject

public TWGNativeManagedObject()
Default constructor for native managed object

Method Detail

copyTo

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

Overrides:
copyTo in class TWGManagedObject
Parameters:
managedObject - target managed object.

SetUniqueID

public void SetUniqueID(long uid)
Set unique ID: removed or add objects to common object list

Parameters:
uid - - new unique ID

UniqueID

public long UniqueID()
Return unique ID

Returns:
unique ID value

setUUID

public void setUUID(byte[] new_val,
                    boolean no_save)
Set UUID

Parameters:
new_val - - byte[16] unique ID (or null)
no_save - - no save required (used during restore)

getUUID

public byte[] getUUID()
Get UUID


setArchType

public void setArchType(byte new_val,
                        boolean no_save)
Set arch_type

Parameters:
new_val - - byte architecture type (or null)
no_save - - no save required (used during restore)

getArchType

public byte getArchType()
Get arch_type


setMACAddress

public void setMACAddress(byte[] new_val,
                          boolean no_save)
Set MAC Address

Parameters:
new_val - - byte[6] MAC Address (or null)
no_save - - no save required (used during restore)

getMACAddress

public byte[] getMACAddress()
Get MAC Address


getAllMACAddrs

public java.lang.String[] getAllMACAddrs()
Return list of all known MAC addresses for the given object

Returns:
Array of MAC addresses as Strings

GetAllSNIDTags

public static int[] GetAllSNIDTags()
Return all SNID tags

Returns:
all SNID tags

GetSNIDByTag

public static com.tivoli.twg.netipc.SystemNodeItemData GetSNIDByTag(int systag)
Get SNID by tag

Returns:
SNID for the specified system tag

AddUpdateSNID

public static void AddUpdateSNID(int systag,
                                 byte[] snidbuf,
                                 int snidoff)
                          throws TWGPersistentObjectSaveException,
                                 TWGObjectDestroyException
Update existing SNID record, or add new one

Parameters:
systag - - system tag
snidbuf - - buffer containing SNID record
snidoff - - offset of SNID record
Throws:
TWGPersistentObjectSaveException - if error on saving update
TWGObjectDestroyException - if error on deleting old objects

getIPAddressList

public StringValueSet getIPAddressList()
Return list of TCPIP addresses currently being used by this native MO.

Throws:
TWGObjectDestroyException - if error destroying obsolete objects

ValidateSNIDs

public static void ValidateSNIDs(int[] systags)
                          throws TWGObjectDestroyException
Validate records using tag list : remove all records which are not in list

Parameters:
systags - - array of valid system tags
Throws:
TWGObjectDestroyException - if error destroying obsolete objects

FindByUniqueID

public static TWGNativeManagedObject FindByUniqueID(long uid)
Find native managed object by unique id.

Parameters:
uid - - unique ID

Delete

public void Delete()
Destructor for TWGNativeManagedObject: remove object from lists

Overrides:
Delete in class TWGManagedObject

Destroy

public void Destroy()
             throws TWGObjectDestroyException
Destroy for TWGNativeManagedObject: send delete to NetMgr

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

DumpAll

public static void DumpAll()
Dump info on all objects (debug)


saveData

protected void saveData(TWGPersistentObjectDictionary dictionary)
                 throws TWGPersistentObjectSaveException
Method for saving persistent object data.

Overrides:
saveData in class TWGManagedObject
Throws:
TWGPersistentObjectSaveException - thrown to abort save procedure.

restoreData

protected void restoreData(TWGPersistentObjectDictionary dictionary,
                           boolean resolveObjectReferences)
                    throws TWGPersistentObjectRestoreException
Method for restoring persistent object data.

Overrides:
restoreData in class TWGManagedObject
Parameters:
resolveObjectReferences - used to indicate if object references should be resolved during restore.
Throws:
TWGPersistentObjectRestoreException - thrown to abort restore procedure.

GetPerferredPath

public java.lang.String GetPerferredPath()
Get current preferred IPC path from server to client

Returns:
Preferred IPC path

getPreferredPath

public java.lang.String getPreferredPath()
Get current preferred IPC path from server to client

Returns:
Preferred IPC path

GetAvailablePaths

public java.lang.String[] GetAvailablePaths()
Return all available IPC paths

Returns:
list of IPC paths

IsClientServiceSupported

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

Overrides:
IsClientServiceSupported in class TWGManagedObject
Parameters:
svcname - - service name to be tested
Returns:
true if supported, false if not

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.

Overrides:
ClientServiceStart in class TWGManagedObject
Parameters:
svcname - - service name
cslistener - - ClientServiceListener for service complete

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.

Overrides:
ClientServiceStart in class TWGManagedObject
Parameters:
svcname - - service name
cslistener - - ClientServiceListener for service complete
userid - - user ID of requester

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.

Overrides:
ClientServiceStop in class TWGManagedObject
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.

Overrides:
ClientServiceStop in class TWGManagedObject
Parameters:
svcname - - service name
cslistener - - ClientServiceListener for service complete
userid - - user ID of requester (null if none)

startPing

public boolean startPing()
Start ping : return true if supported

Overrides:
startPing in class TWGManagedObject
Returns:
true if supported, false if not

startPingWithReauthenticate

public boolean startPingWithReauthenticate()
Start ping with reauthenticate : return true if supported

Overrides:
startPingWithReauthenticate in class TWGManagedObject
Returns:
true if supported, false if not

startPingInternal

protected boolean startPingInternal(boolean reauth)
Start ping : return true if supported

Parameters:
reauth - whether to request reauthentication
Returns:
true if supported, false if not

setPingInterval

public void setPingInterval(long intr)
f7693 Set Ping Interval

Overrides:
setPingInterval in class TWGManagedObject
Parameters:
intr - - new interval, in milliseconds

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
Overrides:
getAttributeIDList in class TWGManagedObject

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
Overrides:
getAttributeValue in class TWGManagedObject
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
Overrides:
setAttributeValue in class TWGManagedObject
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
Overrides:
getAttributeType in class TWGManagedObject
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
Overrides:
getAttributeDescription in class TWGManagedObject
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
Overrides:
getAttributeValueString in class TWGManagedObject
Parameters:
id - - attribute ID
loc - - locale to use for description
Returns:
descriptive string for attribute value, or null if not available

getFingerprint

public com.tivoli.twg.engine.TWGManagedObjectFingerprint getFingerprint()
Get fingerprint.

Overrides:
getFingerprint in class TWGManagedObject
Returns:
TWGManagedObjectFingerprint

startServiceRequest

protected void startServiceRequest()
Start service list request for native managed object (normal priority -- FIFO queuing)


startServiceRequest

protected void startServiceRequest(boolean highPriority)
Start service list request for native managed object

Parameters:
highPriority - true to enqueue as high priority (LIFO)

startServiceRequest

public static void startServiceRequest(java.lang.String baseService)
Perform a startServiceRequest() for all online objects that have the specified baseService. This is primarily used for objects that have CIMMgr and DMIMgr to force an update by check for specified classes as services.

Parameters:
baseService - - the service the object must have to be included in the startServiceRequest. Typically this is: NativeMO.CIMMgr NativeMO.DMIMgr

updateAttributes

protected void updateAttributes()
Update attribute flags


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

Overrides:
requestShutdown in class TWGManagedObject
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

Overrides:
requestPowerdown in class TWGManagedObject
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

Overrides:
requestRestart in class TWGManagedObject
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

Overrides:
requestWakeOnLAN in class TWGManagedObject
Parameters:
req_id_obj - - arbitrary request ID object (passed back to result listener)
result_listener - - result listener

getServerImageSet

public int getServerImageSet()
Get server image set (may be overridden by subclass)


getLaptopImageSet

public int getLaptopImageSet()
Get laptop image set (may be overridden by subclass)


getDesktopImageSet

public int getDesktopImageSet()
Get desktop image set (may be overridden by subclass)


requestClientSecure

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

Overrides:
requestClientSecure in class TWGManagedObject
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

getAgentVersion

public java.lang.String getAgentVersion()
Get agent version string

Returns:
version string (v.vv), or null if unknown

getAgentDisplayVersion

public java.lang.String getAgentDisplayVersion()
Get displayable agent version string

Returns:
version string (v.vv), or null if unknown

getAgentDate

public java.util.Date getAgentDate()
Get agent date

Returns:
date (UTC), or null if unknown

getLicenseVersionRequired

public int getLicenseVersionRequired(int prod_id)
License version required for this MO instance.

Overrides:
getLicenseVersionRequired in class TWGManagedObject
Parameters:
prod_id - - product ID to be checked for

issueConfigRecordSynchronize

public void issueConfigRecordSynchronize(TWGDistConfigRecordHashcode[] recs,
                                         DistConfigAgentResult rslt)
Starts synchronize of agent state to match given set of record definitions. Result of operation should be reported using provided DistConfigAgentResult object.

Specified by:
issueConfigRecordSynchronize in interface TWGDistConfigAgentUpdate
Parameters:
recs - - TWGDistConfigRecordHashcode set to be synchronized on agent
rslt - - result object to report results to

requestAccess

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

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

getComputerName

public java.lang.String getComputerName()
Get computer name


addDatabaseRecord

public void addDatabaseRecord()
Add managed object database table row

Overrides:
addDatabaseRecord in class TWGManagedObject

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