Beschreibung der Java-Laufzeiteigenschaften

In der folgenden Tabelle sind die Eigenschaften beschrieben, die in den Deploymentdeskriptor oder die Programmeigenschaftendatei aufgenommen werden können, sowie die Quelle des Wertes, der ggf. in der J2EE-Umgebungsdatei generiert wird. Der Java™-Typ der einzelnen Eigenschaften ist 'java.lang.String', sofern in der Beschreibungsspalte nichts anderes angegeben ist.

Laufzeiteigenschaft Beschreibung Quelle des generierten Wertes
cso.cicsj2c.timeout Gibt die Zeit in Millisekunden an, nach deren Ablauf bei einem Aufruf mit dem Protokoll CICSJ2C eine Zeitlimitüberschreitung festgestellt wird. Der Standardwert ist 30000 und bedeutet 30 Sekunden. Der Wert 0 gibt an, dass kein Zeitlimit gilt. Der Wert muss größer als oder gleich 0 sein.

Der Java-Typ ist in diesem Fall java.lang.integer.

Die Java-Laufzeiteigenschaft cso.cicsj2c.timeout wirkt sich nur dann auf Aufrufe auf, wenn das aufrufende Programm in einer J2EE-Umgebung und das aufgerufene Programm in einer CICS-Umgebung bereitgestellt wird. Nähere Angaben hierzu finden Sie in J2EE-Server für CICSJ2C-Aufrufe konfigurieren.

Builddeskriptoroptioncicsj2cTimeout
cso.linkageOptions.VO Gibt den Namen der Verbindungseigenschaftendatei an, die steuert, wie das generierte Programm oder der generierte Wrapper andere Programme aufruft. Hier steht VO für den Namen des Verbindungsoptionsabschnitts, der für die Generierung verwendet wird. VO stammt aus der Builddeskriptoroption linkage. Der Standardwert ist der Name des Verbindungsoptionsabschnitts mit der Erweiterung .properties.
egl.service.rest.exception.debug Gibt an, ob die von EGL REST-RPC-Services zurückgegebenen Ausnahmebedingungen die größtmögliche Detailstufe enthalten. Der Eigenschaftswert ist true oder false.

Wenn der Wert false ist, gibt eine Ausnahmebedingung nur die folgenden Details zurück: eine Zeitmarke, eine Nachrichten-ID und eine Referenz auf das Anwendungsserverprotokoll. Diese Antwort enthält keine Details zur Speicherposition des Protokolls, da diese Details spezifisch für den jeweiligen Anwendungsservertyp sind. Für gewöhnlich ist das Protokoll das Ziel für die Java-Ausgabe für System.err auf dem Server.

In der Entwicklungsumgebung lautet der Standardwert der Eigenschaft true.

In der bereitgestellten Umgebung ist der Standardwert false. Ziehen Sie in Betracht, den Wert auf true zu setzen, wenn die Details, die möglicherweise zurückgegeben werden, frei von Sicherheitsverstößen sind, insbesondere dann, wenn Ihre Verarbeitung vom Inhalt der Fehlernachrichten abhängt.

 
vgj.datemask.gregorian. long.Ländereinstellung Enthält die Datumsmaske, die in folgenden Fällen verwendet wird:
  • Der Java-Code, der für die Systemvariable

    vgVar.currentFormatted
    GregorianDate

    generiert wurde, wird aufgerufen oder
  • EGL überprüft ein Seiten- oder Textformularfeld, das mehr als 10 Zeichen lang ist, wenn die Feldeigenschaft dateFormat auf systemGregorianDateFormat gesetzt ist.

Ländereinstellung ist der in der Eigenschaft vgj.nls.code angegebene Code. Sie können die Eigenschaft für die Datumsmaske durch Aufrufen der Funktion sysLib.setLocale ändern.

Der Wert dieser Eigenschaft kann entweder eine Datumsmaske (wie in der Dokumentation beschrieben) oder eines der folgenden Wörter sein:
  • short
  • medium
  • long
Diese Werte stammen aus der Java-Klasse 'DateFormat' und bei ihrer Verwendung gibt Java das kurze, mittlere oder lange Datumsformat ein, das Ihrer Ländereinstellung entspricht.
vgj.datemask.gregorian. short.Ländereinstellung Enthält die Datumsmaske, die verwendet wird, wenn EGL ein Seiten- oder Textformularfeld überprüft, das weniger als 10 Zeichen lang ist, wenn die Elementeigenschaft dateFormat auf systemGregorianDateFormat gesetzt ist.

