Ustawienia fabryki połączeń kolejki dostawcy WebSphere MQ Provider dla klienta aplikacji

Nazwa

Nazwa służąca do identyfikowania tej fabryki połączeń kolejki w celach administracyjnych na serwerze WebSphere Application Server. Nazwa ta musi być unikalna w obrębie fabryk połączeń JMS dla domeny administracyjnej produktu WebSphere.

Typ danych

Łańcuch

Opis

Opis fabryki połączeń używany w celach administracyjnych w obszarze produktu WebSphere Application Server.

Typ danych	Łańcuch
Wartość domyślna	NULL

Nazwa JNDI

Środowisko wykonawcze klienta aplikacji używa tego pola w celu pobrania informacji konfiguracyjnych.

ID użytkownika

Identyfikator użytkownika używany z właściwością Hasło w celu uwierzytelnienia, jeśli aplikacja wywołująca nie udostępni identyfikatora użytkownika oraz hasła w sposób jawny.

Po określeniu wartości dla właściwości Identyfikator użytkownika należy także określić wartość właściwości Hasło.

Właściwości ID użytkownika oraz Hasło fabryki połączeń są używane, jeśli aplikacja wywołująca nie udostępnia identyfikatora użytkownika i hasła w sposób jawny; na przykład wtedy, gdy aplikacja wywołująca korzysta z metody createQueueConnection(). Klient JMS przesyła identyfikator użytkownika oraz hasło do serwera JMS.

Typ danych

Łańcuch

Hasło

Hasło używane z właściwością Identyfikator użytkownika do uwierzytelnienia, jeśli aplikacja wywołująca nie udostępnia identyfikatora użytkownika oraz hasła w sposób jawny.

Po określeniu wartości dla właściwości Identyfikator użytkownika należy także określić wartość właściwości Hasło.

Typ danych	Łańcuch
Wartość domyślna	NULL

Wprowadź ponownie hasło

Potwierdzenie hasła.

Menedżer kolejek

Nazwa menedżera kolejek systemu WebSphere MQ dla danej fabryki połączeń.

Połączenia utworzone przez daną fabrykę łączą się z tym menedżerem kolejek.

Typ danych

Łańcuch

Wprowadź informacje o nazwie hosta i porcie

Ten przełącznik jest domyślnie wybrany. Jego wybranie powoduje włączenie właściwości nazwy hosta i portu oraz wyłączenie właściwości listy nazw połączeń.

Typ danych	Przełącznik
Wartość domyślna	Wybrane

Host

Nazwa hosta, na którym działa menedżer kolejek produktu WebSphere MQ (przeznaczona wyłącznie dla połączeń klientów).

Typ danych	Łańcuch
Wartość domyślna	NULL
Zakres	Poprawna nazwa hosta TCP/IP

Port

Numer portu TCP/IP używanego w celu nawiązywania połączenia z menedżerem kolejek produktu WebSphere MQ (przeznaczony tylko dla połączeń klienta).

Wymaga skonfigurowania portu w Menedżerze kolejek systemu WebSphere MQ.

Typ danych	Liczba całkowita
Wartość domyślna	NULL
Zakres	Poprawny numer portu TCP/IP skonfigurowany w menedżerze kolejek produktu WebSphere MQ.

Wprowadź informacje o liście nazw połączeń

Wybranie tego przełącznika powoduje włączenie właściwości listy nazw połączeń i wyłączenie właściwości nazwy hosta i portu. Wybierz ten przełącznik, aby nawiązać połączenie z menedżerem kolejek z wieloma instancjami.

Typ danych	Przełącznik
Wartość domyślna	Wyzerowane

Lista nazw połączeń

Lista rozdzielana przecinkami zawierająca informacje o hostach i portach, której można używać w celu nawiązania połączenia z menedżerem kolejek z wieloma instancjami.

Format listy to:

host[(port)],[host[(port)]]

gdzie port jest opcjonalny, a jego wartością domyślną w przypadku nieustawienia jest 1414. Na przykład:

nazwa_hosta_1,nazwa_hosta_2(1415)

Więcej informacji na temat używania menedżerów kolejek z wieloma instancjami zamieszczono w Centrum informacyjnym produktu WebSphere MQ.

Tej właściwości można używać tylko w celu nawiązania połączenia z menedżerem kolejek z wieloma instancjami. Nie można jej używać w celu nawiązania połączenia z listą odrębnych menedżerów kolejek, ponieważ może to spowodować problemy z integralnością transakcji.

Kanał

Nazwa kanału używanego w celu nawiązywania połączenia z menedżerem kolejek produktu WebSphere MQ (przeznaczona tylko dla połączeń klienta).

