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:

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

W poniższej tabeli podana została lista właściwości dostępnych na stronie Właściwości MQRFH2 okna dialogowego Właściwości komunikatu. Istnieją dwa sposoby wyświetlenia strony 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.

Więcej informacji na temat okna dialogowego Preferencje zawiera sekcja Konfigurowanie programu MQ Explorer.

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