Vlastnosti tématu

Téma produktu IBM® MQ je objekt produktu IBM MQ, který identifikuje účel publikace. Můžete nastavovat vlastnosti pro témata. Některé vlastnosti témat jsou specifické pro témata systému z/OS. Některé vlastnosti lze upravit pouze při vytváření tématu. Tyto vlastnosti nelze upravit po vytvoření tématu produktu IBM MQ.

V následujících tabulkách jsou uvedeny všechny vlastnosti týkající se témat IBM MQ.

U každého atributu je uveden stručný popis, kdy může být vhodné vlastnost konfigurovat. Tabulky také uvádějí ekvivalentní parametry MQSC příkazu DEFINE, ALTER a DISPLAY TOPIC. Další informace o příkazech MQSC viz Administrace pomocí příkazů MQSC v Centrum znalostí IBM.

Obecné

V následující tabulce jsou uvedeny vlastnosti dostupné na stránce Obecné dialogového okna Vlastnosti tématu produktu IBM MQ.
Vlastnost Význam Parametr MQSC
Název tématu Tuto hodnotu nelze po vytvoření tématu změnit. Tento parametr je vyžadován a nemůže obsahovat prázdný řetězec.

Jedinečný identifikátor vytvářené definice administrativního tématu. Maximální povolená délka je 48 znaků.

Název tématu nesmí být totožný s jinou definicí tématu definovanou ve vybraném správci front.

TOPNAME
Typ tématu Tato hodnota je určena jen pro čtení. Tato hodnota určuje, zda je téma lokální (Lokální) nebo v klastru (Klastr). Není k dispozici
Řetězec tématu Tuto hodnotu nelze po vytvoření tématu změnit. Tento parametr je vyžadován a nemůže obsahovat prázdný řetězec.

Znak / má v tomto řetězci zvláštní význam. Odděluje prvky ve stromu témat. Řetězec tématu může začínat znakem /, ale není to nutné. Řetězec začínající znakem / není shodný s řetězcem, který znakem / nezačíná.

Atribut Řetězec tématu nesmí být totožný s žádným řetězcem tématu, který je již reprezentován jinou definicí objektu tématu. Maximální délka řetězce tématu je 10240 znaků.

TOPICSTR
Popis Hodnotou je řetězec zadaný administrátorem. Tento atribut obsahuje informace popisující dané téma. Musí obsahovat pouze zobrazitelné znaky. Maximální povolená délka je 64 znaků.

Jsou-li použity znaky, které nejsou obsaženy v identifikátoru CCSID (coded character set identifier) pro vybraného správce front, mohou být tyto znaky při odeslání informace jinému správci front nesprávně přeloženy.

DESC
Publikovat Tato vlastnost určuje, zda mohou být v rámci daného tématu publikovány zprávy. Výchozí hodnota je Jako nadřízené. Další dvě volby k dispozici jsou:

Hodnota Povoleno znamená, že autorizované aplikace mohou publikovat zprávy v rámci daného tématu.

Hodnota Blokováno znamená, že zprávy v rámci daného tématu nelze publikovat.

PUB
Odebírat Tato vlastnost určuje, zda mohou být v rámci daného tématu přihlášeny odběry zpráv. Výchozí hodnota je Jako nadřízené. Další dvě volby k dispozici jsou:

Hodnota Povoleno znamená, že autorizované aplikace se mohou registrovat k odběru zpráv v rámci daného tématu.

Hodnota Blokováno znamená, že se aplikace nemohou registrovat k odběru zpráv v rámci daného tématu.

SUB
Trvalé odběry Tato vlastnost určuje, zda lze v rámci daného tématu registrovat trvalé odběry. Výchozí hodnota je Jako nadřízené. Další dvě volby k dispozici jsou:

Hodnota Povoleno znamená, že se aplikace mohou registrovat k trvalému odběru zpráv v rámci daného tématu.