Typ danych	Łańcuch
Wartość domyślna	NULL
Zakres	Od 1 do 20 znaków ASCII

Typ transportu

Określa, czy połączenie klienta produktu WebSphere MQ lub wiązania JNDI są wykorzystywane do połączenia z menedżerem kolejek WebSphere MQ. Zewnętrzny dostawca JMS zarządza protokołami komunikacyjnymi między klientami JMS oraz serwerami JMS. Typ transportu należy dostroić w przypadku przesyłania nieciągłych, nietrwałych oraz nietransakcyjnych komunikatów typu innego niż ASF lub w celu spełnienia wymagań dotyczących bezpieczeństwa, gdy klient jest klientem lokalnym dla danego węzła menedżera kolejek.

Typ danych	Wyliczeniowy
Jednostki	Nie dotyczy
Wartość domyślna	BINDINGS (POWIĄZANIA)
Zakres	BINDINGS (POWIĄZANIA) Powiązania JNDI są używane do połączenia z menedżerem kolejek. POWIĄZANIA są protokołem pamięci współużytkowanej i mogą być używane tylko wtedy, gdy menedżer kolejek znajduje się na tym samym węźle, co klient JMS, i gdy stwarza on zagrożenie dla bezpieczeństwa, którym należy się zająć, używając ról EJB. KLIENT Połączenie systemu WebSphere MQ przez protokół klient jest przeznaczone do nawiązywania połączenia z Menedżerem kolejek. Protokół CLIENT (KLIENT) jest typowym protokołem opartym na TCP. BEZPOŚREDNI Dla produktu WebSphere MQ Event Broker, gdy używany jest tryb BEZPOŚREDNI. Tryb BEZPOŚREDNI jest uproszczonym protokołem gniazd używanym podczas nietransakcyjnego, nietrwałego i nieciągłego przesyłania komunikatów w trybie publikowania lub subskrypcji. Tryb BEZPOŚREDNI działa jedynie dla klientów i komponentów bean sterowanych komunikatami korzystających z protokołów innych niż ASF. QUEUED (W KOLEJCE) Protokół W KOLEJCE jest typowym protokołem opartym na TCP.
Zalecane	Typ transportu dla fabryki połączeń kolejki Protokół BINDINGS (POWIĄZANIA) zapewnia prędkość większą o co najmniej 30%, ale posiada słabsze zabezpieczenia. Z punktu widzenia zabezpieczeń protokół BINDINGS (KLIENT) jest lepszy od protokołu CLIENT (POWIĄZANIA). Typ transportu dla fabryki połączeń tematów Tryb BEZPOŚREDNI jest najszybszym typem transportu i powinien być używany wszędzie tam, gdzie jest to możliwe. Trybu POWIĄZANIA należy używać, gdy wymagane jest spełnienie dodatkowych wymagań bezpieczeństwa w przypadku menedżera kolejek lokalnego dla danego klienta JMS. Typ W KOLEJCE jest odpowiedni dla wszystkich innych przypadków. Produkt WebSphere MQ 5.3 bez pakietu poprawek CSD2 przy ustawieniu BEZPOŚREDNI może gubić komunikaty, jeśli będzie używany z komponentami bean sterowanymi komunikatami oraz przy dużym obciążeniu. Ma to także miejsce w przypadku aplikacji po stronie klienta, jeśli parametr maxClientQueueSize brokera nie jest ustawiony na 0. Parametr ten można ustawić na 0 przy pomocy komendy: #wempschangeproperties serwer_1_nazwy_węzła_WAS -e default -o DynamicSubscriptionEngine -n maxClientQueueSize -v 0 -x executionGroupUUID Wartość executionGroupUUID można znaleźć, uruchamiając brokera oraz przeglądając dziennik zdarzeń/aplikacje dla zdarzenia 2201. Wartość jest zwykle równa ffffffff-0000-0000-000000000000. Uwaga: Usługa JMS produktu WebSphere MQ w wersji 5.3 nie może być używana w ramach serwera WAS 6.1, ponieważ serwer WAS 6.1 ma środowisko wykonawcze Java 5. Dlatego nie można nawiązać połączeń między pamięciami menedżerów kolejek produktu WebSphere MQ 5.3. Może to spowodować obniżenie wydajności, jeśli poprzednio używano produktu WebSphere MQ 5.3 oraz POWIĄZAŃ dla połączeń, a po przejściu do serwera WebSphere Application Server 6.1 rozpoczęto używanie połączeń sieciowych typu KLIENT. Jeśli używany jest produkt WebSphere MQ 5.3 for z/OS®, może wystąpić konieczność zakupu dodatkowego pakietu opcji. Podczas działania w 64-bitowym systemie z/OS pole Typ transportu musi mieć wartość KLIENT, ponieważ 64-bitowy produkt WebSphere MQ for z/OS obecnie nie jest dostępny, a tryb POWIĄZANIA nie może być używany do nawiązywania połączenia z 31-bitowym produktem WebSphere MQ for z/OS. Może się okazać, że konieczny będzie zakup dodatkowego pakietu opcji dla produktu WebSphere MQ w celu uzyskania takiego rozwiązania.

