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.
