10.4 Notes on using the event service
-
If you install JP1/Base on a Windows computer, but change the default setting to disable the event service, the performance of programs that use the event service might be affected. If you do not want to start the event service, add the following definition to the API settings file api (sets the event service environment):
server local-host-name close 0.0.0.0 jp1imevtapi
In local-host-name, specify the same name as the host name output by the hostname command. Adding this definition will prevent any impact on program performance. Do not write this definition in the API settings file if you want to start the event service.
-
The event service will only operate in an environment that allows conversion from a local host name to an IP address, or from a local IP address to a local host name. Be sure to set up the hosts file or DNS server to enable these conversions.
-
When you specify an IP address with the ports parameter in the event server settings file (conf) configured by default during the program installation, the JP1 event registration and acquisition programs might not be able to access event services if you assign an IP address that does not correspond to a host name returned by the hostname command. In this case, modify the API settings (api) file.
- Example:
-
Settings in the conf file (the ports parameter line):
ports 192.168.1.2 jp1imevt jp1imevtapi
Settings in the api file:
server * keep-alive
server host-name keep-alive 192.168.1.2
Note: For host-name, specify the value returned by the hostname command.
-
The event service does not support the use of external characters in basic or extended attributes for JP1 events. Any external characters contained in character string attributes might not appear correctly in JP1/IM - View and other programs. Forwarding settings files (forward) and action definition files for log file trapping and event log trapping also do not support external characters. If you specify an external character, JP1/Base might fail to forward or trap any JP1 events.
-
On Linux, the error message KAJP1870-E is output to syslog when both of the following conditions are met:
-
The v5-unused flag in the options parameter in the event server configuration file (conf) is not set.
-
The service name jesrd is not set in the services file.
The port number set for the service name jesrd is only used for acquisition and issuing of events by programs using the JP1/SES protocol. If you do not use such programs for acquiring or issuing events, output of this message does not affect the operation of the event service. If you want to disable output of this message, specify the v5-unused flag, or set an unused arbitrary port number for the service name jesrd in the services file, and then start the event service.
- Example setting in the services file:
-
jesrd 5100/tcp
Note: Specify a unique port number not already in use by another program.
-