Właściwości produktu IBM MQ

Właściwości produktu IBM® MQ dotyczą całej instalacji produktu IBM MQ.

W poniższych tabelach przedstawiono właściwości, które można ustawić w produkcie IBM MQ:

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łaściwości w oknie dialogowym właściwości produktu IBM MQ odnoszą się do sekcji w plikach konfiguracyjnych.

Strona Ogólne

W poniższej tabeli przedstawiono właściwości, które można ustawić na stronie Ogólne w oknie dialogowym Właściwości produktu IBM MQ.

Właściwość Opis Klucz sekcji
Przedrostek domyślny Aby zmienić położenie katalogu, w którym składowane są wszystkie dane menedżera kolejek, podaj pełną ścieżkę do nowego katalogu. DefaultPrefix
Domyślna nazwa menedżera kolejek Aby określić domyślną nazwę nowych menedżerów kolejek, wpisz nazwę w tym polu. Nazwa

Strona Rozszerzone

W poniższej tabeli przedstawiono właściwości, które można ustawić na stronie Rozszerzone w oknie dialogowym Właściwości produktu IBM MQ.

Właściwość Opis Klucz sekcji
[9.2.0, lipiec 2020]Domyślny przedrostek danych efemerycznych Aby zmienić położenie katalogu, w którym przechowywane są wszystkie dane efemeryczne menedżera kolejek, należy podać pełną ścieżkę do nowego katalogu. DefaultEphemeralPrefix
Przekształcanie nowego wiersza EBCDIC Strony kodowe EBCDIC zawierają znak nowego wiersza (NL), który nie jest obsługiwany przez strony kodowe ASCII (mimo tego, że niektóre warianty ISO kodu ASCII zawierają jego odpowiednik). Jeśli komunikaty są wysyłane z systemu, który używa stron kodowych EBCDIC (na przykład systemu z/OS), do systemu używającego kodu ASCII, można kontrolować sposób konwersji znaku nowego wiersza z formatu EBCDIC na format ASCII. Wartość domyślna to NL_TO_LF, co oznacza, że znak EBCDIC NL (X'15') jest konwertowany na znaku nowego wiersza LF (X'0A') w kodzie ASCII w przypadku wszystkich konwersji z EBCDIC na ASCII. Aby dokonać konwersji znaku NL EBCDIC zgodnie z tabelami konwersji w systemie operacyjnym, kliknij opcję TABLE. Należy zauważyć, że wyniki konwersji TABLE mogą różnić się w zależności od platformy i języka. Nawet na tej samej platformie wyniki mogą być różne, jeśli używane są różne identyfikatory kodowanego zestawu znaków (CCSID). Aby przeprowadzić konwersję identyfikatorów CCSID ISO za pomocą metody TABLE i użyć metody NL_TO_LF dla wszystkich innych identyfikatorów CCSID, kliknij opcję ISO. ConvEBCDICNewline
Tryb obciążenia klastra Wyjście obciążenia klastra (CLWL) pozwala określić, która kolejka klastrowa w klastrze ma zostać otwarta w odpowiedzi na wywołanie MQI (np. MQOPEN lub MQPUT). Wartość domyślna to SAFE, co oznacza, że wyjście CLWL jest uruchamiane w oddzielnym procesie dla menedżera kolejek, tak aby w przypadku wystąpienia problemu zachować integralność menedżera kolejek. Jednak uruchomienie wyjścia CLWL jako osobnego procesu może pogorszyć wydajność. Aby poprawić wydajność, uruchamiając wyjście CLWL w tym samych procesie, co menedżer kolejek, kliknij opcję FAST. Trybu FAST należy używać tylko wtedy, gdy użytkownik ma pewność, że nie ma problemów z wyjściem CLWL, ponieważ jeśli wystąpi problem z trybem FAST, działanie menedżera kolejek nie powiedzie się i pojawi się niebezpieczeństwo utraty integralności menedżera kolejek. Ta wartość może zostać przesłonięta dla poszczególnych menedżerów kolejek przy użyciu właściwości trybu obciążenia klastra. Więcej informacji na ten temat zawiera sekcja Właściwości menedżera kolejek. CLWLMode

