Ustawienia fabryki połączeń tematów dostawcy przesyłania komunikatów produktu WebSphere MQ

Ten panel służy do przeglądania i zmiany właściwości konfiguracyjnych wybranej fabryki połączeń tematów na potrzeby używania z dostawcą przesyłania komunikatów produktu IBM MQ. Właściwości konfiguracji określają sposób tworzenia połączeń z powiązanym miejscem docelowym JMS tematu.

Fabryka połączeń tematu produktu IBM MQ służy do tworzenia połączeń JMS z miejscami docelowymi tematu udostępnianymi przez produkt IBM MQ na potrzeby przesyłania komunikatów w trybie publikowania/subskrypcji.

Aby wyświetlić ustawienia fabryki połączeń tematów produktu WebSphere MQ, należy użyć Konsoli administracyjnej i wykonać następujące kroki:
  1. Na panelu nawigacyjnym kliknij opcję Zasoby > JMS -> Fabryki połączeń tematu, aby wyświetlić istniejące fabryki połączeń tematów.
  2. W razie potrzeby zmień na panelu treści ustawienie opcji Zasięg na poziom, na którym zdefiniowano fabryki połączeń tematów. Ograniczy to listę wyświetlanych fabryk połączeń tematów.
  3. Wybierz nazwę fabryki połączeń tematu, która ma być używana.
W sekcji Właściwości ogólne znajdują się cztery grupy właściwości:
Po wprowadzeniu żądanych zmian w grupach właściwości Administrowanie, Połączenie, Zaawansowane i Zabezpieczenia należy kliknąć przycisk Zastosuj, aby zapisać konfigurację przed kliknięciem dowolnego z poniżej wymienionych odsyłaczy panelu treści obszaru Właściwości dodatkowe:

W obszarze Elementy pokrewne można kliknąć opcję JAAS - dane uwierzytelniania J2C, aby skonfigurować informacje uwierzytelniania używane z fabryką połączeń tematu.

Za pomocą komend administracyjnych produktu WebSphere MQ można określić następujące właściwości dodatkowe:

Więcej informacji na temat tych właściwości zawiera sekcja Komenda createWMQConnectionFactory.

Uwaga: Podczas określania właściwości produktu IBM MQ obowiązują następujące ograniczenia:

Fabryka połączeń tematu produktu IBM MQ ma następujące właściwości.

Administrowanie

Zasięg

Poziom, do którego definicja zasobów jest widoczna dla aplikacji.

Zasoby takie jak dostawcy przesyłania komunikatów, powiązania przestrzeni nazw czy współużytkowane biblioteki można definiować w wielu zasięgach, a zasoby składowe - definiować z bardziej konkretnymi zasięgami, które są traktowane nadrzędnie, jeśli pokrywają się z zasięgami bardziej ogólnymi.

Zasięg jest wyświetlany wyłącznie w celach informacyjnych i nie może być modyfikowany na bieżącym panelu. W celu przeglądania i modyfikowania tego zasobu w innym zasięgu należy zmienić zasięg na panelu kolekcji fabryki połączeń tematów produktu IBM MQ, kliknąć przycisk Zastosuj, a następnie kliknąć odsyłacz do typu zasobu.

Informacje Wartość
Typ danych Łańcuch

Dostawca

Dostawca JMS przypisany podczas tworzenia fabryki połączeń tematów.

Dla wszystkich fabryk połączeń tematów utworzonych za pomocą tego panelu dostawcą jest dostawca przesyłania komunikatów produktu WebSphere MQ.

Dostawca jest wyświetlany wyłącznie w celach informacyjnych.

Informacje Wartość
Typ danych Łańcuch

Nazwa

Nazwa służąca do identyfikowania tej fabryki połączeń tematu w celach administracyjnych w ramach produktu WebSphere Application Server.

Informacje Wartość
Typ danych Łańcuch
Zakres Nazwa ta musi być unikalna w obrębie zestawu fabryk połączeń tematów JMS zdefiniowanych dla tej komórki.

Nazwa JNDI

Nazwa JNDI używana do powiązania fabryki połączeń tematu z przestrzenią nazw.

