Running a Batch

Java Heap

Batch processing is a relatively resource intensive operation involving the creation and retention of large inheritance and dependency trees. The easiest way to increase the memory available to Eclipse is to edit the eclipse.ini file. As a guide, a medium sized Java project requires about 500 MB to run to completion. A larger project may require 1 GB.

The eclipse.ini file is located in the same folder as the eclipse executable on Windows. On Mac OS X right click on the Eclipse.app file and select Show Package Contents which will open a new finder window with the eclipse.ini located under the Mac OS folder.

--launcher.XXMaxPermSize256m
-vmargs
-Xms40m
-Xmx512m

Note that it is important to avoid setting the -Xmx value greater than the physical memory available as this will only result in slow processing due to the use of paged memory and the postponement of Java garbage collection.

Running

A batch may be run directly from the wizard (see Creating a New Batch), restarted or cleaned and re-run.

The wizard creates a new folder called batch under the project or folder you specify. In that folder it creates a file batch.ajb which is read as the batch is run.

Right clicking on the batch.ajb file and selecting AgileJ StructureViews - Run/Resume invokes the batch processing.

diagrams

The diagrams folder contains the diagram files which are opened by the AgileJ StructureViews diagram editor during the batch run.

uploadThis

The uploadThis folder contains the batch output which can be uploaded to a web server.

Stopping a Batch

A batch is an Eclipse job which can be halted just like any other Eclipse job. To kill the batch generator select

Window - Show View - Progress

In the list of running jobs will be AgileJ batch generator

Press the red square to end batch generation. This can be done safely at any time, the batch results so far generated will be retained, and if the batch is resumed then it will continue from where it was stopped.

Cleaning a Batch

A batch can be cleaned and re-run without needing to start from scratch with the wizard. To clean a batch simply delete the uploadThis folder.