Strona Wyjścia

W poniższej tabeli przedstawiono właściwości, które można ustawić na stronie Wyjścia w oknie dialogowym Właściwości produktu IBM MQ. Aby skonfigurować wyjścia, które są wspólne dla wszystkich menedżerów kolejek na tym komputerze, zmień właściwości na stronie Wyjścia.

Właściwość Opis Klucz sekcji
Domyślna ścieżka wyjść Aby zmienić położenie wyjść kanału dla klientów oraz wyjść kanału i konwersji danych dla serwerów, należy podać ścieżkę do nowego katalogu. ExitsDefaultPath
Wspólne wyjścia funkcji API Aby skonfigurować nowe wspólne wyjście funkcji API dla produktu IBM MQ, należy kliknąć opcję Dodaj, a następnie w oknie dialogowym Właściwości podać szczegóły wyjścia. Aby zmienić wspólne wyjście funkcji API, które zostało już pokazane w tabeli, należy kliknąć opcję Edytuj. Aby usunąć wyjście funkcji API z tabeli, należy kliknąć opcję Usuń. ApiExitCommon
Szablony wyjść funkcji API Aby skonfigurować nowy szablon wyjścia funkcji API dla produktu IBM MQ, należy kliknąć opcję Dodaj, a następnie w oknie dialogowym Właściwości podać szczegóły wyjścia. Aby zmienić szablon wyjścia funkcji API, który jest już pokazany w tabeli, należy kliknąć opcję Edytuj. Aby usunąć wyjście funkcji API z tabeli, należy kliknąć opcję Usuń. ApiExitTemplate
Nazwa Określa opis wyjścia funkcji API przekazywany do wyjścia funkcji API w polu ExitInfoName w strukturze MQAXP. Musi to być unikalna nazwa zawierająca nie więcej niż 48 znaków, przy czym wszystkie znaki muszą być poprawne dla nazw obiektów IBM MQ, na przykład nazw kolejek. Nazwa
Typ Określa typ wyjścia: wspólne lub szablon. (Brak odrębnego klucza sekcji)
Kolejność Właściwość będąca wartością liczbową bez znaku, za pomocą której definiowana jest kolejność wywoływania tego wyjścia funkcji API w porównaniu z pozostałymi wyjściami funkcji API. Wywołanie wyjścia funkcji API z niskim numerem kolejnym następuje przed wywołaniem wyjścia funkcji API z wyższym numerem kolejnym. Kolejność wywoływania różnych wyjść funkcji API z takim samym numerem kolejnym jest niezdefiniowana. Zaleca się, aby między kolejnymi numerami wyjść funkcji API zdefiniowanymi dla menedżera kolejek występowały przerwy. Kolejność
Moduł Służy do określenia modułu zawierającego kod dla wyjścia funkcji API. Jeśli w polu znajduje się pełna nazwa ścieżki do modułu, jest ona używana w takiej postaci. Jeśli w polu znajduje się tylko nazwa modułu, wyszukiwanie modułu odbywa się przy użyciu takiej samej metody, jak wyszukiwanie wyjść kanału, to znaczy za pomocą wartości określonej w polu Domyślna ścieżka wyjść na stronie Wyjścia w oknie dialogowym Właściwości menedżera kolejek. Moduł
Funkcja Określa nazwę punktu wejścia funkcji do modułu zawierającego kod dla wyjścia funkcji API. Punktem wejścia jest funkcja MQ_INIT_EXIT. Wielkość tego pola jest ograniczona do wartości MQ_EXIT_NAME_LENGTH. Funkcja
Dane Jeśli określono tę właściwość, usuwane są odstępy początkowe i końcowe, a pozostały łańcuch jest obcinany do 32 znaków. Następnie wynik jest przekazywany do wyjścia znajdującego się w polu ExitData w strukturze MQAXP. Jeśli ta właściwość nie zostanie określona, do wyjścia znajdującego się w polu ExitData w strukturze MQAXP przekazywana jest domyślna wartość stanowiąca 32 znaki odstępu. Dane

