Job Management Partner 1/Base User's Guide
This section describes how to configure or modify an event service environment, and how to check the specified settings.
- Organization of this subsection
- (1) Configuring the environment
- (2) Modifying the event service operating environment
- (3) Modifying the settings for forwarding JP1 events
- (4) Checking whether the event service is active
- (5) Checking the settings for forwarding JP1 events
(1) Configuring the environment
To set up the event service environment:
- Configure the event-service operating environment.
Use the following files to configure an event-service operating environment:
For details on each definition file, see Event server index file, Event server settings file, and API settings file in 14. Definition Files.
- Event server index file (index)
Defines directories that are used by the event server.
- Event server settings file (conf)
Defines the operating environment for the event service.
- API settings file (api)
Defines the method for connecting from the application program to the event server and the port to use for the connection.
- Define how JP1 events should be forwarded.
Use the forwarding settings file (forward) to define which JP1 events to be forwarded to which event server. According to the system configuration defined in JP1/IM - Manager, by default, only severe-level JP1 events are sent to a higher-level server. The default setting is recommended if you intend to monitor the system for only errors.
For details on the forwarding settings file, see Forwarding settings file in 14. Definition Files.
- Enable the setting.
Start the event service to apply the settings.
- In Windows:
- The event service is set by default to start automatically when the system is started. For details on the startup control, see 7. Setting the Service Start and Stop Sequences (Windows Only).
- In UNIX:
- Execute the jevstart command.
(2) Modifying the event service operating environment
To modify the event service operating environment:
- Edit the settings files.
Edit the event server index file (index), event server settings file (conf), and API settings file (api).
- Apply the new settings.
Restart the event service to apply the new settings.
- In Windows:
- From the Control Panel, open the Services dialog box. Stop the JP1/Base Event service, and then restart the service.
- In UNIX:
- Execute the jevstop command to stop the event service, and then execute the jevstart command to restart it.
- Notes on overwrite installations
- In Version 9, the save-rep flag has been added to the options parameter in the event server settings file (conf). Setting this flag saves the duplication prevention table of the event database to the file. If this flag is not set, the duplication prevention table is saved to memory. In this case, the table is deleted, and then re-created when the event server is restarted. As a result, it takes time to receive JP1 events forwarded from other hosts. We recommend that you set the save-rep flag in the event server that receives JP1 events forwarded from other hosts.
- If you perform an overwrite installation from JP1/Base 08-00 or earlier, this flag will not be set. In this case, you must perform the following procedure to create the duplication prevention table in the file.
- To create this table in the file:
- Add the save-rep flag to the options parameter in the event server settings file.
For details on the event server settings file, see Event server settings file in 14. Definition Files.
- Execute the jevdbmkrep command.
For details on the jevdbmkrep command, see jevdbmkrep in 13. Commands.
- Start the event server.
(3) Modifying the settings for forwarding JP1 events
To modify the settings for forwarding JP1 events:
- Edit the forwarding settings file (forward).
- Apply the new settings.
Reload the forwarding settings file (forward) or restart the event service to apply the new settings.
- Reload the forwarding settings file (forward).
You can apply the new settings while the system is operating. Execute the following:
jevreload
- Restart the event service.
In Windows: From the Control Panel, open the Services dialog box. Stop the JP1/Base Event service, and then restart it.
In UNIX: Execute the jevstop command to stop the event service, and then execute the jevstart command to restart it.
(a) Collecting and distributing definition information from the manager host
With one operation, you can distribute the information in a forwarding settings file (forward) from a higher-level host defined in the JP1/IM - Manager system configuration to lower-level hosts. The forwarding settings are reloaded on each host as soon as the file is successfully distributed, after which event forwarding starts again, using the updated settings.
For details on this function, see 10. Collecting and Distributing Event Service Definitions (JP1/IM Only).
(b) Note on reloading the forwarding settings file (forward)
Any JP1 events being sent at the exact moment the forwarding settings file (forward) is reloaded are canceled and the transfers are regarded as having failed. For this reason, in the forward-limit parameter of the event server settings file (conf), you must set a retry timeout that will allow any JP1 events that could not be forwarded to be resent after the forwarding settings file is reloaded.
(c) Reloading the forwarding settings file when using JP1/IM - Manager
When the forwarding settings file (forward) contains a to-upper forwarding setting block, the JP1 events will be forwarded according to the JP1/IM - Manager system configuration. If the JP1/IM - Manager system configuration is changed, the forwarding settings file (forward) will be automatically updated when you execute the jbsrt_distrib command to distribute the new JP1/IM - Manager system configuration to each host. There is no need to execute the jevreload command on each host.
For details on the jbsrt_distrib command, see the manual Job Management Partner 1/Integrated Management - Manager Command and Definition file Reference.
- Note
- If your system consists of hosts on which JP1/Base 06-00 or JP1/Base 06-51 or later are installed, the configuration definition information will be distributed when the jbsrt_distrib command is executed. However, the forwarding settings file (forward) will not be reloaded on the hosts running JP1/Base version 06-00.
- You must restart the event service on the hosts running JP1/Base version 06-00.
(4) Checking whether the event service is active
Execute the following command to check whether the event service is active. If the return value is 0, then the event service is running.
jevstatFor details on the jevstat command, see jevstat in 13. Commands.
(5) Checking the settings for forwarding JP1 events
Execute the following command to check the event forwarding settings for the active event services. The execution result will be displayed on screen in the format of the forwarding settings file (forward).
jbsgetopinfo -o forwardFor details on the jbsgetopinfo command, see jbsgetopinfo in 13. Commands.
All Rights Reserved. Copyright (C) 2009, Hitachi, Ltd.