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 SYSTEM.MANAGED.DURABLE.

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 SYSTEM.MANAGED.NDURABLE

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:
  • Menedżer kolejek oznacza, że definicja obiektu jest dostępna tylko dla menedżera kolejek, który ją przechowuje.
  • Grupa oznacza, że definicja obiektu jest składowana we współużytkowanym repozytorium i każdy menedżer kolejek w grupie współużytkowania kolejek ma kopię tej definicji.
  • Kopia oznacza, że definicja obiektu jest kopią definicji menedżera kolejek we współużytkowanym repozytorium.
Podczas wyświetlania właściwości tematu to pole jest wyświetlane jako tylko do odczytu.
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:
  • Wartość Nie oznacza, że komunikaty publikowania, których nie można dostarczyć do odpowiedniej kolejki subskrybenta, są traktowane jako niepowodzenie umieszczenia komunikatu, a wywołanie MQPUT aplikacji w temacie kończy się niepowodzeniem przy ustawieniach Dostarczenie komunikatu nietrwałego i Dostarczenie komunikatu trwałego.
  • Wartość Tak oznacza, że jeśli właściwość Kolejka niedostarczonych komunikatów menedżera kolejek udostępnia nazwę kolejki niedostarczonych komunikatów, to jest ona używana. W przeciwnym razie zachowanie jest takie jak w przypadku wartości Nie.
  • Wartość Jak element nadrzędny oznacza, że decyzja o używaniu kolejki niedostarczonych komunikatów jest oparta na ustawieniu najbliższego z administracyjnych obiektów tematów w drzewie tematów. Jest to wartość domyślna produktu IBM MQ, która jednak mogła zostać zmieniona podczas instalacji.
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:
  • CUSTOM('')
  • CUSTOM('A(B)')
  • CUSTOM('C(D) E(F)')
  • CUSTOM('G(5000) H(''9.20.4.6(1415)'')')

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:
  • Po utworzeniu subskrypcji lokalnej.
  • Po odebraniu subskrypcji proxy, która musi być propagowana do dalszych bezpośrednio połączonych menedżerów kolejek.
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:
  • Jak element nadrzędny. Jest to wartość domyślna. Zasięg publikacji jest ustawiany na tę samą wartość co nadrzędny menedżer kolejek.
  • Menedżer kolejek. Publikacja jest dostarczana tylko do subskrybentów lokalnych.
  • Wszystkie. Publikacja jest dostarczana do subskrybentów lokalnych i zdalnych przez połączone bezpośrednio menedżery kolejek.
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:
  • Jak element nadrzędny. Jest to wartość domyślna. Zasięg subskrypcji jest ustawiany na tę samą wartość co nadrzędny menedżer kolejek.
  • Menedżer kolejek. Subskrypcja otrzymuje tylko publikacje lokalne, a subskrypcje proxy nie są propagowane do zdalnych menedżerów kolejek.
  • Wszystkie. Subskrypcja proxy jest propagowana do zdalnych menedżerów kolejek, a subskrybent otrzymuje publikacje lokalne i zdalne.
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:
ACTIVE
Temat klastra jest poprawnie skonfigurowany i jest uwzględniany przez ten menedżer klastra.
PENDING
Ta wartość jest widoczna tylko przez udostępniający menedżer kolejek. Ten stan jest zgłaszany, jeśli temat został utworzony, ale pełne repozytorium jeszcze nie propagowało go do klastra. Taka sytuacja może wystąpić, kiedy udostępniający menedżer kolejek nie jest połączony z pełnym repozytorium lub pełne repozytorium uznało temat za niepoprawny.
INVALID
Ta definicja tematu klastra pozostaje w konflikcie z wcześniejszą definicją w klastrze i dlatego nie jest aktualnie aktywna.
ERROR
Wystąpił błąd dotyczący tego obiektu tematu.
Ten parametr jest zwykle używany do celów diagnostycznych, kiedy wiele definicji tego samego tematu klastra zostaje zdefiniowanych w różnych menedżerach kolejek, a definicje nie są identyczne.
CLSTATE
Kierowanie klastra
Kierowanie używane na potrzeby tematów w klastrze zdefiniowanym przez parametr CLUSTER. Istnieją dwie możliwe wartości:
DIRECT
Po skonfigurowaniu bezpośredniego kierowanego tematu klastra w menedżerze kolejek wszystkie menedżery kolejek w klastrze będą powiadomione o obecności wszystkich innych menedżerów kolejek w klastrze. Podczas wykonywania operacji publikowania i subskrypcji każdy menedżer kolejek nawiązuje następnie bezpośrednie połączenie ze wszystkimi pozostałymi menedżerami.
TOPICHOST
Jeśli używane jest kierowanie hostami tematów, wszystkie menedżery kolejek w klastrze będą powiadomione o menedżerach kolejek klastra, które udostępniają definicje kierowanych tematów. Podczas wykonywania operacji publikowania i subskrypcji menedżery kolejek w klastrze nawiązują połączenie tylko z tymi menedżerami kolejek hostów tematów, a nie bezpośrednio ze sobą. Menedżery kolejek hostów tematów są odpowiedzialne za kierowanie publikacji z menedżerów kolejek, na których publikacje są publikowane, do menedżerów kolejek ze zgodnymi subskrypcjami.
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