Einstellungen für ORB-Service

Auf dieser Seite können Sie den Java-ORB-Service (Object Request Broker) konfigurieren.

Gehen Sie zum Anzeigen dieser Seite der Administrationskonsole wie folgt vor:

Für die Steuerung der internen ORB-Verarbeitung sind mehrere Einstellungen verfügbar. Sie können diese Einstellungen verwenden, um die Leistung von Anwendungen zu verbessern, die Enterprise-Beans enthalten. Sie können diese Einstellungen für den Standardserver und jeden anderen Anwendungsserver ändern, der in der Administrationskonsole konfiguriert ist.

Zeitlimit für Anforderung

Die Wartezeit in Sekunden, nach der eine Zeitlimitüberschreitung für eine Anforderungsnachricht eintritt.

Wenn Sie Befehlszeilen-Scripting verwenden, müssen Sie den vollständigen Namen dieser Systemeigenschaft verwenden: com.ibm.CORBA.RequestTimeout.

Datentyp int
Einheiten Sekunden
Standardeinstellung 180
Einstellmöglichkeiten 0 - größte von Java erkannte ganze Zahl mit erweiterter Genauigkeit
Anzahl der Anforderungswiederholungen [AIX Solaris HP-UX Linux Windows] [iSeries]

Dieser Wert gibt an, wie oft der ORB versucht, eine Anforderung zu senden, wenn der Server ausfällt. Eine Wiederholung dieses Vorgangs ermöglicht die Fehlerbehebung in temporären Netzen. Dieses Feld wird für z/OS ignoriert.

Wenn Sie Befehlszeilen-Scripting verwenden, müssen Sie den vollständigen Namen diese Systemeigenschaft verwenden: com.ibm.CORBA.requestRetriesCount.

Datentyp int
Standardeinstellung 1
Einstellmöglichkeiten 1 bis 10
Verzögerung zwischen Anforderungswiederholungen [AIX Solaris HP-UX Linux Windows] [iSeries]

Das Zeitintervall zwischen Anforderungswiederholungen (in Millisekunden). Dieses Feld wird für z/OS ignoriert.

Wenn Sie Befehlszeilen-Scripting verwenden, müssen Sie den vollständigen Namen dieser Systemeigenschaft verwenden: com.ibm.CORBA.requestRetriesDelay.

Datentyp int
Einheiten Millisekunden
Standardeinstellung 0
Einstellmöglichkeiten 0 bis 60.000
Maximalgröße des Verbindungscache [AIX Solaris HP-UX Linux Windows] [iSeries]

Gibt die maximale Anzahl der Einträge an, die in den ORB-Verbindungscache aufgenommen werden können, bevor der ORB damit beginnt, inaktive Verbindungen aus dem Cache zu entfernen. Dieses Feld wird für z/OS ignoriert.

Es ist möglich, dass die Anzahl aktiver Verbindungen im Cache diesen Schwellenwert vorübergehend überschreitet. Sofern erforderlich, fügt der ORB so lange weitere Verbindungen hinzu, wie Ressourcen verfügbar sind.

Für die Verwendung im Befehlszeilen-Scripting müssen Sie den vollständigen Namen dieser Systemeigenschaft verwenden: com.ibm.CORBA.MaxOpenConnections.

Datentyp Integer
Einheiten Verbindungen
Standardeinstellung 240
Einstellmöglichkeiten 10 - größte von Java erkannte ganze Zahl
Mindestgröße des Verbindungscache [AIX Solaris HP-UX Linux Windows] [iSeries]

Gibt die Mindestanzahl der Einträge für den ORB-Verbindungscache an. Dieses Feld wird für z/OS ignoriert.

Der ORB entfernt keine inaktiven Verbindungen, solange die Anzahl der Einträge unter diesem Wert liegt.

Wenn Sie ein Script in der Befehlszeile verwenden möchten, müssen Sie den vollständigen Namen dieser Systemeigenschaft eingeben: com.ibm.CORBA.MinOpenConnections.

