Angepasste Eigenschaften der Java Virtual Machine

Sie können die Administrationskonsole verwenden, um die Werte von angepassten Eigenschaften der Java™ Virtual Machine (JVM) zu ändern.

Anmerkung: Dieser Artikel referenziert eine oder mehrere Protokolldateien des Anwendungsservers. Alternativ dazu wird empfohlen, den Server so zu konfigurieren, dass er die HPEL-Protokoll- und -Traceinfrastruktur (High Performance Extensible Logging) verwendet und nicht die Dateien SystemOut.log , SystemErr.log, trace.log und activity.log auf verteilten oder IBM® i-Systemen. Sie können HPEL auch in Verbindung mit Ihren nativen z/OS-Protokolleinrichtungen verwenden. Wenn Sie HPEL verwenden, können Sie mit dem Befehlszeilentool LogViewer im Verzeichnis "bin" des Serverprofils auf alle Ihre Protokoll- und Tracedaten zugreifen. Weitere Informationen zur Verwendung von HPEL finden Sie in der Dokumentation zum Einsatz von HPEL für die Fehlerbehebung in Anwendungen.

Wenn Sie angepasste Eigenschaften festlegen möchten, stellen Sie eine Verbindung zur Administrationskonsole her, und rufen Sie die Seite mit den angepassten Eigenschaften der entsprechenden Java Virtual Machine auf.

Anwendungsserver Deployment Manager Node Agent

[z/OS]Klicken Sie auf Server > Servertypen und auf WebSphere-Anwendungsserver > Servername bzw. WebSphere-Proxy-Server > Servername. Klicken Sie dann unter "Serverinfrastruktur" auf Java- und Prozessverwaltung > Prozessdefinition und wählen Sie Steuerung, Servant oder Zusatzregion aus. Klicken Sie anschließend auf Java Virtual Machine > Angepasste Eigenschaften.

[AIX Solaris HP-UX Linux Windows][IBM i]Klicken Sie auf Server > Servertypen und auf WebSphere-Anwendungsserver > Servername bzw. WebSphere-Proxy-Server > Servername. Klicken Sie dann unter "Serverinfrastruktur" auf Java- und Prozessverwaltung > Prozessdefinition > Java Virtual Machine > Angepasste Eigenschaften.

[z/OS]Klicken Sie auf Systemverwaltung > Deployment Manager > Java- und Prozessverwaltung > Prozessdefinition > Steuerung > Java Virtual Machine > Angepasste Eigenschaften

[AIX Solaris HP-UX Linux Windows][IBM i]Systemverwaltung > Deployment Manager > Java- und Prozessverwaltung > Prozessdefinition > Java Virtual Machine > Angepasste Eigenschaften

[z/OS] Systemverwaltung > Node Agent > Name_des_Node_Agent > Java- und Prozessverwaltung > Prozessdefinition > Steuerung > Java Virtual Machine > Angepasste Eigenschaften

[AIX Solaris HP-UX Linux Windows][IBM i] Systemverwaltung > Node Agent > Name_des_Node_Agent > Java- und Prozessverwaltung > Prozessdefinition > Java Virtual Machine > Angepasste Eigenschaften

Wenn die angepasste Eigenschaft nicht in der Liste der bereits definierten Eigenschaften aufgeführt ist, erstellen Sie eine neue Eigenschaft, und geben Sie im Feld "Name" den Eigenschaftsnamen und im Feld "Wert" einen gültigen Wert ein. Starten Sie den Server erneut, um Ihre Änderungen abzuschließen.

Sie können auf der Seite "Angepasste Eigenschaften" die folgenden Eigenschaften für die Java Virtual Machine definieren.

allowDeployerRoleGenPluginCfg

Setzen Sie diese angepasste Eigenschaft auf "true", um Benutzern mit der Rolle "Deployer" (Implementierung) die Generierung und Konfiguration der Datei plugin-cfg.xml zu ermöglichen. Starten Sie den Server erneut, nachdem Sie diese angepasste Eigenschaft gesetzt und gespeichert haben.

Wenn die angepasste Eigenschaft fehlt oder den Wert "false" hat, können die folgenden Situationen eintreten, wenn der Benutzer die Berechtigungen der Rolle "Deployer" besitzt:
  • Die Generierungs- und Konfigurationsprozesse scheitern.
  • Es wird eine Fehlernachricht ausgegeben.

Zum Inaktivieren dieser Funktion löschen Sie die angepasste Eigenschaft, oder setzen Sie sie auf false.

Sie können diese angepasste Eigenschaft auch mit dem Tool "wsadmin" und dem folgenden Jacl-Script über die Befehlszeile definieren:
#-------------------------------------------------------------------------
# setAllowDeployer.jacl - Jacl-Script für Definition der Eigenschaft "allowDeployerRoleGenPluginCfg"
# des Web-Server-Plug-ins für WebSphere Application Server.
#-------------------------------------------------------------------------
#    Diese Jacl-Datei ändert die Datei "server.xml" für einen Anwendungsserver.
#    Dieses Script muss aufgerufen werden, während der Anwendungsserver aktiv ist.
#
#    Es folgt ein Beispiel für den Aufruf des Scripts:
#	   wsadmin -f setAllowDeployer.jacl <Knotenname> <Servername> <enable-Wert>

#------------------------------------------------------------------------
proc printUsageAndExit {} {
     puts " "
     puts "Usage: wsadmin -f setAllowDeployer.jacl &ltnodeName> <serverName> <boolEnable>"
     puts "Note: enableValue argument is of type boolean; valid values
are true and false."	
     exit
 }
 if { [llength $argv] >= 3 } {
     set nodename [lindex $argv 0]
     set servername [lindex $argv 1]
     set enablevalue [lindex $argv 2]
 } else {
     printUsageAndExit
 }  

set cellname [$AdminControl getCell]
set propname "allowDeployerRoleGenPluginCfg" 
set propdesc "Allow conditional deployer role for plug-in generation
and propagation" 
set required "false"  

set jvm [$AdminConfig getid 
/Cell:${cellname}/Node:${nodename}/Server:${servername}/JavaProcessDef:/JavaVirtualMachine:/]

$AdminConfig modify $jvm [subst {{systemProperties {{{name {$propname}}
{value {$enablevalue}} 
{description {$propdesc}} {required {$required}}}}}}]  
$AdminConfig save   

exit 0
Syntax:
wsadmin -f setAllowDeployer.jacl Knotenname Servername true

com.ibm.cacheLocalHost

Setzen Sie diese Eigenschaft auf "true", damit IBM SDK for Java die von java/net/InetAddress.getLocalHost zurückgegebene IP-Adresse während der Lebensdauer der JVM zwischenspeichert. Dies ist eine Leistungsverbesserung, die für alle Prozesse empfohlen wird, wenn sich die Adresse des lokalen Hosts während der Ausführung nicht ändert.

Anmerkung: Die Adresse für Server, die über DHCP konfiguriert sind, kann sich im Lauf der Zeit ändern. Daher sollte diese Eigenschaft nur festgelegt werden, wenn Sie für Ihre Server statisch zugeordnete IP-Adressen verwenden.

com.ibm.apc.nodeMMTimeout

Wenn Sie einen Knoten in den Wartungsmodus versetzen und APC auf "automatic" gesetzt ist, setzt der Deployment Manager standardmäßig ein Zeitlimit von 20 Minuten für die Operation im Wartungsmodus. Dies kann geändert werden, indem das generische JVM-Argument -DnodeMMTimeout im Deployment Manager festgelegt und der Deployment Manager erneut gestartet wird. Beispielsweise könnten Sie für -DnodeMMTimeout den Wert 60 festlegen, um ein Zeitlimit von 60 Minuten für die Operation im Wartungsmodus festzulegen. In diesem Zusammenhang kann die Einstellung apcConcurrentStartSize dabei helfen, die Zeit zu verkürzen, die APC zum Ausführen der Operation im Wartungsmodus benötigt, und weitere Angaben wie min != max für den dynamischen Cluster können die Wahrscheinlichkeit reduzieren, dass APS Änderungen vornehmen muss.

com.ibm.config.allow.set.session.timeout

Setzen Sie diese angepasste Eigenschaft, um das Verhalten von PI20040 für das Element session-timeout von web.xml zurückzusetzen.

Wenn Sie das aktualisierte Verhalten von PI20040 nutzen möchten, legen Sie keine Einstellungen für diese angepasste Eigenschaft fest.

Standardmäßig wird das aktualisierte Verhalten von PI20040 abgerufen. Das aktualisierte Verhalten ist gemäß der Servletspezifikation korrekt und stellt das neue Standardverhalten beim Schreiben von session-timeout-Werten dar. Die angepasste Eigenschaft wird bereitgestellt, um das frühere Verhalten wieder zu aktivieren.

com.ibm.config.eclipse.wtp.enablejemtrim

Verwenden Sie diese angepasste Eigenschaft, um die Bereinigung temporärer DOM-Knoten nach dem XML-Parsing der Metadaten für eine Anwendung zu aktivieren.

Fehler vermeiden Fehler vermeiden: Die Einstellung für diese Eigenschaft muss mit der Einstellung für die angepasste Eigenschaft com.ibm.config.eclipse.wtp.enablexmltrim übereinstimmen. Entweder müssen beide Eigenschaften nicht definiert, auf false oder auf true gesetzt werden.gotcha

Der Standardwert ist false.

com.ibm.config.eclipse.wtp.enablexmltrim

Verwenden Sie diese angepasste Eigenschaft, um die gemeinsame Nutzung der JavaClass-Instanzen und die Konvertierung erweiterter JavaClass- und JavaMethod-Objekten nach ihrer Verwendung in schlanke Proxys zu ermöglichen.

Fehler vermeiden Fehler vermeiden: Die Einstellung für diese Eigenschaft muss mit der Einstellung für die angepasste Eigenschaft com.ibm.config.eclipse.wtp.enablejemtrim übereinstimmen. Entweder müssen beide Eigenschaften nicht definiert, auf false oder auf true gesetzt werden.gotcha

Der Standardwert ist false.

com.ibm.config.eclipse.wtp.jem=finer

Verwenden Sie diese angepasste Eigenschaft, um einen Trace aus Codebereichen zu generieren, die aktiviert werden, wenn die angepasste Eigenschaft com.ibm.config.eclipse.wtp.enablejemtrim auf true gesetzt wird.

Fehler vermeiden Fehler vermeiden: Diese Eigenschaft kann sich auf die Leistung auswirken. Deshalb darf diese Eigenschaft nur angegeben werden, wenn während der Bereinigung temporärer DOM-Knoten nach dem XML-Parsing der Metadaten für eine Anwendung ein Problem auftritt und Sie weitere Informationen für die Diagnose der Problemursache benötigen.gotcha

com.ibm.config.eclipse.wtp.xmltrim=finer

Verwenden Sie diese angepasste Eigenschaft, um einen Trace aus Codebereichen zu generieren, die aktiviert werden, wenn die angepasste Eigenschaft com.ibm.config.eclipse.wtp.enablexmltrim auf true gesetzt wird.

Fehler vermeiden Fehler vermeiden: Diese Eigenschaft kann sich auf die Leistung auswirken. Deshalb darf diese Eigenschaft nur angegeben werden, wenn bei der gemeinsamen Nutzung von JavaClass-Instanzen oder der Konvertierung erweiterter JavaClass- und JavaMethod-Objekten nach deren Verwendung in schlanke Proxys ein Problem auftritt und Sie weitere Informationen für die Diagnose der Problemursache benötigen.gotcha

com.ibm.disableCommonsElCache

Legen Sie den Wert true für die angepasste Eigenschaft com.ibm.wsspi.jsp.disableElCache des Web-Containers fest, um den Cache für commons-el-Ausdrücke zu inaktivieren, wenn es zu abnormalen Speicherbedingungen kommt, weil die Hash-Tabellen vom Auswertungsprogramm für die Ausdrücke gesperrt werden.

Der Standardwert ist "false".

[AIX][HP-UX][IBM i][Linux][Solaris][z/OS]

com.ibm.eclipse.wtp.allowRootedEntries

In früheren Service-Releases werden Eigenschaftsdateien, die sich Stammverzeichnis eines Unternehmensarchivs (EAR-Datei) befinden, nicht ordnungsgemäß gelesen. Daher wurde das Verhalten ab dem vorliegenden Release dahingehend geändert, dass der Klassenpfad in Dateien des Typs META-INF und MANIFEST.MF als relativer URI gehandhabt wird. Wenn Sie eine Zurücksetzung auf das ursprüngliche Verhalten erreichen möchten, setzen Sie die Eigenschaft "com.ibm.eclipse.wtp.allowRootedEntries" auf true.

com.ibm.ejs.ras.disablerasnotifications

Mit dieser Eigenschaft können Sie den RAS-Service inaktivieren und aktivieren. Wenn Sie diese Eigenschaft auf true setzen, werden RAS-Services inaktiviert. Der Standardwert für diese Eigenschaft ist "false".

com.ibm.ejs.ras.writeSystemStreamsDirectlyToFile

Verwenden Sie diese angepasste Eigenschaft, um die angepasste JSR-47-Protokollierung in den SystemOut-Datenstrom ohne das Format von WebSphere Application Server zu unterstützen. Das Format von WebSphere Application Server enthält Informationen, wie z. B. die Zeitmarke, die Thread-ID usw. Möglicherweise möchte eine Anwendung nicht, dass diese Informationen im SystemOut-Datenstrom erscheinen. (Oder sie bevorzugt, dass die Informationen in einem anderen Format erscheinen.) Zum Inaktivieren des Formats von WebSphere Application Server setzen Sie diese angepasste Eigenschaft auf true.

com.ibm.ejs.sm.server.quiesceInactiveRequestTime

Verwenden Sie diese angepasste Eigenschaft, um anzugeben, wie schnell (in Millisekunden) IIOP-Anforderungen über den Object Request Broker (ORB) empfangen und verarbeitet werden können. Wenn Sie beispielsweise den Wert "5000" für diese Eigenschaft festlegen, versucht der Server erst dann einen Systemabschluss durchzuführen, wenn Anforderungen erst in einem Abstand von mindestens 5 Sekunden eingehen. Wenn der für diese Eigenschaft angegebene Wert zu groß ist und der Anwendungsserver über die Administrationskonsole gestoppt wird, kann die folgende Fehlernachricht ausgegeben werden:
Beim Stoppen von Server1 ist ein Fehler aufgetreten. Suchen Sie in den Fehlerprotokollen nach weiteren Informationen.

Der Standardwert ist "5000" (5 Sekunden).

Wenn Sie sich für die Verwendung dieser angepassten Eigenschaft entscheiden, können Sie sie als angepasste JVM-Eigenschaft für einen Anwendungsserver, einen Node Agent oder einen Deployment Manager angeben. Sie wird gewöhnlich als angepasste JVM-Eigenschaft eines Anwendungsservers definieren.

com.ibm.ejs.sm.server.quiesceTimeout

Verwenden Sie diese angepasste Eigenschaft, um die Gesamtlänge (in Sekunden) des Quiesce-Zeitlimits anzugeben. Wenn nach Ablauf dieses Zeitlimits immer noch eine Anforderung ansteht, kann der Server mit dem Systemabschluss beginnen. Der Wert "180" steht beispielsweise für 3 Minuten. Wenn die Quiesce-Zeit überschritten wird, weist die Workloadregulierung alle ankommenden Anforderungen zurück und der Server wird heruntergefahren.
Anmerkung: Die Nachricht WTRN0036W wird abgesetzt, wenn ausstehende Transaktionen vorhanden sind, während sich der Server im Quiesce-Status befindet.
Der Standardwert ist "180".
Anmerkung: Wenn der Zeitlimitwert auf null gesetzt ist, ist die Quiesce-Funktion inaktiviert.

Wenn Sie sich für die Verwendung dieser angepassten Eigenschaft entscheiden, können Sie sie als angepasste JVM-Eigenschaft für einen Anwendungsserver, einen Node Agent oder einen Deployment Manager angeben. Sie wird gewöhnlich als angepasste JVM-Eigenschaft eines Anwendungsservers definieren.

com.ibm.ffdc.log

Verwenden Sie diese angepasste Eigenschaft, um anzugeben, wo FFDC-Daten (First Failure Data Capture, Erfassung von Fehlerdaten beim ersten Auftreten) gespeichert werden sollen, wenn während der Laufzeitverarbeitung des Produkts ein Fehler auftritt. Das FFDC-Feature erfasst unverzüglich Daten zu den Ereignissen und Bedingungen, die zum Fehler geführt haben. Die erfassten Daten können dann zur Fehleranalyse verwendet werden. Nachdem die Daten erfasst und in einer Protokolldatei gespeichert wurden, gibt das FFDC-Feature die Steuerung an die betroffenen Engines zurück.

Verwendungsbeispiel für das Angeben einer Ordnerposition für die Protokolldatei:
Name: com.ibm.ffdc.log
Wert: C:\my_FFDC_CP\
Verwendungsbeispiel für das Angeben eines tatsächlichen Dateinamens für die Protokolldatei:
Name: com.ibm.ffdc.log
Wert: C:\my_FFDC_CP_log

com.ibm.websphere.application.updateapponcluster.waitforappsave

Verwenden Sie diese angepasste Eigenschaft, um anzugeben, wie lange (in Sekunden) der Deployment Manager auf den Abschluss der Erweiterungstasks der Sicherungsoperation warten soll, bevor er die aktualisierte Anwendung startet.

Fehler vermeiden Fehler vermeiden: Diese Eigenschaft ist nur gültig, wenn sie für einen Deployment Manager angegeben wird. gotcha

Gewöhnlich werden die Erweiterungstasks der Sicherungsoperation während einer Anwendungsaktualisierung, die über den Aktualisierungsprozess "Rollout" ausgeführt wird, als Hintergrundoperation in einem separaten Thread ausgeführt. Wenn der Hauptthread der Sicherungsoperation vor der Synchronisationsphase des Rollout-Prozesses abgeschlossen ist, wird die aktualisierte Anwendung nicht ordnungsgemäß gestartet.

Wenn Sie diese angepasste Eigenschaft den Einstellungen Ihres Deployment Manager hinzufügen und die Erweiterungstasks der Sicherungsoperation nicht innerhalb des festgelegten Zeitraums abgeschlossen werden, stoppt der Rollout-Prozess die Anwendungsaktualisierung und verhindert damit, dass die Anwendung in der Synchronisationsphase des Rollout-Prozesses beschädigt wird.

Der Standardwert ist "180".

[z/OS]

com.ibm.websphere.bean.delete.sleep.time

Mit dieser Eigenschaft geben Sie das Intervall an, in dem nach Beans gesucht wird, die das zulässige Zeitlimit überschritten haben. Der Wert wird in Sekunden angegeben. Beispiel: 120 entspricht 2 Minuten. Außerdem steuert diese Eigenschaft das Intervall im Servant-Prozess, in dem Beans gesucht werden, die das zulässige Zeitlimit überschritten haben, aber weiterhin für den EJB-Container sichtbar sind.

Der Standardwert ist 4200 (70 Minuten). Der Mindestwert ist 60 (1 Minute). Der Wert kann in der Administrationskonsole geändert werden. Wenn Sie diese Eigenschaft anwenden möchten, müssen Sie den Wert in der Steuerung und in den angepassten Eigenschaften der Servant-JVM angeben.

com.ibm.websphere.deletejspclasses

Mit dieser Eigenschaft können Sie angeben, dass die JSP-Klassen für alle Anwendungen gelöscht werden sollen, nachdem diese Anwendungen gelöscht oder aktualisiert wurden. Der Standardwert ist false.

Fehler vermeiden Fehler vermeiden: In einer Network Deployment-Umgebung gilt diese Eigenschaft für WebSphere Application Server.gotcha

Legen Sie diese Eigenschaft für einen Node Agent fest, wenn der Server in einer eingebundenen Zelle ausgeführt wird.

com.ibm.websphere.deletejspclasses.delete

Mit dieser Eigenschaft können Sie angeben, dass die JSP-Klassen für alle Anwendungen gelöscht werden sollen, nachdem diese Anwendungen gelöscht wurden, aber nicht, nachdem sie aktualisiert wurden. Der Standardwert ist false.

Fehler vermeiden Fehler vermeiden: In einer Network Deployment-Umgebung gilt diese Eigenschaft für WebSphere Application Server.gotcha

Legen Sie diese Eigenschaft für einen Node Agent fest, wenn der Server in einer eingebundenen Zelle ausgeführt wird.

com.ibm.websphere.deletejspclasses.update

Mit dieser Eigenschaft können Sie angeben, dass die JSP-Klassen für alle Anwendungen gelöscht werden sollen, nachdem diese Anwendungen aktualisiert wurden, aber nicht, nachdem sie gelöscht wurden. Der Standardwert ist false.

Fehler vermeiden Fehler vermeiden: In einer Network Deployment-Umgebung gilt diese Eigenschaft für WebSphere Application Server.gotcha

Legen Sie diese Eigenschaft für einen Node Agent fest, wenn der Server in einer eingebundenen Zelle ausgeführt wird.

com.ibm.websphere.ejb.UseEJB61FEPScanPolicy

Mit dieser Eigenschaft können Sie steuern, ob das Produkt Module einer Version vor Java EE 5 während der Anwendungsinstallation oder während des Serverstarts nach weiteren Metadaten durchsucht. Standardmäßig werden diese traditionellen EJB-Module nicht gescannt.

Der Standardwert ist false.

Sie müssen diese Eigenschaft für jeden Server und jeden Verwaltungsserver auf true setzen, der eine Änderung des Standardwerts erfordert.

Wenn Sie sich für die Verwendung dieser angepassten Eigenschaft entscheiden, müssen Sie sie als angepasste JVM-Eigenschaft des Anwendungsservers definieren.

com.ibm.websphere.ejbcontainer.expandCMPCFJNDIName

Der EJB-Container muss die Erweiterung des JNDI-Namens der CMP-Verbindungsfactory zulassen, wenn der JNDI-Name eines Benutzers eine benutzerdefinierte Variable von Application Server enthält. Der JNDI-Name der CMP-Verbindungsfactory kann über die angepasste Eigenschaft com.ibm.websphere.ejbcontainer.expandCMPCFJNDIName erweitert werden.

Wenn die Eigenschaft den Wert true hat, erweitert der EJB-Container eine Variable, die im JNDI-Namen der CMP-Verbindungsfactory gefunden wird. Hat die Eigenschaft den Wert false, erweitert der EJB-Container die Variablen nicht.

Wenn Sie sich für die Verwendung dieser angepassten Eigenschaft entscheiden, müssen Sie sie als angepasste JVM-Eigenschaft des Anwendungsservers definieren.

com.ibm.websphere.ejbcontainer.includeRootExceptionOnRollback

Verwenden Sie diese angepasste EJB-Eigenschaft (Enterprise JavaBeans), um die folgenden Funktionen zu aktivieren:
  • Zulassen, dass die Ursache des Rollbacks einer Transaktion in eine Ausnahme des Typs "TransactionRolledbackLocalException" aufgenommen wird, falls die Transaktion von einem lokalen aufrufenden Programm ausgeführt wird.
  • Zulassen, dass die Ursache des Rollbacks der Transaktion nach Ausführung einer Commit-Methode in eine Ausnahme des Typs "TransactionRolledbackLocalException" aufgenommen wird, falls die Transaktion von einem fernen aufrufenden Programm ausgeführt wird.
  • Die Rückgabe heuristischer Ausnahmebedingungen anstelle einer TransactionRolledbackLocalException (für einen lokalen Client) oder einer TransactionRolledbackLocalException (für einen fernen Client) zulassen.
  • Zulassen, dass eine RemoteException von einer fernen EJB-Methode zurückgegeben wird, auch wenn diese Methode im Kontext der Aufruftransaktion ausgeführt wird. Beispiel: Angenommen, EJB1, Methode m1 startet eine Transaktion und ruft EJB2, Methode m2 auf. m2 löst eine nicht behandelte Ausnahmebedingung aus. In diesem Fall empfängt m1 gemäß EJB-Spezifikation eine TransactionRolledbackException. Wenn Sie diese Eigenschaft auf "true" setzen, wird eine RemoteException, die alle verschachtelten Ausnahmebedingungen umfasst, anstelle der Ausnahme des Typs "TransactionRolledbackException" zurückgegeben, auch wenn dies den Anforderungen der EJB-Spezifikation widerspricht.

Zum Aktivieren dieser Funktion müssen Sie diese Eigenschaft auf true setzen. Zum Inaktivieren dieser Funktion müssen Sie diese Eigenschaft auf false setzen.

Der Standardwert ist false.

Wenn Sie sich für die Verwendung dieser angepassten Eigenschaft entscheiden, müssen Sie sie als angepasste JVM-Eigenschaft des Anwendungsservers definieren.

com.ibm.websphere.jaxrpc.stub.typemapping.per.thread

Verwenden Sie diese Eigenschaft, um anzuzeigen, ob die JAX-RPC-Laufzeit threadspezifische Objekte für die Zuordnung von Inhaltstypen verwenden soll.

Die JAX-RPC-Laufzeit verwendet eine einzelnes TypeMappingRegistry-Objekt für alle JAX-RPC-Clients. Dieses Verhalten ist erwünscht und erlaubt Ihnen, einen JAX-RPC-Stub zu erstellen und für mehrere Threads zu verwenden. Allerdings wird die Singleton-TypeMappingRegistry verfälscht, wenn mehrere JAX-RPC-Web-Services mit verschiedenen Zuordnungen gleichzeitig aufgerufen werden. Diese Situation tritt zwar nicht oft ein, doch wenn das der Fall sein sollte, können Sie die angepasste Eigenschaft com.ibm.websphere.jaxrpc.stub.typemapping.per.thread auf true setzen, um für die JAX-RPC-Laufzeit festzulegen, dass sie threadspezifische Objekte für die Zuordnung von Inhaltstypen verwenden kann. Diese eigenständigen Zuordnungsobjekte vermeiden das Problem der Verfälschung, und die verschiedenen Web-Service-Aufrufe können ausgeführt werden.

Der Standardwert ist false.

Fehler vermeiden Fehler vermeiden: Sie sollten diese angepasste Eigenschaft nur verwenden, wenn eine Situation eintritt, in der die Singleton-TypeMappingRegistry verfälscht wird. Wenn Sie diese Eigenschaft aktivieren, können Anwendungen, die davon abhängig sind, über mehrere Threads auf denselben JAX-RPC-Stub zuzugreifen, zurückgesetzt werden. gotcha

com.ibm.websphere.jaxrs.server.DisableIBMJAXRSEngine

Verwenden Sie diese Eigenschaft, um die automatische Verarbeitung Ihrer JAX-RS-Anwendungen durch die Laufzeit der JAX-RS-Integration inaktivieren möchten. Der Standardwert ist false.
Fehler vermeiden Fehler vermeiden: Wenn Sie diese Eigenschaft auf den Wert true setzen, wird auch die Integration der IBM JAX-RS-Laufzeit in EJB und JCDI inaktiviert.gotcha

com.ibm.websphere.logging.useJULThreadID

Verwenden Sie diese Eigenschaft, um den Typ der in den Protokolldateien von WebSphere Application Server verwendeten Thread-ID zu steuern.

Wenn Sie diese Eigenschaft auf true setzen, werden LogRecord-Instanzen verwendet, um die Thread-ID abzurufen. Wenn Sie diese Eigenschaft auf false setzen, werden Threadinstanzen verwendet, um die Thread-ID abzurufen.

Der Standardwert ist false.

Hinweis zur Umstellung Hinweis zur Umstellung: Ab Version 8.5 ist der Standardwert für diese Eigenschaft false. In früheren Versionen hat die Eigenschaft com.ibm.websphere.logging.useJULThreadID den Standardwert true.trns

com.ibm.websphere.management.application.client.EnvEntry_processBindings

Mit dieser Eigenschaft können Sie festlegen, wie ein Umgebungseintrag während einer Anwendungsimplementierung behandelt wird.

Wenn diese Eigenschaft den Wert "false" hat, wird ein Umgebungseintrag aus dem Implementierungsdeskriptor gelesen und in diesen geschrieben. Ein in den XML-Bindungen angegebener Wert für den Umgebungseintrag wird ignoriert.

Wenn diese Eigenschaft nicht angegeben wird oder den Wert "true" hat, erhält ein in den XML-Bindungen angegebener Wert für den Umgebungseintrag Vorrang vor dem im Implementierungsdeskriptor angegebenen Wert. Die Umgebungseinträge aus Annotationen werden verarbeitet. Der Standardwert ist true.

Wenn eine Anwendung mit aktivierter Eigenschaft com.ibm.websphere.management.application.client.EnvEntry_processBindings implementiert und anschließend zur Implementierung in einer Umgebung vor Version 8.0 exportiert wird, wird der Wert des Umgebungseintrags in den XML-Bindungen weder von der Implementierungsumgebung noch von der Laufzeitumgebung erkannt.

Wenn eine Anwendung mit aktivierter Eigenschaft com.ibm.websphere.management.application.client.EnvEntry_processBindings implementiert und anschließend zur Implementierung in eine Umgebung der Version 8.0 oder höher exportiert wird, wird der Wert des Umgebungseintrags in XML-Bindungen von der Implementierungsumgebung nicht erkannt, aber er wird von der Laufzeitumgebung erkannt.

Fehler vermeiden Fehler vermeiden: Die angepasste Eigenschaft "com.ibm.websphere.management.application.client.EnvEntry_processAnnotations" sollte nicht in die JVM-Konfigurationseinstellungen aufgenommen werden, wenn die angepasste Eigenschaft com.ibm.websphere.management.application.client.EnvEntry_processBindings auf den Wert "true" gesetzt wurde.gotcha
Fehler vermeiden Fehler vermeiden: Wenn Ihre Umgebung Knoten mit einer früheren Version als Version 8.0 enthält und eine Anwendung für einen solchen Knoten bestimmt ist, setzen Sie diese Eigenschaft auf den Wert "false", falls in der Anwendung ein Umgebungseintrag definiert ist und der Wert dieses Umgebungseintrags während der Implementierung (einschließlich Installation, Bearbeitung oder Aktualisierung) bereitgestellt oder geändert wird. Andernfalls schlägt die Anwendungsimplementierung fehl. gotcha

com.ibm.websphere.management.application.fullupdate

Verwenden Sie diese Eigenschaft, um festzulegen, dass das Verzeichnis mit den Binärdateien gelöscht und der Inhalt der aktualisierten EAR-Datei vollständig extrahiert werden soll, wenn Anwendungen aktualisiert werden.

Wenn Sie diese Eigenschaft nicht angeben, wird jede geänderte Datei in einer aktualisierten EAR-Datei einzeln aktualisiert und auf dem Knoten synchronisiert. Dieser Prozess kann für große Anwendungen sehr zeitaufwendig sein, wenn viele Dateien geändert werden.

Wenn Sie die Einstellung com.ibm.websphere.management.application.fullupdate auf:
  • true setzen, wird das Verzeichnis mit den Binärdateien gelöscht und der Inhalt der aktualisierten EAR-Datei vollständig extrahiert, wenn Anwendungen aktualisiert werden.
  • false setzen, werden nur die geänderten Dateien in der EAR-Datei auf dem Knoten aktualisiert und synchronisiert, wenn Anwendungen aktualisiert werden.
Fehler vermeiden Fehler vermeiden:
  • Verwenden Sie die Eigenschaft com.ibm.websphere.management.application.fullupdateAnwendungsname, wenn Sie eine vollständige Ersetzung nur für eine bestimmte Anwendung und nicht für alle Anwendungen durchführen möchten.
  • Sie müssen diese Eigenschaft in der JVM des Deployment Manager definieren.
gotcha

com.ibm.websphere.management.application.fullupdate.Anwendungsname

Verwenden Sie diese Eigenschaft, um festzulegen, dass das Verzeichnis mit den Binärdateien gelöscht und der Inhalt der aktualisierten EAR-Datei vollständig extrahiert werden soll, wenn eine bestimmte Anwendung aktualisiert wird.

Wenn Sie diese Eigenschaft nicht angeben, werden alle geänderten Datei in einer aktualisierten EAR-Datei für die angegebene Anwendung einzeln aktualisiert und auf dem Knoten synchronisiert. Dieser Prozess kann für große Anwendungen sehr zeitaufwendig sein, wenn viele Dateien geändert werden.

