Troubleshooting Query Parser plug-in issues

The Query Parser plug-in is used to convert a formatted BMC Remedy AR System qualification into an encoded qualification. This formatted qualification is used by the BIRT report and is also used when performing the search.

Plug-in type

Query Parser is a Java-based Filter API plug-in.

AR System server connectivity

The AR System server interacts with the Query Parser plug-in by using the BMC Remedy AR System Java API.
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 Query Parser 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.QUERYPARSER ARSYS.ARF.QUERYPARSER myServer:9999

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

To troubleshoot Query Parser plug-in issues

1. Verify the Query Parser 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 Query Parser plug-in.

To enable logs for the Query Parser 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 Query Parser plug-in.

Related topic

Enabling plug-ins