Upgrade Guide for DB2 UDB for z/OS and OS/390 > Running the Postmerge Utilities >

Running the Postmerge Utilities


Upgrades: All upgrades.

Environments: Development environment only.

This topic is part of an upgrade process. See How to Perform the Upgrade.

After the merge is completed successfully, run the postmerge utilities. These utilities make the following changes to user interface objects in the merged repository:

  • Convert flow-based form applets to grid-based.
  • Verify that new or customized screens, views, and applets from the Prior Customer Repository are configured correctly and can be accessed in the UI.
  • Revise multi-value group (MVG) applets so that they are shuttle-enabled.
  • If you selected Incorporate Custom Layout (ICL) during the repository merge, the utilities list the UI objects that were affected.
  • Lists UI objects that have missing required fields.

You can rerun the postmerge utilities as needed. If the postmerge utilities encounter a problem, do the following:

  • Try to fix the problem in the merged repository, and then rerun the utilities.
  • If you cannot fix the problem, restore the backup of the postmerge Siebel Database or repository. Then, resolve the problem and run the utilities again.

The postmerge utilities take a significant amount of time to run.

Prerequisite. Before running the postmerge utilities, verify you have a backup of the Siebel Database or the Siebel Repository that was done after the repository merge.

To run the postmerge utilities

  1. If you are rerunning the postmerge utilities and want to save the existing log, rename the log. The path to the log is as follows:

    SIEBEL_TOOLS_INSTALL_DIR\reppatch\log\reputility.log

    If you do not rename the log, it will be overwritten.

  2. In Siebel Tools, navigate to Screens > Application Upgrader > Application Upgrade Object List.
  3. In the Application Upgrades list, select the record of the merge.
  4. In the Application Upgrades list, right-click and select Launch Post Merge utility from the pop-up menu.

    A dialog box appears and displays the postmerge utilities log. When the utilities have finished, a message showing completion displays in the log.

Upgrade Guide for DB2 UDB for z/OS and OS/390