Debugowanie menedżera wiadomości (dbgmsgmgr)

Wprowadzenie

W celu zdefiniowania sposobu rejestrowania komunikatów należy użyć narzędzia dbgmsgmgr. Domyślnie serwer aplikacji po uruchomieniu jest ustawiony na system produkcyjny. Można zmienić następujące ustawienia dla bieżącego serwera aplikacji za pomocą dbgmsgmgr:

poziom ważności od którego dodatkowe informacje o miejscu docelowym wiadomości (grupa wiadomości, identyfikator wiadomości, …) są wyprowadzane dla wiadomości, gdy są one wysyłane do kolejki wiadomości. Jest to pomocne podczas tworzenia aplikacji dialogowych w celu sprawdzenia przypisania komunikatów i pól.
poziom ważności, od którego komunikaty są zapisywane w dzienniku aplikacji lub systemu.
poziom ważność, od której generowany jest również ślad dla komunikatów w celu zidentyfikowania lokalizacji programu, który wygenerował komunikat.
czy komunikaty zapisywane w dzienniku systemowym powinny być również zawsze zapisywane w konsoli i pliku loga.

Obniżenie poszczególnych wartości progowych prowadzi do potencjalnie bardzo wielu wyjść lub wpisów w dziennikach komunikatów i powinno być używane wyłącznie do rozwiązywania problemów.

Oprócz rejestrowania ogólnych komunikatów, narzędzie dbgcls może być również używane do kontrolowania rejestrowania specjalnych komunikatów debugowania.

Grupa docelowa

Administratorzy systemu
Konsultanci techniczni

Opis

Narzędzie pozwala na sprawdzenie i ustawianie wartości progowych, które określają, które komunikaty są zapisywane w dziennikach komunikatów oraz w konsoli lub pliku loga i w jakim czasie.

Polecenie

Poniżej znajduje się polecenie wraz ze wszystkimi możliwymi parametrami.

dbgmsgmgr

[-info][-debugLevel:<vs>]

[-logLevel:<vs>]

[-traceLevel:<vs>]

[-systemLogToConsole:<boolean>]

Parametry

Parametry polecenia zostały wyjaśnione w poniższej tabeli. Parametry w nawiasach kwadratowych są opcjonalne, podczas gdy pozostałe są parametrami obowiązkowymi. Gwiazdka (*) może być określona jako symbol zastępczy dla niektórych parametrów, aby móc wyświetlić wszystkie możliwe wartości. Nie wszystkie parametry mogą być określone wielokrotnie; tylko te z następującym dodatkiem do zmiennych parametrów są dozwolone do wielokrotnego określenia: <str-1> … <str-n>.

Uwaga

W systemie są używane specjalne wartości dla ważności wiadomości, których użytkownik nie może określić bezpośrednio, np. „30” zamiast „35”. Ze względu na ich znaczenie, są one utożsamiane z wyższymi określonymi wartościami.

Parametr	Opis
[-info]	Wyświetlane są bieżące wartości możliwych ustawień.
[-debugLevel:<vs>]	Ustawia poziom debugowania. Wszystkie wywołania: CisMessageQueue.registerMessage() CisMessageQueue.add() CisMessageManager.sendMessage() są wysyłane do konsoli, w zależności od ustawienia. Jest to przydatne do sprawdzania poprawności przypisania komunikatów do pól GUI podczas tworzenia aplikacji dialogowych. Możliwe wartości to: 1 – Brak – żadne wywołania nie są rejestrowane. 2 – Dodaj komunikaty – rejestrowane są tylko połączenia dodające komunikaty. 3 – Zarejestruj i dodaj wiadomości – zrejestrowane są wszystkie wywołania tych trzech metod.
[LogLevel:<vs>]	Pozwala określić minimalną ważność, od której automatycznie generowany jest ślad stosu dla komunikatów, który identyfikuje lokalizacje programu, który wysłał komunikat. Możliwe wartości to 2 – Pasek stanu 5 – Informacja 15 – Ostrzeżenie 25 – Błąd 35 – Błąd krytyczny (wartość domyślna) 45 – Anulowanie funkcji 55 – Naruszenie integralności podsystemu 65 – Naruszenie integralności usługi 75- Naruszenie integralności bazy danych 85 – Naruszenie integralności serwera 95 – Naruszenie integralności systemu
[-traceLevel:<vs>]	Pozwala określić minimalną wagę, powyżej której automatycznie generowany jest ślad stosu dla komunikatów, który identyfikuje lokalizację programu, który wysłał komunikat. Możliwe wartości to: 2 – Pasek stanu 5 – Informacja 15 – Ostrzeżenie 25 – Błąd 35 – Błąd krytyczny (wartość domyślna) 45 – Anulowanie funkcji 55 – Naruszenie integralności podsystemu 65 – Naruszenie integralności usługi 75- Naruszenie integralności bazy danych 85 – Naruszenie integralności serwera 95 – Naruszenie integralności systemu
[-systemLogToConsole: <boolean>]	Określa, czy wszystkie wpisy zapisywane w dzienniku systemowym są również zapisywane w konsoli i pliku loga. Możliwe wartości to true i false.