Introduction

---

The diagrams contained in this section are provided to be referenced by those persons who will be responsible for developing and maintaining online applications. They are organized in a sequence to be most useful to a developer who is doing customization to generated MMP's and MBP's.

It is advisable for the developer to familiarize him/herself with the overall processing logic of the generated programs before undertaking customization. Gaining a familiarity with them can be done by reviewing the Cobol program listings produced by the compiler. Reading the section of this manual titled Analysis of the Generated MMP will also be helpful in understanding the online MMP's.

The generated online programs (MMP's) each typically supports nine standard functions, plus any custom functions the developer might have added. The logic diagrams depict not the physical structure of the MMP's, but the logical structure for each of the various standard functions. They emphasize, not the Cobol paragraph names, but the customization insertion point names through which the processing flows. Thus, you will notice, any given insertion point name might appear in several diagrams. The cross-reference chart included in the front of the Insertion Points section of this manual will help you to see which insertion points are applicable to which functions.

The generated batch report programs (MBP's) are typical internal-sort processes utilizing an input procedure to read, join, and select data to be reported; a standard Cobol SORT verb, and an output procedure which produces a report. Multiple (up to nine) levels of break logic are supported.

This diagram structure is intended to be useful to the developer who is customizing generated applications and wishes to decide which insertion points are appropriate for his/her particular desired modifications. They are not to be confused with "flow charts" of the programs. A flow chart would involve a greater level of detail and would necessarily combine all program functions into one chart. This distinction is important to recognize since a change made in any given insertion point might well affect several different functions. The developer should refer to the cross-reference chart to resolve any questions regarding the potential (unexpected) impact of making changes at a given insertion point. The text of the Insertion Points section includes a detailed discussion of each insertion point.

It should be noted that when the automated logical join processes are used, MAGEC will generate "custom" coding which is inserted automatically into certain of the insertion points; therefore, you may notice coding in some insertion points (i.e. %JOIN and %DATADEF) even before you have done any customization of your own. This scheme allows you to access and modify the generated join logic, just as you can access and modify any other custom coding.

If you have generated an SQL application, there will be customization automatically generated in many of the insertion points which do database access. This coding consists mainly of EXEC SQL statements and it can be modified by you, if you wish.

If you are using MAGEC in GUI mode, these diagrams are available online in either the development or debugging phases. The narrative descriptions and instructions from the Insertion Points chapter are also available by clicking on the insertion points.