Właściwości niestandardowe usługi nasłuchiwania komunikatów.

Ten panel umożliwia przeglądanie i zmianę właściwości niestandardowych usługi nasłuchiwania komunikatów.

Aby wyświetlić tę stronę Konsoli administracyjnej, kliknij opcję Serwery > Typy serwerów > Serwery aplikacji WebSphere > nazwa_serwera > [Komunikacja] Przesyłanie komunikatów > Usługa nasłuchiwania komunikatów > Właściwości niestandardowe

Na stronie Właściwości niestandardowe można zdefiniować następujące właściwości, które będą używane przez usługę nasłuchiwania komunikatów.
DYNAMIC.CONFIGURATION.ENABLED

Ta właściwość określa, czy serwer aplikacji, w którym został utworzony port nasłuchiwania, wymaga ponownego uruchomienia. Ustaw tę właściwość na wartość true, aby włączyć dynamiczną konfigurację.

Typ danych Boolean
Wartość domyślna False (niezaznaczona)
MAX.RECOVERY.RETRIES

Maksymalna liczba prób odzyskiwania komunikatu po niepowodzeniu, podejmowanych przez port nasłuchiwania zarządzany za pomocą danej usługi, przed porzuceniem prób i zatrzymaniem nasłuchiwania. Po zatrzymaniu powiązanego portu nasłuchiwania jego stan zmienia się na stan zatrzymania. Odstęp czasu między ponownymi próbami jest zdefiniowany we właściwości RECOVERY.RETRY.INTERVAL.

Niepowodzenie może być spowodowane dowolnym z następujących warunków:
  • Wystąpił nieoczekiwany błąd przy próbie otrzymania komunikatu od dostawcy JMS przez port nasłuchiwania.
  • Utracono połączenie między serwerem aplikacji a dostawcą usług JMS, zwykle wskutek błędu sieci.
Typ danych Integer
Jednostki Liczba ponownych prób
Wartość domyślna 5
Zakres Od 0 (bez ponawiania) do 2147483647
MQJMS.POOLING.THRESHOLD

Maksymalna liczba nieużywanych połączeń w puli.

Menedżer połączeń MQSimpleConnectionManager przydziela zasoby w kolejności według ostatniego używania i niszczy zasoby w kolejności według najdłuższego czasu nieużywania. Połączenia są niszczone domyślnie, kiedy liczba nieużywanych połączeń w puli przekracza dziesięć.

Typ danych Integer
Jednostki Liczba połączeń
Wartość domyślna 10
MQJMS.POOLING.TIMEOUT

Liczba milisekund, po której nieużywane połączenie w puli zostaje zniszczone.

Menedżer połączeń MQSimpleConnectionManager przydziela zasoby w kolejności według ostatniego używania i niszczy zasoby w kolejności według najdłuższego czasu nieużywania. Połączenia są niszczone domyślnie po pięciominutowym czasie nieużywania.

Typ danych Integer
Jednostki Milisekundy
Wartość domyślna 5 minut
NON.ASF.RECEIVE.TIMEOUT

Limit czasu w milisekundach dla odbierania komunikatów synchronicznych przez sesje nasłuchiwania komponentu bean sterowanego komunikatami w trybie operacji bez ASF.

Uwaga: Usługa nasłuchiwania komunikatów ma dwa tryby wykonywania operacji: tryb ASF (z narzędziami Application Server Facilities) i tryb bez ASF (baz narzędzi Application Server Facilities):
  • Tryb ASF zapewnia współbieżność i obsługę transakcyjną aplikacji. W przypadku komponentów bean publikowania/subskrypcji sterowanych komunikatami tryb ASF zapewnia większą przepustowość i współbieżność, natomiast w trybie bez ASF nasłuchiwanie odbywa się jednowątkowo.
  • Tryb bez ASF jest przeznaczony głównie do stosowania z dostawcami usług przesyłania komunikatów innych firm, którzy nie obsługują narzędzi ASF usług JMS. Narzędzia te stanowią opcjonalne rozszerzenie dla specyfikacji JMS. Tryb bez ASF jest również transakcyjny, ale ze względu na krótszą ścieżkę niż w przypadku trybu ASF jest zwykle bardziej wydajny.

Aby włączyć tryb działania bez narzędzi ASF dla wszystkich obiektów nasłuchiwania komponentów bean sterowanych komunikatami na serwerze aplikacji, należy ustawić dla tej właściwości wartość różną od 0.

[z/OS] Trybu bez narzędzi ASF nie można wybrać w systemach z/OS, dlatego w ich przypadku nie należy wprowadzać wartości różnej od 0.

Typ danych Integer
Jednostki Milisekundy
Wartość domyślna Tryb ASF (bez utworzenia właściwości niestandardowej)
Zakres 0 lub więcej milisekund
0
Wyłączony tryb bez narzędzia ASF
1 lub więcej
Limit czasu w milisekundach dla nasłuchiwania komponentu bean sterowanego komunikatami bez ASF, odbieranego przez sesje synchroniczne.
Zalecane W przypadku przekroczenia limitu czasu komunikat jest powtórnie przetwarzany, co zwiększa nakłady pracy. Jeśli jest używany tryb bez narzędzi ASF, należy ustawić właściwość na wartość mniejszą niż limit czasu transakcji, ale równą lub większą niż wartość maksymalnego czasu trwania metody onMessage() komponentu bean sterowanego komunikatami. Na przykład jeśli wykonanie metody onMessage() komponentu bean sterowanego komunikatami zajmuje zwykle maksymalnie 10 sekund, a limit czasu transakcji jest ustawiony na 120 sekund, właściwość NON.ASF.RECEIVE.TIMEOUT powinna być ustawiona na nie więcej niż 110 000 milisekund (to znaczy 110 sekund).
NON.ASF.BMT.ROLLBACK.ENABLED

