INFORMATOR TECHNICZNY WONDERWARE

Informator Techniczny nr 20 
14-11-2000 
 

Alarm Logger – narzędzie do składowania informacji alarmowych w 
relacyjnej bazie danych

 

 
 

Wstęp 

 
Alarm Logger jest oprogramowaniem, które poprzez swoją funkcjonalność rozszerza grupę dostępnych 
standardowych opcji InTouch’a dotyczących przede wszystkim alarmowania rozproszonego. Jedynym 
warunkiem korzystania z niego jest konieczność posiadania oprogramowania InTouch w wersji 7.1, 
(Alarm Logger domyślnie instalowany jest w głównym katalogu InTouch’a). 
Wykorzystując Alarm Logger’a, użytkownik może wybrać, następujące opcje: 

•  zapisywanie informacji alarmowych do pliku .ALD. Jest to plik tekstowy (ASCII), którego zawar-

tość można przeglądać oraz edytować za pomocą każdego edytora teksu np. Notatnika lub też 
zaimportować do arkusza kalkulacyjnego np. Excel. 

•  drukowanie przez drukarkę podłączoną do określonego portu, 

•  składowanie informacji alarmowych w bazie danych SQL. 

Nazwa pliku .ALD tworzona jest automatycznie przez Alarm Logger wykorzystując format daty i czasu: 

YYMMDDHH.ald, gdzie YY – rok, MM – miesiąc, DD –dzień, HH – godzina (domyślnie HH przyjmuje 
postać dwóch zer). 

 

 

Edycja pliku za pomocą Notatnika. 

 
Domyślny format daty, jaki zapisywany jest w pliku tekstowym, ma następującą postać: DD MMM YYYY, 
natomiast czas jest zapisywany w postaci HH:MM:SS:MsMsMs, gdzie: HH – godziny, MM – minuty, SS 
– sekundy, Ms – milisekundy. Oczywiście format daty i czasu można zmienić według własnych 
preferencji.  
Użytkownik może tworzyć wiele konfiguracji – każda z nich jest zapisywana do pliku z rozszerzeniem 
.ALC. W ten sposób zwiększono elastyczność definiowania konfiguracji logowania informacji 
alarmowych - wystarczy tylko wskazać plik, w którym zawarte są zdefiniowanie ustawienia. Dodatkowo 
można uruchomić więcej niż jedną konfigurację. Dzięki temu może równocześnie pracować kilka 
zdefiniowanych konfiguracji (Alarm Logger’ów), co zabezpiecza cały mechanizm logowania przed 
sytuacją awaryjną np. brak papieru w drukarce, nie spowoduje zawieszenia zbierania informacji 
alarmowych, gdyż za to będzie odpowiadać inna konfiguracja. 
 

 

ASTOR Sp. z o.o. 
Dział Oprogramowania Przemysłowego 
ul. Smoleńsk 29, 31-112 Kraków 

tel.: 012 428-63-30 
fax: 012 428-63-09 
 

e-mail: wonderware1@astor.com.pl 
http://www.astor.com.pl 

 

Praca z Alarm Logger’em 

 
Po uruchomieniu Alarm Logger’a (almlgr.exe) na ekranie pojawia się okno wyświetlające domyślną 
konfigurację: 
 

 

 
Aby zdefiniować nową konfigurację należy w menu File wybrać opcję New. W celu zmiany domyślnych 
ustawień wybrać z menu opcję  Output, a następnie  Configuration. Pojawi się okno Configuration 
Settings, gdzie można wprowadzać własne ustawienia. 
 
W zakładce Query można zdefiniować właściwości zapytania o alarmy: 
 

 

 
 
 

 

2

Właściwość 

Opis 

From Priority 

Najmniejszy priorytet alarmu (domyślnie 1) 

To Priority 

Największy priorytet alarmu (domyślnie 999) 

Alarm State 

Status alarmu: All –wszystkie, Unack – niepotwierdzone, 
Ack – potwierdzone 

Alarm Query 

