Submitting a query for finding sources
You can query the impact analysis data to determine which source programs refer to specified external call symbols.
Before you begin
Procedure
To submit a query for finding sources, do these steps:
- On the option line of the TSO Client Main Menu, type 7 and
press Enter.The Impact Analysis panel opens.
- On the Impact Analysis panel, type
the following information and then press Enter.
- Option field: Type 3.
- IA HLQ field: Type the high-level qualifier(s) for the impact analysis data to be used for the query. The initial value for this field is IAADMIN.PROJECT.Dyymmdd. You can obtain the correct value for this field from the impact analysis administrator who created and loaded the impact analysis data.
The Symbol to find Source Query panel opens. - In the Symbol field, type the name
of an external call symbol to use for the query.The value you enter cannot exceed eight characters. You can use the following prefix commands in the entry field beside the Symbol entry field to construct your query:
- I - Inserts a new row for entering a symbol. You can include a number with this command, such as I2, for example, to insert multiple rows. The rows are inserted below the row on which the prefix command is entered.
- D - Deletes a row. You can include a number with this command, such as D2, for example, to delete multiple rows.
- If you have created more Symbol rows
than can be displayed on one page, you can enter the following commands
on the Option field to scroll the data:
- top - Displays the top part of the data table.
- bottom - Displays the bottom part of the data table.
- forward - Moves the data table down by the current scroll amount. If the scroll amount is set to PAGE, for example, forward moves the table down one full screen.
- back - Moves the data table up by the current scroll amount. If the scroll amount is set to PAGE, for example, back moves the table up one full screen.
- After you have entered all symbol names to search, press Enter.
The panel is processed. The prefix commands are processed first and then the Option commands. Any data entered on the screen is converted to upper case. If the Symbol field is empty, the cursor will be positioned to the empty row and a message prompts you to supply a value.
- To execute the query, complete all required fields and
press Enter.The Result - Symbol to find Source Query panel opens with a list of query results. You can use the Option commands listed in step 4 to scroll through the result data. These results show source programs that use the symbols specified in your query. A source that contains the definition of any of the specified callable external symbols is indicated by an asterisk (*) in the D column. All items that are not so marked contain an invocation to the external symbol.Restriction: Queries for external call sources and symbols can help show possible relationships only. All current impact analysis information is derived from the compiler—not the linker. The linker is the final arbiter in determining relationships between invoking and invoked modules. If different versions of the same code are compiled and the results of these compilations captured in your impact analysis data, then the information from queries may show more than one source that contains the definition of an external symbol, or the place where the module is coded.