EGLPREP batch command utility
Use the EGLPREP command outside of the workbench to prepare multiple generated COBOL programs on the host. The utility monitors a specified folder for buildplan files created by the EGL COBOL generation process. When EGLPREP finds a new buildplan file, it starts a new thread and launches the build plan. You may set an optional parameter to limit the number of threads to be started.
As each build plan finishes, EGLPREP updates a history file named batchBuild.html in the same folder where the utility looks for buildplan files. This file shows the results of each completed build plan.
If you generate COBOL programs from the workbench with the build descriptor option prep set to yes, EGL waits for each compile to finish before generating the next program. By setting the prep build descriptor option to NO, you shift responsibility for compilation to the EGLPREP utility, which takes advantage of the ability of the z/OS® and iSeries® to run multiple compilations at the same time.
Prerequisites
- Make sure that eglbatchgen.jar is in both your PATH and CLASSPATH
system variables. The JAR file is in the following directory:
SharedInstallDirectory\plugins\com.ibm.etools.egl.batchgeneration_version\runtimeThe substitution variables are as follows:
- SharedInstallDirectory is the fully qualified path for
the directory where you installed the shared resources for the EGL
developer product. For example, the path might be
C:\Program Files\IBM\SDP70Sharedon a Windows™ system or/opt/IBM/SDP70Sharedon a Linux™ system.If you installed and kept a previous version of the EGL developer product before installing the product that you are using now, the shared installation directory of interest may be the directory that was used in the earlier install.
- version is the plugin version. The value has three numbers separated by periods, followed by a string separator, followed by the date and time that the plugin was built. If more than one version of the same plugin is present, use the most recent version number, unless you have a reason to use an older version.
- SharedInstallDirectory is the fully qualified path for
the directory where you installed the shared resources for the EGL
developer product. For example, the path might be
- Set up the Security Manager to handle user IDs and passwords. For details, see Security Manager.
Syntax
java EGLPREP foldername [-searchSubfolders]
[-maxThreadsn]
[-clearHistory]- foldername
- The name of the folder that EGLPREP should monitor for new build plans.
- -searchSubfolders
- Tells EGLPREP to search subfolders under foldername for new build plans.
- -maxThreadsn
- Tells EGLPREP to limit the threads to the specified number. Include no space between maxThreads and that number. The default is 1.
- -clearHistory
- Tells EGLPREP to delete the contents of the batchBuild.html file before logging subsequent history.