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

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ę.

Ta właściwość steruje zachowaniem portu nasłuchiwania podczas nawiązywania połączenia przez serwer aplikacji z produktem WebSphere MQ for z/OS.

Po dodaniu właściwości należy zrestartować serwer.

Jeśli połączenie z produktem WebSphere MQ for z/OS jest nawiązywane za pośrednictwem połączeń powiązań, należy również zastosować poprawkę APAR PK53912 produktu WebSphere MQ dostarczaną w produkcie WebSphere MQ 6.0.2.4.

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.

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ęć.

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.

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

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.

Trybu działania 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 dla tej właściwości.

Jeśli system przesyłania komunikatów jest uruchomiony w trybie bez ASF, w celu uniknięcia niepożądanych przekroczeń limitu czasu transakcji należy zapewnić wystarczającą ilość czasu na potrzeby przetwarzania, aby zakończyć je przed przekroczeniem łącznego limitu czasu życia transakcji. Dlatego należy sprawdzić, czy wartość podana dla właściwości niestandardowej usługi nasłuchiwania komunikatów NON.ASF.RECEIVE.TIMEOUT jest mniejsza niż wartość określona dla właściwości usługi transakcji Łączny limit czasu życia transakcji, a także, czy różnica między wartościami obu właściwości jest większa od ilości czasu, jaką zabiera przetworzenie komunikatu przez metodę onMessage() komponentu bean sterowanego komunikatami (message-driven bean - MDB).

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).

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.

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.

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.

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ą.

Właściwość niestandardowa SERVER.SESSION.POOL.REAP.TIME nie ma zastosowania, jeśli system przesyłania komunikatów został uruchomiony w trybie bez ASF.

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.

Właściwość niestandardowa SERVER.SESSION.POOL.UNUSED.TIMEOUT nie ma zastosowania, jeśli system przesyłania komunikatów został uruchomiony w trybie bez ASF.

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.

Właściwość niestandardowa SERVER.SESSION.POOL.UNUSED.TIMEOUT.lpname nie ma zastosowania, jeśli system przesyłania komunikatów został uruchomiony w trybie bez ASF.