Domyślne ustawienia dziennika

W poniższej tabeli przedstawiono właściwości, które można ustawić na stronie Domyślne ustawienia dziennika w oknie dialogowym Właściwości produktu IBM MQ. Aby zmienić domyślne ustawienia dziennika, należy zmienić właściwości na stronie Domyślne ustawienia dziennika. Te ustawiania mają zastosowanie do wszystkich nowych menedżerów kolejek (domyślnie).

Właściwość Opis Klucz sekcji
Typ dziennika Aby umożliwić menedżerowi kolejek odtwarzanie, gdy jest restartowany, kliknij opcję Cykliczny. Jeśli menedżer kolejek używa rejestrowania cyklicznego, to gdy plik dziennika jest pełny, jest nadpisywany i rejestrowanie rozpoczyna się od początku pliku. Aby umożliwić menedżerowi kolejek odtwarzanie, gdy jest restartowany, oraz aby włączyć odtwarzanie nośnika lub odtwarzanie do przodu, kliknij opcję Liniowy. Jeśli menedżer kolejek używa rejestrowania liniowego, po zapełnieniu pliku dziennika jest tworzony nowy plik dziennika. LogType
Ścieżka do dziennika Aby zmienić domyślne położenie dzienników, wpisz tutaj pełną ścieżkę. Jeśli nie zostanie tutaj wpisana ścieżka, wartością domyślną jest podkatalog o nazwie Dziennik znajdujący się w katalogu Przedrostek_domyślny, gdzie Przedrostek_domyślny to katalog określony we właściwości Przedrostek domyślny na stronie Ogólne okna dialogowego Właściwości produktu IBM MQ. LogPath
Strony pliku dziennika Wpisz wartość z zakresu od 32 do 4095 określającą liczbę 4-kilobajtowych stron w pliku dziennika. Na przykład jeśli zostanie podana wartość 256, wielkość pliku wynosi 1 MB. LogFilePages
Podstawowe pliki dziennika

W systemie Windows należy wpisać liczbę podstawowych plików dziennika z zakresu od 2 do 254. Wartość domyślna to 3. Całkowita liczba podstawowych i drugorzędnych plików dziennika nie może być większa niż 255 ani mniejsza niż 3.

W systemie UNIX i Linux® należy wpisać liczbę podstawowych plików dziennika z zakresu od 2 do 510. Wartość domyślna to 3. Całkowita liczba plików podstawowych i drugorzędnych dziennika nie może być większa niż 511 ani mniejsza niż 3.

LogPrimaryFiles
Drugorzędne pliki dziennika

W systemie Windows należy wpisać liczbę plików drugorzędnych dziennika z zakresu od 1 do 253. Wartość domyślna to 3. Całkowita liczba podstawowych i drugorzędnych plików dziennika nie może być większa niż 255 ani mniejsza niż 3.

W systemie UNIX i Linux należy wpisać liczbę plików drugorzędnych dziennika z zakresu od 1 do 509. Wartość domyślna to 3. Całkowita liczba plików podstawowych i drugorzędnych dziennika nie może być większa niż 511 ani mniejsza niż 3.

LogSecondaryFiles
Strony buforu dziennika Wpisz liczbę (z zakresu od 0 do 512) stron buforu o wielkości 4 kB do zapisu. Jeśli zostanie określona wartość 0, menedżer kolejek sam wybierze liczbę.

