Ustawienia specyfikacji aktywowania dostawcy komunikatów produktu IBM MQ

Ten panel umożliwia przeglądanie i zmianę właściwości konfiguracyjnych wybranej specyfikacji aktywowania na potrzeby jej użycia z dostawcą przesyłania komunikatów produktu IBM MQ. Właściwości konfiguracyjne określają sposób tworzenia połączeń z powiązanymi kolejkami i tematami.

Aby wyświetlić ustawienia specyfikacji aktywowania produktu IBM MQ, wykonaj następujące kroki w Konsoli administracyjnej:
  1. Na panelu nawigacyjnym kliknij opcję Zasoby > JMS -> Specyfikacje aktywowania, aby wyświetlić istniejące specyfikacje aktywowania.
  2. W razie potrzeby na panelu treści zmień ustawienie opcji Zasięg na poziom, na którym zdefiniowano specyfikacje aktywowania. Spowoduje to ograniczenie wyświetlanego zestawu specyfikacji aktywowania.
  3. Wybierz nazwę specyfikacji aktywowania do skonfigurowania.
W sekcji Właściwości ogólne znajduje się pięć grup właściwości:
Wprowadź wymagane zmiany w grupach właściwości Administracja, Połączenie, Miejsce docelowe, Zaawansowane i Ustawienia zabezpieczeń, a następnie kliknij przycisk Zastosuj, aby zapisać konfigurację, zanim na panelu treści w obszarze Właściwości dodatkowe zostanie kliknięty dowolny z następujących odsyłaczy:

W obszarze Elementy pokrewne można kliknąć opcję JAAS - Dane uwierzytelnienia J2C, aby skonfigurować informacje dotyczące uwierzytelniania używane w specyfikacji aktywowania.

Istnieje również możliwość określenia właściwości -localAddress za pomocą komendy administracyjnej createWMQActivationSpec produktu IBM MQ.

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

Funkcjonalność produktu IBM MQ została wyłączona w zasięgu, który ma wpływ na ten zasób dostawcy funkcji przesyłania komunikatów produktu IBM MQ, jest wyświetlany komunikat informacyjny wskazujący, że produkt IBM MQ został wyłączony. W środowisku z pojedynczym serwerem ten komunikat jest wyświetlany tylko podczas restartowania serwera po wyłączeniu produktu IBM MQ. W środowisku wdrożenia sieciowego ten komunikat jest wyświetlany natychmiast. Więcej informacji zawiera temat Wyłączanie funkcji produktu IBM MQ na serwerze WebSphere Application Server.

Specyfikacja aktywowania 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 lub zmodyfikowania tego lub innych zasobów w innym zasięgu należy zmienić zasięg na panelu kolekcji specyfikacji aktywowania produktu IBM MQ, a następnie kliknąć przycisk Zastosuj przed kliknięciem odsyłacza dla typu zasobu.

Informacje Wartość
Typ danych Łańcuch

Dostawca

Dostawca JMS przypisany podczas tworzenia specyfikacji aktywowania.

Dla wszystkich specyfikacji aktywowania utworzonych za pomocą tego panelu dostawcą jest dostawca przesyłania komunikatów produktu IBM MQ.

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

Informacje Wartość
Typ danych Łańcuch

Nazwa

Nazwa służąca do identyfikowania tej specyfikacji aktywowania na potrzeby administracyjne w ramach produktu WebSphere Application Server.

Informacje Wartość
Typ danych Łańcuch
Zakres Nazwa musi być unikalna w zestawie specyfikacji aktywowania zdefiniowanym w komórce.

Nazwa JNDI

Nazwa JNDI używana do wiązania specyfikacji aktywowania z przestrzenią nazw JNDI.

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 specyfikacji aktywowania używany do celów 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 specyfikacja aktywowania została utworzona przy użyciu tabeli definicji kanału klienta.

Jeśli wybrana specyfikacja aktywowania została utworzona za pomocą 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 specyfikacja aktywowania nie została utworzona za pomocą 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 przez produkt WebSphere MQ Centrum informacyjnego produktu IBM MQ.

Uwaga: Istnieją cztery właściwości połączeń produktu IBM MQ stosowane na potrzeby konfigurowania adaptera zasobów produktu IBM MQ używanego przez dostawcę przesyłania komunikatów produktu IBM MQ. Właściwości te wpływają na pulę połączeń używaną przez specyfikację aktywowania:
  • maxConnections
  • connectionConcurrency (Ustawienie tej właściwości ma wpływ tylko na węzły produktu WebSphere Application Server 7. Właściwość nie dotyczy węzłów produktu WebSphere Application Server w wersji 8 lub nowszej.)
  • reconnectionRetryCount
  • reconnectionRetryInterval
Więcej informacji na temat tych czterech właściwości i sposobu ich konfigurowania zawiera sekcja Właściwości adaptera zasobów.

Adres URL tabeli definicji kanału klienta

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

Informacje Wartość
Typ danych Łańcuch

Menedżer kolejek

Jeśli określona specyfikacja aktywowania 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. Z określonym zasobem produktu IBM MQ nawiązywane jest połączenie mające na celu odbieranie komunikatów.