Zapytanie o alarmy według notacji Distributed Alarms 

 
Zakładka Message umożliwia wybór informacji jakie będą zapisywane wraz z alarmami. 
 

 

 
Należy zaznaczyć Date, jeżeli w komunikacie o alarmie ma być dołączona data. Można wybrać jeden z 
następujących formatów: 
 

Format 

Wygląd 

DD MMM 

28 Feb 

DD MMM YYYY 

28 Feb 2000 

DD/MM 

28/02 

DD/MM/YY 

28/02/00 

MM/DD 

02/28 

MM/DD/YY 

02/28/00 

MMM DD 

Feb 28 

MMM DD YYYY 

Feb 28 2000 

 
Zaznaczyć  Time, jeżeli w komunikacie o alarmie ma być dołączony czas. Można wybrać jeden z na-
stępujących formatów: 
 

Format 

Wygląd 

HH:MM:SS.SSS 

11:56:23.456 

HH:MM:SS 

11:56:23 

HH:MM 

11:56 

HH:MM:SS.SSS AP 

11:56:23.456 AM 

HH:MM:SS AP 

11:56:23 AM 

HH:MM AP 

11:56 AM 

 

 

3

W polu sortowania, umieszczonym poniżej pola Time, zaznaczyć kryterium do sortowania komunikatów 
o alarmach. Dostępne są trzy możliwości: 

•  LCT – Last Changed Time, 

•  OAT – Orginal Alarm Time, 

•  LCT But OAT on ACK 

Zaznaczyć Alarm State (Unack, Ack) jeżeli ma być rejestrowany status alarmu. 
Zaznaczyć Alarm Class (VALUE, DEV, ROC, ...), jeżeli ma być rejestrowana kategoria alarmu. 
Zaznaczyć Alarm Type (HIHI, LO, MAJDEV, ...), jeżeli ma być rejestrowany typ alarmu. 
Zaznaczyć Priority, jeżeli ma być rejestrowany priorytet alarmu. 
Zaznaczyć Alarm Name, jeżeli ma być rejestrowany alarm/zmienna. W polu Length wprowadzić liczbę 
znaków (maksymalnie 32). 
Zaznaczyć  Group Name, jeżeli ma być rejestrowana nazwa Grupy alarmowej. W polu Lenght 
wprowadzić liczbę znaków (maksymalnie 32). 
Zaznaczyć  Alarm Provider, jeżeli ma być rejestrowana nazwa źródła alarmu. W polu Lenght wpro-
wadzić liczbę znaków (maksymalnie 32). 
Zaznaczyć  Value at Alarm, jeżeli w momencie pojawienia się alarmu ma być rejestrowana bieżąca 
wartość zmiennej. W polu Lenght wprowadzić liczbę znaków. Wartość ta powinna być na tyle duża, aby 
zapewniony był żądany stopień dokładności (maksymalnie 15 znaków) 
Zaznaczyć Limit, jeżeli ma być rejestrowana wartość graniczna alarmowania dla zmiennej. Wartość ta 
powinna być tak duża, aby zapewniony był żądany stopień dokładności (maksymalnie 32 znaki). 
Zaznaczyć  Operator, jeżeli identyfikator ID zalogowanego operatora ma być rejestrowany. W polu 
Lenght wprowadzić liczbę znaków (maksymalnie 16). 
Zaznaczyć  Comment, jeżeli ma być rejestrowany komentarz zmiennej. Komentarz ten wprowadzany 
jest w polu Comments  podczas definiowania zmiennej. W polu Lenght wprowadzić liczbę znaków 
(maksymalnie 50). 
Zaznaczyć User Defined, jeżeli ma być rejestrowana nazwa zmiennej. W polu Lenght wprowadź liczbę 
znaków. Wartość ta powinna być tak duża, aby zapewniony był  żądany stopień dokładności 
(maksymalnie 32 znaki). 
 
Zakładka  File Logging umożliwia zdefiniowanie konfiguracji do logowania informacji alarmowych do 
plików tekstowych. 
 

 

 

 