Hodnota Blokováno znamená, že se aplikace nemohou registrovat k trvalému odběru zpráv v rámci daného tématu.

DURSUB
Výchozí priorita Výchozí priorita zpráv publikovaných v rámci tématu. Výchozí hodnota je Jako nadřízené.

Výchozí prioritu lze nastavit v rozmezí 0 (nejnižší priorita) až 9 (nejvyšší priorita).

DEFPRTY
Výchozí trvání Výchozí trvání nového tématu má hodnotu Jako nadřízené. Výběrem hodnoty Trvalý můžete určit, že zprávy vytvořené aplikacemi, které používají volbu MQPER_PERSISTENCE_AS_Q_DEF, mají být trvalé. Výběrem hodnoty Přechodný můžete určit, že zprávy vytvořené aplikacemi, které používají volbu MQPER_PERSISTENCE_AS_Q_DEF, mají být přechodné. DEFPSIST
Trvalá modelová fronta

Hodnotou je řetězec zadaný administrátorem. Obsahuje název modelové fronty použité pro trvalé odběry, jež požadují, aby správce front spravoval místa určení svých publikování.

Maximální povolená délka názvu je 48 znaků.

Je-li toto pole prázdné, považuje se za jeho hodnotu hodnota Jako nadřízené.

Určujete-li modelovou frontu pro klastrované téma, musíte zajistit, aby byla fronta definována v každém správci front v klastru, v němž lze vytvořit trvalý odběr pomocí tohoto tématu.

Dynamická fronta vytvořená z tohoto modelu má předponu SYSTEM.MANAGED.DURABLE

MDURMDL
Netrvalá modelová fronta Hodnotou je řetězec zadaný administrátorem. Obsahuje název modelové fronty použité pro netrvalé odběry, jež požadují, aby správce front spravoval místo určení svých publikování.

Maximální povolená délka názvu je 48 znaků.

Je-li toto pole prázdné, považuje se za jeho hodnotu hodnota Jako nadřízené.

Určujete-li modelovou frontu pro klastrované téma, musíte zajistit, aby byla fronta definována v každém správci front v klastru, v němž lze vytvořit netrvalý odběr pomocí tohoto tématu.

Dynamická fronta vytvořená z tohoto modelu má předponu SYSTEM.MANAGED.NDURABLE

MNDURMDL
Dispozice QSG Dispozice skupiny sdílení front tématu. Dispozici skupiny sdílení front můžete nastavit na jednu ze tří hodnot:
  • Správce front znamená, že je definice objektu dostupná pouze pro správce front, který je jejím hostitelem.
  • Skupina znamená, že definice objektu je uložena ve sdíleném úložišti a každý správce front v rámci skupiny sdílení front má kopii této definice.
  • Kopie znamená, že definice objektu je kopií definice ze sdíleného úložiště do správce front.
Při zobrazení vlastností tématu je toto pole zobrazeno jen pro čtení.
QSGDISP
Výchozí typ odezvy put Výchozí typ odezvy pro operace put se zprávou. Výchozí hodnota je Jako nadřízené. Další dvě volby k dispozici jsou:

Synchronní - odezva je vložena synchronně.

Asynchronní - odezva je vložena asynchronně.

DEFPRESP
Doručení netrvalé zprávy

Metoda doručení pro netrvalé zprávy publikované v rámci tohoto tématu. K dispozici jsou čtyři volby:

Jako nadřízené Je použit mechanizmus doručení v závislosti na nastavení prvního nadřízeného administrativního uzlu nalezeného ve stromu tématu týkajícím se tohoto tématu. Tato hodnota je nastavena v dodávce produktu IBM MQ jako výchozí, což však mohlo být změněno při instalaci.

Všem dostupným odběratelům Netrvalé zprávy jsou doručeny všem odběratelům, kteří je mohou přijmout. Fakt, že selhalo doručení zprávy některému z odběratelů, nezabrání jejímu doručení ostatním odběratelům.