Zgodnie z konwencją użyj pełnej nazwy JNDI, na przykład w postaci jms/Nazwa, gdzie Nazwa jest logiczną nazwą zasobu.

Informacje Wartość
Typ danych Łańcuch

Opis

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

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

Połączenie

Informacje wymagane do skonfigurowania połączeń zależą od tego, czy wybrana fabryka połączeń tematu została utworzona przy użyciu tabeli definicji kanału klienta.

Jeśli wybrana fabryka połączeń tematu została utworzona przy użyciu tabeli definicji kanału klienta, wyświetlane są tylko następujące właściwości:
  • Adres URL tabeli definicji kanału klienta
  • Menedżer kolejek
  • Konfiguracja protokołu SSL
Jeśli wybrana fabryka połączeń tematu nie została utworzona przy użyciu tabeli definicji kanału klienta, wyświetlane są następujące właściwości:
  • Menedżer kolejek
  • Transport
  • Jeśli wybrana jest opcja Wprowadź informacje o hoście i porcie w postaci oddzielnych wartości hosta i portu, nie można użyć właściwości listy nazw połączeń, ale można użyć następujących właściwości:
    • Nazwa hosta
    • Port
  • Jeśli wybrana jest opcja Wprowadź informacje o hoście i porcie w postaci listy nazw połączeń, można użyć właściwości listy nazw połączeń, ale nie można użyć następujących właściwości:
    • Nazwa hosta
    • Port
  • Kanał połączenia z serwerem
  • Jeśli pole wyboru dla właściwości Użyj protokołu SSL do zabezpieczenia komunikacji z produktem IBM MQ nie zostanie zaznaczone, nie będzie można użyć następujących właściwości:
    • Centralnie zarządzana
    • Konkretna konfiguracja
    • Konfiguracja protokołu SSL

Więcej informacji na temat konfigurowania właściwości SSL dla produktu IBM MQ zawiera temat Właściwości protokołu SSL w sekcji Używanie języka Java Centrum informacyjnego produktu IBM MQ.

Adres URL tabeli definicji kanału klienta

Adres URL określający położenie tabeli definicji kanału klienta produktu WebSphere MQ.

Informacje Wartość
Typ danych Łańcuch

Menedżer kolejek

Jeśli określona fabryka połączeń tematu jest oparta na tabeli definicji kanału klienta, ta właściwość jest używana do wybierania pozycji w tabeli definicji kanału klienta. W przeciwnym razie właściwość stanowi nazwę menedżera kolejek lub grupy współużytkowania kolejek na potrzeby połączenia. Połączenie z tym zasobem produktu WebSphere MQ jest nawiązywane w celu wysyłania lub odbierania komunikatów.

Informacje Wartość
Typ danych Łańcuch
Zakres Jeśli ta fabryka połączeń tematu nie jest oparta na tabeli definicji kanału klienta, to właściwość stanowi poprawną nazwę menedżera kolejek.
Jeśli ta fabryka połączeń tematów jest oparta na tabeli definicji kanału klienta, to właściwość zawiera jedną z następujących wartości:
  • Poprawna nazwa menedżera kolejek
  • Gwiazdka (*) poprzedzająca nazwę grupy menedżera kolejek1
  • Gwiazdka (*)
  • Pusta1
1Jeśli użytkownik poda wartość właściwości menedżera kolejek w takiej formie wraz z tabelą definicji kanału klienta, to poszczególne połączenia nawiązane przy użyciu fabryki połączeń tematu mogą prowadzić do różnych menedżerów kolejek. Wybór spośród wielu menedżerów kolejek jest dokonywany, gdy tabela definicji kanału klienta zawiera wiele definicji kanału połączenia klienta oraz zgodny parametr nazwy menedżera kolejek (QMNAME), natomiast definicje kanału połączeń określają szczegóły połączenia sieciowego różnych menedżerów kolejek.
Jeśli określona fabryka połączeń jest oparta na tabeli definicji kanału klienta, a tabela ta może wybierać z wielu menedżerów kolejek, odzyskanie transakcji globalnych może nie być możliwe. Oznacza to, że w przypadku fabryk połączeń określających tabelę definicji kanału klienta są dostępne dwie możliwości:
  • Unikanie jakichkolwiek niejednoznaczności dotyczących docelowego menedżera kolejek podczas określania właściwości Menedżer kolejek co oznacza, że wartość określona dla tej właściwości nie może zawierać znaku gwiazdki (*).
  • Unikanie używania zasobów w aplikacjach, które biorą udział w transakcjach globalnych.

