Generierungsausgabe

Dieser Abschnitt umfasst die von EGL generierte Ausgabe einschließlich der Steuerdateien, die die Vorbereitung oder externe Implementierung betreffen.

Für Rich-UI werden zwei Ausgaben für jeden Handler oder jede Bibliothek generiert: eine JavaScript-Datei und eine Implementierungsdatei, die alle Abschnitte auflistet, die vom gerade generierten Abschnitt referenziert werden. Der EGL-Implementierer verwendet die Implementierungsdateien, um festzulegen, welche JavaScript-Dateien in die HTML-Datei einbezogen werden sollen. Weitere Einzelheiten finden Sie im Abschnitt "Übersicht über die Rich-UI-Implementierung".

Die folgende Tabelle listet die main-Abschnitte und die Angabe auf, ob die Abschnitte zur COBOL-Generierung oder zur Java™-Generierung gehören.

Tabelle 1. Ausgabe der Java- und COBOL-Generierung für main-Abschnitte
main-Abschnitt Generierungstyp Beschreibung
Datentabelle generiert als COBOL Erstellt auf zSeries-Plattformen ein COBOL-Programm, das Datentabellen enthält; erstellt auf iSeries-Plattformen eine Binärdatei, die Datentabellen enthält.
  generiert als Java Erstellt eine Java-Klasse, die Datentabellen enthält.
EGL-Implementierungsdeskriptor generiert als COBOL Eine nachfolgend angezeigte Tabelle enthält Zusatzinformationen.
  generiert als Java Eine nachfolgend angezeigte Tabelle enthält Zusatzinformationen.
JSF-Handler generiert als Java Erstellt eine Ausgabe, die eine Laufzeitinteraktion des Benutzers mit einer Webseite steuert.
Bibliothek generiert als COBOL Erstellt ein COBOL-Programm und stellt Funktionen und Werte für die Verwendung durch andere generierte COBOL-Programme zur Verfügung.
  generiert als Java Erstellt eine Java-Klasse und stellt Funktionen und Wert für die Verwendung durch andere generierte Java-Programme zur Verfügung.
Programm generiert als COBOL Erstellt ein COBOL-Programm, das in der Ziellaufzeitumgebung (z/OS-Batch, z/OS CICS oder iSeries) ausgeführt werden kann.
  generiert als Java Erstellt ein Java-Programm, das außerhalb von J2EE oder im Kontext einer J2EE-Clientanwendung, einer Webanwendung oder eines EJB-Containers verarbeitet werden kann.
  generiert als Java-Wrapper Erstellt einen Java-Quellcode, der in einem Nicht-EGL-Java-Programm verwendet werden kann, um ein mit EGL generiertes Programm aufzurufen.
Report-Handler generiert als Java Erstellt eine Java-Klasse, die einen Jasper-Bericht erstellen kann.
Datensatz mit dem Stereotyp 'ConsoleForm' generiert als Java Erstellt eine Java-Klasse, die die 'ConsoleForm' enthält.
Service generiert als COBOL Erstellt ein COBOL-Programm, das als Service fungiert.
  generiert als Java Erstellt eine Java-Klasse, die als Service fungiert.

Zusätzlich zu Ihrer Java- oder COBOL-Ausgabe werden während des Generierungsprozesses zusätzliche Dateien erstellt. In der nächsten Tabelle sind diese zusätzlichen Dateien und deren Dateinamen aufgelistet.