Všem trvalým odběratelům Netrvalé zprávy je třeba doručit všem trvalým odběratelům. Fakt, že selhalo doručení netrvalé zprávy některým netrvalým odběratelům neznamená, že bude na volání MQPUT vrácena chyba. Pokud selže doručení zprávy některému z trvalých odběratelů, není zpráva přijata žádným z dalších odběratelů a volání MQPUT se nezdaří.

Všem odběratelům Netrvalé zprávy je třeba doručit všem odběratelům; trvalost odběratelů nemá na úspěch volání MQPUT žádný vliv. Pokud selže doručení zprávy některému z odběratelů, není zpráva přijata žádným z dalších odběratelů a volání MQPUT se nezdaří.

NPMSGDLV
Doručení trvalé zprávy

Metoda doručení pro trvalé zprávy publikované v rámci tohoto tématu. K dispozici jsou čtyři volby:

Jako nadřízené Je použit mechanizmus doručení v závislosti na nastavení prvního nadřízeného administrativního uzlu nalezeného ve stromu tématu týkajícím se tohoto tématu. Tato hodnota je nastavena v dodávce produktu IBM MQ jako výchozí, což však mohlo být změněno při instalaci.

Všem dostupným odběratelům Trvalé zprávy jsou doručeny všem odběratelům, kteří je mohou přijmout. Fakt, že selhalo doručení zprávy některému z odběratelů, nezabrání jejímu doručení ostatním odběratelům.

Všem trvalým odběratelům Trvalé zprávy je třeba doručit všem trvalým odběratelům. Fakt, že selhalo doručení trvalé zprávy některým netrvalým odběratelům neznamená, že bude na volání MQPUT vrácena chyba. Pokud selže doručení zprávy některému z trvalých odběratelů, není zpráva přijata žádným z dalších odběratelů a volání MQPUT se nezdaří.

Všem odběratelům Trvalé zprávy je třeba doručit všem odběratelům; trvalost odběratelů nemá na úspěch volání MQPUT žádný vliv. Pokud selže doručení zprávy některému z odběratelů, není zpráva přijata žádným z dalších odběratelů a volání MQPUT se nezdaří.

PMSGDLV
Operace se zástupnými znaky Tato hodnota určuje chování odběrů používajících zástupné znaky vzhledem k tématu. K dispozici jsou dvě hodnoty:

Blokovat. Odběry registrované pro téma používající zástupné znaky, které je méně specifické než řetězec tématu tohoto objektu tématu, nebudou přijímat publikování vygenerovaná v rámci tohoto tématu ani v rámci řetězců tématu, které jsou specifičtější než toto téma.

Průchod. Odběry registrované pro téma používající zástupné znaky, které je méně specifické než řetězec tématu tohoto objektu tématu, budou přijímat publikování publikovaná v rámci tohoto tématu a v rámci řetězců tématu, které jsou specifičtější než toto téma. Toto je výchozí hodnota.

WILDCARD
Použít frontu nedoručených zpráv Určuje, zda je fronta nedoručených zpráv používána v případě, že zprávy publikování nelze doručit do správné fronty odběratele. Existují tři možné hodnoty:
  • Hodnota Ne znamená, že zprávy publikování, které nelze doručit do správné fronty odběratele, jsou považovány za selhání vložení zprávy a příkaz MQPUT aplikace pro dané téma selže v závislosti na nastavení volby Doručení netrvalé zprávy a Doručení trvalé zprávy.
  • Hodnota Ano značí, že pokud vlastnost Fronta nedoručených zpráv správce front poskytuje název fronty nedoručených zpráv, bude tento název použit. Jinak se chování shoduje s volbou Ne.
  • Hodnota Jako nadřízené značí, že rozhodnutí o použití Fronty nedoručených zpráv je založeno na nastavení nejbližšího objektu administrativního tématu ve stromu témat. Tato hodnota je nastavena v dodávce produktu IBM MQ jako výchozí, což však mohlo být změněno při instalaci.