Identyfikator klienta

Identyfikator klienta JMS używany do połączeń z menedżerem kolejek produktu MQSeries.

Typ danych

Łańcuch

CCSID

Identyfikator kodowanego zestawu znaków używany z menedżerem kolejek produktu WebSphere MQ.

Identyfikator kodowanego zestawu znaków (CCSID) należy podać w postaci obsługiwanej przez produkt WebSphere MQ.

Typ danych

Łańcuch

Więcej informacji o obsługiwanych identyfikatorach CCSID i o dokonywaniu konwersji z jednego kodowanego zestawu znaków na inny zawierają sekcje Administrowanie systemem i Skorowidz programowania aplikacji w Centrum informacyjnym produktu WebSphere MQ.

Czas Przechowywanie komunikatów

Zaznacz to pole wyboru, aby określić, że niepożądane komunikaty mają być pozostawione w kolejce. W przeciwnym razie niepożądane komunikaty będą przetwarzane zgodnie z ich opcjami dyspozycji.

Typ danych	Wyliczeniowy
Jednostki	Nie dotyczy
Wartość domyślna	Wyzerowane
Zakres	Wybrane W kolejce są pozostawiane komunikaty niepożądane. Wyzerowane Niepożądane komunikaty są przetwarzane zgodnie z ich opcjami dyspozycji.

Model tymczasowy

Nazwa definicji modelu używanego do tworzenia fabryk połączeń tymczasowych, jeśli fabryka połączeń jeszcze nie istnieje.

Typ danych	Łańcuch
Zakres	Od 1 do 48 znaków ASCII

Przedrostek kolejki tymczasowej

Przedrostek używany podczas dynamicznego nadawania nazw kolejkom.

Typ danych

Łańcuch

Niepowodzenie w przypadku wyciszenia

Wskazuje, że aplikacje powracają z wywołania metody, jeśli operacja menedżera kolejek nie powiodła się w sposób kontrolowany.

Typ danych	Pole wyboru
Wartość domyślna	Wybrane

Adres serwera lokalnego

Adres serwera lokalnego.

Typ danych

Łańcuch

Odstęp czasu między operacjami odpytywania

Odstęp czasu (w milisekundach) między operacjami skanowania wszystkich odbiorców podczas asynchronicznego dostarczania komunikatów.

Typ danych	Liczba całkowita
Jednostki	Milisekundy
Wartość domyślna	5000

Czas do ponownego skanowania

Odstęp czasu (w milisekundach) między operacjami skanowania tematu w celu odnalezienia komunikatów, które zostały dodane do tematu poza kolejnością.

Ten odstęp czasu steruje skanowaniem komunikatów dodanych do tematu poza kolejnością względem kursora przeglądania produktu WebSphere MQ.

Typ danych	Liczba całkowita
Jednostki	Milisekundy
Wartość domyślna	5000

Zestaw algorytmów szyfrowania SSL

Zestaw algorytmów szyfrowania używany w ramach połączenia SSL z produktem WebSphere MQ.

Tę właściwość należy ustawić na poprawny zestaw algorytmów udostępniony przez dostawcę JSSE. Wartość musi być zgodna z wartością CipherSpec określoną na kanale SVRCONN jako właściwość Kanał.

Tę właściwość należy ustawić w przypadku ustawienia właściwości Nazwa węzła sieci SSL.

Baza certyfikatów SSL

Lista zawierająca zero lub więcej serwerów list odwołań certyfikatów (Certificate Revocation List - CRL) używanych do sprawdzania odwołań certyfikatów SSL. Jeśli zostanie podana wartość tej właściwości, należy używać produktu WebSphere MQ JVM z platformą Java 2 w wersji 1.4.

Wartość stanowi listę rozdzielaną spacjami, zawierającą pozycje w następującym formacie:

ldap://nazwa_hosta:[port]

Po tej wartości znajduje się pojedynczy ukośnik (/). Jeśli wartość port jest pominięta, zostanie przyjęta wartość domyślnego portu LDAP, 389. W czasie połączenia certyfikat SSL zgłoszony przez serwer jest porównywany z listami odwołań certyfikatów (Certificate Revocation List - CRL) na określonych serwerach. Więcej informacji na temat zabezpieczeń CRL zawierają informacje Praca z listami odwołań certyfikatów w sekcji Zabezpieczenia Centrum informacyjnego produktu WebSphere MQ.