Transport

Typ transportu produktu IBM MQ dla połączenia. Typ transportu służy do określania dokładnych mechanizmów używanych w celu połączenia z produktem WebSphere MQ.

Informacje Wartość
Typ danych Lista rozwijana
Wartość domyślna Powiązania, następnie klient
Zakres
Klient
Należy użyć połączenia sieciowego opartego na protokole TCP/IP na potrzeby komunikacji z menedżerem kolejek produktu WebSphere MQ.
Powiązania, następnie klient
Najpierw jest wykonywana próba połączenia z menedżerem kolejek w trybie powiązania. Jeśli połączenie takie nie jest możliwe, następuje powrót do transportu klienta.
Powiązania
Nawiązywane jest połączenie między pamięciami z menedżerem kolejek działającym na tym samym węźle. Następujące właściwości opcji Tryb transportu klienta są wyłączone:
  • Nazwa hosta
  • Port
  • Lista nazw połączeń
  • Kanał połączenia z serwerem
Więcej informacji na temat konfigurowania typu transportu Powiązania, następnie klient lub Powiązania zawiera sekcja Konfigurowanie dostawcy przesyłania komunikatów produktu IBM MQ przy użyciu informacji o bibliotekach rodzimych.

Wprowadź informacje o hoście i porcie w postaci oddzielnych wartości hosta i portu

Jeśli ten przełącznik jest wybrany, połączenie z menedżerem kolejek produktu IBM MQ jest nawiązywane przy użyciu informacji określonych przez właściwości nazwy hosta i portu.

Wybranie tej opcji powoduje włączenie właściwości nazwy hosta i portu oraz wyłączenie właściwości listy nazw połączeń. Aby wprowadzić informacje o liście nazw połączeń, należy kliknąć opcję Wprowadź informacje o hoście i porcie w postaci listy nazw połączeń.

Ten przełącznik jest dostępny tylko wtedy, gdy właściwość zasięgu określa komórkę lub klaster albo gdy właściwość zasięgu określa węzeł lub serwer, a w tym węźle lub na tym serwerze działa produkt WebSphere Application Server 8.0 lub nowszy.

Informacje Wartość
Typ danych Przełącznik

Nazwa hosta

Nazwa hosta albo adres IPv4 lub IPv6 menedżera kolejek produktu WebSphere MQ, z którym ma zostać nawiązane połączenie.

Informacje Wartość
Typ danych Łańcuch

Port

Numer portu, na którym nasłuchuje produkt IBM MQ.

Informacje Wartość
Typ danych Liczba całkowita
Wartość domyślna 1414
Zakres Wartość musi zawierać się w zakresie od 1 do 65536 (włącznie).

Wprowadź informacje o hoście i porcie w postaci listy nazw połączeń

Jeśli ten przełącznik jest wybrany, połączenie z menedżerem kolejek produktu IBM MQ jest nawiązywane przy użyciu informacji określonych przez właściwość listy nazw połączeń.

List nazw połączeń można używać w celu nawiązania połączenia z pojedynczym menedżerem kolejek lub menedżerem kolejek z wieloma instancjami. Więcej informacji na temat używania menedżera kolejek z wieloma instancjami zawiera Centrum informacyjne produktu IBM MQ. Wybranie tej opcji powoduje włączenie właściwości listy nazw połączeń i wyłączenie właściwości nazwy hosta i portu. Aby wprowadzić oddzielne informacje o hoście i porcie, należy kliknąć opcję Wprowadź informacje o hoście i porcie w postaci oddzielnych wartości hosta i portu.

Ten przełącznik jest dostępny tylko wtedy, gdy właściwość zasięgu określa komórkę lub klaster albo gdy właściwość zasięgu określa węzeł lub serwer, a w tym węźle lub na tym serwerze działa produkt WebSphere Application Server 8.0 lub nowszy.

