Vlastnosti zprávy
Vlastnosti zprávy jsou zobrazeny v dialogovém okně Vlastnosti zprávy. Žádnou z vlastností zprávy nelze upravovat.
V následujících tabulkách jsou uvedeny vlastnosti zprávy produktu IBM® MQ, které lze vkládat do front a také je z nich vyjímat:
- Obecné
- Sestava
- Kontext
- Identifikátory
- Segmentace
- Pojmenované vlastnosti
- Vlastnosti MQRFH2
- Data
- Záhlaví nedoručených zpráv
U každé vlastnosti je uveden stručný popis významu vlastnosti. Tabulky také obsahují formát názvu MQMD, který se používá v rozhraní API. Popis naleznete v Přehled pro MQMD v Centrum znalostí IBM.
Stránka Obecné
V následující tabulce jsou uvedeny vlastnosti na stránce Obecné dialogového okna vlastností zprávy.
Vlastnost | Význam | Formát MQMD |
---|---|---|
Pozice | Pouze pro čtení. Aktuální pozice ve frontě zprávy. | (Nelze použít) |
Typ zprávy | Pouze pro čtení. Jedná se o typ zprávy:
Datagram znamená, že u zprávy není vyžadována odpověď;
Požadavek znamená, že u zprávy je vyžadována odpověď;
Odpovědět znamená, že zpráva je odpovědí na předchozí zprávu s požadavkem;
Sestava znamená, že zpráva obsahuje informace o očekávaném nebo neočekávaném výskytu, obvykle související s jinou zprávou. Například zpráva s požadavkem, která obsahovala neplatná data. |
MsgType |
Priorita | Pouze pro čtení. Označuje prioritu zprávy. Nejnižší priorita je 0. | Priorita |
Trvání | Pouze pro čtení. Označuje, zda je zpráva přechodná nebo trvalá. Pokud je zpráva trvalá, zůstane zachována i při selhání systému a restartování správce fronty. Přechodná zpráva zůstane při restartu zachována jen tehdy, je-li obsažena ve frontě s vlastností NPMCLASS(HIGH). Ale ani s vlastností NPMCLASS(HIGH) zpráva nezůstane déle než třída QMGR. Přechodné zprávy ve frontách s vlastností NPMCLASS(NORMAL) se při restartu správce front zahazují, a to i v případě, že se zpráva během restartu nachází v pomocné paměti. | Trvání |
Datum a čas vložení | Pouze pro čtení. Jedná se o datum vložení zprávy. | PutDate; PutTime |
Vypršení | Pouze pro čtení. Jedná se o čas (v desetinách sekundy), po kterém bude možné zprávu odstranit, pokud již nebyla odebrána z cílové fronty. Interval vypršení je nastaven aplikací, která vložila zprávu. | Vypršení |
Fronta pro odpověď | Pouze pro čtení. Jedná se o název fronty zpráv, do které by měla aplikace, která zadala požadavek get pro zprávu, odeslat odpověď a zprávy sestav. | ReplyToQ |
Správce front pro odpovědi | Pouze pro čtení. Jedná se o název správce front, u kterého je definována fronta pro odpověď. | ReplyToQmgr |
Počet vrácení | Pouze pro čtení. Označuje, kolikrát byla předtím zpráva vrácena voláním MQGET jako součást pracovní jednotky a následně vrácena zpět. | BackoutCount |
Stránka Sestava
V následující tabulce jsou uvedeny vlastnosti na stránce Sestava dialogového okna vlastností zprávy. Sestava je zpráva o jiné zprávě používaná k informování aplikace o očekávaných nebo neočekávaných událostech, které se vztahují k původní zprávě. Stránka Sestava obsahuje vlastnosti související se zprávami sestav. Další informace viz Volby sestav a příznaky zpráv v Centrum znalostí IBM.
Vlastnost | Význam | Formát MQMD |
---|---|---|
Sestava | Pouze pro čtení. V tomto poli odesílací aplikace určuje, zda jsou zprávy sestav požadované, zda mají být data aplikací zahrnuty do zpráv sestav a také jak mají být nastaveny zprávy a identifikátory korelace v sestavě nebo zprávě odpovědi. | Sestava |
Zpětná vazba | Pouze pro čtení. Používá se pouze u zpráv sestav k označení povahy sestavy. | Zpětná vazba |
Původní délka | Pouze pro čtení. Používá se pouze u zpráv sestav k označení délky původní zprávy, ke které se sestava vztahuje. | OriginalLength |
Stránka kontextu
V následující tabulce jsou uvedeny vlastnosti na stránce Kontext dialogového okna vlastností zprávy. Na stránce Kontext se zobrazují informace o zprávě z odesílací aplikace.
Vlastnost | Význam | Formát MQMD |
---|---|---|
Identifikátor uživatele | Pouze pro čtení. Jedná se o identifikátor uživatele aplikace, která byla původcem zprávy. | UserIdentifier |
Typ aplikace | Pouze pro čtení. Toto je typ aplikace, která vkládá zprávu, například CICS nebo AIX. | PutApplType |
Název vkládající aplikace | Pouze pro čtení. Jedná se o název aplikace, která zprávu vložila. Tento název se může jevit jako oříznutý. | PutApplName |
Data identity aplikace | Pouze pro čtení. Jedná se o informace, které jsou definované sadou aplikací a lze je používat k zadání informací o zprávě nebo jejím autorovi. | ApplIdentityData |
Data původu aplikace | Pouze pro čtení. Jedná se o informace, které jsou definované sadou aplikací, a lze je používat k zadání dalších informací o původu zprávy. | ApplOriginData |
Token evidence | Pouze pro čtení. Tyto informace umožňují aplikaci odpovídajícím způsobem účtovat práci prováděnou v důsledku zprávy. | AccountingToken |
Stránka Identifikátory
V následující tabulce jsou uvedeny vlastnosti na stránce Identifikátory dialogového okna vlastností zprávy. Na stránce Identifikátory se zobrazují identifikační informace, které jsou přidruženy ke zprávě.
Vlastnost | Význam | Formát MQMD |
---|---|---|
Identifikátor zprávy | Pouze pro čtení. Jedná se o identifikátor zprávy, který se používá k rozlišení jedné zprávy od druhé. | MsgId |
Počet bajtů identifikátoru zprávy | Pouze pro čtení. Jde o identifikátor zprávy v bajtech. | MsgId |
Identifikátor korelace | Pouze pro čtení. Jedná se o identifikátor korelace, který může aplikace použít ke vztažení jedné zprávy k druhé nebo ke vztažení zprávy k další práci, kterou aplikace provádí. | CorrelId |
Počet bajtů identifikátoru korelace | Pouze pro čtení. Jde o identifikátor korelace v bajtech. | CorrelId |
Identifikátor skupiny | Pouze pro čtení. Jedná se o identifikátor skupiny, který se používá k identifikaci konkrétní skupiny zpráv nebo logické zprávy, ke které fyzická zpráva patří. | GroupId |
Počet bajtů identifikátoru skupiny | Pouze pro čtení. Jde o identifikátor skupiny v bajtech. | GroupId |
Stránka Segmentace
V následující tabulce jsou uvedeny vlastnosti na stránce Segmentace dialogového okna vlastností zprávy. Stránka Segmentace obsahuje vlastnosti související se segmentováním velkých zpráv.
Vlastnost | Význam | Formát MQMD |
---|---|---|
Logické pořadové číslo | Pouze pro čtení. Jedná se o pořadové číslo logické zprávy v rámci skupiny. Pořadová čísla začínají číslem 1 a u každé nové logické zprávy ve skupině se zvyšují o 1 až do maximální hodnoty 999 999 999. Fyzická zpráva, která se nenachází ve skupině, má pořadové číslo 1. | MsgSeqNumber |
Offset | Pouze pro čtení. Označuje posunutí dat ve fyzické zprávě od začátku logické zprávy. | Offset |
Příznaky | Pouze pro čtení. Jedná se o příznaky zpráv, které určují vlastnosti zprávy, nebo řídí její zpracování. | MsgFlags |
Stránka Pojmenované vlastnosti
V následující tabulce jsou uvedeny vlastnosti na stránce Pojmenované vlastnosti dialogového okna Vlastnosti zprávy. Stránka Pojmenované vlastnosti se zobrazí pouze v případě, že byla vybrána volba jako pojmenované vlastnosti na stránce Vlastnosti zprávy dialogového okna Vlastnosti a že vybraná zpráva má vlastnosti. Vlastnosti zprávy s výjimkou těch, které jsou obsaženy v deskriptoru nebo rozšíření zprávy, musí být vyjádřeny na panelu Pojmenované vlastnosti jako dvojice názvů a hodnot a jsou odebrány z dat zprávy.
Volba MQGMO má hodnotu MQGMO_PROPERTIES_IN_HANDLE. Informace o příslušných volbách načtení zprávy viz Volby získávání zpráv MQ.Další informace o dialogovém okně Předvolby viz Konfigurace produktu MQ Explorer.
Vlastnost | Význam |
---|---|
Název | Pouze pro čtení. Název vlastnosti zprávy. |
Hodnota | Pouze pro čtení. Toto je skutečná hodnota pojmenované vlastnosti. |
Stránka Vlastnosti MQRFH2
- Na stránce Zprávy v dialogovém okně Předvolby vyberte volbu jako struktura MQRFH2 v těle zprávy.
Vlastnosti zprávy s výjimkou těch, které jsou obsaženy v deskriptoru nebo rozšíření zprávy, musí být vyjádřeny na panelu Vlastnosti MQRFH2 a zůstávají v datech zprávy. Volba MQGMO má hodnotu MQGMO_PROPERTIES_FORCE_MQRFH2. Informace o příslušných volbách načtení zprávy viz Volby získávání zpráv MQ.
- Na stránce Zprávy v dialogovém okně Předvolby vyberte volbu jako struktura MQRFH2 v těle zprávy, kompatibilní s verzí 6 produktu WebSphere MQ. Stránka Vlastnosti MQRFH2 bude viditelná jen tehdy, jestliže zpráva obsahuje vlastnost s předponou mcd, jms, usr nebo mqext.
Obsahuje-li zpráva vlastnost s předponou mcd, jms, usr nebo mqext, všechny vlastnosti zprávy s výjimkou těch, které jsou obsaženy v deskriptoru nebo rozšíření zprávy, musí být vyjádřeny na panelu Vlastnosti MQRFH2 a zůstávají v datech zprávy. Jinak jsou všechny vlastnosti zprávy s výjimkou těch, které jsou obsaženy v deskriptoru nebo rozšíření zprávy, zahozeny a nezobrazí se. Volba MQGMO má hodnotu MQGMO_PROPERTIES_IN_COMPATIBILITY. Informace o příslušných volbách načtení zprávy viz Volby získávání zpráv MQ.
Protože struktura MQRFH2 má tvar vnořeného kódu v jazyce XML, jsou vlastnosti MQRFH2 na stránce Vlastnosti MQRFH2 zobrazeny ve formě zobrazení stromu. Všechny vlastnosti s tímtéž synonymem jsou seskupeny pod stromem daného synonyma, který lze rozbalit, a zobrazit tak všechny vlastnosti, nebo sbalit, a skrýt tak všechny vlastnosti.
Vlastnost | Význam |
---|---|
Název | Pouze pro čtení. Název vlastnosti zprávy. |
Hodnota | Pouze pro čtení. Toto je skutečná hodnota pojmenované vlastnosti. |
Stránka Data
V následující tabulce jsou uvedeny vlastnosti na stránce Data dialogového okna vlastností zprávy. Na stránce Data se zobrazují samotná data zprávy a informace o formátu dat.
Vlastnost | Význam | Formát MQMD |
---|---|---|
Délka dat | Pouze pro čtení. Označuje délku původní zprávy. | OriginalLength |
Formát | Pouze pro čtení. Označuje název, pomocí kterého odesilatel zprávy příjemci označil povahu dat ve zprávě. | Formát |
Identifikátor znakové sady | Pouze pro čtení. Jedná se o identifikátor znakové sady dat znaků v datech zprávy aplikace. | CodedCharSetId |
Encoding | Pouze pro čtení. Jedná se o numerické kódování numerických dat ve zprávě. Tato hodnota se nevztahuje na numerická data v samotné struktuře MQMD. | Encoding |
Data zprávy | Pouze pro čtení. Jedná se o data zprávy v čitelné podobě - v textu ve formátu ASCII. | (Nelze použít) |
Počet bajtů dat zprávy | Pouze pro čtení. Jedná se o data zprávy v hexadecimálním formátu. | (Nelze použít) |
Stránka Záhlaví nedoručených zpráv
V následující tabulce jsou uvedeny vlastnosti na stránce Záhlaví nedoručených zpráv dialogového okna vlastností zprávy. Stránka Záhlaví nedoručených zpráv je zobrazena pouze v případě, že zpráva má záhlaví nedoručených zpráv.
Vlastnost | Význam | Formát MQMD |
---|---|---|
Příčina | Označuje, proč byla zpráva umístěna do fronty nedoručených zpráv místo do původní cílové fronty. | Příčina |
Cílová fronta | Název fronty zpráv, která byla původním cílem pro zprávu. | DestQName |
Správce cílové fronty | Název fronty zpráv, který byla původním cílem pro zprávu. | DestQMgrName |
Původní kódování | Označuje numerické kódování dat odpovídající struktuře MQDLH (obvykle data z původní zprávy); nevztahuje se na numerická data v samotné struktuře MQDLH. | Encoding |
Původní CCSID | Označuje identifikátor znakové sady dat odpovídající struktuře MQDLH (obvykle data z původní zprávy); nevztahuje se na data znaků v samotné struktuře MQDLH. | CodedCharSetId |
Původní formát | Označuje název formátu dat odpovídající struktuře MQDLH (obvykle data z původní zprávy). | Formát |
Typ vkládající aplikace | Typ aplikace vkládající zprávu. Jde o část původního kontextu zprávy. Podrobnější informace o kontextu zprávy viz Kontext zprávy v Centrum znalostí IBM. | PutApplType |
Název vkládající aplikace | Název aplikace, která vložila zprávu do fronty nedoručených zpráv. Formát názvu závisí na vlastnosti Typ vkládající aplikace . Tento název se může jevit jako oříznutý. |
PutApplName |
Datum vložení | Datum, kdy byla zpráva vložena do fronty nedoručených zpráv. | PutDate |
Čas vložení | Čas, kdy byla zpráva vložena do fronty nedoručených zpráv. | PutTime |