Migrating modules from ProgramModules saved as BOG files

If you have saved one or more ProgramModule components in your Workbench file space, you can run the folder (BOG) file containing them through the N4 migration tool.

If necessary, you can do this on a PC still running an AX-3.8 Supervisor station, but with both Workbench and Workbench installed.

Perform the following steps:

At the Workbench PC, open a console. This can be either a standalone Console window or the Console available in Workbench. See Console choice for migration.
Enter the migration tool command (n4mig) using syntax that specifies the source folder with ProgramModule BOG files. If using an absolute file path, an example command could look similar to:

n4mig C:\niagara\niagara-3.8.111\AprogBldr

for the AprogBldr folder as shown in the previous 16. Figure 17 on page 34. Leaving the target unspeciified (as here), results in a subfolder under stations in your Workbench User Home”.

NOTE: After the tool finishes, you can simply cut and paste this “non-station” folder to a better location.

While the migration tool runs, operation activity is reflected in the console window. When finished, the ending lines in the console window state where the target output folder and log file can be found. As shown above, you are not prompted for a station “type” (unlike if migrating the AX backup .dist file).
If the target folder was created in your stations folder, move (cut and paste it) to another location in your Workbench User Home. You can do this in the Nav tree, using right-click commands.
In the Nav tree, expand the target folder to see the BOG file(s) with ProgramModule(s).
Double-click a ProgramModule for its Program Module Builder view.
Right-click one of the contained Programs and select Views > Program Editor (as above).
In the Program Editor, click Save & Compile (ProgramEditor > Save&Compile). Activity occurs in the console area at the bottom of the Workbench window.

If successful, the Program status should be up-to-date, and the Save Bog icon should be available.
Click Save Bog.

NOTE: If a Program compile fails, you must make one or more modifications to that Program, working in its Program Editor.
Repeat steps 6 and 7 for all Programs in the selected ProgramModule, so that all Programs have been successfully compiled and saved.
Double-click the ProgramModule for its Program Module Builder view, then click Build.

As shown above, a popup dialog appears while the module is created. Completion may take several seconds. Related details should also appear in the console area at the bottom of the Workbench window.
If multiple ProgramModules are in the folder, repeat steps 5 through 9 for each one, so that a module for each is created. In the example folder shown here, there are two ProgramModules.

As shown above, the modules named yourPrgmModule1-rt.jar and yourPrgrmModule2-rt.jar were created by the two ProgramModules.
When finished migrating modules, close and restart Workbench. This is necessary to update the registry. Modules should now be ready when running the N4 migration tool on a backup .dist file of any AX-3.8 station that uses them. See Running the migration tool.

Migrating modules from ProgramModules saved as BOG files

Related Links