Wenn Sie die Eigenschaft com.ibm.websphere.management.application.fullupdate.Anwendungsname auf:
  • true setzen, wird das Verzeichnis mit den Binärdateien gelöscht und der Inhalt der aktualisierten EAR-Datei vollständig extrahiert, wenn die angegebene Anwendung aktualisiert wird.
  • false setzen, werden nur die geänderten Dateien auf dem Knoten aktualisiert und synchronisiert, wenn die angegebene Anwendung aktualisiert wird.
Fehler vermeiden Fehler vermeiden:
  • Verwenden Sie die Eigenschaft com.ibm.websphere.management.application.fullupdate, um festzulegen, dass das Verzeichnis mit den Binärdateien gelöscht und der Inhalt der aktualisierten EAR-Datei vollständig extrahiert werden soll, wenn Anwendungen aktualisiert werden.
  • Sie müssen diese Eigenschaft in der JVM des Deployment Manager definieren.
gotcha

com.ibm.websphere.management.application.keepExistingSharedLibraries

Mit dieser Eigenschaft können Sie festlegen, wie Zuordnungen gemeinsam genutzter Bibliotheken bei Anwendungsaktualisierungen behandelt werden.

Wenn diese Eigenschaft auf false gesetzt wird, müssen die während der Anwendungsaktualisierung angegebenen gemeinsam genutzten Bibliotheken die ursprünglichen Zuordnungen ersetzen. "False" ist die Standardeinstellung.

Wenn diese Eigenschaft auf true gesetzt wird, enthalten die Anwendungs- und Modulkonfigurationen nach der Aktualisierung der Anwendung die ursprünglichen Einstellungen für die gemeinsam genutzten Bibliotheken zusätzlich zu denen, die während der Aktualisierung angegeben wurden.

com.ibm.websphere.management.application.persistWebContext

Legen Sie mit dieser Eigenschaft fest, ob das Kontextstammverzeichnis und die Informationen zu virtuellen Hosts für Webmodule in der Datei "deployment.xml" festgeschrieben werden. Wenn Sie diese Eigenschaft nicht angeben, stützt sich die Anwendungsimplementierung auf die Annotationsverarbeitung, bei der das Kontextstammverzeichnis und die Informationen zu den virtuellen Hosts gelesen werden, was sich auf die Leistung der Anwendungsimplementierung auswirkt.

Wenn Sie diese Eigenschaft auf true setzen, werden Kontextstammverzeichnis und Informationen zu den virtuellen Hosts für Webmodule in der Datei "deployment.xml" gespeichert, und die gespeicherten Daten werden für die Validierung der Anwendungsimplementierung verwendet, was die Leistung der Anwendungsimplementierung verbessert.

Der Standardwert ist false, d. h., die Informationen zum Kontextstammverzeichnis und zu den virtuellen Hosts für Webmodule werden nicht in der Datei "deployment.xml" gespeichert.

com.ibm.websphere.management.application.sync.recycleappasv5

Verwenden Sie diese Eigenschaft, wenn Sie für Ihre Anwendung dasselbe Neustartverhalten verwenden möchten wie in den Versionen von Version 6.x des Produkts.

In Version 6.x und höher werden nach einer Anwendungsaktualisierung oder Bearbeitungsoperation je nach geänderten Dateien entweder die Anwendungen oder die Module der Anwendungen automatisch gestoppt und erneut gestartet. Dieser Neustartprozess wird nach allen Änderungen an der Konfigurationsdatei der Anwendung und allen Änderungen an nicht statischen Dateien durchgeführt.

In den Versionen vor Version 6.x des Produkts wird eine Anwendung jedoch nur dann gestoppt und erneut gestartet, wenn die EAR-Datei selbst aktualisiert wird oder wenn sich das URL-Attribut der Binärdateien ändert. Eine Anwendung wird nicht gestoppt und erneut gestartet, wenn Änderungen an der Anwendungskonfigurationsdatei vorgenommen werden.

Wenn Sie die Eigenschaft "com.ibm.websphere.management.application.sync.recycleappasv5" auf
  • true setzen, wird für Ihre Anwendung dasselbe Neustartverhalten verwendet wie in den Versionen vor Version 6.x des Produkts.
  • false setzen, wird für Ihre Anwendung das Neustartverhalten nach dem Schema der Version 6.x und höher verwendet.

Der Standardwert ist false.

Fehler vermeiden Fehler vermeiden: Sie müssen diese Eigenschaft in der JVM des Node Agent definieren. Wenn Sie diese Eigenschaft definieren, können Sie jedoch die Zelle als Geltungsbereich angeben, wenn die Einstellung für alle Knoten in einer bestimmten Zelle gelten soll. Wird diese Eigenschaft auf Zellen- und auf Node-Agent-Ebene definiert, hat die Einstellung des Node Agents für diesen bestimmten Node Agent Vorrang.gotcha

com.ibm.websphere.management.application.updateClusterTask.serverStopWaitTimeout

Verwenden Sie diese Eigenschaft, um anzugeben, wie lange (in Sekunden) der Deployment Manager auf die vollständige Beendigung des Servers in der Task "$AdminTask updateAppOnCluster" wartet. Standardmäßig wartet der Deployment Manager 60 Sekunden. Der Zeitwert, den Sie für diese Eigenschaft angeben, muss größer sein als die Zeit, die es maximal dauert, um einen Server im Cluster zu stoppen.

Diese Eigenschaft kann nur angegeben werden, wenn Sie Version 7.0.0.1 oder höher verwenden.

Fehler vermeiden Fehler vermeiden: Diese Eigenschaft ist nur gültig, wenn sie für einen Deployment Manager angegeben wird. gotcha

com.ibm.websphere.management.application.updatesync.appExpansionTimeout

Verwenden Sie diese Eigenschaft, um anzugeben, wie lange der Deployment Manager nach einer Anwendungsaktualisierung auf den Start eines Anwendungsservers wartet. In dieser Wartezeit können die Binärdateien für die Anwendung nach Abschluss des Aktualisierungsprozesses in die entsprechenden Verzeichnisse extrahiert werden. Der Wert, den Sie für diese Eigenschaft angeben, sollte der maximalen Zeit entsprechen, die die Anwendungen dem Knoten benötigen, um ihre Binärdateien vollständig zu extrahieren.

Standardmäßig wartet die Rollout-Funktion bei Aktualisierungen 60 Sekunden nach einer Aktualisierung einer oder mehrerer Anwendungen auf die Extraktion jeder Anwendung. Da die Rollout-Funktion für die Aktualisierung mehrerer Anwendung gleichzeitig verwendet werden kann, ist der Standardwert für diese Eigenschaft n x 60 Sekunden, wobei n für die Anzahl der zu aktualisierenden Anwendungen steht.

Diese Standardwartezeit kann jedoch für größere Anwendungen nicht ausreichend sein. Falls eine oder mehrere Anwendungen nach der Anwendungsaktualisierung nicht gestartet werden, wenn der Server gestartet wird, müssen Sie unter Umständen die Zeit verlängern, die die Rollout-Funktion wartet, bevor sie den Server startet.

Fehler vermeiden Fehler vermeiden: Diese Eigenschaft ist nur gültig, wenn sie für einen Deployment Manager angegeben wird. gotcha

com.ibm.websphere.management.configservice.getServerLogRootFromTemplate

Mit dieser Eigenschaft können Sie festlegen, ob der Wert, der für die in einer Serverschablone definierte Variable SERVER_ROOT festgelegt ist, oder der Wert von {LOG_ROOT}/serverName beim Erstellen eines Anwendungsservers oder Cluster-Members verwendet werden sollte.

Wenn Sie einen Anwendungsserver oder ein Cluster-Member erstellen, wird normalerweise immer der Wert von {LOG_ROOT}/serverName anstelle des Werts der in einer vorhandenen Serverschablone definierten Variablen SERVER_ROOT verwendet. Wenn Sie beim Erstellen eines Anwendungsservers oder Cluster-Members stattdessen den Wert der in einer Serverschablone definierten Variablen SERVER_ROOT verwenden möchten, setzen Sie diese Eigenschaft auf true.

Wenn Sie diese angepasste Eigenschaft verwenden, müssen Sie sie für den Deployment Manager definieren.

Wenn Sie wsadmin im Modus "Verbunden" verwenden, legen Sie diese Eigenschaft mit dem Befehl "AdminTask.setJVMSystemProperties" auf der Ebene des Deployment Manager fest.

Wenn Sie wsadmin im lokalen Modus verwenden (conntype=none), kann diese Eigenschaft als Java-Option ("javaoption") übergeben werden:
wsadmin -conntype none -javaoption
"-Dcom.ibm.websphere.management.configservice.getServerLogRootFromTemplate=true"

com.ibm.websphere.management.configservice.sessionIdUniqueness

Verwenden Sie diese Eigenschaft, um zu verhindern, dass die Konfigurationssitzungs-ID oder die Arbeitsbereichs-ID doppelt erstellt wird. Wenn unterschiedliche Prozesse zufällig generierte Konfigurationssitzungs- oder Arbeitsbereichs-IDs innerhalb derselben Millisekunde erstellen, ist es möglich, dass die IDs identisch sind.

Um zu verhindern, dass die Konfigurationssitzungs- oder Arbeitsbereichs-ID doppelt erstellt wird, nehmen Sie diese Eigenschaft in die Anwendungsservereinstellungen auf, und setzen Sie sie auf true.

Diese angepasste Eigenschaft kann entweder mit dem wsadmin-Befehl "AdminTask.setJVMSystemProperties" oder über die Administrationskonsole festgelegt werden.

Wenn der Anwendungsserver Teil einer eingebundenen Zelle ist, müssen Sie nach dem Speichern der Änderungen den Knoten synchronisieren und jeden Server erneut starten, damit diese Änderung wirksam wird.

Wenn Sie diese angepasste Eigenschaft verwenden möchten, können Sie sie als angepasste JVM-Eigenschaft des Deployment Manager oder des Anwendungsservers angeben.

com.ibm.websphere.management.configservice.validatePropNames

Mit dieser Eigenschaft können Sie angeben, ob Zeicheneinschränkungen für die Namen angepasster Eigenschaften und für den Namenswert von Property- und J2EEResourceProperty-Konfigurationsobjekten in wsadmin-Befehlen umgesetzt werden.

Sie können eine der folgenden Methoden verwenden, um die Zeichenvalidierung für die Namen angepasster Eigenschaften und Namenswert von Property- und J2EEResourceProperty-Konfigurationsobjekten in wsadmin-Befehlen inaktivieren.
  • Setzen Sie die Java-Systemeigenschaft "com.ibm.websphere.management.configservice.validatePropNames" in der Java Virtual Machine (JVM) für den Deployment-Manager-Server auf false.
  • Setzen Sie die Eigenschaft "com.ibm.websphere.management.configservice.validatePropNames" mit dem Parameter -javaoption, wenn Sie das Tool "wsadmin" im lokalen Modus verwenden.
    wsadmin -conntype none -javaoption
    "-Dcom.ibm.websphere.management.configservice.validatePropNames=false"
[z/OS]

com.ibm.websphere.management.jmx.random

Verwenden Sie diese Eigenschaft, um dem Controller zu ermöglichen, den ursprünglichen Servant für die Verarbeitung einer JMX-Connector-Anforderung (Java Management Extensions) nach dem Zufallsprinzip aus dem Servant-Pool auszuwählen, anstatt die Anforderung automatisch dem Hot-Servant zuzuordnen.

Wenn mehrere Servants aktiviert sind und der Anwendungsserver eine JMX-Verbindungsanforderung empfängt, ordnet der Anwendungsserver die Anforderung standardmäßig dem ersten Servant zu. Dieser Servant wird auch als Hot-Servant bezeichnet. Diese Strategie verringert das Risiko, dass die Anforderung einem Servant zugeordnet wird, der ausgelagert ist. Wenn der erste Servant jedoch eine hohe Arbeitslast hat, können Anforderungen an diesen Servant irgendwann fehlschlagen. Die Verwendung des Zufallsalgorithmus hat deshalb den Vorteil, dass der zugeordnete Servant wahrscheinlich nicht viele andere Anforderungen verarbeitet. Der Nachteil ist, dass der ausgewählte Servant möglicherweise ausgelagert ist und erst wieder eingelagert werden muss, damit der die Anforderung bearbeiten kann.

Wenn Sie die Eigenschaft "com.ibm.websphere.management.jmx.random" auf
  • true setzen, wählt der Controller den ersten Servant zur Verarbeitung einer JMX-Connector-Anforderung nach dem Zufallsprinzip aus dem Servant-Pool aus.
  • false setzen, ordnet der Controller alle JMX-Connector-Anforderungen dem Hot-Servant zu.

Wenn Sie sich für die Verwendung dieser angepassten Eigenschaft entscheiden, müssen Sie sie als angepasste JVM-Eigenschaft für den Controller definieren.

com.ibm.websphere.management.nodeagent.bootstrap.maxthreadpool

Verwenden Sie diese Eigenschaft, um die Anzahl der Threads festzulegen, die in einen neu erstellten Thread-Pool aufgenommen werden können. Zum Starten jeder Anwendungsserver-JVM wird ein dedizierter Thread erstellt. Die JVMs mit dedizierten Threads in diesem Thread-Pool sind die JVMs, die bei jedem Start des Node Agent parallel gestartet werden.

Sie können eine ganze Zahl im Bereich 0 - 5 als Wert für diese Eigenschaft angeben. Wenn der angegebene Wert größer ist als 0, wird ein Thread-Pool erstellt, wobei dieser Wert die maximale Anzahl Threads angibt, die in diesen neu erstellten Thread-Pool aufgenommen werden können. In der folgenden Tabelle sind die unterstützten Werte für diese angepasste Eigenschaft und deren Auswirkung aufgeführt.

Tabelle 1. Unterstützte Werte für com.ibm.websphere.management.nodeagent.bootstrap.maxthreadpool. Die Tabelle enthält die angepassten Eigenschaftswerte an und ihre Auswirkungen.
com.ibm.websphere.management.nodeagent.bootstrap.maxthreadpool Auswirkung
Die Eigenschaft "com.ibm.websphere.management.nodeagent.bootstrap.maxthreadpool" ist auf 0 gesetzt oder nicht angegeben. Der Node Agent startet bis zu fünf JVMs parallel.
Die Eigenschaft "com.ibm.websphere.management.nodeagent.bootstrap.maxthreadpool" ist auf 1 gesetzt. Der Node Agent startet die JVMs seriell.
Die Eigenschaft "com.ibm.websphere.management.nodeagent.bootstrap.maxthreadpool" ist auf einen ganzzahligen Wert zwischen 2 und 5 gesetzt. Der Node Agent startet die angegebene Anzahl JVMs parallel.

Beispiel: Angenommen, der Node Agent verfügt über zehn JVMs mit dem Status running (aktiv), was bedeutet, dass sie bei jedem Start des Node Agent gestartet werden. Wenn Sie für diese Eigenschaft den Wert 3 angeben, werden jedes Mal, wenn der Node Agent gestoppt und gestartet wird, nur drei der zehn JVMs beim Node-Agent-Start parallel gestartet.

Fehler vermeiden Fehler vermeiden:
  • Wenn Sie die Administrationskonsole verwenden und com.ibm.websphere.management.nodeagent.bootstrap.maxthreadpool als Namen für eine neue angepasste JVM-Eigenschaft für den Node Agent angeben, müssen Sie für diese neue angepasste Eigenschaft einen Wert im Feld Wert angeben. Wenn Sie keinen Wert angeben, wird eine Fehlernachricht zurückgegeben.
  • Wenn Sie über die Befehlszeile einen Leerwert an die Eigenschaft übergeben, wird dieser Wert als ungültiger Wert betrachtet, und das Standardverhalten des Node Agent tritt wieder in Kraft.
gotcha

Diese Eigenschaft ist standardmäßig nicht angegeben. Wenn Sie diese angepasste Eigenschaft verwenden möchten, müssen Sie sie als angepasste JVM-Eigenschaft des Node Agent angeben.

com.ibm.websphere.management.nodesync.skipWebServerTarget

Verwenden Sie diese Eigenschaft, um festzulegen, ob Binärdateien von Anwendungen auf Zielknoten verteilt werden, die nur für Web-Server vorgesehen sind.

Wenn Sie den Wert der angepassten Eigenschaft auf false setzen, verteilt der Anwendungsserver Binärdateien von Anwendungen auf Zielknoten. Setzen Sie diese angepasste Eigenschaft auf true, verteilt der Anwendungsserver Binärdateien der Anwendungen nicht auf Zielknoten, die nur für Web-Server vorgesehen sind.

Wichtig: Das Systemverhalten wird vom Wert dieser angepassten Eigenschaft nicht beeinflusst. Es wird ebenfalls nicht beeinflusst von der geänderten Knotensynchronisation, die dazu geführt hat, dass der Wert dieser angepassten Eigenschaft für Zielknoten, die Anwendungsserverziele enthalten, geändert wurde. Diese Anweisungen sind zutreffend, unabhängig davon, ob Web-Server-Ziele auf dem Knoten enthalten sind.
Die folgende Beispielausgabe zeigt die Ausgabe von isAppReady, die für Web-Server-orientierte Zielknoten generiert wird, wenn Sie diese angepasste Eigenschaft auf true setzen:
wsadmin>$AdminApp isAppReady SuperApp 
ADMA5071I: Die Überprüfung des Verteilungsstatus für die Anwendung
SuperApp.WebSphere:cell=IBMCell10,node=IBMNode30,distribution=true,expansion=skipped
wurde gestartet.
ADMA5011I: Die Bereinigung des temporären Verzeichnisses für die Anwendung SuperApp ist abgeschlossen.
ADMA5072I: Die Überprüfung des Verteilungsstatus für die Anwendung SuperApp.
true
Sie können diese angepasste Eigenschaft für den Deployment Manager setzen, jedoch nicht für den Anwendungsserver oder den Node Agent. Sie können die folgenden Schritte in der Administrationskonsole oder über eine Befehlszeile ausführen:
  1. Starten Sie das Script-Tool "wsadmin" im Verzeichnis Profilstammverzeichnis/bin. Sie müssen den Befehl ".wsadmin.bat" oder "wsadmin.sh" in diesem Verzeichnis starten.
  2. Setzen Sie einen der folgenden Befehle ab:
    Mit Jacl:
    $AdminTask setJVMSystemProperties {-serverName Servername -nodeName Knotenname -propertyName com.ibm.websphere.management.nodesync.skipWebServerTarget -propertyValue true}
    Mit Jython (String):
    AdminTask.setJVMSystemProperties('[-serverName Servername -nodeName Knotenname -propertyName com.ibm.websphere.management.nodesync.skipWebServerTarget -propertyValue true]')
    Mit Jython (List):
    AdminTask.setJVMSystemProperties (['-serverName', 'Servername', '-nodeName', 'Knotenname' '-propertyName', 'com.ibm.websphere.management.nodesync.skipWebServerTarget', '-propertyValue', 'true'])

    Für diese Angaben gilt Folgendes: Die Variablen Servername und Knotenname sind umgebungsspezifisch.

  3. Starten Sie den Deployment Manager erneut.

com.ibm.websphere.management.processEmbeddedConfigGlobal

Verwenden Sie diese Eigenschaft, um die Verarbeitung der integrierten Konfiguration erweiterter Anwendungs-EAR-Dateien während der Implementierung global zu aktivieren oder zu inaktivieren. Eine erweiterte EAR-Datei wird beim Export einer installierten Anwendung generiert.

Diese angepasste Eigenschaft überschreibt die Standardeinstellung für die Option Integrierte Konfiguration verarbeiten (-processEmbededConfig) global. Standardmäßig wird Integrierte Konfiguration verarbeiten für erweiterte EAR-Dateien auf true (ausgewählt) und für alle anderen EAR-Dateien auf false (abgewählt) gesetzt. Die Einstellung Integrierte Konfiguration verarbeiten bestimmt das Verzeichnis, in dem das Produkt eine erweiterte EAR-Datei während der Implementierung der erweiterten EAR-Datei entpackt. Wenn Sie eine Anwendung aus einer anderen Zelle als der aktuellen Zelle exportiert und die Variable $(CELL) für Installationsverzeichnis für Anwendung bei der Erstinstallation der Anwendung nicht angegeben haben, bewirkt das Setzen der Eigenschaft Integrierte Konfigurationsverarbeitung auf false, dass die erweiterte EAR-Datei während der Implementierung im Verzeichnis Stammverzeichnis_des_Anwendungsservers/profiles/installedApps/Name_der_aktuellen_Zelle entpackt wird. Wenn Integrierte Konfiguration verarbeiten auf true gesetzt ist, wird die erweiterte EAR-Datei im Verzeichnis Stammverzeichnis_des_Anwendungsservers/profiles/installedApps/Name_der_ursprünglichen_Zelle entpackt, wobei Name_der_ursprünglichen_Zelle für den Namen der Zelle steht, in der die Anwendung zuerst installiert wurde. Wenn Sie bei der Erstinstallation der Anwendung die Variable $(CELL) für Installationsverzeichnis für Anwendung angegeben haben, entpackt die Installation die erweiterte EAR-Datei im Verzeichnis Stammverzeichnis_des_Anwendungsservers/profiles/installedApps/Name_der_aktuellen_Zelle.

Wenn die angepasste Eigenschaft "processEmbeddedConfigGlobal" auf false gesetzt ist, verarbeitet das Produkt die integrierte Konfiguration einer Anwendung, einschließlich erweiterter EAR-Dateien, nicht während der Implementierung. Nachdem Sie "processEmbeddedConfigGlobal" auf false gesetzt haben, verarbeitet das Produkt die integrierte Konfiguration erweiterter EAR-Dateien nicht. Bei der Implementierung einer einzelnen erweiterten EAR-Datei können Sie diese Einstellung jedoch überschreiben, indem Sie die Eigenschaft Integrierte Konfiguration verarbeiten explizit auf true setzen.

Wenn die angepasste Eigenschaft "processEmbeddedConfigGlobal" auf true gesetzt ist, verarbeitet das Produkt die integrierte Konfiguration erweiterter EAR-Dateien.

Unabhängig davon, ob die angepasste Eigenschaft "processEmbeddedConfigGlobal" auf true oder false gesetzt ist, implementiert das Produkt Anwendung, die keine integrierten Konfigurationen enthalten, wie gewöhnlich. Die Einstellung hat keine Auswirkung auf die Implementierung.

Fehler vermeiden Fehler vermeiden: Wenn Sie diese angepasste Eigenschaft verwenden möchten, müssen Sie diese Eigenschaft und ihren Wert als angepasste JVM-Eigenschaft für den Controller und für den Servant angeben oder die Eigenschaft in die Datei "wsadmin.properties" aufnehmen.gotcha
Fehler vermeiden Fehler vermeiden: Wenn Sie diese angepasste Eigenschaft verwenden möchten, müssen Sie diese Eigenschaft als angepasste JVM-Eigenschaft für den Deployment Manager angeben oder die Eigenschaft in die Datei "wsadmin.properties" aufnehmen.gotcha
[z/OS]

com.ibm.websphere.management.registerServerIORWithLSD

Mit dieser Eigenschaft können Sie steuern, ob ein Verbundserver beim LSD (Location Service Daemon) registriert wird. Normalerweise erfordert ein Verbundserver, dass der Node Agent aktiv ist. Soll der Server nicht beim LSD registriert und seine Abhängigkeit von einem aktiven Node Agent aufgehoben werden, müssen Sie die angepasste JVM-Eigenschaft "com.ibm.websphere.management.registerServerIORWithLSD" auf false setzen, und ORB_LISTENER_ADDRESS muss auf einen Wert größer 0 gesetzt werden, damit der ORB an einem festen Port empfangsbereit ist. Die Einstellung für diese Eigenschaft wird ignoriert, wenn die Eigenschaft ORB_LISTENER_ADDRESS auf 0 (null) gesetzt oder nicht angegeben wird und der Verbundserver beim LSD registriert wird.

Setzen Sie diese Eigenschaft auf false, wenn der Server auch bei inaktivem Node Agent ausgeführt werden soll. Wenn diese Eigenschaft auf true gesetzt ist, registriert sich der Server beim LSD. Der Standardwert ist true.

Fehler vermeiden Fehler vermeiden: Diese Eigenschaft ist bereits in der Liste der angepassten Eigenschaften für den ORB-Service vorhanden. Wenn Sie die Einstellung dieser angepassten Eigenschaft ändern möchten, klicken Sie in der Administrationskonsole auf Server > Anwendungsserver > Servername > Sitzungsverwaltung > Container-Services > ORB-Service > Angepasste Eigenschaften > com.ibm.websphere.management.registerServerIORWithLSD. gotcha

Nachdem Sie den Wert dieser angepassten Eigenschaft geändert haben, müssen Sie eine vollständige Synchronisation durchführen, damit sich diese Änderung in der Datei "server.xml" auf dem Knoten widerspiegelt. Wenn Sie den Node Agent für den Server nicht starten können, müssen Sie die Datei "server.xml" manuell bearbeiten, um den Wert dieser angepassten Eigenschaft von true in false zu ändern.

Wenn Sie die Eigenschaft "com.ibm.websphere.management.registerServerIORWithLSD" auf "false" setzen, benachrichtigt der Server den Node Agent nicht, wenn er den "ORB_LISTENER_ADDRESS"-Port dynamisch zuordnet. Außerdem gibt es keine indirekten IORs (Interoperable Object References), die der Node Agent in einen Server auflösen kann. Alle IORs sind in diesem Fall direkte IORs, d. h., der Node Agent kann nur dann eine Verbindung zu diesem Server herstellen, wenn diesem Server ein statischer "ORB_LISTENER_ADDRESS"-Port zugeordnet ist.

Fehler vermeiden Fehler vermeiden: Wenn Sie die Eigenschaft "com.ibm.websphere.management.registerServerIORWithLSD" auf "false" setzen und nicht vorhaben, den Service des High Availability Manager und den Node-Agent-Prozess zu verwenden, erstellen Sie eine statische Routentabelle, um das statische Routing zu aktivieren. Das Aktivieren des statischen Routing gewährleistet, dass das Workload-Management (WLM) weiterhin ordnungsgemäß funktioniert. Sie verwenden die Eigenschaft "com.ibm.websphere.management.registerServerIORWithLSD", um zu verhindern, dass indirekte IORs für Services zurückgegeben werden, die vom Anwendungsserver bereitgestellt werden, und der Node Agent diese indirekten IORs direkten IORs zuordnet.
Wenn ein Node Agent verwendet wird, wird ein bekannter Port auf der Serverseite eingerichtet, an den der Client Anforderungen senden kann, wenn die Ports für die Anwendungsserver nicht bekannt sind. Durch die Erstellung einer statischen Routing-Tabelle und die Aktivierung des statischen Routings werden statische Ports für die Anwendungsserver bereitgestellt und zur Verwendung verfügbar gemacht. Mit statischen Ports ist keine Node-Agent-Verarbeitung erforderlich.
Anmerkung: Für dynamische Anwendungsserverports kann die statische Routing-Tabelle nicht verwendet werden. Die Node-Agent-Verarbeitung ist für dynamische Anwendungsserverports erforderlich, weil der Client die neuen Portinformationen abrufen muss, wenn die Server erneut gestartet werden.

Die Festlegung der Eigenschaft "com.ibm.websphere.management.registerServerIORWithLSD" hat keine Auswirkung auf die Verwendung dynamischer oder statischer Ports oder das Routing von Anforderungen durch WLM. Sie verlieren jedoch eine potenzielle Failoverstufe, die die Node Agents des HAManager bieten.

Die WLM-Verarbeitung wird bei einer gewichteten Verteilung von Anforderungen beibehalten.

gotcha

com.ibm.websphere.management.soapSocketConnectionTimeout

Mit dieser Eigenschaft können Sie festlegen, wie lange (in Sekunden) ein JMX-SOAP-Connector-Socket geöffnet bleiben soll. Wenn Sie keinen Wert für diese Eigenschaft angeben, bleibt die Socketverbindung des JMX-SOAP-Connectors ohne zeitliche Begrenzung geöffnet.

com.ibm.websphere.management.useUpdatedPropertyFiles

Verwenden Sie diese Eigenschaft, um neue Mailsitzungen mit der aktualisierten Eigenschaftendateischablone zu erstellen.

Setzen Sie diese Eigenschaft auf true, um die aktualisierte Konfigurationsschablone der Eigenschaftendatei zum Erstellen neuer Mailsitzungen zu verwenden. Anstelle der ursprünglichen Konfigurationsschablone der Eigenschaftendatei wird die aktualisierten Konfigurationsschablone der Eigenschaftendatei verwendet.

Bewährtes Verfahren Bewährtes Verfahren: Sofern Sie nicht die ursprüngliche Eigenschaftendateischablone verwendet haben, um Konfigurationsobjekte von WebSphere Application Server in die Eigenschaftendateien zu extrahieren, sollten Sie com.ibm.websphere.management.useUpdatedPropertyFiles aktivieren.bprac

Speichern Sie die Änderungen, nachdem Sie die Systemeigenschaft festgelegt haben. Wenn der Anwendungsserver Teil einer eingebundenen Zelle ist, synchronisieren Sie den Knoten, um die Änderungen weiterzugeben. Starten Sie jeden Server erneut, damit die Änderungen wirksam werden.

Diese Eigenschaft ist standardmäßig nicht aktiviert.

com.ibm.websphere.metadata.ignoreDuplicateRefBindingsInWebModules

Verwenden Sie diese Eigenschaft, um festzulegen, ob die JVM Instanzen doppelter Referenzbindungen in der DTD-Datei für ein Webmodul in einer J2EE-Anwendung der Version 1.3 (Java 2 Platform, Enterprise Edition) ignoriert. Normalerweise wird eine MetaDataException ausgelöst, wenn die DTD-Datei für ein Webmodul in einer J2EE-Anwendung der Version 1.3 (Java 2 Platform, Enterprise Edition) doppelte Referenzen enthält.

Die Standards für die DTD-Datei für ein Webmodul legen explizit fest, dass die Referenzbindungen eindeutige Namensfelder haben müssen. Daher ist eine Anwendung, die ein Webmodul enthält, das doppelte Referenzen beinhaltet, technisch gesehen, eine nicht kompatible Anwendung.

Obwohl die Standards für die DTD-Datei für ein Webmodul einem Benutzer nicht gestatten, doppelte Referenzbindungen zu definieren, tolerieren die JVMs in Produktversionen vor Version 7.0 doppelte Referenzbindungen. Wenn Sie DTD-Dateien für Webmodule in J2EE-Anwendungen der Version 1.3 (Java 2 Platform, Enterprise Edition) haben, die doppelte Referenzbindungen enthalten, können Sie die doppelte Referenz entfernen oder diese Eigenschaft in die JVM-Konfigurationseinstellungen aufnehmen und die Eigenschaft auf true setzen.

com.ibm.websphere.network.useMultiHome

[AIX Solaris HP-UX Linux Windows][IBM i]Mit dieser Eigenschaft können Sie in einer Multihome-Umgebung (Umgebung mit mehreren Netzen) angeben, an welchen IP-Adressen der Anwendungsserver empfangsbereit ist. In einer Multihome-Umgebung gibt es normalerweise eine bestimmte IP-Adresse, auf die die Empfangsbereitschaft des Anwendungsservers für Erkennungs- und SOAP-Nachrichten beschränkt ist. Wenn Sie die Eigenschaft "com.ibm.websphere.network.useMultiHome" auf
  • true setzen, ist das Produkt an allen IP-Adressen des Hosts für Erkennungs- und SOAP-Nachrichten empfangsbereit.
  • false setzen, ist das Produkt nur auf dem konfigurierten Host für Erkennungs- und SOAP-Nachrichten empfangsbereit. Außerdem muss in diesem Fall ein Hostname im Produkt konfiguriert sein, der in eine bestimmte IP-Adresse aufgelöst wird.
  • null setzen, ist das Produkt nur an der Standard-IP-Adresse empfangsbereit.
[z/OS]In einer Multihome-Umgebung, in der das Produkt nur an einer bestimmten IP-Adresse Erkennungs- und SOAP-Nachrichten empfangen kann, müssen Sie diese Eigenschaft für den Deployment Manager, alle Anwendungsserver und alle Node Agents auf "false" setzen. Der Standardwert dieser Eigenschaft ist "true", d. h. der Anwendungsserver wartet an allen IP-Adressen des Hosts auf Erkennungs- und SOAP-Nachrichten. Wenn die Eigenschaft den Wert "false" hat, empfängt das Produkt Erkennungs- und SOAP-Nachrichten nur auf dem konfigurierten Host. Außerdem müssen Sie sicherstellen, dass folgende Bedingungen erfüllt sind, wenn Sie die Eigenschaft auf "false" setzen:
  • Es ist ein Hostname im Produkt konfiguriert, der in eine bestimmte IP-Adresse aufgelöst werden kann.
  • Die Eigenschaft Endpunkt des Deployment Manager, aller Anwendungsserver und aller Node Agents ist auf diesen Hostnamen gesetzt. Für den Deployment Manager müssen die Endpunkte CELL_DISCOVERY_ADDRESS und SOAP_CONNECTOR_ADDRESS definiert werden. Für den Node Agent und die Anwendungsserver muss nur der Endpunkt SOAP_CONNECTOR_ADDRESS definiert werden.