USEDLQ
Vlastní Parametr Custom je zahrnut pouze pro použití IBM, je vyhrazen pro konfiguraci nových funkcí před zavedením oddělených vlastností. Možnými hodnotami je seznam libovolného počtu dvojic vlastnost-hodnota v syntaxi stylu produktu MQSC oddělených alespoň jednou mezerou.
V názvech vlastností a v hodnotách je rozlišována velikost písmen a musí být zadány velkými písmeny. Hodnoty mohou obsahovat mezery, závorky a apostrofy (které musí být uvozeny jiným znakem apostrofu). Ostatní znaky, včetně vnořených závorek (), mohou být uzavřeny do dvou apostrofů na obou stranách. Příklady platné syntaxe:
  • CUSTOM('')
  • CUSTOM('A(B)')
  • CUSTOM('C(D) E(F)')
  • CUSTOM('G(5000) H(''9.20.4.6(1415)'')')

Správce front danou hodnotu analyzuje, ale pokud řetězec nelze analyzovat podle těchto pravidel nebo pokud obsahuje nerozpoznané vlastnosti či hodnoty, správce front tyto chyby ignoruje.

CUSTOM

Distribuované publikování/odběr

V následující tabulce jsou uvedeny vlastnosti dostupné na stránce Distribuované publikování/odběr dialogového okna Vlastnosti tématu produktu IBM MQ.
Vlastnost Význam Parametr MQSC
Chování proxy odběru Proxy odběry jsou přidruženy k názvu správce front, který je vytvořil. V případě, že existuje proxy odběr obsahující téma publikování, jsou publikování předána pouze přímo připojeným správcům front. K dispozici jsou dvě volby:

Vynutit. To vynutí odeslání proxy odběru používajícího zástupné znaky pro řetězec tématu přidružený k tomuto objektu tématu ze všech správců front v klastru všem ostatním správcům front v topologii publikování/odběru, bez ohledu na to, zda byly zaregistrovány lokální odběry. Když je tento vynucený proxy odběr rozšířen po celé topologii, přijímají všechny nové odběry všechna publikování od ostatních připojených správců front okamžitě, bez latence, ale všechna publikování se šíří ke všem ostatním správcům front v daném klastru nezávisle na tom, zda si je nějaký odběr vyžádal, či nikoli.

Nastavení této hodnoty na dané úrovni ve stromu témat také brání generování proxy odběrů pro jednotlivé řetězce témat, které jsou odebírány na nižší úrovni stromu témat, a snižuje tak režii spojenou s proxy odběry.

První použití. V případě každého jedinečného řetězce tématu na úrovni nebo pod úrovní tohoto objektu tématu je asynchronně zaslán proxy odběr všem sousedním správcům front v těchto scénářích:
  • Když je vytvořen lokální odběr.
  • Když je přijat proxy odběr, který je třeba rozšířit k dalším přímo připojeným správcům front.
PROXYSUB
Obor publikování
Obor publikování může být řízen administrativně pomocí atributu tématu PUBSCOPE. Atribut může být nastaven na jednu z následujících tří hodnot:
  • Jako nadřízené. Toto je výchozí hodnota. Obor publikování je nastaven na stejnou hodnotu jako nadřízený správce front.
  • Správce front. Publikování bude doručeno pouze lokálním odběratelům.
  • Vše. Publikování bude doručeno lokálním odběratelům a vzdáleným odběratelům prostřednictvím přímo připojených správců front.
PUBSCOPE
Obor odběru
Obor odběrů může být řízen administrativně pomocí atributu tématu SUBSCOPE. Atribut může být nastaven na jednu z následujících tří hodnot:
  • Jako nadřízené. Toto je výchozí hodnota. Obor odběru je nastaven na stejnou hodnotu jako nadřízený správce front.
  • Správce front. Odběr přijme pouze lokální publikace a proxy odběr nebude šířen na vzdálené správce front.
  • Vše. Proxy odběr je šířen na vzdálené správce front a odběratel přijme lokální a vzdálené publikace.
