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.

Using BPCU to generate difference reports

Run the Best Practice Conversion Utility (BPCU) in ReportDiff mode to compare objects between the overlay hash file and an BMC Remedy AR System server, and generate difference reports.

To generate a differences report

  1. At the command prompt, go to the <utilityInstallDir>\Best_Practice_Conversion_Utility directory
  2. Run BPCU in ReportDiff mode by executing the following command with the appropriate arguments (see the following table):
    • (Microsoft Windows) bpcu.bat
    • (UNIX)

Command-line options for ReportDiff mode




Name of the server on which to perform the operation.


User name.


User password.


(optional) User authentication string.


(optional) TCP port of the server on which to perform the operation.


(optional) RPC port of the server on which to perform the operation.


Absolute path to the overlay hash file (include full path and file name).


(optional) Full path to the XML file containing a list of objects to include in or to exclude from the operation.
This option does not apply to ReportDiff mode when two overlay hash files are compared.


(optional) Comma-separated list of form names whose associated fields and views are the only objects processed by the operation.
Do not use this option with the -s option.


(optional) File name and path of the difference report. Do not include a file extension.

If you do not provide a file name, the following name is used:

If you do not provide a path, the utility places the report file in the installationDir\Best_Practice_Conversion_Utility\output folder.


(optional) Format of the difference report. Values are:

  • 0 — (Default) HTML
  • 1 — CSV
  • 2 — XLSX


(optional) Flag that specifies whether to include overlay and custom objects in the "extension" section of the difference report.
This option applies only to file-to-server comparisons. Values are:

  • 0 — (Default) Exclude from extension section.
  • 1 — Include in extension section.


Utility mode. Values are D or d or diff.


(optional) Indicates whether to display or hide the list of objects that will be skipped in Overlay mode.

  • 0 — (Default) Hide this list in the difference report.
  • 1 — Display this list in the difference report.

Related topics

For an example of using the bpcu command to compare objects, see Stage 3 - Create overlays for existing customizations.

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.