Sie können den Wert in der Administrationskonsole ändern. Ändern Sie die Standardwerte, indem Sie für Server Deployment Manager und Node Agent Werte angeben. Damit die Änderungen wirksam werden, müssen Sie den Server erneut starten.

Sollten Sie keine Verbindung zum Server herstellen können, überprüfen Sie die Einstellung für die Eigenschaft "com.ibm.websphere.network.useMultihome". Sie können den Wert in der Administrationskonsole ändern. Ändern Sie die Standardwerte, indem Sie für Server Deployment Manager und Node Agent Werte angeben. Sie müssen den Server erneut starten, damit diese Änderungen wirksam werden.

com.ibm.websphere.perf.tuning.disableRPARepositoryCache

Verwenden Sie diese Eigenschaft, um zu verhindern, dass Serverkonfigurationsdetails zwischengespeichert werden, wenn RPA inaktiviert ist.

RPA verwendet einen Repository-Cache zum Speichern der Konfigurationsdetails für den Server. Auch wenn RPA und PMI inaktiviert sind, wird dieser Cache initialisiert und Konfigurationsdetails werden gespeichert. Der Repository-Cache kann in extrem großen Installationen, z. B. in einer Installation mit mehr als 3000 Datenquellen, ziemlich groß werden. Wenn aufgrund der Größe dieses Repository-Cache Leistungsprobleme auftreten und RPA inaktiviert ist, nehmen Sie diese Eigenschaft in Ihre JVM-Konfigurationseinstellungen auf und setzen Sie sie auf den Wert true. Diese angepasste Eigenschaft sollte nicht verwendet werden, wenn RPA aktiviert ist oder wenn keine Leistungsprobleme aufgrund der Größe des Repository-Cache auftreten.

Fehler vermeiden Fehler vermeiden: Diese angepasste Eigenschaft sollte nicht verwendet werden, wenn RPA aktiviert ist oder wenn keine Leistungsprobleme aufgrund der Größe des Repository-Cache auftreten.gotcha

Der Standardwert für diese Eigenschaft ist "false".

Wenn Sie sich für die Verwendung dieser angepassten Eigenschaft entscheiden, müssen Sie sie als angepasste JVM-Eigenschaft des Anwendungsservers definieren.

com.ibm.websphere.resource.xmlConfigMaxLineLength

Verwenden Sie diese Eigenschaft, um eine bevorzugte maximale Zeilenlänge für XML-Konfigurationsdokumente festzulegen.

Häufig sind die Zeilen am Anfang der Datei server.xml länger als 2048 Zeichen. Zeilen, die länger sind als 2048 Zeichen können von gebräuchlichen Textverarbeitungstools unter einigen Betriebssystemen, z. B. unter z/OS nicht verarbeitet werden. Wenn Sie daher eine Datei bearbeiten und speichern, die Zeilen mit einer Länge von mehr als 2048 Zeilen enthalten, werden die langen Zeilen abgeschnitten. Durch das Abschneiden der Zeilen wird die Konfigurationsdatei unbrauchbar und bewirkt, dass der Serverstart fehlschlägt.

Wenn Sie für diese Eigenschaft einen Wert eingeben und ein XML-Konfigurationsdokument bearbeiten und speichern, werden die Zeilen baldmöglichst umgebrochen, nachdem sie die angegebene maximale Anzahl zulässiger Zeichen erreichen. Die Zeilenumbrüche erfolgen weiterhin an logischen Umbruchstellen, daher können die Zeilenlängen das angegebene Maximum dennoch überschreiten. In dem Wert, den Sie für diese Eigenschaft angeben, sollte deshalb die Anzahl der Zeichen berücksichtigt sein, durch die das angegebene Maximum überschritten werden kann, um sicherzustellen, dass keine Zeile im Dokument länger ist als 2048 Zeichen.

Wenn Sie keinen Wert für diese Eigenschaft angeben, dürfen Zeilen auf eine beliebige Länge anwachsen.

Ein akzeptabler Wert für diese Eigenschaft ist eine ganze Zahl im Bereich von 80 bis einschließlich 2046.

Für diese Eigenschaft gibt es keine Standardeinstellung.

Wenn Sie sich für die Verwendung dieser angepassten Eigenschaft entscheiden, müssen Sie sie als angepasste JVM-Eigenschaft des Anwendungsservers definieren.

com.ibm.websphere.sib.webservices.useTypeSoapArray

Sie können Nachrichten direkt an ein Busziel übergeben, indem Sie den Bindungsnamespace und die Endpunktadresse des JAX-RPC-Clients überschreiben. Es gilt jedoch Folgendes:
  • Die generierte RPC-codierte Web-Service-Standardnachricht (Zeichenfolgebereich) interagiert mit einigen Ziel-Service-Providern nicht ordnungsgemäß.
  • Die erzeugte Zeichenfolgenachricht entspricht der entsprechenden JAX-RPC-Standardnachricht, die erfolgreich verwendet werden kann, nicht exakt.
Im Folgenden finden Sie Beispiele für die Unterschiede zwischen den beiden Nachrichten:
  • Nachricht des Service Integration Bus:
    <partname env:encodingStyle='http://schemas.xmlsoap.org/soap/encoding/ xsi:type='ns1:ArrayOf_xsd_string'>
      <item xsi:type='xsd:anySimpleType'>namevalue</item>
    </partname>
  • JAX-RPC-Clientnachricht:
    <partname xsi:type="soapenc:Array" soapenc:arrayType="xsd:string[1]">
      <item>namevalue</item>
    </partname>

Setzen Sie diese Eigenschaft auf true, um das Standardverhalten zu ändern und eine Zeichenfolgenachricht zu senden, die mit Standard-JAX-RPC vollständig kompatibel ist. Die Definition dieser Eigenschaft ändert das Standardverhalten für alle abgehenden JMS-Web-Service-Aufrufe, die vom Service Integration Bus gesendet werden.

com.ibm.websphere.webservices.attachment.tempfile.expiration

Verwenden Sie diese Eigenschaft, um die Verfallszeit (in Sekunden) für einen Anhang in einem JAX-WS- oder SCA-Client (Service Component Architecture) oder -Service anzugeben. Wenn innerhalb des mit dieser Eigenschaft definierten Zeitraums kein Zugriff auf den Anhang erfolgt, kann die Web-Service-Laufzeitumgebung den Anhang löschen.

Das Programmiermodell JAX-RPC lässt den Zugriff auf Anhänge über eingehende Web-Service-Nachrichten zu. Der Zugriff auf den Anhang kann sofort erfolgen, oder der Anhang kann für spätere Verarbeitung gespeichert werden. Deshalb muss die Persistenz des Hauptspeichers, der dem Anhang zugeordnet ist, die Laufzeit der Web-Service-Interaktion überdauern, da nicht genau festgelegt werden kann, wann die Web-Service-Laufzeitumgebung den Anhang sicher freigeben kann.

Bei kleinen Anhängen wird der Hauptspeicher letztendlich vom Java-Garbage-Collector freigegeben.

Bei größeren Anhängen speichert die JAX-RPC-Laufzeitumgebung die Anhangsdaten in einer temporären Datei und ermöglicht der Laufzeitumgebung damit, sehr große Anhänge zu verarbeiten, ohne Hauptspeicher zu konsumieren. Wenn die Anwendung nicht auf den Anhang zugreift oder wenn die Anwendung den Datenhandler, der dem Anhang zugeordnet ist, nicht ordnungsgemäß schließt, wird die große temporäre Datei nicht freigegeben. Mit der Zeit kann es zu eine Anhäufung dieser temporären Anhangsdateien kommen, wenn keine Verfallszeit für diese Dateien angegeben wird.

Bewährtes Verfahren Bewährtes Verfahren: Für die Verfallszeit dieser Anhänge wird eine Einstellung von 600 Sekunden empfohlen. Die Standardeinstellung für diese angepasste Eigenschaft ist 0 Sekunden, d. h., es gibt keine Verfallszeit für diese Anhänge.bprac

Wenn Sie sich für die Verwendung dieser angepassten Eigenschaft entscheiden, müssen Sie sie als angepasste JVM-Eigenschaft des Anwendungsservers definieren.

com.ibm.websphere.webservices.attachements.maxMemCacheSize

Verwenden Sie diese Eigenschaft, um die maximale Größe (in Kilobytes) eines Anhangs im JAX-RPC-Client oder -Service anzugeben, der in den Speicher geschrieben werden kann. Wenn Ihr Web-Service beispielsweise Anhänge mit einer Größe von 20 MB senden muss, setzen Sie die Eigenschaft auf 20480.

Beachten Sie beim Festlegen eines Werts für diese Eigenschaft, dass die Auswirkungen auf die Leistung und möglicherweise den Java-Heapspeicher mit steigender Cachegröße zunehmen.

Wenn Sie keinen Wert für diese Eigenschaft angeben, ist die maximale Hauptspeichergröße für die Zwischenspeicherung von Anhängen 32 KB. Dies ist der Standardwert für diese Eigenschaft.

Unterstützte Konfigurationen Unterstützte Konfigurationen: Informationen zum Festlegen der maximalen Größe eines Anhangs im JAX-WS-Client bzw. -Service finden Sie in der Beschreibung der angepassten Eigenschaft "com.ibm.ws.websvcs.attachments.sizethreshold".sptcfg

Wenn Sie sich für die Verwendung dieser angepassten Eigenschaft entscheiden, müssen Sie sie als angepasste JVM-Eigenschaft des Anwendungsservers definieren.

com.ibm.websphere.webservices.DisableIBMJAXWSEngine

Verwenden Sie diese Eigenschaft, um das Scannen von Web-Service-Annotationen auf der Serverebene zu inaktivieren. Standardmäßig ist das Scannen von Web-Service-Annotationen auf Serverebene aktiviert.

Möchten Sie das Scannen von Annotationen auf Anwendungsebene inaktivieren, müssen Sie die Eigenschaft DisableIBMJAXWSEngine im META-INF/MANIFEST.MF einer WAR-Datei oder eines EJB-Moduls auf "true" setzen.

Wenn Sie sich für die Verwendung dieser angepassten Eigenschaft entscheiden, müssen Sie sie als angepasste JVM-Eigenschaft des Anwendungsservers definieren.

com.ibm.websphere.webservices.http.OneWayConnectionRecycleTime

Mit dieser Eigenschaft können Sie festlegen, wie lange die Web-Service-Engine warten soll (in Sekunden), bis sie eine einseitige Verbindung wiederverwendet. Wenn eine einseitige Verbindung zu schnell wiederverwendet wird, schlägt eine Web-Service-Operation im Client möglicherweise fehl, weil ein Zeitlimit überschritten wurde (z. B. SocketTimeoutException).

Wenn ein Wert für diese Eigenschaft angegeben ist, werden einseitige Verbindungen erst zurückgesetzt, wenn der angegebene Zeitraum (in Sekunden) seit dem Versenden der Anforderung verstrichen ist.

Standardmäßig wird diese Eigenschaft nicht gesetzt, und einseitige Verbindungen werden unmittelbar nach dem Versenden der Anforderung zurückgesetzt.

Wenn Sie sich für die Verwendung dieser angepassten Eigenschaft entscheiden, müssen Sie sie als angepasste JVM-Eigenschaft des Anwendungsservers definieren.

com.ibm.websphere.webservices.http.waitingThreadsThreshold

Mit dieser Eigenschaft können Sie festlegen, wie viele wartende Verbindungsanforderungen toleriert werden, bevor variable Verbindungen freigegeben werden. Eine sogenannte weiche Verbindung liegt vor, wenn eine Client-Engine Verbindungsobjekte für einige Hosts verwaltet, nachdem die Verbindung geschlossen wurde. Standardmäßig gibt die Client-Engine die variablen Verbindungen frei, wenn fünf Threads auf Verbindungen warten.

Anmerkung: Wenn alle Verbindungen im Gebrauch sind, hat die angepasste Eigenschaft keine Wirkung. In diesem Fall können Sie die maximal zulässige Anzahl an Verbindungen und/oder die maximal zulässige Anzahl an Threads erhöhen.

Der Standardwert für diese angepasste Eigenschaft ist 5.

Wenn Sie sich für die Verwendung dieser angepassten Eigenschaft entscheiden, müssen Sie sie als angepasste JVM-Eigenschaft des Anwendungsservers definieren.

com.ibm.websphere.webservices.jaxrpc.client.publishwsdl

Gibt an, ob eine WSDL-Datei für ein Client-Web-Modul veröffentlicht wird. Wenn diese Eigenschaft auf "true" gesetzt ist und eine Anwendung ein Client-Web-Modul enthält, kann eine WSDL-Datei für diesen Client veröffentlicht werden. Wenn Sie nicht möchten, dass WSDL-Dateien für Ihre Clientanwendungen veröffentlicht werden, müssen Sie diese Eigenschaft auf false setzen.

Der Standardwert ist true.

Fehler vermeiden Fehler vermeiden:
  • Die Veröffentlichung der WSDL-Datei ist für JAX-RPC-Anwendungen, die nur einen Client enthalten, nicht verfügbar.
  • Diese Eigenschaft kann für JAX-WS-Anwendungen nicht verwendet werden.
gotcha

Wenn Sie sich für die Verwendung dieser angepassten Eigenschaft entscheiden, müssen Sie sie als angepasste JVM-Eigenschaft des Anwendungsservers definieren.

com.ibm.websphere.management.connector.http.header.includeProductVersion

Setzen Sie diese Eigenschaft auf den Wert true, um die Informationen zur Serverversion in den SOAP-Port-HTTP-Antwortheader aufzunehmen. Der Standardwert ist false.

com.ibm.websphere.webservices.jaxws.setLinkValuePrecedence

Verwenden Sie diese Eigenschaft, um die Priorität der Linkwerte in der JAX-WS-Laufzeitumgebung festzulegen.

Wenn diese Eigenschaft auf true gesetzt ist, haben Linkwerte des Implementierungsdeskriptors Priorität vor Annotationslinkwerten.

Der Standardwert ist false.

com.ibm.websphere.webservices.soap.enable.legacy.get.behavior

Ab WebSphere Application Server Version 8 lösen die Methoden SOAPMessage.getSOAPHeader und getSOAPBody eine Ausnahmebedingung des Typs SOAPException aus, wenn in der Nachricht kein entsprechendes Element enthalten ist. Die Systemeigenschaft com.ibm.websphere.webservices.soap.IBMSOAPMessage.ENABLE_LEGACY_GETSOAP_BEHAVIOR wird bereitgestellt, um das Verhalten so zurückzusetzen, dass null zurückgegeben und keine Ausnahmebedingung ausgelöst wird. Diese Systemeigenschaft wird mit der angepassten JVM-Eigenschaft com.ibm.websphere.webservices.soap.enable.legacy.get.behavior festgelegt. Der Standardwert für diese angepasste JVM-Eigenschaft ist false. Wenn Sie diese JVM-Eigenschaft auf den Wert true setzen, wird das vorherige Verhalten verwendet und für die Methoden "SOAPMessage.getSOAPHeader" und "getSOAPBody" wird null zurückgegeben, wenn keine entsprechende Nachricht existiert.
Anmerkung: Das vorherige Verhalten, bei dem null zurückgegeben wird, ist mit der Spezifikation nicht kompatibel.

com.ibm.websphere.webservices.tempAttachDir

Verwenden Sie diese Eigenschaft, um die Position in einer Speichereinheit anzugeben, an der die Web-Service-Laufzeitkomponente Kopien von Anhängen mit einer Größe von mehr als 32 KB, die als Teil einer SOAP-Nachricht gesendet oder empfangen werden, zwischenspeichern soll.

Unter Leistungsaspekten stellt die Web-Service-Laufzeitkomponente eine temporäre Kopie eines Anhangs einer SOAP-Nachricht, der mehr als 32 KB groß ist, in den Cache. Wenn Sie für diese Eigenschaft keinen Wert angeben, wird die zwischengespeicherte Kopie des Anhangs normalerweise in das temporäre Standardverzeichnis für Ihr Betriebssystem gesendet.

Wenn Sie sich für die Verwendung dieser angepassten Eigenschaft entscheiden, müssen Sie sie als angepasste JVM-Eigenschaft des Anwendungsservers definieren.

com.ibm.websphere.webservices.transport.jms.messageType

Mit dieser Eigenschaft können Sie den JMS-Nachrichtentyp steuern, der von der Web-Service-Engine für SOAP-over-JMS-Komponenten beim Senden von Anforderungs- und Antwortnachrichten verwendet wird. Wenn Sie ein JMS-BytesMessage-Objekt (javax.jms.BytesMessage) angeben möchten, setzen Sie die Eigenschaft auf BYTES, um anzuzeigen, dass der Hauptteil der Nachricht aus Binärdaten besteht. Wenn Sie ein JMS-TextMessage-Objekt (javax.jms.TextMessage) angeben möchten, setzen Sie die Eigenschaft auf TEXT, um anzuzeigen, dass der Hauptteil der Nachricht aus Zeichenfolgedaten besteht.

Der Standardwert für diese angepasste Eigenschaft ist BYTES.

Weitere Informationen zu den SOAP-over-JMS-Nachrichtentypen finden Sie im Artikel zum Konfigurieren von SOAP-over-JMS-Nachrichtentypen.

Wenn Sie sich für die Verwendung dieser angepassten Eigenschaft entscheiden, müssen Sie sie als angepasste JVM-Eigenschaft des Anwendungsservers definieren.

com.ibm.websphere.webservices.transport.OPTIMIZE_HTTP_HEADERS

Vor Version 8 kann eine JAX-WS-Clientanwendung für WebSphere Application Server einen SAVE_CONNECTION-HTTP-Header in einer SOAP-Nachricht senden. Dieser zusätzliche Header stellt sicher, dass in dem Anwendungsserver, der den JAX-WS-Web-Service bereitstellt, die richtigen Prozesse ausgeführt werden. Dieser SAVE_CONNECTION-Header und die zusätzlichen Prozesse sind nicht erforderlich, wenn der Anwendungsserver für den Client und der Anwendungsserver-Host für den Web-Service beide WebSphere Application Server Version 7.0 mit Fixpack 3 verwenden.

Sie können die angepasste Eigenschaft com.ibm.websphere.webservices.transport.OPTIMIZE_HTTP_HEADERS auf false setzen, um den SAVE_CONNECTION-Header zu aktivieren und eine ordnungsgemäße Verarbeitung in Anwendungsservern einer älteren Version zu gewährleisten. Standardmäßig ist diese angepasste Eigenschaft auf true gesetzt, d. h., der JAX-WS-Client kann den Header SAVE_CONNECTION nicht senden. Wenn Sie dieses Standardverhalten ändern möchten, müssen Sie die angepasste Eigenschaft in dem Anwendungsserver, in dem sich die JAX-WS-Clientanwendung befindet, auf den Wert false setzen.
Wichtig: Sie müssen sicherstellen, dass der Anwendungsserver für den Client und der Anwendungsserver-Host für den Web-Service beide Version 7.0 mit Fixpack 3 oder höher verwenden.

Wenn Sie sich für die Verwendung dieser angepassten Eigenschaft entscheiden, müssen Sie sie als angepasste JVM-Eigenschaft des Anwendungsservers definieren.

com.ibm.websphere.webservices.transport.ssl.loadFromPolicyBinding

Mit dieser Eigenschaft können Sie steuern, ob JAX-WS-Anwendungen SSL-Transportbindungen oder die Standard-SSL-Einstellungen des Systems verwenden, wenn der Client ein verwalteter Client ist und wenn sich Client und Server in unterschiedlichen Anwendungsservern befinden.

Wenn Sie eine SSL-Bindung erstellen, wird diese Eigenschaft automatisch der Bindungsdatei hinzugefügt und auf "true" gesetzt. Diese Einstellung ermöglicht die Verwendung von SSL-Transportbindungen für JAX-WS-Anwendungen, wenn der Client ein verwalteter Client ist und sich Client und Server in unterschiedlichen Anwendungsservern befinden. Wenn Ihrer JAX-WS-Anwendung keine Bindungen zugeordnet sind, setzen Sie diese Eigenschaft auf false.

Wenn Sie sich für die Verwendung dieser angepassten Eigenschaft entscheiden, müssen Sie sie als angepasste JVM-Eigenschaft des Anwendungsservers definieren.

com.ibm.websphere.webservices.UseWSFEP61ScanPolicy

Mit dieser Eigenschaft können Sie steuern, ob das Produkt WAR-Module der Version 2.4 und früher nach JAXWS-Komponenten und teilweise verwalteten Service-Clients durchsucht. Standardmäßig werden diese traditionellen WAR-Module nur nach teilweise verwalteten Service-Clients durchsucht.

Der Standardwert ist false.

Sie müssen diese Eigenschaft für jeden Server und jeden Verwaltungsserver auf true setzen, der eine Änderung des Standardwerts erfordert.

Wenn Sie sich für die Verwendung dieser angepassten Eigenschaft entscheiden, müssen Sie sie als angepasste JVM-Eigenschaft des Anwendungsservers definieren.

com.ibm.websphere.webservices.WSDL_Generation_Extra_ClassPath

Verwenden Sie diese Eigenschaft, um die Position der gemeinsam genutzten Klassendateien festzulegen. Das Befehlszeilentool "wsgen" generiert die erforderlichen Artefakte, die für JAX-WS-Anwendungen (Java API for XML Web Services) erforderlich sind, die auf der Basis von Java-Code entwickelt werden. Das Befehlszeilentool "wsgen" findet die erforderlichen Klassendateien jedoch unter Umständen nicht und fügt der Protokolldatei die folgenden Fehlernachrichten hinzu:
Caused by: java.lang.NoClassDefFoundError
...
at com.ibm.ws.websvcs.wsdl.WASWSDLGenerator.wsgen(WASWSDLGenerator.java:521)
at com.ibm.ws.websvcs.wsdl.WASWSDLGenerator.generateWsdl(WASWSDLGenerator.java:183)
Verwenden Sie diese Eigenschaft, um die vollständig qualifizierte Position der fehlenden Klassendateien anzugeben. Mit dieser angepassten Eigenschaft können Sie die vollständig qualifizierten Pfade zu mehreren Java-Archiven (JARs) und Verzeichnissen, jeweils getrennt durch ein Semikolon (;), angeben.[z/OS]Um Fehler zu vermeiden, setzen Sie diese Eigenschaft auf alle JVM-Prozesse, einschließlich Deployment Manager, Node Agent und Anwendungsserver.
Wichtig: Wenn Sie für WebSphere Application Server als Basisbetriebssystem AIX, Linux oder UNIX einsetzen, verwenden Sie einen Doppelpunkt (:) als Trennzeichen zwischen mehreren JAR (Java-Archiven) und Verzeichnissen.

Beispiel: D:\sharedlibs;D:\libs\WSBean.jar

Wenn Sie sich für die Verwendung dieser angepassten Eigenschaft entscheiden, müssen Sie sie als angepasste JVM-Eigenschaft des Anwendungsservers definieren.

[z/OS]Hinweis: Legen Sie diese Eigenschaft sowohl für den Controller als auch für den Servant fest. Für den Servant wird diese Eigenschaft wie folgt festgelegt:
[z/OS]Fehler vermeiden: Wenn Sie diese Eigenschaft unter z/OS festlegen möchten, müssen Sie sie in der Administrationskonsole in den angepassten Eigenschaften der Java Virtual Machine unter "Steuerung" und unter "Servant" definieren:
  • Anwendungsserver>[Servername]>Prozessdefinition>Servant>Java Virtial Machine>Angepasste Eigenschaften
  • Anwendungsserver>[Servername]>Prozessdefinition>Steuerregion>Java Virtial Machine>Angepasste Eigenschaften

com.ibm.websphere.websvcs.EJBPostInvokeCallOnException

Verwenden Sie diese Eigenschaft, um den Status und die Transaktion nach einer Ausnahme in einer von Web-Services aufgerufenen EJB (Enterprise JavaBeans) zu bereinigen.

Wenn in Installationen von WebSphere Application Server, die JAX-WS-Web-Services verwenden, eine Ausnahme in einer EJB auftritt, die als Teil eines Web-Service aufgerufen wird, kann es vorkommen, dass Transaktionen in einem Thread aktiv bleiben und verhindern, dass eine dem aktuellen XA-Transaktionsfluss zugeordnete Transaktion fortgesetzt werden kann. Setzen Sie diese Eigenschaft auf true, um eine vollständige Bereinigen des Status und der Transaktion sicherzustellen.

Der Standardwert ist false.

Wenn Sie sich für die Verwendung dieser angepassten Eigenschaft entscheiden, müssen Sie sie als angepasste JVM-Eigenschaft des Anwendungsservers definieren.

com.ibm.websphere.workspace.decodeclustervariable

Verwenden Sie diese Eigenschaft, um sicherzustellen, dass auf Clusterebene definierte Variablen erweitert werden, wenn sie in Protokolldateipfaden verwendet werden, die in der Administrationskonsole definiert wurden.

Wird diese Eigenschaft nicht festgelegt und werden zum Definieren von Protokolldateipfaden Variablen auf Clusterebene verwendet, kann der Deployment Manager die angeforderte Protokolldatei möglicherweise nicht abrufen. Daher sollten Sie diese Eigenschaft in die JVM-Einstellungen Ihres Deployment Manager aufnehmen, falls Sie in Ihren Protokolldateipfaden Variablen auf Clusterebene verwenden.

Der Standardwert ist false.

Wenn Sie diese angepasste Eigenschaft verwenden möchten, müssen Sie sie als angepasste JVM-Eigenschaft des Deployment Manager angeben. Nachdem Sie diese Eigenschaft auf true gesetzt haben, müssen Sie den Deployment Manager erneut starten, damit die Änderung wirksam wird.

com.ibm.websphere.wsrm.MaxSequenceBacklog

Verwenden Sie diese Eigenschaft, um die maximale Anzahl der Nachrichten in einer abgehenden WS-RM-Nachrichtenfolge zu konfigurieren.

Wenn der definierte Grenzwert erreicht wird, wird WS-RM neue Nachrichten zurückzuweisen, indem es eine Ausnahmebedingung vom Typ "javax.xml.ws.WebServiceException" auslöst, bis der Rückstand unter den Grenzwert fällt. Clients, die eine Ausnahmebedingung empfangen, sollten die Anforderung wiederholen.

Es ist kein Standardwert verfügbar. Ist keine Wertegruppe definiert, ist der Rückstand unbegrenzt.

com.ibm.websphere.wsrm.MessageContextCacheSize

Verwenden Sie diese Eigenschaft, um die maximale Größe des Speichercaches als positiven ganzzahligen Wert anzugeben.

Es ist kein Standardwert verfügbar. Die Größe des Caches ist unbegrenzt.

com.ibm.websphere.wsrm.pollingInterval

Verwenden Sie diese Eigenschaft, um die Frequenz anzugeben, mit der MakeConnection-Anforderungen für eine Nachrichtenfolge durchgeführt werden.

Mit diesem Wert wird das Intervall in Millisekunden angegeben. Wird die Eigenschaft nicht gesetzt, wird standardmäßig der Wert "3.000 Millisekunden" verwendet.

com.ibm.websphere.wsrm.retransmissionInterval

Verwenden Sie diese Eigenschaft, um die Häufigkeit anzugeben, mit der WS-RM eine Anwendungsnachricht erneut überträgt, wenn vorherige Übertragungsversuche fehlgeschlagen sind.

Mit diesem Wert wird das Intervall in Millisekunden angegeben. Wird die Eigenschaft nicht gesetzt, wird standardmäßig der Wert "15.000 Millisekunden" verwendet.

[z/OS]

com.ibm.websphere.zos.userdir.useRacfSettings

Wenn diese Eigenschaft auf false gesetzt ist, wird user.dir vom WebSphere Application Server-Code auf ${USER_INSTALL_ROOT} gesetzt, d. h. dem Teil des Konfigurationsdateisystempfads vor dem Verzeichnis /profiles/.

Wenn diese Eigenschaft auf true gesetzt ist, wird user.dir vom WebSphere Application Server-Code nicht gesetzt. Stattdessen wird user.dir gesetzt, indem die USS-Einstellungen wirksam werden (user.dir == Ausgangsverzeichnis des OMVS-Segments).

Da WebSphere Application Server die Eigenschaft nicht setzt, können Sie für user.dir in den angepassten Servant-JVM-Eignschaften einen Wert Ihrer Wahl angeben. Nachdem Sie user.dir definiert haben, wird es vom Java-Code in der Optionsdatei servant.jvm.options gesetzt.

Anmerkung: Wenn Sie user.dir ändern, wird nur der Wert der Eigenschaft geändert. Das aktuelle Arbeitsverzeichnis der JVM wird nicht geändert. Dieses wird zur Bootzeit festgelegt.

com.ibm.ws.amm.require.produces.annotation.for.cdi

WebSphere Application Server ignoriert fälschlicherweise die Annotationen @EJB, @WebServiceRef, @PersistenceContext, @PersistenceUnit und @Resource, sofern nicht eine @Produces-Annotation in der CDI-Bean existiert. Dieses Verhalten ist falsch, da es keine Java EE-Anforderung gibt, derzufolge eine @Produces-Annotation vorhanden sein muss. Weil vorhandene Anwendungen von diesem falschen Verhalten abhängig sind, bleibt dieses von der Spezifikation abweichende Verhalten der Standard. Mit dieser angepassten Eigenschaft können Sie ein der Spezifikation entsprechendes Verhalten erzielen, indem Sie die Eigenschaft auf den Wert "false" setzen.

Setzen Sie die Eigenschaft auf den Wert "false", um ein mit der Spezifikation konformes Verhalten zu erzielen, wenn alle folgende Bedingungen zutreffen:
  • Ihre Anwendung enthält eine CDI-Bean.
  • Die CDI-Bean enthält eine der folgenden Annotationen: @EJB, @WebServiceRef, @PersistenceContext, @PersistenceUnit, @Resource.
  • Die CDI-Bean enthält keine @Produces-Annotation.

com.ibm.ws.amm.scan.context.filter.archives

Verwenden Sie diese Eigenschaft, um eine Liste von Archiven oder Dienstprogramm-JAR-Dateien bereitzustellen, die keine Annotationen enthalten. Archive oder Dienstprogramm-JAR-Dateien, die für diese Eigenschaft angegeben sind, werden nicht nach Annotationen gescannt.

Wenn eine Java EE-Anwendung (Java Platform, Enterprise Edition) der Version 5 oder 6 implementiert oder aktualisiert wird, scannt die AMM-Funktion (Annotations Metadata Manager) alle Annotationsmetadaten. Dieser Scanvorgang kann die für die Anwendungsimplementierung benötigte Zeit verlängern. Wenn die Anwendung Archive oder Dienstprogramme ohne Annotationen enthält, können Sie diese Archive und Dienstprogramme als Wert für diese Eigenschaft aufführen. Wenn die Anwendung Java-Pakete ohne Annotationen enthält, können Sie diese Pakete als Wert für die Eigenschaft Ignore-Scanning-Packages aufführen.

Bei den Werten, die für diese Eigenschaften angegeben werden, muss die Groß-/Kleinschreibung beachtet werden. Außerdem müssen sie als einzelne Zeichenfolge eingegeben werden, jeweils mit einem Komma und einem Leerzeichen zwischen zwei Werten für die Archive oder Dienstprogramm-JAR-Dateien. Platzhalterzeichen und REGEX-Ausdrücke sind nicht zulässig.

Als Alternative zur Verwendung dieser angepassten Eigenschaft können Sie die Eigenschaft "Ignore-Scanning-Archives" einer der folgenden Dateien bzw. einem der folgenden Module zuordnen und die Archive und Dienstprogramme angeben, die nicht als Wert der Eigenschaft gescannt werden sollen:
  • Die Datei "amm.filter.properties", die sich im Verzeichnis "was_home/properties" befindet.
  • Die Datei "amm.filter.properties", die sich im Verzeichnis "profile_home/properties" befindet.
  • Die Manifestdatei einer Anwendung, META-INF/MANIFEST.MF.
  • Das Manifest eines Web- oder EJB-Moduls in einer Anwendung.