Die Dateinamen dieser zusätzlichen Dateien hängen von der Eigenschaft alias (falls vorhanden) ab, die im Abschnitt angegeben ist. Wenn die Eigenschaft alias nicht angegeben ist, wird der Name des Abschnitts verwendet und dabei jedoch bei Bedarf abgeschnitten, wenn die maximale Anzahl der zulässigen Zeichen in der Laufzeitumgebung erreicht ist. Weitere Merkmale der Variablen alias im Dateinamen werden durch die Art der Ausgabe bestimmt:
Tabelle 2. Weitere Dateien, die während der Java- oder COBOL-Generierung erstellt werden
Dateityp Generierungstyp Beschreibung
Bindungssteuerdatei COBOL für z/OS, wenn das Programm SQL verwendet Diese Datei enthält den Befehl BIND, der bei der Vorbereitung eines SQL-Programms für z/OS verwendet wird. Der Dateiname lautet 'alias.bnd'.
Buildplan COBOL und für Java, wenn die Builddeskriptoroption destDirectory definiert ist Diese Datei listet die Codevorbereitungsschritte auf, die in der Ziellaufzeitumgebung vorkommen. Der Dateiname ist 'alias_BuildPlan_timestamp.xml'.
CICS-Tabellendateien COBOL für CICS Diese Datei listet die CICS-Programm- und -Transaktionsdefinitionen auf, die für ein generiertes COBOL-Programm, eine Formatgruppe, eine Datentabelle oder eine Bibliothek erforderlich sind. Der Dateiname ist 'alias.ppt' für PPT-Einträge oder RDO PROGRAM oder alias.pct für PCT-Einträge oder RDO TRANSACTION.
DDS-Dateien (DDS = Data Definition Specification, Datendefinitionsspezifikation) COBOL für iSeries, wenn für den Builddeskriptor genDDSFile YES festgelegt wurde Diese Datei enthält die DDS-Dateien auf Grundlage der Datensatzdeklarationen, die für die Eingabe oder Ausgabe im Programm verwendet werden. Der Dateiname ist 'alias.dds'.
Implementierungsdatei Java Diese Datei enthält eine Liste der Builddeskriptoren, mit denen der Abschnitt generiert wurde. Der Dateiname ist 'partName.deploy', auch wenn der Abschnitt einen Aliasnamen hat.
J2EE-Umgebungsdatei Java, wenn für die Builddeskriptoroption genProperties GLOBAL oder PROGRAM festgelegt wurde Diese Datei enthält Einträge für die Einfügung in den J2EE-Implementierungsdeskriptor. Der Dateiname ist 'alias-env.txt'.
Verbindungseigenschaftsdatei Java Diese Datei legt fest, wie Aufrufe von generiertem Java-Code erfolgen. Dies geschieht jedoch nur, wenn Entscheidungen zur Laufzeit endgültig sind und nicht zur Generierungszeit. Der Dateiname ist 'linkageOptionsPart.properties', wobei linkageOptionsPart der Name des Verbindungsoptionsabschnitts ist, der im Builddeskriptor angegeben ist.
Linkbearbeitungsdatei COBOL für z/OS Es gibt zwei mögliche Dateien:
  • Eine ursprüngliche Linkbearbeitungsdatei, die mit EGL generiert wurde. Der Dateiname ist 'alias.led'.
  • Eine Linkbearbeitungsdatei bietet eine erneute Verbindung des Programms. Diese Datei wird nur erstellt, wenn ein Linkbearbeitungsabschnitt für das Programm generiert wurde. Der Dateiname lautet 'alias.lkg'.
Programmeigenschaftendatei Java, wenn für die Builddeskriptoroption genProperties GLOBAL oder PROGRAM definiert ist Diese Datei enthält Java-Laufzeiteigenschaften in einem Format, auf das nur zugegriffen werden kann, wenn Sie ein Java-Programm außerhalb von J2EE ausführen oder debuggen. Der Dateiname lautet 'alias.properties' oder 'rununit.properties' bei einer VGWebTransaction, wenn für genProperties GLOBAL festgelegt wurde.
Ergebnisdatei COBOL und für Java, wenn die Builddeskriptoroption destDirectory definiert ist Diese Datei gibt Statusinformationen zu den Schritten der Codevorbereitung auf der Zielplattform. Der Dateiname lautet 'alias_Results_timestamp.xml'.
Beispielsteuerlogik für Laufzeit COBOL für iSeries Diese Datei enthält Beispielsteuerlogik (CL, Control Logic), die für die Ausführung eines iSeries-Programms verwendet wird. Der Dateiname lautet 'alias.clr'.
Beispieljobsteuersprache für Laufzeit COBOL für z/OS-Batch, wenn für die Builddeskriptoroption genRunFile YES angegeben wurde Diese Datei enthält Beispieljobsteuersprache, die für die Ausführung eines z/OS-Batchprogramms verwendet wird. Der Dateiname lautet 'alias.jcx'.
EJB-Session-Bean (Enterprise JavaBean) Java-Wrapper Diese Datei wird in einem EJB-Container ausgeführt. Der Dateiname lautet 'aliasEJBHome.java' für die Home-Schnittstelle, 'aliasEJB.java' für die ferne Beanschnittstelle und 'aliasEJBBean.java' für die Beanimplementierung.

