This documentation supports the 18.08 version of Remedy Action Request System.

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

Runtime configuration

To run Java API programs, make sure your execution environment includes:


Installing BMC Remedy Encryption Premium Security changes any active Java installation. If you install BMC Remedy Encryption Premium on a system that is running a client written using the BMC Remedy AR System Java API and later change the Java installation by installing a different version of the Java Runtime Environment (JRE) or Java Development Kit (JDK) or switching the system from one installed Java version to another, you must reinstall BMC Remedy Encryption Premium to ensure that the new or other Java installation has the changes that installation makes.

Changing the default configuration

To override the default Java API configuration, create the arsys_api.xml configuration file and make sure it is in the CLASSPATH environment variable or the java command -classpath command-line parameter. See the sample configuration file, arsys_sample.xml, in the lib directory for descriptions, valid values, and default values for the API configuration options.

Running the Java driver program

To run the Java driver program, perform the following steps:

  1. Set the Java environment variable as follows:
    export PATH=/opt/jdk<JDK-Install-Dir>/bin:$path
  2. Check the Java version by running java -version. If the correct version is displayed, it means that the java is enabled.
  3. Run the following command from the AR install directory.
    For Unix:
    java -classpath /opt/bmc/ars<AR Install Dir>/api/lib/javadriver.jar:./api/lib/arapi91_build001.jar:. com.bmc.arsys.demo.javadriver.JavaDriver
    For Windows:
    <AR Install Dir>\Arserver\api\lib

For more information, see Using the driver program.

Running the Windows driver program

To run the Windows driver program, click driver for wind32 or driver_win64 from C:\Program Files\BMC Software\ARSystem<AR Install Dir>\Arserver\api. Then from the DOS window, run the required command.

You can also invoke Java driver in Windows from the following path:

C:\Program Files\BMC Software\ARSystem<AR Install Dir>\Arserver\api\lib\javadriver.bat

Was this page helpful? Yes No Submitting... Thank you


  1. Paul Horncastle

    In a clean windows install the javadriver.bat file seems to be in folder ...Arserver\api\lib not as stated above. Can this be checked and corrected if this is the case?

    Nov 19, 2018 03:28
    1. Anagha Deshpande

      Hello Paul,

      We will confirm the file location and will update.



      Nov 19, 2018 08:59
      1. Anagha Deshpande

        Hello Paul,

        Apologies for the late response.

        I have updated the topic.



        Apr 24, 2019 11:35