AD Module 2 Eclipse Navigation and Introduction To Call Graphs
AD Module 2 Eclipse Navigation and Introduction To Call Graphs
Module 2 –
Eclipse Navigation and
Mainframe Graphs
© 2019 IBM Corporation
1
Company Trademarks and Copyrights
© Copyright IBM Corporation 2018 through 2019.
All rights reserved – including the right to use these materials for instructional
purpose.
The information contained in these materials is provided for informational purposes only, and is
provided AS IS without warranty of any kind, express or implied. IBM shall not be responsible
for any damages arising out of the use of, or otherwise related to, these materials. Nothing
contained in these materials is intended to, nor shall have the effect of, creating any warranties
or representations from IBM or its suppliers or licensors, or altering the terms and conditions of
the applicable license agreement governing the use of IBM software. References in these
materials to IBM products, programs, or services do not imply that they will be available in all
countries in which IBM operates.
This information is based on current IBM product plans and strategy, which are subject to change
by IBM without notice. Product release dates and/or capabilities referenced in these materials
may change at any time at IBM’s sole discretion based on market opportunities or other factors,
and are not intended to be a commitment to future product or feature availability in any way.
IBM, the IBM logo, the on-demand business logo, Rational, the Rational logo, and other IBM
Rational products and services are trademarks or registered trademarks of the International
Business Machines Corporation, in the United States, other countries or both. Other company,
product, or service names may be trademarks or service marks of others.
This module contains Hands-On Workshops – which should be completed after you
have finished participating in the presentation/demo. To do the labs you will need
access to an AD Client and Server. Note that AD setup (installation/configuration) are
not part of the training. Ask your instructor for references to AD experts.
You will also need some level of IDz/Eclipse experience, in order to navigate and
manipulate (resize, maximize, etc.) the AD Views and tooling
Note:
• You may use an IBM zTrial virtual machine or your own AD server image loaded with
your own production code for these workshops.
• Because we have no idea what programs/files/etc. exist in your AD Projects – the
workshops can have been written as open-ended directions – which refer to the AD
Tooling you will learn – but not to specific files/DSNs
3
Topics in this module
After completing this module you will be able to:
Define eclipse terms and concepts
Launch AD and navigate within the product running under Eclipse
Describe the AD Graphs, Screen Layout and Explorer tools
Invoke the following tools from AD…………
Explorer
▪ List project artefacts by Resource Type
▪ Text search within selected Project(s)
Layouts
▪ BMS and MFS map layout (screen user view)
Mainframe Graphs
▪ Job triggers – defined in CA7
▪ Paths through Jobs – defined in CA7
▪ Value (data) movement shown from file to file
▪ (Traditional) program statement-level Flow Chart
▪ Display of program calls from JCL EXEC PGM=
▪ Display of all Steps in a Batch Job
▪ Mainframe system taxonomy
▪ What resources are affected by program logic?
▪ Paragraphs and SECTIONS within a program
▪ What resources interface with a screen?
▪ What resources are interact with a transaction? 4 4
4
UNIT AD Module 2
Topics:
▪ AD Navigation – a product walkthrough
▪ Labs & Module Review
5
Launch IBM Application Discovery using VM-Ware or IBM zTrial
You will start AD from: Windows > All Programs
Or you may have placed an icon to AD on your desktop/toolbar
Or you may be using a virtual machine (VM-Ware,Citrix, etc.)
Log in using credentials provided by your instructor
Workstation
Hard-drive
C:\ad_workspace
Drive:\workspace
Projects
Tools
Source Code views
Properties view
Outline view
Reports
AD Tools
Usage Analytics
(Metrics)
Source Files
Screen Layouts
AD Tool Categories
10
AD Tools and Project Workflow – Two Usage Scenarios
Understand
2. Use AD’s tools to research
Research
Search for something specific within an
application
11
Workflow – AD Project Selection
1.
2.
3.
Toolbar
Notes:
• Within this workflow – there are several refinements – depending on:
• Type of component that you’re studying
• Optional selections that you use to refine/customize the analyses
• This will not be the only workflow pattern we cover in the course
13
View Screen Layout – 1 of 2
▪ Click Finish
Screen Layout displays the 3270 UI
14 for a BMS Map or MFS Screen
View Screen Layout – 2 of 2
▪ This is how the
JKEMLIS screen
would look to users
▪ Notes:
Both BMS & MFS
maps are supported
If there are multiple
BMS Maps within a
Mapset, the name
displayed in the list on
the previous slide will
be:
MAPSETNAME – MAPNAME
15
Dataset Flow – 1 of 3
▪ Select the Project
Double-click Dataset Flow
17
Dataset Flow – 3 of 3 Additional views
Notes:
The AD Graph Overview view is used by
several tools to navigate through large
diagrams
The Graph Overview provides:
▪ Simplified navigation for complex
diagrams that consist of
dozens/hundreds of artifacts
▪ Zoom In/Zoom Out for large Graphs
18
Program Flow Chart – 1 of 2
▪ Select the Project
Double-click Flow Chart
▪ You will see a list of
Available Programs:
Assembler
COBOL
PL/I
20
Screen Callgraph – 1 of 2
You can:
▪ Filter the list by name
▪ Select one or more Programs
▪ Specify:
Call directions
Callgraph limits – or not
▪ Click Finish
Screen/Transaction/Program Callgraphs
all basically show the same information
from different starting points. This
screenshot also shows MQ Access here,
but could equally show File/database I/O. 22
Transaction Callgraph – 1 of 2
▪ Select the Project
Double-click Transaction Callgraph
You can:
▪ Filter the list by name
▪ Select one or more
Transactions
▪ Specify:
Call directions
Callgraph limits – or not
Transaction Callgraph – 2 of 2
The Transaction Callgraph shows detail about
selected Transaction(s) and interaction with: Online Program
Online
Files
Simple
Transaction
Callgraph
24
Program Callgraph – 1 of 3
▪ You will see a list of Available Programs in: COBOL, Assembler, or PL/I
You can:
▪ Filter the list by name
▪ Select one or more Programs
▪ Specify:
Call directions
Callgraph limits – or not
▪ Click Finish
26
Program Callgraph – 3 of 3 – Context Menu Options
While we have not covered Reports and other AD options – note that the
various Callgraphs provide the Context (Right-Mouse) menu access to
additional tools, reports, and the original (analysis) source file.
27
Graph Inventory – Context Menu Options
Related Points-of-Interest can be researched from the Context Menu within the Graph
Inventory. Flexible graphical tools/techniques such as this makes application research
far more effective than manual/TSO tools
28
Program Flow – 1 of 5
▪ Select the Project
Double-click Program Flow
▪ You will see a list of Available Programs in: COBOL, Assembler, or PL/I
You can:
Program ▪ Filter the list by
Type
Filters Name
Type (COBOL vs. PL/I)
▪ Select a Program
▪ Click Finish
Program Name Filter
Program Flow reveals a program’s
Procedural Logic semantics - at the
Paragraph/Section/PL1-PROC level
as well as displaying artefacts that
interact with the program.
29
Program Flow – 2 of 5
The Program Flow shows detail about selected programs:
Program I/O – Screens, Files, Databases & DB2 Tables, Message Queues
Subprograms – in COBOL, Assembler, PL/I
▪ Use the AD Graph Overview and the toolbar functionality to explore & navigate
Try Zoom In/Zoom-Out and different Diagram Modes
Paragraphs
Logic Flow
I/O and
Called
30 Programs
Program Flow – 3 of 5
This Program Flow shows detail about selected programs:
Program I/O – Screens, Files, Databases & DB2 Tables, Message Queues
Subprograms – in COBOL, Assembler, PL/I
Transaction interactions
▪ Use the AD Graph Overview and the toolbar functionality to explore & navigate
Try Zoom In/Zoom-Out and different Diagram Modes
Diagram Zoom In/Out Diagram “Mode”
31
Program Flow – 4 of 5
The Properties view updates dynamically, with whatever procedural element of
the graphical view you’ve selected. Calls, Performs, Sends, Receives, etc.
32
Program Flow – 5 of 5
PL/I Program Flow – including Legend
PROCs
I/O and
Called
PROCs
Legend
33
Job Callgraph – 1 of 2
▪ Select the Project
Double-click Job Callgraph
You can:
▪ Filter the list
▪ Select one or more Jobs
▪ Decide how
intricate/complex you
want the graph to be
drawn:
Limit the Callgraph to
Called/Calling Levels –
or not
Click Finish
35
Job Flow – 1 of 2
▪ Select the Project
Double-click Job Flow
You can:
▪ Filter the list by name
▪ Select a Job
▪ Click Finish
37
List a Project’s Components
1. Select the Project
Expand Explore
Select Explore project
39
Summary AD Tools: Call Graphs
Explorer
▪ List project artefacts by Resource Type
▪ Text search within selected Project(s)
Layouts
▪ BMS and MFS map layout (screen user view)
Mainframe Graphs
▪ Job triggers – defined in CA7
▪ Paths through Jobs – defined in CA7
▪ Value (data) movement shown from file to file
▪ Program statement-level Flow Chart
▪ Display of program calls from JCL EXEC PGM=
▪ Display of all Steps in a Batch Job
▪ Mainframe system taxonomy
▪ What resources are affected by program logic?
▪ Paragraphs and SECTIONS within a program
▪ What resources interface with a screen?
▪ What resources are interact with a transaction?
41
Hands-on Workshops – Discovering Mainframe Graphs – 1 of 4
▪ Log into your AD Analysis Server:
If you are using zTrial:
▪ Look for the note from the IBM zTrial team – which contains your ID/PWD
▪ Login to the zTrial machine
If you are using your own AD Server – launch AD
what specific Resource types and individual files are stored under each category Double-Click to use a Tool
45
UNIT AD for ISPF Developers
Topics:
▪ AD Navigation – a product walkthrough
▪ Labs and Module Review
▪ Build Client and Answers to Review Questions
Select Notepad
47
The AD Build Client – Change source
in a file and Rebuild – 2 of 5
49
The AD Build Client – Change source in a file and
Rebuild – 4 of 5
1. Expand a category
2. Select a file then Right-Click and select an action
Confirm your selection
52
AD Asset Partitioning
AD Repository
(Default DB2 Database == DMHDB)
53
AD Tools: Graphs, Reports and Usage
AD Tools
Graphs
COBOL
Program
54
AD Analysis Project – Review
What is an AD “Analysis Project”?
▪ AD calls physical groupings of parsed programs and other application source code
components “Analysis Projects” – or just “Projects”
Component Types
z/OS Application
55