Informacje Wartość
Typ danych Przełącznik

Lista nazw połączeń

Lista nazw połączeń określająca szczegółowe informacje dotyczące nazwy hosta i portu, których fabryka połączeń ma używać do nawiązania połączenia z menedżerem kolejek z wieloma instancjami.

Tej właściwości można używać tylko w celu umożliwienia nawiązania połączenia z menedżerem kolejek z wieloma instancjami. Nie można jej używać w celu umożliwienia nawiązania połączenia z menedżerami kolejek bez wielu instancji, ponieważ może to spowodować problemy z integralnością transakcji.

Informacje Wartość
Typ danych Łańcuch
Wartość domyślna Nie ustawione
Zakres To pole musi być ustawione na łańcuch w następującej postaci:

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

Informacja o porcie jest opcjonalna i jeśli nie zostanie określona, przyjmowana jest wartość domyślna 1414.

Wartość host musi być poprawną nazwą hosta TCP/IP bądź adresem IPv4 lub IPv6.

Wartość port musi być liczbą całkowitą z zakresu od 1 do 65536 (włącznie).

Na przykład: localhost(1234),host_zdalny1(1234),host_zdalny2

Po określeniu właściwości listy nazw połączeń właściwości nazwy hosta i portu są automatycznie ustawiane na nazwę hosta i numer portu pierwszej pozycji na liście nazw połączeń. Na przykład jeśli określono wartość localhost(1234),host_zdalny1(1234),host_zdalny2, nazwa hosta zostanie ustawiona na wartość localhost, a numer portu zostanie ustawiony na wartość 1234.

Ta właściwość jest dostępna tylko wtedy, gdy właściwość zasięgu określa komórkę lub klaster albo gdy właściwość zasięgu określa węzeł lub serwer, a w tym węźle lub na tym serwerze działa produkt WebSphere Application Server lub nowszy.

W środowisku komórki mieszanej właściwość listy nazw połączeń nie jest dostępna dla wersji produktu WebSphere Application Server wcześniejszych niż 8.0. W takim przypadku zamiast niej używane są pola nazwy hosta i portu określone na podstawie pierwszej pozycji listy nazw połączeń.

Kanał połączenia z serwerem

Nazwa kanału połączenia serwera produktu IBM MQ używana podczas nawiązywania połączenia z produktem IBM MQ.

Informacje Wartość
Typ danych Łańcuch
Wartość domyślna SYSTEM.DEF.SVRCONN
Zakres Wartość musi być kanałem połączenia serwera określonym w menedżerze kolejek produktu IBM MQ, z którym nawiązywane jest połączenie.

Użyj protokołu SSL do bezpiecznej komunikacji z produktem WebSphere MQ

Ta opcja służy do określania, czy protokół SSL (Secure Sockets Layer) jest używany do zabezpieczenia komunikacji sieciowej z menedżerem kolejek lub grupą współużytkowania kolejek produktu IBM MQ.

Podczas używania fabryki połączeń tematów dostawcy przesyłania komunikatów produktu IBM MQ w środowisku serwera aplikacji serwer ten zarządza konfiguracją SSL. Aby zmienić parametry konfiguracji SSL, należy za pomocą Konsoli administracyjnej przejść do panelu Zabezpieczenia > Zarządzanie certyfikatami SSL i kluczami.

Podczas używania fabryki połączeń tematów dostawcy przesyłania komunikatów produktu IBM MQ w środowisku klienta pobiera on informacje o konfiguracji SSL z pliku ssl.client.props. Zastosowanie tego pliku jest szczegółowo opisane w informacjach uzupełniających do tego tematu.

Można użyć tylko jednego zestawu algorytmów szyfrowania w konfiguracji SSL dla fabryki połączeń tematów dostawcy przesyłania komunikatów produktu IBM MQ. W przypadku określenia większej liczby zestawów algorytmów szyfrowania użyty zostanie tylko pierwszy z nich.