Werte, die in den Dateien "amm.filter.properties" angegeben sind, werden mit in dieser angepassten Eigenschaft angegebenen Werten zusammengeführt und bilden dann eine Filtergruppe auf Serverebene. Diese gemischte Filtergruppe wird auf alle Anwendungen angewendet, die auf diesem Server implementiert werden.

Werte, die in der Manifestdatei einer Anwendung angegeben sind, werden mit der Filtergruppe auf Serverebene zusammengeführt und bilden dann eine Supergruppe auf Modulebene, die für alle Module in dieser Anwendung gültig ist.

Werte, die in der Manifestdatei eines Web- oder EJB-Moduls angegeben sind, werden mit der Filtergruppe auf Modulebene zusammengeführt. Diese gemischte Filtergruppe gilt nur für dieses Modul.

Fehler vermeiden Fehler vermeiden: Lassen Sie Vorsicht walten, wenn Sie eine Manifestdatei aktualisieren. Manifestdateien haben Längenbeschränkungen und andere Beschränkungen, die berücksichtigt werden müssen. gotcha
Beispiel:
Ignore-Scanning-Archives : ant.jar,  avalon-framework-4.2.0.jar, axis.jar, CICS.jar, xerces.jar

com.ibm.ws.amm.scan.context.filter.disable.unifyTrue

Verwenden Sie diese Eigenschaft nur, wenn Sie bestimmte JAR-Dateien vom Annotationsscan auf der AMM-Ebene (Annotations Metadata Manager) ausschließen möchten, die Dateien jedoch auf der ECS-Ebene (Extensible Class Scanner) gescannt werden sollen. Zum Aktivieren dieser Eigenschaft setzen Sie den Wert auf true.

Der Standardwert ist false.

com.ibm.ws.amm.scan.context.filter.packages.

Verwenden Sie diese Eigenschaft, um eine Liste von Java-Paketen bereitzustellen, die keine Annotationen enthalten. Die Java-Klassen, die für diese Eigenschaft angegeben sind, werden nicht nach Annotationen gescannt.

Wenn eine Java EE-Anwendung (Java Platform, Enterprise Edition) der Version 5 oder 6 implementiert oder aktualisiert wird, scannt die AMM-Funktion (Annotations Metadata Manager) alle Annotationsmetadaten. Dieser Scanvorgang kann die für die Anwendungsimplementierung benötigte Zeit verlängern. Wenn die Anwendung Java-Pakete ohne Annotationen enthält, können Sie diese Pakete als Wert für diese Eigenschaft aufführen. Wenn die Anwendung Archive oder Dienstprogramme ohne Annotationen enthält, können Sie diese Archive oder Dienstprogramme als Wert für die Eigenschaft "Ignore-Scanning-Archives" aufführen.

Bei den Werten, die für diese Eigenschaften angegeben werden, muss die Groß-/Kleinschreibung beachtet werden. Außerdem müssen sie als einzelne Zeichenfolge eingegeben werden, jeweils mit einem Komma und einem Leerzeichen zwischen zwei Werten für die Namen der Java-Pakete. Platzhalterzeichen und REGEX-Ausdrücke sind nicht zulässig.

Als Alternative zur Verwendung dieser angepassten Eigenschaft können Sie die Eigenschaft "Ignore-Scanning-Packages" einer der folgenden Dateien bzw. einem der folgenden Module zuordnen und die Archive und Dienstprogramme angeben, die nicht als Wert der Eigenschaft gescannt werden sollen:
  • Die Datei "amm.filter.properties", die sich im Verzeichnis "was_home/properties" befindet.
  • Die Datei "amm.filter.properties", die sich im Verzeichnis "profile_home/properties" befindet.
  • Die Manifestdatei einer Anwendung, META-INF/MANIFEST.MF.
  • Das Manifest eines Web- oder EJB-Moduls in einer Anwendung.

Werte, die in den Dateien "amm.filter.properties" angegeben sind, werden mit in dieser angepassten Eigenschaft angegebenen Werten zusammengeführt und bilden dann eine Filtergruppe auf Serverebene. Diese gemischte Filtergruppe wird auf alle Anwendungen angewendet, die auf diesem Server implementiert werden.

Werte, die in der Manifestdatei einer Anwendung angegeben sind, werden mit der Filtergruppe auf Serverebene zusammengeführt und bilden dann eine Supergruppe auf Modulebene, die für alle Module in dieser Anwendung gültig ist.

Werte, die in der Manifestdatei eines Web- oder EJB-Moduls angegeben sind, werden mit der Filtergruppe auf Modulebene zusammengeführt. Diese gemischte Filtergruppe gilt nur für dieses Modul.

Fehler vermeiden Fehler vermeiden: Das folgende Beispiel ist eine Eigenschaftendatei und kann nicht als Manifestdatei verwendet werden. Manifestdateien haben eine Längenbegrenzung von 72 Byte pro Zeile sowie weitere Einschränkungen, die eingehalten werden müssen.gotcha
Beispiel:
Ignore-Scanning-Packages : org.apache.avalon, org.apache.batik, org.apache.commons

com.ibm.ws.application.enhancedScanning

Verwenden Sie diese Eigenschaft, um mehrere Optimierungen zu inaktivieren, die die für die Implementierung und das Starten von Unternehmensanwendungen benötigte Zeit verringern. Die Optimierungen betreffen hauptsächlich Java EE 5-fähige Anwendungen. Wenn Sie diese Eigenschaft auf "false" setzen, werden die folgenden Aktualisierungen inaktiviert:
  • Neuer Cache für Moduldateien
  • Neuer Cache für das Laden von Modulklassen
  • Alternative Codepfade für die Verarbeitung von Annotationen
Wenn Sie diese Eigenschaft auf false setzen, kann sich dies nachteilig auf die Leistung auswirken. Der Standardwert ist true.

com.ibm.ws.cache.CacheConfig.alwaysSetSurrogateControlHdr

Verwenden Sie diese Eigenschaft, um zu erzwingen, dass der Header "surrogate-control" aus dem dynamischen Cache-Service in der Antwort immer gesetzt wird. Der Header "surrogate-control" enthält die Metadaten, die die ESI-Verarbeitung (Edge Side Include) benötigt, um den zwischengespeicherten Inhalt im ESI-Cache ordnungsgemäß zu generieren und ungültig zu machen.

Der Standardwert ist false, d. h., der Header "surrogate-control" wird nicht in der Antwort gesetzt.

Wenn Sie sich für die Verwendung dieser angepassten Eigenschaft entscheiden, definieren Sie sie als angepasste JVM-Eigenschaft des Anwendungsservers, sofern im Kontext einer bestimmten Task keine anderen Angaben enthalten sind.

com.ibm.ws.cache.CacheConfig.cascadeCachespecProperties

Mit dieser Eigenschaft können Sie festlegen, dass untergeordnete Seiten oder Fragmente kaskadierende Eigenschaften des Typs "save-attributes" und "store-cookies" von den übergeordneten Seiten oder Fragmenten übernehmen. Der Standardwert ist false.

Das Standardverhalten des dynamischen Cache-Service ist, die Anforderungsattribute für eine untergeordnete Seite oder ein untergeordnetes Fragment zu speichern, falls sie in der Cachespezifikation nicht explizit überschrieben werden. In Szenarien, in denen diese Anforderungsattribute zu groß werden, können bei einem Anwendungsserver abnormale Speicherbedingungen auftreten. Wenn die standardmäßig gespeicherten Attribute nicht serialisierbar sind, führt die Plattenauslagerung dieser Cacheeinträge dazu, dass java.io.NotSerializableExceptions abgesetzt werden.

Wenn Sie sich für die Verwendung dieser angepassten Eigenschaft entscheiden, definieren Sie sie als angepasste JVM-Eigenschaft des Anwendungsservers, sofern im Kontext einer bestimmten Task keine anderen Angaben enthalten sind.

com.ibm.ws.cache.CacheConfig.filteredStatusCodes

Verwenden Sie diese Eigenschaft, um Fehlersituationen anzugeben, in denen der dynamische Cache-Service die Servletausgabe nicht zwischenspeichern soll.

Der für diese Eigenschaft angegebene Wert ist eine durch Leerzeichen getrennte Liste mit HTTP-Antwortfehlercodes. Wenn der bei einem Cachefehler zurückgegebene Statuscode einem der Statuscodes in der Liste der Antwortfehlercodes entspricht, werden die Daten, die als Antwort auf eine HTTP-Anforderung zurückgegeben werden, vom dynamischen Cache-Service nicht zwischengespeichert.

Wenn Sie sich für die Verwendung dieser angepassten Eigenschaft entscheiden, definieren Sie sie als angepasste JVM-Eigenschaft des Anwendungsservers, sofern im Kontext einer bestimmten Task keine anderen Angaben enthalten sind.

com.ibm.ws.cache.CacheConfig.use61EntrySetBehavior

Verwenden Sie diese Eigenschaft, um eine Set-Ansicht der in der Map enthaltenen Zuordnungen zurückzugeben.

Wenn com.ibm.ws.cache.CacheConfig.use61EntrySetBehavior definiert und auf true gesetzt ist, gibt die Methode DistributedMap.entrySet() eine Set-Ansicht der in der Map enthalten Zuordnungen.

Diese angepasste Eigenschaft kann als angepasste JVM-Eigenschaft unter Server > Anwendungsserver > <Servername> > Prozessdefinitionen > Java Virtual Machine > Angepasste Eigenschaften festgelegt werden.

Wenn Sie diese angepasste JVM-Eigenschaft definieren, wirkt sie sich auf alle Cacheinstanzen aus. Diese Eigenschaft wird auf der Ebene des Anwendungsservers definiert.

com.ibm.ws.cache.CacheConfig.useServerClassLoader

Verwenden Sie diese Eigenschaft, um festzulegen, welches Klassenladeprogramm JVM beim Entserialisieren eines InvalidationEvent (Invalidierungsereignis) verwenden soll. Wenn Sie diese Eigenschaft auf true setzen, wird das Klassenladeprogramm des Servers zum Entserialisieren des InvalidationEvent verwendet. Wenn Sie diese Eigenschaft auf false setzen, wird das Klassenladeprogramm der Anwendung zum Entserialisieren des InvalidationEvent verwendet. Der Standardwert ist false.

Durch Verwendung des geeigneten Klassenladeprogramms beim Entserialisieren eines InvalidationEvent kann die Leistung verbessert werden.

Wenn Sie sich für die Verwendung dieser angepassten Eigenschaft entscheiden, definieren Sie sie als angepasste JVM-Eigenschaft des Anwendungsservers, sofern im Kontext einer bestimmten Task keine anderen Angaben enthalten sind.

com.ibm.ws.CacheConfig.alwaysTriggerCommandInvalidations

Verwenden Sie diese Eigenschaft, um sicherzustellen, dass Befehlsinvalidierungen ungeachtet des Attributs "skipCache" ausgelöst werden.

Wenn ein Anforderungsobjekt das Attribut <previewRequest> enthält, setzt der dynamische Cache das Attribut "skipCache" auf "true". Wenn das Attribut "skipCache" den Wert "true" hat, werden Befehle nicht immer invalidiert. Setzen Sie die angepasste Eigenschaft "com.ibm.ws.CacheConfig.alwaysTriggerCommandInvalidations" auf "true", um sicherzustellen, dass Befehlsinvalidierungen ungeachtet des Attributs "skipCache" ausgelöst werden. Wenn Sie diese angepasste Eigenschaft definieren, betrifft das alle Cacheinstanzen. Der Standardwert ist false.

Diese angepasste Eigenschaft wird nur auf der Anwendungsserverebene definiert.

Wenn Sie sich für die Verwendung dieser angepassten Eigenschaft entscheiden, definieren Sie sie als angepasste JVM-Eigenschaft des Anwendungsservers, sofern im Kontext einer bestimmten Task keine anderen Angaben enthalten sind.

com.ibm.ws.cdi.immediate.ejb.start

Verwenden Sie diese Eigenschaft, um sicherzustellen, dass der CDI-Container (Contexts and Dependency Injection, Kontext- und Abhängigkeitsinjektion) und seine Lebenszyklen für alle EJB-Module gestartet werden, wenn die Anwendung gestartet wird.

Wenn diese Eigenschaft auf den Wert true gesetzt ist, werden der CDI-Container und seine Lebenszyklen für alle EJB-Module gestartet, wenn die Anwendung gestartet wird. Der Standardwert für diese Eigenschaft ist false.

com.ibm.ws.classloader.allowDisposedClassLoad

Verwenden Sie diese Eigenschaft, um anzugeben, ob die JVM ein Anwendungsklassenladeprogramm vollständig verwerfen soll, wenn die Anwendung gestoppt wird. Wenn die JVM ein Anwendungsklassenladeprogramm nicht vollständig verwirft, können weiterhin Klassen über dieses Klassenladeprogramm geladen werden.

Wenn Sie diese Eigenschaft auf den Wert true setzen, verwirft die JVM ein Anwendungsklassenladeprogramm nicht vollständig, wenn die Anwendung gestoppt wird.

Der Standardwert ist false.

Wenn Sie sich für die Verwendung dieser angepassten Eigenschaft entscheiden, müssen Sie sie als angepasste JVM-Eigenschaft des Anwendungsservers definieren.

com.ibm.ws.classloader.encodeResourceURLs

Verwenden Sie diese Eigenschaft, um festzulegen, ob das Anwendungsklassenladeprogramm, z. B. EAR, Webmodul und Ladeprogramme für gemeinsam genutzte Bibliotheken, in den Ressourcen-URLs Leerzeichen codieren. Wenn Sie diese Eigenschaft auf true setzen, werden Leerzeichen in den URLs, die von getResource- oder getResources-Aufrufen zurückgegeben werden, als "%20" codiert.

Der Standardwert ist true. Wenn Sie diese Eigenschaft auf false setzen, wird die Warnung WSVR0333W in den Protokollen angezeigt. Diese Nachricht weist darauf hin, dass die Verwendung der Einstellung false für diese Eigenschaft nicht mehr unterstützt wird.

Wenn Sie sich für die Verwendung dieser angepassten Eigenschaft entscheiden, müssen Sie sie als angepasste JVM-Eigenschaft des Anwendungsservers definieren.

com.ibm.ws.classloader.strict

Verwenden Sie diese Eigenschaft, um dem Anwendungsklassenladeprogramm von WebSphere Application Server den Zugriff auf das Verzeichnis META-INF über einen getResources-Aufruf auch dann zu ermöglichen, wenn der META-INF-Verzeichnispfad keinen abschließenden Schrägstrich enthält.

Das Anwendungsklassenladeprogramm von WebSphere Application Server lässt den Zugriff auf das Verzeichnis META-INF über einen getResources-Aufruf standardmäßig nicht zu, wenn kein abschließender Schrägstrich am Ende des META-INF-Verzeichnispfads enthalten ist. Wenn das Anwendungsklassenladeprogramm von WebSphere Application Server den Zugriff auf das Verzeichnis META-INF über einen getResources-Aufruf auch dann zulassen soll, wenn kein abschließender Schrägstrich am Ende des META-INF-Verzeichnispfads enthalten ist, setzen Sie diese Eigenschaft auf true.

Der Standardwert ist false.

Wenn Sie sich für die Verwendung dieser angepassten Eigenschaft entscheiden, müssen Sie sie als angepasste JVM-Eigenschaft des Anwendungsservers definieren.

com.ibm.ws.classloader.zipFileCacheSize

Verwenden Sie diese Eigenschaft, um die maximale Anzahl an Anwendungs-JAR-Dateien anzugeben, die für das Laden von Ressourcen und Klassen offen gehalten werden können. Je seltener JAR-Dateien geöffnet werden müssen, desto höher ist die Leistung von Anwendungen, die sehr viele Ressourcen oder Klassen laden müssen.

Wenn das angegebene Limit offener JAR-Dateien erreicht ist, beginnt das Klassenladeprogramm damit, JAR-Dateien auf der Basis der letzten Zugriffszeit zu schließen und zu entfernen. Die zuletzt aufgerufenen JAR-Dateien bleiben offen. Der für diese Eigenschaft angegebene Wert muss auf der Gesamtanzahl der Anwendungs-JAR-Dateien basieren, auf die häufig zugegriffen wird.

Der Standardwert für diese Eigenschaft ist 8. Der Wert 0 inaktiviert den Cache und verhindert, dass Anwendungs-JAR-Dateien geöffnet bleiben.

Fehler vermeiden Fehler vermeiden: Um Probleme zu vermeiden, sollten Sie die Hot-Deployment-Funktion (Implementierung während des Betriebs) von Microsoft Windows nicht verwenden, wenn Sie einen anderen Wert als 0 für diese Eigenschaft definieren.gotcha

Wenn Sie sich für die Verwendung dieser angepassten Eigenschaft entscheiden, müssen Sie sie als angepasste JVM-Eigenschaft des Anwendungsservers definieren.

com.ibm.ws.cscope.HighlyAvailableIORsEnabled

Mit dieser Eigenschaft kann der Administrator den Kompensationsservice so konfigurieren, dass hoch verfügbare IORs für verteilte CORBA-Geschäftsaktivitätsobjekte generiert werden. Dadurch können untergeordnete verteilte Geschäftsaktivitäten, die fehlgeschlagen sind, während der Peerwiederherstellung abgeschlossen werden. Diese Eigenschaft erlaubt auch neue Geschäftsaktivitäten, wenn der Node Agent nicht ausgeführt wird.

Der Standardwert für diese Eigenschaft ist false. Durch Angabe des Werts true wird diese Eigenschaft aktiviert. Diese Eigenschaft sollte auf jedem Anwendungsserver im Cluster festgelegt werden.

com.ibm.ws.el.reuseEvaluationContext

Verwenden Sie diese Eigenschaft, um anzugeben, dass dasselbe EvaluationContext-Objekt auf Threadbasis wiederverwendet werden kann.

Gewöhnlich erstellt der Unified-EL-Code während der Auswertung von Ausdrücken ein neues org.apache.el.lang.EvaluationContext-Objekt für jeden abgesetzten Aufruf. Da diese Objekte anschließend für die Garbage-Collection verfügbar gemacht werden, nehmen mit zunehmender Anzahl erstellter Objekte auch die Speicherbelegung und die Garbage-Collection zu. Wenn Sie die Eigenschaft "com.ibm.ws.el.reuseEvaluationContext" auf true setzen, kann dasselbe EvaluationContext-Objekt auf Threadbasis wiederverwendet werden, was die Speicherbelegung und die erforderliche Garbage-Collection reduziert.

Der Standardwert ist false.

com.ibm.ws.http.ConnectionIOTimeout

Verwenden Sie diese Eigenschaft, um das Zeitlimit des SOAP-Ports zu verlängern, das zwischen dem Zeitpunkt, zu dem die Verbindung aufgebaut wurde, und dem Zeitpunkt, zu dem die Datenübertragung vom Client beginnt, liegt. Der Standardwert ist 5 Sekunden (15 Sekunden in Liberty). Dieser Wert muss möglicherweise erhöht werden, wenn eine SOAP-Server- oder SOAP-Client-JVM aktiv ist oder wenn ein SSL-Handshake längere Zeit dauert. Wenn dieses Zeitlimit auftritt, wird möglicherweise die Nachricht HTTP 408 vom SOAP-Server empfangen.

[z/OS]

com.ibm.ws.iiop.channel.disableOnewayLocateRequiredMessage

Mit dieser Eigenschaft können Sie steuern, ob die Nachricht CWZGB0005I angezeigt wird, wenn eine unidirektionale GIOP-Anforderung für ein Objekt eine weitere locate-forward-Adressierung erfordert. Wenn Sie diese Eigenschaft auf false setzen, wird die Nachricht CWZGB0005I angezeigt. Wenn Sie die Eigenschaft auf true setzen, wird die Nachricht CWZGB0005I nicht angezeigt.

Der Standardwert ist false.

com.ibm.ws.jsf.allow.interpolator.per.app

Der JSF-Container wurde aktualisiert, damit für jede Anwendung ein MessageInterpolator definiert und verwendet werden kann, der nicht von mehreren Anwendungen gemeinsam genutzt wird. Damit das neue Verhalten aktiviert wird, muss diese Eigenschaft auf true gesetzt werden.

com.ibm.ws.jsf.call.publishevent.with.sourceclass

Verwenden Sie diese Eigenschaft, um sicherzustellen, dass beim Aufruf von javax.faces.Application.publishEvent die richtige Quellenklasse verwendet wird. Beim Aufruf von javax.faces.Application.publishEvent wird anstelle der tatsächlichen Quellenklasse standardmäßig UIComponent.class verwendet. Allerdings sollte der Parameter sourceBaseType das Quellenereignis angeben, mit dem der Listener gesucht wird, in dem dieses Ereignis veröffentlicht werden muss. Wenn dieses Argument null ist, muss der Rückgabewert von source.getClass() für sourceBaseType verwendet werden.

Der Standardwert ist false.

com.ibm.ws.jsp.enhance_el_support

Verwenden Sie diese Eigenschaft, um die Verarbeitung eines Ausdrucks zu steuern. Bei der Auswertung eines Ausdrucks wird der Wert basierend auf Abschnitt 1.8.2 der Expression Language Specification Version 2.1 in den erwarteten Typ umgesetzt. Das kann unerwartete Ergebnisse zur Folge haben, da der Ausdruckswert möglicherweise nicht der erwartete Typ ist. Setzen Sie diese Eigenschaft auf true, um die Umsetzung zu verhindern.

Der Standardwert ist false.

com.ibm.ws.management.application.task.AppTypeDeploymentTask.isLongRunningApp

Diese Eigenschaft wird nur zur Informationszwecken aufgelistet. Diese Eigenschaft wird automatisch erstellt und für die automatische Konfiguration verwendet. Sie sollte daher nicht geändert werden.

Der Standardwert ist true.

com.ibm.ws.management.connector.soap.logClientInfo

Mit dieser Eigenschaft können Sie angeben, ob Sie den Host, den Port und den Benutzernamen von SOAP-Clientanforderungen protokollieren möchten. Wenn Sie diese Eigenschaft auf true setzen, werden SOAP-Clientdetails in SystemOut.log protokolliert. Diese Details werden werden auch der Datei "trace.log" hinzugefügt, wenn die Tracestufe für den SOAP-Connector auf all ist.

Der Standardwert ist false.

[Windows]

com.ibm.ws.management.connector.soap.waitBeforeCloseTime

Mit dieser Eigenschaft können Sie das Zeitlimit für SOAP-Verbindungen des Servers ändern. Wenn Sie den localhost-Adapter unter einem Microsoft Windows-Betriebssystem verwenden, lässt das Zeitlimit für SOAP-Verbindungen des Servers, das standardmäßig 10 Millisekunden beträgt, das Streaming großer Datenvolumen ohne Unterbrechung zu.

Wenn Sie für diese Eigenschaften einen zu kleinen Wert festlegen, wird beim Streaming eines großen Datenvolumens auf der Serverseite der Verbindung eine Ausnahme des Typs "SOAPException" wegen eines vorzeitigen Datenstromendes ausgelöst.

Der Wert 0 inaktiviert das Zeitlimit.

com.ibm.ws.management.event.max_polling_interval

Verwenden Sie diese Eigenschaft, um die maximale Wartezeit für den Server anzugeben, nach deren Ablauf der Server Benachrichtigungen vom Client anfordert oder abruft. Das Standard-Polling-Intervall beträgt 1000 Millisekunden (1 Sekunde). Wenn kein Wert für die Eigenschaft angegeben wird, wird der Standardwert verwendet.

Wenn Sie einen SOAP- oder IPC-Connector verwenden, können Sie den Connector mit dieser Eigenschaft so anpassen, dass die Zeitdauer, während der der Server auf eine Polling-Benachrichtigung vom Client wartet, mit dem Zeitintervall übereinstimmt, das der Server bei Verwendung eines RMI-Connectors einhalten würde.

Wenn dieser Eigenschaftswert auf -1 gesetzt wird, verwendet der Client einen integrierten adaptiven Algorithmus, um Benachrichtigungen abzufragen. Dieser Algorithmus ändert das Polling-Intervall basierend auf der Anzahl der Benachrichtigungen, die der Client empfängt. Zwischen den Pollings kann ein Zeitintervall von 3 bis 20 Sekunden verstreichen, bevor die erste Benachrichtigung empfangen wird.

Hinweis zur Umstellung Hinweis zur Umstellung: Wenn in einer Version vor Version 8.0 kein Wert für die Eigenschaft com.ibm.ws.management.event.max_polling_interval festgelegt wurde, erfolgten die Client-Pollings der Benachrichtigungen auf der Basis eines integrierten adaptiven Algorithmus, der das Polling-Intervall basierend auf der Anzahl der Benachrichtigungen, die der Client empfangen hat, änderte.trns

Diese Eigenschaft muss für die clientseitige JVM angegeben werden.

com.ibm.ws.management.event.pull_notification_timeout

Verwenden Sie diese Eigenschaft, um anzugeben, wie lange der Client wartet, bevor er eine Benachrichtigung vom Server abruft. Das Standardzeitlimit ist 60000 Millisekunden (60 Sekunden oder 1 Minute). Wenn kein Wert für die Eigenschaft angegeben wird, wird der Standardwert verwendet.

Wenn als Wert für die Eigenschaft 0 (null) oder eine negative Zahl wie -1 angegeben wird, kehrt der Server sofort zum Client zurück, selbst wenn keine Benachrichtigung verfügbar ist.

Hinweis zur Umstellung Hinweis zur Umstellung: Wenn in einer Version vor Version 8.0 kein Wert für die Eigenschaft com.ibm.ws.management.event.pull_notification_timeout angegeben wurde, kehrte der Server unverzüglich zum Client zurück, selbst wenn keine Benachrichtigung verfügbar war.trns

Diese Eigenschaft muss für die serverseitige JVM angegeben werden.

com.ibm.ws.management.repository.tempFileKeepTimeMinutes

Mit dieser Eigenschaft können Sie angeben, wie lange (in Minuten) eine Datei im temporären Verzeichnis des Konfigurationsrepositorys aufbewahrt wird, bevor die Bereinigungstask für das temporäre Verzeichnis des Konfigurationsrepositorys diese Datei aus dem Verzeichnis löschen kann. Der Standardwert für diese Eigenschaft ist "1440" (Minuten). Dies entspricht 24 Stunden. In früheren Versionen des Produkts wurde eine Datei 60 Minuten aufbewahrt.

Der Standardwert ist gewöhnlich ausreichend, um die erforderliche Bereinigung durchzuführen, ohne dass Dateien gelöscht werden, die im Gebrauch sind. Es kann jedoch Situationen geben, in denen Sie einen größeren oder kleineren Wert angeben müssen. Sie können eine Mindestwert von 60 Minuten für diese Eigenschaft angeben. Es wird jedoch empfohlen, einen Wert anzugeben, der mehreren Stunden entspricht, um Situationen abzufangen, in denen sehr große Dateien übertragen oder synchronisiert werden oder in denen das Netz langsam ist und Dateiübertragungsoperationen sehr lange dauern. Wenn in solchen Situationen ein zu kleiner Zeitraum angegeben ist, ist es möglich, dass eine Datei gelöscht während ihrer Übertragung gelöscht wird.

Wenn die Eigenschaft "com.ibm.ws.management.repository.tempFileSweepIntervalMinutes" auf 0 gesetzt ist, ist die Bereinigungsfunktion inaktiviert, und alle Dateien, die nach einem Fehler im Serverprozess übrig bleiben, werden so lange im temporären Verzeichnis des Konfigurationsrepositorys aufbewahrt, bis sie manuell entfernt oder die Bereinigungsfunktion aktiviert wird.

Fehler vermeiden Fehler vermeiden: Wird ein ungültiger Wert für diese Eigenschaft angegeben, wird der Standardwert verwendet.gotcha

com.ibm.ws.management.repository.tempFileSweepIntervalMinutes

Mit dieser Eigenschaft können Sie festlegen, in welchem Intervall (Minuten) die Bereinigungstask für das temporäre Verzeichnis des Konfigurationsrepositorys ausgeführt wird. Diese Task entfernt Dateien aus dem temporären Verzeichnis des Konfigurationsrepositorys, die aufgrund eines Fehlers im Serverprozess nicht ordnungsgemäß entfernt wurden.

Die Bereinigungstask wird immer beim Serverstart und anschließend in dem Intervall ausgeführt, das Sie mit dieser Eigenschaft festlegen. Der Standardwert für diese Eigenschaft ist "720" (Minuten). Dies entspricht 12 Stunden. Gewöhnlich reicht der Standardwert für die Bereinigungstask für das temporäre Verzeichnis des Konfigurationsrepositorys aus, damit der Bereinigungsprozess ordnungsgemäß ausgeführt werden kann. Sie können diese Bereinigungsfunktion inaktivieren, indem Sie diese Eigenschaft auf 0 setzen.

In früheren Versionen des Produkts wurde die Bereinigungstask beim Serverstart und danach alle 30 Minuten ausgeführt.

Fehler vermeiden Fehler vermeiden: Wird ein ungültiger Wert für diese Eigenschaft angegeben, wird der Standardwert verwendet.gotcha

com.ibm.ws.management.suppressPortScan

Setzen Sie diese Eigenschaft auf den Wert true, um die Portaktivitätsprüfung durch den Deployment Manager zu unterdrücken, wenn neue Server erstellt werden. Bei Angabe des Werts true wird der Deployment Manager keine Bindung oder Verbindung zu einem neuen Port aufbauen, bevor er den Port in einer Serverkonfiguration verwendet. Wird die Prüfung der Portaktivität unterdrückt, kann dies zu Portkonflikten führen, wenn andere Anwendungen aktive Ports haben. Der Standardwert ist false.

com.ibm.ws.management.taskcommandtimeoutsec

Setzen Sie diese Eigenschaft auf einen Wert in Sekunden, falls eine Ausnahme des Typs SessionTimeoutException im TaskCommandSessionMgr auftritt, während ein Anwendungsupdate über einen längeren Zeitraum hinweg ausgeführt wird. Der Standardwert ist 1200 Sekunden (20 Minuten).

com.ibm.ws.odr.plugincfg.config.ASDisableNagle

Verwenden Sie diese Eigenschaft, um festzulegen, ob der Nagle-Algorithmus für die Verbindung zwischen dem Plug-in und dem Proxy-Server inaktiviert werden soll.

Diese Eigenschaft ist nur für einen Proxy-Server gültig und gilt für das Element "Config" in der Datei "plugin-cfg.xml", die automatisch vom Proxy-Server generiert wird.

Der Standardwert ist false, d. h., der Nagle-Algorithmus wird für die Verbindung zwischen dem Plug-in und dem Proxy-Server aktiviert.

com.ibm.ws.odr.plugincfg.config.AcceptAllContent

Geben Sie mit dieser Eigenschaft an, ob der Inhalt in POST-, PUT-, GET- und HEAD-Anforderungen eingefügt werden kann, wenn ein Header vom Typ Content-Length oder Transfer-encoding im Anforderungsheader enthalten ist. Sie können für dieses Attribut einen der folgenden Werte angeben:
  • True, wenn für alle Anforderungen Inhalt erwartet gelesen wird.
  • False, wenn nur für Anforderungen des Typs POST und PUT Inhalt erwartet und gelesen wird.

Diese Eigenschaft ist nur für einen Proxy-Server gültig und gilt für das Element "Config" in der Datei "plugin-cfg.xml", die automatisch vom Proxy-Server generiert wird.

Der Standardwert ist false.

com.ibm.ws.odr.plugincfg.config.AppServerPortPreference

Verwenden Sie diese Eigenschaft, um die Portnummer festzulegen, die zum Erstellen der URIs für sendRedirect verwendet werden soll.

Diese Eigenschaft ist nur für einen Proxy-Server gültig und gilt für das Element "Config" in der Datei "plugin-cfg.xml", die automatisch vom Proxy-Server generiert wird.

Der Standardwert ist HostHeader.

com.ibm.ws.odr.plugincfg.config.ChunkedResponse

Verwenden Sie diese Eigenschaft, um festzulegen, ob das Plug-in die Antwort an den Client gruppiert, wenn ein Antwortheader "Transfer-Encoding : Chunked" in der Antwort enthalten ist.

Sie können für dieses Attribut einen der folgenden Werte angeben:
  • True, wenn das Plug-in die Antwort an den Client in Blöcke aufteilen soll, falls ein Header vom Typ "Transfer-Encoding : Chunked" in der Antwort enthalten ist.
  • False, wenn die Antwort nicht in Blöcke aufgeteilt werden soll.