SUBSCOPE
Výběrové vysílání Tato vlastnost určuje, zda je téma považováno za šiřitelné výběrovým vysíláním nebo ne. Existují čtyři možné hodnoty:

Jako nadřízené. Vlastnost výběrového vysílání tématu se dědí od nadřízeného objektu.

Zakázáno. V tomto uzlu není povolen žádný provoz výběrového vysílání.

Povoleno. V tomto uzlu je povolen provoz výběrového vysílání.

Pouze. Jsou povoleny pouze odběry z klienta podporujícího výběrové vysílání.

MCAST
Informace o komunikaci Název objektu informací o komunikaci. Jestliže se ve stromu nachází více témat vyžadujících stejné vlastnosti přenosu výběrovým vysíláním, zvažte možnost umístění těchto vlastností do samostatného objektu, na který lze odkazovat. COMMINFO

Klastr

V následující tabulce jsou uvedeny vlastnosti dostupné na stránce Klastr dialogového okna Vlastnosti tématu produktu IBM MQ.
Vlastnost Význam Parametr MQSC
Název klastru Konfigurací této vlastnosti z tématu učiníte téma klastru. Provedete-li tento úkon, pak každé téma použité vydavatelem či odběratelem v tomto bodu nebo ve stromu témat je sdíleno napříč všemi správci front v klastru a zprávy publikované do klastrované větve stromu témat se automaticky směrují k odběrům v ostatních správcích front ve klastru. CLUSTER
Stav objektu klastru
Aktuální stav tohoto objektu tématu v tomto klastru. Možné hodnoty:
AKTIVNÍ
Téma klastru je správně nakonfigurováno a drží se jej tento správce front.
NEVYŘÍZENO
Tento stav se zobrazuje pouze pro správce front hostitele a hlásí se v situaci, kdy bylo vytvořeno téma, avšak úplné úložiště dosud neprovedlo jeho rozšíření do klastru. Možným důvodem je skutečnost, že správce front hostitele není připojen k úplnému úložišti nebo úplné úložiště považuje téma za neplatné.
NEPLATNÉ
Tato definice tématu klastru koliduje s dřívější definicí v klastru, a proto není momentálně aktivní.
CHYBA
Došlo k chybě v souvislosti s tímto objektem tématu.
Tento parametr se obvykle používá k podpoře diagnostiky, je-li definováno více definic ve stejném tématu klastru v různých správcích front, přičemž tyto definice nejsou identické.
CLSTATE
Trasa klastru
Chování směrování, jež má být použito pro témata v klastru, který je definován parametrem. Existují dvě možné hodnoty:
PŘÍMÁ
Pokud nakonfigurujete přímo směrované klastrované téma ve správci front, všichni správci front ve klastru budou mít informace o všech ostatních správcích front ve klastru. Při provádění operací publikování a odběru se každý správce front připojení přímo ke všem ostatním správcům front.
HOSTITELTÉMATU
Při použití směrování hostitelů témat budou všichni správci front v klastru mít informace o správcích front klastru, které provozují definice směrovaných témat. Při provádění operací publikování a odběru se správci front v klastru připojí pouze ke správcům front hostitele tématu a nikoli přímo každý s každým. Správci front hostitele tématu odpovídají za směrování publikování ze správců front, na nichž dochází k publikování publikací, na správce front s odpovídajícími odběry.
CLROUTE

Statistika

V následující tabulce jsou uvedeny vlastnosti dostupné na stránce Statistika dialogového okna Vlastnosti tématu produktu IBM MQ.
Vlastnost Význam Parametr MQSC
Datum změny Tuto hodnotu nelze změnit a slouží pouze k informativním účelům.

Toto je datum poslední změny vlastností tématu.

ALTDATE
Čas změny Tuto hodnotu nelze změnit a slouží pouze k informativním účelům.

Toto je čas poslední změny vlastností tématu.

ALTTIME