WebSphere logo Classic Federation Server for z/OS, Version 9.1
WebSphere logo Classic Replication Server for z/OS, Version 9.1
WebSphere logo Classic Data Event Publisher for z/OS, Version 9.1
WebSphere logo Data Integration Classic Connector for z/OS, Version 9.1


Creating native VSAM tables and views for change capture

To capture changes that are made to a native VSAM file, you must create a relational table that maps to that file. You can also create a view on the table to filter record types or to filter rows and columns.

Before you begin

Restrictions

The VSAM files that you map to must correspond to a cluster for an ESDS, KSDS, or RRDS data set.

The VSAM files that you map to must not be under RLS (record-level sharing) or TVS control.

Procedure

To create a VSAM table and optionally a view for change capture:

  1. Map your VSAM file to a relational table and optionally a view by using the New VSAM Table wizard.
    1. Open this wizard by right-clicking either the database in your data design project or one of the schemas within the database. Select Add Classic Object > VSAM table.
    2. Select the copybook or include file to base the table on.
    3. Choose to use the table for change capture.
    4. Choose whether to create a view on the table.
    5. Provide information about how to access the VSAM file.
    6. Provide the URL of a Cross Memory (XM) queue. The URL consists of these values:
      • The first four characters of the name of the data space for the queue.
      • The first four characters of the name of the queue. The change-capture agent that is capturing changes to the native VSAM table writes change data to this XM queue.

      The format of the XM URL is XM1/name_of_data_space/name_of_queue

    7. Select the elements to map to columns in your relational table.
    8. If you are creating a view, specify the criteria for the WHERE clause.
    When you finish the wizard, the new table appears under the selected schema. If you created a view, it also appears under the selected schema.
  2. Optional: Modify the table properties or add privileges. Select the table and make any changes in the Properties view.
  3. Optional: Generate the DDL for the table. You can generate the DDL later, if you do not want to generate it now. You can also generate the DDL for all of the objects within the same schema. See Generating DDL.
    1. Right-click the table and select Generate DDL.
    2. In the Generate DDL wizard, follow these steps:
      1. Choose to generate CREATE statements.
      2. Choose to generate DDL for tables. You can also choose to generate DDL for indexes.
      3. Name the file in which to save the DDL within your project.
      4. Choose whether to run the DDL on a data server. After you run the DDL, check the Data Output view to determine whether the DDL ran successfully.
      5. Choose whether to open the DDL for editing.
  4. Optional: If you ran the DDL successfully on a data server, validate the table by running a test query against your VSAM file. Ensure that the data server is connected to the system where the file is located.
    1. In the Database Explorer, search your data server for the schema that you created the table in. Expand the schema and expand the Tables folder.
    2. Right-click the table and select Data > Sample Contents.
    3. Check the Data Output view to determine whether the test query ran successfully.
  5. Optional: If you created a view, generate the DDL for the view. You can generate the DDL later. You can also generate the DDL for all of the objects within the same schema. See Generating DDL.
    1. Right-click the view and select Generate DDL.
    2. In the Generate DDL wizard, follow these steps:
      1. Choose to generate CREATE and ALTER statements.
      2. Choose to generate DDL for views.
      3. Name the file in which to save the DDL within your project.
      4. Choose whether to run the DDL on a data server. After you run the DDL, check the Data Output view to find out whether the DDL ran successfully.
      5. Choose whether to open the DDL for editing.
  6. Optional: If you ran the DDL successfully on a data server, validate the view by running a test query against your VSAM file. Be sure that the data server is connected to the system where the file is located.
    1. In the Database Explorer, search your data server for the schema that you created the view in. Expand the schema and expand the Views folder.
    2. Right-click the view and select Data > Sample Contents.
    3. Check the Data Output view to determine whether the test query ran successfully.
Related concepts
Mapping data for change capture
Creating views on existing tables
Related tasks
Creating Adabas tables and views for change capture
Creating CA-IDMS tables and views for change capture
Creating CICS VSAM tables and views for change capture
Creating IMS tables and views for change capture
Altering tables to support change capture
Altering views to support change capture
Related information
Views


Feedback

Update icon Last updated: 2007-07-11