Ländereinstellung ist der in der Eigenschaft vgj.nls.code angegebene Code. In Webanwendungen können Sie die Eigenschaft für die verwendete Datumsmaske ändern, indem Sie sysLib.setLocale einen anderen Wert zuweisen.

Builddeskriptorwert für die Datumsmaske im kurzen Gregorianischen Format. Der Standardwert hängt von der Ländereinstellung ab.
vgj.datemask.julian.long.Ländereinstellung Enthält die Datumsmaske, die in folgenden Fällen verwendet wird:
  • Der Java-Code, der für die Systemvariable

    vgVar.currentFormatted
    GregorianDate

    generiert wurde, wird aufgerufen oder
  • EGL überprüft ein Seiten- oder Textformularfeld, das mehr als 10 Zeichen lang ist, wenn die Feldeigenschaft dateFormat auf systemJulianDateFormat gesetzt ist.

Ländereinstellung ist der in der Eigenschaft vgj.nls.code angegebene Code. In Webanwendungen können Sie die Eigenschaft für die verwendete Datumsmaske ändern, indem Sie sysLib.setLocale einen anderen Wert zuweisen.

Der Wert dieser Eigenschaft kann entweder eine Datumsmaske (wie in der Dokumentation beschrieben) oder eines der folgenden Wörter sein:
  • short
  • medium
  • long
Diese Werte stammen aus der Java-Klasse 'DateFormat' und bei ihrer Verwendung gibt Java das kurze, mittlere oder lange Datumsformat ein, das Ihrer Ländereinstellung entspricht.
vgj.datemask.julian.short.Ländereinstellung Enthält die Datumsmaske, die verwendet wird, wenn EGL ein Seiten- oder Textformularfeld überprüft, das weniger als 10 Zeichen lang ist, wenn die Elementeigenschaft dateFormat auf systemJulianDateFormat gesetzt ist.

Ländereinstellung ist der in der Eigenschaft vgj.nls.code angegebene Code. In Webanwendungen können Sie die Eigenschaft für die verwendete Datumsmaske ändern, indem Sie sysLib.setLocale einen anderen Wert zuweisen.

Builddeskriptorwert für die Datumsmaske im kurzen Julianischen Format. Der Standardwert hängt von der Ländereinstellung ab.
vgj.default.databaseDelimiter Gibt das Symbol an, das zur Trennung eines Werts vom nächsten in den Systemfunktionen sqlLib.loadTable und sqlLib.unLoadTable verwendet wird. Die Standardeinstellung ist ein Pipe-Zeichen (|). Builddeskriptoroption dbContentSeparator
vgj.default.dateFormat Gibt den Anfangswert der Systemvariable strLib. defaultDateFormat an. Builddeskriptoroption defaultDateFormat

vgj.default.
I4GLNativeLibrary

Gibt den DLL-Namen an, auf den eine native EGL-Stereotypbibliothek zugreift. Die Eigenschaft ist erforderlich, wenn die Bibliothekseigenschaft dllName nicht angegeben wurde.
Anmerkung: Dies ist eine Java-Systemeigenschaft. Sie stammt nicht aus der gewöhnlichen Programmeigenschaftendatei bzw. aus dem J2EE-Deploymentdeskriptor.
Um eine Systemeigenschaft anzugeben, verwenden Sie beim Starten von Java die Option '-D'. Beispiel:java -DEigenschaft=Wert, wobei Eigenschaft der Eigenschaftsname und Wert der Wert ist, den Sie zuweisen.
vgj.default.moneyFormat Gibt den Anfangswert der Systemvariable >strLib. defaultMoneyFormat an. Builddeskriptoroption defaultMoneyFormat
vgj.default.numericFormat Gibt den Anfangswert der Systemvariable strLib. defaultNumericFormat an. Builddeskriptoroption defaultNumericFormat
vgj.default.timeFormat Gibt den Anfangswert der Systemvariable >strLib. defaultTimeFormat an. Builddeskriptoroption defaultTimeFormat
vgj.default.timestampFormat Gibt den Anfangswert der Systemvariable strLib. defaultTimestampFormat an. Builddeskriptoroption defaultTimestampFormat
vgj.java.command Der Befehl, der von vgLib.startTransaction zum Starten einer neuenJava Virtual Machine verwendet wird. Die Standardeinstellung ist 'java'. Nicht vorhanden
vgj.jdbc.database.SN Optional. Wenn Sie mithilfe der Systemfunktion sysLib.connect oder vgLib.connectionService eine Datenbankverbindung herstellen, gibt diese Eigenschaft den verwendeten JDBC-Datenbanknamen an.
Die Bedeutung des Wertes ist für J2EE-Verbindungen eine andere als bei Standardverbindungen (Nicht-J2EE):
  • Bezogen auf J2EE-Verbindungen (wie sie in Produktionsumgebungen benötigt werden) ist der Wert der Name, an den die Datenquelle im JNDI-Registry gebunden ist, beispielsweise 'jdbc/MyDB'.
  • Bezogen auf eine Standard-JDBC-Verbindung (wie sie für das Debugging verwendet werden kann) ist der Wert die Verbindungs-URL, beispielsweise 'jdbc:db2:MyDB'.

