You can query the impact analysis data to determine which
source programs refer to specified external call symbols.
Before you begin
The
3 Symbol to find Source Query menu
item queries the impact analysis data using external symbols and returns
a list of source programs that use these symbols. To use this menu
item you need to specify the impact analysis data's high-level qualifier
(HLQ) since the HLQ is used in locating your project's impact analysis
data. You can obtain this information from the impact analysis administrator
who created and loaded the impact analysis data. For more information
on sharing source files for impact analysis, see
Sharing source files for impact analysis.
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.