Właściwości subskrypcji produktu IBM MQ

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 zawiera sekcja Administrowanie za pomocą komend MQSC w podręczniku Dokumentacja produktu IBM®.

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 jest używany podczas interpretowania znaków wieloznacznych zawartych w parametrze Łańcuch tematu. 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:
ALL
Subskrypcja będzie przekazywana do wszystkich menedżerów kolejek bezpośrednio połączonych za pośrednictwem zbioru lub hierarchii publikowania/subskrypcji.
QMGR
Subskrypcja przekazuje komunikaty publikowane w temacie tylko w obrębie danego menedżera kolejek.
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 Identyfikator korelacji będzie umieszczana w deskryptorze wszystkich komunikatów wysyłanych do subskrypcji. Jeśli nie zostanie określony żaden parametr Identyfikator korelacji, komunikaty będą umieszczane w miejscu docelowym o identyfikatorze korelacji MQCI_NONE.

Wartość pusta (wartość domyślna) powoduje, że zostanie użyty wygenerowany przez system identyfikator korelacji.

Jeśli zostanie ustawiona wartość 000000000000000000000000000000000000000000000000 (48 zer), parametr CorrelId ustawiony przez aplikację publikującą zostanie utrzymany w kopii komunikatu dostarczonego do subskrypcji, chyba że komunikaty są propagowane w hierarchii publikowania/subskrypcji.

DESTCORL
Uwaga: Nie można programowo ustawić właściwości DESTCORL na wartość JMS.
Trwałe Subskrypcja stała nie jest usuwana, kiedy aplikacja, która ją utworzyła, zamyka uchwyt subskrypcji. Parametr Trwałe subskrypcji może mieć wartość Tak lub Nie. Gdy parametr Trwałe jest ustawiony na wartość Tak, subskrypcje nie są usuwane, gdy aplikacja tworzący zamyka uchwyt subskrypcji. DURABLE
Typ Typ 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.

Parametru Typ nie można modyfikować.

SUBTYPE
Właściwości Parametr Właściwości 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 produktem IBM WebSphere® MQ 6.0 publikowania/subskrypcji.

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ść parametru Dane użytkownika może być opcjonalnie przekazywana jako właściwość komunikatu wysyłanego do subskrypcji. USERDATA
Selektor Parametr Selektor 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ść parametru Dane tożsamości aplikacji będzie używana dla komunikatów wysyłanych do subskrypcji. Jeśli parametr Dane tożsamości aplikacji nie zostanie określony, będzie używana pusta wartość domyślna. PUBAPPID
Token rozliczania Wartość parametru Token rozliczania będzie używana dla komunikatów wysyłanych do subskrypcji. Jeśli parametr Token rozliczania nie zostanie określony, będzie używana wartość domyślna MQACT_NONE. PUBACCT
Priorytet publikowania Parametr Priorytet publikowania 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 Identyfikator subskrypcji 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ść Utrata ważności 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 Wskazuje, że subskrybent będzie odpytywał w poszukiwaniu aktualizacji przy użyciu funkcji API MQSUBPRQ. 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, która oznacza, że publikacje będą dostarczane do subskrypcji tylko w odpowiedzi na funkcję API MQSUBPRQ.

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