Datentyp Integer
Einheiten Verbindungen
Standardeinstellung 100
Einstellmöglichkeiten Jede ganze Zahl, die um mindestens 5 kleiner ist als der Wert, der für die maximale Anzahl der Verbindungen im Cache definiert ist.
ORB-Tracing

Trace für ORB-GIOP-Nachrichten (General Inter-ORB Protocol) aktivieren.

Diese Einstellung betrifft zwei Systemeigenschaften: com.ibm.CORBA.Debug und com.ibm.CORBA.CommTrace. Wenn Sie diese Eigenschaften mit einem Script über die Befehlszeile definieren, müssen Sie beide Eigenschaften auf true setzen, um das Tracing von GIOP-Nachrichten zu aktivieren.

Datentyp Boolean
Standardeinstellung Nicht aktiviert (false)
Zeitlimit für Anforderung lokalisieren [AIX Solaris HP-UX Linux Windows] [iSeries]

Die Wartezeit in Sekunden, nach der eine Nachricht hinsichtlich der Zeitlimitüberschreitung für das Lokalisieren einer Anforderung (LocateRequest) ausgegeben wird. Dieses Feld wird für z/OS ignoriert.

Wenn Sie Befehlszeilen-Scripting verwenden, müssen Sie den vollständigen Namen dieser Systemeigenschaft verwenden: com.ibm.CORBA.LocateRequestTimeout.

Datentyp int
Einheiten Sekunden
Standardeinstellung 180
Einstellmöglichkeiten 0 bis 300
Tunnelung erzwingen [AIX Solaris HP-UX Linux Windows] [iSeries]

Legt fest, wie der Client-ORB versucht, die HTTP-Tunnelung zu verwenden. Dieses Feld wird für z/OS ignoriert.

Wenn Sie Befehlszeilen-Scripting verwenden, müssen Sie den vollständigen Namen dieser Systemeigenschaft verwenden: com.ibm.CORBA.ForceTunnel.

Datentyp String
Standardeinstellung Nie
Einstellmöglichkeiten Die gültigen Werte sind Immer, Nie und Bei Bedarf.
Berücksichtigen Sie bei der Auswahl des Wertes die folgenden Informationen:
IMMER
HTTP-Tunnelung wird sofort verwendet. Es werden keine TCP-Verbindungen verwendet.
NIE
HTTP-Tunnelung wird inaktiviert. Wenn eine TCP-Verbindung fehlschlägt, wird eine Ausnahme des CORBA-Systems (COMM_FAILURE) ausgelöst.
BEI BEDARF
Die HTTP-Tunnelung wird verwendet, wenn TCP-Verbindungen fehlschlagen.
URL des Tunnel Agent [AIX Solaris HP-UX Linux Windows] [iSeries]

Gibt die Webadresse des für HTTP-Tunnelung zu verwendenden Servlet an. Dieses Feld wird auf der Plattform z/OS ignoriert.

Diese Webadresse muss das richtige Format haben:

http://w3.mycorp.com:81/servlet/com.ibm.CORBA.services.IIOPTunnelServlet

Für Applets: http://applethost:port/servlet/com.ibm.CORBA.services.IIOPTunnelServlet.

Dieses Feld muss ausgefüllt werden, wenn HTTP-Tunnelung ausgewählt ist. Wenn Sie Befehlszeilen-Scripting verwenden, müssen Sie den vollständigen Namen dieser Systemeigenschaft verwenden: com.ibm.CORBA.TunnelAgentURL.

Durch Referenz übergeben

Gibt an, wie der ORB die Parameter übergibt. Wenn dieser Parameter definiert ist, übergibt der ORB Parameter durch eine Referenz (Passed-by-Reference) und nicht mit einem Wert. Hierbei wird keine Kopie eines Objekts erstellt. Falls Sie diesen Parameter nicht definieren, wird anstelle des Parameterobjekts selbst eine Kopie des Parameters übergeben. Dies kann kostenintensiv werden, weil der ORB von jedem Parameterobjekt zuerst eine Kopie erstellen muss.

Sie können diese Option nur verwenden, wenn der EJB-Client (Enterprise JavaBeans) und die EJB in demselben Klassenlader enthalten sind. Der EJB-Client und die EJB müssen also in derselben EAR-Datei implementiert sein.