Nazwa węzła SSL

Szkielet nazwy wyróżniającej zabezpieczeń SSL, który musi być zgodny z nazwą udostępnianą przez menedżer kolejek systemu WebSphere MQ. Nazwa wyróżniająca jest używana do sprawdzania certyfikatu identyfikacyjnego udostępnianego przez serwer w czasie połączenia.

Jeśli ta właściwość nie jest ustawiona, odbywa się sprawdzanie certyfikatu.

Właściwość nazwy węzła SSL jest ignorowana, jeśli nie zostanie podana właściwość Zestaw algorytmów szyfrowania SSL.

Właściwość ta stanowi listę par nazw atrybutów i wartości rozdzielonych przecinkami lub średnikami. Na przykład:

CN=QMGR.*, OU=IBM, OU=WEBSPHERE

Wartość podana w przykładzie sprawdza certyfikat identyfikujący, zgłoszony przez serwer w czasie połączenia. Aby połączenie nie zostało przerwane, nazwa zwykła certyfikatu powinna zaczynać się od znaków QMGR., i musi zawierać przynajmniej dwie nazwy jednostek organizacyjnych, pierwszą IBM i drugą WEBSPHERE. Przy sprawdzaniu nie jest uwzględniana wielkość liter.

Więcej informacji o nazwach wyróżniających i ich użyciu z produktem WebSphere MQ znajduje się w sekcji Nazwy wyróżniające w Centrum informacyjnym produktu WebSphere MQ.

Pula połączeń

Określa opcjonalny zestaw ustawień puli połączeń.

Właściwości puli połączeń są wspólne dla wszystkich konektorów J2C.

Serwer aplikacji zestawia połączenia i sesje w pule w celu poprawienia wydajności dostawcy usługi JMS. To zestawianie połączeń jest niezależne od zestawiania połączeń systemu WebSphere MQ. Właściwości puli połączeń i sesji należy skonfigurować odpowiednio do zainstalowanych aplikacji. W przeciwnym przypadku, połączenia i sesje mogą zachowywać się niezgodnie z oczekiwaniami.

Jeśli współbieżny dostęp do zasobów JMS po stronie serwera przekracza wartość domyślną, należy zmienić wielkość puli połączeń. Wielkość puli połączeń może być ustawiona względem kolejek lub względem tematów.

Typ danych	Pole wyboru
Wartość domyślna	Wybrane

Opcje ponownego łączenia klienta

Wskazuje, czy połączenie trybu klienta ma być automatycznie ponownie łączone w przypadku awarii komunikacji lub menedżera kolejek. Ta właściwość jest ignorowana, jeśli fabryka połączeń nie jest używana w środowisku cienkiego klienta lub klienta zarządzanego.

Typ danych	Lista rozwijana
Wartość domyślna	DISABLED (wyłączone)
Zakres	DISABLED (wyłączone) Ponowne łączenie klienta nie jest realizowane automatycznie. ASDEF Używana jest wartość atrybutu DefRecon z sekcji kanałów pliku konfiguracyjnego klienta. Jeśli nie ma określonej wartości DefRecon, to ustawienie ma takie samo działanie jak wartość DISABLED. RECONNECT Ponowne łączenie jest realizowane dla wszystkich menedżerów kolejek spójnych z wartością atrybutu menedżera kolejek. Może to być inny menedżer kolejek niż ten, z którym było realizowane oryginalne połączenie. QMGR Ponowne łączenie jest realizowane tylko dla menedżera kolejek, z którym było realizowane oryginalne połączenie.

Więcej informacji na temat automatycznego ponownego łączenia klienta zawiera Centrum informacyjne produktu WebSphere MQ.

Limit czasu ponownego łączenia klienta

Maksymalna ilość czasu (w sekundach), przez jaki połączenie trybu klienta podejmuje automatyczne próby ponownego połączenia z menedżerem kolejek po wystąpieniu awarii komunikacji lub menedżera kolejek. Ten parametr jest ignorowany, jeśli fabryka połączeń nie jest używana w środowisku cienkiego klienta lub klienta zarządzanego. Stosowanie tego parametru zależy od wartości parametru opcji ponownego łączenia klienta.

Typ danych	Liczba całkowita
Jednostki	Sekundy
Wartość domyślna	1800
Zakres	Wartość większa od zera i nie większa niż 2147483647

Więcej informacji na temat automatycznego ponownego łączenia klienta zawiera Centrum informacyjne produktu WebSphere MQ.