Rational Developer for System z, Version 7.6

Managed Synchronization

Rational® Developer for System z® offers a Managed Synchronization wizard that allows users to set up projects so that they can be easily synchronized with a host without the need to manually set mappings for each file. The Managed Synchronization wizard page offers the ability to enable automatic mapping. When enabled, specified project files will be automatically mapped to remote MVS™ locations based on the type of file extension.

When you enable Remote Synchronization, the Enable Remote Synchronization wizard will contain a Managed Synchronization wizard page. To access the wizard, perform the following steps.

  1. Enable the local project by Right-clicking on it and then selecting Remote > Enable Remote Synchronization from the context menu.
  2. The Remote Synchronization wizard will be displayed.

The Remote Synchronization wizard consists of three main parts. Located at the top of the window is a check box labeled Automatic Mapping. To enable automatic mapping, simply select this check box. Located just below that are two drop down boxes labeled Host Short Name and High Level Qualifier The Host Short Name box allows you to select the host system that you would like to use for your mappings. If you wish to define a High Level Qualifier, you must be connected to the host system before starting the wizard. Once a connection is made, the wizard allows you to select a High Level Qualifier from a list of defined filters for your connection. Selecting a High Level Qualifier will allow your mappings to use the <HLQ> variable, which will be replaced with the selected High Level Qualifier.

Note: If you are enabling remote synchronization on a Local z/OS® Project, such as a Local COBOL Project, the Host Short Name and High Level Qualifier will be set in a previous wizard page, and will not be editable on the Managed Synchronization wizard page.
The wizard, by default, provides an editable list of available mappings that can be used to synchronize your local files to the host. If the list of mappings that is provided is not sufficient, the remote synchronization wizard also provides you with the ability to add your own mappings.
Table 1. The following variables are supported within the Mapping location.
Variable Name Description Example
<HLQ> The High Level Qualifier selected. This allows for mappings to be easily changed between users and systems. <HLQ>.SRC>COBOL might be mapped to FEK.SRC.COBOL
<PROJ> This variable will map to the truncated name of the local project. FEK.<PROJ>.SRC.PLI might be mapped to FEK.LOCALPRO.SRC.PLI for a project named “Local Project”.

To manually add a mapping to the list, perform the following steps:

  1. Select the Add button located to the right of the mappings area.
  2. When the mapping editor appears, it will request a file extension as well as mapping location.
    • File extension: The extension for which you want to map.
    • Mapping location: The location where files with the specified extension will be mapped to.
  3. Select OK to finish.
  4. Repeat steps 1 through 3 to add any additional mappings.

After managed synchronization has been enabled and configured for your projects, CARMA will map your files for you. Part of this process involves the truncation of file names to ensure that they fit the mapping location properly. File names will be truncated to a maximum length of eight (8) characters. In addition, all spaces and invalid MVS characters will be removed and the names will be converted to all upper case. These default mappings will be visible in the Pushable Manifest Editor, and will be green. In the event that two or more files are mapped to the same location with an identical truncated file name, an error will occur. When this happens, you will be forced to manually change the mapped location of the files that have been mapped to the same location. These locations can be changed in the Pushable Manifest Editor. See below for an example.

File File Name Truncated File Name Error Caused
File 1 Super big File.cpp FEK.SRC(SUPERBIG) Yes
File 2 Not so BiG.cpp FEK.SRC(NOTSOBIG) No
File 3 Supper Big file for YOU.cpp FEK.SRC(SUPERBIG) Yes

After a project has enabled Remote Synchronization, you may view and edit its properties and settings by Right-clicking the enabled project and selecting Remote Properties from the context menu.

You can modify the initial list of mappings presented by the Managed Synchronization wizard page through the Remote Synchronization preference page located by selecting Window > Preferences, and then selecting Remote Systems > Remote Synchronization from the Preferences panel.


Terms of use | Feedback

This information center is powered by Eclipse technology. (http://www.eclipse.org)