Previous Topic Next topic Print topic


Generating the Analysis

Restriction: This topic applies only when the AppMaster Builder AddPack has been installed, and applies only to Windows platforms.
Important: To ensure that you generate a complete analysis for an application, you must be sure that each object in the application generates without errors. Before generating an analysis, we recommend that you generate an application, including all of its objects, and then consult the Job Queue to see that each object has built correctly. The Job Queue shows a list of generated application objects on the left and the text of the job log on the right. Correct all errors before continuing.

You generate the analysis in stages as follows:

Stage 1: Generate application and program manifests
Before generating the application, you need to enable the creation of program manifests by checking Generate program manifest on the Output preferences page. Then, when you generate the application, AMB generates both the COBOL code and the program manifests.

One program manifest is created for each program, and each manifest contains a list of all the components in the program. The manifests are recreated every time you regenerate the application.

The program manifests are stored in the APXPROG project subdirectory. Generally, you don't need to access the manifests.

Stage 2: Generate a rule definition file
The rule definition file lists where each User Rule is located in the application's programs. When you generate this file, you can specify which directories to search for User Rule files, or you can search the default directories, such as APSMACS and CNTL (both located by default under %ProgramFiles(x86)%\Micro Focus\Enterprise Developer\etc (Windows) or $COBDIR/etc (UNIX)). The rule definition file is an XML file, macrodef.xml and is stored in your project's root directory. The Analysis Browser uses the rule definition file when displaying an analysis.
Stage 3: Generate the analysis
You can generate an analysis for the whole project or for just one application, as follows:
Project analysis
This creates an XML file containing an analysis of each application and program in your project, and is created using the information from the program manifest files together with information on the application files. The project analysis file has the same name as your project and is stored in your project's root directory.
Appication analysis
This creates an XML file containing an analysis of a single application, and is created using the information from the program manifest files. The application analysis file has the same name as your application and is stored in the APXAPPL project subdirectory.

The Analysis Browser uses the analysis XML file when displaying an analysis. The file might also be of use to you in other ways. For example, if you want to copy files from AppMaster Builder, the analysis file gives you a complete inventory of the application.

Previous Topic Next topic Print topic