AGD / Pralki
Dokumentacja funkcji Hitachi Job Management Partner 1/Base
Oficjalna dokumentacja techniczna funkcji JP1/Base, zawierająca szczegółowe opisy interfejsów programistycznych (API) do wydawania i pobierania zdarzeń JP1.
Spis treści
Wprowadzenie do JP1/Base
Niniejsza dokumentacja techniczna opisuje funkcje udostępniane przez oprogramowanie Hitachi Job Management Partner 1/Base (JP1/Base). Głównym celem dokumentu jest przedstawienie procedur rozszerzania funkcjonalności systemu poprzez programowe wydawanie i pobieranie zdarzeń JP1.
Wydawanie i pobieranie zdarzeń
JP1/Base umożliwia aplikacjom użytkownika bezpośrednią interakcję z bazą danych zdarzeń. Użytkownicy mogą definiować własne zdarzenia (user-defined events) z niestandardowymi atrybutami, co pozwala na lepsze monitorowanie systemów w ramach JP1/Integrated Management.
Kluczowe funkcje API
- JevRegistEvent: Służy do wydawania zdarzeń JP1 do serwera zdarzeń.
- JevGetOpen / JevGetClose: Zarządzają połączeniem aplikacji z serwerem zdarzeń.
- JevGetEvent: Umożliwia pobieranie zdarzeń spełniających określone filtry.
- Funkcje pomocnicze: Dostępne są liczne funkcje do odczytu atrybutów zdarzeń, takie jak JevGetMessage, JevGetArrivedTime czy JevGetFirstExtAttr.
Wymagania techniczne
Aby korzystać z funkcji JP1/Base, wymagane jest środowisko programistyczne z zainstalowanym JP1/Base oraz odpowiednim kompilatorem (np. Visual C++ dla Windows, gcc dla Linux, Sun Studio dla Solaris). Dokumentacja zawiera szczegółowe tabele z opcjami kompilacji i linkowania dla różnych systemów operacyjnych.
Przykłady implementacji
W sekcji załączników znajdują się przykładowe pliki źródłowe (sender.c oraz receiver.c), które ilustrują praktyczne zastosowanie funkcji API do rejestracji zdarzeń oraz ich filtrowania i odczytu z bazy danych. Przykłady te stanowią punkt wyjścia dla programistów integrujących własne aplikacje z systemem JP1.
Informacje o producencie
Hitachi, Ltd.
Praktyczna pomoc
Typowe problemy
Błąd JEV_NO_LIBRARY podczas wywoływania funkcji.
Sprawdź, czy pliki bibliotek nie zostały usunięte i czy użyto poprawnych opcji kompilacji. W razie potrzeby przeinstaluj JP1/Base.
Błąd JEV_S_FILTER_ERROR przy definiowaniu filtra.
Upewnij się, że składnia filtra jest poprawna. Jeśli używasz warunków wykluczenia, upewnij się, że łączysz się z serwerem zdarzeń w wersji 09-00 lub nowszej.
Zdarzenia nie są pobierane mimo poprawnego filtra.
Sprawdź, czy zestaw znaków (locale) użyty w filtrze jest zgodny ze zmienną środowiskową LANG używaną przez aplikację.
Przed użyciem
- Zainstaluj JP1/Base na maszynie, na której będzie odbywać się kompilacja i uruchamianie.
- Zainstaluj wspierany kompilator dla danego systemu operacyjnego.
- Upewnij się, że użytkownik ma odpowiednie uprawnienia administratora.
- Skonfiguruj parametr 'users' w pliku konfiguracyjnym serwera zdarzeń (conf), aby umożliwić połączenie.
- Przygotuj pliki definicji atrybutów zdarzeń, jeśli chcesz, aby były one widoczne w JP1/IM.
Zgodność modelu
- JP1/Base zapewnia kompatybilność binarną z aplikacjami stworzonymi w starszych wersjach, pod warunkiem, że wersja środowiska wykonawczego jest taka sama lub nowsza niż wersja środowiska programistycznego.
- W środowisku Linux x64 należy dodać flagę -m32 do opcji kompilacji i linkowania.
Autor opracowania
Anna Kowalska
Redaktorka treści użytkowych
Tworzy krótkie opisy instrukcji i porządkuje informacje techniczne tak, aby były zrozumiałe dla osób szukających manuala online.