Sie müssen den Namen der Eigenschaft anpassen, wenn Sie bei der Bereitstellung einen Substitutionswert für SN angeben. Der Substitutionswert wiederum muss entweder dem Servernamen, der im Aufruf von vgLib.connectionService enthalten ist, oder dem im Aufruf von sysLib.connect enthaltenen Datenbanknamen entsprechen.

Builddeskriptorwert für den Datenbanknamen, den Sie dem angegebenen "Servernamen" zuordnen möchten.
vgj.jdbc.default.database Gibt den Namen der Standarddatenbank an. Builddeskriptoroptionen sqlDB oder sqlJNDIName
vgj.jdbc.default.database. commitControl Gibt an, ob nach jeder Änderung an der Standarddatenbank eine Commitoperation ausgeführt wird. Gültige Werte sind AUTOCOMMIT, NOAUTOCOMMIT und NOCOMMIT, wie im AbschnittsqlCommitControl beschrieben. Builddeskriptoroption sqlCommitControl
vgj.jdbc.default.database. Programmname Gibt den Namen der Standarddatenbank an, die für eine SQL-E/A-Operation verwendet wird, wenn keine vorherige Datenbankverbindung existiert. EGL nimmt den Programmnamen (oder einen ggf. vorhandenen Programmaliasnamen) als Substitutionswert für Programmname auf, sodass jedes Programm eine eigene Standarddatenbank hat. Der Programmname ist jedoch optional. Für Programme, die nicht von einer programmspezifischen Eigenschaft dieser Art referenziert werden, wird die Eigenschaft vgj.jdbc.default.database als Standard verwendet.

Die Bedeutung des Eigenschaftswertes ist für J2EE-Verbindungen eine andere als für Nicht-J2EE-Verbindungen:

  • Bezogen auf J2EE-Verbindungen ist der Wert der Name, an den die Datenquelle im JNDI-Registry gebunden ist, beispielsweise 'jdbc/MyDB'.
  • Bezogen auf eine Standard-JDBC-Verbindung ist der Wert die Verbindungs-URL, beispielsweise 'jdbc:db2:MyDB'.
Hängt vom folgenden Verbindungstyp ab:
  • Für J2EE-Verbindungen die Builddeskriptoroption sqlJNDIName
  • Für Nicht-J2EE-Verbindungen die Builddeskriptoroption sqlDB
vgj.jdbc.default.database. password Gibt das Kennwort für den Zugriff auf die in vgj.jdbc.default.database angegebene Datenbankverbindung an. Builddeskriptoroption sqlPassword
vgj.jdbc.default.database. userid Gibt die Benutzer-ID für den Zugriff auf die in vgj.jdbc.default.database angegebene Datenbankverbindung an. Builddeskriptoroption sqlID
vgj.jdbc.drivers Gibt die Treiberklasse für den Zugriff auf die in vgj.jdbc.default.database angegebene Datenbankverbindung an. Wenn mehr als eine Treiberklasse vorhanden ist, trennen Sie die Treiberklassen jeweils mit einem Semikolon voneinander. Diese Eigenschaft ist nicht im Deploymentdeskriptor oder in der J2EE-Umgebungsdatei enthalten und wird nur für eine Standard-JDBC-Verbindung (Nicht-J2EE) verwendet. Builddeskriptoroption sqlJDBCDriverClass
vgj.jdbc.pstmt.cache.size Gibt an, wie viele vorbereitete Anweisungen im Laufzeitcache gespeichert werden sollen.

Diese Eigenschaft hat nur Auswirkungen auf Code, der bei folgender auf 'YES' gesetzter Builddeskriptoroption generiert wurde: cachePreparedStatements.

