Your project can contain a variety of file types such as COBOL source, CICS mapset definitions, IMS data definitions, Data Files and Assembler code. See the section File Types and Dependencies for more information. These files can be built into an executable project. Mainframe Express saves a project whenever significant changes have occurred. See the sections Building Your Project and When Projects are Saved for more information.
When Mainframe Express builds a project, it uses built-in system intelligence to determine:
Mainframe Express also uses system intelligence at run-time, to identify which module to load.
When you create a project or you add a source file to a project, Mainframe Express scans the project for dependencies (such as copybooks). It adds these additional files to the project automatically. While doing the scan for dependencies, Mainframe Express also looks for selected phrases to try to determine the type of file, for example EXEC CICS. These set the relevant project settings, in this case that the CICS preprocessor must be used.
The following is a list of the file types and default file extensions currently supported:
Notes:
Building a project is the process of converting source code to executable code. Typically, building an application involves:
When you come to build your project, the build order is important. For example, the CICS BMS compile must take place before the COBOL compile for the program which uses the copybook produced by the BMS compile. There are a variety of ways of rebuilding the application:
Selecting Rebuild All on the Build menu causes the entire project to be rebuilt (whether or not the files have changed since the last build). Mainframe Express automatically builds the various components in the following order:
When you select a rebuild by choosing Build > Build, Mainframe Express rebuilds only those targets with changes in their source files. The build system checks which files have changed, the dependents of those files (the "targets") and then scans all the dependencies of those targets to see if any of the sources for a given target have been updated or any new dependencies have been added. Where a target is out of date for any of its dependencies, a compile command is issued (where that compile may turn out to be a COBOL compile, BMSGEN or whatever).
In detail, the build system performs the following sequence of steps:
Mainframe Express uses the same order of building as in the case of a complete rebuild.
When you select a rebuild by choosing Build > Quick Build, Mainframe Express rebuilds only those targets marked out of date in the File Details View, or that failed during the previous build operation.
If any objects have been changed outside of the IDE, Mainframe Express is not aware of these changes and the objects are not built.
You can rebuild one file or several files:
You can rebuild a single file by simply right-clicking on the filename in the project list and clicking compile filename. Be aware that this simply compiles the chosen file. The build order has been determined by you and you should be aware of the sequence you are using and the possible incorrectness of this sequence.
You can choose several files to rebuild by selecting the files and right-clicking in the project list. Then click Compile x programs where x is the number of files that you have chosen to rebuild.
When Mainframe Express updates the build status of a source file, it performs the following three operations:
Mainframe Express first looks for each source and dependency file in the project along each of the folders specified for the relevant search path in the project. New versions are added if found, and old ones removed if they no longer exist. The date and time on each source file is stored in the project.
Mainframe Express next looks for all possible output files from each source file along each of the folders specified for the relevant search path in the project. New versions are added if found, and old ones are removed if they no longer exist. The date and time on each output file is stored in the project.
When a source file is compiled, the dependent files (such as copybooks) are linked to the main source file. This link also includes the date and time of the dependent file when the compilation occurred. Immediately after compilation, Mainframe Express examines each of the possible output files, and determines which has the latest date and time. It then stores this date and time as the Date Compiled attribute of the source file.
The status of a file is set to Out of Date if any of the following are true:
When one module in a mixed-language application calls another, Mainframe Express looks for the module to load in a specific order:
This takes care of the situation where there might be COBOL modules and an Assembler module of the same name: Mainframe Express finds and loads the COBOL modules first.
Mainframe Express saves a project file (.mvp) when you do any of the following:
Copyright © 2006 Micro Focus (IP) Ltd. All rights reserved.