Informacje Wartość
Typ danych Łańcuch
Zakres Jeśli ta specyfikacja aktywowania nie jest oparta na tabeli definicji kanału klienta, wartość właściwości musi być nazwą menedżera kolejek.
Jeśli ta specyfikacja aktywowania jest oparta na tabeli definicji kanału klienta, 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 specyfikacji aktywowania 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 umożliwia dokładne określenie mechanizmów używanych do nawiązywania połączenia z produktem IBM 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 bądź adres IPv4 lub IPv6 menedżera kolejek produktu IBM 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 specyfikacja aktywowania 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 mieszanych komórek informacje właściwości listy nazw połączeń dotyczące specyfikacji aktywowania o zasięgu klastra lub komórki są dostępne dla węzłów produktu WebSphere Application Server 7.0. Dokładne zachowanie zależy od poziomu pakietu poprawek węzła:
  • W przypadku węzłów produktu WebSphere Application Server 7.0 z pakietem poprawek Fix Pack 7 lub nowszym, właściwości listy nazw połączeń można używać w celu nawiązywania połączenia z menedżerami kolejek z wieloma instancjami.
  • W przypadku węzłów z poziomem pakietu poprawek wcześniejszym niż 7.0 właściwość listy nazw połączeń nie jest rozpoznawana i zwracany jest komunikat ostrzegawczy podobny do następującego przykładu:
    [29/09/10 12:15:27:468 BST] 00000018 J2CUtilityCla W   
    J2CA0008W: Klasa com.ibm.mq.connector.inbound.ActivationSpecImpl używana przez zasób 
    cells/L3A3316Node01Cell/resources.xml#J2CResourceAdapter_1284547647859 nie zawiera 
    metody setConnectionNameList. Przetwarzanie jest kontynuowane.
    W tym przypadku do nawiązania połączenia z menedżerem kolejek używane są informacje właściwości nazwy hosta i portu.

Kanał połączenia z serwerem

Nazwa kanału połączenia z serwerem IBM MQ używana do nawiązania 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 z serwerem zdefiniowanym 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 IBM MQ

Ta opcja umożliwia określenie, 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.

W przypadku używania specyfikacji aktywowania dostawcy przesyłania komunikatów produktu IBM MQ w środowisku serwera aplikacji serwer aplikacji 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.

W konfiguracji SSL dla specyfikacji aktywowania dostawcy przesyłania komunikatów produktu IBM 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 używany jest protokół SSL, należy wybrać ten przełącznik, aby określić że konfiguracja SSL jest pobierana z centralnie zarządzanej konfiguracji SSL produktu WebSphere Application Server.

Po wybraniu tego przełącznika do wybrania odpowiedniej konfiguracji SSL używane są atrybuty nazwy hosta i portu ze specyfikacji aktywowania dostawcy przesyłania komunikatów produktu IBM MQ. Jeśli informacje o hoście i porcie zostały dostarczone do specyfikacji aktywowania 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 wprowadzić konfigurację SSL zgodną ze specyfikacją aktywowania, zapoznaj się z informacjami w temacie Dynamiczne konfiguracje SSL punktów końcowych dla danych wychodzących, który znajduje się w pokrewnych odwołaniach.

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 IBM 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, jeśli komunikacja sieciowa z menedżerem kolejek lub grupą współużytkowania kolejek produktu IBM MQ ma być zabezpieczona przy użyciu protokołu SSL.

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

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 dany zasób dostawcy przesyłania komunikatów produktu IBM MQ jest oparty na tabeli definicji kanału klienta, ten parametr jest używany tylko w przypadku skonfigurowania odpowiednich pozycji w tabeli definicji kanału klienta do korzystania z protokołu SSL.

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

Informacje Wartość
Typ danych Lista rozwijana

Miejsce docelowe

Uwaga: Właściwość WAS_EndpointInitialState to właściwość niestandardowa. Ta właściwość określa, czy przetwarzanie komunikatów z miejsca docelowego JMS rozpoczyna się natychmiast po użyciu specyfikacji aktywowania dla komponentu bean sterowanego komunikatami do nawiązania połączenia z miejscem docelowym. Aby ustawić właściwości niestandardowe po zakończeniu wprowadzania zmian na tym panelu treści i kliknięciu opcji Zastosuj w celu zapisania konfiguracji, należy kliknąć odsyłacz Właściwości niestandardowe na panelu treści w obszarze Właściwości dodatkowe.

Nazwa JNDI miejsca docelowego

Nazwa JNDI dla miejsca docelowego JMS, z którego komunikaty są dostarczane do komponentu bean sterowanego komunikatami skonfigurowanego do użycia tej specyfikacji aktywowania.

Informacje Wartość
Typ danych Łańcuch

Selektor komunikatów

Wyrażenie selektora komunikatów określające, które komunikaty mają zostać dostarczone.

Informacje Wartość
Typ danych Łańcuch

Typ miejsca docelowego

Typ miejsca docelowego (kolejka lub temat), z którego mają być zajmowane komunikaty.

Informacje Wartość
Typ danych Lista rozwijana
Zakres
Kolejka
Nazwa miejsca docelowego JNDI odwołuje się do miejsca docelowego JMS, które jest kolejką.
Temat
Nazwa miejsca docelowego JNDI odwołuje się do miejsca docelowego JMS, które jest tematem.

Trwała subskrypcja

Opcja określająca, czy do dostarczania komunikatów do komponentu bean sterowanego komunikatami subskrybującego temat używana jest subskrypcja trwała, czy nietrwała.

Informacje Wartość
Typ danych Pole wyboru
Wartość domyślna Niezaznaczone (nietrwała)
Zakres
Wyzerowane
Nietrwała
Wybrane
Trwała

Nazwa subskrypcji

Nazwa trwałej subskrypcji. Jest ona dostępna tylko po zaznaczeniu pola wyboru Trwała subskrypcja.

Informacje Wartość
Typ danych Łańcuch

Zaawansowane

Identyfikator klienta

Identyfikator klienta, który należy podać przy nawiązywaniu 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 IBM 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.

Ustawienia zabezpieczeń

Alias uwierzytelniania

Nazwa użytkownika i hasło używane przy nawiązywaniu połączenia z produktem IBM MQ.

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.


Nazwa pliku: umj_pasm.html