Updating FDs from a COBOL Source File or COBOL Syntax File

  1. With a catalog open in the Relativity Designer, on the Tools menu, click Update FDs from Source.

    The COBOL FD Importer tab is displayed in 'Updating FD from Source' mode. If you opened the COBOL FD Importer tab from the File menu, this mode is not enabled and you will be unable to perform the merge process with existing file definitions.

  2. In the Import FDs From field, select the type of update:
    • Update from a COBOL source (.cbl) file:
      CAUTION:
      Only use a source file that contains well-formed COBOL syntax that compiles cleanly.
      1. In the Import FDs From field, select New CST file compiled from COBOL source or New RST file compiled from COBOL source.
      2. To the right of the Files to Import field, click (Select file to import), then use the Open dialog box to select a .cbl file.
      3. If necessary, enter the appropriate compiler (directive) options in the Compilation Options field.
      4. If the FD includes copy files, click (Select file to import) and select the folder(s) in which the copy files(s) reside.
        Note: If you are having issues with the update, you may be requested to perform it with Keep Temporary Files after Import selected, which retains the temporary files created during the update process; SupportLine can use the .lst and .err.xml temporary files to help troubleshoot update issues.
    • Update from a COBOL syntax file:
      Note: The Existing CST File option is only available if you have Visual COBOL or Enterprise Developer installed.
      1. In the Import FDs From field, select Existing CST File or Existing RST File.
      2. To the right of the File to Import field, click (Select file to import), then use the Open dialog box to select a compatible COBOL syntax file for the selected COBOL language.
  3. Click Read File and Record Descriptions.

    If you selected a COBOL source file, it is compiled, and the FD information extracted to a COBOL Syntax Tree (CST) file or a Relativity Table (RST) file depending on the Micro Focus COBOL development product installed. Relativity can then read the FD information from the resulting file.

    A further two tabs are displayed. The Items to Import tab displays the FDs found in the selected file, and the Messages tab contains output from the Schema Extractor process.

  4. In the Items to Import tab, select the file definition(s) to update, then click Add to Catalog.
    Note: If you need to import other COBOL items from the source that are not part of the file definition (e.g. working-storage items), click Show Advanced Import Options, then select from the additional items displayed.

    For each selected file definition, an additional Update... tab containing a merge editor is displayed. Each FD is compared with the original FD, and an attempt is made to auto-resolve each field in the record.

  5. For each tab, deal with any items that require attention, as indicated by 'Unmatched' in the Matches column:
    1. Click the row containing Unmatched in the Matches column.

      Details of the difference between the original and new field are displayed.

    2. Click Unmatched, and then select a new status:
      • Select New if the item is a new addition to the FD.
      • Select Delete if the item is to be deleted from the FD.

    Once all unmatched fields are resolved, the Complete Merge for FD option becomes available.

  6. Click Complete Merge for FD.

    The updated file definition is now displayed in the Catalog Explorer. The existing file definition is still available in the Catalog Explorer, but has (Previous) appended to its name, and any tables associated with the previous FD have 'OLD' appended to their name. You can delete this file definition if it is no longer required, but first you must delete any existing table definitions for that file definition.

Parent topic: Updating COBOL Data File Definitions