To query or update data in a 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. Use the New VSAM Table wizard
to create the table and optionally the view.
Restrictions
You
can map to the following types of VSAM files:
- KSDS, ESDS, and RRDS files
- IAM files
About this task
For
more information about creating tables and views that map to VSAM files, see
the related links for VSAM syntax diagrams and for views.
Procedure
To create a VSAM table and optionally a view
for Classic federation:
- Map your VSAM file to a relational table and optionally a view
by using the New VSAM Table wizard.
- 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.
- Select the copybook or include file to base
the table on.
- Choose whether to use the table for queries, updates, or both.
- Choose whether to create a view on the table.
- Provide information about how to access the VSAM file.
- Select the elements that you want to map to columns in your
relational table.
- 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, the view also appears under the selected schema.
- Optional: Modify the table properties or add privileges.
Select the table and make any changes in the Properties view.
- Optional: Create one or more indexes on the table. See Creating indexes.
- 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.
- Right-click the table and select Generate DDL.
- In the Generate DDL wizard, follow these steps:
- Choose to generate CREATE statements.
- Choose to generate DDL for tables. You can also choose to generate DDL
for indexes.
- Name the file in which to save the DDL within your project.
- 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.
- Choose whether you want to open the DDL for editing.
- Optional: If you ran the DDL successfully on a data
server, you can validate the table 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.
- 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.
- Right-click the table and select Data > Sample
Contents.
- Check the Data Output view to find out whether the test query
ran successfully.
- 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.
- Right-click the view and select Generate DDL.
- In the Generate DDL wizard, follow these steps:
- Choose to generate CREATE and ALTER statements.
- Choose to generate DDL for views.
- Name the file in which to save the DDL within your project.
- 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.
- Choose whether to open the DDL for editing.
- 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.
- 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.
- Right-click the view and select Data > Sample
Contents.
- Check the Data Output view to determine whether the test query
ran successfully.