Importing from a COBOL Source File or Relativity Symbol Table

With a catalog open in the Relativity Designer, on the File menu, click Import COBOL FDs.

The COBOL FD Importer tab is displayed.

If the current data source is a Client/Server data source, the Remote tick-box is selected: this allows you to select files on the Data Server machine during file import selection. If you want to select files on your local machine for import, ensure Remote is not selected.

In the Import FDs From field, select the type of import:

Import from a COBOL source (.cbl) file:
CAUTION:

Only use a source file that contains well-formed COBOL syntax that compiles cleanly.

Note: The New CST file compiled from COBOL source option is only available if you have Visual COBOL or Enterprise Developer installed.
1. In the Import FDs From field, select New RST file compiled from COBOL source.
2. To the right of the File 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 within the source includes references to copy files, to the right of the Source/Copy Path field, click (Select file to import) and select the folder(s) in which the copy files reside.
  Note: If you are having issues with the import, you may be requested to perform it with Keep Temporary Files after Import selected, which retains the temporary files created during the import process; SupportLine can use the .lst and .err.xml temporary files to help troubleshoot import issues.
Import from an RM/COBOL object (.cob) file:
Prerequisite: The object file must have been compiled with at least the Y (or Y=1) compiler option.
1. In the Import FDs From field, select Existing COB 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 .cob file.
Import from an Relativity Symbol Table (.rst) file:
1. In the Import FDs From field, select 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 an .rst file.

Click Read File and Record Descriptions.

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 extractor process.

In the Items to Import tab, select the file definition(s) to import.

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.

Click Add to Catalog.

The selected file definitions are now displayed in the Catalog Explorer.