Diese Eigenschaft ist nur für einen Proxy-Server gültig und gilt für das Element "Config" in der Datei "plugin-cfg.xml", die automatisch vom Proxy-Server generiert wird.

Der Standardwert ist false.

com.ibm.ws.odr.plugincfg.config.IISDisableNagle

Geben Sie mit dieser Eigenschaft an, ob der Nagle-Algorithmus inaktiviert werden soll.

Diese Eigenschaft ist nur für einen Proxy-Server gültig und gilt für das Element "Config" in der Datei "plugin-cfg.xml", die automatisch vom Proxy-Server generiert wird.

Der Standardwert ist false.

com.ibm.ws.odr.plugincfg.config.IISPluginPriority

Geben Sie mit dieser Eigenschaft die Priorität an, mit der der Web-Server das Plug-in lädt. Sie können für dieses Attribut einen der folgenden Werte angeben:
  • Hoch
  • Mittel
  • Niedrig

Diese Eigenschaft ist nur für einen Proxy-Server gültig und gilt für das Element "Config" in der Datei "plugin-cfg.xml", die automatisch vom Proxy-Server generiert wird.

Der Standardwert ist High.

com.ibm.ws.odr.plugincfg.config.IgnoreDNSFailures

Verwenden Sie diese Eigenschaft, um festzulegen, ob das Plug-in DNS-Fehler in einer Konfiguration beim Starten ignorieren soll.

Wenn Sie diese Eigenschaft auf "true" setzen, ignoriert das Plug-in DNS-Fehler in einer Konfiguration und wird erfolgreich gestartet, wenn mindestens ein Server in jedem Server-Cluster den Hostnamen auflöst. Jeder Server, für den der Hostname nicht aufgelöst werden kann, wird für die Lebensdauer der Konfiguration als nicht verfügbar gekennzeichnet. Der Hostname wird später beim Routing der Anforderungen nicht aufgelöst. Wenn ein DNS-Fehler auftritt, wird eine Protokollnachricht in die Plug-in-Protokolldatei geschrieben. Die Initialisierung des Plug-ins wird fortgesetzt, anstatt den Web-Server nicht zu starten.

Diese Eigenschaft ist nur für einen Proxy-Server gültig und gilt für das Element "Config" in der Datei "plugin-cfg.xml", die automatisch vom Proxy-Server generiert wird.

Der Standardwert ist false.

com.ibm.ws.odr.plugincfg.config.RefreshInterval

Verwenden Sie diese Eigenschaft, um festzulegen, wie oft (in Sekunden) das Plug-in die Konfigurationsdatei auf Aktualisierungen oder Änderungen hin überprüfen soll. Das Plug-in sucht in der Datei nach Änderungen, die seit dem Laden der Plug-in-Konfiguration vorgenommen wurden.

In einer Entwicklungsumgebung, in der häufig Änderungen vorgenommen werden, setzen Sie das Zeitintervall auf weniger als 60 Sekunden.

In einer Fertigungsumgebung sollten Sie einen höheren Wert als den Standardwert festlegen, weil Änderungen an der Konfiguration nicht mehr so häufig vorgenommen werden.

Sollte das erneute Laden des Plug-in fehlschlagen, wird eine entsprechende Fehlernachricht in die Protokolldatei des Plug-ins geschrieben und die vorherige Konfiguration so lange verwendet, bis die Konfigurationsdatei des Plug-in fehlerfrei geladen werden kann. Suchen Sie in der Protokolldatei des Plug-ins nach weiteren Informationen, wenn ein Fehler auftritt.

Diese Eigenschaft ist nur für einen Proxy-Server gültig und gilt für das Element "Config" in der Datei "plugin-cfg.xml", die automatisch vom Proxy-Server generiert wird.

Der Standardwert ist 60.

com.ibm.ws.odr.plugincfg.config.ResponseChunkSize

Verwenden Sie diese Eigenschaft, um die maximale Blockgröße festzulegen, die das Plug-in beim Lesen des Antworthauptteils verwenden kann. Beispiel: Config ResponseChunkSize="N", wobei N für die Blockgröße steht.

Standardmäßig liest das Plug-in den Hauptteil der Antwort in 64-KB-Blöcken, bis alle Antwortdaten gelesen sind. Dieser Prozess kann zu Leistungsproblemen bei Anforderungen führen, deren Antworthauptteil große Datenmengen enthält. Wenn die Inhaltslänge des Antworthauptteils nicht bekannt ist, wird eine Puffergröße von N Kilobytes zugeordnet, und der Hauptteil wird in Blöcken von N KB gelesen, bis alle Daten gelesen sind. Ist die Inhaltslänge bekannt, wird ein Puffer zum Lesen des Antworthauptteils verwendet, dessen Größe der Inhaltslänge bzw. N entspricht.

Diese Eigenschaft ist nur für einen Proxy-Server gültig und gilt für das Element "Config" in der Datei "plugin-cfg.xml", die automatisch vom Proxy-Server generiert wird.

Der Standardwert ist 64.

com.ibm.ws.odr.plugincfg.config.VHostMatchingCompat

Verwenden Sie diese Eigenschaft, um festzulegen, ob das Plug-in die Portnummer für den Abgleich des virtuellen Hosts verwenden soll. Die folgenden Werte können angegeben werden:
  • "true", wenn der Abgleich physisch anhand der Nummer des Ports durchgeführt werden soll, für den die Anforderung empfangen wurde,
  • "false", wenn der Abgleich logisch anhand der Portnummer im Host-Header durchgeführt werden soll.

Diese Eigenschaft ist nur für einen Proxy-Server gültig und gilt für das Element "Config" in der Datei "plugin-cfg.xml", die automatisch vom Proxy-Server generiert wird.

Der Standardwert ist false.

com.ibm.ws.odr.plugincfg.config.TrustedProxyEnable

Verwenden Sie diese Eigenschaft, um festzulegen, ob das Plug-in den Einschluss anerkannter Proxy-Server zulassen soll. Die folgenden Werte können angegeben werden:
  • "true", wenn der Einschluss anerkannter Proxy-Server zugelassen werden soll,
  • "false", wenn der Einschluss anerkannter Proxy-Server nicht zugelassen werden soll.

Die anerkannten Proxy-Server werden aus den definierten anerkannten Sicherheitsproxys erfasst.

Diese Eigenschaft ist nur für einen Proxy-Server gültig und gilt für das Element "Config" in der Datei "plugin-cfg.xml", die automatisch vom Proxy-Server generiert wird.

Der Standardwert ist false.

com.ibm.ws.odr.plugincfg.log.Name

Verwenden Sie diese Eigenschaft, um den vollständig qualifizierten Pfad zu der Protokolldatei anzuzeigen, in die das Plug-in Fehlernachrichten schreibt.

Diese Eigenschaft ist nur für einen Proxy-Server gültig und gilt für das Element "Log" in der Datei "plugin-cfg.xml", die automatisch vom Proxy-Server generiert wird.

Der Standardwert ist Profilstammverzeichnis/logs/http_plugin.log.

com.ibm.ws.odr.plugincfg.log.LogLevel

Verwenden Sie diese Eigenschaft, um die Detaillierungsebene der Protokollnachrichten anzugeben, die das Plug-in in das Protokoll schreibt. Sie können für dieses Attribut einen der folgenden Werte angeben:
  • Trace. Alle Schritte im Anforderungsprotokoll werden detailliert protokolliert.
  • Stats. Der für jede Anforderung ausgewählte Server und weitere Lastausgleichinformationen zur Anforderungsverarbeitung werden protokolliert.
  • Warn. Alle Warnungen und Fehlernachrichten, die Folge einer abnormalen Anforderungsverarbeitung sind, werden protokolliert.
  • Fehler. Es werden nur Fehlernachrichten, die Folge einer abnormalen Anforderungsverarbeitung sind, protokolliert.
  • Debug. Alle in Verarbeitungsanforderungen ausgeführten kritischen Schritte werden protokolliert.
  • Detail. Alle Informationen zu Anforderungen und Antworten werden protokolliert.

Diese Eigenschaft ist nur für einen Proxy-Server gültig und gilt für das Element "Log" in der Datei "plugin-cfg.xml", die automatisch vom Proxy-Server generiert wird.

Der Standardwert ist Error.

Fehler vermeiden Fehler vermeiden: Bei dieser Einstellung werden viele Nachrichten protokolliert, sodass der Plattenspeicherplatz des Dateisystems sehr schnell erschöpft sein kann. In einer normalen Betriebsumgebung sollte keine Traceeinstellung verwendet werden, weil sie sich nachteilig auf den Durchsatz auswirkt.gotcha

com.ibm.ws.odr.plugincfg.cluster.CloneSeparatorChange

Verwenden Sie diese Eigenschaft, um dem Plug-in mitzuteilen, dass das Pluszeichen (+) als Klontrennzeichen verwendet werden kann.

Einige Einheiten für Pervasive Computing können keinen Doppelpunkt (:) verarbeiten, der zum Trennen der Klon-IDs bei der Sitzungsaffinität verwendet wird.

Fehler vermeiden Fehler vermeiden: Wenn Sie diese angepasste Eigenschaft verwenden, müssen Sie die Proxy-Server-Konfigurationen so ändern, dass der Proxy-Server Klon-IDs durch das Pluszeichen und nicht durch den Doppelpunkt voneinander trennt.gotcha

Diese Eigenschaft ist nur für einen Proxy-Server gültig und gilt für das Element "ServerCluster" in der Datei "plugin-cfg.xml", die automatisch vom Proxy-Server generiert wird.

Der Standardwert ist false.

com.ibm.ws.odr.plugincfg.cluster.LoadBalance

Verwenden Sie diese Eigenschaft, um die richtige Lastausgleichsoption anzugeben: Round Robin oder Random.

Die Round-Robin-Implementierung hat einen willkürlichen Anfangspunkt. Der erste Proxy-Server wird nach dem Zufallsprinzip gewählt. Danach werden die Proxy-Server im Round-Robin-Verfahren ausgewählt. Diese Implementierung stellt sicher, dass in prozessbasierten Web-Servern nicht alle Prozesse sofort mit dem Senden der ersten Anforderung an denselben Proxy-Server beginnen.

Die Random-Implementierung hat ebenfalls einen willkürlichen Anfangspunkt. Bei dieser Implementierung werden jedoch auch alle nachfolgenden Proxy-Server zufällig ausgewählt. Deshalb kann unter Umständen derselbe Proxy-Server mehrfach ausgewählt werden, während andere Proxy-Server inaktiv bleiben.

Der Standardwert ist Round Robin.

com.ibm.ws.odr.plugincfg.cluster.PostSizeLimit

Verwenden Sie diese Eigenschaft, um die maximale Größe von Anforderungsinhalten (in Bytes) festzulegen, die das Plug-in an einen Server senden darf. Wenn eine Anforderung empfangen wird, deren Größe den angegebenen Wert überschreitet, beendet das Plug-in die Anforderung.

Diese Eigenschaft ist nur für einen Proxy-Server gültig und gilt für das Element "ServerCluster" in der Datei "plugin-cfg.xml", die automatisch vom Proxy-Server generiert wird.

Der Standardwert ist -1 und gibt an, dass die Größe einer Anforderung nicht begrenzt ist.

com.ibm.ws.odr.plugincfg.cluster.RemoveSpecialHeaders

Verwenden Sie diese Eigenschaft, um anzugeben, ob das Plug-in einer Anforderung spezielle Header hinzufügen soll, bevor es die Anforderung an den Server weiterleitet. Diese Header enthalten Informationen zur Anforderung, die dann von der Anwendung verwendet werden. Standardmäßig entfernt das Plug-in diese Header aus eingehenden Anforderungen, bevor es die erforderlichen Header hinzufügt.

Wenn Sie diese Eigenschaft auf "false" setzen, bedeutet dies ein potenzielles Sicherheitsrisiko, da die Header nicht aus eingehenden Anforderungen entfernt werden.

Diese Eigenschaft ist nur für einen Proxy-Server gültig und gilt für das Element "ServerCluster" in der Datei "plugin-cfg.xml", die automatisch vom Proxy-Server generiert wird.

Der Standardwert ist true.

com.ibm.ws.odr.plugincfg.cluster.RetryInterval

Geben Sie mit dieser Eigenschaft an, nach welchem Zeitraum (in Sekunden) das Plug-in mit Verbindungswiederholungen beginnen soll, nachdem ein Proxy-Server als inaktiv markiert wurde.

Diese Eigenschaft ist nur für einen Proxy-Server gültig und gilt für das Element "ServerCluster" in der Datei "plugin-cfg.xml", die automatisch vom Proxy-Server generiert wird.

Der Standardwert ist 60.

com.ibm.ws.odr.plugincfg.odrIncludeStopped

Verwenden Sie diese Eigenschaft, um festzulegen, ob das Plug-in den Einschluss gestoppter Proxy-Server zulassen soll. Die folgenden Werte können angegeben werden:
  • "true", wenn der Einschluss gestoppter Proxy-Server zugelassen werden soll,
  • "false", wenn der Einschluss gestoppter Proxy-Server nicht zugelassen werden soll.

Diese Eigenschaft ist nur für einen Proxy-Server gültig.

Der Standardwert ist false.

com.ibm.ws.odr.plugincfg.server.ConnectTimeout

Verwenden Sie diese Eigenschaft, um anzugeben, wie lange (in Sekunden) das Plug-in auf eine erfolgreiche Verbindung wartet.

Wenn Sie einen Wert für die Eigenschaft angeben, kann das Plug-in nicht blockierende Verbindungen zum Proxy-Server herstellen. Solche Verbindungen sind hilfreich, wenn das Plug-in keine Verbindung zum Ziel herstellen kann, um festzustellen, ob der Port verfügbar ist.

Wenn Sie einen Wert angeben, der größer als 0 ist, und nach Ablauf des Zeitintervalls keine Verbindung hergestellt werden kann, markiert das Plug-in den Proxy-Server als nicht verfügbar und fährt dann mit einem der anderen Proxy-Server fort, die im Cluster definiert sind.

Wenn Sie keinen Wert für diese Eigenschaft angeben, führt das Plug-in eine blockierende Verbindung aus, in der das Plug-in wartet, bis ein Betriebssystem ein Zeitlimit überschreitet und dem Plug-in ermöglicht, den Server als nicht verfügbar zu markieren.

Diese Eigenschaft ist nur für einen Proxy-Server gültig und gilt für das Element "Server" in der Datei "plugin-cfg.xml", die automatisch vom Proxy-Server generiert wird.

Der Standardwert ist 0.

com.ibm.ws.odr.plugincfg.server.ExtendedHandShake

Verwenden Sie diese Eigenschaft, um dem Plug-in mitzuteilen, dass die Verfügbarkeit eines Proxy-Servers sichergestellt werden muss, bevor eine Anforderung an diesen Proxys-Server gesendet wird.

Gewöhnlich markiert das Plug-in einen Proxy-Server als gestoppt, wenn eine connect()-Methode beendet wird. Wenn jedoch eine Proxy-Firewall zwischen dem Plug-in und dem Proxy-Server vorhanden ist, ist die Methode "connect()" erfolgreich, selbst wenn der Back-End-Proxy-Server gestoppt ist. Diese Situation bewirkt, dass das Plug-in nicht ordnungsgemäß an die anderen Proxy-Server übertragen wird.

Diese Eigenschaft ist nur für einen Proxy-Server gültig und gilt für das Element "Server" in der Datei "plugin-cfg.xml", die automatisch vom Proxy-Server generiert wird.

Der Standardwert ist false.

com.ibm.ws.odr.plugincfg.server.MaxConnections

Verwenden Sie diese Eigenschaft, um die maximal zulässige Anzahl offener Verbindungen zu einem Proxy-Server festzulegen, die zu jeder Zeit über einen Web-Server-Prozess aufgebaut sein können.

Diese Eigenschaft ist nur für einen Proxy-Server gültig und gilt für das Element "Server" in der Datei "plugin-cfg.xml", die automatisch vom Proxy-Server generiert wird.

Der Standardwert ist -1 und gibt an, dass es keine maximale Anzahl offener Verbindungen zu einem Proxy-Server gibt, die zu jeder Zeit über einen Web-Server-Prozess aufgebaut sein können.

com.ibm.ws.odr.plugincfg.cluster.WaitForContinue

Verwenden Sie diese Eigenschaft, um festzulegen, ob die Unterstützung von HTTP 1.1 100 Continue verwendet wird, bevor der Anforderungsinhalt an den Proxy-Server gesendet wird.

Gewöhnlich wartet das Plug-in nicht auf die Antwort "100 Continue" des Proxy-Servers, bevor es den Anforderungsinhalt sendet. Sie müssen die Unterstützung für "HTTP 1.1 100 Continue" verwenden, wenn Sie das Plug-in für die Arbeit mit bestimmten Typen von Proxy-Firewalls konfigurieren.

Diese Eigenschaft wird für POST-Anforderungen ignoriert, um Fehler zu verhindern, wenn der Proxy-Server eine Verbindung aufgrund einer Zeitlimitüberschreitung schließt.

Diese Eigenschaft ist nur für einen Proxy-Server gültig und gilt für das Element "Server" in der Datei "plugin-cfg.xml", die automatisch vom Proxy-Server generiert wird.

Der Standardwert ist false.

com.ibm.ws.odr.plugincfg.property.ESIEnable

Verwenden Sie diese Eigenschaft, um den ESI-Prozessor (Edge Side Include) zu aktivieren oder zu inaktivieren. Wenn der ESI-Prozessor inaktiviert ist, werden die anderen ESI-Elemente in der Datei ignoriert.

Diese Eigenschaft ist nur für einen Proxy-Server gültig und gilt für das Element "Property" in der Datei "plugin-cfg.xml", die automatisch vom Proxy-Server generiert wird.

Der Standardwert ist true.

com.ibm.ws.odr.plugincfg.property.ESIMaxCacheSize

Verwenden Sie diese Eigenschaft, um die die maximale Größe des Caches in 1-KB-Einheiten anzugeben. Standardmäßig wird eine maximale Größe von 1024 KB (1 MB) für den Cache verwendet. Wenn der Cache voll ist, wird zuerst der Eintrag gelöscht, der als nächstes verfallen würde.

Diese Eigenschaft ist nur für einen Proxy-Server gültig und gilt für das Element "Property" in der Datei "plugin-cfg.xml", die automatisch vom Proxy-Server generiert wird.

Der Standardwert ist 1024.

com.ibm.ws.odr.plugincfg.property.ESIInvalidationMonitor

Verwenden Sie diese Eigenschaft, um anzugeben, ob der ESI-Prozessor Invalidierungen vom Proxy-Server empfängt.

Diese Eigenschaft ist nur für einen Proxy-Server gültig und gilt für das Element "Property" in der Datei "plugin-cfg.xml", die automatisch vom Proxy-Server generiert wird.

Der Standardwert ist false.

com.ibm.ws.odr.plugincfg.property.https.keyring

Verwenden Sie diese Eigenschaft, um die Verzeichnisposition des SAF-Schlüsselrings anzugeben, wenn HTTPS als Transportprotokoll definiert ist.

Diese Eigenschaft ist nur für einen Proxy-Server gültig und gilt für das Element "Property" in der Datei "plugin-cfg.xml", die automatisch vom Proxy-Server generiert wird.

Der Standardwert ist profileRoot/etc/plugin-key.kdb.

com.ibm.ws.odr.plugincfg.property.https.stashfile

Verwenden Sie diese Eigenschaft, um die Position der verdeckten Datei festzulegen.

Diese Eigenschaft ist nur für einen Proxy-Server gültig und gilt für das Element "Property" in der Datei "plugin-cfg.xml", die automatisch vom Proxy-Server generiert wird.

Der Standardwert ist Profilstammverzeichnis/node/etc/plugin-key.sth .

com.ibm.ws.odr.plugincfg.property.PluginInstallRoot

Verwenden Sie diese Eigenschaft, um den Installationspfad für das Plug-in festzulegen.

Sie müssen diese Eigenschaft auf den vollständig qualifizierten Pfad des Plug-in-Installationsstammverzeichnisses setzen. Wenn Sie den Standardwert verwenden, wird die Eigenschaft nicht in der Datei "plugin-cfg.xml" angezeigt.

Diese Eigenschaft ist nur für einen Proxy-Server gültig und gilt für das Element "Property" in der Datei "plugin-cfg.xml", die automatisch vom Proxy-Server generiert wird.

Der Standardwert ist "".

com.ibm.ws.pm.checkingDBconnection

Verwenden Sie diese Eigenschaft, um anzugeben, ob der Persistenzmanager die Prüfung der Verfügbarkeit einer Datenbank, die als nicht verfügbar markiert wurde, so lange fortsetzen soll, bis wieder eine erfolgreiche Verbindung zu dieser Datenbank hergestellt wurde.

Wenn ein Datenbankservice inaktiv ist, wenn der Persistenzmanager versucht, eine Verbindung zu dieser Datenbank herzustellen, wird die Datenbank als nicht verfügbar markiert. Gewöhnlich wiederholt der Persistenzmanager den Verbindungsversuch nicht, nachdem eine Verbindung zu einer Datenbank als nicht verfügbar markiert wurde. Wenn Sie diese Eigenschaft auf true setzen, setzt der Persistenzmanager die Prüfung der Verfügbarkeit der Datenbank so lange fort, bis eine Verbindung zu dieser Datenbank wieder erfolgreich hergestellt werden kann.

Der Standardwert ist false.

com.ibm.ws.policyset.exportEncodedPasswords

Setzen Sie diese Eigenschaft auf true, damit WS-Security-Richtliniensatzbindungen, die verschlüsselte Kennwörter enthalten, stattdessen mit XOR-verschlüsselten Kennwörtern exportiert werden können.

Die gültigen Werte sind true und false.

Der Standardwert ist false.

com.ibm.ws.recoverylog.disableNonHARegistration

Wenn der Anwendungsserver nicht zu einem Cluster mit aktiviertem Failover der Transaktionsprotokollwiederherstellung gehört, muss der Recovery Log Service nicht beim HA Manager registriert werden.

Wenn der Failover jedoch zu einem späteren Zeitpunkt aktiviert wird und nur ein partieller Neustart des Clusters stattfindet, sollte diese angepasste Eigenschaft auf true gesetzt werden, damit der Recovery Log Service sich nicht beim HA Manager registriert.

Die gültigen Werte sind true und false.

Der Standardwert ist false.

com.ibm.ws.recoverylog.spi.NoMemoryMappedFiles

Verwenden Sie diese Eigenschaft, um eine Leistungsverbesserung für die Speicherzuordnung der Transaktionsprotokolldateien zu erzielen, wenn die Protokolle in einem lokalen Verzeichnis des Anwendungsservers abgelegt sind.

Wenn die Transaktionsprotokolle jedoch in einem fernen Dateisystem definiert sind, was bei aktivierter Hochverfügbarkeit typisch ist, können die erzielten Leistungssteigerungen vernachlässigt werden. Hinzu kommt, dass die Protokollverarbeitung komplexer ist. Aufgrund dieser Komplexität sollten Sie die Zuordnung der Transaktionsprotokolle in einer Hochverfügbarkeitsumgebung inaktivieren.

Wenn Sie die Speicherzuordnungsdateien inaktivieren möchten, setzen Sie die angepasste JVM-Eigenschaft "com.ibm.ws.recoverylog.spi.NoMemoryMappedFiles" in jedem Server, der auf Protokolldateien für die Wiederherstellung zugreift, auf true. Der Standardwert ist false.
Hinweis: Standardmäßig ist die Speicherzuordnung der Transaktionsprotokolle im Betriebssystem z/OS und im Betriebssystem Windows in einer Hochverfügbarkeitsumgebung inaktiviert.

com.ibm.ws.runtime.component.ResourceMgr.postBindNotify

Verwenden Sie diese Eigenschaft, um Verbindungsfactory-MBeans bereitzustellen, wenn ein Ressourcenadapter gestartet wird. Gewöhnlich stehen dem Ressourcenadapter beim Start keine abzufragenden Verbindungsfactory-MBeans zur Verfügung. Bestimmte Ressourcenadapter, wie z. B. der IMS-DB-Ressourcenadapter, erfordern diese Funktion jedoch für die Initialisierung.

Wenn Sie keinen Ressourcenadapter verwenden, der die Verfügbarkeit von Verbindungsfactory-MBeans bei der Initialisierung voraussetzt, fügen Sie diese Eigenschaft Ihren JVM-Einstellungen hinzu, und setzen Sie die Eigenschaft auf den Wert false.

Der Standardwert ist true.

com.ibm.ws.runtime.dumpShutdown

Es gibt verschiedene Situationen, in denen ein Threadspeicherauszug (Dump) beim Herunterfahren des Servers nützlich ist. Nachfolgend sind Beispiele für solche Situationen aufgeführt:
  • Der Server wird heruntergefahren, weil der Node Agent den blockierten Server gestoppt hat.
  • Der Server wird heruntergefahren, wenn System.exit() von einem im Server ausgeführten Anwendungscode aufgerufen wird.
  • Der Server wird sporadisch heruntergefahren.
Mit der angepassten Diagnoseeigenschaft "com.ibm.ws.runtime.dumpShutdown" können Sie festlegen, dass beim Herunterfahren des Servers ein Java-Core-Threadspeicherauszug ausgelöst wird. Setzen Sie diese Eigenschaft auf true, wenn beim Herunterfahren des Servers ein Java-Core-Threadspeicherauszug ausgelöst werden soll. Der Standardwert ist false.

[AIX][Windows][Linux][z/OS]Für Plattformen, auf denen ein IBM Software Development Kit verwendet wird (AIX, Windows, Linux, z/OS), wird der Java-Core-Threadspeicherauszug im Arbeitsverzeichnis des Anwendungsservers generiert.

[Solaris][HP-UX]Für andere Plattformen (Solaris, HP-UX) wird der Java-Core-Threadspeicherauszug in die Datei native_stdout.log für den Anwendungsserver geschrieben.

Zusätzlich zum Java-Core-Threadspeicherauszug wird der Stack-Trace des aktuellen Threads, der das Herunterfahren verarbeitet, in der Datei SystemErr.log für den Anwendungsserver ausgegeben.

[AIX Solaris HP-UX Linux Windows][IBM i]

com.ibm.ws.runtime.logThreadPoolGrowth

Thread-Pools, die für Wachstum konfiguriert sind, haben zwar einen Maximalwert für die Größe, sie dürfen diesen Wert jedoch überschreiten. Es werden jedoch keine Nachrichten ausgegeben, die besagen, dass der Maximalwert überschritten wurde.

Setzen Sie diese Eigenschaft auf true, wenn der Server eine Nachricht an die Protokolldatei senden soll, falls ein Thread-Pool, der für Wachstum konfiguriert ist, den konfigurierten Maximalwert überschreitet.

com.ibm.ws.scripting.apptimeout

Mit dieser Eigenschaft können Sie das Zeitlimit (in Sekunden) für eine Anwendungsinstallation oder Anwendungsaktualisierung festlegen. Der Standardwert ist 86400. Dies entspricht 24 Stunden.

Durch die Festlegung eines angemessenen Werts für diese Eigenschaft kann verhindert werden, dass der Installations- bzw. Aktualisierungsprozess unbegrenzt fortgesetzt wird, wenn eine Situation eintritt, die die Ausführung des Installations- bzw. Aktualisierungsscripts verhindert. Beispiel: Sie haben ein JACL-Script, das eine EAR-Datei aktualisiert, aber nicht ausgeführt werden kann, weil der Deployment Manager, mit dem das Script verbunden ist, gestoppt wird.

com.ibm.ws.sib.webservices.useSOAPJMSTextMessages

Standardmäßig wird eine Web-Service-Nachricht vom Typ "SOAP over JMS" in WebSphere Application Server Version 6 oder höher vom Web-Service-Gateway als JmsBytesMessage gesendet.

Setzen Sie diese Eigenschaft auf true, um das Standardverhalten zu ändern und eine kompatible JmsTextMessage zu senden. Die Definition dieser Eigenschaft ändert das Standardverhalten für alle abgehenden JMS-Web-Service-Aufrufe, die vom Service Integration Bus gesendet werden.

Wenn Sie sich für die Verwendung dieser angepassten Eigenschaft entscheiden, müssen Sie sie als angepasste JVM-Eigenschaft des Anwendungsservers definieren.

com.ibm.ws.soap.handleRST

Verwenden Sie diese Eigenschaft, damit Ihr Web-Server erkennt, wenn eine SOAP-Nachricht gelesen wurde, und das RST-Element (RequestSecurityToken) als FIN-Nachrichtentyp behandelt.

In einigen Situationen wird ein Web-Server, wenn eine Verbindung zurückgesetzt wird, mit inaktivierter Sicherheit gestartet. Weil jedoch RST anstelle des normalen FIN/Dateiendes empfangen wurde, wird in der Administrationskonsole eine Fehlernachricht angezeigt, die angibt, dass der Web-Server-Start fehlgeschlagen ist, obwohl der Web-Server gestartet wurde und betriebsbereit ist. Wird die Web-Server-Konsolenseite aktualisiert, wird der richtige Betriebsstatus angezeigt.

Wenn Sie die angepasste Eigenschaft "com.ibm.ws.soap.handleRST" auf true setzen, erkennt der Web-Server, wenn die vollständige SOAP-Nachricht gelesen wurde, und behandelt RST als FIN. In diesem Fall wird keine Fehlernachricht angezeigt, wenn RST empfangen wird.

com.ibm.ws.use602RequiredAttrCompatibility

Verwenden Sie die angepasste Eigenschaft "com.ibm.ws.use602RequiredAttrCompatibility", um anzugeben, ob das Attribut <required> vor anderen Attributen in der Datei cachespec.xml ausgewertet wird.

Wenn Sie in Version 6.0.2 das Attribut <required> auf "false" setzen, werden alle anderen Attribute in der Datei cachespec.xml ignoriert, und eine Cache-ID wird generiert.

Hinweis zur Umstellung Hinweis zur Umstellung: In den Versionen nach Version 6.0.2 wird das Attribut <required> zusammen mit allen anderen Attributen standardmäßig ausgewertet, um zu bestimmen, ob eine Cache-ID generiert wird. trns
Anmerkung: Wenn Sie die angepasste Eigenschaft "com.ibm.ws.use602RequiredAttrCompatibility" auf "true" setzen, wird das Verhalten der Datei cachespec.xml auf das Verhalten von Version 6.0.2 zurückgesetzt. Das Attribut <required> wird vor anderen Attributen in der Datei cachespec.xml ausgewertet. Der Standardwert ist false.. Wenn Sie diese angepasste JVM-Eigenschaft definieren, die sich nur auf die Anwendungsserverebene bezieht, sind alle Benutzer des dynamischen Cache betroffen.

Wenn Sie sich für die Verwendung dieser angepassten Eigenschaft entscheiden, definieren Sie sie als angepasste JVM-Eigenschaft des Anwendungsservers, sofern im Kontext einer bestimmten Task keine anderen Angaben enthalten sind.

com.ibm.ws.webcontainer.allowDefaultErrorPage

Verwenden Sie diese Eigenschaft, wenn Ihre Datei "web.xml" eine Fehlerseitendefinition gemäß der Servlet 3.0-Spezifikation verwendet. Die Servlet 3.0-Spezifikation legt fest, dass nur der Parameter <location> verbindlich ist. Die Parameter <error-code> und <exception-type> sind optionale Parameter. Wenn Sie diese Eigenschaft Ihren JVM-Einstellungen jedoch nicht hinzufügen und sie auf den Wert true setzen, wird eine Fehlerseite, die lediglich mit dem Parameter <location> definiert ist, ignoriert.

Der Standardwert ist false.

Wenn Sie diese angepasste Eigenschaft verwenden, müssen Sie sie auf Anwendungsserverebene definieren.

com.ibm.ws.webservices.allowNoSOAPActionHeader

Verwenden Sie diese Eigenschaft, um der Web-Service-Engine zu ermöglichen, eine eingehende Web-Service-Anforderung zu tolerieren, die keinen SOAPAction-Header enthält. Diese Eigenschaft muss auf Anwendungsserverebene definiert werden.