Wenn EJB-Client und EJB-Server in derselben Instanz des Produkts installiert sind und beide ferne Schnittstellen verwenden, kann durch die Auswahl der Option "Durch Referenz übergeben" (Pass-by-Reference) eine Durchsatzsteigerung von bis zu 50 % erzielt werden. Mit dieser Einstellung kann nur dann eine Leistungssteigerung erzielt werden, wenn nicht primitive Objekttypen als Parameter übergeben werden. Demzufolge werden int und floats unabhängig vom Aufrufmodell immer kopiert.

Fehler vermeiden: Verwenden Sie diese Eigenschaft mit Bedacht, da unerwartete Ergebnisse eintreten können. Sollte eine Objektreferenz vom Aufgerufenen geändert werden, wird auch das Objekt des Aufrufenden geändert, weil es sich um dasselbe Objekt handelt. gotcha

Wenn Sie Befehlszeilen-Scripting verwenden, müssen Sie den vollständigen Namen dieser Systemeigenschaft verwenden: com.ibm.CORBA.iiop.noLocalCopies.

Datentyp Boolean
Standardeinstellung Nicht aktiviert (false)

Die Verwendung dieser Option für Enterprise-Beans mit Remote-Schnittstellen verstößt gegen die EJB-Spezifikation Version 2.0 (siehe Abschnitt 5.4). An EJB-Methoden oder EJB-Home-Methoden übergebene Objektreferenzen werden nicht kopiert und können deshalb beschädigt werden.

Sehen Sie sich dazu das folgende Beispiel an:
Iterator iterator = collection.iterator();
MyPrimaryKey pk = new MyPrimaryKey();
while (iterator.hasNext()) {
   pk.id = (String) iterator.next();
   MyEJB myEJB = myEJBHome.findByPrimaryKey(pk);
}

Im vorherigen Beispiel wird zwei Mal eine Referenz auf dasselbe MyPrimaryKey-Objekt an das Produkt übergeben, jedes Mal mit einer anderen ID. Wenn Sie diesen Code ausführen und die Einstellung "Durch Referenz übergeben" aktiviert ist, löst dies einen Fehler des Anwendungsservers aus, weil mehrere Enterprise-Beans auf dasselbe MyPrimaryKey-Objekt verweisen. Sie können diesen Fehler vermeiden, indem Sie die Systemeigenschaft "com.ibm.websphere.ejbcontainer.allowPrimaryKeyMutation" auf true setzen, wenn die Option "Durch Referenz übergeben" aktiviert ist. In diesem Fall erstellt der EJB-Container nämlich eine lokale Kopie des Objekts "PrimaryKey". Durch das Setzen der Eigenschaft "Übergeben durch Referenz" sind jedoch geringfügige Leistungseinbußen zu verzeichnen.

Es gilt die folgende allgemeine Regel: Jeder Anwendungscode, der eine Objektreferenz als Parameter an eine Methode einer Enterprise-Bean oder an eine Home-Methode einer EJB übergibt, muss unbedingt daraufhin untersucht werden, ob die Objektreferenz zu einem Verlust der Datenintegrität oder zu anderen Fehlern führen könnte.

Nach der Überprüfung Ihres Codes können Sie die Option "Durch Referenz übergeben" aktivieren, indem Sie die Systemeigenschaft "com.ibm.CORBA.iiop.noLocalCopies" auf true setzen. Sie können die Option "Durch Referenz übergeben" auch in der Administrationskonsole aktivieren. Klicken Sie auf Server > Servertypen > Anwendungsserver > Servername > Containerservices > ORB-Service , und wählen Sie Nach Referenz übergeben aus.




Mit (online) gekennzeichnete Links setzen einen Internet-Zugang voraus.

Zugehörige Tasks
Zugehörige Verweise
[AIX Solaris HP-UX Linux Windows] [iSeries] Thread-Pool-Einstellungen
[AIX Solaris HP-UX Linux Windows] [iSeries]
[AIX Solaris HP-UX Linux Windows] [iSeries]


Dateiname: uorb_rsetg.html