com.adventnet.nms.topodb.tl1
Class TL1Interface

java.lang.Object
  com.adventnet.nms.topodb.ManagedObject
      com.adventnet.nms.topodb.TopoObject
          com.adventnet.nms.topodb.IpAddress
              com.adventnet.nms.topodb.tl1.TL1Interface

All Implemented Interfaces:

DBExtendedInterface, DBInterface, com.adventnet.nms.topodb.corba.IpAddress_CIOperations, com.adventnet.nms.topodb.corba.ManagedObject_CIOperations, com.adventnet.nms.topodb.corba.TopoObject_CIOperations, java.io.Serializable, java.lang.Cloneable

public class TL1Interface
extends IpAddress

This class extends the IpAddress class and represents an Interface attached to a TL1Node discovered by WebNMS System. For detailed information on each of the fields used in this TL1Node class, please refer to the Help Documentation or the documentation provided in the example_tl1seed.file under WebNMS_HOME/conf/examples directory.

See Also:

Serialized Form

Field Summary

Fields inherited from class com.adventnet.nms.topodb.TopoObject

PROCEEDSTATUSPOLL

Constructor Summary

TL1Interface()
Default constructor.

Method Summary

protected int	checkStatus() This method is called to check the status of the TL1Interface object.
boolean	checkValues(com.adventnet.tl1.message.TL1ResponseMessage resMess, java.lang.String response)
java.lang.String	getConnectionHandler() Get the ConnectionHandler implementation class name for this TL1 device.
java.lang.String	getDictionary() For future use.
java.util.Properties	getProperties() Returns the Properties of the TL1Interface object.
java.lang.String	getSessionId() Get the current SessionId used.
java.lang.String	getStatpollCommand() Get the Status Polling Commands (TL1 Input Commands) used for status polling the TL1Interface object and thereby the TL1 device.
java.util.Vector	getStatpollCommandV() Get the Status Polling Commands (TL1 Input Commands) used for status polling the TL1Interface object and thereby the TL1 device.
int	getTl1port() Get the current port number of TL1 Agent in the NetworkElement used for connecting to the TL1 device.
void	setConnectionHandler(java.lang.String connHandler) Set the ConnectionHandler implementation classname for this TL1 device.
void	setDictionary(java.lang.String diction) For future use.
void	setProperties(java.util.Properties p) Set the TL1Interface object's properties.
void	setSessionId(java.lang.String sessId) Set the current SessionId used.
void	setStatpollCommand(java.lang.String statpollStr) Set the Status Polling Commands (TL1 Input Commands) used for status polling the TL1Interface object and thereby the TL1 device.
void	setStatpollCommandV(java.util.Vector statpollV) Get the Status Polling Commands (TL1 Input Commands) used for status polling the TL1Interface object and thereby the TL1 device.
void	setTl1port(int port) Set the current port number of TL1 Agent in the NetworkElement used for connecting to the TL1 device.

Methods inherited from class com.adventnet.nms.topodb.IpAddress

checkDHCPNodeStatus, checkStatus_CT, clone, getParentNet, getParentNode, getProperties_CT, getStatus_CT, getTieRefHolder_IpAddress, getUserProperties_CT, setParentNet, setParentNode, setProperties_CT

Methods inherited from class com.adventnet.nms.topodb.TopoObject

getBaseMibs, getCommunity, getContextName, getDomainName, getIpAddress, getIsDHCP, getIsInterface, getIsNetwork, getIsNode, getIsRouter, getIsSNMP, getNetmask, getSnmpport, getTieRefHolder_TopoObject, getUserName, getVersion, getWriteCommunity, setBaseMibs, setCommunity, setContextName, setDomainName, setIpAddress, setIsDHCP, setIsInterface, setIsNetwork, setIsNode, setIsRouter, setIsSNMP, setNetmask, setSnmpport, setUserName, setVersion, setWriteCommunity, toString

Methods inherited from class com.adventnet.nms.topodb.ManagedObject