Jeśli jest używany tryb działania bez narzędzi ASF (Application Server Facilities) - w wyniku ustawienia różnej od zera wartości właściwości NON.ASF.RECEIVE.TIMEOUT - a komponent bean sterowany komunikatami korzystający z transakcji zarządzanych przez komponent bean wygeneruje wyjątek czasu wykonywania, właściwość NON.ASF.BMT.ROLLBACK.ENABLED określa, czy komunikaty zostaną zwrócone do miejsca docelowego.

Uwaga: Usługa nasłuchiwania komunikatów ma dwa tryby wykonywania operacji: tryb ASF (z narzędziami Application Server Facilities) i tryb bez ASF (baz narzędzi Application Server Facilities):
  • Tryb ASF zapewnia współbieżność i obsługę transakcyjną aplikacji. W przypadku komponentów bean publikowania/subskrypcji sterowanych komunikatami tryb ASF zapewnia większą przepustowość i współbieżność, natomiast w trybie bez ASF nasłuchiwanie odbywa się jednowątkowo.
  • Tryb bez ASF jest przeznaczony głównie do stosowania z dostawcami usług przesyłania komunikatów innych firm, którzy nie obsługują narzędzi ASF usług JMS. Narzędzia te stanowią opcjonalne rozszerzenie dla specyfikacji JMS. Tryb bez ASF jest również transakcyjny, ale ze względu na krótszą ścieżkę niż w przypadku trybu ASF jest zwykle bardziej wydajny.

[z/OS] Trybu bez ASF nie można wybrać w systemach z/OS.

Jeśli ta właściwość ma wartość false (wartość domyślna), komunikat jest automatycznie potwierdzany przed przekazaniem do komponentu bean sterowanego komunikatami.

Jeśli ta właściwość ma wartość true, usługa nasłuchiwania komunikatów wysyła potwierdzenie komunikatu do klienta po pomyślnym przetworzeniu komunikatu przez komponent bean sterowany komunikatami i żąda odzyskania każdego komunikatu, dla którego komponent bean generuje wyjątek.

Typ danych Boolean
Wartość domyślna False
RECOVERY.RETRY.INTERVAL

Odstęp czasu podany w sekundach między kolejnymi próbami odzyskania komunikatów podejmowanymi przez port nasłuchiwania. Maksymalna liczba ponawianych prób jest zdefiniowana we właściwości MAX.RECOVERY.RETRIES.

Niepowodzenie może być spowodowane dowolnym z następujących warunków:
  • Wystąpił nieoczekiwany błąd przy próbie otrzymania komunikatu od dostawcy JMS przez port nasłuchiwania.
  • Utracono połączenie między serwerem aplikacji a dostawcą usług JMS, zwykle wskutek błędu sieci.
Typ danych Integer
Jednostki Sekundy
Wartość domyślna 60
Zakres Od 1 do 2147483647
SERVER.SESSION.POOL.REAP.TIME

Czas (w sekundach) między sprawdzeniami dotyczącymi puli sesji serwera. Aby włączyć monitorowanie puli sesji serwera, należy ustawić tę właściwość na wartość nieujemną.

Typ danych Integer
Jednostki Sekundy
Wartość domyślna -1 (wyłączone)
Zakres Od -2147483648 do 2147483647
SERVER.SESSION.POOL.UNUSED.TIMEOUT

Domyślny limit czasu puli serwera w sekundach.

Jeśli ta właściwość ma ustawioną wartość nieujemną, jest ona porównywana z czasem, który upłynął od momentu użycia sesji serwera. Jeśli wartość limitu czasu jest mniejsza niż czas, który upłynął, sesja serwera zostanie usunięta z puli sesji serwera, a sesja JMS zostanie zwrócona do puli sesji JMS. Na przykład jeśli wartość limitu czasu wynosi jedną sekundę, a czas, który upłynął od użycia określonej sesji serwera - dwie sekundy, ta sesja serwera zostanie usunięta z puli sesji serwera, a sesja JMS zostanie zwrócona do puli sesji JMS.

Typ danych Integer
Jednostki Sekundy
Wartość domyślna -1 (wyłączone)
Zakres Od -2147483648 do 2147483647
SERVER.SESSION.POOL.UNUSED.TIMEOUT.nazwa_portu_nasłuchiwania

Ta właściwość przesłania domyślną wartość SERVER.SESSION.POOL.UNUSED.TIMEOUT dla portu nasłuchiwania o nazwie nazwa_portu_nasłuchiwania. Ta wartość obowiązuje dla wszystkich komponentów bean sterowanych komunikatami, które korzystają z określonego portu nasłuchiwania.

Jeśli wartość zastępująca jest nieujemna, przesłania ona właściwość SERVER.SESSION.POOL.UNUSED.TIMEOUT, nawet jeśli właściwość SERVER.SESSION.POOL.UNUSED.TIMEOUT ma wartość ujemną.

Jeśli wartość zastępująca jest ujemna, powoduje ona wyłączenie monitorowania puli sesji serwera dla określonego portu nasłuchiwania.

Typ danych Integer
Jednostki Sekundy
Wartość domyślna Nieustawiona
Zakres Od -2147483648 do 2147483647



Zaznaczone odsyłacze (online) wymagają dostępu do Internetu.

Zadania pokrewne
Odsyłacze pokrewne


Nazwa pliku: umb_prolscp.html