Die vordefinierten und benutzerdefinierten symbolischen Parameter stehen in den Build-Scripts für die Vorbereitung der COBOL-Ausgabe als Substitutionsvariablen zur Verfügung. Während der COBOL-Buildzeit übergibt EGL alle symbolischen Parameter an den Build-Server. Die übergebenen Werte stellen die Werte für die Build-Script-Substitutionsvariablen mit denselben Namen bereit und überschreiben die Standardwerte (falls vorhanden) für diese Substitutionsvariablen. Details hierzu finden Sie unter EGL-Build-Scripts für z/OS ändern und im Handbuch IBM® Rational Business Developer EGL Server Guide for IBM i.
Sie können die Werte für einige vordefinierte symbolische Parameter angeben. Zusätzlich zu den vordefinierten symbolischen Parametern können Sie auch Ihre eigenen symbolischen Parameter definieren und jedem definierten Parameter einen Wert zuordnen. Der symbolische Parameter MYDIR könnte zum Beispiel den Namen eines Verzeichnisses enthalten. Sie können nicht denselben symbolischen Parameter (wie MYDIR) zweimal in demselben Buildddeskriptor definieren.
Wenn der für die Generierung verwendete Builddeskriptor mit der Option nextBuildDescriptor mehrere Builddeskriptoren verkettet und Sie den symbolischen Parameter gleichen Namens in mehreren verketteten Builddeskriptoren definieren, wird der während der Generierungszeit verwendete Wert von den Vorrangregeln bestimmt, die in Builddeskriptorabschnitt beschrieben werden. Der dem symbolischen Parameter MYDIR im Master-Builddeskriptor zugeordnete Wert hat zum Beispiel Vorrang vor dem Wert, der MYDIR in einem der anderen Builddeskriptoren zugeordnet ist.
Sie können symbolische Parameter für EGL-Builddeskriptoren verwenden, um die Sprachencodepage für zSeries festzulegen.
Außer den Datentypen STRING und UNICODE, die Sie in EGL definieren können, verfügt die Sprache über interne Literale, die als STRING definiert sind. Alle diese STRING- und UNICODE-Werte werden in COBOL als PIC N mit dem Qualifikationsmerkmal USAGE NATIONAL implementiert. Damit der COBOL-Compiler diese PIC N-Werte korrekt in Unicode-Werte umsetzt, muss die Codepage für die Umsetzung bekannt sein. Wenn die Systemprogrammierer die Option CODEPAGE nicht für den COBOL-Compiler konfiguriert haben oder wenn die falsche Codepage angegeben ist, müssen Sie möglicherweise den richtigen Wert selbst definieren.
COBLISTPARMS LIST,NOOPT,CODEPAGE(1147)
Den korrekten Wert für den Parameter CODEPAGE können Sie den COBOL-Handbüchern entnehmen. Die folgende Tabelle enthält eine Teilliste:
| Wert | Sprache |
|---|---|
| 420 | Arabisch |
| 274 | Belgien (Alt) |
| 275 | Brasilianisches Portugiesisch |
| 935 | Vereinfachtes Chinesisch |
| 1371, 937 | Traditionelles Chinesisch |
| 277 | Dänisch |
| 437 | Englisch (Australien) |
| 1146, 285 | Englisch (GB) |
| 1140, 437 | Englisch (USA) |
| 278 | Finnisch |
| 1147, 297 | Französisch |
| 273 | Deutsch |
| 875 | Griechisch |
| 424, 803 | Hebräisch |
| 1149, 871 | Isländisch |
| 1144, 280 | Italienisch |
| 1390, 290, 930, 939 | Japanisch |
| 1364, 933 | Koreanisch |
| 1153, 870, 1148, 500 | Lateinischer Zeichensatz |
| 277 | Norwegisch |
| 1156 | Russisch (Baltisch) |
| 1025, 1158 | Russisch (Kyrillisch) |
| 1122, 1157 | Russisch (Estnisch) |
| 1112 | Russisch (Lettisch) |
| 1112 | Russisch (Litauisch) |
| 1123, 1158 | Russisch (Ukrainisch) |
| 1145, 284 | Spanisch |
| 278 | Schwedisch |
| 838 | Thailändisch |
| 1026 oder 1155 | Türkisch |
Sie können symbolische Parameter in den Werten für die Builddeskriptoroptionen genDirectory und destDirectory, in Build-Scripts, Schablonen oder in den Linkbearbeitungs- oder Bindungssteuerungsabschnitten verwenden.
%EZEGTIME%
Sie können auch mehrere symbolische Parameter verwenden, um einen Wert zuzuordnen. Beispiel: Die folgenden Symbole stellen Datum und Uhrzeit getrennt durch ein Leerzeichen dar:
%EZEGDATE% %EZEGTIME%
Wenn genDirectory zum Beispiel auf C:\MyProject\%EZEENV% gesetzt ist und die Builddeskriptoroption system auf ZOSCICS, wird die Generierungsausgabe in C:\MyProject\ZOSCICS geschrieben.
&EZEGDATE.
//EZESRC DD DSN=&MYHLQ..;&SYSTEM..EZESRC;,DISP=SHR
Wenn Sie die Builddeskriptoroption system auf ZOSCICS und den benutzerdefinierten symbolischen Parameter MYHQL auf den Wert MYQUAL setzen, ergibt sich folgende Zeile im Build-Script://EZESRC DD DSN=MYQUAL.ZOSCICS.EZESRC,DISP=SHR