WebSphere Message Broker, Version 8.0.0.7 Operating Systems: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

See information about the latest product version

Converting a project to an application or library

Two options are available to convert existing projects to applications or libraries. Use Convert Single Project to convert a project with no references. Use Analyse and Convert Multiple Projects to convert one or more projects and any referenced resources.

Before you start:
You can convert a Message Broker project, Java™ project, message set project, or PHP project into an application or library. For example, you might want to convert a project in the following situations.
  • You imported an existing project from a previous version of WebSphere Message Broker. You want to use that project as the basis for a new application. You can convert the project into an application, then add the rest of the resources that are required to complete your solution.
  • You have an existing project that contains resources that you want to reuse in several solutions. You can convert the project into a library, add any other required resources, then refer to that library from the appropriate applications.
  • You imported your resources from a previous version of WebSphere Message Broker, and your message flow projects were migrated to Message Broker projects. You can convert all or some of your projects (such as Message Broker projects, Java projects, and message set projects) automatically to applications and libraries.

If you are converting a project that has no references to other resources, a simple conversion to an application or library is sufficient (see Converting a single project to an application or library). To convert all imported projects, or a project that contains references to other resources, a conversion wizard is provided, which uses rules to decide how to convert your resources. The wizard also converts associated projects, such as Java projects and message set projects, that are referenced by the selected projects (see Converting one or more projects with the conversion wizard).

Converting a single project to an application or library

The following restrictions apply when you convert a single project to an application or library:
  • You can convert only Message Broker projects, Java projects, message set projects, and PHP projects.
  • You can select multiple projects to convert to applications or libraries, but you cannot convert more than one Message Broker project at a time. To convert multiple Message Broker projects, you must use the conversion wizard.
  • You cannot convert a project that refers to a library.
  • If a Message Broker project is referenced by another Message Broker project, you can convert it to a library only.
  • When you select the Convert single project option, no precondition checks are made, such as checking for references to projects that do not exist. If your project might contain references to other resources, use the wizard to analyze all projects and resources. To complete precondition checks before you convert a project, select the option Analyse and Convert Multiple Projects.
To convert a single project to an application or library, without making precondition checks, complete the following steps.
  1. In the Broker Development view, right-click the project or projects that you want to convert, then click Convert to application or library > Convert single project.
  2. Select either an application or a library.
  3. Click Finish.
The project is converted into an application or library and shown in the Broker Development view. The contents of the original project are now shown under the new application or library.

Converting one or more projects with the conversion wizard

To convert projects to applications or libraries, including precondition checks, complete the following steps.

  1. In the Broker Development view, select the resources that you want to convert. You can select multiple projects in the Independent Resources folder, or you can select all projects by right-clicking the Independent Resources folder.
  2. Right-click the Independent Resources folder, or one of the selected projects, and click Convert to application or library > Analyze and convert multiple projects. The Convert Projects to Applications and Libraries wizard opens.
  3. Projects that you can convert are listed. Projects that you selected in step 2 are preselected in the wizard. Select the projects to convert, then click Next.

    The wizard completes a precondition check. If any errors are detected that would prevent successful conversion, those errors are listed. For example, a Message Broker project cannot be converted if it references a project that does not exist. You cannot continue with the conversion until all errors are fixed.

  4. Select an error and click Fix selected.

    Alternatively, you can fix all the errors listed by clicking Fix all. If more than one solution is available for an error, you can select the solution from the Quick Fix dialog box that opens. An error that was fixed is indicated by a green tick.

    After you apply one or more fixes, if you change your mind, you can undo fixes. Click Cancel, then specify whether the fixes made during the precondition check are to be undone.

    When you have applied fixes to the errors, the wizard runs the precondition check again. If new errors occur, they are listed so that you can fix them.

    When no errors exist, click Next. Alternatively, click Cancel, fix the errors manually, then repeat steps 1 - 3.

  5. Review the proposed conversion actions.

    The wizard analyzes the required conversion actions and shows a summary of changes that it will make. The proposed new applications and libraries are shown in tree form. Expand an application or library to see the resources that it references. The Conversion Actions pane lists the changes that will be made to convert the selected resource.

    The wizard applies the following rules to convert projects to applications or libraries:
    • A top-level Message Broker project, or a Message Broker project that is not referenced by another Message Broker project, is converted to an application.
    • A Message Broker project that is referenced by another Message Broker project is converted to a library.
    • If you choose to convert a referenced project that is not a Message Broker project, it is converted to a library, except for Data Design projects and Adapter Connection projects. These projects are unchanged and are referenced by the application or library. If you choose not to convert the referenced project, it remains unchanged, and the referencing project refers to the original project.

      For example, a Message Broker project refers to a message set. If the Message Broker project and the message set project are both selected for conversion, the Message Broker project is converted to an application, and the message set project is converted to a library. If, however, the Message Broker project is selected for conversion, but the referenced message set project is not selected, the Message Broker project is converted to an application that refers to the message set. The message set is not converted.

    • A project that is not a Message Broker project, and that is referenced by multiple projects, is converted to a wrapper library. A wrapper library is a library that refers to the original project, such as a message set project. Project references from other projects are updated to refer to the wrapper library.
    • A stand-alone project that is not a Message Broker project is converted to a library.
    • A Message Broker project that contains broken references is not converted; the broken references are reported so that you can fix them.
  6. The conversion changes cannot be reversed. Therefore, you are prompted to back up your workspace by clicking Export.
  7. For future reference, you can save the conversion actions for all converted projects by clicking Save all conversion actions to file. You can then save the single document as a .txt file.
  8. To complete the proposed changes, click Finish.
Your selected projects, and affected referenced projects, are converted to applications and libraries and are shown in the Broker Development view.
Next: Now that you have created an application or library, you can continue with any of the following tasks:

If you converted a Message Broker project that referred to a Java project, you can now convert the Java project to a library so that it can be used by other applications. In the Broker Development view, right-click the Java project and click Include project in a new library. A library is created for the Java project, and the reference between the application and Java project is rebuilt.

You can also convert an application to a library, or a library to an application, by following the instructions in Converting between applications and libraries.

Notices | Trademarks | Downloads | Library | Support | Feedback

Copyright IBM Corporation 1999, 2016Copyright IBM Corporation 1999, 2016.

        
        Last updated:
        
        Last updated: 2016-05-23 14:47:51


Task topicTask topic | Version 8.0.0.7 | bc23535_