Jeśli zostanie podana liczba z zakresu od 1 do 17, zostanie użyta wartość minimalna 18. Jeśli zostanie podana liczba z zakresu od 18 do 512, zostanie ona użyta. Jeśli wartość tej właściwości zostanie zmieniona, należy zrestartować menedżer kolejek, aby umożliwić wykrycie zmiany.

LogBufferPages
Integralność zapisu dziennika Metoda używana przez program rejestrujący do niezawodnego zapisu rekordów dziennika.

Wartość domyślna to TripleWrite. Należy pamiętać, że można wybrać wartość DoubleWrite, ale w takim przypadku system interpretują ją jako wartość TripleWrite.

Wartości SingleWrite należy używać tylko wtedy, gdy dziennik odtwarzania produktu IBM MQ jest przechowywany w systemie plików lub na urządzeniu jawnie gwarantującym niepodzielność zapisów o wielkości 4 kB.

To oznacza, że jeśli z jakiegoś powodu zapis strony o wielkości 4 kB nie powiedzie się, są możliwe tylko dwa stany: przed obrazem i po obrazie. Nie powinien być możliwy żaden stan pośredni.

LogWriteIntegrity
Zarządzanie protokołami Metoda używana do zarządzania dziennikami. Metoda LogManagement ma zastosowanie tylko wtedy, gdy LogType ma wartość LINEAR.

Jeśli zostanie zmieniona wartość metody LogManagement, zmiana ta odniesie skutek dopiero po zrestartowaniu menedżera kolejek.

Istnieją trzy opcje.

Manual (Ręcznie), w przypadku której zakresy dziennika są zarządzane ręcznie. Podanie tej opcji oznacza, że menedżer kolejek nie wykorzystuje ponownie ani nie usuwa zakresów dziennika, nawet jeśli nie są one już wymagane podczas odtwarzania.

Automatic (Automatyczne), w przypadku której zakresy dziennika są zarządzane automatycznie przez menedżer kolejek. Podanie tej opcji oznacza, że menedżer kolejek może wykorzystywać ponownie i usuwać zakresy dziennika, jeśli tylko nie są one już wymagane podczas odtwarzania. Nie jest dozwolone archiwizowanie.

Archive (Archiwizuj), w przypadku której zakresy dziennika są zarządzane przez menedżer kolejek, ale należy poinformować menedżer kolejek o zakończeniu archiwizacji zakresu dziennika.

Podanie tej opcji oznacza, że menedżer kolejek może dowolnie wykorzystywać ponownie i usuwać zakresy dziennika, jeśli tylko menedżer kolejek został powiadomiony o tym, że zakres, który nie jest już wymagany podczas odtwarzania, został zarchiwizowany.

Wartość domyślna to Manual.

LogManagement

Strona ACPI

W poniższej tabeli przedstawiono właściwości, które można ustawić na stronie ACPI w oknie dialogowym Właściwości produktu IBM MQ. Interfejs ACPI (Advanced Configuration and Power Interface) to składnik systemu operacyjnego umożliwiający komputerowi wykrywanie określonych stanów aktywności, a następnie przeprowadzanie hibernacji, czyli samoczynnego przełączania się w tryb niskiego poboru mocy bez uruchomionych programów pozwalającego na szybkie aktywowanie komputera.

Kiedy interfejs ACPI chce wprowadzić komputer w stan hibernacji, najpierw wysyła żądanie zawieszenia do wszystkich aplikacji. Aby określić odpowiedź produktu IBM MQ na to żądanie, należy ustawić właściwość Wykonaj dialog na stronie ACPI.