Die SOAP-Spezifikation legt fest, dass eine HTTP-Anforderungsnachricht ein SOAPAction-HTTP-Headerfeld mit einem in Anführungszeichen gesetzten leeren Zeichenfolgewert enthalten muss, wenn in der zugehörigen WSDL-Beschreibung der Header soapAction von soapbind:operation nicht vorhanden oder mit einer leeren Zeichenfolge als Wert vorhanden ist. Wenn die Web-Service-Engine keine Anforderungen verarbeiten soll, die keinen Header SOAPACTION enthalten, fügen Sie diese Eigenschaft den Anwendungsservereinstellungen hinzu, und setzen Sie sie auf true.

Wenn diese Eigenschaft nicht definiert oder nicht auf "true" gesetzt ist und eine eingehende SOAP-Anforderungsnachricht keinen Header SOAPAction enthält, wird ein SOAP-Fehler an den Client zurückgegeben.

Der Standardwert ist false.

Wenn Sie sich für die Verwendung dieser angepassten Eigenschaft entscheiden, müssen Sie sie als angepasste JVM-Eigenschaft des Anwendungsservers definieren.

com.ibm.ws.webservices.allowStatusCode202OneWay

Verwenden Sie diese Eigenschaft, um einem unidirektionalen JAX-RPC-Service zu ermöglichen, anstelle eines Statuscodes 200 einen Statuscode 202 zu senden.

Ein unidirektionaler JAX-RPC-Service, der in WebSphere Application Server implementiert ist, gibt gewöhnlich einen HTTP-Statuscode 200 zurück. Einige JAX-RPC-Implementierungen tolerieren den Statuscode 200 nicht und bevorzugen einen Statuscode 202. Gemäß Basic Profile Version 1.1 sind 200 und 202 gültige Statuscodes für unidirektionale Services.

Wenn Sie diese Eigenschaft auf "true" setzen, gibt der unidirektionale JAX-RPC-Service einen Statuscode 202 zurück.

Der Standardwert ist false.

Diese Eigenschaft gilt für die JVM des Anwendungsservers.

Wenn Sie sich für die Verwendung dieser angepassten Eigenschaft entscheiden, müssen Sie sie als angepasste JVM-Eigenschaft des Anwendungsservers definieren.

com.ibm.ws.webservices.appendRootCauseToWSF

Wenn Sie ein JAX-RPC-Benutzer sind, geben Sie mit dieser Eigenschaft an, ob die Fehlerdetails einer Ausnahme, die in einer Antwort zurückgegeben werden, Informationen zur ursprünglichen Ausnahme enthalten sollen.

Normalerweise enthalten die Fehlerdetails einer Ausnahme, die in einer Antwort zurückgegeben werden, nur Informationen zur aktuellsten Ausnahme. Sie enthalten keine Informationen zur ursprünglichen Ausnahme, die normalerweise nicht die aktuellste Ausnahme ist. Häufig löst eine Ausnahme weitere Ausnahmen aus, bevor die Fehlerdetails in einer Antwort zurückgegeben werden. Aus diesem Grund kann die Problembestimmung für den Benutzer schwierig sein, wenn dieser nicht gleichzeitig Zugriff auf die Protokolle des Service-Providers hat.

Wenn der Benutzer die Ausnahmebedingungsdetails für alle Ausnahmen sehen muss, die zu demselben Problem gehören, sollten Sie diese Eigenschaft für die JVM im Anwendungsserver des Service-Providers auf den Wert true setzen. Wenn Sie diese angepasste Eigenschaft im Anwendungsserver des Service-Providers auf "true" setzen, durchläuft der Anwendungsserver alle Ursachen der Ausnahmen und verknüpft die Details jeder Ausnahme zu den Fehlerdetails, die schließlich in der Antwort zurückgegeben werden.

Der Standardwert ist false.

Wenn Sie diese angepasste Eigenschaft verwenden möchten, müssen Sie sie als angepasste JVM-Eigenschaft für einen Anwendungsserver angeben.

[z/OS]

com.ibm.ws.webservices.cacheEngineList

Verwenden Sie diese Eigenschaft in Konfigurationen von WebSphere Application Server for z/OS, in denen JAX-RPC-Web-Services verwendet werden, um das Caching durch die Client-Web-Service-Engine zu inaktivieren.

Wird eine Anwendung mehrere Male gestartet, kann der Client-Engine-Cache den lokalen Systemspeicher füllen und einen Fehler aufgrund abnormaler Speicherbedingungen verursachen. Wenn Sie diese Eigenschaft auf true setzen, wird das Caching durch die Engine aktiviert. Setzen Sie diese Eigenschaft auf false, um das Caching durch die Engine zu inaktivieren, wenn ein Fehler aufgrund abnormaler Speicherbedingungen auftritt.

Der Standardwert ist true.

com.ibm.ws.webservices.contentTransferEncoding

Verwenden Sie diese Eigenschaft, um einen Bereich von Bits anzugeben, für den die XML-Codierung inaktiviert werden soll. Gewöhnlich werden alle ganzen Zahlen größer als 127 XML-codiert. Die Definition dieser Eigenschaft hat folgende Auswirkungen:
  • Die Web-Services inaktivieren die Codierung für alle ganzen Zahlen im angegebenen Bereich.
  • Die HTTP-Transportnachricht enthält einen ContentTransferEncoding-Header, der den Wert hat, der für diese angepasste Eigenschaft festgelegt wurde.

Geben Sie 7bit an, wenn nur ganze Zahlen größer als 127 codiert werden sollen. Geben Sie 8bit an, wenn nur ganze Zahlen größer als 255 codiert werden sollen. Geben Sie binary an, wenn die Codierung für alle ganzen Zahlen inaktiviert werden soll.

Der Standardwert ist 7bit.

Wenn Sie sich für die Verwendung dieser angepassten Eigenschaft entscheiden, müssen Sie sie als angepasste JVM-Eigenschaft des Anwendungsservers definieren.

com.ibm.ws.webservices.disableSOAPElementLazyParse

Verwenden Sie diese Eigenschaft, um die verzögerte Syntaxanalyse von SOAPElements zu inaktivieren. Die verzögerte Syntaxanalyse ist für Situationen bestimmt, in denen der Client das SOAPElement nicht syntaktisch analysiert. Wenn ein Client das SOAPElement mit SAAJ syntaktisch analysiert, empfiehlt es sich, die Syntaxanalyse durch die Web-Service-Komponente nicht zu verzögern.

Sie können diese Eigenschaft als angepasste JVM-Eigenschaft auf Server- oder Clientebene festlegen. Wenn Sie diese Eigenschaft auf Server- oder Clientebene festlegen, gilt diese Einstellung für alle Anwendungen in der JVM. Der Standardwert ist false.

Sie können auch ein Anwendungsassembliertool verwenden, um diese Eigenschaft als neuen Bindungseintrag für die Web-Service-Beschreibung der Portkomponentenbindung festzulegen, wenn Sie die verzögerte Syntaxanalyse von SOAPElements auf Anwendungsbasis für einen bestimmten Server und nicht für alle Server, die vom Deployment Manager verwaltet werden, inaktivieren möchten.

Wenn Sie sich für die Verwendung dieser angepassten Eigenschaft entscheiden, müssen Sie sie als angepasste JVM-Eigenschaft des Anwendungsservers definieren.

com.ibm.ws.webservices.engine.transport.jms.propagateOneWaySystemExceptions

Mit dieser Eigenschaft können Sie festlegen, dass Ausnahmen, die während der Verarbeitung eines bidirektionalen JMS-Web-Service eintreten, an den EJB-Container zurückgegeben werden sollen. Diese Weitergabe macht eine normale Fehlerbehebung möglich.

Wenn Sie diese Eigenschaft auf false setzen, wird eine Ausnahme in eine WebServicesFault-Nachricht eingeschlossen und an den Client zurückgesendet. Da der Web-Service keine Kenntnis von der Ausnahme hat, wird keine Fehlerbehebung versucht.

Der Standardwert ist false.

Fehler vermeiden Fehler vermeiden: Diese Eigenschaft gilt nicht für unidirektionale HTTP-Web-Services und bidirektionale JMS-Anforderungen.gotcha

Wenn Sie sich für die Verwendung dieser angepassten Eigenschaft entscheiden, müssen Sie sie als angepasste JVM-Eigenschaft des Anwendungsservers definieren.

com.ibm.ws.webservices.forceLegacyDispatchFromSOAPConnection

Verwenden Sie diese Eigenschaft, um festzulegen, dass anstelle der JAX-WS-Engine die JAX-RPC-Engine zur Verarbeitung abgehender Anforderungen für SAAJ-Clients (SOAP with Attachments API for Java) verwendet werden soll.

Diese Eigenschaft ist nicht gültig für Clients, die Web-Services über JAX-RPC- oder JAX-WS-APIs aufrufen. Wenn die JAX-WS-Engine zum Verarbeiten von Clientanforderungen verwendet wird, kann dies ein anderes Ergebnis zur Folge haben als die Verwendung der JAX-RPC-Engine. Beispielsweise legen einige SAAJ-Clients den SOAPAction-Header mit den SAAJ-APIs als MIME-Header fest. Wenn die JAX-WS-Engine zum Verarbeiten einer solchen Anforderung verwendet wird, wird dieser SOAPAction-Header mit seinem benutzerdefinierten Wert in der Anforderung gesendet. Wenn dieselbe Anforderung jedoch von der JAX-WS-Engine verarbeitet wird, wird ein leerer SOAPAction-Header in der Anforderung gesendet. Wenn Sie normalerweise die JAX-RPC-Engine für die Verarbeitung von SAAJ-Clientanforderungen verwenden und diese Vorgehensweise beibehalten möchten, nehmen Sie diese Eigenschaft in Ihre JVM-Einstellungen auf und setzen Sie sie auf den Wert true.

Der Standardwert ist false.

Wenn Sie sich für die Verwendung dieser angepassten Eigenschaft entscheiden, müssen Sie sie als angepasste JVM-Eigenschaft des Anwendungsservers definieren.

com.ibm.ws.webservices.HttpRedirectWithProxy

Geben Sie für diese Eigenschaft den Wert true an, wenn es zulässig ist, dass HTTP-Umleitungsanforderungen über den Proxy-Server gesendet werden. Wenn Sie diese Eigenschaft auf "true" setzen, ändern sie das Standardverhalten für alle von der JAX-RPC-Laufzeit gesendeten abgehenden HTTP-Umleitungsanforderungen. Wird diese Eigenschaft auf den Wert false gesetzt, wird eine Umleitungsanforderung direkt an einen fernen Server gesendet, obwohl ein Proxy-Server konfiguriert ist.

Der Standardwert ist false.

Wenn Sie diese angepasste Eigenschaft verwenden möchten, müssen Sie sie als angepasste JVM-Eigenschaft für einen Proxy-Server angeben.

com.ibm.ws.webservices.ignoreUnknownElements

Mit dieser Eigenschaft können Sie steuern, ob Clients zusätzliche XML-Elemente ignorieren können, die manchmal in Antworten auf SOAP-Operationen des Typs "literal" zu finden sind.

Wenn Sie diese Eigenschaft auf true setzen, können Sie Ihren Server-Code flexibel aktualisieren und weitere Antwortinformationen hinzufügen, ohne den Client-Code sofort aktualisieren zu müssen, um diese zusätzlichen Informationen zu verarbeiten. Falls diese Funktion aktiviert ist, wird die Überprüfung der SOAP-Nachricht im Hinblick auf die erwartete Nachrichtenstruktur jedoch lockerer durchgeführt, wenn diese Eigenschaft auf false gesetzt ist.

Wenn Sie sich für die Verwendung dieser angepassten Eigenschaft entscheiden, müssen Sie sie als angepasste JVM-Eigenschaft des Anwendungsservers definieren.

com.ibm.ws.webservices.jaxrpc.parse.tolerate.invalid.namespace

Mit dieser Eigenschaft können Sie festlegen, dass die JAX-RPC-Engine einen toleranteren Algorithmus verwendet, um zu bestimmen, ob eine eingehende JAX-RPC-Nachricht empfangen werden soll.

Wenn eine eingehende JAX-RPC-Nachricht im Normalfall einen ungültigen Namespace für ein Body-Element verwendet, weist die JAX-RPC-Engine die Nachricht zurück. Wenn Sie diese Eigenschaft auf true setzen, verwendet die JAX-RPC-Engine einen toleranteren Algorithmus, der die Abweichung beim Namespace ignoriert.

Der Standardwert ist false.

Wenn Sie sich für die Verwendung dieser angepassten Eigenschaft entscheiden, müssen Sie sie als angepasste JVM-Eigenschaft des Anwendungsservers definieren.

com.ibm.ws.webservices.resolveXMLSchemaDTD

Verwenden Sie diese angepasste Eigenschaft, um den Start einer JAX-RPC-Anwendung auch zu ermöglichen, wenn die Schema- oder WSDL-Datei, die in der Klasse "_AbsoluteImportResolver" dargestellt wird, auch auf die DTD-Datei "http://www.w3.org/2001/XMLSchema.dtd" verweist.

Wenn Sie auf einem Host arbeiten, der nicht mit dem Internet verbunden ist, werden JAX-RPC-Anwendungen, die mit der Klasse "_AbsoluteImportResolver" gepackt sind, möglicherweise nicht ordnungsgemäß gestartet. Der folgende Fehler kann in den Protokolldateien ausgegeben werden:
WSDDPort      W com.ibm.ws.webservices.engine.deployment.wsdd.WSDDPort expand 
WSWS3114E: Fehler: Interner Fehler.
java.net.UnknownHostException: www.w3.org

Wenn Sie diese Eigenschaft auf true setzen, kann eine JAX-RPC-Anwendung auch ordnungsgemäß gestartet werden, wenn die Schema- oder WSDL-Datei, die in der Klasse "_AbsoluteImportResolver" dargestellt wird, auch auf die DTD-Datei "http://www.w3.org/2001/XMLSchema.dtd" verweist.

Der Standardwert ist false.

Wenn Sie sich für die Verwendung dieser angepassten Eigenschaft entscheiden, müssen Sie sie als angepasste JVM-Eigenschaft des Anwendungsservers definieren.

com.ibm.ws.webservices.searchForAppServer

Mit dieser Eigenschaft können Sie steuern, ob die Nachricht DualMetaDataLoaderImpl E loadWebContainerPorts could not find any http or https ports in das Systemprotokoll gestellt wird.

Wenn eine Web-Service-Anwendung in einem Web-Server und einem Anwendungsserver installiert wird, kann Ihr System je nach Systemkonfiguration die Nachricht ausgeben, dass ein Fehler aufgetreten ist, obwohl eine gültige Konfiguration vorliegt. Wenn Sie also Web-Service-Anwendungen in einem Web-Server und einem Anwendungsserver installieren, möchten Sie vielleicht nicht, dass diese Nachrichten in das Systemprotokoll gestellt werden.

Wenn Sie die Eigenschaft "com.ibm.ws.webservices.searchForAppServer" auf true setzen, werden alle ausgegebenen Nachrichten mit dem Inhalt DualMetaDataLoaderImpl E loadWebContainerPorts could not find any http or https ports nicht an das Systemprotokoll gesendet. Wenn diese Eigenschaft nicht definiert oder auf false gesetzt ist, werden diese Nachrichten an das Systemprotokoll gesendet.

Der Standardwert ist false.

Wenn Sie sich für die Verwendung dieser angepassten Eigenschaft entscheiden, müssen Sie sie als angepasste JVM-Eigenschaft des Anwendungsservers definieren.

com.ibm.ws.webservices.serialize.2DimArray.asArrays

Verwenden Sie diese Eigenschaft, um die JAX-RPC-Laufzeitumgebung anzuweisen, zweidimensionale XML-Arrays als Folge von Arrays zu serialisieren.

Wenn Sie sich für die Verwendung dieser angepassten Eigenschaft entscheiden, müssen Sie sie als angepasste JVM-Eigenschaft des Anwendungsservers definieren.

Der Standardwert ist false.

Der folgende Nachrichtenausschnitt veranschaulicht eine Reihe von Elemente, was ein gültiges Format für die Darstellung zweidimensionaler XML-Arrays ist, wenn diese Eigenschaft auf false gesetzt ist.

<p565:sayHelloResponse xmlns:p565="http://ibm.com">
    <sayHelloReturn xsi:type="soapenc:Array" 
soapenc:arrayType="xsd:string[2,3]">
      <item xsi:type="xsd:string">array1 element1</item>
      <item xsi:type="xsd:string">array1 element2</item>
      <item xsi:type="xsd:string">array1 element3</item>
      <item xsi:type="xsd:string">array2 element1</item>
      <item xsi:type="xsd:string">array2 element2</item>
      <item xsi:type="xsd:string">array2 element3</item>
    </sayHelloReturn>
  </p565:sayHelloResponse>

Der folgende Nachrichtenausschnitt veranschaulicht ein Array von zwei Arrays, wobei jedes Array drei Elemente enthält, was ein gültiges Format für die Darstellung zweidimensionaler XML-Arrays ist, wenn diese Eigenschaft auf true gesetzt ist.

<p565:sayHelloResponse xmlns:p565="http://ibm.com">
    <sayHelloReturn xsi:type="soapenc:Array" 
soapenc:arrayType="xsd:string[][2]">
      <item soapenc:arrayType="xsd:string[3]">
         <item>array1 element1</item>
         <item>array1 element2</item>
         <item>array1 element3</item>
      </item>
      <item soapenc:arrayType="xsd:string[3]">
         <item>array2 element1</item>
         <item>array2 element2</item>
         <item>array2 element3</item>
      </item>
    </sayHelloReturn>
  </p565:sayHelloResponse>

com.ibm.ws.webservices.serializeDetailElementUsingDefaultNamespace

Verwenden Sie diese Eigenschaft, um anzugeben, ob der Anwendungsserver einen tatsächlichen Präfixnamen verwenden soll, um den Namespace zur Definition des Fehlerdetails zu lokalisieren, oder ob er einen Standard-Namespace zur Definition des Fehlerdetails verwenden soll.

Wenn ein JAX-RPC-Web-Service mit einem SOAP-Fehler reagiert, wird normalerweise ein Präfixname verwendet soll, um den Namespace zu lokalisieren, der den Inhalt des Fehlerdetails definiert. Das folgende Beispiel zeigt eine Nachricht, die der Anwendungsserver in einer solchen Situation normalerweise absetzt:

<soapenv:Fault                                      
      xmlns:soapenv=
      "http://schemas.xmlsoap.org/soap/envelope/">      
  <faultcode xmlns="http://sample">       
     sampleFault                          
  </faultcode>                                              
  <faultstring>sample text</faultstring>                      
  <detail encodingStyle="">                                
    <sampleFault                        
      xmlns="http://sample"> 
      ...
    </sampleFault>
  </detail>
<soapenv:Fault>   

Wenn Ihr Anwendungsserver mit .Net-Clients kommunizieren muss und diese .Net-Clients die Verwendung eines Standard-Namespace voraussetzen, um den Inhalt des Fehlerdetails zu definieren, setzen Sie diese Eigenschaft auf true. Wenn diese Eigenschaft auf true gesetzt ist, gleicht die Nachricht, die der Anwendungsserver absetzt, der Nachricht, die von einem Anwendungsserver einer früheren Version als Version 6.x gesendet wurde.

Der Standardwert ist false.

Wenn Sie sich für die Verwendung dieser angepassten Eigenschaft entscheiden, müssen Sie sie als angepasste JVM-Eigenschaft des Anwendungsservers definieren.

com.ibm.ws.webservices.suppressHTTPRequestPortSuffix

Mit dieser Eigenschaft können Sie steuern, ob eine Portnummer in einer HTTP-POST-Anforderung, die eine SOAP-Nachricht sendet, verbleiben kann.

Einige Web-Service-Implementierungen unterstützen die Existenz einer Portnummer in HTTP-POST-Anforderungen, die die SOAP-Nachricht senden, nicht ordnungsgemäß. Wenn Sie einen Web-Service-Client haben, der mit einem Web-Service interagieren muss, der eine Portnummer in einer HTTP-POST-Anforderung, die eine SOAP-Nachricht sendet, nicht toleriert, setzen Sie diese angepasste Eigenschaft auf true.

Wenn Sie diese Eigenschaft auf true setzen, wird die Portnummer vor dem Versenden der Nachricht aus der HTTP-POST-Anforderung entfernt.

Fehler vermeiden Fehler vermeiden: Sie müssen den Server erneut starten, damit diese Konfigurationseinstellung wirksam wird.gotcha

Der Standardwert ist false.

Wenn Sie sich für die Verwendung dieser angepassten Eigenschaft entscheiden, müssen Sie sie als angepasste JVM-Eigenschaft des Anwendungsservers definieren.

com.ibm.ws.websvcs.attachments.sizethreshold

Verwenden Sie diese Eigenschaft, um die maximale Größe (in Byte) eines Anhangs im JAX-WS-Client oder -Service anzugeben, der in den Speicher geschrieben werden kann. Standardmäßig beträgt die maximale Anhangsgröße 11 MB. Wenn diese Wert definiert ist und ein Anhang die Größe von 11 MB überschreitet, wird der Anhang im Dateisystem zwischengespeichert und nicht in den Hauptspeicher geschrieben. Wenn Sie diese angepasste Eigenschaft zum Erhöhen der maximalen Cachegröße verwenden, hat dies größere Auswirkungen auf die Leistung und potenziell auf den Java-Heapspeicher.

Anmerkung: Informationen zum Festlegen der maximalen Größe eines Anhangs im JAX-RPC-Client bzw. -Service finden Sie in der Beschreibung der angepassten Eigenschaft "com.ibm.websphere.webservices.attachements.maxMemCacheSize".

Wenn Sie sich für die Verwendung dieser angepassten Eigenschaft entscheiden, müssen Sie sie als angepasste JVM-Eigenschaft des Anwendungsservers definieren.

com.ibm.ws.websvcs.getJAXBContext.cacheClassList

Verwenden Sie diese Eigenschaft, um eine Liste der in einem Paket enthaltenen JAXB-Klassen zwischenzuspeichern (JAXB = Java Architecture for XML Binding).

Wenn ein JAXBContext erstellt wird und ein Paket weder eine "ObjectFactory"- noch eine "package-info"-Klassendatei enthält, wird das Paket normalerweise nach allen potenziellen JAXB-Klassen durchsucht. Dieser Suchvorgang kann zeitaufwändig sein und kann durch Sperren der JAR-Datei verzögert werden. Wenn Sie diese Eigenschaft auf true setzen, wird die Klassenliste für jedes Paket zwischengespeichert, sodass keine nachfolgenden Suchvorgänge für dasselbe Paket erforderlich sind. Spätere Anforderungen zum Erstellen des JAXBContext rufen die zwischengespeicherte Version der Klassenliste ab, anstatt eine neue Suche zu starten.

Weil der Cache für die Klassenliste mit einer SoftReference erstellt wird, kann er freigegeben werden, wenn zu wenig Speicher verfügbar ist.

Der Standardwert ist false.

Wenn Sie sich für die Verwendung dieser angepassten Eigenschaft entscheiden, müssen Sie sie als angepasste JVM-Eigenschaft des Anwendungsservers definieren.

com.ibm.ws.websvcs.getJAXBContext.cacheClassList.persist

Verwenden Sie diese Eigenschaft, um einen Plattencache der in einem Paket enthaltenen JAXB-Klassen (Java Architecture for XML Binding) zu erstellen.

Wenn ein JAXBContext erstellt wird und ein Paket weder eine "ObjectFactory"- noch eine "package-info"-Klassendatei enthält, wird das Paket normalerweise nach allen potenziellen JAXB-Klassen durchsucht. Dieser Suchvorgang kann zeitaufwändig sein und kann durch Sperren der JAR-Datei verzögert werden. Wenn Sie diese Eigenschaft auf true setzen, wird ein Plattencache der Klassenliste für jedes Paket erstellt, sodass keine nachfolgenden Suchvorgänge für dasselbe Paket erforderlich sind. Spätere Anforderungen zum Erstellen des JAXBContext rufen die zwischengespeicherte Version der Klassenliste ab, anstatt eine neue Suche zu starten.

Der Standardwert ist false.

Wenn Sie sich für die Verwendung dieser angepassten Eigenschaft entscheiden, müssen Sie sie als angepasste JVM-Eigenschaft des Anwendungsservers definieren.

com.ibm.ws.websvcs.logOperationExceptionAsDebug

SOAP-Fehlerausnahmen werden immer mit log.error geschrieben, das wiederum in SystemOut.log und in Trace.log schreibt. Verwenden Sie diese Eigenschaft, um sicherzustellen, dass SOAP-Fehlerausnahmen NUR in Trace.log protokolliert werden, wenn die Traceerstellung aktiviert ist, und NICHT in SystemOut.log. Die Eigenschaft unterscheidet nicht den Typ der SOAP-Fehlerausnahmen, die in SystemOut.log protokolliert werden.

Anmerkung: SOAP-Fehlerausnahmen werden nur dann in Trace.log protokolliert, wenn die Web-Service-Traces aktiviert und die Eigenschaft "com.ibm.ws.websvcs.logOperationExceptionAsDebug=true" gesetzt ist.

Wenn Sie sich für die Verwendung dieser angepassten Eigenschaft entscheiden, müssen Sie sie als angepasste JVM-Eigenschaft des Anwendungsservers definieren.

com.ibm.ws.websvcs.suppressHTTPRequestPortSuffix

Verwenden Sie diese Systemeigenschaft, um zu verhindern, dass die JAX-WS-Laufzeitumgebung die Portnummer an den HTTP-Host-Header-Wert für eine Anforderung anhängt.

Ein JAX-WS-Client kann eine Ausnahme des Typs "java.io.IOException" als Antwort auf eine Anforderung empfangen, insbesondere dann, wenn sich ein anderer Web-Server als ein IBM Web-Server zwischen dem Client und dem Web-Service befindet, den der Client aufzurufen versucht. Dieser zwischengeschaltete Server weiß möglicherweise nicht, wohin die Anforderung weiterzuleiten ist, weil die JAX-WS-Laufzeitumgebung die Portnummer an den HTTP-Host-Header-Wert angehängt hat. Die JAX-WS-Laufzeitumgebung hat den Headerwert möglicherweise vom Endpunkt-URL "lilygirl.austin.mycompany.com" in den URL "lilygirl.austin.mycompany.com:80" geändert, der die Portnummer enthält.

Um zu verhindern, dass die JAX-WS-Laufzeitumgebung die Portnummer an den HTTP-Host-Header-Wert anhängt, fügen Sie diese angepasste Eigenschaft Ihren JVM-Einstellungen hinzu, und setzen Sie sie auf true. Wenn diese Eigenschaft auf true gesetzt ist, enthält der Host-Header nur den Hostnamen des Endpunkt-URL, z. B. Host: lilygirl.austin.mycompany.com.

Der Standardwert für diese Eigenschaft ist false, d. h., die Portnummer wird an einen Host-Header-Wert angehängt.

Wenn Sie sich für die Verwendung dieser angepassten Eigenschaft entscheiden, müssen Sie sie als angepasste JVM-Eigenschaft des Anwendungsservers definieren.

com.ibm.ws.websvcs.transport.enableProxyTunnel

Setzen Sie diese Eigenschaft auf true, damit der Web-Service-Client über einen Web-Proxy-Server auf Ressourcen zugreifen kann. Die Standardeinstellung für diese Eigenschaft ist false, d. h., die Tunnelung wird in der Web-Service-Transportschicht für Proxy-Server nicht verwendet.
Beispiel: Wenn Sie die Standardeinstellung false übernehmen, tritt bei einem JAX-WS-Web-Service-Client, der versucht, einen fernen Web-Service über HTTPS aufzurufen, eine Ausnahme auf, wenn der Aufruf über einen HTTP-Server weitergeleitet wird, der als Forward Proxy konfiguriert ist.

Der Standardwert ist false.

Wenn Sie diese angepasste Eigenschaft verwenden möchten, müssen Sie sie als angepasste JVM-Eigenschaft für einen Proxy-Server angeben.

com.ibm.ws.websvcs.relaxClientPolsetMatching

Verwenden Sie diese Eigenschaft, damit Richtliniensätze auf der JAX-WS-Clientseite über die Administrationskonsole auf der Serviceebene oder auf einer niedrigeren Ebene angewendet werden können, wenn sich der Client-Code über mehrere Archivdateien erstreckt.

Der Standardwert ist false.

com.ibm.ws.websvcs.transport.jms.enableBasicAuthOnResponse

Verwenden Sie diese Eigenschaft, um anzugeben, ob die Benutzer-ID und das Kennwort für die Basisauthentifizierung des JMS-Richtliniensatzes auf JMS-Ressourcennachrichten angewendet werden sollen. Standardmäßig werden die Benutzer-ID und das Kennwort für die Basisauthentifizierung des JMS-Richtliniensatzes nicht auf JMS-Ressourcennachrichten angewendet.

Wenn Sie diese Eigenschaft Ihren JVM-Einstellungen hinzufügen und auf den Wert true setzen, werden die Benutzer-ID und das Kennwort für die Basisauthentifizierung des JMS-Richtliniensatzes auf JMS-Ressourcennachrichten angewendet. Wird diese Eigenschaft auf false gesetzt, werden weder die Benutzer-ID noch das Kennwort angewendet.

Der Standardwert ist false.

Wenn Sie sich für die Verwendung dieser angepassten Eigenschaft entscheiden, müssen Sie sie als angepasste JVM-Eigenschaft des Anwendungsservers definieren.

com.ibm.ws.websvcs.unifyServiceMessage

Setzen Sie diese Eigenschaft auf true, damit die JAX-WS-Anwendungen bei Eingabe eines Service-URL in einem Browser die JAX-RPC-Nachricht "Hi there, this is a Web service!" ("Dies ist ein Web-Service!") in einem Browserfenster anzeigen anstatt die JAX-WS-spezifische Nachricht "Hello! This is an Axis2 Web Service!".

Der Standardwert ist false.

com.ibm.ws.websvcs.unmanaged.client.dontUseOverriddenEndpointUri

Sie können eine Anforderung von einem nicht verwalteten JAX-WS-Client-Service an den Endpunkt-URL senden, der im Feld Überschriebener Endpunkt-URL angegeben ist. Der Wert dieses verwalteten Felds, der im Rahmen der Konfiguration des Web-Service-Clientports definiert wird, überschreibt den in der WSDL-Datei angegebenen Endpunkt. Weitere Informationen zu diesem Feld finden Sie in der Beschreibung von Web-Service-Clientports.

Fehler vermeiden Fehler vermeiden: Wenn Sie entweder nur verwaltete Clients oder eine Mischung aus verwalteten und nicht verwalteten Clients haben, können Sie das Feld Überschriebener Endpunkt-URL in der Administrationskonsole editieren. Wenn Sie keine verwalteten Clients haben, können Sie das Feld nicht editieren. gotcha

Im Normalfall ist es nicht wünschenswert, dass ein nicht verwalteter JAX-WS-Client-Service auf diese verwaltete Client-Service-Funktion zugreift. Möglicherweise benötigen Sie nicht verwaltete JAX-WS-Client-Services für den Zugriff auf diesen URL. Standardmäßig ist die angepasste Eigenschaft "com.ibm.ws.websvcs.unmanaged.client.dontUseOverriddenEndpointUri" auf "false" gesetzt, um nicht verwalteten JAX-WS-Client-Services den Zugriff auf den Endpunkt-URL, der den Endpunkt in der WSDL-Datei überschreibt, zu gestatten.

Diese angepasste Eigenschaft wird auf der Anwendungsserverebene definiert, auf der ein JAX-WS-Client installiert oder ein Java EE-Client vorhanden ist, falls Sie den launchClient ausführen.

Wenn Sie sich für die Verwendung dieser angepassten Eigenschaft entscheiden, müssen Sie sie als angepasste JVM-Eigenschaft des Anwendungsservers definieren.

com.ibm.ws.ws.wsba.protocolmessages.twoway

Verwenden Sie diese Eigenschaft, um die Leistung eines Anwendungsservers zu verbessern, der Anforderungen für Web Services Business Activities (WS-BA) verarbeitet. Wenn Sie diese angepasste Eigenschaft auf "true" setzen, verbessert sich die Leistung des Anwendungsservers, wenn WS-BA-Protokollnachrichten zwischen zwei Anwendungsservern ausgetauscht werden. Der Standardwert ist true.

Fehler vermeiden Fehler vermeiden: Wenn Sie sich für die Verwendung dieser angepassten Eigenschaft entscheiden, müssen Sie sie in dem Anwendungsserver definieren, der die Anforderungen einleitet. In dem Anwendungsserver, der die Anforderungen empfängt, muss die Eigenschaft nicht definiert werden.

Wenn Sie sich für die Verwendung dieser angepassten Eigenschaft entscheiden, müssen Sie sie als angepasste JVM-Eigenschaft des Anwendungsservers definieren.

