Instrukcja obsługi Hitachi Job Management Partner 1/Base

Najważniejsze informacje z instrukcji

Niniejszy dokument stanowi referencję funkcji dla oprogramowania Hitachi Job Management Partner 1/Base (JP1/Base). Jest przeznaczony dla programistów i administratorów systemów, którzy chcą rozszerzyć funkcjonalność JP1/Base poprzez wydawanie i pobieranie zdarzeń JP1 z własnych aplikacji. Dokument zawiera procedury operacyjne, przykłady kodu w języku C oraz szczegółowy opis dostępnych funkcji API.

Wydawanie zdarzeń JP1

Aby wydawać zdarzenia zdefiniowane przez użytkownika, należy wykonać następujące kroki:

• Zdecydować o typach i atrybutach zdarzeń, które mają być wydawane.
• Napisać kod wykorzystujący funkcję wydawania zdarzeń JP1 (JevRegistEvent).
• Skompilować pliki źródłowe.
• Opcjonalnie utworzyć pliki definicji dla rozszerzonych atrybutów zdarzeń i typów obiektów w JP1/IM.

Podczas wydawania zdarzeń należy pamiętać o ograniczeniach dotyczących liczby atrybutów (maksymalnie 100) oraz rozmiaru danych (maksymalnie 10 000 bajtów dla wszystkich wartości atrybutów).

Pobieranie zdarzeń JP1

Proces pobierania zdarzeń z bazy danych JP1/Base obejmuje:

1. Określenie typów i atrybutów zdarzeń do pobrania.
2. Zdefiniowanie filtra pobierania zdarzeń.
3. Napisanie kodu wykorzystującego funkcje pobierania (JevGetOpen, JevGetEvent, JevGetClose).
4. Kompilację plików źródłowych.

Funkcja JevGetOpen służy do nawiązania połączenia z serwerem zdarzeń, JevGetEvent do pobierania zdarzeń spełniających kryteria filtra, a JevGetClose do zakończenia sesji i rozłączenia.

Kompilacja i linkowanie

Aby skompilować aplikacje korzystające z funkcji JP1/Base, należy:

• Użyć odpowiedniego pliku nagłówkowego (JevApi.h).
• Dołączyć wymagane biblioteki statyczne dostarczone z JP1/Base, zależne od systemu operacyjnego i kompilatora.
• Zastosować odpowiednie opcje kompilacji i linkowania (np. /MD dla Windows, -I/opt/jp1base/include dla UNIX).

Opis funkcji API

Dokumentacja zawiera szczegółowy opis funkcji API, w tym:

• JevRegistEvent: Wydaje zdarzenie JP1 do serwera zdarzeń.
• JevGetOpen: Łączy program z serwerem zdarzeń.
• JevGetEvent: Pobiera zdarzenie JP1 spełniające warunki filtra.
• JevGetMessage: Pobiera treść komunikatu zdarzenia.
• JevGetFirstExtAttr / JevGetNextExtAttr: Pobierają rozszerzone atrybuty zdarzenia.
• JevFreeEvent: Zwalnia pamięć zajmowaną przez pobrane zdarzenie.
• JevGetClose: Rozłącza program z serwerem zdarzeń.

Atrybuty zdarzeń

Zdarzenia JP1 posiadają atrybuty podstawowe (np. Event ID, Message, Arrived time) oraz atrybuty rozszerzone. Atrybuty rozszerzone dzielą się na wspólne (np. SEVERITY, PRODUCT_NAME, OBJECT_TYPE) oraz specyficzne dla użytkownika. Poprawne zdefiniowanie tych atrybutów jest kluczowe dla monitorowania i filtrowania zdarzeń w systemie JP1/IM.