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.