Refreshing the contents of a broker archive

Refresh the contents of a broker archive by using the Refresh option of the Broker Archive editor in the workbench. Alternatively, remove resources from your broker archive and, having made the required changes, add them back again.

Before you start:

See Creating a broker archive and Adding files to a broker archive.

You are likely at some time to make changes to resources that you have already added to your broker archive (BAR) file. Follow these steps to refresh the contents of a broker archive so that they are reflected in the archive before you deploy it.

  1. Switch to the Broker Administration perspective.

    BAR files that need to be refreshed are shown with an 'out-of-sync' icon Inconsistent in the Navigator view. (When any changes are made to deployable files in the workspace, that have previously been built in the broker archive, the BAR file is considered to be inconsistent. The BAR file is also inconsistent if any changes are made to the project that the files belong to.)

  2. Double-click your BAR file in the Navigator view to open it.

    The contents of the BAR file are shown in the Content editor. Icons indicate resources that are consistent Consistent, and those that need to be refreshed Inconsistent.

  3. To refresh all the resources in the broker archive, click Refresh Refresh.

    A dialog box opens, showing progress. When the operation is complete, click Details to see information about what was refreshed, what was not, and why. If the refresh process was successful, you see the same information that is placed in the user log by each of the resource compilers.

    Alternatively, you can refresh the archive contents by right-clicking a BAR file in the Navigator view and selecting Refresh Archive Contents. The broker archive is rebuilt in the background.

    You can view, and clear Clear, the user and service logs by clicking the appropriate tabs in the Broker Archive editor.

  4. (Optional) To view the properties of an individual resource in the Content editor, right-click the resource and click Show in Properties.
    The Deployable properties view opens (if it is not already in the perspective) and shows details of the resource that you have selected. The view has two fields:
    • Workspace Resource, with references to the linked workspace resources (.msgflow, .mset, .xml, and .xslt files, for example).
    • Last Compile Status, which shows the user log entry for the last compilation. You can copy text, but you cannot modify it.

Next:

Deploying a broker archive file

Related concepts
Message flow application deployment
Broker archive
Related tasks
Deploying a message flow application
Resolving problems when you use the workbench
Resolving problems when deploying message flows or message sets
Related reference
Broker Archive editor
Broker Administration perspective
Notices | Trademarks | Downloads | Library | Support | Feedback

Copyright IBM Corporation 1999, 2009Copyright IBM Corporation 1999, 2009.
Last updated : 2009-01-07 15:21:52

af03955_