Navigator User Guide

10.5.4
- 10.5.6
- 10.5.5
- 10.5.3
- 10.5.2
- 10.5.1
- 10.5
- 10.4.1
- 10.4.0 HotFix 1
- 10.4.0

Back Next

Importing a Copybook into a Data Map

You can import a copybook when you add a data map or after you add it.

If you plan to import a COBOL copybook, you can run a trace at import time that provides an enhanced memory map, which is useful for troubleshooting mapping errors and other purposes. For more information, see Appendix G: Trace for Creating a Memory Map When Importing a COBOL Copybook.

Complete one of the following steps depending on whether you are importing a copybook into an existing data map or adding a data map:

For an existing data map, open the data map and click

File

Import Copybook

If you are adding a data map, select the

Import Record Definitions

check box in the

Name

dialog box.

Then, click

. Enter information in the

Access Method

dialog box, and click

Finish

The

Import Copybook - Source Details

dialog box appears.

In the

Import Copybook - Source Details

dialog box, enter information about the location and type of copybook that you want to import.

For some copybook types, you must enter additional information.

For more information, see Import Copybook - Source Details Dialog Box.

For an IMS data map, import a DBD copybook. Then, import a COBOL or

PL/I

copybook into each segment in the data map.

To display information about the last import operation, click

Last Import

The

Import Copybook Information

window displays the following information about the last copybook import operation:

Whether the copybook was imported from the local or a remote system

The name and type of the copybook

The default actions defined for imported records, fields, and tables

To close the dialog box, click

Cancel

Click

Based on whether you specified a remote or local copybook location, enter information about the copybook in one of the following dialog boxes for the data source type:

Import Copybook - Remote Details

dialog box. For more information, see Import Copybook - Remote Details Dialog Box.

Import Copybook - Local Details

dialog box. For more information, see Import Copybook - Local Details Dialog Box.

Click

In the

Import Copybook - Configuration Details

dialog box, select options to define the default actions to take for imported records, fields, and tables.

For more information, see Import Copybook - Configuration Details Dialog Box.

If you are importing a COBOL copybook, enter field property details in the

Import Copybook - Field Property Details

dialog box.

For more information, see Import Copybook - Field Property Details Dialog Box.

Click

Finish

In the

Import Copybook Information

window, review the information for the import operation.

The

Import Copybook Information

window displays the following information:

Whether PowerExchange imports the copybook from the local or a remote system

The name and type of the copybook

The default actions defined for imported records, fields, and tables

Click

In the

Record Definition

dialog box, select an action for each imported record or segment.

If the copybook contains a record or field that duplicates a record or field in the data map, the

Duplicate Record Definition

dialog box appears. In the

Duplicate Record Definition

dialog box, you can select options to indicate how to handle the duplicate item. For example, you can choose to import, overwrite, or skip the item, or stop the import.

For more information, see Record Definition and Duplicate Record Definition Dialog Boxes.

Click

If the copybook contains REDEFINES statements, a

Copybook Redefines

window notifies you that the copybook contains REDEFINES statements.

Complete the following steps:

To point to the line that contains the correct field, click

Redefinition

Click

Import

Resume

The

Import

window displays the imported copybook.

The

Copybook Message Log

window displays the results of the import operation.

If an error message appears in the

Copybook Message Log

window, double-click the message to find the associated line in the copybook.

Close the

Import

window.

If you chose to overwrite a duplicate record or field in a data map, complete the following actions:

On the

Data Map

tab in the

Resource Explorer

, right-click the table that contains columns that are based on the updated record or field and click

Properties

In the

Record Dependencies

list in the

Table Properties

dialog box, select the table.

In the

Column Generation

list, select

Refresh with missing columns

Run a database row test on the table.

Based on the data source type for the data map and the type of copybook that you imported, you might need to complete one of the following tasks:

If you imported a COBOL or PL/I copybook into an Adabas data map, edit the data map to associate the imported field definitions with Adabas field definitions. For information, see Viewing or Editing Properties for a Data Map Table.

If you imported a DBD source into an IMS data map, import a COBOL or

PL/I

copybook into each segment in the data map. For more information, see Importing a Copybook into a Record or a Segment.

If you imported a DDM copybook with fields defined with wide character datatypes into an

Adabas for z/OS

data map, PowerExchange does not select the

Wide Char

option on the

Code Page

tab in the

Field Properties

dialog box.

To set the

Wide Char

option for fields defined with the wide character datatype, complete one of the following tasks:

Import a PREDICT or FDT copybook.

Edit field properties in the data map.

Copybooks

Import Copybook - Local Details Dialog Box

Import Copybook - Local DB2 Catalog Details Dialog Box

Import Copybook - Remote Details Dialog Box

Import Copybook - Remote Datacom Details Dialog Box

Import Copybook - Remote DB2 Catalog Details Dialog Box

Download Guide

Watch

Comments

Communities

Knowledge Base

Success Portal

0 COMMENTS

We’d like to hear from you! Log in to comment.

Rename Saved Search

Table of Contents

Navigator User Guide

Navigator User Guide

Importing a Copybook into a Data Map

Importing a Copybook into a Data Map