Hitachi Job Management Partner 1/Base Function Reference

Overview of JP1/Base Functionality

Hitachi Job Management Partner 1/Base (JP1/Base) provides a robust framework for system management, specifically focusing on the issuance and acquisition of JP1 events. This manual serves as a comprehensive reference for developers looking to extend the functionality of JP1/Base by integrating their own applications. By utilizing the provided C/C++ APIs, developers can create custom applications that interact directly with the JP1 event database, enabling advanced monitoring and automated system responses.

Issuing and Acquiring JP1 Events

The core functionality described in this manual revolves around two primary operations: issuing user-defined events and acquiring existing events from the database. Issuing events allows applications to report status changes, errors, or custom information to the JP1/IM management console. Conversely, the event acquisition function allows applications to monitor the system by retrieving specific events based on defined filters. This bidirectional communication is essential for creating a cohesive management environment where disparate applications can share status information.

Development and Integration

To integrate with JP1/Base, developers must follow specific procedures for compiling and linking their source code. The manual details the necessary header files, such as JevApi.h, and the required libraries for various operating systems, including Windows, HP-UX, Solaris, AIX, and Linux. It is crucial to ensure that the development environment matches the target execution environment to maintain binary compatibility. The manual also provides sample source files, sender.c and receiver.c, which serve as practical templates for implementing event issuance and acquisition logic.

Event Attributes and Filtering

Effective event management relies on the proper definition of event attributes. JP1 events consist of basic attributes, such as Event ID and Message, and extended attributes that provide context-specific information. Developers can define custom extended attributes to suit their application's needs. When acquiring events, defining precise filters is critical to ensure that applications only process relevant data. The manual outlines the criteria for setting these attributes and provides guidance on filter syntax to optimize event retrieval performance.

Best Practices and Troubleshooting

When implementing JP1/Base functions, developers should adhere to best practices, such as properly closing event acquisition handles using JevGetClose to prevent system resource leaks. The manual also includes detailed information on return codes and error handling, which are essential for debugging applications that interact with the JP1 event service. By following the guidelines provided, developers can ensure stable and reliable integration with the JP1/Base environment.