Właściwość Opis Klucz sekcji
Wykonaj dialog Wartość domyślna to Tak. To oznacza, że w produkcie IBM MQ zostanie wyświetlony komunikat z zapytaniem, czy uruchomione menedżery kolejek mają zostać zawieszone. Aby wprowadzić produkt IBM MQ w tryb zawieszenia bez wyświetlania tego komunikatu, należy kliknąć opcję Nie. DoDialog
Odmowa zawieszenia Jeśli właściwość Wykonaj dialog nie jest ustawiona lub jeśli jest ustawiona, lecz okno dialogowe nie może zostać wyświetlone (na przykład jeśli komputer laptop ma zamkniętą pokrywę), wówczas właściwość Odmowa zawieszenia steruje odpowiedzią. Wartość domyślna to Nie. To oznacza, że produkt IBM MQ przechodzi w tryb zawieszenia, nawet gdy nie można wyświetlić okna dialogowego. Aby uniemożliwić przechodzenie produktu IBM MQ w tryb zawieszenia, gdy nie można wyświetlić okna dialogowego, należy kliknąć opcję Tak. Właściwość ta może zostać przesłonięta przez właściwość Sprawdź uruchomione kanały. DenySuspend
Sprawdź uruchomione kanały Wartość domyślna to Nie. To oznacza, że produkt IBM MQ nie sprawdza, czy są uruchomione kanały, i odpowiada zgodnie z ustawieniami właściwości Wykonaj dialog i Odmowa zawieszenia. Aby sprawdzić, czy istnieją uruchomione kanały, kliknij opcję Tak. Jeśli nie ma żadnych uruchomionych kanałów, produkt IBM MQ ignoruje właściwości Wykonaj dialog i Odmowa zawieszenia. Jeśli kanały są uruchomione, produkt IBM MQ odpowiada zgodnie z ustawieniami właściwości Wykonaj dialog i Odmowa zawieszenia. CheckChannelsRunning
[Windows]

Strona Monitor alertów

Monitor alertów jest dostępny tylko w systemie Windows.

W poniższej tabeli przedstawiono właściwości, które można ustawić na stronie Monitor alertów w oknie dialogowym Właściwości produktu IBM MQ. Monitor alertów jest przydatny w określaniu problemów. Alerty są wywoływane przez usługi, kiedy pojawiają się nieprawidłowości, na przykład jeśli usługa inicjatora kanału nie może zostać uruchomiona, ponieważ usunięto wymaganą kolejkę. Aby skonfigurować monitor alertów, zmień właściwości na stronie Monitor alertów.

Właściwość Opis Klucz sekcji
Monitor alertów powiadamia użytkownika Wartość domyślna to Nie. To oznacza, że produkt IBM MQ nie wysyła alertów do użytkownika w przypadku pojawienia się problemu. Aby skonfigurować produkt IBM MQ do wysyłania alertów w przypadku problemów, należy kliknąć opcję Tak. Enable
Użytkownik monitora alertów Należy wpisać nazwę komputera lub nazwę użytkownika, do którego produkt IBM MQ ma wysyłać alerty. Recipient
Ikona monitora alertów dodana do paska zadań Wartość domyślna to Nie, co oznacza, że ikona Monitora alertów nie jest wyświetlana na pasku zadań systemu Windows. Aby wyświetlić ikonę Monitora alertów na pasku zadań systemu Windows, kliknij przycisk Tak. TaskBar

Strona Informacje o konfiguracji

W poniższej tabeli przedstawiono właściwości, które są wyświetlane na stronie Informacje konfiguracyjne w oknie dialogowym Właściwości produktu IBM MQ. Właściwości na stronie Informacje konfiguracyjne są tylko do odczytu.

Właściwość Opis
Typ instalacji Tylko do odczytu. Ta właściwość wskazuje, czy na komputerze zainstalowano serwer czy klient produktu IBM MQ.
Załadowano mqjbnd05 Tylko do odczytu. To jest biblioteka wymagana podczas łączenia z lokalnymi menedżerami kolejek.
Wersja MQ Tylko do odczytu. Jest to wersja produktu IBM MQ zainstalowanego na komputerze.
Wersja kompilacji Tylko do odczytu. Jest to numer kompilacji produktu IBM MQ zainstalowanego na komputerze.
Typ kompilacji Tylko do odczytu. Jest to typ kompilacji produktu IBM MQ zainstalowanego na komputerze.