15.3.16 Setting the event server name in the system using DNS
When you want to use JP1/AJS3 and JP1/Base in a network environment consisting of multiple domains to send and receive JP1 events across the domains, you must consider that there might be hosts that have the same name in different domains. If you use JP1/Base event servers with the default settings on hosts that have the same name, it is not possible to determine from the host name whether a JP1 event registered in the JP1/Base event server was transferred from another host or generated on the local host. As a result, problems could arise, such as a JP1 event reception monitoring job seeming to detect events incorrectly.
To prevent these problems, specify FQDN event server names instead of using the default event server settings in a multiple-domain system.
When JP1/AJS3 and an event server that has an FQDN event server name are operating on the same host, you can execute a log file monitoring job by using JP1/AJS3 on the host as the execution agent. To do so, define the FQDN event server name option (EventServerName environment setting parameter) for the JP1/AJS3 that will be used as the execution agent, and specify the event server name (FQDN format) that will be used by the log file monitoring job.
- Cautionary note:
-
If the log file monitoring job is executed when the event server specified by this option is not running, the following message is output to the integrated trace log, after which connection processing is retried internally: KAVT1068-W The specified event server is inactive. (EventServerName=even-server-name). If the event server is successfully connected during retry, the following message is output to the integrated trace log: KAVT1069-I The specified event server was connected. (EventServerName=event-server-name). Accordingly, the log file monitoring job cannot monitor events during the time from output of KAVT1068-W message to output of the KAVT1069-I message.
The following describes the procedure for setting the FQDN event server name option.
- Organization of this subsection
(1) Definition procedure
-
Stop the JP1/AJS3 service.
Execute the following commands to confirm that all processes have stopped:
# /etc/opt/jp1ajs2/jajs_stop#1 # /opt/jp1ajs2/bin/jajs_spmd_status
- #1:
-
Confirm that automatic termination has been set.
-
Execute the following command to set the environment setting parameter described in (2) below:
jajs_config -k "definition-key" "parameter-name"=value
-
Restart JP1/AJS3.
The new settings are applied.
(2) Environment setting parameter
|
Definition key |
Environment setting parameter |
Explanation |
|---|---|---|
|
[{JP1_DEFAULT|logical-host} \JP1AOMAGENT]# |
"EventServerName"= |
FQDN event server name |
- #:
-
The specification of the {JP1_DEFAULT|logical-host} part depends on whether the host is a physical host or a logical host. For a physical host, specify JP1_DEFAULT. For a logical host, specify the logical host name.
For details about the definition of this environment setting parameters, see 20.6.2(28) EventServerName.