Builddeskriptoroption preparedStatementCacheSize
vgj.messages.file Gibt eine Eigenschaftendatei mit von Ihnen erstellten oder angepassten Nachrichten an. Die Datei wird in folgenden Fällen durchsucht:
  • Die EGL-Laufzeit muss eine Fehlernachricht laden. In diesem Fall können Sie die Nachrichten von EGL mithilfe der Eigenschaft anpassen.
  • Die EGL-Laufzeit antwortet auf den Aufruf der Systemfunktion sysLib.getMessage, die eine von Ihnen erstellte Nachricht zurückgibt.
  • Die EGL-Laufzeit verarbeitet eine ConsoleUI-Anwendung und versucht, Hilfe- oder Kommentartext aus einer in der Systemvariablen consoleLib. messageResource angegebenen Datei bereitzustellen. Diese Variable hat jedoch keinen Wert.
Builddeskriptoroption userMessageFile
vgj.nls.code Gibt den drei Buchstaben umfassenden NLS-Code des Programms an.
Wenn die Eigenschaft nicht angegeben ist, gelten folgende Regeln:
  • Der Wert nimmt standardmäßig den Wert des NLS-Codes an, der der standardmäßig verwendetenJava-Ländereinstellung entspricht.
  • Der Wert lautet 'ENU', wenn die standardmäßig verwendete Java-Ländereinstellung keinem von EGL unterstützten NLS-Code entspricht.
  • Der NLS-Code kann durch Aufrufen der Systemvariablen sysLib.setLocale geändert werden.
Builddeskriptoroption targetNLS
vgj.nls.currency Gibt das als Währungssymbol verwendete Zeichen an. Der Standardwert wird gemäß der für vgj.nls.code angegebenen Ländereinstellung bestimmt. Builddeskriptoroption currencySymbol
vgj.nls.currency.location Gibt an, ob das Währungssymbol vor oder hinter der Zahl angezeigt wird oder ob keine Position für das Symbol zugeordnet ist. Builddeskriptoroption currencyLocation
vgj.nls.number.decimal Gibt das als Dezimalzeichen verwendete Zeichen an. Der Standardwert wird gemäß der für vgj.nls.code angegebenen Ländereinstellung bestimmt. Builddeskriptoroption decimalSymbol
vgj.nls.number.separator Gibt ein Symbol als Trennzeichen für Tausender und Hunderter in einem numerischen Wert an. Builddeskriptoroption seaparatorSymbol
vgj.ra.DN.fileType Gibt den Dateityp an, der in DN bezeichnet ist. Dabei handelt es sich um eine Datei, die im Datensatzabschnitt angegeben ist. Der Eigenschaftswert ist 'seqws' oder 'mq'.

Diese Deploymentdeskriptoreigenschaft müssen Sie für jede von Ihrem Programm verwendete logische Datei angeben.

Builddeskriptoroption fileType
vgj.ra.DN.replace Gibt die Wirkung einer Anweisung add auf einen Datensatz an, der DN zugeordnet ist. DN ist ein in einem Datensatz angegebener Dateiname. Wählen Sie einen der beiden folgenden Werte aus:
  • 1, wenn die Anweisung den Dateisatz ersetzt.
  • 0 (die Standardeinstellung), wenn die Anweisung einen Datensatz an die Datei anhängt.

Der Java-Typ ist in diesem Fall java.lang.integer.

Ressourcenzuordnungseigenschaft replace
vgj.ra.DN.systemName Gibt den Namen der physischen Datei oder Nachrichtenwarteschlange an, die in DN bezeichnet ist. Dies kann ein im Datensatzabschnitt angegebener Datei- oder Warteschlangenname sein.

Diese Deploymentdeskriptoreigenschaft müssen Sie für jede von Ihrem Programm verwendete logische Datei angeben.

Ressourcenzuordnungseigenschaft systemName
vgj.ra.DN.text Gibt an, ob ein generiertes Java-Programm beim Zugriff auf eine Datei über einen seriellen Datensatz veranlasst werden soll, Folgendes zu tun:
  • Anhängen von Zeilenendezeichen während der Operation add. Auf Nicht-UNIX-Plattformen sind dies die Zeichen für Zeilenschaltung und Zeilenvorschub. Auf UNIX-Plattformen ist es nur das Zeichen für Zeilenvorschub.
  • Entfernen von Zeilenendezeichen während der Operation get next.