Informacje Wartość
Typ danych Pole wyboru. Jeśli to pole wyboru nie zostanie zaznaczone, następujące właściwości protokołu SSL zostaną wyłączone:
  • Centralnie zarządzana
  • Konkretna konfiguracja
  • Konfiguracja protokołu SSL

Centralnie zarządzana

Jeśli do komunikacji z produktem IBM MQ jest używany protokół SSL, należy wybrać ten przełącznik, aby określić, że konfiguracja SSL jest pobierana z zarządzanej centralnie konfiguracji SSL serwera WebSphere Application Server.

Po wybraniu tego przełącznika do wybrania odpowiedniej konfiguracji SSL używane są atrybuty nazwy hosta i portu z fabryki połączeń dostawcy przesyłania komunikatów produktu IBM MQ. Jeśli informacje o hoście i porcie zostały dostarczone przy użyciu listy nazw połączeń, do wybrania odpowiedniej konfiguracji SSL używane są informacje o nazwie hosta i porcie pierwszej pozycji na liście. Aby zapewnić konfigurację SSL zgodną z fabryką połączeń, należy zapoznać się z tematem Ustawienia dynamicznych konfiguracji SSL punktów końcowych dla danych wychodzących, wymienionym wśród informacji pokrewnych.

Informacje Wartość
Typ danych Przełącznik

Konkretna konfiguracja

Ten przełącznik należy wybrać, aby określić konkretną konfigurację SSL, która ma być używana, jeśli do zabezpieczenia komunikacji sieciowej z menedżerem kolejek lub grupą współużytkowania kolejek produktu WebSphere MQ używany jest protokół SSL.

Informacje Wartość
Typ danych Przełącznik

Konfiguracja protokołu SSL

Konfiguracja protokołu SSL, która ma zostać użyta, gdy protokół SSL będzie używany do zabezpieczenia komunikacji z menedżerem kolejek lub grupą współużytkowania kolejek produktu WebSphere MQ.

Ta właściwość jest wyłączona, jeśli wybrano przełącznik Centralnie zarządzana i zasób dostawcy przesyłania komunikatów produktu WebSphere MQ został jawnie zdefiniowany.

Ta właściwość jest zawsze włączona, jeśli zasób dostawcy przesyłania komunikatów produktu IBM MQ jest oparty na tabeli definicji kanału klienta.

Jeśli ten zasób dostawcy przesyłania komunikatów produktu WebSphere MQ działa na podstawie tabeli definicji kanału klienta, ten parametr jest używany tylko w przypadku, gdy dla odpowiednich pozycji w tabeli definicji kanału klienta skonfigurowano użycie protokołu SSL.

Ponadto w przypadku wybrania konfiguracji SSL brak dla dostawcy przesyłania komunikatów produktu WebSphere MQ używana jest domyślna centralnie zarządzana konfiguracja protokołu SSL produktu WebSphere Application Server.

Informacje Wartość
Typ danych Lista rozwijana

Zaawansowane

Identyfikator klienta

Identyfikator klienta, który ma być określony podczas nawiązywania połączenia z dostawcą przesyłania komunikatów produktu IBM MQ.

Informacje Wartość
Typ danych Łańcuch

Zezwalaj na klonowanie stałych subskrypcji

Opcja określająca, czy do wielu instancji subskrypcji trwałych można uzyskać współbieżny dostęp z poziomu różnych serwerów.

Informacje Wartość
Typ danych Pole wyboru
Wartość domyślna Wyzerowane
Zakres
Wybrane
Do wielu instancji subskrypcji trwałych można uzyskać współbieżny dostęp z poziomu różnych serwerów.
Wyzerowane
Do wielu instancji subskrypcji trwałych nie można uzyskać współbieżnego dostępu z poziomu różnych serwerów.

Wersja dostawcy

Wersja dostawcy przesyłania komunikatów produktu WebSphere MQ. Jest ona używana do określenia, czy należy nawiązać połączenie z konkretną wersją menedżera kolejek. Jest również używana do określenia typu funkcji wymaganych przez klient.

Informacje Wartość
Typ danych Łańcuch
Zakres Wprowadzona wartość musi być pustym łańcuchem lub musi mieć jeden z następujących formatów:
  • n.n.n.n
  • n.n.n
  • n.n
  • n
