Właściwości miejsca docelowego
Istnieje możliwość przeglądania i ustawiania właściwości miejsca docelowego w oknie dialogowym Właściwości miejsca docelowego. Właściwości dostępne w tym oknie dialogowym zależą od typu miejsca docelowego.
W poniższych tabelach znajdują się listy wszystkich właściwości dostępnych dla miejsc docelowych:
Dla każdej właściwości dostępny jest krótki opis sytuacji, w której może być wymagana konfiguracja danej właściwości. W tabelach zostały także podane równoważne długie i skrócone nazwy używane w narzędziu wiersza komend JMS Administration. Właściwości dostępne w oknie dialogowym właściwości zależą od typu miejsca docelowego. Miejsca docelowe kolejek posiadają inne właściwości niż miejsca docelowe sekcji. Więcej informacji zawiera sekcja Konfigurowanie obiektów JMS przy użyciu narzędzia administracyjnego w Centrum Wiedzy IBM®.
Strona Ogólne
W tabeli podano listę właściwości, które można ustawić na stronie Ogólne w oknie dialogowym Właściwości obiektu docelowego.
Właściwość | Znaczenie | Długa nazwa | Krótka nazwa |
---|---|---|---|
Nazwa | Określa nazwę obiektu. | NAME | |
Opis | Podaj opis obiektu. | DESCRIPTION | DESC |
Nazwa klasy | Określa nazwę klasy implementowaną przez obiekt docelowy. | ||
Dostawca komunikatów | Określa transport obsługiwany przez obiekt docelowy. Może to być transport produktu IBM MQ lub transport w czasie rzeczywistym. Transport w czasie rzeczywistym jest niedostępny w produkcie IBM MQ 8.0. W przypadku używania produktu IBM MQ 8.0 można zdefiniować transport w czasie rzeczywistym, jednak jego działanie zostanie zakończone niepowodzeniem podczas próby utworzenia połączenia. | ||
Menedżer kolejek | Wybierz lub wpisz nazwę menedżera kolejek, który udostępnia kolejkę docelową. | QMANAGER | QMGR |
Kolejka | Wybierz nazwę kolejki reprezentowaną przez miejsce docelowe. | QUEUE | QU |
Temat | Wpisz nazwę tematu reprezentowanej przez miejsce docelowe. | TOPIC | TOP |
Strona Obsługa komunikatów
W tabeli podana została lista właściwości dostępnych na stronie Obsługa komunikatów okna dialogowego właściwości miejsca docelowego. Aby skonfigurować sposób postępowania z komunikatami wysyłanymi do miejsca docelowego, edytuj właściwości na stronie Obsługa komunikatów.
Właściwość | Znaczenie | Długa nazwa | Krótka nazwa |
---|---|---|---|
Utrata ważności | Określ termin ważności komunikatu dla miejsca docelowego. Aby określić, czy termin ważności może być definiowany przez aplikację klienta JMS, kliknij opcję Aplikacja. Aby określić brak terminu ważności, kliknij opcję Nieograniczony. W przeciwnym razie podaj liczbę milisekund terminu ważności komunikatu. | EXPIRY | EXP |
Trwałość | Określa trwałość komunikatów wysyłanych do miejsca docelowego. Aby określić, że trwałość komunikatu jest definiowana przez aplikację JMS, kliknij opcję Aplikacja. Aby określić, że trwałość komunikatu przyjmuje wartość domyślną kolejki, kliknij opcję Domyślna wartość kolejki. Aby określić, że komunikaty są trwałe, kliknij opcję Trwałe. Aby określić, że komunikaty nie są trwałe, kliknij opcję Nietrwałe. Aby określić, że komunikaty nietrwałe w kolejce nie są usuwane podczas ponownego uruchomienia menedżera kolejek następującego po wygaszeniu lub natychmiastowym zamknięciu systemu, kliknij opcję Wysoka (komunikaty nietrwałe mogą nie zostać usunięte w przypadku zamknięcia systemu z wywłaszczaniem lub awarii). | PERSISTENCE | PER |
Priorytet | Określa priorytet komunikatów wysyłanych do miejsca docelowego. Aby określić, że priorytet definiowany jest przez aplikację klienta JMS, kliknij opcję Aplikacja. Aby określić, że priorytet przyjmuje wartość domyślną kolejki, kliknij opcję Wartość domyślna kolejki. W przeciwnym razie należy wpisać priorytet z zakresu od 0 do 9. | PRIORITY | PRI |
Kontekst komunikatu MQMD | Służy do określania kontekstu podczas wysyłania komunikatów
do miejsca docelowego. Do wyboru są trzy opcje: Domyślny: Wywołanie funkcji API MQOPEN i struktura MQPMO nie określa jawnych opcji kontekstu komunikatu. Jest to wartość domyślna. Ustaw cały kontekst: Opcja kontekstu komunikatu MQOO_SET_ALL_CONTEXT zostanie określona przez wywołanie funkcji API MQOPEN, a opcja MQPMO_SET_ALL_CONTEXT - przez strukturę MQPMO.Ustaw kontekst tożsamości: Opcja kontekstu komunikatu MQOO_SET_IDENTITY_CONTEXT zostanie określona przez wywołanie funkcji API MQOPEN, a opcja MQPMO_SET_IDENTITY_CONTEXT - przez strukturę MQPMO. |
MDMSGCTX | MDCTX |
Włączony zapis MQMD | Służy do określania, czy aplikacja JMS może ustawiać
wartości pól MQMD. Do wyboru są dwie opcje: Nie: Wszystkie właściwości JMS_IBM_MQMD* są ignorowane, a ich wartości nie są kopiowane do bazowej struktury MQMD. Jest to wartość domyślna. Tak: Wszystkie właściwości JMS_IBM_MQMD* są przetwarzane. Ich wartości są kopiowane do bazowej struktury MQMD. |
MDWRITE | MDW |
Włączony odczyt MQMD | Służy do określania, czy aplikacja JMS może wyodrębniać
wartości pól MQMD. Do wyboru są dwie opcje: Nie: Podczas wysyłania komunikatów właściwości JMS_IBM_MQMD* wysłanego komunikatu nie są aktualizowane w celu odzwierciedlenia zaktualizowanych wartości pól w strukturze MQMD. Podczas odbierania komunikatów żadna właściwość JMS_IBM_MQMD* nie jest dostępna w odebranym komunikacie nawet wtedy, gdy nadawca ustawił niektóre lub wszystkie z nich. Jest to wartość domyślna. Tak: Podczas wysyłania komunikatów wszystkie właściwości JMS_IBM_MQMD* wysłanego komunikatu są aktualizowane w celu odzwierciedlenia zaktualizowanych wartości pól w strukturze MQMD (w tym także te, które nie zostały jawnie ustawione przez nadawcę). Podczas odbierania komunikatów wszystkie właściwości JMS_IBM_MQMD* są dostępne w odebranym komunikacie (w tym także te, które nie zostały jawnie ustawione przez nadawcę). |
MDREAD | MDR |
Treść komunikatu | Służy do określania, czy aplikacja JMS przetwarza
strukturę MQRFH2 komunikatu produktu
IBM MQ jako część treści
komunikatu JMS. Do wyboru są trzy opcje: Nieokreślona: Podczas wysyłania komunikatów klasy IBM MQ classes for JMS generują lub nie generują oraz dołączają lub nie dołączają nagłówka MQRFH2, w zależności od wartości właściwości WMQ_TARGET_CLIENT. Podczas odbierania komunikatów działanie jest identyczne z działaniem w przypadku wartości JMS. Jest to wartość domyślna. JMS: Podczas wysyłania komunikatów klasy IBM MQ classes for JMS automatycznie generują nagłówek MQRFH2 i dołączają go do komunikatu produktu IBM MQ. Podczas odbierania komunikatów klasy IBM MQ classes for JMS ustawiają właściwości komunikatu JMS zgodnie z wartościami struktury MQRFH2 (jeśli istnieje). Struktura MQRFH2 nie jest prezentowana jako część treści komunikatu JMS.MQ: Podczas wysyłania komunikatów klasy IBM MQ classes for JMS nie generują struktury MQRFH2. Podczas odbierania komunikatów klasy IBM MQ classes for JMS prezentują strukturę MQRFH2 jako część treści komunikatu JMS. |
MSGBODY | MBODY |
Odbierz konwersję | Służy do konfigurowania użycia opcji MQGMO_CONVERT. Podczas żądania komunikatów określa, czy konwersja ma zostać przeprowadzona w menedżerze kolejek (parametr MQGMO_CONVERT komendy MQGET), czy w aplikacji klienckiej. | RECEIVECONVERSION | RCNV |
Odbierz identyfikator CCSID | Identyfikator CCSID, w który ma zostać przekształcony komunikat. Ta właściwość jest używana, gdy klasy IBM MQ classes for JMS żądają od menedżera kolejek przeprowadzenia konwersji (na przykład określając wartość WMQ_RECEIVE_CONVERSION_QMGR jako argument metody setReceiveConversion). Wartością tej właściwości jest identyfikator CCSID, w który menedżer kolejek ma przekształcić komunikat. Wartość domyślna to CCSID 1208. | RECEIVECCSID | RCCS |
Strona Broker
W tabeli podana została lista właściwości dostępnych na stronie Broker okna dialogowego właściwości obiektu docelowego. Aby udostępnić szczegóły brokera publikowania/subskrybowania, edytuj właściwości na stronie Broker.
Właściwość | Znaczenie | Długa nazwa | Krótka nazwa |
---|---|---|---|
Kolejka trwałej subskrypcji brokera | Ta właściwość może zostać użyta w kliencie JMS produktu
IBM WebSphere MQ 7.0 lub nowszego, ale
nie ma wpływu na menedżer kolejek produktu
IBM WebSphere MQ 7.0 lub nowszego. Jeśli menedżer kolejek, z którym łączy się klient JMS, jest używany przez brokera publikowania/subskrybowania, można wybrać kolejkę z menedżera kolejek brokera. Wybrany menedżer kolejek musi być uruchomiony. W przeciwnym razie należy wpisać nazwę kolejki, z której są pobierane komunikaty subskrypcji stałej. Domyślna kolejka to SYSTEM.JMS.D.SUBSCRIBER.QUEUE. |
BROKERDURSUBQ | BDSUB |
Kolejka komunikatów trwałej subskrypcji CC brokera | Ta właściwość może zostać użyta w kliencie JMS produktu
IBM WebSphere MQ 7.0 lub nowszego, ale
nie ma wpływu na menedżer kolejek produktu
IBM WebSphere MQ 7.0 lub nowszego. Jeśli menedżer kolejek, z którym łączy się klient JMS, jest używany przez brokera publikowania/subskrybowania, można wybrać kolejkę z menedżera kolejek brokera. Wybrany menedżer kolejek musi być uruchomiony. W przeciwnym razie należy wpisać nazwę kolejki, z której są pobierane komunikaty subskrypcji stałej dla obiektu ConnectionConsumer. Domyślna kolejka to SYSTEM.JMS.D.CC.SUBSCRIBER.QUEUE. |
BROKERCCDURSUBQ | CCDSUB |
Strumień zgłoszenia | Ta właściwość może zostać użyta w kliencie JMS produktu
IBM WebSphere MQ 7.0 lub nowszego, ale
nie ma wpływu na menedżer kolejek produktu
IBM WebSphere MQ 7.0 lub nowszego. Wybierz lub podaj nazwę kolejki, do której wysyłane są zgłoszone komunikaty (kolejka strumieniowa). Domyślna nazwa kolejki to SYSTEM.BROKER.DEFAULT.STREAM. Aby
użyć przycisku Wybierz w celu wpisania nazwy, należy wcześniej wybrać wartość
właściwości |
BROKERPUBQ | BPUB |
Menedżer kolejek publikacji brokera | Wybierz lub podaj nazwę menedżera kolejek będącego właścicielem kolejki, do której wysyłane są komunikaty zgłoszone w temacie. | BROKERPUBQMGR | BPQM |
Wersja brokera | Ta właściwość może zostać użyta w kliencie JMS produktu
IBM WebSphere MQ 7.0 lub nowszego, ale
nie ma wpływu na menedżer kolejek produktu
IBM WebSphere MQ 7.0 lub nowszego. Wybierz wersję używanego brokera. Należy kliknąć opcję |
BROKERVER | BVER |
Strona Producenci
W tabeli podano listę właściwości, które można ustawić na stronie Producenci w oknie dialogowym Właściwości obiektu docelowego. Aby dodatkowo zmienić właściwości obiektu docelowego, zmodyfikuj właściwości na stronie Producenci.
Właściwość | Znaczenie | Długa nazwa | Krótka nazwa |
---|---|---|---|
Zezwól na asynchroniczne operacje put | Określ, czy producenci komunikatów mogą używać asynchronicznych operacji put w celu wysyłania komunikatów do tego miejsca docelowego. Aby określić, czy producenci komunikatów są dozwoleni, przez odwołanie się do definicji kolejki lub tematu, kliknij opcję Jak miejsce docelowe (domyślna). Aby zezwolić na asynchroniczne operacje put, kliknij opcję Włączone. Aby zabronić takich operacji, kliknij opcję Wyłączone. | PUTASYNCALLOWED | PAA |
Strona Konsumenci
W tabeli podano listę właściwości, które można ustawić na stronie Konsumenci w oknie dialogowym Właściwości obiektu docelowego. Aby dodatkowo zmienić właściwości obiektu docelowego, zmodyfikuj właściwości na stronie Konsumenci.
Właściwość | Znaczenie | Długa nazwa | Krótka nazwa |
---|---|---|---|
Zezwól na odczyt z wyprzedzeniem | Określ, czy odbiorcy komunikatów i przeglądarki kolejek mogą używać operacji odczytu z wyprzedzeniem, aby pobrać nietrwałe komunikaty z tego miejsca docelowego do buforu klienta przed ich pobraniem. Aby określić, czy operacje odczytu z wyprzedzeniem są dozwolone przez odwołanie się do definicji kolejki lub tematu, kliknij opcję Jak miejsce docelowe (domyślna). Aby zezwolić na operacje odczytu z wyprzedzeniem, kliknij opcję Włączone. Aby zabronić takich operacji, kliknij opcję Wyłączone. | READAHEADALLOWED | RAA |
Strategia zamykania odczytu z wyprzedzeniem | Dla komunikatów dostarczanych do asynchronicznego obiektu nasłuchiwania komunikatów określ postępowanie z komunikatami w klienckiej kolejce proxy, gdy odbiorca komunikatów jest zamknięty. Aby wszystkie komunikaty w klienckiej kolejce proxy były dostarczane do obiektu MessageListener aplikacji przed zwróceniem, kliknij opcję Dostarczaj wszystkie (domyślna). Aby określić, że bieżące wywołanie obiektu MessageListener jest tylko kończone przed zwróceniem, potencjalnie pozostawiając dalsze komunikaty w klienckiej kolejce proxy do usunięcia, kliknij opcję Dostarczaj bieżące. | READAHEADCLOSEPOLICY | RACP |
Format znaku wieloznacznego | Określ wersję składni znaku wieloznacznego, która ma
być używana. Kliknij opcję Tylko znaki wieloznaczne na poziomie znaku, aby używać tylko znaków wieloznacznych na poziomie znaku (ze względu na spójność z aplikacjami, które używały wcześniej brokera w wersji 1. Patrz właściwość Wersja brokera). Kliknij opcję Tylko znaki wieloznaczne tematu, aby używać tylko znaków wieloznacznych na poziomie tematu, zgodnie z brokerem w wersji 2. |
WILDCARDFORMAT | WCFMT |
Strona Rozszerzone
W tabeli podano listę właściwości, które można ustawić na stronie Rozszerzone w oknie dialogowym Właściwości obiektu docelowego. Aby zmienić dodatkowe właściwości obiektu docelowego, edytuj właściwości na stronie Rozszerzone.
Właściwość | Znaczenie | Długa nazwa | Krótka nazwa |
---|---|---|---|
Identyfikator kodowanego zestawu znaków | Podaj identyfikator CCSID używany dla miejsc docelowych. | CCSID | CCS |
Kodowanie | Wybierz schemat kodowania dla miejsca docelowego. Więcej informacji zawiera sekcja Konfigurowanie obiektów JMS przy użyciu narzędzia administracyjnego w Centrum Wiedzy IBM. | ENCODING | ENC |
Błąd w przypadku wygaszania | Określ, czy wywołania do pewnych metod nie są wykonywane, jeśli menedżer kolejek jest w stanie wygaszania. Aby określić, że wywołania do pewnych metod nie są wykonywane, jeśli menedżer kolejek jest w stanie wygaszania, kliknij opcję Tak. Oznacza to, że jeśli aplikacja wykryje wygaszenie menedżera kolejek, to może zakończyć swoje zadanie i zamknąć połączenie, pozwalając na zatrzymanie menedżera kolejek. Aby określić, że wywołania metody nie zakończą się niepowodzeniem, ponieważ menedżer kolejek jest w stanie wyciszenia, kliknij opcję Nie. Oznacza to, że aplikacja nie może wykryć, że menedżer kolejek jest w stanie wyciszenia, więc może kontynuować operacje w odniesieniu do menedżera kolejek i tym samym uniemożliwić jego zatrzymanie. | FAILIFQUIESCE | FIQ |
Rozsyłanie grupowe | Określa, czy komunikaty mają być dostarczane do
odbiorców, którzy używają transportu rozsyłającego. Rozsyłanie
grupowe jest możliwe tylko dla miejsc docelowych tematów i może zostać
użyte tylko wtedy, gdy fabryka połączeń używa bezpośredniego transportu
IP. Bezpośredni transport IP jest niedostępny w produkcie
IBM MQ 8.0. W przypadku
używania produktu IBM MQ 8.0
można zdefiniować bezpośredni transport IP, jednak jego działanie zostanie
zakończone niepowodzeniem podczas próby utworzenia połączenia. Wartość domyślna to Jak dla fabryki połączeń, co oznacza, że używana jest wartość właściwości Rozsyłanie grupowe fabryki połączeń. Aby dostarczać komunikaty do odbiorcy komunikatów, który używa transportu rozsyłającego, należy kliknąć opcję Włączone. Temat musi zostać skonfigurowany w brokerze do niezawodnego rozsyłania grupowego. W takim przypadku używana jest niezawodna jakość usług. |
MULTICAST | MCAST |
Rozgłaszanie (kontynuowane) | Aby dostarczać komunikaty do odbiorcy komunikatów, który używa transportu rozsyłającego, z niezawodną jakością usług, należy kliknąć opcję Niezawodne. Temat musi być skonfigurowany do niezawodnego rozsyłania grupowego w brokerze. W przeciwnym razie nie będzie można utworzyć odbiorcy komunikatów dla tematu. Aby dostarczać komunikaty do odbiorcy komunikatów, który używa transportu rozsyłającego, bez niezawodnej jakości usług, należy kliknąć opcję Niepewne. Temat musi zostać skonfigurowany w brokerze do rozsyłania grupowego. Niezawodna jakość usług nie jest używana, nawet wtedy, gdy temat jest skonfigurowany do niezawodnego rozsyłania grupowego. |
MULTICAST | MCAST |
Klient docelowy | Należy kliknąć opcję JMS, aby określić, że obiektem docelowym komunikatu jest aplikacja JMS. Należy kliknąć opcję MQ, aby określić, że obiektem docelowym komunikatu jest aplikacja IBM MQ inna niż JMS. |
TARGCLIENT | TC |
Styl docelowy ReplyTo | Służy do określenia formatu pola JMSReplyTo. Należy kliknąć opcję Domyślny, aby użyć wartości domyślnej. Wartość domyślna jest równoznaczna z informacjami w nagłówku RFH2, chyba że została ustawiona właściwość systemowa JVM. Należy kliknąć opcję MQMD, aby użyć wartości podanej w strukturze MQMD. Pole menedżera kolejek zostanie zapełnione wartością ze struktury MQMD. Należy kliknąć opcję RFH2, aby użyć wartości podanej w nagłówku RFH2. Jeśli aplikacja wysyłająca ustawi wartość JMSReplyTo, to zostanie ona użyta. |
REPLYTOSTYLE | RTOST |
Odbierz konwersję | Służy do konfigurowania użycia opcji MQGMO_CONVERT. Podczas żądania komunikatów określa, czy konwersja ma zostać przeprowadzona w menedżerze kolejek (parametr MQGMO_CONVERT komendy MQGET), czy w aplikacji klienckiej. | RECEIVECONVERSION | RCNV |
Odbierz identyfikator CCSID | Identyfikator CCSID, w który ma zostać przekształcony komunikat. Ta właściwość jest używana, gdy klasy IBM MQ classes for JMS żądają od menedżera kolejek przeprowadzenia konwersji (na przykład określając wartość WMQ_RECEIVE_CONVERSION_QMGR jako argument metody setReceiveConversion). Wartością tej właściwości jest identyfikator CCSID, w który menedżer kolejek ma przekształcić komunikat. Wartość domyślna to CCSID 1208. | RECEIVECCSID | RCCS |