Loading the local workspace

To work on your applications, you must first load the instances on which you must work into your local workspace. The Rational Programming Patterns workspace is represented by the Design Explorer view of the Pattern Driven Programming perspective. When you open this view for the first time, it is empty. Your first task is then to populate it.

You can populate your local workspace from the content of a Rational Team Concert server. To do so, you must open the Team Artifacts view of the Work Items perspective. You must create a repository connection to the Rational Team Concert server and connect to the project area managed by your team. When you are connected, you can load your local workspace in various ways:
  • To limit the number of the loaded artifacts, you can load only the artifacts or the projects that are required by one or more artifacts that you select.
  • To import all the artifacts that are contained in selected projects, you can load your local workspace from a Rational Team Concert stream.

You can also load your local workspace by importing the instances that are contained in an import file.

Loading the required artifacts

With this method, you load the artifacts that are required by one or more artifacts. The artifacts are loaded from the Rational Team Concert server into your local workspace, where they constitute a consistent set of data.

Loading the required artifacts comprises the following global steps:
  1. Searching for the artifacts in the indexes, performed by a server design search, a server artifact search, or a server reference search,
  2. Collecting the referenced artifacts, indicated by the progress bar of the number of analyzed artifacts,
  3. Selecting the artifacts to be loaded, displayed in a specific loading wizard,
  4. Validating the selection,
  5. Loading the artifacts in the local workspace, performed by Rational Team Concert,
  6. Indexing, performed by Rational Programming Pattern.

To use this method, you must start a design, an artifact, or a reference search on the Rational Team Concert server.

In the result view, you must then select the artifacts on which you must work. Right-click and select Load required artifacts. You can select this choice from one of the following artifacts:
  • One or more design files. A specific loading wizard opens and displays the selected design files and the artifacts that are required by them, following the subreference links. All these artifacts will be loaded into the local workspace.
  • One or more files that contain the source of an instance (Program, Screen, Server, Dialog, or Server Dialog), or a Screen map. The specific loading wizard opens and displays the files that will actually be loaded. The generation links are automatically explored and all the artifacts that are required for the generation are automatically selected.
Note: The number of the artifacts to be loaded is displayed for information.

The local workspace that is loaded in this way can be used immediately from the Design Explorer view of the Pattern Driven Programming perspective.

Limitations: The folder structure that is loaded with the specific loading wizard does not have a shared status.
The following limitations then apply to the files loaded in this way:
  • Moving, deleting, or renaming a file is impossible.
  • Moving a project to another component is impossible.
  • Renaming a folder that contains files loaded with the specific loading wizard is ineffective.
  • Deleting a folder that contains files loaded with the specific loading wizard has no effect on the folder. Only the files are deleted.
  • To load a full project that overwrites the same project with files loaded with the specific loading wizard, you must first delete the project to be overwritten.
To perform all these actions, you must fully load the projects that are involved.
If you create or generate instances in projects loaded with the specific loading wizard, you must share them explicitly. In the Design Explorer view, select the instances or the COBOL files to be shared, right-click, and select Team > Share selected elements. A sharing wizard opens. It shares the newly created files that belong to the same project and folder. If a new file is in a new folder, you must create this folder explicitly in the sharing wizard. This wizard automatically selects the correct project and folder to be shared. If you generated an instance, the wizard automatically selects the files that are associated with the source file (map file for Screens and metadata files). When the files are shared, they are displayed in the Pending changes view. You can then check them in a repository workspace and deliver them to the server.
Note: You can also open the file sharing wizard from the Project Explorer view of the Resource perspective if you generated the source in a zComponent project for example.
The following limitations apply when unloading components loaded with the specific loading wizard.
  • Deleting projects disconnects the shared files and deletes the complete folder structure.
  • Unloading a component from the Pending changes view unloads all the shared files, but the folder structure in the project remains as a skeleton. You must delete them explicitly.

Loading the required projects

With this method, you load the artifacts that are contained in the projects required by instances or generated files. The artifacts are directly loaded from the Rational Team Concert server into your local workspace, where they constitute a consistent set of data.

To use this method, you must start a design, an artifact, or a reference search on the Rational Team Concert server.

In the result view, you must select instances or generated files, right-click, and select Load required projects.

The selected artifacts and the projects that contain the artifacts required to maintain them are then loaded into your local workspace.

Loading from a Rational Team Concert stream

With this method, you load all the artifacts that are stored in some projects of a Rational Team Concert stream.

In the Team Artifacts view of the Work Items perspective, you must create a repository workspace from a stream of your team project area. This repository workspace is a private development workspace in which you can work alone or combine your work with the members of your team.

You must then select the projects to be loaded into your repository workspace.

All the selected projects are automatically displayed in your repository workspace and in the Design Explorer view of the Pattern Driven Programming perspective.

Loading from an import file

With this method, you load instances from a file that you must import. You import the file from the Design Explorer view or from the corresponding command line.

The file that contains the instances was exported with the export function of the Design Explorer view or created by the batch migration procedures.

When the file is imported, its instances automatically populate the location that is selected in the Design Explorer view of the Pattern Driven Programming perspective.


Feedback