addChildrenKey, addChildrenKeys, addGroupMembers, addGroupNames, equals, getChildren, getChildrenKeys, getClassname, getDisplayName, getDynamicUserProperty, getFailureCount, getFailureThreshold, getGroupMembers, getGroupNames, getGroups, getIsContainer, getIsGroup, getKey, getKeyName, getLazyLoaded, getLockId, getManaged, getMappedProperties, getMembers, getMoid, getName, getOwnerName, getParentId, getParentKey, getPollInterval, getShallowProperties, getStatus, getStatus, getStatusChangeTime, getStatusColor, getStatusPollEnabled, getStatusUpdateTime, getTester, getTieRefHolder_ManagedObject, getType, getUClass, getUserProperties, getUserProperty, getUTest, getWebNMS, hashCode, pollStatus, removeChildren, removeChildrenKeys, removeGroupMembers, removeGroupNames, removeUserProperty, setChildren, setChildrenKeys, setClassname, setDisplayName, setDynamicUserProperty, setFailureCount, setFailureThreshold, setGroupMembers, setGroupNames, setGroups, setIsContainer, setIsGroup, setLazyLoaded, setLockId, setManaged, setMappedProperties, setMembers, setName, setObjMoid, setOwnerName, setParentId, setParentKey, setPollInterval, setShallowProperties, setStatus, setStatusChangeTime, setStatusPollEnabled, setStatusUpdateTime, setTester, setType, setUClass, setUserProperty, setUTest, setWebNMS

Methods inherited from class java.lang.Object

finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface com.adventnet.nms.topodb.corba.TopoObject_CIOperations

getBaseMibs, getCommunity, getIpAddress, getIsInterface, getIsNetwork, getIsNode, getIsRouter, getIsSNMP, getNetmask, getSnmpport, getWriteCommunity, setBaseMibs, setCommunity, setIpAddress, setIsInterface, setIsNetwork, setIsNode, setIsRouter, setIsSNMP, setNetmask, setSnmpport, setWriteCommunity

Methods inherited from interface com.adventnet.nms.topodb.corba.ManagedObject_CIOperations

getClassname, getFailureCount, getFailureThreshold, getGroupNames, getKey, getKeyName, getManaged, getName, getPollInterval, getStatusChangeTime, getStatusUpdateTime, getTester, getType, getUClass, getWebNMS, pollStatus, setFailureThreshold, setGroupNames, setManaged, setName, setPollInterval, setStatus, setStatusChangeTime, setStatusUpdateTime, setTester, setType, setUClass, setWebNMS

Constructor Detail

TL1Interface

public TL1Interface()

Default constructor. Sets the "type" and "classname" fields to a default value of "TL1Interface" and the "tester" field to a default value of "tl1ping"

Method Detail

getTl1port

public int getTl1port()

Get the current port number of TL1 Agent in the NetworkElement used for connecting to the TL1 device.

Returns:

TL1 Agent port number currently used by Web NMS.

setTl1port

public void setTl1port(int port)

Set the current port number of TL1 Agent in the NetworkElement used for connecting to the TL1 device.

Parameters:

port - TL1 Agent port number currently used by Web NMS.

getSessionId

public java.lang.String getSessionId()

Get the current SessionId used. SessionId is a unique key allocated by the Management Server denoting a connection between Web NMS and the Network Element.

Returns:

SessionId used currently.

setSessionId

public void setSessionId(java.lang.String sessId)

Set the current SessionId used. SessionId is a unique key allocated by the Management Server denoting a connection between Web NMS and the Network Element.

Parameters:

SessionId - used currently.

getDictionary

public java.lang.String getDictionary()

For future use. Not in use as of now. Get the XML filenames defining the complete set of device specific input commands, responses messages, acknowledgement messages and autonomous messages.

Returns:

dictionaries used.

setDictionary

public void setDictionary(java.lang.String diction)

For future use. Not in use as of now. Set the XML filenames defining the complete set of device specific input commands, responses messages, acknowledgement messages and autonomous messages.

Parameters:

dictionaries - used.

getConnectionHandler

public java.lang.String getConnectionHandler()

Get the ConnectionHandler implementation class name for this TL1 device. ConnectionHandler is a class used for doing any special setups or device specific customization when a connection is established to the device. Please refer to the Help Documentation or the documentation provided in the example_tl1seed.file in the WebNMS_HOME/conf/example directory.

Returns:

the ConnectionHandler implementation class name.

setConnectionHandler

public void setConnectionHandler(java.lang.String connHandler)

Set the ConnectionHandler implementation classname for this TL1 device. ConnectionHandler is a class used for doing any special setups or device specific customization when a connection is established to the device. Please refer to the Help Documentation or the documentation provided in the example_tl1seed.file in the WebNMS_HOME/conf/examples directory.

getStatpollCommand

public java.lang.String getStatpollCommand()

