Getting Started with EA Web

The EA Web home page consists of a banner and two main tabs, Inventory and Business Rules. On the Inventory tab the page is split into a number of panes, Repository, Code Search, Code Search Queries, Code Search Reports, and Inventory pane:



Banner

The banner bar enables you to specify the workspace and project that you want to use. You can change the default workspace by selecting from the Workspace list. You can then select an appropriate project for that workspace from the Project list. Click About to see the EA Web version number.

The choices you have depends on the workspace you have configured in Enterprise Analyzer Administration. In Enterprise Analyzer Administration, click Administer > Configure Web Service and modify as required.

Repository Pane

The Repository pane displays the contents of the repository for the current workspace. It has two views, Folder and Type which you can toggle between using the radio buttons:

Folder
Displays the content of the repository in the same folder structure as the one they have in the host environment. This enables elements with the same name (homonyms) to be loaded and displayed.
Type
Displays the content of the repository by project, object type, and object relationship.

The Folder and Type views both consists of the following elements:

Browser
Displays the objects in the repository of the current workspace in a tree structure. Depending on the view you have selected in the Repository pane, the contents are displayed by type or by folder.
Search
Enables you to execute searches in the repository of the current workspace.

To expand a node in the Repository pane tree, click . By drilling down through the nodes you can find programs called by or called to, copybooks used, data accessed, screens used, and so forth. These elements are different depending on the element chosen. They are all relationships at object level between programs, files, database tables, copybooks, screens, JCLs and so forth.

Note: Unlike the Enterprise Analyzer IDE, the EA Web Repository Browser can not expand relationships recursively for the root object. For example, expand a JCL file that uses a control card, then expand the Used By relationship for the control card. The starting JCL is displayed, but it cannot be expanded to see its relationships again.

Double-click an object and the source code is displayed in the pane on the right as a new tab alongside Inventory pane.

Right-click an object, and a context menu with the following menu items is displayed:

Query Repository
Displays all the queries available for the selected source type:
  • Related Java Packages.
  • Boundary Points (potential) - Points that could lead to requests resources outside of Java.
  • Boundary Points (resolved) - Points that lead to requests resources outside of Java.
  • Is Invoked By
  • Related Java Files
  • Dependent Sources
  • Direct References (outgoing)
  • Direct References (incoming) - This makes references to usage directly. A program is called through a Program Entry Point so this will not return the list of Called Programs, but the includes and copies.
  • Is Called By
  • Is CRUD By
  • Used Data Stores
  • Used Sources
Diagrammer
Creates a small graph. The information on the graph depends on the requested type of graph. For example, Call Map will display all the links between programs. The following list gives the Diagrammer scopes:
Call Map
Program to program calls.
CICS Flow
Interactions between transactions, programs, and screens.
Job Flow
Process to program to data port to data store.
Screen Flow
Program to screen send/receive.
AS/400 Flow
DBFile links.
Data Flow
Program to data.
IMS Flow
Interactions between transactions, programs, screens, and segments.
Job Executive Report
Job to program, sys-program, and data store.
Natural Flow
Natural links between programs, screens, and so forth.
Program Executive Report
All links coming from a program.
Source Dependencies
Links between sources, like copies, includes, and so forth.
Unisys Flow
Unisys links.
Open
Opens the source file.

Code Search

From the Code Search pane you can execute queries. By default, the queries are the same as in Enterprise Analyzer but you can create your own queries in the tool and add them to the Code Search tab.

In this pane you have two different views Code Search Queries and Code Search Reports. From Code Search Queries you can execute queries defined in Code Search in EA and from Code Search Reports you can execute pre-defined reports such as Quality Assessment, Performance Optimization, Portability Assessment, and various migration reports.

The Code Search Queries pane lets you filter by selected files or project and the language of the sources.

Click Refresh to update the list depending on your choices.

All query results appear in a new tab on the Inventory pane.

Inventory

When you start EA Web, this pane displays three different types of charts:

Object types in the workspace
Displays the types and number of elements in the workspace.
Inventory report
The verification results for each type of element.
Complexity report.
Displays information on the number of source lines, comment lines, blank lines, and include statements split by source.

When you execute a query, the results from it appear in a new tab in the Inventory pane. You can double-click an element to see its source code which will be displayed in a new view in this pane.

You can also right-click a variable and create an Impact trace for the variable. The impact trace displays how the data flows to and from other variables, files, screens, and so forth.

Business Rules

The left-hand portion of the Business Rules pane displays the business functions in your workspace in tree form:

  • The Grouping tab lists rules in the order you created them manually, organized by business function and rule set.
  • The Triggering tab lists rules in a hierarchy of triggers, in which each triggering rule can be a parent to triggering rules that depend on it in program logic.

The right-hand pane displays the attributes and other characteristics of the business function, rule set, or rule selected in the left-hand pane.

See the Extracting Business Rules chapter for more information.