Running the COBOL Copybook (Deprecated) Importer

About this task

Use the COBOL Copybook (Deprecated) Importer to automatically generate COBOL Copybook type trees.

The metadata for the type trees is in the form of COBOL copybooks.

If you are running the COBOL Copybook (Deprecated) Importer to generate a type tree that is used with the CICS Adapter, you must select the Customer Information Control System (CICS) option. The option is in the window where you select byte and character sets.

The following procedure describes how to use the COBOL Copybook (Deprecated) Importer Wizard to generate a type tree from COBOL copybooks.

There is an example of a COBOL Copybook file in the install_dir\examples\general\copybook folder.

To run the COBOL Copybook (Deprecated) Importer:

Procedure

Access the Importer Wizard in the Design Studio application.
In the Import window, expand the Transformation Extender folder, select COBOL Copybook (Deprecated) from the import source list, and click Next. The COBOL Copybook Importer window opens.
Enter or select the name of the metadata source file that you want to import, following the Importer Wizard instructions, and then click Next. The metadata source files have a default file extension of .cpy.
If you are importing metadata to generate a COBOL Copybook type tree, select a character set from the Character set for execution-time data list, and a byte order that is set from the Byte order for execution-time data list. The Generate tree for Customer Information Control System check box is disabled.
To generate a type tree that is used with the CICS Adapter, select the Generate tree for Customer Information Control System check box.
The Character set for execution-time data list and the Byte order for execution-time data list are disabled.
The importer operation generates the type tree with the following parameters:
- Character data set is EBCDIC
- Byte order is Big Endian
- Standard header information is added to the type tree
Click Next.
Enter or select the parent folder of the generated type tree.
For File name, do one of the following choices:
- To create a type tree file, enter a new name.
- To overwrite an existing type tree file, enter its name if it does not already display in the field.
The default name for the type tree is the COBOL Copybook file name with the .mtt extension.
To generate the type tree, click Next.

If you selected a file name for an existing type tree file, you are prompted to continue or stop the import operation in the Overwrite Warning window.

After the import operation runs, it displays the run results in the COBOL Copybook Importer window. If errors or warnings, or both, occur, they display in that same window. The errors and warnings are also saved to error and log files in the product installation directory. The file names are Cpybkimp.err and cobol.log. You can open these files and analyze them in a text editor after the import operation completes. The import operation deletes and regenerates these log files every time a new COBOL Copybook is imported. If errors occur, the import operation cannot generate the type tree until you resolve the problem. If only warnings occur, the import operation can still generate the type tree. However, to ensure that the reported warnings do not interfere with the requirements necessary for a valid instance document, inspect the generated type tree.
After the type tree generation process is complete, click Finish.
If the type tree was generated, you are given the option to open the type tree in the Type Tree editor. The Properties view for the generated type tree contains the imported data format for the generated type tree. You can also click the type tree in the Extender Navigator view or the Navigator view to view the date and time that the import operation generated the type tree, under the Info property in the Properties view.