Launching the Application Diagram

What to do next

You can use theVisualize Application Diagram action to create a new Application Diagram and open it in the viewer. This action appears on the pop-up menu for the following Remote System Explorer resources:
  • ILE RPG, ILE COBOL, and ILE CL source members
  • IFS files and local files
  • IFS folders (all ILE RPG, ILE COBOL, and ILE CL source files in the folder are included)
  • Local folders (all ILE RPG, ILE COBOL, and ILE CL source files in the folder are included)
  • Member filters
  • Program and service program objects
  • Object filters

Multi-selection is available on all of the above resources, so you could for example select 5 ILE RPG and 2 ILE CL source members as well as 2 program objects and 4 service program objects.

You can also launch the Application Diagram from the Remote Systems LPEX Editor using the Source > Visualize Application Diagram action or toolbar icon.

Launch Application Diagram from Remote Systems LPEX Editor.

This creates an Application Diagram using the contents of the editor including any unsaved changes. The Application Diagram is also integrated with i Projects. You can launch the action from an ILE RPG, ILE COBOL, or ILE CL project member, source file or the project itself.

The Application Diagram uses the LPEX parser associations for the ILErpg, ILErpgSql and ILEcobolSqlCics, and cl parsers to determine if a selected source member, IFS file or local file is either ILE RPG, ILE COBOL, or ILE CL. By default the standard types (RPGLE, SQLRPGLE, CBLLE, SQLCBLLE, CL, CLLE, CLP, and CMD) are associated with one of these parsers. If you are using a nonstandard type then the Visualize Application Diagram action will not appear in the pop-up menu for your source members until you associate the type with one of the above four parsers. You can do this using the LPEX Editor > Parsers > Parser Associations preference page.

After launching the Visualize Application Diagram action the tool scans each of the selected resources to build up the Application Diagram. This may take some time depending on the number and size of the resources selected. You can click the Run in Background button on the Building Application Diagram progress monitor to have this task run in the background while you continue working with the Remote System Explorer. Switch to the Progress view to check the status of the task.

The scanning of ILE RPG source resources uses the ILE RPG Program Verifier. The ILE RPG program verifier uses a local cache on the workstation to resolve external dependencies before checking the remote system. You can force the program verifier to update the cache by selecting then Refresh Cache option on the Remote Systems > IBM i > Program Verifiers preference page.
Note: When multiple local files are scanned, the verifier does not find calls between different files since it only looks for /COPY members on the server. It is recommended that you use i Projects for storing and working with local RPG, COBOL and CL source files. i Projects do not have this /COPY member restriction.
Note: If ILE RPG subroutines/subprocedures, ILE COBOL procedures, or CL subroutines do not start and end in the same source member, calls from that subroutine/subprocedure/procedure might not be shown correctly in the application diagram or the properties of the calls may be incorrect.

Feedback