gotcha
[z/OS]

com.ibm.ws390.SystemOutErrCodepage

Verwenden Sie diese angepasste Eigenschaft, um für Nachrichten, die über System.out und System.err mit den Methoden println, print und write ausgegeben wurden, ein anderes Codierungsschema als EBCDIC festzulegen. Wird kein Codierungsschema festgelegt, wird für diese Nachrichten das Standardcodierungsschema EBCDIC verwendet.

Der Wer für diese Eigenschaft muss im Zeichenfolgeformat angegeben werden.

Wenn Sie diese angepasste Eigenschaft verwenden möchten, müssen Sie sie als angepasste JVM-Eigenschaft für den Servant angeben.

com.ibm.wsspi.amm.merge.ignoreValidationExceptions

Mit dieser angepasste Eigenschaft können Sie für die JVM festlegen, dass sie Ausnahmen bei der Validierung, die während der EJB-Verarbeitung auftreten können, ignorieren soll. Wenn eine Anwendung so konfiguriert ist, dass erforderliche Klassen in gemeinsam genutzten Bibliotheken angegeben sind, werden während der EJB-Verarbeitung möglicherweise unvollständige Daten generiert. Daher kann bei der Validierung eine Ausnahme auftreten und folgende Ausnahmenachricht kann angezeigt werden:
AnnotativeMetadataManagerImpl merge caught exception while merging com.ibm.wsspi.amm.validate.ValidationException:
the interface com.xyz.app.myappRemote does not define a
valid remote business interface; the method mygetMethod does not
conform to RMI rules.

Wenn die JVM diese Validierungsausnahmen ignorieren soll, setzen Sie diese Eigenschaft auf den Wert true.

Der Standardwert ist false.

Wenn Sie diese angepasste Eigenschaft verwenden möchten, müssen Sie sie als angepasste JVM-Eigenschaft für den Anwendungsserver angeben.

com.ibm.wsspi.wssecurity.dsig.enableEnvelopedSignatureProperty

Verwenden Sie diese angepasste Eigenschaft, um der JVM mitzuteilen, dass die WS-Security-Laufzeit eine digitale XML-Signatur genau so prüfen soll wie in Version 7.0.0.21 und früheren Versionen und in Version 8.0.0.3 und früheren Versionen.

Fehler vermeiden Fehler vermeiden: Diese Eigenschaft sollte nur dann auf true gesetzt werden, wenn in Ihrer Umgebung eine Zelle vorkommt, die Anwendungsserver mit verschiedenen Fixpackstufen enthält, und wenn Kompatibilitätsprobleme auftreten.gotcha
In Version 7.0.0.21 und früheren Versionen sowie in Version 8.0.0.3 und früheren Versionen wird eine Fehlernachricht des Typs Digest value mismatch (Abweichung bei Digest-Wert) ähnlich der folgenden angezeigt, wenn WS-Security eine digitale XML-Signatur prüft, die den Umsetzungsalgorithmus http://www.w3.org/2000/09/xmldsig#enveloped-signature verwendet und das signierte Element über Attribute mit einem Namespacepräfix verfügt:
SAML Assertion signature is verified.Core validity=false
Signed info validity=true Signed info
message='null'(validity=false message='Digest value mismatch:
calculated: KCuNwlUAk5+G2PYb8fZ+Y1hTMtw='
uri='#Assertion-1234' type='null')

Wenn ein Element, das signiert werden soll, ein Attribut mit einem Namespacepräfix enthält, kanonisiert die WS-Security-Laufzeit das Element, bevor sie den Digest-Wert berechnet.

In dieser Version des Produkts, in den Versionen ab 7.0.0.23 und in den Versionen ab 8.0.0.4 werden Elementattribute mit Namespacepräfixen von der WS-Security-Laufzeit ordnungsgemäß behandelt.

Fehler vermeiden Fehler vermeiden:
  • Wenn Sie diese Eigenschaft auf true setzen, müssen Sie auch die folgende angepasste WS-Security-Eigenschaft als angepasste Eigenschaft für eingehende Nachrichten, für abgehende Nachrichten oder für eingehende und abgehende Nachrichten in den WS-Security-Richtliniensatzbindungen festlegen:
    com.ibm.wsspi.wssecurity.dsig.oldEnvelopedSignature=true
  • Wenn Sie diese Eigenschaft auf true setzen und die SAMLTokenFactory verwenden, um ein SAML-Token zu erstellen, fügen Sie der Datei SAMLIssuerConfig.properties die folgende Eigenschaft hinzu:
    com.ibm.wsspi.wssecurity.dsig.oldEnvelopedSignature=true
gotcha

Wenn Sie diese angepasste Eigenschaft verwenden möchten, müssen Sie sie als angepasste JVM-Eigenschaft für den Anwendungsserver angeben.

com.ibm.xml.xlxp.jaxb.opti.level

Verwenden Sie die angepasste Eigenschaft "com.ibm.xml.xlxp.jaxb.opti.level", um zu bestimmen, ob Optimierungsmethoden für JAXB-Unmarshaling (Entserialisierung) und JAXB-Marshaling (Serialisierung) aktiviert sind. In der folgenden Tabelle sind die unterstützten Werte für diese angepasste Eigenschaft und ihre Auswirkungen auf Anwendungen und Web-Services aufgeführt.
Tabelle 2. Unterstützte Werte für die angepasste Eigenschaft. Die Tabelle gibt die angepassten Eigenschaftswerte an und beschreibt ihre Auswirkungen auf die angepassten Eigenschaften in Anwendungen und Web-Services.
Wert der angepassten Eigenschaft Auswirkung
com.ibm.xml.xlxp.jaxb.opti.level=0 Optimierungsmethoden sind nicht aktiviert.
com.ibm.xml.xlxp.jaxb.opti.level=1 Es sind nur Optimierungsmethoden für das Unmarshaling aktiviert.
com.ibm.xml.xlxp.jaxb.opti.level=2 Es sind nur Optimierungsmethoden für das Marshaling aktiviert.
com.ibm.xml.xlxp.jaxb.opti.level=3 Es sind Optimierungsmethoden für das Unmarshaling und das Marshaling und aktiviert (Standardeinstellung).

Setzen Sie die angepasste Eigenschaft auf 3, um eine optimale Leistung zu erzielen. Dieser Wert erhöht den Durchsatz für Web-Services und Anwendungen, die JAXB direkt nutzen. Wenn nach dem Setzen dieses Werts Optimierungsprobleme auftreten, ändern Sie den Wert in 0, um den Fehler temporär zu umgehen.

Diese angepasste Eigenschaft wird nur auf der Anwendungsserverebene definiert.

com.ibm.xml.xlxp2.api.util.encoding.DataSourceFactory.bufferLength

Wenn Sie diese angepasste JVM-Eigenschaft auf einen kleineren Wert als 2048 setzen, können Sie die Speichernutzung reduzieren, wenn die 64KB-Puffer (der Standard) nur teilweise vom Eingabedatenstrom (InputStream) gefüllt werden, wenn sie verwendet werden. Die Puffer werden im XML-Parser com/ibm/xml/xlxp2/api/wssec/WSSXMLStreamReader zwischengespeichert. Indem die Speicherbelegung reduziert wird, kann der Gesamtspeicher verringert werden, der jedem Parserobjekt zugeordnet wird.

com.ibm.xml.xlxp2.api.util.Pool.STRONG_REFERENCE_POOL_MAXIMUM_SIZE

Der Wert dieser Systemeigenschaft ist eine ganze Zahl. Wird ein Wert angegeben, begrenzt er die Anzahl der XMLStreamReaders und XMLStreamWriters, die mit starken Referenzen (Strong Reference) zwischengespeichert werden.

Um einen Fehler aufgrund abnormaler Speicherbedingungen (OutOfMemoryError) zu vermeiden, sollte diese Systemeigenschaft auf 0 gesetzt werden. Dadurch werden alle XMLStreamReaders mit schwachen Referenzen (SoftReferences) zwischengespeichert und der Garbage-Collector kann den Speicher, den sie im im Cache belegen, jederzeit freigeben.

Wenn diese Systemeigenschaft nicht definiert wird, ist der Standardwert 10.

config_consistency_check

Verwenden Sie diese Eigenschaft, um den Standardprozess für die Arbeitsbereichskonsistenz optional zu inaktivieren. Der Deployment Manager verwaltet ein Masterkonfigurationsrepository für die gesamte Zelle. Wenn sich die Konfiguration ändert, vergleicht das Produkt standardmäßig die Konfiguration im Arbeitsbereich mit dem Master-Repository, um die Arbeitsbereichskonsistenz zu gewährleisten. Der Konsistenzprüfprozess kann jedoch die Zeit für das Speichern einer Konfigurationsänderung oder für die Implementierung sehr vieler Anwendungen erhöhen. Die folgenden Faktoren haben Einfluss auf die benötigte Zeit:
  • Je mehr Anwendungsserver oder Cluster in einer Zelle definiert sind, desto länger dauert die Speicherung einer Konfigurationsänderung.
  • Je mehr Anwendungen in einer Zelle implementiert sind, desto länger dauert die Speicherung einer Konfigurationsänderung.

Wenn die für die Speicherung einer Konfigurationsänderung erforderliche Zeit nicht vertretbar ist, können Sie Ihren JVM-Einstellungen die angepasste Eigenschaft config_consistency_check mit dem Wert "false" hinzufügen.

Unterstützte Konfigurationen Unterstützte Konfigurationen: Die angepasste Eigenschaft config_consistency_check wirkt sich nur auf den Deployment-Manager-Prozess aus. Sie hat keine Auswirkungen auf andere Prozesse, wie z. B. Node-Agent- oder Anwendungsserverprozesse. Die Konsistenzprüfung wird in diesen Prozessen nicht durchgeführt. In den Dateien SystemOut.log für diese Prozesse sehen Sie jedoch unter Umständen einen Hinweis darauf, dass die Konsistenzprüfung inaktiviert wurde. Für diese Prozesse, die keine Deployment-Manager-Prozesse sind, können Sie diese Nachricht ignorieren.sptcfg

deactivateWildCardURIMapping

Verwenden Sie diese Eigenschaft, um dem Generator der Datei "plugin-cfg.xml" die Erkennung der URI-Muster zu ermöglichen, die im Attribut "file.serving.patterns.allow" der Datei "ibm-web-ext.xmi" für eine Webanwendung angegeben sind.

Der Generator der Datei "plugin-cfg.xml" erkennt die URI-Muster, die im Attribut "file.serving.patterns.allow" angegeben sind, nur dann, wenn das Attribut "FileServingEnabled" in der Datei "ibm-web-ext.xmi" auf true gesetzt ist. Wenn das Attribut "FileServingEnabled" jedoch auf "true" gesetzt ist, fügt der Generator der Datei "plugin-cfg.xml" automatisch die Platzhalter-URI-Zuordnung /* in der Datei "plugin-cfg.xml" hinzu, die die Zweckmäßigkeit der Definition eindeutiger Dateibereitstellungsmuster verneint.

Wenn Sie die Eigenschaft "deactivateWildCardURIMapping" auf true setzen, verhindert dies, dass der Generator der Datei "plugin-cfg.xml" die Zuordnung /* in der Datei "plugin-cfg.xml" hinzufügt. Außerdem ermöglicht diese Einstellung dem Generator der Datei "plugin-cfg.xml" die Erkennung der URI-Muster, die im Attribut "file.serving.patterns.allow attribute" angegeben sind. Wird diese Eigenschaft den JVM-Einstellungen nicht hinzugefügt oder auf false gesetzt, wird der Datei "plugin-cfg.xml" automatisch die Zuordnung "/*" hinzugefügt.

Diese Eigenschaft wird auf Deployment-Manager-Ebene definiert.

DISABLE_LOCAL_COMM_WHEN_SSL_REQUIRED

Diese Eigenschaft gibt an, ob localComm oder SSL verwendet werden sollte, wenn die Transportebene SSL auf der Client- oder Serverseite unterstützt und auf der anderen Seite erforderlich ist.

localComm sollte nicht verwendet werden, wenn die Transportebene SSL auf der Client- oder Serverseite unterstützt und auf der anderen Seite erforderlich ist. In diesem Fall sollte diese angepasste Eigenschaft auf den Wert true gesetzt werden, um sicherzustellen, dass SSL anstelle von localComm verwendet wird.

Der Standardwert für diese Eigenschaft ist "false". Dies bedeutet, dass localComm verwendet wird.

Wenn Sie sich für die Verwendung dieser angepassten Eigenschaft entscheiden, müssen Sie sie als angepasste JVM-Eigenschaft des Anwendungsservers definieren.

Wenn Sie diese Eigenschaft für einen Anwendungsserver angeben, muss Folgendes festgelegt sein:
  • Für die Eigenschaft "Eingehender CSIv2-Transport" muss "SSL unterstützt" oder "SSL erforderlich" angegeben sein. Nähere Informationen zu diesen Einstellungen finden Sie im Artikel Eingehende Transporte konfigurieren.
  • Auf der Clientseite muss für die Eigenschaft "com.ibm.CORBA.loginSource" in der Datei "sas.client.props" der Wert none angegeben sein.
  • Auf der Clientseite muss eine der folgenden Einstellungen festgelegt sein:
    • com.ibm.CSI.performTransportAssocSSLTLSRequired=true
    • com.ibm.CSI.performTransportAssocSSLTLSSupported=true

    Fungiert ein WebSphere-Server als Client, muss die Eigenschaft für eingehenden CSIv2-Transport entweder mit SSLSupported oder mit SSLRequired auf dem Server auf "true" gesetzt werden.

disableWSAddressCaching

Mit dieser Eigenschaft können Sie das Caching für Web-Services inaktivieren. Wenn Ihr System normalerweise mit vielen Client-Threads ausgeführt wird und ein Zugriffskonflikt im Cache "wsAddrCache" auftritt, können Sie diese angepasste Eigenschaft auf true setzen, um das Caching der Web-Service-Daten zu verhindern.

Wenn Sie networkaddress.cache.ttl mit dem Wert null oder einer positiven ganzen Zahl angeben, muss diese Eigenschaft auf "true" gesetzt werden, um zu verhindern, dass eine IP-Adresse in der Web-Service-Engeine zwischengespeichert wird. Mit Networkaddress.cache.ttl wird in Sekunden angegeben, wie lange eine erfolgreiche Suche (Lookup) zwischengespeichert werden soll.

Der Standardwert ist false.

DRS_BATCH_INTERVAL_SIZE

Diese Eigenschaft gibt die maximale Anzahl an Objekten an, die in einen Stapel von DRS-replizierten HTTP-Sitzungsdaten aufgenommen werden kann (DRS = Data Replication Service). Wenn weniger als die angegebene Anzahl Objekte in den HTTP-Sitzungsdaten enthalten sind, die repliziert werden, werden alle Sitzungsdaten in einem einzigen Stapel repliziert.

Standardmäßig repliziert DRS 50 HTTP-Sitzungsdatenobjekte in einem Stapel. Weil die Serialisierung einer großen Nachricht eine abnormale Speicherbedingung zur Folge haben kann, sollte in jeden Stapel eine kleinere Anzahl Objekte aufgenommen werden, insbesondere dann, wenn Sie Anwendungsserver verwenden, die zu eingerichteten, vollständig gefüllten Replikationsdomänen dazu kommen.

Wenn Sie sich für die Verwendung dieser angepassten Eigenschaft entscheiden, müssen Sie sie als angepasste JVM-Eigenschaft des Anwendungsservers definieren.

DRS_THREADPOOL_MINSIZE

Gibt die zulässige Mindestanzahl an Threads im Thread-Pool für den Datenreplikationsservice (DRS) an.

Beim Starten eines Anwendungsservers sind dem Thread-Pool zunächst keine Threads zugeordnet. Wenn es die Workload des Anwendungsservers erfordert, werden dem Thread-Pool so viele Threads hinzugefügt, bis die Anzahl der Threads im Pool dem mit dieser angepassten Eigenschaft angegebenen Wert entspricht. Danach werden in Anpassung an die Workload weitere Threads hinzugefügt bzw. entfernt. Die Anzahl der Threads im Pool fällt jedoch niemals unter den mit dieser angepassten Eigenschaft angegebenen Wert, selbst wenn einige der Threads inaktiv sind.

Der Standardwert für diese angepasste Eigenschaft sind 40 Threads.

Wenn Sie sich für die Verwendung dieser angepassten Eigenschaft entscheiden, müssen Sie sie als angepasste JVM-Eigenschaft des Anwendungsservers definieren.

DRS_THREADPOOL_MAXSIZE

Gibt die maximale Anzahl der Threads an, die im DRS-Thread-Pool verwaltet werden sollen.

Der Standardwert für diese angepasste Eigenschaft sind 100 Threads.

Wenn Sie sich für die Verwendung dieser angepassten Eigenschaft entscheiden, müssen Sie sie als angepasste JVM-Eigenschaft des Anwendungsservers definieren.

DRS_THREADPOOL_ISGROWABLE

Bei Auswahl dieser Option kann die Anzahl der Threads den für den DRS-Thread-Pool konfigurierten Maximalwert übersteigen.

Die maximale Anzahl der Threads, die erstellt werden können, wird nur durch die Grenzwerte der JVM und des Betriebssystems beschränkt. Wenn die Größe eines erweiterbaren Thread-Pools die maximale Größe überschreitet, werden keine zusätzlichen Threads mehr wiederverwendet, sondern werden nach der Verarbeitung der Vorgänge, für die sie erstellt wurden, verworfen.

Der Standardwert ist false.

Wenn Sie sich für die Verwendung dieser angepassten Eigenschaft entscheiden, müssen Sie sie als angepasste JVM-Eigenschaft des Anwendungsservers definieren.

dynacache.jms.cacheInstance

Wenn die Invalidierung mehrerer Zellen und mehrerer Stammgruppen des dynamischen Cache-Service aktiviert ist, können Sie mit dieser Eigenschaft die Cacheinstanz festlegen, die für Prozessinvalidierungen verwendet werden soll. Wenn Sie diese Eigenschaft auf "*" setzen, werden Invalidierungs-IDs in allen Cacheinstanzen verarbeitet. Diese Eigenschaft muss auf den SIB-Servern definiert werden.

Standardmäßig wird die Cacheinstanz "baseCache" verwendet. Mit der Administrationskonsole können Sie die Namen der Cacheinstanzen bestimmen, die für Ihr System definiert sind.

Wenn Sie sich für die Verwendung dieser angepassten Eigenschaft entscheiden, definieren Sie sie als angepasste JVM-Eigenschaft des Anwendungsservers, sofern im Kontext einer bestimmten Task keine anderen Angaben enthalten sind.

dynacache.jms.connRetryInterval

Wenn die Invalidierung mehrerer Zellen und mehrerer Stammgruppen des dynamischen Cache-Service aktiviert ist, können Sie mit dieser Eigenschaft den Zeitraum in Sekunden angeben, den ein Cluster-Member warten muss, bevor er versucht, erneut eine neue Verbindung zu einem SIB-Server (Service Integration Bus) herzustellen.

Der Standardwert für diese Eigenschaft ist 30.

Wenn Sie sich für die Verwendung dieser angepassten Eigenschaft entscheiden, definieren Sie sie als angepasste JVM-Eigenschaft des Anwendungsservers, sofern im Kontext einer bestimmten Task keine anderen Angaben enthalten sind.

dynacache.jms.invProcessingDelay

Wenn die Invalidierung mehrerer Zellen und mehrerer Stammgruppen des dynamischen Cache-Service aktiviert ist, können Sie mit dieser Eigenschaft den Zeitraum in Sekunden angeben, den der SIB-Server Invalidierungs-IDs in die Warteschlange stellen muss, bevor er sie verarbeitet.

Der Standardwert für diese Eigenschaft ist 20.

Wenn Sie sich für die Verwendung dieser angepassten Eigenschaft entscheiden, definieren Sie sie als angepasste JVM-Eigenschaft des Anwendungsservers, sofern im Kontext einer bestimmten Task keine anderen Angaben enthalten sind.

dynacache.jms.numStoredInvalidations

Wenn die Invalidierung mehrerer Zellen und mehrerer Stammgruppen des dynamischen Cache-Service aktiviert ist, können Sie mit dieser Eigenschaft die maximale Anzahl an Invalidierungs-IDs angeben, die ein Cluster-Member speichern kann, während er darauf wartet, dass ein SIB-Server verfügbar wird. Ist der Schwellenwert erreicht, werden die ältesten Invalidierungs-IDs beim Hinzufügen neuer IDs entfernt.

Der Standardwert für diese Eigenschaft ist 10000.

Wenn Sie sich für die Verwendung dieser angepassten Eigenschaft entscheiden, definieren Sie sie als angepasste JVM-Eigenschaft des Anwendungsservers, sofern im Kontext einer bestimmten Task keine anderen Angaben enthalten sind.

[z/OS]

invocationCacheSize

Verwenden Sie diese Eigenschaft, um die Größe des Aufrufcaches zu steuern. Der Aufrufcache enthält Informationen für die Zuordnung von Anforderungs-URLs zu Servletressourcen. Für jeden Worker-Thread, der eine Anforderung verarbeiten kann, wird ein Cache der angeforderten Größe erstellt. Die Standardgröße des Aufrufcaches ist 50. Wenn mehr als 50 eindeutige URLs aktiv verwendet werden (jede JavaServer Page ist ein eindeutiger URL), müssen Sie die Größe des Aufrufcaches erhöhen.

Ein größerer Cache verbraucht mehr Java-Heapspeicher. Deshalb müssen Sie unter Umständen auch die maximale Java-Heapspeichergröße erhöhen. Wenn beispielsweise jeder Cacheeintrag 2 KB erfordert, die maximale Threadgröße auf 25 und die Größe des URL-Aufrufcache auf 100 gesetzt ist, sind 5 MB Java-Heapspeicher erforderlich.

Sie können jede Zahl größer als 0 als Cachegröße angeben. Wenn Sie diese Eigenschaft auf den Wert 0 setzen, wird der Aufrufcache inaktiviert.

[AIX Solaris HP-UX Linux Windows][IBM i]

java.net.preferIPv4Stack

Mit dieser Eigenschaft können Sie die IPv6-Unterstützung inaktivieren. In Betriebssystemen, in denen IPv6-Unterstützung verfügbar ist, ist das zugrunde liegende, vom Produkt verwendete native Socket ein IPv6-Socket. In IPv6-Netz-Stacks, die mit IPv4 zugeordnete Adressen verwenden, können Sie IPv6-Sockets verwenden, um Verbindungen zu IPv4- und IPv6-Hosts herzustellen und auch Verbindungen von diesen Hosts zu empfangen.

Wird diese Eigenschaft auf true gesetzt, wird in der JVM die Unterstützung für den dualen Modus inaktiviert, was wiederum normale Funktionen des Produkts unterbrechen könnte. Deshalb müssen Sie vor der Verwendung der Eigenschaft unbedingt über die möglichen Folgen im Klaren sein. Im Allgemeinen wird die Definition dieser Eigenschaft nicht empfohlen.

Der Standardwert für diese angepasste Eigenschaft ist false. Eine Ausnahme bilden Microsoft Windows-Betriebssysteme, für die der Standardwert true ist.

[AIX Solaris HP-UX Linux Windows][IBM i]

java.net.preferIPv6Addresses

Mit dieser Eigenschaft können Sie die IPv4-Unterstützung inaktivieren. Wird diese Eigenschaft auf true gesetzt, wird in der JVM die Unterstützung für den dualen Modus inaktiviert, was wiederum normale Funktionen des Produkts unterbrechen könnte. Deshalb müssen Sie vor der Verwendung der Eigenschaft unbedingt über die möglichen Folgen im Klaren sein. Im Allgemeinen wird die Definition dieser Eigenschaft nicht empfohlen.

Der Standardwert für diese angepasste Eigenschaft ist false. Eine Ausnahme bildet das Betriebssystem Windows, für das der Standardwert true ist.

java.util.logging.configureByLoggingPropertiesFile

Mit dieser angepassten Eigenschaft können Sie angeben, ob die JVM die Datei "logging.properties" für die Konfiguration der JSR-47-Protokollierung verwendet.

Wird diese Eigenschaft den JVM-Konfigurationseinstellungen nicht hinzugefügt oder auf false gesetzt, werden die Konfigurationseinstellungen, die in der Datei "logging.properties" enthalten sind, nicht übernommen, weil das Produkt die Basiskonfiguration für die JSR47-Protokollierung mit der Einstellung der Systemeigenschaft "java.util.logging.manager=com.ibm.ws.bootstrap.WsLogManager" überschreibt. In dieser Situation können nur Protokollierungseinstellungen, die über das Programm geändert werden können, wie z. B. das Hinzufügen von Handlern und Formatierungsprogrammen, modifiziert werden.

Wenn Sie diese Eigenschaft auf true setzen, konfiguriert die JVM den WsLogManager weiterhin als LogManager, aber während des Serverstarts wird die Protokollierungskonfiguration für Anwendungen, die die JSR-47-Protokollierung verwenden, basierend auf den Einstellungen in der Datei "logging.properties" initialisiert. Die gültigen Protokollierungseigenschaften und Protokollierungsformate, die in der Konfigurationsdatei "logging.properties" angegeben werden können, finden Sie in der Dokumentation der Anwendungsprogrammierschnittstelle "Java Utility Logging".
Fehler vermeiden Fehler vermeiden: Weisen Sie die Eigenschaft "java.util.logging.ConsoleHandler" keinen Protokollfunktionen zu, da diese Zuordnung zu einer Endlosschleife führen kann.gotcha

[AIX Solaris HP-UX Linux Windows][IBM i]Die Datei logging.properties befindet sich im Verzeichnis <<WAS-Installationsverzeichnis>>/java/jre/lib/logging.properties und kann bei Bedarf angepasst werden.

[z/OS]Die Datei logging.properties befindet sich im Verzeichnis <<WAS-Installationsverzeichnis>>/java/J*/lib/logging.properties und kann bei Bedarf angepasst werden.

Der Standardwert ist false.

jaxws.asyncClient.maxThreadPoolSize

Verwenden Sie diese Eigenschaft, um die Anzahl der gleichzeitig ausgeführten Threads für asynchrone JAX-WS-Clientanforderungen zu begrenzen.

Die Anzahl der Threads ist standardmäßig nicht begrenzt.

Wenn Sie sich für die Verwendung dieser angepassten Eigenschaft entscheiden, müssen Sie sie als angepasste JVM-Eigenschaft des Anwendungsservers definieren.

jaxws.handler.reducecaching

Verwenden Sie diese Eigenschaft, um sicherzustellen, das JAX-WS-Handler die SOAP-Nachrichten ordnungsgemäß aktualisieren.

SOAP-Nachrichten, die von einem JAX-WS-Handler aktualisiert werden, erscheinen korrekt, wenn sie in einem Speicherauszug im Handler ausgegeben werden, aber wenn die Nachricht gesendet wird, fehlen die Änderungen. Setzen Sie diese Eigenschaft auf true, wenn Ihr Handler mehrere Male getMessage() aufruft und Nachrichten verloren gehen.

Fehler vermeiden Fehler vermeiden: Diese Eigenschaft ist nicht kompatibel, wenn SOAP-Header direkt über JAX-WS-Nachrichtenkontexteigenschaften modifiziert werden. Werden beide Arten der Nachrichtenmodifikation verwendet, können Daten verloren gehen.gotcha

Der Standardwert ist false.

jaxws.ignore.extraWSDLOps

Verwenden Sie diese Eigenschaft, wenn in der WSDL eine größere Anzahl Operationen enthalten sind als im Client integriert.

Das Standardverhalten des Client sieht vor, die im Client integrierten Operationen mit den Operationen in der WSDL zu validieren. Wenn diese Operationen nicht übereinstimmen, schlägt die Validierung fehl. Geben Sie für diese Eigenschaft den Wert "true" an, wenn in der WSDL eine eine größere Anzahl Operationen enthalten ist als im Client integriert und wenn die WSDL-Validierung erfolgreich ausgeführt werden soll und der Client aufgerufen werden kann.

Der Standardwert ist false.

Wenn Sie sich für die Verwendung dieser angepassten Eigenschaft entscheiden, müssen Sie sie als angepasste JVM-Eigenschaft des Anwendungsservers definieren.

jaxws.ignoreMetadataComplete

Setzen Sie diese JVM-Eigenschaft auf true, damit ein Scan auf Web-Service-Annotationen ausgeführt wird, auch wenn "metadata-complete" für ein Modul festgelegt wird. Der Standardwert ist false.

Standardmäßig werden JAX-WS-Web-Services nicht erkannt, wenn "metadata-complete" auf true gesetzt ist.

Fehler vermeiden Fehler vermeiden: Diese JVM-Eigenschaft muss für jede JVM in der WebSphere Application Server-Zelle festgelegt werden. gotcha

jaxws.JAXBContext.permStoreCostThresholdMsec

Verwenden Sie diese Eigenschaft, um das Caching von JAXBContext-Objekten, für deren Erstellung mehr Zeit als angegeben benötigt wird, zu aktivieren.

Während der Ausführung von JAX-WS-Web-Services oder -Clients können Verzögerungen auftreten, wenn JAXBContext-Objekte erstellt werden, die Hunderte von Klassen handhaben. Durch das Caching zeitintensiver JAXBContext-Objekte kann die Web-Service- und Clientausführung beschleunigt werden, weil das JAXBContext-Objekt nicht bei jeder Verwendung erneut erstellt werden muss.

Setzen Sie diese Eigenschaft auf einen Wert in Millisekunden größer 0, um das Caching von JAXBContext-Objekten zu aktivieren, für deren Erstellung mehr Zeit als angegeben benötigt wird, Der Cache bleibt so lange bestehen, bis die JVM erneut gestartet wird. Der empfohlene Wert ist 5000 Millisekunden oder höher.

Der Standardwert ist 0, d. h. das Caching ist nicht aktiviert.

Wenn Sie sich für die Verwendung dieser angepassten Eigenschaft entscheiden, müssen Sie sie als angepasste JVM-Eigenschaft des Anwendungsservers definieren.

jaxws.JAXBContext.permStoreMaxSize

Setzen Sie diese Eigenschaft auf einen ganzzahligen Wert, um die maximale Anzahl Einträge im JAXBContext-Cache anzugeben. Wenn der Cache voll ist, werden veraltete Einträge als erstes ersetzt, gefolgt von dem Eintrag mit der geringsten Erstellungszeit.

Der Standardwert ist 32.

Anmerkung: Diese Eigenschaft modifiziert den mit der Eigenschaft jaxws.JAXBContext.permStoreCostThresholdMsec erstellten Cache.

jaxws.JAXBContext.permStoreStaleThresholdHours

Setzen Sie diese Eigenschaft auf einen Wert in Stunden, nach deren Ablauf ein Eintrag im JAXBContext-Cache, der nicht aufgerufen wurde, als veraltet gilt. Wenn der Cache voll ist, werden veraltete Einträge als erstes ersetzt.

Der Standardwert ist 24 Stunden.

Anmerkung: Diese Eigenschaft modifiziert den mit der Eigenschaft jaxws.JAXBContext.permStoreCostThresholdMsec erstellten Cache.

jaxws.payload.highFidelity

Verwenden Sie diese Eigenschaft, um verlustfreie Umsetzungen zu ermöglichen. Wenn Sie diese Eigenschaft auf true setzen, garantiert die Web-Service-Laufzeitumgebung, dass die eingehende Nachricht und die Nachricht an der SOAPHandler-Grenze identisch sind.

Gewöhnlich ist die von einem JAX-WS-SOAPHandler empfangene SOAP-Nachricht keine exakte Entsprechung der eingehenden SOAP-Nachricht. Die vom JAX-WS-SOAPHandler empfangene Nachricht kann beispielsweise andere XML-Präfixe als die ursprüngliche eingehende Nachricht verwenden. Dies geringfügigen Änderungen haben keine Auswirkung auf die logische Interpretation der Nachricht. Sie müssen diese Eigenschaft jedoch Ihren JVM-Einstellungen hinzufügen und die Eigenschaft auf "true" setzen, wenn Nachrichten an der SOAPHandler-Grenze den eingehenden Nachrichten exakt entsprechen müssen. Canonicalization Specification (C14N) erfordert beispielsweise, dass die Präfixnamen beibehalten werden.

