Ta strona umożliwia konfigurowanie obiektowego brokera zapytań Java (ORB).
Do sterowania wewnętrznym przetwarzaniem przez obiektowego brokera zapytań (ORB) dostępnych jest wiele ustawień. Ustawień tych można użyć w celu zwiększenia wydajności w przypadku aplikacji zawierającej komponenty EJB. Istnieje możliwość zmiany tych ustawień dla domyślnego serwera lub dowolnego serwera aplikacji skonfigurowanego w domenie administracyjnej.
Określa czas w sekundach, który musi upłynąć, zanim zostanie przekroczony limit czasu żądania.
Przy korzystaniu ze skryptu w wierszu komend, pełna nazwa tej właściwości systemu to com.ibm.CORBA.RequestTimeout.
Typ danych | int |
Jednostki | Sekundy |
Wartość domyślna | 180 |
Zakres | Od 0 do największej liczby całkowitej rozpoznawanej przez język Java |
Określa liczbę prób wysłania żądania przez brokera ORB, jeśli serwer nie reaguje. Ponowne wysłanie żądania pozwala czasami uniknąć konsekwencji przejściowych awarii sieci. Pole to jest ignorowane w systemie z/OS.
Przy korzystaniu ze skryptu w wierszu komend pełna nazwa tej właściwości systemu to com.ibm.CORBA.requestRetriesCount.
Typ danych | int |
Wartość domyślna | 1 |
Zakres | Od 1 do 10 |
Określa liczbę milisekund między ponownymi próbami wysłania żądania. Pole to jest ignorowane w systemie z/OS.
Przy korzystaniu ze skryptu w wierszu komend pełna nazwa tej właściwości systemu to com.ibm.CORBA.requestRetriesDelay.
Typ danych | int |
Jednostki | Milisekundy |
Wartość domyślna | 0 |
Zakres | Od 0 do 60 000 |
Określa maksymalną liczbę pozycji, które mogą zajmować pamięć podręczną połączeń ORB, zanim broker ORB zacznie usuwać nieaktywne połączenia z pamięci podręcznej. Pole to jest ignorowane w systemie z/OS.
Może się zdarzyć, że liczba aktywnych połączeń w pamięci podręcznej chwilowo przekroczy wartość progową. Jeśli to konieczne, broker ORB będzie wciąż dodawał połączenia, dopóki tylko są dostępne zasoby.
Przy korzystaniu ze skryptu w wierszu komend, pełna nazwa tej właściwości systemu to com.ibm.CORBA.MaxOpenConnections.
Typ danych | Integer |
Jednostki | Połączenia |
Wartość domyślna | 240 |
Zakres | Od 10 do największej liczby całkowitej rozpoznawanej przez język Java |
Określa minimalną liczbę pozycji w podręcznej pamięci połączeń brokera ORB. Pole to jest ignorowane w systemie z/OS.
Broker ORB nie usunie nieaktywnych połączeń, jeśli liczba pozycji jest mniejsza od tej wartości.
Przy korzystaniu ze skryptu w wierszu komend, pełna nazwa tej właściwości systemu to com.ibm.CORBA.MinOpenConnections.
Typ danych | Integer |
Jednostki | Połączenia |
Wartość domyślna | 100 |
Zakres | Dowolna liczba całkowita, która jest mniejsza co najmniej o 5 od wartości określonej we właściwości maksymalnej pamięci podręcznej połączeń. |
Umożliwia śledzenie komunikatów brokera ORB zgodnych z protokołem GIOP (General Inter-ORB Protocol).
Ustawienie to ma wpływ na dwie właściwości systemu: com.ibm.CORBA.Debug oraz com.ibm.CORBA.CommTrace. Ustawiając te właściwości za pomocą skryptu w wierszu komend, obie wartości należy ustawić na true w celu włączenia śledzenia komunikatów GIOP.
Typ danych | Boolean |
Wartość domyślna | Niewłączona (fałsz) |
Określa czas w sekundach, który musi upłynąć, zanim zostanie przekroczony limit czasu żądania znalezienia. Pole to jest ignorowane w systemie z/OS.
Przy korzystaniu ze skryptu w wierszu komend pełna nazwa tej właściwości systemu to com.ibm.CORBA.LocateRequestTimeout.
Typ danych | int |
Jednostki | Sekundy |
Wartość domyślna | 180 |
Zakres | Od 0 do 300 |
Określa sposób korzystania z usługi tunelowania HTTP przez brokera ORB klienta. Pole to jest ignorowane w systemie z/OS.
Przy korzystaniu ze skryptu w wierszu komend pełna nazwa tej właściwości systemu to com.ibm.CORBA.ForceTunnel.
Typ danych | String |
Wartość domyślna | NEVER (NIGDY) |
Zakres | Poprawne wartości to ALWAYS (ZAWSZE), NEVER (NIGDY), lub WHENREQUIRED (GDY TO KONIECZNE). |
Określa adres WWW serwletu do użycia w przypadku obsługi tunelowania HTTP. Pole to jest ignorowane na platformie z/OS platform.
Adres WWW musi mieć prawidłowy format:
http://w3.moja_firma.com:81/serwlet/com.ibm.CORBA.services.IIOPTunnelServlet
Dla apletów: http://host_apletu:port/serwlet/com.ibm.CORBA.services.IIOPTunnelServlet.
To pole jest wymagane przy ustawionym tunelowaniu HTTP. Przy korzystaniu ze skryptu w wierszu komend pełna nazwa tej właściwości systemu to com.ibm.CORBA.TunnelAgentURL.
Określa sposób przekazywania parametrów przez brokera ORB. Jeśli opcja jest włączona, broker ORB przekazuje parametry przez odwołanie zamiast przez wartość, tak aby uniknąć tworzenia kopii obiektu. Jeśli opcja przekazywania przez odwołanie nie zostanie włączona, przekazana zostanie kopia parametru, zamiast samego obiektu parametru. Może to oznaczać duże nakłady, gdyż broker ORB musi najpierw wykonać kopię każdego z obiektów parametru.
Opcji tej można użyć tylko wtedy, gdy klient komponentu EJB oraz komponent EJB znajdują się w tym samym programie ładującym klasy. Wymaganie to oznacza, że klient komponentu EJB i komponent EJB muszą być wdrażane w tym samym pliku EAR.
Jeśli klient i serwer komponentu EJB są zainstalowane w tej samej instancji produktu, a klient i serwer korzystają ze zdalnych interfejsów, włączenie opcji przekazywania przez referencję może zwiększyć wydajność nawet o 50%. Opcja przesyłania przez odwołanie pomaga zwiększyć wydajność tylko wtedy, gdy jako parametry przesyłane są nieprymitywne typy obiektów. Z tego powodu parametry typu int i float są kopiowane zawsze, niezależnie od modelu wywołania.
Przy korzystaniu ze skryptu w wierszu komend, pełna nazwa tej właściwości systemu to com.ibm.CORBA.noLocalCopies.
Typ danych | Boolean |
Wartość domyślna | Niewłączona (fałsz) |
Użycie tej opcji dla komponentów EJB z interfejsami zdalnymi jest niezgodne ze specyfikacją komponentów EJB 2.0 (patrz sekcja 5.4). Referencje obiektów przesyłane do metod EJB lub do metod podstawowych EJB nie są kopiowane i są podatne na uszkodzenie.
Iterator iterator = collection.iterator(); MyPrimaryKey pk = new MyPrimaryKey(); while (iterator.hasNext()) { pk.id = (String) iterator.next(); MyEJB myEJB = myEJBHome.findByPrimaryKey(pk); }
W przykładzie tym odwołanie do tego samego obiektu MyPrimaryKey przechodzi do produktu za każdym razem z inną wartością identyfikatora. Uruchomienie tego kodu z włączoną opcją przekazywania przez odwołanie powoduje problem w obrębie serwera aplikacji, ponieważ wiele komponentów EJB odwołuje się do tego samego obiektu MyPrimaryKey. Aby uniknąć tego problemu, należy ustawić właściwość systemową com.ibm.websphere.ejbcontainer.allowPrimaryKeyMutation na true, jeśli opcja przekazywania przez odwołanie jest włączona. Ustawienie true opcji przekazywania przez odwołanie sprawia, że kontener EJB tworzy lokalną kopię obiektu PrimaryKey. Skutkiem tego jest jednak utrata niewielkiej części zysku na wydajności uzyskiwanego dzięki opcji przekazywania przez odwołanie.
Jest ogólną zasadą, że dowolny kod aplikacji przekazujący odwołanie obiektu jako parametr do metody komponentu EJB lub do głównej metody EJB musi odbywać się pod nadzorem w celu określenia, czy przekazanie odwołania tego obiektu nie skutkuje utraceniem spójności danych albo innymi problemami.
Po sprawdzeniu kodu istnieje możliwość włączenia opcji przekazania przez odwołanie przez ustawienie właściwości systemowej com.ibm.CORBA.iiop.noLocalCopies na true. Opcję przekazywania przez odwołanie można również włączyć za pomocą Konsoli administracyjnej. W tym celu kliknij opcję Serwery > Typy serwerów > Serwery aplikacji > nazwa_serwera > Usługi kontenera > Usługa ORB i wybierz pozycję Przekaż przez referencję.
Zaznaczone odsyłacze (online) wymagają dostępu do Internetu.