This documentation applies to the 8.1 version of Remedy Action Request System, which is in "End of Version Support."

To view the latest version, select the version from the Product version menu.

Common plug-in C functions and Java methods

This section describes the calls or methods common to all plug-in types including:


Plug-in operations run synchronously; that is, BMC Remedy AR System waits for a plug-in to complete its processing before the server continues its processing. Thus, a badly written plug-in can adversely impact BMC Remedy AR System performance and stability. Plug-in developers must:

  • Maintain thread safety
  • Use minimal processing logic for optimal code execution
  • Implement only callback methods that are required or that have custom logic for a given plug-in
  • Allocate or free resources appropriately to prevent resource leaks
  • Optimize any costly operation that must be performed (or data structures that must be built) by employing a meaningful caching strategy.

Common C plug-in functions

The following C API functions are common to every type of plug-in:

  • ARPluginCreateInstance
  • ARPluginDeleteInstance
  • ARPluginEvent
  • ARPluginIdentify
  • ARPluginInitialization
  • ARPluginSetProperties
  • ARPluginTermination

In general, these functions use the same structure as other AR System C API functions. The plug-in server calls the functions and provides the necessary input data. The plug-in accepts the data, processes it, and returns the appropriate response data to the plug-in server.

The following figure shows a typical sequence of calls that the plug-in server makes on a C plug-in.

C plug-in call sequence

(Click the image to expand it.)

For more information, see AR System plug-in API functions.

Common Java plug-in methods

The methods defined in the ARPluggable interface and the ARPlugin abstract class are common to all plug-in types. For more information, see the Java plug-in API online documentation located at ARSystemServerInstallDir\ARserver\api\javaplugins\arpluginsdocVerNum.jar.

This version of the documentation is no longer supported. However, the documentation is available for your convenience. You will not be able to leave comments.