Die folgende Tabelle zeigt die Dateien, die erstellt werden, wenn Sie den EGL-Implementierungsdeskriptor für Java oder COBOL erstellen. Das Generieren des Implementierungsdeskriptors hat keine Auswirkung auf Rich-UI, weil in diesem Fall die Datei nur während der Implementierung verwendet wird.

Tabelle 3. Generierungsausgabe für EGL-Implementierungsdeskriptoren
Zweck des Dateieintrags Ziellaufzeitumgebung Ausgabedateien
Web-Serviceimplementierung z/OS CICS-COBOL
  • Ein COBOL-Web-Service-Wrapperprogramm, das von CICS verwendet wird, um einen EGL-Webservice zu starten.
  • Eine WSDL-Datei, die verwendet wird, um den Web-Service zu beschreiben.
  • Eine CICS-Web-Service-Bindungsdatei, die von CICS verwendet wird, um SOAP-Nachrichten in COBOL-Daten zu konvertieren und umgekehrt.
  • Eine CICS-Web-Service-Protokolldatei, die verwendet wird, um Ereignisse zu protokollieren, wenn die Web-Service-Bindungsdatei erstellt wird.
  iSeries COBOL
  • Ein Java-Web-Service-Wrapper, der für ein bestimmtes Webprojekt generiert wurde. Dieser Wrapper bietet über eine Ebene im Java-Code Zugriff auf den COBOL-Service.
  • Eine WSDL-Datei, die verwendet wird, um den Web-Service zu beschreiben.
  • Eine Sammlung von Java-Klassen, die für die Kommunikation zwischen dem Service-Wrapper und dem Service verwendet werden.
  Java (alle Umgebungen); für SOAP-Services
  • Ein Java-Web-Service-Wrapper, der für ein bestimmtes Webprojekt generiert wurde.
  • Eine WSDL-Datei, die verwendet wird, um den Web-Service zu beschreiben.
  • Eine Sammlung von Java-Klassen, die verwendet wird, um zwischen dem Service-Wrapper und dem Service zu kommunizieren.
  Java (alle Umgebungen); für EGL REST-RPC-Services
  • Eine XML-Datei, die die EGL REST-RPC-Endpunkte definiert. Der Dateiname lautet 'projectName-uri.xml', wobei projectName der Name des Projekts ist.
Servicebindung z/OS CICS-COBOL
  • Ein COBOL-Web-Service-Proxyprogramm, das von EGL-COBOL-Clients verwendet wird, um Web-Services aufzurufen.
  • Eine CICS-Web-Service-Bindungsdatei, die von CICS verwendet wird, um SOAP-Nachrichten in COBOL-Daten zu konvertieren und umgekehrt. Der Dateiname lautet 'eglddName-bind.xml', wobei eglddName der Name des EGL-Implementierungsdeskriptors ist.
  • Eine CICS-Web-Serviceprotokolldatei, die für Protokollereignisse verwendet wird, wenn die Web-Service-Bindungsdatei erstellt wird.
  iSeries COBOL
  • Eine XML-Datei, die die Servicebindungen definiert. Der Dateiname lautet 'eglddName-bind.xml', wobei eglddName der Name des EGL-Implementierungsdeskriptors ist.
  • Ein Proxy für den Zugriff auf den EGL Java-Laufzeitcode mithilfe der Java Native Interface (JNI).
  Java Standard Edition oder Apache Tomcat
  • Eine XML-Datei, die die Servicebindungen definiert. Der Dateiname lautet 'eglddName-bind.xml', wobei eglddName der Name des EGL-Implementierungsdeskriptors ist.
  Ein vollständig JEE-kompatibler Anwendungsserver wie beispielsweise WebSphere Application Server
  • Eine XML-Datei, die die Servicebindungen definiert. Der Dateiname lautet 'eglddName-bind.xml', wobei eglddName der Name des EGL-Implementierungsdeskriptors ist.
  • Ein Proxy für die Interaktion mit dem Anwendungsserver.
  • Die Sammlung der Java-Klassen, die für die Kommunikation zwischen dem Proxy und dem Anwendungsserver verwendet werden.

Feedback