Specifikace aktivace JMS je přidružena k jednomu nebo více objektům typu message-driven bean a poskytuje konfiguraci umožňující jejich příjem zpráv.
Specifikaci aktivace JMS vytvořte v případě, že chcete používat objekt typu message-driven bean ke komunikaci s výchozím poskytovatelem systému zpráv prostřednictvím architektury JCA (Java Connector Architecture) 1.5. Architektura JCA poskytuje konektivitu jazyka Java mezi aplikačními servery, jako je například server WebSphere Application Server, a podnikovými informačními systémy. Poskytuje standardizovaný způsob integrace poskytovatelů rozhraní JMS s aplikačními servery s prostředím Java EE a strukturu pro výměny dat s podnikovými systémy, přičemž přenos dat probíhá ve formě zpráv.
Všechny konfigurační vlastnosti specifikace aktivace kromě vlastností Název, Název rozhraní JNDI, Název rozhraní cílového JNDI a Alias ověřování jsou přepsány vlastnostmi konfigurace aktivace s odpovídajícími názvy v deskriptoru implementace přidruženého objektu typu message-driven bean sady EJB verze 2.1 nebo novější. U objektu typu message-driven bean sady EJB 2.0 jsou vlastnosti Typ cíle, Trvalost odběru, Režim potvrzení a Selektor zpráv přepsány odpovídajícími prvky v deskriptoru implementace. Pro kterýkoli typ objektu bean lze vlastnost Název cílového rozhraní JNDI přepsat hodnotou určenou v rámci vazeb objektu typu message-driven bean.
Vlastnosti specifikace aktivace mají vliv na způsob, kterým výchozí poskytovatel systému zpráv volí stroj systému zpráv, ke kterému se aplikace objektu typu message-driven bean připojuje. Při výchozím nastavení prostředí automaticky připojuje aplikace ke stroji systému zpráv, který je ve sběrnici k dispozici. Můžete však určit další podrobnosti konfigurace, které budou mít vliv na proces připojení; můžete například identifikovat speciální servery samozavedení nebo omezit připojení na podskupinu strojů systému zpráv, které jsou k dispozici, zlepšit dostupnost či výkon nebo zajistit sekvenční zpracování přijatých zpráv. Informace týkající se důvodu a způsobu provedení této operace naleznete v tématu Způsob připojování aplikací rozhraní JMS ke stroji systému zpráv ve sběrnici.
Na kartě Konfigurace jsou uvedeny konfigurační vlastnosti pro tento objekt. Tyto hodnoty vlastností jsou zachovány i v případě, že je běhové prostředí zastaveno a restartováno. Informace o použití změn konfigurace v běhovém prostředí najdete v popisech úloh v Informačním centru.
Určuje nejvyšší úroveň topologie, na které mohou aplikační servery používat tento objekt prostředků.
| Informace | Hodnota |
|---|---|
| Vyžadováno | Ne |
| Datový typ | Řetězec |
Určuje poskytovatele JMS, který povoluje asynchronní výměnu zpráv založenou na službě JMS (Java Message Service). Poskytuje továrny připojení J2EE pro vytváření připojení pro specifickou frontu nebo místa určení JMS. Administrační objekty poskytovatele JMS slouží ke správě prostředků JMS pro přidruženého poskytovatele JMS.
| Informace | Hodnota |
|---|---|
| Vyžadováno | Ne |
| Datový typ | Řetězec |
Povinný zobrazovaný název prostředku.
| Informace | Hodnota |
|---|---|
| Vyžadováno | Ano |
| Datový typ | Řetězec |
Název rozhraní JNDI prostředku.
| Informace | Hodnota |
|---|---|
| Vyžadováno | Ano |
| Datový typ | Řetězec |
Volitelný popis prostředku.
| Informace | Hodnota |
|---|---|
| Vyžadováno | Ne |
| Datový typ | Textová oblast |
Určuje, zda objekt typu message-driven bean používá místo určení tématu nebo fronty.
| Informace | Hodnota |
|---|---|
| Vyžadováno | Ano |
| Datový typ | rozevírací seznam |
| Rozsah |
|
Název rozhraní JNDI místa určení
Ve vlastnosti Typ cíle vyberte typ místa určení.
Pro adaptéry prostředků, které podporují rozhraní JMS, přidejte parametr javax.jms.Destinations, aby mohl adaptér prostředků obsluhovat zprávy z rozhraní JMS místa určení. V tomto případě administrátor konfiguruje administrovaný objekt J2C, který implementuje rozhraní javax.jms.Destination a sváže je s rozhraním JNDI.
Administrovaný objekt J2C můžete konfigurovat, aby používal třídu specifikace aktivace, která implementuje metodu setDestination(javax.jms.Destination). V tomto případě můžete zadat název cílového rozhraní JNDI (tedy název rozhraní JNDI pro administrovaný objekt J2C, který implementuje rozhraní javax.jms.Destination).
V průběhu spouštění aplikace při inicializaci specifikace aktivace v rámci aktivace koncového bodu server název cílového rozhraní JNDI používá k vyhledání cílového administrovaného objektu a poté jej nastaví na instanci specifikace aktivace.
| Informace | Hodnota |
|---|---|
| Vyžadováno | Ano |
| Datový typ | Řetězec |
Selektor zpráv JMS slouží k určení zpráv, které přijímá objekt typu message-driven bean. Hodnotou je řetězec používaný pro výběr dílčí sady zpráv, které jsou k dispozici. Syntaxe je založena na dílčí sadě syntaxe podmíněných výrazů specifikace SQL 92 popsané ve specifikaci rozhraní JMS. Další informace naleznete v Informačním centru.
JMSType='car' AND color='blue' AND weight>2500
Řetězec selektoru může odkazovat na pole v záhlaví zpráv rozhraní JMS a ve vlastnostech zprávy. Selektory zpráv nemohou odkazovat na hodnoty těla zpráv.
Hodnota null (prázdný řetězec) indikuje, že pro daného spotřebitele zpráv neexistuje selektor zpráv.
| Informace | Hodnota |
|---|---|
| Vyžadováno | Ne |
| Datový typ | Řetězec |
Název sběrnice pro připojení.
| Informace | Hodnota |
|---|---|
| Vyžadováno | Ne |
| Datový typ | Vlastní |
Určuje způsob, jakým relace potvrzuje veškeré zprávy, které přijímá.
Po odstranění zprávy bude odesláno potvrzení.
Zpráva bude při spuštění objektu bean odstraněna tehdy, pokud je pro kvalitu služby zadána hodnota Nejlepší snaha, přechodné. Při zadání všech ostatních hodnot kvality služby bude zpráva odstraněna až při dokončení zpracování objektu bean.
| Informace | Hodnota |
|---|---|
| Vyžadováno | Ne |
| Datový typ | rozevírací seznam |
| Rozsah |
|
Název cíle, který identifikuje skupinu strojů systému zpráv. Typ cíle určete pomocí vlastnosti Typ cíle.
| Informace | Hodnota |
|---|---|
| Vyžadováno | Ne |
| Datový typ | Řetězec |
Typ cíle pojmenovaný v cílové vlastnosti.
| Informace | Hodnota |
|---|---|
| Vyžadováno | Ne |
| Datový typ | rozevírací seznam |
| Rozsah |
|
Tato vlastnost určuje významnost skupiny cílů.
| Informace | Hodnota |
|---|---|
| Vyžadováno | Ne |
| Datový typ | rozevírací seznam |
| Rozsah |
|
Název příchozího transportního řetězu, který by měl být cílem aplikace při připojování ke stroji systému zpráv v samostatném procesu vzhledem k aplikaci. Pokud je zvolen stroj systému zpráv v jiném procesu, lze připojení vytvořit pouze v případě, že je stroj systému zpráv umístěn na serveru, na němž je spouštěn určený příchozí transportní řetěz. Další informace naleznete v Informačním centru.
Nachází-li se vybraný stroj systému zpráv na stejném serveru jako aplikace, je vytvořeno přímé připojení v rámci procesu a daná vlastnost transportního řetězce je ignorována.
| Informace | Hodnota |
|---|---|
| Vyžadováno | Ne |
| Datový typ | Řetězec |
Seznam trojic koncových bodů (s čárkami jako oddělovači) se syntaxí název_hostitele:číslo_portu:název_řetězu, který je používán pro připojování k serveru samozavedení. Příklad: Merlin:7276:BootstrapBasicMessaging,Gandalf:5557:BootstrapSecureMessaging.
Není-li určen název hostitele, bude jako výchozí hodnota použit název localhost.
Není-li určeno číslo portu, bude jako výchozí hodnota použito číslo 7276.
Není-li určen protokol, bude jako výchozí hodnota použit předdefinovaný řetěz, například BootstrapBasicMessaging.
| Informace | Hodnota |
|---|---|
| Vyžadováno | Ne |
| Datový typ | Textová oblast |
Maximální počet zpráv, které lze přijmout ze stroje systému zpráv v jediné dávce.
| Informace | Hodnota |
|---|---|
| Vyžadováno | Ne |
| Datový typ | Celé číslo |
| Rozsah | 1 až 2147483647 |
Maximální počet koncových bodů, do kterých mohou být zprávy odesílány souběžně.
| Informace | Hodnota |
|---|---|
| Vyžadováno | Ne |
| Datový typ | Celé číslo |
| Rozsah | 1 až 2147483647 |
Tyto parametry umožňují automatické zastavení koncového bodu, dosáhne-li počet po sobě jdoucích zpráv, které selhaly, zadaného limitu. Díky tomu lze lépe rozlišovat mezi jednou či dvěma zprávami, které selhaly v důsledku problémů přímo s těmito zprávami, a problému se systémovými prostředky, v jehož důsledku selže mnoho po sobě jdoucích zpráv.
Při automatickém zastavení koncového bodu je jeho stav v administrativní konzole vyznačen červeně. Je nutné ho ručně restartovat klepnutím na tlačítko Pokračovat.
Jakmile je koncový bod restartován, jsou zopakovány všechny chybné zprávy, které způsobily zastavení koncového bodu. Pokud jsou tyto zprávy stále chybné, jsou přesunuty do cíle výjimek (je-li nakonfigurováno).
Povolení automatického zastavování koncového bodu na základě parametrů uvedených dále.
| Informace | Hodnota |
|---|---|
| Vyžadováno | Ne |
| Datový typ | Logický |
Koncový bod bude zastaven, pokud počet po sobě jdoucích zpráv, pro něž dojde k selhání, dosáhne nastavené mezní hodnoty. V důsledku závislostí zpracování v rámci objektu typu message-driven bean může skutečný počet zpracovaných zpráv tuto hodnotu překročit.
Tato vlastnost není povolena, dokud není povolena vlastnost Automaticky zastavovat koncové body při selhání kvůli opakující se zprávě.
| Informace | Hodnota |
|---|---|
| Vyžadováno | Ne |
| Datový typ | Celé číslo |
Pro každou zprávu, kterou se objektu typu message-driven bean nedaří zpracovat, ale nedosáhla maximální mezní hodnoty pro doručování při selhání, bude proveden další pokus až po uplynutí tohoto časového úseku (v milisekundách). Během tohoto období lze provádět další pokusy pro jiné zprávy, není-li pro prahovou hodnotu selhání v posloupnosti a pro hodnotu maximální souběžnosti nastavena hodnota 1.
Při nastavení prodlevy mezi opakovanými pokusy pro zprávy, které selhaly, se sníží počet zpráv zbytečně přesouvaných do cíle výjimek před zastavením činnosti aplikace objektu typu message-driven bean (MDB). Chcete-li minimalizovat počet přesouvaných zpráv, zadejte pro tuto prodlevu větší hodnotu než očekávaný časový interval mezi zprávami přicházejícími do místa určení.
Tato vlastnost není povolena, dokud není povolena vlastnost Automaticky zastavovat koncové body při selhání kvůli opakující se zprávě.
| Informace | Hodnota |
|---|---|
| Vyžadováno | Ne |
| Datový typ | Celé číslo |
| Rozsah | Doba v milisekundách. Hodnota 0 označuje nulovou prodlevu mezi opakováními. |
Určuje, zda je odběr tématu JMS trvalý nebo dočasný.
| Informace | Hodnota |
|---|---|
| Vyžadováno | Ne |
| Datový typ | rozevírací seznam |
| Rozsah |
|
Název odběru potřebný pro trvalé odběry témat. Povinné pole při použití trvalého odběru tématu.
Tento název odběru musí být v daném identifikátoru klienta jedinečný.
| Informace | Hodnota |
|---|---|
| Vyžadováno | Ne |
| Datový typ | Řetězec |
Identifikátor klienta JMS potřebný pro trvalé odběry témat u všech připojení vytvořených s použitím této specifikace aktivace.
| Informace | Hodnota |
|---|---|
| Vyžadováno | Ne |
| Datový typ | Řetězec |
Název stroje systému zpráv použitého při ukládání zpráv doručených v rámci trvalých odběrů pro objekty vytvořené na základě této aktivace specifikace JMS. Jde o povinné pole při použití trvalého odběru tématu.
| Informace | Hodnota |
|---|---|
| Vyžadováno | Ne |
| Datový typ | Řetězec |
Je-li tato volba povolena, budou data objektových zpráv přijatých prostřednictvím této specifikace aktivace serializována systémem pouze v případě, kdy to bude skutečně nutné. Data získaná z těchto zpráv musí být aplikacemi zpracovávána jako data jen pro čtení.
| Informace | Hodnota |
|---|---|
| Vyžadováno | Ne |
| Datový typ | Logický |
Je-li tato volba povolena, nebudou data objektových či bajtových zpráv přeposlaných prostřednictvím této specifikace aktivace, jejichž zátěž bude upravena, po vložení do zprávy kopírována a budou serializována systémem pouze v případě, kdy to bude skutečně nutné. Aplikace odesílající takové zprávy nesmějí upravovat dat po jejich vložení do zprávy.
| Informace | Hodnota |
|---|---|
| Vyžadováno | Ne |
| Datový typ | Logický |
Dopředné čtení je metoda optimalizace, při které jsou zprávy preemptivně přiřazovány spotřebitelům. Zkracuje čas nutný k vyřízení požadavků spotřebitele.
Zprávy přiřazené spotřebiteli jsou uzamčeny na serveru a nelze je spotřebovat jinými spotřebiteli daného cíle. Zprávy přiřazené spotřebiteli, které nebyly spotřebovány před uzavřením spotřebitele, jsou poté odemčeny na serveru a dány k dispozici k příjmu jinými spotřebiteli.
Tuto vlastnost lze přepsat pro jednotlivé cíle služby JMS nastavením vlastnosti Dopředné čtení v cíli služby JMS.
| Informace | Hodnota |
|---|---|
| Vyžadováno | Ne |
| Datový typ | rozevírací seznam |
| Rozsah |
|
Tato vlastnost se používá pouze v případě, že je aplikace objektu typu message-driven bean spuštěna na serveru, který je členem sběrnice, jež je cílem příslušné aplikace. Je-li objekt typu message-driven bean spuštěn na serveru, který není členem cílové sběrnice, tato vlastnost se nijak neprojeví.
Je-li aplikace objektu typu message-driven bean spuštěna na serveru, který je členem cílové sběrnice, povolením této volby umožníte této aplikaci zpracovávat zprávy bez ohledu na to, zda je server také hostitelem spuštěného stroje systému zpráv. Není-li tato volba povolena, aplikace objektu typu message-driven bean na serverech, na nichž není spuštěn lokální stroj systému zpráv, nezpracovávají zprávy.
Další informace naleznete v tématu Způsob připojování objektů typu message-driven bean v klastru.
| Informace | Hodnota |
|---|---|
| Vyžadováno | Ne |
| Datový typ | Logický |
Prodleva (v sekundách) mezi pokusy o připojení ke stroji systému zpráv pro počáteční připojení i pro veškeré následné pokusy o navázání lepšího připojení.
| Informace | Hodnota |
|---|---|
| Vyžadováno | Ne |
| Datový typ | Celé číslo |
| Rozsah | 1 až 2147483647 |
Alias ověřování J2C pro ověřování řízené komponentami pro připojení ke sběrnici SIBus.
Alias ověřování JCA (Java Platform, Enterprise Edition (Java EE) Connector Architecture) určuje ID a heslo uživatele, která slouží k ověření vytvoření nového připojení k poskytovateli rozhraní JMS.
Pole přizpůsobených vlastností jména uživatele a hesla musí být ponecháno nespecifikovaný, pokud je použito pole aliasu ověřování. Vlastnosti aliasu ověřování nastavené jako součást implementace aplikace mají přednost před vlastnostmi nastavenými pro objekt správy specifikace aktivace.
Do souboru je zapisován pouze alias ověřování v šifrované formě, a to i pro účely protokolování zotavení transakcí. K ochraně skutečného jména uživatele a hesla je používána služba zabezpečení.
V průběhu spouštění aplikace při inicializaci specifikace aktivace v rámci aktivace koncového bodu server alias ověřování používá k načtení skutečného jména uživatele a hesla ze zabezpečení a poté jej nastaví na instanci specifikace aktivace.
| Informace | Hodnota |
|---|---|
| Vyžadováno | Ne |
| Datový typ | rozevírací seznam |