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.
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.
| 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:
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.