Właściwości tematu
Temat produktu IBM® MQ jest obiektem produktu IBM MQ identyfikującym informacje, których dotyczy publikowanie. Istnieje możliwość ustawienia właściwości tematów. Niektóre właściwości tematu są specyficzne dla tematów systemu z/OS. Niektóre właściwości można zmienić tylko podczas tworzenia tematu. Nie można zmodyfikować tych właściwości po utworzeniu tematu produktu IBM MQ.
W poniższych tabelach przedstawiono wszystkie właściwości tematów produktu IBM MQ.
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 można także podać równoważne parametry MQSC dla komend DEFINE, ALTER i DISPLAY TOPIC. Więcej informacji o komendach MQSC zawiera sekcja Administrowanie za pomocą komend MQSC w Centrum Wiedzy IBM.
Ogólne
W poniższej tabeli przedstawiono właściwości dostępne na stronie Ogólne okna dialogowego Właściwości tematu produktu IBM MQ.Właściwość | Znaczenie | Parametr MQSC |
---|---|---|
Nazwa tematu | Po utworzeniu tematu nie można zmienić tej wartości. Ten parametr jest wymagany i nie może zawierać pustego
łańcucha. Należy utworzyć unikalny identyfikator definicji tematu administracyjnego. Dozwolonych jest maksymalnie 48 znaków. Właściwość Nazwa tematu musi się różnić od innych definicji tematów zdefiniowanych dla wybranego menedżera kolejek. |
TOPNAME |
Typ tematu | Ta wartość jest tylko do odczytu. Wartość ta wskazuje, czy temat jest lokalny (Lokalny ) lub znajduje się w klastrze (Klaster ). |
Nie dotyczy |
Łańcuch tematu | Po utworzeniu tematu nie można zmienić tej wartości. Ten parametr jest wymagany i nie może zawierać pustego
łańcucha. Znak ukośnika (/) w tym łańcuchu ma specjalne znaczenie. Znak ten oddziela elementy w drzewie tematów. Łańcuch tematu może zaczynać się od znaku ukośnika (/), ale nie jest to wymagane. Łańcuch zaczynający się od znaku ukośnika (/) różni się od łańcucha, który nie zaczyna się od tego znaku. Parametr Łańcuch tematu musi się różnić od innych łańcuchów tematu, które są już reprezentowane w innych definicjach obiektów tematu. Maksymalna długość łańcucha tematu to 10 240 znaków. |
TOPICSTR |
Opis | Wartość ta stanowi łańcuch wprowadzony przez administratora.
Zawiera ona opisowe informacje dotyczące
temat. Wartość ta musi zawierać tylko znaki możliwe do wyświetlenia. Maksymalnie 64 znaki. Jeśli użyto znaków, które nie znajdują się w identyfikatorze CCSID dla wybranego menedżera kolejek, mogą one zostać przetłumaczone niepoprawnie w przypadku przesłania informacji do innego menedżera kolejek. |
DESC |
Publikowanie | Ta właściwość określa, czy w temacie można publikować komunikaty. Wartość domyślna to Jak element
nadrzędny.
Dwie inne dostępne opcje to: Dozwolone, która oznacza, że komunikaty mogą być publikowane w temacie przez autoryzowaną aplikację. Zablokowane, która oznacza, że nie można publikować komunikatów w temacie. |
PUB |
Subskrybowanie | Ta właściwość określa, czy komunikaty mogą subskrybować temat. Wartość domyślna to Jak element
nadrzędny.
Dwie inne dostępne opcje to: Dozwolone, która oznacza, że autoryzowana aplikacja może zasubskrybować temat. Zablokowane, która oznacza, że aplikacje nie mogą subskrybować tematu. |
SUB |
Subskrypcje stałe | Ta właściwość określa, czy temat umożliwia dokonywanie subskrypcji stałych. Wartość domyślna to Jak element
nadrzędny. Dwie inne dostępne opcje to: Dozwolone, która oznacza, że autoryzowana aplikacja może dokonywać stałych subskrypcji tematu. Zablokowane, która oznacza, że autoryzowana aplikacja nie może dokonywać stałych subskrypcji tematu. |
DURSUB |
Priorytet domyślny | Domyślny priorytet komunikatów publikowanych w tym temacie. Wartość domyślna to Jak element
nadrzędny. Priorytet domyślny można ustawić w zakresie od 0 (najniższy priorytet) do 9 (najwyższy priorytet). |
DEFPRTY |
Trwałość domyślna | Trwałość domyślna nowej kolejki to Jak element nadrzędny. Wybierz opcję Trwałe, aby określić, że komunikaty tworzone przez aplikacje używające opcji MQPER_PERSISTENCE_AS_Q_DEF mają być trwałe. Wybierz opcję Nietrwałe, aby określić, że komunikaty tworzone przez aplikacje używające opcji MQPER_PERSISTENCE_AS_Q_DEF mają być nietrwałe. | DEFPSIST |
Trwała kolejka modelu | Wartość ta stanowi łańcuch wprowadzony przez administratora. Zawiera ona nazwę kolejki modelowej, która ma być używana dla stałych subskrypcji wysyłających do menedżera kolejek żądania zarządzania miejscem docelowym ich publikacji. Dozwolonych jest maksymalnie 48 znaków dla nazwy. Jeśli to pole jest puste, jest traktowane jako wartość Jak element nadrzędny. W przypadku określania kolejki modelowej dla klastrowego tematu należy się upewnić, że kolejka została zdefiniowana w każdym menedżerze kolejek w klastrze, gdzie można utworzyć stałą subskrypcję używającą tego tematu. Kolejka dynamiczna utworzona na podstawie tego modelu ma przedrostek |
MDURMDL |
Nietrwała kolejka modelu | Wartość ta stanowi łańcuch wprowadzony przez administratora.
Zawiera ona nazwę kolejki modelowej, która ma być
używana dla niestałych subskrypcji wysyłających do menedżera kolejek żądania zarządzania miejscem docelowym ich publikacji. Dozwolonych jest maksymalnie 48 znaków dla nazwy. Jeśli to pole jest puste, jest traktowane jako wartość Jak element nadrzędny. W przypadku określania kolejki modelowej dla klastrowego tematu należy się upewnić, że kolejka została zdefiniowana w każdym menedżerze kolejek w klastrze, gdzie można utworzyć niestałą subskrypcję używającą tego tematu. Kolejka dynamiczna utworzona na podstawie tego modelu ma przedrostek |
MNDURMDL |
Dyspozycja QSG | Dyspozycja tematu dotycząca grupy współużytkowania kolejek.
Dyspozycji grupy współużytkowania kolejek można nadać
jedną z trzech wartości:
|
QSGDISP |
Operacja put - domyślna odpowiedź | Domyślny typ odpowiedzi dla operacji put dla komunikatów.
Wartość domyślna to Jak element
nadrzędny. Dwie inne dostępne opcje to: Synchroniczna oznaczająca, że odpowiedź jest umieszczana synchronicznie. Asynchroniczna oznaczająca, że odpowiedź jest umieszczana asynchronicznie. |
DEFPRESP |
Dostarczenie komunikatu nietrwałego | Metoda dostarczania nietrwałych komunikatów publikowanych w tym temacie. Istnieją cztery opcje: Jak element nadrzędny: Używany mechanizm dostarczania zależy od ustawienia pierwszego nadrzędnego węzła administracyjnego znalezionego w drzewie tematów i dotyczącego tego tematu. Jest to wartość domyślna produktu IBM MQ, która jednak mogła zostać zmieniona podczas instalacji. Do wszystkich dostępnych subskrybentów: Komunikaty nietrwałe są dostarczane do wszystkich subskrybentów, którzy mogą zaakceptować komunikat. Niepowodzenie dostarczenia komunikatu do dowolnego subskrybenta nie uniemożliwia innym subskrybentom otrzymania tego komunikatu. Do wszystkich trwałych subskrybentów: Komunikaty nietrwałe muszą zostać dostarczone do wszystkich stałych subskrybentów. Niepowodzenie dostarczenia komunikatu nietrwałego do dowolnego z niestałych subskrybentów nie powoduje zwrócenia błędu do wywołania MQPUT. Jeśli wystąpi niepowodzenie dostarczenia do stałego subskrybenta, żadni inni subskrybenci nie otrzymają komunikatu i wywołanie MQPUT nie powiedzie się. Do wszystkich subskrybentów: Komunikaty nietrwałe muszą zostać dostarczone do wszystkich subskrybentów bez względu na stałość, aby wywołanie MQPUT mogło zgłosić powodzenie. Jeśli wystąpi niepowodzenie dostarczenia do dowolnego subskrybenta, żadni inni subskrybenci nie otrzymają komunikatu i wywołanie MQPUT nie powiedzie się. |
NPMSGDLV |
Dostarczenie komunikatu trwałego | Metoda dostarczania trwałych komunikatów publikowanych w tym temacie. Dostępne są cztery opcje: Jak element nadrzędny: Używany mechanizm dostarczania zależy od ustawienia pierwszego nadrzędnego węzła administracyjnego znalezionego w drzewie tematów i dotyczącego tego tematu. Jest to wartość domyślna produktu IBM MQ, która jednak mogła zostać zmieniona podczas instalacji. Do wszystkich dostępnych subskrybentów: Komunikaty trwałe są dostarczane do wszystkich subskrybentów, którzy mogą zaakceptować komunikat. Niepowodzenie dostarczenia komunikatu do dowolnego subskrybenta nie uniemożliwia innym subskrybentom otrzymania tego komunikatu. Do wszystkich trwałych subskrybentów: Komunikaty trwałe muszą zostać dostarczone do wszystkich stałych subskrybentów. Niepowodzenie dostarczenia komunikatu trwałego do dowolnego z niestałych subskrybentów nie powoduje zwrócenia błędu do wywołania MQPUT. Jeśli wystąpi niepowodzenie dostarczenia do stałego subskrybenta, żadni inni subskrybenci nie otrzymają komunikatu i wywołanie MQPUT nie powiedzie się. Do wszystkich subskrybentów: Komunikaty trwałe muszą zostać dostarczone do wszystkich subskrybentów bez względu na stałość, aby wywołanie MQPUT mogło zgłosić powodzenie. Jeśli wystąpi niepowodzenie dostarczenia do dowolnego subskrybenta, żadni inni subskrybenci nie otrzymają komunikatu i wywołanie MQPUT nie powiedzie się. |
PMSGDLV |
Operacja na znakach wieloznacznych | Ta wartość określa zachowanie subskrypcji ze znakami wieloznacznymi w odniesieniu
do tego tematu. Możliwe są dwie wartości: Blokada. Subskrypcje tematu ze znakami wieloznacznymi, który jest mniej konkretny niż łańcuch tematu w tym obiekcie tematu, nie otrzymują publikacji zamieszczonych w tym temacie i w łańcuchach tematów bardziej konkretnych niż ten temat. Tranzyt. Subskrypcje tematu ze znakami wieloznacznymi, który jest mniej konkretny niż łańcuch tematu w tym obiekcie tematu, otrzymują publikacje zamieszczone w tym temacie i w łańcuchach tematów bardziej konkretnych niż ten temat. Jest to wartość domyślna. |
WILDCARD |
Użyj kolejki niedostarczonych komunikatów | Służy do określania, czy kolejka niedostarczonych komunikatów jest używana, gdy nie można
dostarczyć komunikatów publikacji do odpowiedniej kolejki subskrybenta. Istnieją trzy możliwe wartości:
|
USEDLQ |
Niestandardowe | Parametr Niestandardowy jest przeznaczony tylko do użytku z IBM i zastrzeżony dla konfiguracji nowych
składników przed wprowadzeniem oddzielnych właściwości. Dopuszczalne wartości to
lista zawierająca zero lub więcej par właściwość-wartość o składni w stylu komend
MQSC rozdzielonych co najmniej jedną spacją. W nazwach i
wartościach właściwości jest rozróżniana wielkość liter i muszą one być podane
wielkimi literami. Wartości mogą zawierać spacje, nawiasy i apostrofy (przy czym każdy apostrof należy poprzedzić dodatkowym apostrofem jako znakiem zmiany znaczenia). Inne znaki, w tym zagnieżdżone nawiasy (), można stosować, pod warunkiem że zostają ujęte w apostrofy. Przykłady poprawnej składni:
Menedżer kolejek analizuje wartość, ale jeśli nie można przeprowadzić analizy łańcucha zgodnie z tymi regułami lub jeśli zawiera on właściwości albo wartości, które nie zostały rozpoznane, menedżer kolejek zignoruje błędy. |
CUSTOM |
Rozproszone publikowanie/subskrypcja
W poniższej tabeli przedstawiono właściwości dostępne na stronie Rozproszone publikowanie/subskrypcja okna dialogowego Właściwości tematu produktu IBM MQ.Właściwość | Znaczenie | Parametr MQSC |
---|---|---|
Zachowanie subskrypcji proxy | Subskrypcje proxy są powiązane z nazwą menedżera kolejek, który je utworzył. Publikacje są przekazywane do
połączonych bezpośrednio menedżerów kolejek tylko w przypadku, gdy istnieje subskrypcja proxy obejmująca temat publikacji. Dostępne
są dwie opcje dla tej wartości: Wymuszenie. Wymusza wysłanie subskrypcji proxy ze znakami wieloznacznymi dla łańcucha tematu powiązanego z tym obiektem tematu z każdego menedżera kolejek znajdującego się w klastrze do pozostałych menedżerów kolejek w topologii publikowania/subskrypcji niezależnie od tego, czy dokonano jakichś subskrypcji lokalnych. Po rozpropagowaniu tej wymuszonej subskrypcji proxy w topologii wszystkie nowe subskrypcje będą natychmiast odbierać publikacje od innego połączonego menedżera kolejek bez żadnego opóźnienia, mimo że wszystkie publikacje są propagowane na wszystkie pozostałe menedżery kolejek w klastrze niezależnie od ustawienia żądania publikacji przez subskrypcję. Ustawienie tej wartości na dany poziom w drzewie tematów zapobiega również generowaniu subskrypcji proxy dla poszczególnych łańcuchów tematów na kolejnych poziomach drzewa tematu, co zmniejsza narzut subskrypcji proxy. Pierwsze użycie. Dla
każdego unikalnego łańcucha tematu w tym obiekcie tematu lub poniżej
subskrypcja proxy jest asynchronicznie wysyłana do wszystkich sąsiednich
menedżerów kolejek w następujących sytuacjach:
|
PROXYSUB |
Zasięg publikacji |
Zasięg publikacji może być sterowany administracyjnie przy użyciu atrybutu tematu PUBSCOPE. Atrybut ten można ustawić na jedną z trzech następujących wartości:
|
PUBSCOPE |
Zasięg subskrypcji |
Zasięg subskrypcji może być sterowany administracyjnie przy użyciu atrybutu tematu SUBSCOPE. Atrybut ten można ustawić na jedną z trzech następujących wartości:
|
SUBSCOPE |
Rozsyłanie grupowe | Ta właściwość wskazuje, czy dany temat może być przesyłany z użyciem rozsyłania, czy nie. Istnieją cztery możliwe wartości: Jak element nadrzędny. Właściwość rozsyłania jest dziedziczona z tematu nadrzędnego. Wyłączone. W danym węźle nie można stosować rozsyłania. Włączone. W danym węźle można stosować rozsyłanie. Tylko. Dozwolone są wyłącznie subskrypcje pochodzące z klienta obsługującego rozsyłanie. |
MCAST |
Informacje o komunikacji | Nazwa obiektu informacji o komunikacji. Ponieważ w drzewie istnieje kilka tematów wymagających tych samych właściwości transmisji z użyciem rozsyłania, można te właściwości traktować jako osobny obiekt, który można przywoływać. | COMMINFO |
Klaster
W poniższej tabeli przedstawiono właściwości dostępne na stronie Klaster okna dialogowego Właściwości tematu produktu IBM MQ.Właściwość | Znaczenie | Parametr MQSC |
---|---|---|
Nazwa klastra | Należy skonfigurować tę właściwość, aby utworzyć temat, który będzie tematem klastra. W takiej sytuacji każdy temat użyty przez publikator lub subskrybent w tym punkcie lub w drzewie tematów jest współużytkowany ze wszystkimi menedżerami kolejek w klastrze. Komunikaty publikowane w klastrowej gałęzi drzewa tematów są automatycznie kierowane do subskrypcji i innych menedżerów kolejek w klastrze. | CLUSTER |
Stan obiektu klastra |
Bieżący stan tego obiektu tematu w tym klastrze. Wartości mogą być następujące:
|
CLSTATE |
Kierowanie klastra |
Kierowanie używane na potrzeby tematów w klastrze zdefiniowanym przez parametr CLUSTER. Istnieją dwie możliwe wartości:
|
CLROUTE |
Statystyka
W poniższej tabeli przedstawiono właściwości dostępne na stronie Statystyka okna dialogowego Właściwości tematu produktu IBM MQ.Właściwość | Znaczenie | Parametr MQSC |
---|---|---|
Data zmiany | Tej wartości nie można zmienić. Jest ona udostępniana tylko w celach informacyjnych. Jest to data ostatniej zmiany właściwości tematu. |
ALTDATE |
Godzina zmiany | Tej wartości nie można zmienić. Jest ona udostępniana tylko w celach informacyjnych. Jest to godzina ostatniej zmiany właściwości tematu. |
ALTTIME |