Job Management Partner 1/Base User's Guide

Event server index file

Format

server event-server-name directory-name

File name

index

Storage destination directory

In Windows:

installation-folder\conf\event\

In UNIX:

/etc/opt/jp1base/conf/event/

Description

Accessed by the event server. It defines the directories where the other environment setting files, event databases, and work files are stored. There is usually no need to change the default settings in this file.

You can define multiple event servers if you want to specify a large-capacity or high-speed disk other than the one where you have installed JP1/Base or you want to run more than one event server on the local host.

Application of settings

Start the event service to apply the settings.

Definition details

The following conventions apply to entries in the event server index file (index):

• Each line of the text file is no more than 1,024 bytes and the file size is no more than 2 GB.
• Separate parameter keywords with a space (code 0x20) or a tab (code 0x09).
• Do not insert a space or any other characters in front of the parameter name at the start of a line.
• A hash mark (#) (code 0x23) at the start of a line indicates a comment. You can enter a comment or line space anywhere in a file.
• Letters are case sensitive.

Specify an event server and directory to use. To have multiple event servers on the local host, associate each event server with a corresponding directory.

server event-server-name directory-name

event-server-name

Specify the name of the event server. For event-server-name, specify one of the following names. The default is *:

• *
  In this case, the local host name (value returned by the hostname command) is used. Under normal circumstances, there is no need to change the default asterisk. If you configure the JP1 program to support DNS, you should replace the asterisk with an event server name or an at mark (@).
  
• event-server-name
  Specify this parameter if you configured the JP1 program to support DNS or use JP1 programs in a cluster system. For an example of configuring an event server in a system that uses DNS, see 8.1.3 Setting up an event server in a system that uses DNS services.
  For the event server name, specify the name of the host on which the event server starts as a character string of no more than 255 bytes. Letters are case sensitive. If you want to use a server to distribute and collect event service definitions in an environment that supports the DNS, you should specify an at mark (@) for the event server name.
  
• @
  When an at mark (@) is specified, the event server supports the DNS. Also, the event server can be used to distribute and collect event service definitions in an environment that supports the DNS.
  

directory-name

You can change the directory that the event server uses. If the directory has been changed, place the event server settings file and forwarding settings file in this directory.

• When a full path is specified:
  Place the event database and all the work files in the specified directory.
  
• When a partial path is specified:
  The partial path indicates subdirectories of the directory shown in the following table, so place the event database and all the work files in the specified directories.
  

  Table 14-4 Base directories of the partial paths specified (in Windows)

  File name	Directory
  Event server settings file or forwarding settings file	installation-folder\conf\event\servers\
  Event database	installation-folder\sys\event\servers\
  Temporary work files	installation-folder\sys\tmp\event\servers\

  Table 14-5 Base directories of the partial paths specified (in UNIX)

  File name	Directory
  Event server settings file or forwarding settings file	/etc/opt/jp1base/conf/event/servers/
  Event database	/var/opt/jp1base/sys/event/servers/
  Temporary work files	/var/opt/jp1base/sys/tmp/event/servers/

Notes

• To support the DNS, the DNS must return a FQDN as a local host name. If the DNS fails to return the FQDN as a local host name, the FQDN format event server will not be recognized as an event server of the physical host.
• If you change the server parameter of an active event service, the event service does not stop.

[Contents][Back][Next]

All Rights Reserved. Copyright (C) 2009, Hitachi, Ltd.