![]() |
Copyright © TIBCO Software Inc. All Rights Reserved |
Each adapter has three microagents, a standard TIBCO Hawk microagent named COM.TIBCO.ADAPTER.xyz where xyz is the adapter configuration name, a custom microagent and a class microagent. The microagents provide:
• Business level statistics—statistics that report the progress of the adapter as it interacts with the vendor application. These statistics indicate whether the Tuxedo service returned a success or a failure.
• Queries that return information about the state of the adapter. This can be an important tool for seeing the internals of an adapter and debugging it if something appears wrong. For example, methods can return information about threads, internal queues, or connections to the target system. Using these methods, one might be able to identify certain bottlenecks or gauge how successfully an adapter is scaling with respect to the current environment.
• Updates of the adapter runtime parameters. This includes retrieving the current runtime parameters and setting new runtime parameters without restarting the adapter. An example of this is getting and setting the polling interval. Updating a runtime parameter through the Hawk microagent only affects the setting of the instance that is running. It does not make a permanent change of the setting in either the repository or the .tra file.
Custom microagents are deprecated in this release. All business statistics related methods which were part of the custom microagent are now available in the class microagent.perfMon property value set in the adapter’s property file affects the business statistics related methods. If this property is set to on, the adapter does all the performance related calculations. When you invoke the methods, if the perfMon property is set to off, default values are displayed and not the valid values.
The getActivityStatisticsbyService and getActivityStatisticsbyOperation methods display the following message: Method Invocation returned NO Data, if the perfMon property is set to off.You can disallow adding custom methods to the class microagent when deploying the adapter by changing the addCustomHawkMethodstoClassMAgent property value in the adapter’s property file. If this property is set to on, custom methods (getPollingInterval and setPollingInterval) are added to the class microagents. If set to off, these methods are not visible.The following table lists each standard microagent methods available for the adapter and the pages on which the method is explained.
Table 39 Standard Microagent Methods Returns basic configuration information. More specific information is accessed by the more specific methods. Returns general status information, such as the number of TIBCO Rendezvous messages received and published, the number of errors since the last call, the PID of the application, and more. Returns the configuration ID, application name, version, and date for this adapter instance. Returns information retrieved from the ledger file of a certified messaging session for a publisher adapter.
Table 40 Class Microagent Methods Returns the total number of objects processed for all the schemas by each service that is associated with a specified operation. Returns the total number of objects processed for the given schema by each service that uses the schema.
![]() |
Copyright © TIBCO Software Inc. All Rights Reserved |