DN ist der dem seriellen Datensatz zugeordnete Dateiname.

Wählen Sie einen der folgenden Werte aus:
  • 1 für das Ausführen der Änderungen
  • 0 (die Standardeinstellung) für das Nichtausführen von Änderungen

Der Java-Typ ist in diesem Fall java.lang.integer.

Ressourcenzuordnungseigenschaft text
vgj.trace.device.option Ziel für die Trace-Daten. Wählen Sie einen der folgenden Werte aus:
  • 0 für das Schreiben in System.out
  • 1 für das Schreiben in System.err
  • 2 (die Standardeinstellung) für das Schreiben in die von vgj.trace.device.spec angegebene Datei. Ausnahme: VSAM-E/A-Traces werden in vsam.out geschrieben.

Der Java-Typ ist in diesem Fall java.lang.integer.

Der ggf. generierte Wert ist 2.
vgj.trace.device.spec Gibt den Namen der Ausgabedatei an, wenn vgj.trace.device.option auf '2' gesetzt ist. Ausnahme: VSAM-E/A-Traces werden in vsam.out geschrieben. Der generierte Wert (falls vorhanden) ist vgjtrace.out; dies ist der Standardwert.
vgj.trace.type Gibt die Traceeinstellung für die Laufzeit an. Addieren Sie die entsprechenden Werte für die gewünschte Trace-Einstellung:
  • -1 für Gesamt-Trace
  • 0 für keinen Trace (Standardeinstellung)
  • 1 für allgemeinen Trace, einschließlich Funktionsaufrufe und call-Anweisungen
  • 2 für Systemfunktionen, die mathematische Operationen ausführen
  • 4 für Systemfunktionen, die Zeichenfolgen bearbeiten
  • 16 für Daten, die in einer call-Anweisung übergeben werden
  • 32 für die in einem Aufruf verwendeten Verbindungsoptionen
  • 128 für JDBC-E/A
  • 256 für Datei-E/A
  • 512 für alle Eigenschaften mit Ausnahme von vgj.jdbc.default.password

Der Java-Typ ist in diesem Fall java.lang.integer.

Der ggf. generierte Wert ist 0.
In der folgenden Tabelle sind Eigenschaften aus der Programmeigenschaftendatei 'TCPIPListener' aufgeführt.
Laufzeiteigenschaft Beschreibung Quelle des generierten Wertes
tcpiplistener.port

Gibt die Nummer des Ports an, an dem ein EGL-TCP/IP-Empfangsprogramm (der Klasse 'TcpipListener' oder 'TcpipListenerJ2EE') empfangsbereit ist. Für diese Eigenschaft gibt es keinen Standardwert. Weitere Informationen finden Sie im Abschnitt TCP/IP-Listener für aufgerufene J2EE-Anwendungen konfigurieren oder TCP/IP-Listener für aufgerufene Nicht-J2EE-Anwendungen konfigurieren.

Der Java-Typ ist in diesem Fall Java.lang.Integer.

Wird nicht generiert.
tcpiplistener.trace.file Gibt den Namen der Datei an, in der die Aktivitäten von EGL-TCP/IP-Listenern (jeweils der Klasse 'TcpipListener' oder 'TcpipListenerJ2EE') aufgezeichnet werden. Die Standarddatei ist 'tcpiplistener.out'. Wird nicht generiert. Der Trace wird nur von IBM® durchgeführt.
tcpiplistener.trace.flag Gibt an, ob für EGL-TCP/IP-Listener (jeweils der Klasse 'TcpipListener' oder 'TcpipListenerJ2EE') ein Trace der Aktivitäten durchgeführt werden soll. Wählen Sie einen der folgenden Werte aus:
  • 1 für die Erfassung der Aktivitäten in der von der Eigenschaft tcpiplistener.trace.flag angegebenen Datei
  • 0 (Standardeinstellung) für das Nichterfassen der Aktivitäten

Der Java-Typ ist in diesem Fall Java.lang.Integer.

Weitere Informationen finden Sie im Abschnitt TCP/IP-Listener für aufgerufene J2EE-Anwendungen konfigurieren oder TCP/IP-Listener für aufgerufene Nicht-J2EE-Anwendungen konfigurieren.
Wird nicht generiert. Der Trace wird nur von IBM durchgeführt.
Weitere Informationen finden Sie in den Abschnitten zu den folgenden Themen in der EGL-Sprachreferenz:

Feedback