Get the Status Polling Commands (TL1 Input Commands) used for status polling the TL1Interface object and thereby the TL1 device. Any response information to be used for matching with the information obtained from the TL1 Response Message, for checking if the device is healthy can also be given. The returned String uses a special format. User is recommended to use the user friendly getStatpollCommandV() method instead of this method. This method is meant for internal use by Web NMS

Returns:

Status Polling Commands and the response information are returned as a String in a special format.

setStatpollCommand

public void setStatpollCommand(java.lang.String statpollStr)

Set the Status Polling Commands (TL1 Input Commands) used for status polling the TL1Interface object and thereby the TL1 device. Any response information to be used for matching with the information obtained from the TL1 Response Message, for checking if the device is healthy can also be given. The String argument needs to be in a special format. User is recommended to use the user friendly setStatpollCommandV() method instead of this method. This method is meant for internal use by Web NMS.

Parameters:

Status - Polling Commands and the response information are passed as a String in a special format.

getStatpollCommandV

public java.util.Vector getStatpollCommandV()

Get the Status Polling Commands (TL1 Input Commands) used for status polling the TL1Interface object and thereby the TL1 device. Any response information to be used for matching with the information obtained from the TL1 Response Message, for checking if the device is healthy can also be given. . Returns a Vector of Hashtables. The Hashtables have the the TL1 command against "command" key and the response information, for matching, against "response" key. User is recommended to use this method and avoid using the getStatpollCommand() method. Please refer to the Help Documentation or the documentation provided in the example_tl1seed.file under WebNMS_HOME/conf/examples directory for detailed information and the format followed for the "response" message string.

Returns:

Status Polling Commands and the response information are returned as a Vector of Hashtables.

setStatpollCommandV

public void setStatpollCommandV(java.util.Vector statpollV)

Get the Status Polling Commands (TL1 Input Commands) used for status polling the TL1Interface object and thereby the TL1 device. Any response information to be used for matching with the information obtained from the TL1 Response Message, for checking if the device is healthy can also be given. The argument passed is a Vector of Hashtables. The Hashtables should have the TL1 Status Polling Commands against "command" key and the response information, for matching, against "response" key. This "response" information is optional. User is recommended to use this method and avoid using the setStatpollCommand() method. Please refer to the Help Documentation or the documentation provided in the example_tl1seed.file under WebNMS_HOME/conf/examples directory for detailed information and the format to be follow for the "response" message string.

Parameters:

Status - Polling Commands and the response information are passed as a Vector of Hashtables.

getProperties

public java.util.Properties getProperties()

Returns the Properties of the TL1Interface object. Derived classes should override this method and invoke the super.getProperties() in the begining of this method. Please refer to the Help Documentation or the documentation provided in the example_tl1seed.file under WebNMS_HOME/conf/examples directory for detailed information on each of the TL1Node object fields.

Specified by:

getProperties in interface DBInterface

Overrides:

getProperties in class IpAddress

Returns:

The values of the following fields of this class and all its super classes in a Property object including the user properties. This method returns the value of all fields as string.

 
 tl1port, sessionId, dictionary, connectionHandler, statpollCommand
 all the properties of this object's super classes.
  

See Also:

ManagedObject#getProperties()

setProperties

public void setProperties(java.util.Properties p)

Set the TL1Interface object's properties. The name of an object cannot be changed using this method. Derived Classes should override this method and invoke super.setProperties() at the end of this method. If the Object is to be updated in the database the TopoAPI.updateObject() method should be invoked after doing the setProperties() on the object. It's recommended to use this method to set all properties except the statpollCommand as it uses special format, internally used by Web NMS. Please refer to the Help Documentation or the documentation provided in the example_tl1seed.file under WebNMS_HOME/conf/examples directory for detailed information on each of the TL1Node object fields.

Specified by:

setProperties in interface DBInterface

Overrides:

setProperties in class IpAddress

Parameters:

p - The properties to be set in this object.

 
 tl1port, sessionId, dictionary, connectionHandler, statpollCommand,
 and all the properties of this object's super classes.
  

See Also:

ManagedObject#setProperties(Properties)

checkStatus

protected int checkStatus()
                   throws java.rmi.RemoteException

This method is called to check the status of the TL1Interface object. It does the status checking and returns the new status of this object. Super classes should override this method and provide their own status checking logic.

Overrides:

checkStatus in class IpAddress

Returns:

status of the object to be set.

Throws:

java.rmi.RemoteException - if an error occurs

checkValues

public boolean checkValues(com.adventnet.tl1.message.TL1ResponseMessage resMess,
                           java.lang.String response)