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

Ten panel umożliwia przeglądanie i zmianę właściwości konfiguracji wybranej fabryki połączeń kolejki na potrzeby używania z dostawcą przesyłania komunikatów produktu WebSphere MQ. Właściwości konfiguracji określają sposób tworzenia połączeń z powiązanymi miejscami docelowymi kolejek JMS.

Fabryka połączeń kolejek produktu WebSphere MQ służy do tworzenia połączeń JMS z kolejkami udostępnianymi przez produkt WebSphere MQ na potrzeby przesyłania komunikatów w trybie punkt z punktem.

Aby wyświetlić ustawienia fabryki połączeń kolejki produktu WebSphere MQ, należy wykonać następującą procedurę w Konsoli administracyjnej:
  1. Na panelu nawigacyjnym kliknij opcję Zasoby > JMS -> Fabryki połączeń kolejki, aby wyświetlić istniejące fabryki połączeń kolejki.
  2. W razie potrzeby na panelu treści zmień ustawienie opcji Zasięg na poziom, na którym zdefiniowano fabryki połączeń kolejki. Spowoduje to ograniczenie wyświetlanego zestawu fabryk połączeń kolejki.
  3. Wybierz nazwę fabryki połączeń kolejki, 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ń kolejki.

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ń kolejki produktu WebSphere MQ ma następujące właściwości.

Administrowanie

Zasięg

Służy do określania poziomu, na którym 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. Aby przeglądać lub modyfikować ten zasób (lub inne zasoby) w innym zasięgu, należy zmienić zasięg na panelu kolekcji fabryki połączeń kolejki produktu WebSphere MQ, kliknąć przycisk Zastosuj, a następnie kliknąć odsyłacz do typu zasobu.

Informacje Wartość
Typ danych Łańcuch

Dostawca

Dostawca JMS przypisany w momencie tworzenia fabryki połączeń kolejki.

Dla wszystkich fabryk połączeń kolejki 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ń kolejek w celach administracyjnych na serwerze WebSphere Application Server.

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

Nazwa JNDI

Nazwa JNDI używana do powiązania fabryki połączeń kolejki 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ń kolejek 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łączenia zależą od tego, czy wybrana fabryka połączeń kolejki została utworzona przy użyciu tabeli definicji kanału klienta.

Jeśli wybrana fabryka połączeń kolejki 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ń kolejki 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
  • 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ń kolejek 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ść określa nazwę menedżera kolejek lub grupy współużytkowania kolejek na potrzeby połączenia. Połączenie z danym zasobem produktu IBM 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ń kolejki nie jest oparta na tabeli definicji kanału klienta, wartość musi być poprawną nazwą menedżera kolejek.
Jeśli ta fabryka połączeń kolejek 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ń kolejki 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
Na potrzeby komunikacji z menedżerem kolejek produktu IBM MQ należy użyć połączenia sieciowego opartego na protokole TCP/IP.
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 8.0 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.

Jeśli fabryka połączeń kolejki dostawcy przesyłania komunikatów produktu WebSphere MQ jest używana 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.

Jeśli fabryka połączeń kolejki dostawcy przesyłania komunikatów produktu WebSphere MQ jest używana w środowisku klienta, klient pobiera informacje o konfiguracji SSL z pliku ssl.client.props. Zastosowanie tego pliku jest szczegółowo opisane w informacjach uzupełniających do tego tematu.

W konfiguracji SSL dla fabryki połączeń kolejki dostawcy przesyłania komunikatów produktu WebSphere MQ można używać tylko jednego zestawu algorytmów szyfrowania. 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 zabezpieczania 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

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ń kolejki 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ń kolejki, 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 być zarejestrowany w transakcji serwera 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ń kolejki obsługuje użycie protokołu rozproszonego zatwierdzania dwufazowego do koordynacji operacji transakcyjnych.
Wyzerowane
Fabryka połączeń kolejki nie obsługuje użycia protokołu rozproszonego zatwierdzania dwufazowego do koordynacji operacji transakcyjnych.

Opcję tę należy wybrać, jeśli transakcje obejmują inne zasoby, w tym inne kolejki lub tematy. Jej zaznaczenie należy usunąć tylko w przypadku pewności, że menedżer kolejek, który jest docelowym menedżerem kolejek dla tej fabryki połączeń kolejki, jest jedynym zasobem w transakcji.

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ń kolejki, 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_pqcfm.html