4

W polu Directory należy wprowadzić  ścieżkę dostępu do katalogu w którym gromadzone będą pliki z 
informacjami o alarmach. Każda konfiguracja Alarm Loggera wymaga osobnego pliku do logowania.  
Pole Number of Hours to Cycle Filename umożliwia określenie co jaki okres czasu będzie tworzony 
nowy plik tekstowy, do którego będą składowane informacje o alarmach. Domyślna wartość 24 oznacza, 
że nowy plik będzie tworzony co dobę. 
W polu Starting at Hour (0-23) wymagane jest wpisanie wartości liczbowej określającej godzinę, o 
której zostanie utworzony plik. Domyślna wartość 0 oznacza, że każdy nowy plik będzie tworzony o 
północy. 
Pole  Keep Log Files  for pozwala na zdefiniowanie okresu czasu przez który plik będzie przechowy-
wany na dysku. Domyślna wartość 0 oznacza, że plik nie będzie automatycznie wymazywany. 
Zaznaczenie opcji Remote Trailing Spaces spowoduje usunięcie wszystkich niewykorzystanych 
znaków określonych w polach Lenght w zakładce Message. 
Natomiast odznaczenie tej funkcji, spowoduje zapisywanie informacji w pliku w postaci wyodrębnionych 
kolumn. 
 

 

 

Odznaczenie opcji Remove Trailing Spaces powoduje zapisywanie wybranych informacji o alarmach w 

wyróżnionych kolumnach. 

 
Zakładka Printing pozwala na wybranie portu, do którego podłączona zostanie drukarka alarmowa. Przy 
czym należy pamiętać o tym, że drukarka dedykowana do drukowania alarmów, nie może zostać 
wykorzystana w innym celu. 
W opcji Port Cofiguration konfiguruje się komunikację portu szeregowego COM, w przypadku, gdy 
będzie on wykorzystywany do komunikacji z drukarką. 
 

 

 
 

 

5

Logowanie informacji o alarmach do bazy danych 

 
W celu wykorzystania tej funkcjonalności należy w pierwszym etapie zdefiniować bazę danych w której 
będą składowane informacje o alarmach. 
 W tym przypadku proponuje się zdefiniowanie bazy danych  alarmlogger.mdb w Microsoft Access. 
W definiowanej bazie danych powinny znajdować się dwie tablice: alarm oraz alarm_query, o 
następującej definicji pól: 
 

 

 

 

 
Po zdefiniowaniu bazy danych należy wybrać w Alarm Logger zakładkę  Database Logging, w której 
określa się ustawienia potrzebne do logowania informacji o alarmach do bazy danych. 
 

 

6

 

 
W polu ODBC connection należy określić  ścieżkę do bazy danych w której będą gromadzone in-
formacje o alarmach. 
Poprzez opcję  Cofigure można automatycznie określić  źródło danych ODBC. Po wybraniu przycisku 
Configure pojawi się okno Select Data Source,  służące do wyboru źródła danych. Jeżeli nie zostało 
wcześniej ono zdefiniowane, należy w zakładce Machine Data Source wybrać przycisk New. 

 

 
Po wybraniu tego przycisku pojawi się okno Create New Data Source, w którym można zdefiniować, 
czy tworzone źródło danych będzie dostępne tylko dla określonego użytkownika:  User Data Source 
(Applies to this machine only), czy też dla wszystkich użytkowników systemu: System Data Source 
(Applies to this machnie only). 
 

 

7

 

 
Wybierając np. pierwszą opcję, w celu kontynuowania definiowania należy przycisnąć przycisk Dalej. 
Następnie pojawi się okno do wyboru sterownika, który będzie wykorzystany do obsługi bazy danych. 
Wybierając Microsoft Access Driver, dostępna będzie możliwość składowania informacji alarmowych 
w bazie danych utworzonej w Microsoft Access. 
 

 

 
Wybierając przycisk Dalej można kontynuować konfigurację, co spowoduje pojawienie się okna za-
chęcającego do zatwierdzenia przeprowadzonej konfiguracji poprzez wybranie przycisku Zakończ. 
 

 

