IBM MQ Właściwości subskrypcji
Istnieje możliwość ustawienia właściwości dla wszystkich typów subskrypcji. Niektóre właściwości nie mają zastosowania do wszystkich typów subskrypcji, niektóre właściwości są specyficzne dla subskrypcji produktu z/OS® .
W poniższej tabeli znajduje się lista wszystkich właściwości, które można ustawić:
Dla każdej właściwości dostępny jest krótki opis sytuacji, w której może być wymagana konfiguracja danej właściwości. W tabelach można także podać równoważne parametry MQSC dla komend DEFINE, ALTER i DISPLAY SUB. Więcej informacji na temat komend MQSC można znaleźć w sekcji Administrowanie produktem IBM® MQ za pomocą komend MQSC w podręczniku IBM Documentation.
Strona Ogólne
W poniższej tabeli podana została lista właściwości, które można ustawić na stronie Ogólne okna dialogowego Właściwości subskrypcji.
Właściwość | Znaczenie | Parametr MQSC |
---|---|---|
Nazwa subskrypcji | Tylko do odczytu. Po utworzeniu subskrypcji nie można zmienić jej nazwy. | SUBNAME |
Nazwa tematu | Nazwa obiektu tematu używanego przez subskrypcję. Nazwa tematu udostępnia opcjonalny temat główny. Dozwolonych jest maksymalnie 48 znaków. | TOPICOBJ |
Łańcuch tematu | Określa pełną nazwę tematu lub temat za znakami wieloznacznymi, jaki ustawiono dla subskrypcji. Znak ukośnika (/) w tym łańcuchu ma specjalne znaczenie. Znak ten oddziela elementy w drzewie tematów. Łańcuch tematu może zaczynać się od znaku (/), ale nie jest to wymagane. Łańcuch zaczynający się od znaku (/) różni się od łańcucha, który nie zaczyna się od znaku (/). |
TOPICSTR |
Użycie znaku wieloznacznego | Schemat ten jest używan podczas interpretowania znaków wieloznacznych zawartych w parametrze Topic string. Dostępne są dwie wartości: TEMAT: Znaki wieloznaczne reprezentują części hierarchii tematów. ZNAK: Znaki wieloznaczne reprezentują części łańcuchów. |
WSCHEMA |
Zasięg | Zasięg określa, czy ta subskrypcja jest przekazywana do
innych menedżerów kolejek, tak aby subskrybent mógł odbierać komunikaty
publikowane przez inne menedżery kolejek. Dostępne są dwie wartości:
Uwaga: poszczególni subskrybenci mogą ograniczyć tylko SUBSCOPE. Jeśli parametr zostanie ustawiony na wartość
ALL na poziomie tematu, to pojedynczy subskrybent może ograniczyć go do wartości QMGR dla danej subskrypcji. Jeśli jednak parametr zostanie
ustawiony na wartość QMGR na poziomie tematu, ustawienie pojedynczego subskrybenta na wartość ALL nie przyniesie żadnego rezultatu.
|
SUBSCOPE |
Klasa docelowa | Klasa docelowa określa, czy miejsce docelowe używane przez subskrypcję jest zarządzane. Dostępne są dwie wartości: ZARZĄDZANE: miejsce docelowe jest zarządzane. UDOSTĘPNIONE: miejsce docelowe jest kolejką. Jest to wartość domyślna. |
DESTCLAS |
Menedżer kolejek docelowych | Menedżer kolejek docelowych dla komunikatów publikowanych w subskrypcji. | DESTQMGR |
Nazwa miejsca docelowego | Określa nazwę kolejki aliasowej, lokalnej, zdalnej lub klastra, w której są umieszczane komunikaty związane z daną subskrypcją. | DEST |
Identyfikator korelacji | Wartość parametru Correlation identifier będzie umieszczona w deskryptorze wszystkich komunikatów wysłanych do subskrypcji. Jeśli nie zostanie podany żaden parametr Correlation
identifier, komunikaty będą umieszczane w miejscu docelowym z identyfikatorem CorrelId MQCI_NONE. Wartość pusta (wartość domyślna) powoduje, że zostanie użyty wygenerowany przez system identyfikator korelacji. Jeśli ustawiona jest wartość ' |
DESTCORL Uwaga: Nie można programowo ustawiać właściwości DESTCORL na JMS.
|
Trwałe | Subskrypcja stała nie jest usuwana, kiedy aplikacja, która ją utworzyła, zamyka uchwyt subskrypcji. Parametr Durable subskrypcji może mieć wartość Tak lub Nie. Gdy parametr Durable jest ustawiony na wartość Tak, subskrypcje nie są usuwane, kiedy aplikacja, która je utworzyła, zamyka uchwyt subskrypcji. | DURABLE |
Typ | Parametr Type subskrypcji wskazuje sposób jej utworzenia. Dostępne są następujące typy subskrypcji: API: subskrypcja utworzona za pomocą żądania MQSUB API . ADMIN: subskrypcja utworzona za pomocą komendy DEF SUB MQSC lub PCF . Opcja ADMIN służy również do wskazywania, czy subskrypcja została zmodyfikowana przy użyciu komendy administracyjnej. PROXY: subskrypcja utworzona wewnętrznie w celu kierowania publikacji przez sieć menedżera kolejek. Podczas próby wprowadzania zmian subskrypcje typu PROXY nie są modyfikowane na subskrypcje typu ADMIN. Nie można zmodyfikować Type. |
SUBTYPE |
Właściwości | Parametr Properties określa sposób dodawania właściwości komunikatu dotyczących publikowania/subskrypcji do komunikatów wysyłanych do subskrypcji. Dostępne są następujące opcje: Kompatybilność: właściwości publikowania/subskrybowania są dodawane do komunikatu w celu zachowania kompatybilności z publikowania/subskrybowania produktu IBM WebSphere® MQ 6.0 . Właściwości komunikatu: właściwości publikowania/subskrypcji są dodawane jako właściwości komunikatu. Brak: właściwości publikowania/subskrypcji nie są dodawane do komunikatu. RFH2: właściwości publikowania/subskrypcji są dodawane do komunikatu w nagłówku RFH 2. |
PSPROP |
Dane użytkownika | Wartość User data może być opcjonalnie przekazywana jako właściwość komunikatu w komunikacie wysłanym do subskrypcji. | USERDATA |
Selektor | Parametr Selector to łańcuch SQL92 stosowany do komunikatów publikowanych w nazwanym temacie w celu zakwalifikowania ich do subskrypcji. | SELECTOR |
Typ selektora | Podany typ łańcucha wyboru. Ta właściwość wyświetlania jest obliczana i nie jest powiązana z obiektem. Typ selektora może być filtrowany (na przykład z użyciem klauzuli WHERE), aby umożliwić, aby umożliwić administratorowi wyświetlanie tylko selektorów wewnętrznych lub zewnętrznych. | SELTYPE |
Strona Rozszerzone
W poniższej tabeli podana została lista właściwości, które można ustawić na stronie Rozszerzone okna dialogowego Właściwości subskrypcji.
Właściwość | Znaczenie | Parametr MQSC |
---|---|---|
Zmienny ID użytkownika | Określa, czy inni użytkownicy niż twórca subskrypcji mogą nawiązywać połączenie z tą subskrypcją i przejąć jej prawo własności. Dostępne są dwie wartości: DOWOLNY: inni użytkownicy mogą nawiązywać połączenie z subskrypcją, jeśli przeszli odpowiednie sprawdzanie uprawnień tematu i miejsca docelowego. Jest to wartość domyślna. USTALONY: inni użytkownicy nie mogą nawiązać połączenia z subskrypcją. |
VARUSER |
Użytkownik | Określa profil użytkownika, do którego należy dana subskrypcja. | SUBUSER |
Dane tożsamości aplikacji | Wartość Application identity data będzie używana dla komunikatów wysyłanych do subskrypcji. Jeśli parametr Application identity data nie zostanie podany, zostanie użyta pusta wartość domyślna. | PUBAPPID |
Token rozliczania | Wartość Accounting token będzie używana dla komunikatów wysyłanych do subskrypcji. Jeśli parametr Accounting token nie zostanie podany, zostanie użyta wartość domyślna MQACT_NONE. | PUBACCT |
Priorytet publikowania | Parametr Publish priority określa sposób dodawania właściwości komunikatu dotyczących publikowania/subskrypcji do komunikatów wysyłanych do subskrypcji. Dostępne są następujące opcje: Jak publikacja: oznacza priorytet komunikatu wysyłanego do subskrypcji pobierany z priorytetu zawartego w publikowanym komunikacie. Jak zdefiniowana kolejka: oznacza priorytet komunikatu wysyłanego do subskrypcji pobierany z domyślnego priorytetu kolejki zdefiniowanej jako miejsce docelowe. Wartość priorytetu można określić liczbą z zakresu od 0 do 9. |
PUBPRTY |
Identyfikator subskrypcji | Wartość parametru Subscription ID jest przypisywana przez menedżer kolejek jako stały, unikalny identyfikator danej subskrypcji. Ten identyfikator może być używany jako alternatywa wartości SUBNAME jako element docelowy dla komend MQSC DISPLAY, ALTERi DELETE, gdy nie jest możliwe podanie wartości SUBNAME ze względu na jej format lub jeśli dla utworzonej aplikacji nie została podana wartość SUBNAME. | SUBID |
Utrata ważności | Czas życia subskrypcji od daty i godziny utworzenia. Wartość Expiry jest mierzona w dziesiątych częściach sekundy. Dostępne są dwie wartości: Nieoznaczona, która oznacza, że subskrypcja nigdy nie utraci ważności lub dowolna wartość wpisana przez użytkownika wyrażona w dziesiątych częściach sekundy. Wartość domyślna to 0. |
EXPIRY |
Tylko żądanie | Żądanie wskazuje tylko, czy subskrybent będzie odpytywać o aktualizacje za pośrednictwem produktu MQSUBPRQ API. Dostępne są dwie wartości: Wszystkie, która oznacza, że wszystkie publikacje będą dostarczane do subskrypcji. Jest to wartość domyślna. Na żądanie , co oznacza, że publikacje są dostarczane tylko do subskrypcji w odpowiedzi na produkt MQSUBPRQ API. |
REQONLY |
Poziom subskrypcji | Jest to poziom powiązany z subskrypcją. Publikacje są dostarczane do danej subskrypcji tylko wtedy, gdy należy ona do zbioru subskrypcji, w którym najwyższa wartość poziomu subskrypcji jest mniejsza lub równa wartości poziomu publikacji użytej podczas publikowania. Wartość musi być z zakresu 0-9. Zero jest najniższym poziomem. | SUBLEVEL |
Strona Statystyka
W poniższej tabeli podana została lista właściwości dostępnych na stronie Statystyka okna dialogowego Właściwości subskrypcji. Na stronie Statystyka wyświetlane są informacje o historii subskrypcji. Informacje wyświetlane na stronie Statystyka są dostępne tylko do odczytu i nie mogą być zmieniane przez użytkownika.
Właściwość | Znaczenie | Parametr MQSC |
---|---|---|
Data utworzenia | Tylko do odczytu. Data utworzenia subskrypcji. | CRDATE |
Godzina utworzenia | Tylko do odczytu. Godzina utworzenia subskrypcji. | CRTIME |
Data zmiany | Tylko do odczytu. Jest to data ostatniej zmiany właściwości subskrypcji. | ALTDATE |
Godzina zmiany | Tylko do odczytu. Jest to godzina ostatniej zmiany właściwości subskrypcji. | ALTTIME |