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 dotyczą wszystkich typów subskrypcji, natomiast pewne właściwości są specyficzne dla subskrypcji systemu 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 o komendach MQSC zawiera sekcja Administrowanie za pomocą komend MQSC w Centrum Wiedzy 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:
Wszystkie
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ólne subskrybenty mogą tylko ograniczyć wartość parametru 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
Docelowy menedżer kolejek 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: JMS nie umożliwia programowego ustawienia wartości właściwości DESTCORL.
Trwała Subskrypcja stała nie jest usuwana, kiedy aplikacja, która ją utworzyła, zamyka uchwyt subskrypcji. Parametr Trwała subskrypcji może mieć wartość Tak lub Nie. Kiedy parametr Trwała jest ustawiony na wartość Tak, subskrypcje nie są usuwane, kiedy aplikacja, która je utworzyła, 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:

Zgodność: właściwości publikowania/subskrypcji są dodawane do komunikatu w celu zachowania zgodności z funkcjami publikowania/subskrypcji 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 w wersji 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ć stosowany w filtrze (na przykład z klauzulą WHERE), dzięki czemu administrator może wyświetlać jedynie selektory wewnętrzne lub zewnętrzne. 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 dla parametru SUBNAME będącego elementem docelowym komend MQSC DISPLAY, ALTER i DELETE, kiedy nie można podać parametru SUBNAME ze względu na jego format lub jeśli nie określono parametru SUBNAME dla subskrypcji utworzonej przez aplikację. 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 mieścić się w zakresie od 0 do 9. Wartość zero oznacza najniższy poziom. 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