The NGEN28SYS/BLD utility supports selective compilation and binding, to simplify partial generation of manually modified <<Ispec>> class, <<Ispec>> class Method, Segment Method, Report and Report Method sources and stubs.
This utility allows you to:
Compile and bind the <<Ispec>> class, Method (Ispec/Segment), and Report/ Report Method COBOL source(s)
Compile and bind the <<Ispec>> class, Method (Segment/Ispec), and Report/ Report Method ALGOL stub(s)
Compile and bind the <<Ispec>> class, Method (Segment/Ispec), and Report COBOL source(s) and ALGOL stub(s)
Compile and bind the user library stub(s)
Compile and bind the GSD program
Create the GENINFO file (ACUS internal diagnostic purposes only)
All of the above, with the option of immediate or scheduled installation of the new system/CODE_LIBRARY/nnn(s) and/orsystem/report code files
You must run the utility in the usercode of the application to be modified. Reports, Report methods and their stubs must reside under the system/GEN_WORK/.. directory. To compile the Exports library the source file must exist as system/SYS_WORK/ EXPORTS. All other modified sources must reside under the system/GEN_SOURCE/.. directories. The utility verifies that they are present
To manually compile and bind methods used by a report you must first update the GEN_WORK version (report method) or the GEN_SOURCE version (Segment/Ispec method) and then use Standalone BLD to compile & bind the GEN_WORK version of the report.
When the System-related information (name, packs etc) is verified as correct, it is saved in file BLD/INPUT/AUTO. If present, this is used to prefill the screen at startup.
The system name, dictionary pack, RunTimeEnvironment dictionary pack and new GSD program properties are used to set up internal tables for the utility. After you have performed the first transmit of the screen, you can no longer enter data in these properties.
When run you might enter any combination of options (Select and Select if Present are mutually exclusive for any type and Exit Program's action is immediate) you are taken through the associated screens to enter your required <<Ispec>> classes, Methods (Segment/Ispec), Reports, stubs and/or stub numbers (a maximum of 3500 entries per type). If you have also selected Start Compiles, this phase commences. Otherwise you are returned to the main menu screen where your selection counts is shown. Enter Start Compiles to process all your previously entered selections, or you can add or re-edit any selections.
If you chose Select if Present, a search is made in the appropriate directories for any source files matching your selection type (<<Ispec>> class, Method (Ispec/Segment), Report etc). If some files exist, you are taken to the pre-filled entry screen for that selection type. You can continue using all shown selections or delete some or all entries before you continue. Each time you choose any of the Select if Present entries, the current table for that type is initialized, so multiple calls will not accumulate any duplicates. However, any selections you had entered manually is lost.
When entering your <<Ispec>> class, Method (Ispec/Segment), Report, stub, or stub numbers, you can select one of six actions:
Next to continue adding entries onto a new page for this screen type
Prior to return to the previous page for this screen entry type (if any)
Menu to return to the main menu screen
Continue to move to the next request selected on the main menu
If this is the last request, the main menu is returned. This is the default.
Same to refresh the screen
Terminate to terminate the process now
Note: The current screen is processed before the requested action.
To invoke tracing, enter Y in the With Trace Option property. Errors and any status messages are returned on line 25.
If all the compiles and binds are successful and you entered Y in the Install property, the new code libraries and/or Reports are copied in immediately. If the current system/ CODE_LIBRARY/nnn or system/report is the original version created by an actual application or Report generate, it is copied as system/CODE_LIBRARY/nnn/SAVE or system/report/SAVE respectively before the generated codefile (system/GEN_LIBRARY/nnn or system/GEN_REP/report) is copied over it.
If you choose Cutover, the utility performs a hotswap of the newly generated code libraries, allowing the new libraries to be used immediately without restarting the application. If you entered N in the Install property, the code required to perform the hotswap is included in the created job system/WFL/INSTALL/DIAG/APPL/BLD.
If you entered N in the Install property:
For <<Ispec>> classes and GLGs, the job system/WFL/INSTALL/DIAG/APPL/BLD is created for the online application installation so you can perform the above actions at a later time. The releaseid is migrated from the original CODE_LIBRARY host with only the job number portion altered to ‘*Diag*.
For Reports, the job system/WFL/INSTALL/DIAG/report/BLD is created for the Report installation so you can perform the above actions at a later time. The releaseid is set to ‘*Diag*’ for the new report code file while the note attribute is maintained from the original report code file.