8

 

 
Po zatwierdzeniu dotychczasowej konfiguracji, kolejnym krokiem jest wskazanie utworzonej bazy danych  
.mdb, w oknie ODBC Microsoft Access Setup. 
 

 

 
W polu Data Source Name należy podać dowolną nazwę definiowanego źródła danych, w tym 
przypadku wpisano po prostu alarmy, natomiast za pomocą przycisku Select, który umożliwia 
przeglądanie zasobów dysków, należy wskazać utworzoną bazę danych w Microsoft Access. – w tym 
przypadku jest to baza danych o nazwie alarmlogger.mdb.  
 

 

9

 

 
Po wykonaniu tych czynności należy aktywnym  przyciskiem OK zatwierdzić wykonaną konfigurację. 
Wtedy w oknie Select Data Source pojawi się zdefiniowane nowe źródło danych. 
 

 

 
Wybierają przycisk OK pojawi się okno służące do zdefiniowania użytkownika, który będzie logował się 
do zdefiniowanego źródła danych.  
 

 

 

 

10

W polu Login name należy wpisać użytkownika o nazwie admin, który będzie miał największe prawa w 
zarządzaniu bazą danych alarmlogger.mdb. W polu Password można wpisać hasło weryfikujące 
logującego się w przyszłości użytkownika admin. W tym przypadku zrezygnowano z podawania hasła. 
Następnie należy zatwierdzić wprowadzone informacje przyciskiem OK. 
Po tej czynności nastąpi automatyczny powrót do zakładki  Database Logging, gdzie w polu ODBC 
Connection pojawi się definicja połączenia z źródłem danych ODBC. 
 

 

 
Aby sprawdzić poprawność przeprowadzonej konfiguracji należy wybrać przycisk Verify. Jeżeli wszystko 
zostało prawidłowo zdefiniowane pojawi się komunikat o pozytywnej weryfikacji źródła danych ODBC. 
 

 

 
Jeżeli natomiast pojawi się komunikat o błędnej konfiguracji, to najczęstszą przyczyną jest niepoprawna 
definicja bazy danych, w której składowane będą informacje o alarmach. 
 
 

Pasek narzędziowy Alarm Logger 

 

 

 
Podstawowe funkcje Alarm Logger’a dostępne są poprzez ikony umieszczone w pasku narzędziowym. 
Poszczególne ikony mają następującą funkcjonalność: 
 
 
 
 

 

11

 

12

Ikona 

Opis funkcjonalności 

 

Tworzenie nowej konfiguracji Alarm Logger 

 

Otwarcie istniejącej konfiguracji Alarm Logger 

 

Zapisanie edytowanej konfiguracji do pliku 

 

Konfiguracja Alarm Logger 

 

Uruchomienie/zatrzymanie zapytania 

 

Uruchomienie/zatrzymanie opcji logowania do pliku 

 

Uruchomienie/zatrzymanie drukowania 

 

Uruchomienie/zatrzymanie logowania do bazy danych 

 
 

Funkcje automatycznego uruchamiania Alarm Logger 

 
Aby automatycznie uruchomić zdefiniowaną konfigurację Alarm Logger’a, w momencie gdy startuje 
system operacyjny należy w utworzonym pliku .BAT wpisać komendę:  almlgr.exe alarm.alc, gdzie 
alarm.alc jest zapisaną konfiguracją, która zostanie uruchomiona. Komendy pliku .BAT, będą 
wykonywane wraz ze startem systemu. 
Natomiast, aby automatycznie uruchomić określone zapytanie, w chwili gdy uruchamiany jest Alarm 
Logger, należy użyć komendy: almlgr –q alarm.alc, gdzie alarm.alc jest zapisaną konfiguracją, która 
zostanie uruchomiona. To zapewni, że zapytanie zostanie wykonane po każdym ponownym 
uruchomieniu systemu.