Vlastnosti definic služeb produktu IBM MQ
Při vytváření nové definice služby nebo při úpravě stávající definice služby můžete nastavit vlastnosti a atributy této definice služby.
Některé atributy budou dostupné jen v případě, že definice služby používá specifický typ vazby nebo vzorec výměny zpráv. Chcete-li zobrazit vlastnosti umístěné na jednotlivých stránkách vlastností definice služby, použijte tyto odkazy:
- Obecné
- Operace
- Místo určení vstupu
- Schéma vstupních zpráv
- Záhlaví vstupních zpráv
- Místo určení výstupu
- Schéma výstupních zpráv
- Záhlaví výstupních zpráv
U každého atributu je uveden stručný popis, kdy může být vhodné jej konfigurovat.
Stránka Obecné
V následující tabulce jsou uvedeny atributy, které lze nastavit na stránce Obecné dialogového okna Vlastnosti definice služby.
Atribut | Popis |
---|---|
Obor názvů | Určuje obor názvů pro službu. Této vlastnosti je již předem přiřazena dočasná výchozí hodnota. |
Název | Jedinečný název nové definice služby. V názvu definice služby se nerozlišují velká a malá písmena, smíšená velikost písmen v názvech definic se však zachovává. |
Vzorec výměny zpráv | Vzorec výměny zpráv popisuje směr odesílání a příjmu zpráv při vyvolání služby.
K dispozici jsou dvě možné volby:
|
Typ vazby | Určuje verzi specifikace definic služeb IBM® MQ. |
Komentář | Zadejte komentář, který bude použit jako anotace služby v souboru WSDL. |
Stránka Operace
V následující tabulce jsou uvedeny atributy, které lze nastavit na stránce Operace dialogového okna Vlastnosti definice služby. Pro každou definici služby je definována pouze jedna operace.
Atribut | Popis |
---|---|
Název operace | Určuje název operace. Tato vlastnost musí mít hodnotu, jinak nelze definici služby vytvořit. |
Akce | Tuto vlastnost využívá poskytovatel služby k rozdělování požadavků na službu. Příklad: Implementace více služeb s použitím jediného místa určení a s možností rozdělování doručených požadavků poskytovatelem služby na vhodná místa určení. U vazeb typu MQ má vlastnost Akce hodnotu targetAction. |
Komentář | Zadejte komentář, který bude použit jako anotace operace v souboru WSDL. |
Stránka Místo určení vstupu
V následující tabulce jsou uvedeny atributy, které lze nastavit na stránce Místo určení vstupu dialogového okna Vlastnosti definice služby. Vstupní stránky podrobně určují, jaké zprávy služba očekává, a místo určení stanoví, odkud budou načteny.
Atribut | Popis |
---|---|
Název místa určení vstupu | Určuje název cílové fronty nebo cílového tématu, do něhož je požadavek zasílán, například: Částice queue-dest nebo topic-dest rozhraní IBM MQ IRI, například:
|
Název správce cílové fronty | Určuje název správce cílové fronty. |
Správce front připojení | Určuje název správce front, k němuž se připojuje služba vysílající požadavky. Tato hodnota odpovídá parametru QmgrName používanému ve voláních MQCONN() a MQCONNX(). |
Vlastnosti připojení klienta | Vlastnosti připojení klienta určují podrobné vazby, které mohou obsahovat informace o způsobu vázání žadatele služby se specifickým počítačem nebo kanálem. Možnost určit vazby klientů a názvy kanálů je za určitých okolností užitečná, příliš podrobná specifikace služby však může představovat omezení. Tento problém lze vyřešit minimalizací množství údajů o vazbách obsažených v definici služby a tam, kde je to možné, ponechat směrování zpráv na základní infrastruktuře nebo systému IBM MQ. |
Název tabulky kanálů | Určuje název souboru s tabulkou kanálu klienta, který se používá k identifikaci připojení kanálu.
|
Knihovna tabulky kanálů | Určuje cestu k tabulce kanálu klienta.
|
Název připojení kanálu klienta | Určuje řetězec připojení, který použije klient služby při vytváření připojení vazby klienta IBM MQ MQI. V případě protokolu TCP/IP je název připojení tvořen názvem hostitele, za nímž následuje číslo portu, např. .
Není-li zadáno číslo portu, bude použita výchozí hodnota 1414.
|
Název kanálu klienta | Určuje kanál, který použije klient služby IBM MQ při vytváření připojení vazby klienta IBM MQ MQI.
|
Typ transportu kanálu klienta | Určuje typ transportu, který použije klient služby IBM MQ při vytváření připojení vazby klienta IBM MQ MQI.
|
Stránka Schéma vstupních zpráv
V následující tabulce jsou uvedeny atributy, které lze nastavit na stránce Schéma vstupních zpráv dialogového okna Vlastnosti definice služby. Pomocí těchto vlastností lze definovat schéma pro informační obsah zprávy.
Atribut | Popis |
---|---|
Příchozí datový typ | Určuje očekávaný příchozí datový typ. Jednoduché typy lze modelovat pomocí vestavěných typů xsd jazyka XML, např. xsd:string nebo xsd:int .
Složitější datové typy lze importovat z externího souboru zadáním parametrů Soubor schématu importu a Obor názvů importu pro daný datový typ. |
Soubor schématu importu | Určuje soubor schématu, který má být importován. |
Obor názvů importu | Určuje obor názvů, který má být importován. |
Stránka Záhlaví vstupních zpráv
V následující tabulce jsou uvedeny atributy, které lze nastavit na stránce Záhlaví vstupních zpráv dialogového okna Vlastnosti definice služby. Vstupní stránky podrobně určují, jaké zprávy služba očekává, a místo určení stanoví, odkud budou načteny. Některé vlastnosti se týkají pouze definic služeb s typem vazby MQ.
Atribut | Popis |
---|---|
CCSID | Určuje ID znakové sady, které odpovídá poli CodedCharSetId ve struktuře MQMD. Není-li tato hodnota zadána, žadatel služby a poskytovatel služby použijí hodnotu, která odpovídá znakové sadě dat zprávy. |
Formát | Určuje název formátu dat zprávy. Tato vlastnost odpovídá poli formátu MQRFH2 nebo poli formátu MQMD, není-li hodnota MQRFH2 nastavena. Hodnota musí být znakový řetězec o délce 0 až 8 znaků, který obsahuje znaky A-Z a 0–9. Pole Formát lze nastavit na libovolnou hodnotu odpovídající pokynům uvedeným v poli Pole formátu. |
Uživatelské vlastnosti | Určuje uživatelem definovaná data přenášená ve zprávách služby IBM MQ. Hodnoty musí být zadány ve formátu přípustném pro prvky složky RFH2, v posloupnosti trojic kódovaných pomocí syntaxe odpovídající formátu XML, např.:
Prvek dt="typ_dat " je volitelný a pokud je vynechán, hodnota je považována za řetězcovou. Prvky lze v tom případě zadávat takto:
Příklad:
Další informace o povolených datových typech a formátování viz NameValueData ( MQCHARn ) v Centrum znalostí IBM.
Nedoporučuje se nastavovat vlastnosti s citlivými daty zabezpečení, například jména uživatelů a hesla. |
Typ zprávy | Určuje typ odesílané zprávy.
Tato vlastnost odpovídá hodnotě MsgType ve struktuře MQMD.
K dispozici je pět hodnot:
|
Trvání | Určuje, zda je zpráva trvalá či nikoli. Odpovídá poli Persistence ve struktuře MQMD. K dispozici jsou tři hodnoty:
|
ID zprávy | Určuje identifikátor zprávy, který odpovídá poli MsgId ve struktuře MQMD. ID zprávy umožňuje popisovat některé specializované aplikace IBM MQ jako služby (např. aplikace, které sdílejí vstupní frontu a zprávy, které jsou pro ně určeny, vybírají na základě předdefinované hodnoty msgId). Předdefinované hodnoty msgId v definicích služeb mohou vést k problémům, například tehdy, vrací-li vzorec výměny zpráv typu požadavek-odezva hodnotu msgId převzatou z požadavku. ID zprávy může být znakový řetězec nebo binární hodnota. Binární hodnota musí být řetězec až 24 dvojic dvouznakových hexadecimálních hodnot.Klepnutím na volbu Upravit otevřete dialogové okno a vložte hodnotu jako text nebo jako bajty. |
ID korelace | Určuje ID korelace, které odpovídá poli CorrelId ve struktuře MQMD. ID korelace může být znakový řetězec nebo binární hodnota. Binární hodnota musí být řetězec až 24 dvojic dvouznakových hexadecimálních hodnot. Klepnutím na volbu Upravit otevřete dialogové okno a vložte hodnotu jako text nebo jako bajty. |
Vypršení | Určuje životnost zprávy. Musí se jednat o celé číslo se znaménkem, které udává hodnotu v desetinách sekundy. Rozsah vlastnosti Vypršení je od 1 do 2147483647. Speciální hodnota Neomezeno udává, že platnost zprávy není časově omezena. Do souboru WSDL je zapsána hodnota -1. Hodnota Nespecifikováno znamená, že do souboru WSDL nebyla zapsána žádná hodnota. Toto je výchozí hodnota. |
Priorita | Určuje prioritu přidruženou ke zprávě. Odpovídá poli priorita ve struktuře MQMD.
Zadaná hodnota musí být celočíselná v intervalu od 0 do 9, kde 0 je nejnižší priorita a 9 nejvyšší. Speciální hodnota Neomezeno znamená, že priorita zprávy bude nastavena podle definice první fronty, do níž bude zpráva vložena. Do souboru WSDL je zapsána hodnota -1. Hodnota Nespecifikováno znamená, že do souboru WSDL nebyla zapsána žádná hodnota. Toto je výchozí hodnota. |
Kódování | Určuje číselné kódování dat zprávy, které odpovídá poli Encoding ve struktuře QMD:
|
Volby sestav | Určuje, jakým způsobem poskytovatel služby nastavuje identifikátory zprávy a korelace ve zprávě odezvy nebo selhání.
Tato vlastnost odpovídá poli Report ve struktuře MQMD.
Existují čtyři možné hodnoty:
|
Stránka Místo určení výstupu
V následující tabulce jsou uvedeny atributy, které lze nastavit na stránce Místo určení výstupu dialogového okna Vlastnosti definice služby. Výstupní stránky podrobně určují, jakou zprávu služba odešle jako odezvu na vstupní zprávu, a místo určení stanoví, kam bude zpráva odeslána. Název místa určení výstupu musí u front začínat předponou 'msg/queue/' a u témat předponou 'msg/topic/'.
Atribut | Popis |
---|---|
Název místa určení výstupu | Určuje název cílové fronty nebo cílového tématu, do nichž bude odeslána zpráva odezvy. Odpovídá polím ReplyToQ a ReplyToQMgr ve struktuře MQMD. Název cíle musí mít tvar částice queue-dest nebo topic-dest rozhraní IBM MQ IRI, například:
|
Název správce cílové fronty | Určuje název správce cílové fronty. |
Správce front připojení | Určuje název správce front, k němuž se připojuje služba vysílající požadavky. Tato hodnota odpovídá parametru QmgrName používanému ve voláních MQCONN() a MQCONNX(). |
Vlastnosti připojení klienta | Vlastnosti připojení klienta určují podrobné vazby, které mohou obsahovat informace o způsobu vázání žadatele služby se specifickým počítačem nebo kanálem. Možnost určit vazby klientů a názvy kanálů je za určitých okolností užitečná, příliš podrobná specifikace služby však může představovat omezení. Tento problém lze vyřešit minimalizací množství údajů o vazbách obsažených v definici služby a tam, kde je to možné, ponechat směrování zpráv na základní infrastruktuře nebo systému IBM MQ. |
Název tabulky kanálů | Určuje název souboru s tabulkou kanálu klienta, který se používá k identifikaci připojení kanálu.
|
Knihovna tabulky kanálů | Určuje cestu k tabulce kanálu klienta.
|
Název kanálu klienta | Určuje řetězec připojení, který použije klient služby při vytváření připojení vazby klienta IBM MQ MQI. V případě protokolu TCP/IP je název připojení tvořen názvem hostitele, za nímž následuje číslo portu, např. .
Není-li zadáno číslo portu, bude použita výchozí hodnota 1414.
|
Název připojení kanálu klienta | Určuje kanál, který použije klient služby IBM MQ při vytváření připojení vazby klienta IBM MQ MQI.
|
Typ transportu kanálu klienta | Určuje typ transportu, který použije klient služby IBM MQ při vytváření připojení vazby klienta IBM MQ MQI.
|
Stránka Schéma výstupních zpráv
V následující tabulce jsou uvedeny atributy, které lze nastavit na stránce Schéma výstupních zpráv dialogového okna Vlastnosti definice služby. Pomocí těchto vlastností lze definovat schéma pro informační obsah zprávy.
Atribut | Popis |
---|---|
Odchozí datový typ | Určuje očekávaný odchozí datový typ. |
Soubor schématu importu | Určuje soubor schématu, který má být importován. |
Obor názvů importu | Určuje obor názvů, který má být importován. |
Stránka Záhlaví výstupních zpráv
V následující tabulce jsou uvedeny atributy, které lze nastavit na stránce Záhlaví výstupních zpráv dialogového okna Vlastnosti definice služby. Výstupní stránky podrobně určují, jakou zprávu služba odešle jako odezvu na vstupní zprávu, a místo určení stanoví, kam bude zpráva odeslána. Některé vlastnosti se týkají pouze definic služeb s typem vazby MQ.
Atribut | Popis |
---|---|
CCSID | Určuje ID znakové sady, které odpovídá poli CodedCharSetId ve struktuře MQMD. Není-li tato hodnota zadána, žadatel služby a poskytovatel služby použijí hodnotu, která odpovídá znakové sadě dat zprávy. |
Formát | Určuje název formátu dat zprávy. Tato vlastnost odpovídá poli formátu MQRFH2 nebo poli formátu MQMD, není-li hodnota MQRFH2 nastavena. Hodnota musí být znakový řetězec o délce 0 až 8 znaků, který obsahuje znaky A-Z a 0–9. Pole Formát lze nastavit na libovolnou hodnotu odpovídající pokynům uvedeným v poli Pole formátu. |
Uživatelské vlastnosti | Určuje uživatelem definovaná data přenášená ve zprávách služby IBM MQ. Hodnoty musí být zadány ve formátu přípustném pro prvky složky RFH2, v posloupnosti trojic kódovaných pomocí syntaxe odpovídající formátu XML, např.:
Prvek dt="typ_dat " je volitelný a pokud je vynechán, hodnota je považována za řetězcovou. Prvky lze v tom případě zadávat takto:
Příklad:
Další informace o povolených datových typech a formátování viz NameValueData ( MQCHARn ) v Centrum znalostí IBM.
Nedoporučuje se nastavovat vlastnosti s citlivými daty zabezpečení, například jména uživatelů a hesla. |
Typ zprávy | Určuje typ odesílané zprávy.
Tato vlastnost odpovídá hodnotě MsgType ve struktuře MQMD.
K dispozici je pět hodnot:
|
Trvání | Určuje, zda je zpráva trvalá či nikoli. Odpovídá poli Persistence ve struktuře MQMD. K dispozici jsou tři hodnoty:
|
ID zprávy | Určuje identifikátor zprávy, který odpovídá poli MsgId ve struktuře MQMD. ID zprávy umožňuje popisovat některé specializované aplikace IBM MQ jako služby (např. aplikace, které sdílejí vstupní frontu a zprávy, které jsou pro ně určeny, vybírají na základě předdefinované hodnoty msgId). Předdefinované hodnoty msgId v definicích služeb mohou vést k problémům, například tehdy, vrací-li vzorec výměny zpráv typu požadavek-odezva hodnotu msgId převzatou z požadavku. ID zprávy může být znakový řetězec nebo binární hodnota. Binární hodnota musí být řetězec až 24 dvojic dvouznakových hexadecimálních hodnot.Klepnutím na volbu Upravit otevřete dialogové okno a vložte hodnotu jako text nebo jako bajty. |
ID korelace | Určuje ID korelace, které odpovídá poli CorrelId ve struktuře MQMD. ID korelace může být znakový řetězec nebo binární hodnota. Binární hodnota musí být řetězec až 24 dvojic dvouznakových hexadecimálních hodnot. Klepnutím na volbu Upravit otevřete dialogové okno a vložte hodnotu jako text nebo jako bajty. |
Vypršení | Určuje životnost zprávy. Musí se jednat o celé číslo se znaménkem, které udává hodnotu v desetinách sekundy. Rozsah vlastnosti Vypršení je od 1 do 2147483647. Speciální hodnota Neomezeno udává, že platnost zprávy není časově omezena. Do souboru WSDL je zapsána hodnota -1. Hodnota Nespecifikováno znamená, že do souboru WSDL nebyla zapsána žádná hodnota. Toto je výchozí hodnota. |
Priorita | Určuje prioritu přidruženou ke zprávě. Odpovídá poli priorita ve struktuře MQMD.
Zadaná hodnota musí být celočíselná v intervalu od 0 do 9, kde 0 je nejnižší priorita a 9 nejvyšší. Speciální hodnota Neomezeno znamená, že priorita zprávy bude nastavena podle definice první fronty, do níž bude zpráva vložena. Do souboru WSDL je zapsána hodnota -1. Hodnota Nespecifikováno znamená, že do souboru WSDL nebyla zapsána žádná hodnota. Toto je výchozí hodnota. |
Kódování | Určuje číselné kódování dat zprávy, které odpovídá poli Encoding ve struktuře QMD:
|
Volby sestav | Určuje, jakým způsobem poskytovatel služby nastavuje identifikátory zprávy a korelace ve zprávě odezvy nebo selhání.
Tato vlastnost odpovídá poli Report ve struktuře MQMD.
Existují čtyři možné hodnoty:
|