Updating the Project Hierarchy

The Hierarchy view can aid in understanding the implications of modifying programs and copybooks in an online BMC mainframe project. It is based on a prior analysis of the project and can be used to view either a hierarchy of copybooks or a hierarchy of program calls. You can use the copybook hierarchy to display both an include hierarchy and an included by hierarchy. The program hierarchy can display both a calls program hierarchy and a called by program hierarchy. 

Project Explorer

Content for the Hierarchy view is created by first analyzing an online BMC mainframe project in the Project Explorer. The project should include source members and a copybook concatenation list. For more information on creating and configuring an online project, see the BMC-AMI-DevX-Workbench-Host-Explorer-User-Guide.

Notes

  • Only files with COBOL or PL/I file extensions will be analyzed; A project can contain either COBOL or PL/I, but not a mixture of the two. You can set the file extension with the right click Assign File Extension… or Change File Extension… choices.
  • The source member names of PL/I programs must observe the convention of matching the procedure name within the member.
  • Code Insights tries to determine the type of file (COBOL or PL/I) by looking at keywords inside the file. If it can't determine what kind of file it is, it will look at the file's extension. In 19.4.1, all files with extensions .cob, .cbl, .cpy, and .copy — as well as all files that were identified as being COBOL — will be analyzed. However, right-clicking on any file that does not have one of those four extensions will not provide the option of opening the program or copybook hierarchy. The behavior of the Update Project Hierarchy feature is as follows:
    • If a project contains a mix of COBOL and JCL members with file extensions assigned correctly:
      • The JCL file will not be analyzed.
      • The right-click menu for the JCL file will not include the options Open Program Hierarchy or Open Copybook Hierarchy.
    • If a project contains a mix of COBOL and JCL members with file extensions assigned incorrectly (for example, a member that was assigned the file extension .cbl contains JCL code):
      • The JCL file with a .cbl extension will be analyzed, but
      • Open Program Hierarchy and Open Copybook Hierarchy will not present any information.
  • When opening editors from either the Project Explorer or Hierarchy view, the copybooks from the project's copybook concatenation list are used, not the copybook concatenation lists configured in Host Explorer.
  • The code problems presented in the Problems view are the result of running Code Insights for each specific program analyzed. Only problems that would affect the Project Hierarchy results are displayed. The reported code problems are not the same as compiler diagnostics and do not replace them. If you wish to see the compiler diagnostics for your program, see Submitting Compiles and Displaying Compile Diagnostics.

Update the project hierarchy for an online BMC mainframe project

  1. To start creating or updating project hierarchy data for an online project, right-click anywhere on the project and select Update Project Hierarchy. The entire project is analyzed to determine the hierarchical relationships of programs and copybooks. This analysis can take some time, depending on the size and complexity of the project. An Analyze project percentage indicator in the status area shows the progress of the scan. Double-clicking the indicator displays a more detailed Progress view and allows you to terminate the hierarchy update process, if necessary.
  2. When creation or updating of the project hierarchy is complete, right-click a program or copybook in the Project Explorer and select either:
    • Open Copybook Hierarchy or
    • Open Program Hierarchy
  3. Continue with Working with the Hierarchy View.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*