Viewing impact analysis results
Learn how to view the impact analysis results of your scan through the Wazi Analyze web user interface.
- View the impact analysis results for COBOL, PL/I, Assembler, C, or JCL
- Viewing impact analysis results from an Application Discovery data provider
- Viewing relationships between system artifacts from a z/OS Discovery Library Adapter data services data provider
- Correlating static analysis to runtime artifacts
View the impact analysis results for COBOL, PL/I, Assembler, C, or JCL
- For COBOL, PL/I, and Assembler:
- Program call references that display the call relationship between programs.
- Source file references that display the relationship between files and included files.
- For C:
- Function call references that display the call relationship between programs.
- Source file references that display the relationship between files and included files.
- For JCL:
- Job call graph that displays the relationship between jobs, job steps, and file references.
- Source file references that display the relationship between the selected JCL file and referred JCL procedures.
- Open the browser and navigate to https://localhost:5000. The Wazi Analyze "Log in" dialog is displayed.
- Enter the password that you provided to log in to Wazi Analyze. For more information, see Starting up and shutting down the server.
- Optional: Select a Wazi Analyze data provider on the data provider page. The data provider is only shown as a landing page if you have set up more than one data provider in your Wazi Analyze container.
- Select a workspace that you want to view impact analysis for from the Workspaces screen.Notes:
- If you have only one workspace and one data provider in your Wazi Analyze container, you do not need to select a workspace to get started. The analysis page of that workspace is shown by default.
- Wazi Analyze does not persist the workspace selection. You need to select a workspace each time you log in to the system.
- The workspace name corresponds to the project name that you created in the Wazi Analyze container.
- Search for a program name, a function name, a file name, or a job name that
you want to see the impact analysis for.Notes:
- Wazi Analyze supports wildcard search. You can use the '*' (asterisk) symbol or the '?'
(question mark) symbol as part of a search string. Check Wazi Analyze's search behaviors in the
following list.
- When the '*' is part of the search string, Wazi Analyze replaces the asterisk symbol with one or
more characters. For example, the 'AB*AB' search string returns all the
programs or files that start and end with
AB
. - When the '?' is part of the search string, Wazi Analyze replaces the question mark symbol with
one character. For example, the 'AB??AB' search string returns all the
programs or files that start with
AB
, end withAB
, and have any 2 characters in the middle. - When users select the search box, Wazi Analyze performs the search as the users search for the '*'. All the program and files are returned.
- For a search string that ends without a blank, Wazi Analyze performs the search by appending the
'*' at the end of search string. For example, the 'AB' search string returns
all the programs or files that start with
AB
. - For a search string that ends with a blank, Wazi Analyze performs the exact search without the
blank. For example, the 'AB ' search string, which ends with a blank, returns
a program and a file named
AB
.
- When the '*' is part of the search string, Wazi Analyze replaces the asterisk symbol with one or
more characters. For example, the 'AB*AB' search string returns all the
programs or files that start and end with
- By default, the search results are limited to 1000 items. This limit can be changed based on your preference. For more information, see Changing user preferences.
- Wazi Analyze supports wildcard search. You can use the '*' (asterisk) symbol or the '?'
(question mark) symbol as part of a search string. Check Wazi Analyze's search behaviors in the
following list.
- Optional: Select an artifact type under the Artifact type drop-down list to reduce the search results to a specific artifact type. You will see the number of artifacts found in the parentheses after each artifact type.
- Select the program, function, file, or JCL job that you want to see the impact analysis for from
the list of search results. The impact analysis graph is displayed.
- A program call graph is displayed if you select a program name.Notes:
- A program call graph is only for COBOL, PL/I, and Assembler languages.
- If there is a node that is displayed as a JCL program, this is the case when a program gets a JCL file as a source because a Job links to a Program that links to a source file and a module.
- Observe any node with Missing entry point status on the top, which indicates that the entry point is missing from the scanned source files. You can select the status to view a full report.
- When you select a program, you might see a status decorator on top of the program node that you searched for. The status decorator indicates that the same program is possibly in the system workspace of z/OS® Discovery Library Adapter (z/OS DLA) data provider. You can select the link on the status decorator to navigate to the system workspace that contains the same program. The information is available only when the z/OS DLA data provider is configured.
- A function call graph is displayed if you select a function name.Notes:
- A function call graph is only for C language.
- For the COBOL language, you can see the Functions search in the Artifact type list. The functions represent paragraphs in COBOL language. You can search for a paragraph but you will not see any associated graph or properties.
- A source file relationship graph is displayed if you select a file name. Note: Observe any node with Missing entry point status on the top, which indicates that the entry point is missing from the scanned source files. You can select the status to view a full report.
- A Job call graph displays if you select a job name.
Note: The number of relationships in the graph is limited to 99. - A program call graph is displayed if you select a program name.
- Select a node on the graph to see the properties of the selected node. The following details are displayed.
- type
- The artifact type of the selected node.
- displayName
- The name of the selected node.
- srctype
- The source type of the selected node.
- Incoming references / Includes
-
- For programs: The list of programs that call or link to the selected node with the number of its references.
- For files: The list of files that include the selected node with the number of its references.
- Outgoing reference / Included by
-
- For programs: The list of programs that are called or linked by the selected node with the number of its references.
- For files: The list of files that are included by the selected node with the number of its references.
- Data Definitions
- For batch job steps: The list of external references and their values, which are executed by the job step.
Note: When you see the node as the Unknown type or language, it could be because this program or file is referenced by the other program or file that is displayed on the graph but the actual file is not included in the scanned source files. For example, in the following graph, HBRDISC is the Unknown type and language because no actual program or file is in the scanned source files but it is referred by LGAPBR01. - Select the Action Menu icon (
) on the upper right of the node to view the actions on the selected node.
- Select Preview source content to view the content of the source file for
the selected node. If the selected node is a "Program", the Preview source
content action will result in a view of the program "logical entity" (the program
statements and all copybooks used, that is, everything that is needed for compilation).Notes:
- For the COBOL and Assembler languages, if you cannot see the comment lines in the source content
that is displayed, you might need to check the scan options in the configuration file and make sure
that the
OPTION_WITHCOMMENT
is enabled. For more information, see Understanding the scan options in the configuration file. - For COBOL programs, the
END-EXEC
statement line is not displayed in the Preview source content view.
- For the COBOL and Assembler languages, if you cannot see the comment lines in the source content
that is displayed, you might need to check the scan options in the configuration file and make sure
that the
- Select View source file references to view the relationship graph of the
source files for the selected node.Note: For the C language, you cannot view source file references from the Action Menu of a node in the function call graph. If you want to view the source file references of a node, you will need to search for the file which contains that function.
- Select View program call references to view a program call graph of the selected node.
- Select Preview source content to view the content of the source file for
the selected node. If the selected node is a "Program", the Preview source
content action will result in a view of the program "logical entity" (the program
statements and all copybooks used, that is, everything that is needed for compilation).
- Select the + and - icons of the
Depth field (
) to adjust the number of relationship depth that is displayed on the graph.
- Select the Graph view icon (
) and Table view icon (
) on the upper right header to switch between the graph view and table view.
- Select the History icon (
) to view the previous items that you were looking at.
- Select the Filter icon (
) to select the artifact type to display in the graph or table.
Notes:- When you select the filter, the graph is updated as a preview. You need to select Apply filter to apply filter to the graph.
- When you apply the filter, you will see a blue dot on the Filter icon indicating that the filter is applied.
Viewing impact analysis results from an Application Discovery data provider
Learn how to view the impact analysis results from an Application Discovery (AD) data provider through the Wazi Analyze web user interface.
Prerequisite:
The AD data provider needs to be configured. For more information about setting up an AD data provider, see Configuring additional data providers.
- When an AD data provider is configured, projects that are created by Wazi Analyze will not be displayed.
- When an AD data provider is used, you must log in to Wazi Analyze with the AD username and password instead of the Wazi Analyze password. However, you still need to provide the Wazi Analyze password during the Wazi Analyze startup process.
- Open the browser and navigate to https://localhost:5000. The Wazi Analyze "Log in" dialog is displayed.
- Enter the AD username and password to log in.
- Select a workspace that you want to view impact analysis for from the Workspaces screen.
- Search for a program name, a file name or a job name that you want to see the impact analysis for.
- Select the program, file, or JCL job that you want to see the impact analysis for from the list
of search results. The impact analysis graph is displayed.
- A program call graph is displayed if you select a program name.
- A source file relationship graph is displayed if you select a file name.
- A job call graph is displayed if you select a job name.
Note: The number of relationships in the graph is limited to 99. - Select a node on the graph to see the properties of the selected node. The following details are displayed.
- type
- The artifact type of the selected node.
- displayName
- The name of the selected node.
- srctype
- The source type of the selected node.
- Incoming references / Includes
-
- For programs: The list of programs that call or link to the selected node with the number of its references.
- For files: The list of files that include the selected node with the number of its references.
- Outgoing reference / Included by
-
- For programs: The list of programs that are called or linked by the selected node with the number of its references.
- For files: The list of files that are included by the selected node with the number of its references.
- Data Definitions
- For batch job steps: The list of external reference and its value, which are executed by the job step.
- Select the Action Menu icon (
) on the upper right of the node to view the actions on the selected node.
- Select View source file references to view the relationship graph of the source files for the selected node.
- Select View program call references to view a program call graph of the selected node.
- Select the + and - icons of the
Depth field (
) to adjust the number of relationship depth that is displayed on the graph.
- Select the Graph view icon (
) and Table view icon (
) on the upper right header to switch between the graph view and table view.
- Select the History icon (
) to view the previous items that you were looking at.
- Select the Filter icon (
) to select the artifact type to display in the graph or table.
Viewing relationships between system artifacts from a z/OS Discovery Library Adapter data services data provider
Learn how to view the relationships of system artifacts from a z/OS Discovery Library Adapter (z/OS DLA) data services data provider through the Wazi Analyze web user interface.
Prerequisite:
The z/OS DLA data services data provider needs to be configured. For more information about setting up z/OS DLA data services data provider, see Configuring additional data providers.
- Open the browser and navigate to https://localhost:5000. The Wazi Analyze "Log in" dialog is displayed.
- Enter the password that you provided to log in to Wazi Analyze. For more information, see Starting up and shutting down the server.
- Select a z/OS DLA data provider that you want to view from the Data providers page.Notes:
- If you have only one workspace for z/OS DLA, the workspace is selected by default. This step will be skipped.
- Wazi Analyze does not persist the workspace selection. You need to select a workspace each time you log in to the system.
- Type an artifact name or part of the name to search for a system artifact that you want to view
the relationship graph. You can select the type of artifacts from the All artifact
types drop-down list to filter only type of artifacts that you are searching for. Notes:
- You can use wildcard such as an asterisk (*) or a question mark (?) as well as simple regular expression within a search string.
- Search results show a list of artifact names. Since within a system it can contain artifacts with the same name, you might see duplicate names in the result list.
- Displaying the search results might take a few seconds to minutes depending on the number of artifacts within the system.
- Select a node on the graph to see the detailed information of the selected node on the
Properties pane.Notes:
- Some nodes could have a layered outline, which indicates that multiple nodes are represented as a single node. The multiple nodes grouping is a grouping of artifacts of the same type that have the same relationship with the node that they are connected from. The multiple nodes grouping is displayed in the graph when there are more than 100 artifacts represented as nodes in the graph. Then, the artifacts with the same relationship type to the previous artifact will be grouped as a single node to make it easier for users to view the graph.
- You can click on the multiple nodes grouping to expand and see the additional nodes. When the
multiple nodes grouping is expanded, you can search for a specific node in the search box on the top
of the multiple nodes grouping. To hide all the expanded nodes, click the
Unexpand icon (
).
- Select the Action Menu icon (
) on the upper right of the node to view the actions on the selected node.
- Select the Add to manifest radio button on the lower right of the node to
select the node and all the related nodes from both forward and backward relationships in the entire
system (even nodes not shown in the current graph) to
manifest.yaml
file to be exported.Note: Wazi Analyze automatically selects all the related nodes at the 99th depth for both forward and backward path. - Select the + and - icons of the
Depth field (
) to adjust the number of relationship depth that is displayed on the graph.
- Select the Graph view icon (
) and Table view icon (
) on the upper right header to switch between the graph view and table view.
- Select the History icon (
) to view the previous items that you were looking at.
- Select the Filter icon (
) to select the artifact type to display in the graph or table.
Correlating static analysis to runtime artifacts
Learn how to correlate program artifacts from Wazi Analyze static analysis data to runtime artifacts from z/OS DLA data.
Prerequisite:
The z/OS DLA data services data provider needs to be configured first. For more information, see the Configuring a z/OS Discovery Library Adapter data services data provider section.
- Open the browser and navigate to https://localhost:5000. The Wazi Analyze "Log in" dialog is displayed.
- Enter the password that you provided to log in to Wazi Analyze. For more information, see Starting up and shutting down the server.
- Optional: Select a Wazi Analyze data provider on the data provider page. The data provider is only shown as a landing page if you have set up more than one data provider in your Wazi Analyze container.
- Select a workspace that you want to view impact analysis for from the Workspaces screen.
- Search for a program name that you want to see the impact analysis with correlated z/OS DLA runtime data for.
- Optional: Select an artifact type under the Artifact type drop-down list to reduce the search results to a specific artifact type. You will see the number of artifacts found in the parentheses after each artifact type.
- Select the program that you want to see the impact analysis with correlated z/OS DLA runtime data for from the list of search results. The impact analysis graph is displayed.
- Observe if a status decorator is available on top of that selected program node. The status decorator indicates that the same program is possibly in the system workspace of z/OS DLA data provider.
- Hover the mouse point over the link on the status decorator to go to the z/OS DLA workspace that contains the same program.
- Search for the same program name to view the system relationship graph. The search box is pre-filled with the program name to search for.
What to do next
Now you have completed the necessary tasks to get started with Wazi Analyze as described in Checklist for getting started. You can continue to check the rest of documentation and explore more with Wazi Analyze.