Bewährtes Verfahren Bewährtes Verfahren: Verwenden Sie diese Eigenschaft nur, wenn Ihre SOAP-Anforderungen auf den Inhalt eines Elements "soapenv:Body" in Ihren SOAPHandlern zugreifen. Wenn Sie die Eigenschaft auf true setzen, kann dies die Web-Service-Laufzeitleistung beeinträchtigen.bprac

Der Standardwert ist false.

Wenn Sie sich für die Verwendung dieser angepassten Eigenschaft entscheiden, müssen Sie sie als angepasste JVM-Eigenschaft des Anwendungsservers definieren.

jaxws.provider.interpretNullAsOneway

Wenn Sie einen JAX-WS-Web-Service haben, der einen providerbasierten Endpunkt definiert, der die Annotation "javax.xml.ws.Provider" verwendet, und keine WSDL-Datei angegeben ist, können Sie mit dieser angepassten Eigenschaft steuern, wie sich die JAX-WS-Laufzeitumgebung verhält, wenn der Provider einen Nullwert von der Methode "invoke()" zurückgibt. Standardmäßig sendet die Laufzeitumgebung eine Antwort zurück, die sich aus einer SOAP-Rahmenanweisung (SOAPEnvelope) mit einem leeren Element "SOAPBody" zusammensetzt.

Wenn diese Eigenschaft auf true gesetzt ist und die Providerimplementierung einen Nullwert zurückgibt und keine WSDL-Datei definiert ist, interpretiert die Laufzeitumgebung den von der Providerimplementierung zurückgegebenen Nullwert als reine Anforderungsoperation, sodass keine Antwort zurückgegeben wird. Wie bei allen reinen Anforderungsoperationen sind einige Servicequalitäten, wie z. B. WS-Transactions, nicht verfügbar.

Wenn die Annotation javax.xml.ws.WebServiceProvider einen WSDL-Wert spezifiziert und die WSDL eine Anforderung/Antwort-Operation definiert, gibt die JAX-WS-Laufzeitumgebung unabhängig von der Einstellung dieser Eigenschaft immer eine Antwort zurück, die sich auseiner SOAP-Rahmenanweisung mit einem leeren Element "SOAPBody" zusammensetzt.

Der Standardwert ist false.

Sie müssen diese Eigenschaft für jeden Server, der eine Änderung des Standardwerts erfordert, auf true setzen.

Wenn Sie sich für die Verwendung dieser angepassten Eigenschaft entscheiden, müssen Sie sie als angepasste JVM-Eigenschaft des Anwendungsservers definieren.

jaxws.runtime.inheritedImplMethodsAccessible

Verwenden Sie diese Eigenschaft, um die Web-Service-Laufzeit so abzuändern, dass übernommene Methoden aufgerufen werden dürfen. Diese Verhaltensänderung wird aktiviert, indem die Eigenschaft auf true gesetzt wird.

Wenn Sie sich für die Verwendung dieser angepassten Eigenschaft entscheiden, müssen Sie sie als angepasste JVM-Eigenschaft des Anwendungsservers definieren.

jaxws.runtime.restrictStaticWebmethod

Verwenden Sie diese Eigenschaft, um die Bereitstellung statischer Operationen zu verhindern. Wenn diese Eigenschaft auf true gesetzt wird, verhindert die JAX-WS-Laufzeitumgebung die Bereitstellung statischer Operationen.

Der Standardwert ist false.

Wenn Sie sich für die Verwendung dieser angepassten Eigenschaft entscheiden, müssen Sie sie als angepasste JVM-Eigenschaft des Anwendungsservers definieren.

jaxws.share.dynamic.ports.enable

Verwenden Sie diese Eigenschaft, um die Sichtbarkeit dynamischer Ports in JAX-WS-Web-Services anzugeben.

Standardmäßig sind dynamische Ports nur für die Instanz des Service sichtbar, die den Port erstellt hat. Setzen Sie diese Eigenschaft auf true, um dynamische Ports in Web-Services gemeinsam zu nutzen.

Wenn Sie sich für die Verwendung dieser angepassten Eigenschaft entscheiden, müssen Sie sie als angepasste JVM-Eigenschaft des Anwendungsservers definieren.

jaxws.soapfault.local.exceptions.disable

Verwenden Sie die Eigenschaft jaxws.soapfault.local.exceptions.disable, um zu verhindern, das lokal ein einem JAX-WS-Client auftretende Ausnahmen als SOAPFault behandelt werden. Wenn in einem JAX-WS-Client eine lokale Ausnahme eintritt, wird standardmäßig ein SOAPFault für die Ausnahme erstellt. Ein Beispiel für eine lokale Ausnahme ist ConnectException, eine Ausnahme, die bei einem ungültigen Host oder Port ausgelöst wird. Die relevanten handleFault-Methoden des JAX-WS-Anwendungshandlers werden mit SOAPFault aufgerufen. Anschließend wird eine Ausnahme des Typs SOAPFaultException über die aufgerufene Methode des JAX-WS-Clients zurückgegeben.

Indem Sie diese Eigenschaft auf true setzen, wird bei lokalen Ausnahmen eine leere Nachricht erstellt. Die relevanten handleMessage-Methoden des JAX-WS-Anwendungshandlers werden mit der leeren Nachricht aufgerufen. Anschließend wird eine Ausnahme des Typs WebServiceException über die aufgerufene Methode des JAX-WS-Clients zurückgegeben. Dies ist das Verhalten aus den früheren Releases.

Der Standardwert ist false.

Wenn Sie sich für die Verwendung dieser angepassten Eigenschaft entscheiden, müssen Sie sie als angepasste JVM-Eigenschaft des Anwendungsservers definieren.

jaxws.useSafeIPC

Setzen Sie diese Eigenschaft für die Anwendungsserver auf true, falls in den JAX-WS-Web-Services Fehler auftreten, wenn die Eigenschaft enableInProcessConnections im Web-Container auf true gesetzt ist. Dies kann der Fall sein, wenn eine sichere gemeinsame Nutzung eines einzelnen Threads durch mehrere Web-Service-Anwendungen, die einander aufrufen, nicht möglich ist. Wenn Sie diese Eigenschaft auf true setzen, werden die Anwendungen in separaten Threads ausgeführt.

Der Standardwert ist "false".

jdk.corba.allowOutputStreamSubclass

Setzen Sie diese Eigenschaft auf true, um sicherzustellen, dass org.omg.CORBA_2_3.portable.OutputStream in Unterklassen klassifiziert werden kann.

Bei Anwendungen, die mit einem Sicherheitsmanager ausgeführt werden, kann ein Leistungsabfall festgestellt werden, der auf die zusätzlichen Sicherheitsprüfungen zurückzuführen ist, die jetzt ausgeführt werden, um den Standardkonstruktor org.omg.CORBA_2_3.portable.OutputStream zu sichern, wenn ein Sicherheitsmanager installiert ist. Aufgrund dieser zusätzlichen Sicherheitsprüfungen können Inkompatibilitäten mit vorhandenen Anwendungsimplementierungen entstehen. Wenn Sie diese Eigenschaft in Ihre JVM-Einstellungen aufnehmen und auf true setzen, können Sie das Auftreten solcher Inkompatibilitäten verhindern.

Diese Eigenschaft kann auf der Ebene des Anwendungsservers, des Node Agent oder des Deployment Manager definiert werden. Normalerweise wird sie auf Anwendungsserverebene festgelegt.

ODCClearMessageAge

Mit dieser Eigenschaft können Sie die Zeit (in Millisekunden) festlegen, nach der eine ODC-Nachricht aus dem Bulletin-Board entfernt wird, selbst wenn der Empfänger die Nachricht nicht bestätigt hat. Wenn Sie einen Wert für diese Eigenschaft festlegen, können Sie damit verhindern, dass sich Nachrichten anhäufen, die aus irgendeinem Grund nicht bestätigt werden.

Sie können jede positive ganze Zahl für diese Eigenschaft angeben. Um jedoch zu vermeiden, dass Nachrichten zu früh entfernt werden, wird ein Wert von "300000" (5 Minuten) oder höher empfohlen.

Der Standardwert ist 300000 Millisekunden.

ODCInit.disabled

Setzen Sie diese Eigenschaft auf true, wenn Sie die Kommunikation zwischen Prozessen für die Komponente On Demand Configuration (ODC) und für die gesamte lokale ODC-Verarbeitung inaktivieren möchten.

Die ODC-Komponente (On Demand Configuration) wird verwendet, wenn Web-Service-basierte Anwendungen implementiert werden und wenn ein Proxy-Server von WebSphere Application Server für die Verarbeitung der Anforderungen verwendet wird. Die ODC-Komponente wird auf Zellenbasis aktiviert und inaktiviert. Wenn Ihre Topologie Proxy-Server oder Web-Service-basierte Anwendungen enthält, dürfen Sie deshalb den ODC-Service nicht inaktivieren.

Wenn Sie in einer eine Umgebung mit einer großen Topologie arbeiten, in der keine Web-Service-basierten Anwendungen implementiert sind oder keine Proxy-Server von WebSphere Application Server für die Verarbeitung von Anforderungen eingesetzt werden, wird die ODC-Komponente nicht verwendet, und Sie können diese Eigenschaft auf true setzen. Durch das Setzen der Eigenschaft auf true wird die ODC-Komponente inaktiviert, was die Netzbandbreite und die CPU-Auslastung verringert.

Der Standardwert ist false.

org.apache.aries.blueprint.header.mandatory

Wenn diese Eigenschaft auf true gesetzt ist, müssen Bundles mit Blueprint einen Blueprint-Header haben. Dies ermöglicht "apache aries", kostenintensive Scanvorgänge zu vermeiden, wenn es keinen Blueprint-Header gibt.

org.apache.axiom.attachments.tempfile.expiration

Wenn sich übermäßig viele temporäre Dateien des Typs AxisXXXXXX.att anhäufen, setzen Sie diese Eigenschaft auf einen Wert in Sekunden, nach dessen Ablauf die JAX-WS-Laufzeit diese temporären Dateien, die zum Speichern von MTOM-Anhängen verwendet werden, löschen soll.

Der Standardwert ist 0, d. h., Dateien werden gelöscht, wenn die JVM beendet wird.

org.apache.el.parser.SKIP_IDENTIFIER_CHECK

Verwenden Sie diese Eigenschaft, um die Überprüfung der EL-Variablenkennungen abzuschwächen. Dieses abgeschwächte Überprüfungsverhalten entspricht dem Verhalten, das in WebSphere Application Server-Versionen vor Version 8.0 stattfindet.

Ab Version 8.0 wird eine striktere Überprüfung der EL-Variablenkennungen durchgeführt. In diesem Überprüfungsprozess wird sowohl auf reservierte Java-Schlüsselwörtern und als auch auf reservierte EL-Schlüsselwörtern geprüft. Vor Version 8.0 wurde nur auf reservierte EL-Schlüsselwörtern geprüft.

Wenn eine Variablenkennung, die in einem JSTL/EL-Script verwendet werden, eines der reservierten JSP-Schlüsselwörter enthält, schlägt die Übersetzung der Variablenkennung fehl, wodurch eine Ausnahme ausgelöst wird. Die bevorzugte Methode zur Behandlung einer solchen Ausnahme besteht darin, den JSTL/EL-Code so zu ändern, dass keine reservierten Kennwörter als Variablennamen verwendet werden. Wenn dies jedoch nicht möglich oder nicht durchführbar ist, setzen Sie diese Eigenschaft auf true, um den Grad der Überprüfung so abzuschwächen, dass er demjenigen vor Version 8.0 entspricht.

Eine Liste der reservierten JSP-Schlüsselwörter finden Sie unter http://docs.oracle.com/javaee/5/tutorial/doc/bnahq.html#bnail

org.eclipse.jst.j2ee.commonarchivecore.disableZip

Verwenden Sie diese angepasste Eigenschaft, damit ZIP-Archive als einfache Dateien verarbeitet werden können.

Geben Sie für diese Eigenschaft den Wert "true" an, damit ZIP-Archive als einfache Dateien verarbeitet werden können, wenn die Dateien einer implementierten Anwendung abgefragt werden.

Der Standardwert ist false.

Diese Eigenschaft muss als angepasste Eigenschaft für einen Prozess von IBM WebSphere Application Server festgelegt werden, der Anwendungen ausführt, für die ZIP-Dateien ignoriert werden sollen.

org.eclipse.jst.j2ee.commonarchivecore.ignore.ejb.in.war

Verwenden Sie diese Eigenschaft, wenn alle folgenden Angaben zutreffen:
  • Sie haben eine Java EE 5-Anwendung.
  • Diese Anwendung enthält eine EJB-Datei in einer WAR-Datei.
  • Ihre Anwendung wird auf einem eigenständigen Server implementiert, auf dem WebSphere Application Server Version 7.x ausgeführt wird.
  • Die Anwendungsimplementierung schlägt fehl, wenn Sie versuchen, die Implementierung über einen Deployment Manager mit WebSphere Application Server Version 8.0 oder höher auf einem Knoten mit Version 7.x durchzuführen.

Wenn alle oben genannten Bedingungen zutreffen, schlägt die Implementierung unter Umständen fehl, weil die Anwendung während der Implementierung auf Java EE 6 hochgestuft wird. WebSphere Application Server Version 7.x implementiert Java EE 5. EJBs sind erst seit Java EE 6 in WAR-Dateien enthalten. Wenn WebSphere Application Server Version 8.0 oder höher eine EJB in einer WAR-Datei findet, wird die WAR-Datei auf Version 3.0 hochgestuft und die Anwendung auf Java EE 6. In diesem Fall kann die Anwendung nicht auf einem Knoten mit WebSphere Application Server Version 7.x implementiert werden.

Wenn EJBs in WAR-Dateien ignoriert werden sollen und das Upgrade der Anwendungsversion verhindert werden soll, setzen Sie die Eigenschaft im Deployment Manager auf true. Der Standardwert ist false.

Wenn Sie diese angepasste Eigenschaft setzen, ist die gewählte Einstellung für alle Anwendungen gültig. Wenn Sie die Einstellung auf eine bestimmte Anwendung anwenden möchten, fügen Sie in der Datei META-INF/MANIFEST.MF die folgende Zeile hinzu:
Ignore-Ejb-In-War-Annotation: true
Fehler vermeiden Fehler vermeiden: Wenn Sie das Anwendungsmanifest aktualisieren, müssen Sie vorgegebenen Zeilenlängen und andere Einschränkungen für das Manifest beachten. gotcha

org.eclipse.jst.j2ee.commonarchivecore.FILTERBINARIES

Verwenden Sie diese angepasste Eigenschaft, um zu verhindern, dass bestimmte Anwendungsdateien während der Laufzeitverarbeitung aufgelistet werden.

Aufgrund neuer Verarbeitungsanforderungen für JavaEE5-Annotationen werden während der Laufzeitverarbeitung in der Regel mehr Anwendungsdateien aufgelistet als in vorherigen Versionen des Produkts. Diese zusätzliche Auflistung kann dazu führen, dass Anwendungen, die von vorherigen Versionen des Produkts migriert wurden, langsamer starten, weil für die Auflistung der Anwendungsdateien zusätzliche Zeit benötigt wird.

Standardmäßig ist diese Eigenschaft nicht festgelegt.

Wenn Sie sich für die Verwendung dieser angepassten Eigenschaft entscheiden, müssen Sie sie als angepasste JVM-Eigenschaft des Anwendungsservers definieren.

org.eclipse.jst.j2ee.commonarchivecore.ignore.jee6.annotation

Verwenden Sie diese Eigenschaft, wenn alle folgenden Angaben zutreffen:
  • Sie haben eine Java EE 5-Anwendung.
  • Die Anwendung enthält Java EE 6-Annotationen.
  • Ihre Anwendung wird auf einem eigenständigen Server implementiert, auf dem WebSphere Application Server Version 7.x ausgeführt wird.
  • Die Anwendungsimplementierung schlägt fehl, wenn Sie versuchen, die Implementierung über einen Deployment Manager mit WebSphere Application Server Version Version 8.0 oder höher auf einem Knoten mit WebSphere Application Server Version 7.x durchzuführen.

Wenn alle oben genannten Bedingungen zutreffen, schlägt die Implementierung unter Umständen fehl, weil die Anwendung während der Implementierung auf Java EE 6 hochgestuft wird. WebSphere Application Server Version 7.x implementiert Java EE 5 und ignoriert Java EE 6-Annotationen. WebSphere Application Server Version 8.0 oder höher implementiert Java EE 6. Daher werden Java EE 6-Annotationen verarbeitet. Aus diesem Grund wird eine Java EE 5-Anwendung, die Java EE 6-Annotationen enthält, auf Java EE 6 hochgestuft. Nachdem die Anwendung hochgestuft wurde, implementiert WebSphere Application Server Version 8.0 oder höher die Anwendung nicht auf einem Knoten mit WebSphere Application Server Version 7.x.

Wenn die Java EE 6-Annotationen ignoriert werden sollen und wenn Sie verhindern möchten, dass die Version der Anwendung aktualisiert wird, setzen Sie die Eigenschaft im Deployment Manager auf true. Der Standardwert ist false.

Wenn Sie diese angepasste Eigenschaft festlegen, ist die gewählte Einstellung für alle Anwendungen gültig. Wenn Sie die Einstellung auf eine bestimmte Anwendung anwenden möchten, fügen Sie in der Datei META-INF/MANIFEST.MF die folgende Zeile hinzu:
Ignore-JEE6-Annotation: true
Fehler vermeiden Fehler vermeiden: Wenn Sie das Anwendungsmanifest aktualisieren, müssen Sie vorgegebenen Zeilenlängen und andere Einschränkungen für das Manifest beachten. gotcha

org.eclipse.jst.j2ee.commonarchivecore.ignore.jee7.annotation

Verwenden Sie diese Eigenschaft, wenn alle folgenden Angaben zutreffen:
  • Sie haben eine Java EE 5- oder Java EE 6-Anwendung.
  • Die Anwendung enthält Java EE 7-Annotationen.
  • Ihre Anwendung wird auf einem eigenständigen Server implementiert, auf dem WebSphere Application Server Version 7.x oder Version 8.x ausgeführt wird.
  • Die Anwendungsimplementierung schlägt fehl, wenn Sie versuchen, die Implementierung über einen Deployment Manager mit WebSphere Application Server Version 9.x auf einem Knoten mit WebSphere Application Server Version 7.x oder Version 8.x durchzuführen.

Wenn alle oben genannten Bedingungen zutreffen, schlägt die Implementierung wahrscheinlich fehl, weil die Anwendung während der Implementierung auf Java EE 7 hochgestuft wird. WebSphere Application Server Version 7.x und Version 8.x implementiert Java EE 5 bzw. Java EE 6. WebSphere Application Server Version 9.x implementiert Java EE 7. Daher werden Java EE 7-Annotationen verarbeitet. Aus diesem Grund wird eine Java EE 5- oder Java EE 6-Anwendung mit Java EE 7-Annotationen auf Java EE 7 hochgestuft. Nachdem die Anwendung hochgestuft wurde, implementiert WebSphere Application Server Version 9.x die Anwendung nicht auf einem Knoten mit Version 7.x oder Version 8.x.

Wenn die Java EE 7-Annotationen ignoriert werden sollen und wenn Sie verhindern möchten, dass die Version der Anwendung aktualisiert wird, setzen Sie die Eigenschaft im Deployment Manager auf true. Der Standardwert ist false.

Wenn Sie diese angepasste Eigenschaft festlegen, ist die gewählte Einstellung für alle Anwendungen gültig. Wenn Sie die Einstellung auf eine bestimmte Anwendung anwenden möchten, fügen Sie in der Datei META-INF/MANIFEST.MF die folgende Zeile hinzu:
Ignore-JEE7-Annotation: true
Fehler vermeiden Fehler vermeiden: Wenn Sie das Anwendungsmanifest aktualisieren, müssen Sie vorgegebene Zeilenlängen und weitere Einschränkungen für das Manifest beachten. gotcha

org.eclipse.jst.j2ee.commonarchivecore.ignore.web.fragment

Verwenden Sie diese Eigenschaft, wenn alle folgenden Angaben zutreffen:
  • Sie haben eine Java EE 5-Anwendung.
  • Die Anwendung enthält eine WAR-Datei mit einem Webfragment.
  • Ihre Anwendung wird auf einem eigenständigen Server implementiert, auf dem WebSphere Application Server Version 7.x ausgeführt wird.
  • Die Anwendungsimplementierung schlägt fehl, wenn Sie versuchen, die Implementierung über einen Deployment Manager mit WebSphere Application Server Version 8.0 oder höher auf einem Knoten mit Version 7.x durchzuführen.

Wenn alle oben genannten Bedingungen zutreffen, schlägt die Implementierung unter Umständen fehl, weil die Anwendung während der Implementierung auf Java EE 6 hochgestuft wird. WebSphere Application Server Version 7.x implementiert Java EE 5. Webfragmente sind erst seit Java EE 6 in WAR-Dateien enthalten. Wenn WebSphere Application Server Version 8.0 oder höher ein Webfragment findet, wird die WAR-Datei auf Version 3.0 hochgestuft und die Anwendung auf Java EE 6. In diesem Fall kann die Anwendung nicht auf einem Knoten mit WebSphere Application Server Version 7.x implementiert werden.

Wenn Webfragmente ignoriert werden sollen und das Upgrade der Anwendungsversion verhindert werden soll, setzen Sie die Eigenschaft im Deployment Manager auf true. Der Standardwert ist false.

Wenn Sie diese angepasste Eigenschaft setzen, ist die gewählte Einstellung für alle Anwendungen gültig. Wenn Sie die Einstellung auf eine bestimmte Anwendung anwenden möchten, fügen Sie in der Datei META-INF/MANIFEST.MF die folgende Zeile hinzu:
Ignore-Web-Fragment: true
Fehler vermeiden Fehler vermeiden: Wenn Sie das Anwendungsmanifest aktualisieren, müssen Sie vorgegebenen Zeilenlängen und andere Einschränkungen für das Manifest beachten. gotcha

org.eclipse.jst.j2ee.commonarchivecore.openAllArchivesTrue

Verwenden Sie diese angepasste Eigenschaft, um den Server so einzustellen, dass er alle Archive erweitert.

Damit Nicht-Standard-Archive während der Implementierung erweitert werden können, legen Sie die Eigenschaft in dem an der Implementierung beteiligten Anwendungsserverprozess fest. Wenn Sie einen Deployment Manager verwenden, legen Sie die Eigenschaft im Deployment Manager-Prozess fest.

Wenn die Erweiterung mit dem Script earExpander durchgeführt werden soll, legen Sie die Eigenschaft als angepasste Java-Eigenschaft fest, indem Sie das Script earExpander bearbeiten.

Der Standardwert ist "false".

Anmerkung: Diese Eigenschaft wird nicht auf JARs innerhalb von JARs angewendet. JARs innerhalb von JARs werden nicht erweitert, auch wenn die Eigenschaft auf "true" gesetzt ist. Alle JARs in EAR-Dateien und alle JARs in RAR-Dateien sind aktiv. Diese angepasste Eigenschaft hat keine Auswirkungen auf die Verarbeitung von JARs in EAR-Dateien und von JARs in RAR-Dateien.

org.eclipse.jst.j2ee.commonarchivecore.PM62467.Disabled

Verwenden Sie diese angepasste Eigenschaft, um das Verhalten anzugeben, das eintritt, wenn ein Archiveintragspfad einen nicht zulässigen Wert enthält.

Beim Implementieren einer Anwendung in WebSphere Application Server wird der Inhalt der Anwendungsarchiv- und Moduldateien in das Verzeichnis installedApps des Anwendungsserverprofils extrahiert, wobei die Archiveintragspfade der Dateien verwendet werden. Die Anwendungsdateien müssen in das Verzeichnis installedApps extrahiert werden. Wenn der Archiveintragspfad einer Datei den Wert ../ enthält, können die Archivdateien jedoch nicht in ein anderes Verzeichnis extrahiert werden. Wenn diese angepasste Eigenschaft auf false gesetzt wird und der Archiveintragspfad den Wert ../ enthält, tritt eine Ausnahme des Typs ArchiveRuntimeException auf, und die Archivverarbeitung wird gestoppt. Setzen Sie diese Eigenschaft auf true, damit eine Warnung protokolliert und die Implementierung der Anwendung fortgesetzt wird.

Der Standardwert ist false.

Wenn Sie sich für die Verwendung dieser angepassten Eigenschaft entscheiden, müssen Sie sie als angepasste JVM-Eigenschaft im Deployment-Manager-Knoten und im Anwendungsserver definieren.

overrideAutoProp

Verwenden Sie diese angepasste Eigenschaft, um die Datei plugin-cfg.xml an ferne Knotenrepositorys und die Position des fernen Web-Servers weiterzugeben.

Wenn diese Eigenschaft mit manueller Weitergabe auf true gesetzt ist, wird die Datei plugin-cfg.xml sowohl an das ferne Knotenrepository als auch an die Position des fernen Web-Servers weitergegeben. Wenn diese Eigenschaft mit manueller Weitergabe auf false gesetzt ist, wird die Datei plugin-cfg.xml nur an das ferne Knotenrepository und nicht an die Position des fernen Web-Servers weitergegeben.

Der Standardwert ist false.

Wenn Sie diese angepasste Eigenschaft verwenden möchten, müssen Sie sie als angepasste JVM-Eigenschaft des Knotens angeben.

Sobald diese Eigenschaft für den Knoten gesetzt wurde, müssen Sie die Änderung am Knoten synchronisieren. Damit die Einstellung wirksam wird, müssen Sie den Knoten stoppen und starten.

plugin.syncdisabled

Verwenden Sie diese angepasste Eigenschaft, um die Knotensynchronisation, die bei der Weitergabe der Web-Server-Plug-in-Konfiguration aufgerufen wird, zu inaktivieren.

Wenn diese Eigenschaft auf true gesetzt ist, werden Konfigurationsänderung des Web-Server-Plug-ins nicht automatisch im Knoten synchronisiert. Dies bedeutet, dass alle Konfigurationsänderungen des Web-Server-Plug-ins, die Sie vornehmen, erst dann an den Web-Server weitergegeben werden, wenn Sie eine manuelle Synchronisation ausführen.

Der Standardwert ist false.

Wenn Sie diese angepasste Eigenschaft verwenden möchten, müssen Sie sie als angepasste JVM-Eigenschaft des Knotens angeben.

threadpool.maxsize

Verwenden Sie diese Eigenschaft, um die Anzahl der Threads festzulegen, die in einen neu erstellten Thread-Pool aufgenommen werden können. Zum Starten jeder Anwendungsserver-JVM wird ein dedizierter Thread erstellt. Die JVMs mit dedizierten Threads in diesem Thread-Pool sind die JVMs, die bei jedem Start des Node Agent parallel gestartet werden.

Sie können eine ganze Zahl im Bereich 0 - 5 als Wert für diese Eigenschaft angeben. Wenn der angegebene Wert größer ist als 0, wird ein Thread-Pool erstellt, wobei dieser Wert die maximale Anzahl Threads angibt, die in diesen neu erstellten Thread-Pool aufgenommen werden können. In der folgenden Tabelle sind die unterstützten Werte für diese angepasste Eigenschaft und deren Auswirkung aufgeführt.

Tabelle 3. Unterstützte Werte für threadpool.maxsize. Die Tabelle enthält die angepassten Eigenschaftswerte an und ihre Auswirkungen.
Wert für threadpool.maxsize Auswirkung
Die Eigenschaft threadpool.maxsize ist auf 0 gesetzt oder nicht angegeben. Der Node Agent startet bis zu fünf JVMs parallel.
Die Eigenschaft threadpool.maxsize ist auf 1 gesetzt. Der Node Agent startet die JVMs seriell.
Die Eigenschaft threadpool.maxsize ist auf einen ganzzahligen Wert zwischen 2 und 5 gesetzt. Der Node Agent startet die angegebene Anzahl JVMs parallel.

Beispiel: Angenommen, der Node Agent verfügt über zehn JVMs mit dem Status running (aktiv), was bedeutet, dass sie bei jedem Start des Node Agent gestartet werden. Wenn Sie für diese Eigenschaft den Wert 3 angeben, werden jedes Mal, wenn der Node Agent gestoppt und gestartet wird, nur drei der zehn JVMs beim Node-Agent-Start parallel gestartet.

Fehler vermeiden Fehler vermeiden:
  • Wenn Sie die Administrationskonsole verwenden und threadpool.maxsize als Namen für eine neue angepasste JVM-Eigenschaft für den Node Agent angeben, müssen Sie für diese neue angepasste Eigenschaft einen Wert im Feld Wert angeben. Wenn Sie keinen Wert angeben, wird eine Fehlernachricht zurückgegeben.
  • Wenn Sie über die Befehlszeile einen Leerwert an die Eigenschaft übergeben, wird dieser Wert als ungültiger Wert betrachtet, und das Standardverhalten des Node Agent tritt wieder in Kraft.
gotcha

Diese Eigenschaft ist standardmäßig nicht angegeben. Wenn Sie diese angepasste Eigenschaft verwenden möchten, müssen Sie sie als angepasste JVM-Eigenschaft des Node Agent angeben.

[z/OS]

was.xcfmonitor.enabled

Verwenden Sie diese Eigenschaft, um die Verwendung von z/OS Cross-System Coupling Facility (XCF) für die Überwachung des Anwendungsserverstatus zu aktivieren. Wenn diese Eigenschaft auf true gesetzt ist, können Node Agents XCF verwenden, um ihre Anwendungsserver zu überwachen. Anwendungsserver können XCF verwenden, um ihre Node Agents zu überwachen, und ein Verwaltungsagentenserver kann XCF verwenden, um seine registrierten Anwendungsserver zu überwachen. Hat diese Eigenschaft den Wert false, wird die TCP/IP-Methode "Ping" verwendet, um den Status von Anwendungsserver und Node Agent zu überwachen.

Der Standardwert ist false.

webservices.unify.faults

Verwenden Sie die Eigenschaft webservices.unify.faults, um die Vereinheitlichung von SOAP-Fehlern für JAX-WS und JAX-RPC zu aktivieren. Standardmäßig vereinheitlichen die Web-Service-Laufzeitumgebungen (JAX-WS und JAX-RPC) alle Fehler, die von der Laufzeitumgebung generiert werden, zu einem einzigen Fehlertyp, der den Fehlercode (faultcode) Server und die Fehlerzeichenfolge (faultstring) "Interner Fehler" (Internal Error) hat. Die Fehler enthalten keine weiteren Informationen zur eigentlichen Fehlerursache. Die Vereinheitlichung der Fehler führt zu einem System mit mehr Sicherheit, weil verhindert wird, dass detaillierte Informationen zum Scheitern der Verarbeitung eingehender Nachrichten an die Nachrichtensendet zurückgegeben werden.

Der Standardwert für diese Eigenschaft ist true, der bewirkt, dass Fehler vereinheitlicht werden. Wenn Ihre Anwendungen Fehlerdetails benötigen, können Sie diese Eigenschaft auf false setzen, um die Fehlervereinheitlichung zu inaktivieren und somit zuzulassen, dass detaillierte Informationen in Fehlern zurückgegeben werden. Unabhängig von der Einstellung der Eigenschaft gilt, dass geprüfte Ausnahmen, die in der WSDL definiert sind und von der Implementierung einer Service-Provider-Methode ausgelöst werden, nicht vereinheitlicht werden. Außerdem werden unabhängig von der Einstellung dieser Eigenschaft detaillierte Informationen zur Fehlerursache protokolliert, wenn die Traceerstellung aktiviert ist.

wink.client.readTimeout

Verwenden Sie diese Eigenschaft, um festzulegen, wie lange (in Millisekunden) das RestClient-Objekt auf eine Antwort auf Anforderungen wartet, bevor eine Zeitlimitüberschreitung ausgelöst wird. Der Wert null (0) bedeutet, dass der Client unbegrenzt wartet und keine Zeitlimitüberschreitung ausgelöst wird.

Der Standardwert ist 60.000 Millisekunden.

wink.client.connectTimeout

Verwenden Sie diese Eigenschaft, um festzulegen, wie lange (in Millisekunden) das RestClient-Objekt auf die Herstellung einer Verbindung zu einer Zielressource wartet, bevor eine Zeitlimitüberschreitung ausgelöst wird. Der Wert null (0) bedeutet, dass der Client unbegrenzt wartet und keine Zeitlimitüberschreitung ausgelöst wird.

Der Standardwert ist 60.000 Millisekunden.


Symbol, das den Typ des Artikels anzeigt. Referenzartikel



Symbol für Zeitmarke Letzte Aktualisierung: 25.05.2016
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=xrun_jvm
Dateiname:xrun_jvm.html