ARCAD Source Code Analyzer
The ARCAD Source Code Analyzer plug-in for RDi is designed for the RDi integrated development environment (IDE). The ARCAD Source Code Analyzer plug-in makes it possible to analyze code sources using the component Repository, directly in your RDi workspace.
Installing
Follow the subsequent steps to install the ARCAD Observer plug-in(s).
Step 1 Download the installation package to your Local Site Repository. ARCAD delivers Eclipse plug-in packages in a .zip file. Save this .zip to your local environment. This location is the local site repository.
The PC on which your Eclipse tool is installed must be able to access this location. It is recommended to save the installation files on the same PC or a shared network that the PC is connected to. There is no need to unzip this file after you save it to your local environment.
After installation, it is recommend that you keep this location. Eclipse will continue to recognize it, so when updates are available, you can copy them into this folder.
Step 2 From the Help menu of the Eclipse IDE, select Install New Software.
You must be logged in as an administrator.
Step 3 From the Install dialog, click the Add button.
Step 4 In the Add Repository dialog, enter a recognizable name, then click Archive... This creates a link to the Local Site Repository that you can come back to and that will be used for automatic updates.
Step 5 Navigate to and select the ARCAD plug-ins installation .zip file that you saved to your local environment. Click OK.
Result The Location field in the Add Repository dialog is set to the .zip file's path. You can add new versions to this path later to update.
Click OK.
Step 6 Select the plug-in(s) to install.
Click Next > to continue.
Step 7 Review the selected features in the Install Details dialog.
Click Next > to continue.
Step 8 Review and accept the license agreement
The License Agreement page presents the ARCAD license agreement for you to review. Please read it carefully.
When you have reviewed the agreement, select I accept the terms of the license agreements.
Step 9 Review and confirm the trusted certificates.
Click OK.
Step 10 Click the Finish button to launch the installation.
Step 11 Restart the workbench. Click Yes to restart.
Result
Updating
Updating ARCAD plug-ins is similar to the original installation process. The prerequisites are the same and you must already have a previous version of the plug-in installed.
When there is a major upgrade (as opposed to a simple cumulative patch) or a name change in one of the ARCAD plug-ins, then it is recommended to uninstall the current plug-in and restart your platform before installing the new plug-ins.
Upgrading ARCAD plug-ins only works correctly when the names of the installation files have not changed.
If you try to re-install plug-ins instead of search for updates, as long as the correct .zip archive is selected, the plug-ins will update instead of reinstall. However, it is suggested to follow the following procedure to update plug-ins.
Follow the subsequent steps to update the ARCAD Observer plug-in(s).
Step 1 Save the new version of the installation .zip in your Local Site repository (created when you first installed the plug-ins).
Step 2 From the Help menu of the Eclipse IDE, select Check for Updates.
You must be logged in as an administrator.
Step 3 The Available Updates dialog displays all of the plug-ins found in your update location that are out of date. Select the plug-in(s) to update.
Click Next > to continue.
Step 4 Review and confirm the updates.
Click Next > to continue.
Step 5 Review and accept the license agreement
The License Agreement page presents the ARCAD license agreement for you to review. Please read it carefully.
When you have reviewed the agreement, select I accept the terms of the license agreements.
Step 6 Review and confirm the trusted certificates.
Click OK.
Step 7 Click the Finish button to launch the installation.
Step 8 Restart the workbench. Click Yes to restart.
Result
Once the update is completed, the IBM i should be updated as well to avoid version compatibility issues. Each user must upgrade their plug-ins, however the upgrade to the server is only performed once.
Executing the analysis
You can use the ARCAD Source Code Analyzer plug-in in RDi from the following views:
- the Remote System Explorer,
- an iProject, or
- the ARCAD Skipper components view.
Step 1 Right-click to select the item(s) to analyze.
It is possible to analyze multiple items at once. Use the Shift+Click shortcut to select multiple items.
Step 2 In the 
ARCAD Source Code Analyzer option, click 
Analyze.
Result The source code is analyzed by ARCAD Source Code Analyzer. You can follow the progress in the bottom right of the RDi workspace.
Once the items are analyzed, the Source code analysis view opens and displays an entry for each source code analyzed.
Each result can be unfolded to display the list of blocks found in the source.
A block is either:
- the main procedure,
- a subprocedure, or
- a subroutine
Double clicking on a block opens the diagram that represents the result of the analysis.
Uninstalling
When there is a major upgrade (as opposed to a simple cumulative patch) or a name change in one of the ARCAD plug-ins, then it is recommended to uninstall the current plug-in(s) and restart your platform before installing the new plug-in(s).
Follow the subsequent steps to uninstall the ARCAD Observer plug-in(s).
Step 1 From the Help menu of the Eclipse IDE, select Installation Details.
You must be logged in as an administrator.
Step 2 Click the What is already installed link in the lower right-hand corner of the Install dialog.
Step 3 Select the plug-in(s) to remove and click the Uninstall button.
Step 4 Click Finish to confirm.
Step 5 Restart the workbench.
Result The selected plug-in(s) is/are uninstalled.