gdzie n jest wartością liczbową większą lub równą zero.

Na przykład 6.0.0.0.

Obsługuj protokół rozproszonego zatwierdzania dwufazowego

Opcja służąca do określania, czy fabryka połączeń tematu obsługuje koordynację XA transakcji przesyłania komunikatów. Tę opcję należy włączyć, jeśli wiele zasobów, w tym ta fabryka połączeń tematu, ma być używanych w tej samej transakcji.

Jeśli ta właściwość nie zostanie zaznaczona, obsługa protokołu rozproszonego zatwierdzania dwufazowego będzie wyłączona. Sesja JMS może być zarejestrowana w transakcji, jednak zamiast wywołań XA będzie używać wywołań transakcji lokalnej menedżera zasobów session.commit i session.rollback. Pozwala to usprawnić wydajność. Jednak tylko pojedynczy zasób może zostać zarejestrowany w transakcji produktu WebSphere Application Server.

Obsługa ostatniego uczestnika umożliwia włączenie do listy jednego zasobu bez XA z innymi zasobami obsługującymi XA.

Informacje Wartość
Typ danych Pole wyboru
Wartość domyślna Wybrane
Zakres
Wybrane
Fabryka połączeń obsługuje użycie protokołów rozproszonego zatwierdzania dwufazowego w celu koordynacji działania transakcji.
Wyzerowane
Fabryka połączeń nie obsługuje użycia protokołów rozproszonego zatwierdzania dwufazowego w celu koordynacji działania transakcji.

Nie należy włączać koordynacji XA, gdy menedżer kolejek określony przez fabrykę połączeń tematów jest jedynym zasobem uczestniczącym w transakcji. Włącz koordynację XA, jeśli transakcje zawierają także innych zasoby, w tym inne kolejki lub tematy.

Ustawienia zabezpieczeń

Alias uwierzytelniania dla odtwarzania XA

Nazwa użytkownika i hasło, które mają być używane przy nawiązywaniu połączenia z produktem WebSphere MQ podczas procesu odtwarzania XA.

Informacje Wartość
Typ danych Lista rozwijana
Wartość domyślna (brak)
Zakres Wszystkie aliasy uwierzytelniania zdefiniowane dla komórki oraz wartość (brak), która określa, że do produktu IBM MQ nie są przekazywane żadne referencje podczas procesu odtwarzania XA.

Alias konfiguracji odwzorowania

To pole jest używane tylko w przypadku braku konfiguracji logowania w odwołaniu do zasobu komponentu.

Jeśli uprawnienie zasobu ma wartość "kontener", to preferowanym sposobem definiowania strategii uwierzytelniania jest określenie konfiguracji logowania i właściwości powiązanych w odwołaniu do zasobu komponentu.

W przypadku określenia konfiguracji logowania DefaultPrincipalMapping właściwość powiązana będzie aliasem pozycji danych uwierzytelniania JAAS J2C. Aby skonfigurować informacje uwierzytelniania na potrzeby fabryki połączeń tematu, należy kliknąć opcję JAAS - dane uwierzytelniania J2C w obszarze Elementy pokrewne.

Informacje Wartość
Typ danych Lista rozwijana
Wartość domyślna (brak)
Zakres Dostępne są następujące opcje:
  • ClientContainer (Kontener klienta)
  • WSLogin
  • WSKRB5Login
  • DefaultPrincipalMapping (Domyślne odwzorowanie podstawowe)
  • TrustedConnectionMapping
  • KerberosMapping

Alias uwierzytelnienia zarządzany przez kontener

Alias uwierzytelnienia określający nazwę użytkownika i hasło, które mają być używane przy nawiązywaniu połączenia z dostawcą przesyłania komunikatów produktu WebSphere MQ.

Informacje Wartość
Typ danych Lista rozwijana
Wartość domyślna (brak)
Zakres Wszystkie aliasy uwierzytelnienia zdefiniowane dla komórki oraz wartość (brak), która określa, że do produktu WebSphere MQ nie są przekazywane żadne referencje.


Nazwa pliku: umj_ptcfm.html