Troubleshooting Parse Parameters plug-in issues

The Parse Parameters plug-in is used to parse parameters utilized by out-of-the-box Business Intelligence Reporting Tool (BIRT) reports. This plug-in is called when you create or modify a BIRT report.

• • Plug-in type
  • AR System server connectivity
  • Configuration information
  • To troubleshoot Parse Parameters plug-in issues
  • To enable logs for the Parse Parameters plug-in
  • Related topic

Plug-in type

Parse Parameters is a Java-based Filter API plug-in.

AR System server connectivity

AR System server interacts with the Parse Parameters plug-in by using the AR System Java API. This plug-in requires BIRT Runtime, which is installed during the AR System server installation in the <ARInstallationFolder>\pluginsvr\birtruntime folder.

The plug-in arreportVerNum.jar and arreportingapiVerNum.jar ( — VerNum represents the release version number) is installed in the <ARInstallationFolder>\pluginsvr folder.

Configuration information

The configuration information of the Parse Parameters plug-in is available in the AR System Administration: Plugin Server Configuration form.

The AR System Administration: AR System Configuration Generic UI form includes the Server-Plugin-Alias parameter setting that points to the correct plug-in server alias:
Server-Plugin-Alias: ARSYS.ARF.PARSEPARAMETERS ARSYS.ARF.PARSEPARAMETERS myServer:9999

See Updating-configuration-settings-by-using-the-AR-System-Configuration-Generic-UI-form, Configuring-Java-plug-in-servers and Setting-plug-in-server-configuration-options.

To troubleshoot Parse Parameters plug-in issues

1. Verify the Parse Parameters plug-in configuration.
2. Troubleshoot common plug-in related issues.
    For more information, see General-approach-for-troubleshooting-plug-in-issues.
3. If you need to investigate the issue further, enable the following logs:
   • Server side logs. For more information, see Enabling-server-side-AR-System-logs.
   • Plug-in specific logs. For more information, see To enable logs for the Parse Parameters plug-in.

To enable logs for the Parse Parameters plug-in

1. In a browser, open the BMC Remedy AR System Administration Console, and click System > General > Plugin Server Configuration.
2. On the Plugin Server Configuration form, from the Plugin Server Instance list, select the instance for which you want to enable logs.
3. Select the Plugin Server Configuration tab.
4. In the Logging Configurations area, from the Log Level list, select DEBUG.
5. Click Apply. 
   The arjavaplugin.log file now generates the debug logs for the Parse Parameters plug-in.

Related topic

Enabling-plug-ins