Importing data structures by using IBM Rational Asset Analyzer
You can import data structures into multiple DBD segments in your IMS™ Explorer project all at once through IBM® Rational® Asset Analyzer (RAA®).
Before you begin
Procedure
To import data structures:
- From the Project
Explorer, open the Import
Data Structures Manager by clicking the
ImportDataStructuresManager.wfm file. Select the RAA server and Site ID and then, click
Discover Data Structure Associations. After the discovery of the data structure associations begins, you can pause the process by
clicking Pause Data Structure Association Discovery.
The discovery process goes through each segment within each DBD one at a time. One of the following states is assigned to each DBD or segment:
Option Description Data Structure Associations Not Discovered This state is the initial state for a DBD before the data structure association discovery occurs. Import in Progress For a DBD with this state, the data structure associations were identified. Expand the DBD to view the individual segments to see which segments need additional work to complete the data structure import. For any segments that have a state that is listed as No Data Structure Found or Multiple Data Structures Found, identify the appropriate data structure. After all of the segments say Data Structure Selected, the DBD state is automatically updated to Import Complete. Data Structure Selected For a segment with this state, no additional work is needed before testing. However, if the data structure has what appears to be a control field, you might want to look at the application source code to verify whether the application is remapping the I/O area with other data structures depending on the control field values. If you are remapping the I/O area, create a segment mapping and select the appropriate data structure for each map case of the segment.
No Data Structure Found For a segment with this state, right-click on the segment name and select Import COBOL or PL/I data structures. Refer to the instructions in Importing data structures into a single DBD segment to import the data structure. Multiple Data Structures Found For a segment with this state, right-click and select Preview and select data structures. Select one of the data structures, and click Select. After you select the data structure, the state changes to Data Structure Selected.
Important: If the segment has map cases, the state will not change to Data Structure Selected until you specify a data structure for each map case. If you need to add or edit a map case, right-click the segment name and select Add or edit segment map. Refer to the instructions in Defining alternative field maps for a segment.Import Complete For a DBD with this state, the data structure associations were identified and imported. After all of the segments within the DBD are changed to Data Structure Selected, the DBD state is automatically updated to Import Complete.
- Test the local copy of the updated DBD metadata. In the Data Source Explorer, create a new IMS connection and select Local IMS Explorer project as your metadata source. Then, create a query to test the metadata. After the metadata is sufficiently tested, change the state to Tested with Local Metadata.
- After testing is complete, publish the consolidated metadata.
- For information about publishing the metadata to an IMS catalog, see Publishing consolidated metadata to an IMS catalog.
- For information about publishing the metadata to a local file, see Publishing consolidated metadata to an IMS catalog.
What to do next
- Connecting to an RAA server
You can create a connection to an IBM Rational Asset Analyzer (RAA) server. Use the RAA server connection to import multiple IMS resources at one time.
© Copyright IBM Corporation 2010, 2017.