Table of Contents

Search

  1. Preface
  2. PowerExchange Navigator Introduction
  3. Data Maps
  4. Data Maps for Specific Data Sources
  5. Copybooks
  6. Registration Groups and Capture Registrations
  7. Extraction Groups and Extraction Maps
  8. Personal Metadata
  9. Database Row Test
  10. PowerExchange Navigator Examples
  11. Appendix A: PowerExchange Functions for User-Defined Fields
  12. Appendix B: User Access Method Programs
  13. Appendix C: Application Groups and Applications
  14. Appendix D: Data Map Properties
  15. Appendix E: Record, Field, and Table Properties
  16. Appendix F: DTL__CAPXTIMESTAMP Time Stamps
  17. Appendix G: Trace for Creating a Memory Map When Importing a COBOL Copybook

Navigator User Guide

Navigator User Guide

Importing a Copybook into a Record or a Segment

Importing a Copybook into a Record or a Segment

Import one or more copybooks into a record or segment to add data definitions to the record or segment.
After you import a DBD into an IMS data map, import a COBOL copybook into each segment in the data map to overlay each segment with its COPYLIB. This action redefines the data map while maintaining the hierarchical metadata information for the IMS database.
  1. Open the data map.
  2. On the
    Data Map
    tab in the
    Resource Explorer
    , select a record or a segment.
  3. Click
    File
    Import Copybook
    .
  4. In the
    Import Copybook - Source Details
    dialog box, enter information about the location and type of copybook to import.
    For some copybook types, you must enter additional information.
    For an IMS data map, import a DBD copybook. Then, import a COBOL or
    PL/I
    copybook into each segment in the data map.
  5. Click
    Next
    .
  6. Based on whether you chose a remote or local copybook location, enter information about the copybook in one of the following dialog boxes:
    If security is enabled on
    z/OS
    , enter a user ID and password.
  7. Click
    Next
    .
  8. In the
    Import Copybook - Configuration Details
    dialog box, select the actions for imported records or segments, fields, and tables, and click
    Finish
    . For more information, see Import Copybook - Configuration Details Dialog Box.
  9. 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
  10. Click
    OK
    .
  11. 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.
  12. Click
    OK
    .
  13. If the copybook contains REDEFINES statements, a
    Copybook Redefines
    window notifies you that the copybook contains REDEFINES statements.
    Complete the following steps:
    1. To point to the line that contains the correct field, click
      Redefinition
      Next
      or
      Redefinition
      Previous
      .
    2. Click
      Import
      Resume
      .
  14. 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.
  15. Close the
    Import
    window.
  16. 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.

0 COMMENTS

We’d like to hear from you!