Create a Map Using a COBOL Copybook

Edit online

About this task

Each map has two sides. Each side represents a data format; the input side is what you are translating from and the output side is what you are translating to. Each data format has specific map components.

Note: If an error occurs while you are creating a map, you need to check your COBOL copybook for errors.

To create a map:

Procedure

  1. From the File menu, select New.
  2. In the New Map wizard, answer the following questions and then click Next.
    • What kind of map are you creating?

      Accept the default, Sterling B2B Integrator

      Caution: Always accept the Sterling B2B Integrator default when you are using the application product.

      Note: The other map options enable you to import maps from other IBM® products in order to convert them to Sterling B2B Integrator-type maps.
    • What is the name of the map?

      Type the unique name of the map. The Sterling B2B Integrator Map Editor adds the default .mxl extension.

    • What is your name?

      Type your name if it differs from the user name prompted by the New Map wizard. The New Map wizard displays Input Format fields. You must complete the format of the input side of the map. This is the format of the data that is translated by the translator.

  3. In the Input Format window, specify how you want to define the data format by selecting one of the following:
    • Create a new data format using this syntax

      Select a format. If you are converting a COBOL copybook for the input side of the map, select the Positional format and click Customize.

    • Load the data format from a saved definition

      Type the path and file name of the saved definition (.ddf or .ifd extension).

      Click Browse to display the Open File Definition dialog box.

      Note: During the conversion process, if the wizard encounters any REDEFINE statements, you are notified that redefine statements are present in the converted copybook file. Additionally, you are notified if the wizard encounters any unsupported data types (such as exponential numbers or binary data).
  4. If you are converting a COBOL copybook for the input side of the map, select the name of the COBOL copybook file (using Browse) or type a URL pointing to the file and click Next.
  5. Click Finish.
  6. In the Output Format window, specify how you want to define the data format by selecting one of the following:
    • Create a new data format using this syntax

      Select a format. If you are converting a COBOL copybook for the output side of the map, select the Positional format and click Customize.

    • Load the data format from a saved definition

      Type the path and file name of the saved definition (.ddf or .ifd extension).

      Click Browse to display the Open File Definition dialog box.

      Note: During the conversion process, if the wizard encounters any REDEFINE statements, you are notified that redefine statements are present in the converted copybook file. Additionally, you are notified if the wizard encounters any unsupported data types (such as exponential numbers or binary data).
  7. If you are converting a COBOL copybook for the output side of the map, select the name of the COBOL copybook file (using Browse) or type a URL pointing to the file and click Next.
  8. Click Finish.
  9. Click Finish to create the map. The map opens in the Sterling B2B Integrator Map Editor window.
    Note: If the map contains REDEFINE statements, a message box is displayed noting that the REDEFINES statements present in the file, [filename], are converted but will require manual attention when the new map wizard is complete.
  10. In the Sterling B2B Integrator Map Editor, select File > Save to save the map. Do not use spaces or apostrophes in the map name. To save a map as a .map file, select File > Save As and then select Source Maps (*.map) from the Save as type list.