For Rich UI, two outputs are generated for each handler or library: a JavaScript file, and a deploy file that lists all of the parts referenced by the part being generated. The EGL deployer uses the deploy files to determine what JavaScript files are to be included in the HTML file. For further details, see “Overview of Rich UI deployment.”
The following table lists the main parts and whether the parts are associated with COBOL generation or Java™ generation.
| Main part | Generation type | Description |
|---|---|---|
| DataTable | generated as COBOL | In zSeries platforms, creates a COBOL program that contains the data table contents; in iSeries® platforms, creates a binary file which contains the data table contents. |
| generated as Java | Creates a Java class that contains the data table contents. | |
| EGL deployment descriptor | generated as COBOL | A table shown later gives the detail. |
| generated as Java | A table shown later gives the detail. | |
| JSF Handler | generated as Java | Creates output that controls a user's runtime interaction with a web page. |
| Library | generated as COBOL | Creates a COBOL program and provides functions and values for use by other generated COBOL programs. |
| generated as Java | Creates a Java class and provides functions and values for use by other generated Java programs. | |
| Program | generated as COBOL | Creates a COBOL program that can be run in the target runtime environment (z/OS® batch, z/OS CICS®, or iSeries). |
| generated as Java | Creates a Java program that can be run outside of J2EE or in the context of a J2EE client application, web application or EJB container. | |
| generated as Java wrapper | Creates Java source code that can be used in a non-EGL Java program to invoke an EGL-generated program. | |
| Report Handler | generated as Java | Creates a Java class that can make a Jasper report. |
| Record with the stereotype ConsoleForm | generated as Java | Creates a Java class that contains the ConsoleForm. |
| Service | generated as COBOL | Creates a COBOL program that acts as a service. |
| generated as Java | Creates a Java class that acts as a service. |
In addition to your Java or COBOL output, additional files are created during the generation process. The next table lists these other files and their file names.
| File type | Generation type | Description |
|---|---|---|
| Bind control file | COBOL for z/OS when the program uses SQL | This file contains the bind command that is used in preparing an SQL program for z/OS. The file name is alias.bnd. |
| Build plan | COBOL, and for Java when the destDirectory build descriptor option is set | This file lists the code-preparation steps that will occur in the target runtime environment. The file name is alias_BuildPlan_timestamp.xml. |
| CICS table files | COBOL for CICS | This file specifies the CICS program and transaction definitions that are needed for a generated COBOL program, form group, data table, or library. The file name is alias.ppt for PPT entries or RDO PROGRAM, or alias.pct for PCT entries or RDO TRANSACTION. |
| Data definition specification (DDS) files | COBOL for iSeries when the genDDSFile build descriptor is set to YES | This file contains the data description specification (DDS) files based on the record declarations used for input or output in the program. The file name is alias.dds. |
| Deployment file | Java | This file contains a list of build descriptors with which the part was generated. The file name is partName.deploy, even if the part has an alias. |
| J2EE environment file | Java, when the genProperties build descriptor option is set to GLOBAL or PROGRAM | This file provides entries for insertion into the J2EE deployment descriptor. The file name is alias-env.txt. |
| Linkage properties file | Java | This file guides how calls are made from generated Java code, but only if decisions are final at runtime rather than generation time. The file name is linkageOptionsPart.properties, where linkageOptionsPart is the name of the linkage options part specified in the build descriptor. |
| Link edit file | COBOL for z/OS | There are two possible files:
|
| Program properties file | Java, when the genProperties build descriptor option is set to GLOBAL or PROGRAM | This file contains Java runtime properties in a format that is accessible only when you are running or debugging a Java program outside of J2EE. The file name is alias.properties, or rununit.properties on a VGWebTransaction if genProperties is set to GLOBAL. |
| Results file | COBOL, and for Java when the destDirectory build descriptor option is set | This file gives status information on the code-preparation steps that occurred on the target platform. The file name is alias_Results_timestamp.xml. |
| Sample runtime CL | COBOL for iSeries | This file contains sample Control Logic (CL) used to run an iSeries program. The file name is alias.clr. |
| Sample runtime JCL | COBOL for z/OS batch when the genRunFile build descriptor option is set to YES | This file contains sample JCL used to run a z/OS batch program. The file name is alias.jcx. |
| Enterprise JavaBean (EJB) session bean | Java wrapper | This file runs in an EJB container. The file name is aliasEJBHome.java for the home interface, aliasEJB.java for the remote bean interface, and aliasEJBBean.java for the bean implementation. |
The following table shows the files that are created when you generate the EGL deployment descriptor for Java or COBOL. Generating the deployment descriptor has no effect for Rich UI because in that case, the file is used only during deployment.
| Purpose of file entry | Target runtime environment | Output files |
|---|---|---|
| Web service deployment | z/OS CICS COBOL |
|
| iSeries COBOL |
|
|
| Java (all environments); for SOAP services |
|
|
| Java (all environments); for EGL REST-RPC services |
|
|
| Service binding | z/OS CICS COBOL |
|
| iSeries COBOL |
|
|
| Java Standard Edition; or Apache Tomcat |
|
|
| A fully JEE-compliant application server such as WebSphere® Application Server |
|