Właściwości komunikatu
Właściwości komunikatów są wyświetlane w oknie dialogowym Właściwości komunikatu. Nie można edytować właściwości tych komunikatów.
W poniższych tabelach przedstawiono właściwości komunikatów produktu IBM® MQ, które można umieszczać w kolejkach i pobierać z nich:
- Ogólne
- Raport
- Kontekst
- Identyfikatory
- Segmentacja
- Nazwane właściwości
- Właściwości MQRFH2
- Dane
- Nagłówek niedostarczonego komunikatu
Dla każdej właściwości umieszczono krótki opis. Nazwy w tabelach podane są również w formacie MQMD, tak jak są używane w interfejsie API. Zostało to opisane w sekcji MQMD - przegląd w Centrum Wiedzy IBM.
Strona Ogólne
W poniższej tabeli podana została lista właściwości dostępnych na stronie Ogólne okna dialogowego Właściwości komunikatu.
Właściwość | Znaczenie | Format MQMD |
---|---|---|
Pozycja | Tylko do odczytu. Bieżąca pozycja komunikatu w kolejce. | (Nie dotyczy) |
Typ komunikatu | Tylko do odczytu. Typ komunikatu: Datagram oznacza, że nie jest wymagana odpowiedź na komunikat; Żądanie oznacza, że dla komunikatu wymagana jest odpowiedź; Odpowiedź oznacza, że komunikat stanowi odpowiedź na odebrany komunikat z żądaniem; Raport oznacza, że komunikat stanowi raport o wystąpieniu oczekiwanej lub nieoczekiwanej sytuacji związanej z innym komunikatem. Na przykład komunikat z żądaniem zawierał niepoprawne dane. |
Typ_komunikatu |
Priorytet | Tylko do odczytu. Priorytet komunikatu. Najniższym priorytetem jest 0. | Priorytet |
Trwałość | Tylko do odczytu. Wskazuje, czy komunikat jest trwały, czy nietrwały. Komunikat trwały nie ulega zniszczeniu w wyniku awarii systemu i restartowania menedżera kolejek. Komunikat nietrwały nie ulega zniszczeniu podczas restartowania tylko wtedy, gdy jest obecny w kolejce z właściwością NPMCLASS(HIGH). Jednak nawet z właściwością NPMCLASS(HIGH) kolejka nie przetrwa klasy QMGR. Komunikaty nietrwałe znajdujące się w kolejkach z właściwością NPMCLASS(NORMAL) są odrzucane przy restartowaniu menedżera kolejek nawet wtedy, gdy podczas procedury restartu komunikat znajduje się w pamięci dodatkowej. | Trwałość |
Data/czas wstawienia | Tylko do odczytu. Data wstawienia komunikatu. | Data_wstawienia; Czas_wstawienia |
Utrata ważności | Tylko do odczytu. Czas, w dziesiątych częściach sekundy, po którego upłynięciu komunikat zostaje zakwalifikowany do usunięcia, jeśli nie został usunięty z kolejki docelowej. Interwał ważności jest ustalany przez aplikację, która wstawiła komunikat. | Utrata ważności |
Kolejka zwrotna | Tylko do odczytu. Nazwa kolejki komunikatów, do której aplikacja wystawiająca żądanie pobrania komunikatu powinna wysłać komunikat z odpowiedzią oraz komunikat raportujący. | Kolejka_zwrotna |
Menedżer kolejek zwrotnych | Tylko do odczytu. Nazwa menedżera kolejek, w którym zdefiniowano kolejkę zwrotną. | Menedżer_kolejek_zwrotnych |
Licznik wycofań | Tylko do odczytu. Liczba zwrotów komunikatu w wywołaniu MQGET w ramach jednostki pracy oraz liczba kolejnych wycofań. | Licznik_wycofań |
Strona Raport
W poniższej tabeli podana została lista właściwości dostępnych na stronie Raport okna dialogowego Właściwości komunikatu. Raport jest komunikatem dotyczącym innego komunikatu, używanym do informowania aplikacji o wystąpieniu oczekiwanego lub nieoczekiwanego zdarzenia związanego z komunikatem pierwotnym. Na stronie Raport wyświetlane są właściwości dotyczące komunikatu raportującego. Więcej informacji zawiera sekcja Opcje raportów i komunikatów w Centrum Wiedzy IBM.
Właściwość | Znaczenie | Format MQMD |
---|---|---|
Raport | Tylko do odczytu. W polu tym określane jest przez aplikację wysyłającą, czy wymagane są komunikaty raportujące, czy dane aplikacji mają zostać zawarte w komunikatach raportujących oraz określany jest sposób ustawienia komunikatu i identyfikatorów korelacji w komunikacie raportującym lub w komunikacie z odpowiedzią. | Raport |
Opinie | Tylko do odczytu. Używane jedynie w przypadku komunikatów raportujących do wskazania natury raportu. | Opinie |
Pierwotna długość | Tylko do odczytu. Używane jedynie w przypadku komunikatów raportujących do wskazania długości komunikatu pierwotnego, którego dotyczy raport. | Długość_pierwotna |
Strona Kontekst
W poniższej tabeli podana została lista właściwości dostępnych na stronie Kontekst okna dialogowego Właściwości komunikatu. Na stronie Kontekst wyświetlane są informacje o komunikacie pochodzące z aplikacji wysyłającej.
Właściwość | Znaczenie | Format MQMD |
---|---|---|
Identyfikator użytkownika | Tylko do odczytu. Identyfikator użytkownika aplikacji będącej autorem komunikatu. | Identyfikator_użytkownika |
Typ aplikacji | Tylko do odczytu. Jest to typ aplikacji, która umieściła komunikat, na przykład CICS lub AIX. | Typ_aplikacji_wstawiającej |
Nazwa aplikacji wstawiającej | Tylko do odczytu. Nazwa aplikacji, która wstawiła komunikat. Ta nazwa może być wyświetlana jako obcięta. | Nazwa_aplikacji_wstawiającej |
Dane tożsamości aplikacji | Tylko do odczytu. Dane zdefiniowane w pakiecie aplikacji, za pomocą których można uzyskać informacje na temat komunikatu lub jego wystawcy. | Dane_tożsamości_aplikacji |
Dane_pochodzenia_aplikacji | Tylko do odczytu. Dane zdefiniowane w pakiecie aplikacji, za pomocą których można uzyskać dodatkowe informacje o wystawcy komunikatu. | Dane_pochodzenia_aplikacji |
Token rozliczania | Tylko do odczytu. Informacje umożliwiające odpowiednie rozliczenie przez aplikację pracy wykonanej na rzecz komunikatu. | Token_rozliczania |
Strona Identyfikatory
W poniższej tabeli podana została lista właściwości dostępnych na stronie Identyfikatory okna dialogowego Właściwości komunikatu. Na stronie Identyfikatory wyświetlane są informacje o identyfikatorach przypisane do komunikatu.
Właściwość | Znaczenie | Format MQMD |
---|---|---|
Identyfikator komunikatu | Tylko do odczytu. Identyfikator komunikatu, za pomocą którego można odróżnić komunikaty. | Identyfikator_komunikatu |
Identyfikator komunikatu (w bajtach) | Tylko do odczytu. Identyfikator komunikatu w bajtach. | Identyfikator_komunikatu |
Identyfikator korelacji | Tylko do odczytu. Za pomocą identyfikatora korelacji aplikacja może ustalić relację między komunikatami lub relację między komunikatem i działaniem innego rodzaju wykonywanym przez aplikację. | Identyfikator_korelacji |
Identyfikator korelacji (w bajtach) | Tylko do odczytu. Identyfikator korelacji w bajtach. | Identyfikator_korelacji |
Identyfikator grupy | Tylko do odczytu. Identyfikator grupy może wskazywać określoną grupę komunikatu lub komunikat logiczny, do którego przypisany jest komunikat fizyczny. | Identyfikator_grupy |
Identyfikator grupy (w bajtach) | Tylko do odczytu. Identyfikator grupy w bajtach. | Identyfikator_grupy |
Strona Segmentacja
W poniższej tabeli podana została lista właściwości dostępnych na stronie Segmentacja okna dialogowego Właściwości komunikatu. Na stronie Segmentacja wyświetlane są właściwości dotyczące segmentacji dużych komunikatów.
Właściwość | Znaczenie | Format MQMD |
---|---|---|
Numer kolejny komunikatu logicznego | Tylko do odczytu. Numer kolejny komunikatu logicznego w obrębie grupy. Numer kolejny począwszy od 1 do maksymalnie 999999999 jest zwiększany o 1 dla każdego nowego komunikatu logicznego w grupie. Numerem kolejnym komunikatu fizycznego będącego poza grupą jest 1. | Numer_kolejny_komunikatu |
Depozycja | Tylko do odczytu. Depozycja danych w komunikacie fizycznym względem początku komunikatu logicznego. | Depozycja |
Flagi | Tylko do odczytu. Flagi określające właściwości komunikatu lub sterujące przetwarzaniem komunikatu. | Flagi_komunikatu |
Strona Nazwane właściwości
W poniższej tabeli podana została lista właściwości dostępnych na stronie Nazwane właściwości okna dialogowego Właściwości komunikatu. Strona Nazwane właściwości jest dostępna tylko w przypadku, gdy wybrano opcję zgodnie z nazwanymi właściwościami na stronie Właściwości komunikatu okna dialogowego Preferencje, jeśli wybrany komunikat ma właściwości. Właściwości komunikatu, z wyjątkiem tych, które są zawarte w deskryptorze lub rozszerzeniu komunikatu, muszą zostać przedstawione w panelu Nazwane właściwości w postaci par nazw i wartości. Właściwości są usuwane z danych komunikatu.
Opcja MQGMO to MQGMO_PROPERTIES_IN_HANDLE. Więcej informacji na temat odpowiednich opcji pobierania komunikatów można znaleźć w sekcji Opcje pobierania komunikatów MQ.Więcej informacji na temat okna dialogowego Preferencje zawiera sekcja Konfigurowanie programu MQ Explorer.
Właściwość | Znaczenie |
---|---|
Nazwa | Tylko do odczytu. Nazwa właściwości komunikatu. |
Wartość | Tylko do odczytu. Wartość bieżąca nazwanej właściwości. |
Strona Właściwości MQRFH2
- Wybierz opcję zgodnie ze strukturą MQRFH2 w treści komunikatu na stronie Komunikaty okna
dialogowego Preferencje.
Właściwości komunikatu, z wyjątkiem tych, które zawarte są w deskryptorze lub rozszerzeniu komunikatu, muszą zostać przedstawione w panelu Właściwości MQRFH2. Właściwości pozostają w danych komunikatu. Opcja MQGMO to MQGMO_PROPERTIES_FORCE_MQRFH2. Więcej informacji na temat odpowiednich opcji pobierania komunikatów można znaleźć w sekcji Opcje pobierania komunikatów MQ.
- Wybierz opcję zgodnie ze strukturą MQRFH2 w treści komunikatu
zgodną z produktem WebSphere MQ 6 na stronie Komunikaty okna
dialogowego Preferencje. Strona Właściwości MQRFH2 będzie widoczna tylko w
przypadku, gdy komunikat zawiera właściwość z przedrostkiem
mcd, jms, usr
lub mqext.
Jeśli komunikat zawiera właściwość z przedrostkiem mcd, jms, usr lub mqext, wszystkie właściwości komunikatu, z wyjątkiem tych, które zawarte są w deskryptorze lub rozszerzeniu komunikatu, muszą zostać przedstawione w panelu Właściwości MQRFH2. Właściwości pozostają w danych komunikatu. W przeciwnym razie wszystkie właściwości komunikatu, z wyjątkiem tych, które zawarte są w deskryptorze lub rozszerzeniu komunikatu, są usuwane i nie są wyświetlane. Opcja MQGMO to MQGMO_PROPERTIES_IN_COMPATIBILITY. Więcej informacji na temat odpowiednich opcji pobierania komunikatów można znaleźć w sekcji Opcje pobierania komunikatów MQ.
Ponieważ struktura MQRFH2 stanowi zagnieżdżony kod XML, strona Właściwości MQRFH2 wyświetla właściwości MQRFH2 w widoku drzewa. Wszystkie właściwości o tym samym synonimie są zgrupowane w drzewie synonimów, które można rozwinąć, aby wyświetlić wszystkie właściwości, albo zwinąć, aby ukryć wszystkie właściwości.
Właściwość | Znaczenie |
---|---|
Nazwa | Tylko do odczytu. Nazwa właściwości komunikatu. |
Wartość | Tylko do odczytu. Wartość bieżąca nazwanej właściwości. |
Strona Dane
W poniższej tabeli podana została lista właściwości dostępnych na stronie Dane okna dialogowego Właściwości komunikatu. Na stronie Dane wyświetlane są dane komunikatów oraz informacje dotyczące formatu danych.
Właściwość | Znaczenie | Format MQMD |
---|---|---|
Długość danych | Tylko do odczytu. Długość pierwotnego komunikatu. | Długość_pierwotna |
Format | Tylko do odczytu. Nazwa nadana przez wysyłającego komunikat w celu wskazania odbiorcy komunikatu natury danych komunikatu. | Format |
Identyfikator kodowanego zestawu znaków | Tylko do odczytu. Identyfikator kodowanego zestawu znaków dla danych komunikatu aplikacji. | Identyfikator_kodowanego_zestawu_znaków |
Kodowanie | Tylko do odczytu. Kodowanie numeryczne danych numerycznych komunikatu. Wartość nie ma zastosowania w przypadku danych numerycznych struktury MQMD. | Kodowanie |
Dane komunikatu | Tylko do odczytu. Dane komunikatu w formie zrozumiałego dla człowieka tekstu ASCII. | (Nie dotyczy) |
Dane komunikatu (w bajtach) | Tylko do odczytu. Dane komunikatu w formacie szesnastkowym. | (Nie dotyczy) |
Strona Nagłówek niedostarczonych komunikatów
W poniższej tabeli znajduje się lista właściwości ze strony Nagłówek niewysłanej wiadomości okna dialogowego Właściwości komunikatu. Strona Nagłówek niedostarczonego komunikatujest wyświetlana jedynie w przypadku posiadania przez komunikat nagłówka niedostarczonego komunikatu.
Właściwość | Znaczenie | Format MQMD |
---|---|---|
Przyczyna | Przyczyna wstawienia komunikatu do kolejki niedostarczonych komunikatów (komunikat niedostarczony) zamiast do pierwotnej kolejki docelowej. | Przyczyna |
Kolejka docelowa | Nazwa kolejki komunikatów będącej pierwotnym miejscem docelowym komunikatu. | Nazwa_kolejki_docelowej |
Docelowy menedżer kolejek | Nazwa menedżera kolejek będącego pierwotnym miejscem docelowym komunikatu. | Docelowy_menedżer_kolejek |
Kodowanie pierwotne | Określa kodowanie numeryczne danych struktury typu MQDLH (zazwyczaj danych komunikatu początkowego); nie dotyczy danych numerycznych struktury MQDLH. | Kodowanie |
Pierwotny CCSID | Określa identyfikator zestawu znaków danych struktury typu MQDLH (zazwyczaj danych komunikatu początkowego); nie dotyczy danych znakowych struktury MQDLH. | Identyfikator_kodowanego_zestawu_znaków |
Format pierwotny | Określa nazwę formatu danych struktury MQDLH (zazwyczaj danych komunikatu pierwotnego). | Format |
Typ aplikacji wstawiającej | Typ aplikacji, która wstawiła komunikat. Jest to część pierwotnego kontekstu komunikatu. Więcej informacji o kontekście komunikatu zawiera sekcja Kontekst komunikatu w Centrum Wiedzy IBM. | Typ_aplikacji_wstawiającej |
Nazwa aplikacji wstawiającej | Nazwa aplikacji, która wstawiła komunikat do kolejki niedostarczonych komunikatów. Format nazwy zależy od wartości właściwości Typ aplikacji wstawiającej . Ta nazwa może być wyświetlana jako obcięta. |
Nazwa_aplikacji_wstawiającej |
Data wstawienia | Data wstawienia komunikatu do kolejki niedostarczonych komunikatów. | Data_wstawienia |
Czas wstawienia | Czas wstawienia komunikatu do kolejki niedostarczonych komunikatów. | Czas wstawienia |