Running the COBOL Copybook Importer

Edit online

Use the COBOL Copybook Importer to automatically generate COBOL Copybook type trees.

About this task

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

If you are running the COBOL Copybook 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 Output File Location window.

The following procedure describes how to use the COBOL Copybook Importer Wizard to generate a type tree from COBOL copybooks. You specify the data in the COBOL Copybook Sources page, and the options and data structures in the Importer Options and Structure Selection page.

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

To run the COBOL Copybook Importer:

Procedure

  1. Access the Importer Wizard in the Design Studio application.
  2. In the Import window, expand the Transformation Extender folder, select COBOL Copybook from the import source list, and click Next. The Type Tree Importer window opens.
  3. If you are importing a single COBOL structure to generate a type tree, do the following steps:.
    1. In the COBOL Copybook Sources page, make sure that the Choose mapping field is set to Single COBOL Copybook to type tree. This selection is the default setting. If it is not selected, you can select Single COBOL Copybook to type tree from the Choose mapping list.
    2. Enter or select the name of the COBOL program or COBOL Copybook metadata source file that you want to import, in the COBOL file field.
      The COBOL Copybook Importer supports COBOL files with the following extensions: .cbl, .ccp, .cob, and .cpy. You can configure the type of support for each COBOL file extension, under Window > Preferences > Importer > COBOL > More COBOL options > File Extension Support. You can select to import the COBOL Copybook from a full program or from a data structure only. The metadata source files have a default file extension of .cpy.
    3. Click Next. The Importer Options and Structure Selection page opens.
    4. Follow the Importer Wizard instructions to select a communication data structure.
  4. If you are importing multiple COBOL structures to generate a single type tree, do the following steps:
    1. In the COBOL Copybook Sources page, select Multiple COBOL Copybooks to type tree from the Choose mapping list.
    2. Click Add, and then enter or select the name of the COBOL Copybook metadata source file that you want to import, in the COBOL file field.
    3. Click Next. The Importer Options and Structure Selection page opens.
    4. Follow the Importer Wizard instructions to select a communication data structure and then click Finish. The selected data structure displays in the Multiple possible output list.
    5. Repeat these steps as required. All of the selected data structures display in the Multiple possible output list.
  5. Click Next. The Output File Location page opens.
  6. Enter or select the Project, Folder, and File name.
  7. To generate a type tree that is used with the CICS Adapter, select the Generate type tree for Customer Information Control System check box.
  8. 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.