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.: [phone]
fax: [phone]

e-mail: [e-mail]
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.