Job Management Partner 1/Base User's Guide

Event server settings file

Format

# Comment ports address receiver-port AP-port client-bind address users { * | user-name } ... eventids {* | basic-code | basic-code:extended-code-card}... alt-userid alternate-user-ID alternate-group-ID forward-limit retry-time after-error forwarding-suspension-period retry-interval transfer-retry-interval buffnum SES-event-count include ses-conf file-name include ajs-conf expire event-expiration-time db-size event-database-capacity remote-server event-server-name communication-type [address [port]] forward-timeout amount-of-time-to-wait options [no-sync | sync] [remote-receive] [conv-off] [v5-unused] [KAJP1037-hntroff] [KAJP1037-syslogoff] [save-rep] error-size file-size trace-size file-size evtlog-size file-size fwderr-size file-size log-keep log-file-count log-level level repetition-noncheck-server { * | event-server-name } ... restart number-of-restart retry-interval reset time

File name

conf

Storage destination directory

In Windows:

folder-specified-in-event-server-index-file\
shared-folder\jp1base\event\conf\ (in a cluster system)

For the default event server index file (index), the file name is: installation-folder\conf\event\servers\default\

In UNIX:

directory-specified-in-event-server-index-file/
shared-directory/event/conf (in a cluster system)

For the default event server index file (index), the file name is: /etc/opt/jp1base/conf/event/servers/default/

Description

Defines the operating environment for the event service. In this file, you mainly define the following information:

• The IP address and port number for sending and receiving JP1 events
• Which JP1 events are retrievable and the JP1 users permitted to acquire those events
• Whether to retry upon a failed attempt to forward an event
• The sending and receiving of JP1 events to and from a host running JP1/SES and JP1/AJS
• The expiration time for JP1 events stored in the event database and the maximum size of the event database
• The connection method for forwarding JP1 events to an event server at a remote host, and the procedure for handling transfer errors

Application of settings

Start or restart an event service to apply the settings.

Definition details

The following conventions apply to entries in the event server settings file (conf).

• 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.

ports address receiver-port AP-port

Specify the IP address and port number to be used by the event server when connecting to a remote program. The values specified here do not apply to receiving events from hosts running either of the pre-version 6 programs, JP1/SES or JP1/AJS.

address

Specify the IP address in one of the following forms.

If you omit the ports parameter, the event server name is used.

• 0.0.0.0
  No set address. The system determines the IP address.
  For a system that only runs on physical hosts, specify the IP address.
  
• IP-address
  Specify numbers separated by periods (example: 172.16.50.50). You can specify multiple IP addresses. Multiple IP addresses are useful when you use event services in an environment with multiple networks. For details on using JP1/Base in an environment with multiple networks, see 4.3 Using JP1/Base in an environment of distinct networks. When you specify multiple IP addresses, separate them with a colon (example: 172.16.50.50:172.16.50.51:172.16.50.52). You can assign no more than four IP addresses.
  Note
  If you specified an IP address other than the IP address returned to the primary server by the OS name resolution, you need to specify the IP address in the server parameter in the API settings file.
  
• host-name
  Specify a name that is no more than 255 bytes and can be converted into an IP address by the system's hosts file or name server.
  

receiver-port

Specify the port number for receiving JP1 events forwarded from a remote server. Use either of the following:

• port-number
  Specify the port number using numbers.
  
• Service name
  Specify the tcp service name defined in the system's services file. As a general rule, specify jp1imevt for the service name. This value is used when the ports parameter is omitted.
  

AP-port

Specify the port number for receiving requests from an application to issue or acquire JP1 events. Use either of the following:

• port-number
  Specify the port number using numbers.
  
• Service name
  Specify the tcp service name defined in the system's services file. As a general rule, specify jp1imevtapi for the service name. This value is used when the ports parameter is omitted.
  

client-bind address

Specify the IP address the event server uses to send JP1 events to other programs. This parameter is useful when you use event services in an environment with multiple networks. Under normal circumstances, there is no need to specify client-bind. When you omit it, JP1 events are sent from the IP address specified in the ports parameter. For details on using JP1/Base in an environment with multiple networks, see 4.3 Using JP1/Base in an environment of distinct networks. Note that this parameter setting is not applicable when transferring events to hosts running either of the pre-version 6 programs, JP1/SES or JP1/AJS.

address

Specify the IP address using either of the following methods:

• 0.0.0.0
  No specific IP address is set, and the system automatically assigns one. Specify this value as a general rule when you enable multi-LAN connectivity.
  
• IP-address
  Specify numbers separated by periods. This address is used to send events.
  

users {* | user-name}...

Specify the users permitted to acquire JP1 events.

You can specify this parameter more than once. The permitted users are equivalent to the sum of all the specifications. When the users parameter is omitted, no users can acquire JP1 events.

*

All users can acquire JP1 events.

user-name

Specify a user name. The specified user can acquire JP1 events.

eventids {* | basic-code | basic-code:extended-code}...

Specify which event IDs can be acquired by programs. If a JP1 event is issued whose ID is not specified, an error will not occur, but the event cannot be acquired.

You can specify this parameter more than once. The retrievable event IDs are equivalent to the sum of all the specifications. When the eventids parameter is omitted, no JP1 events can be acquired.

*

All JP1 events can be acquired.

basic-code

Specify the basic code for each event ID, using no more than 8 hexadecimal digits. The extended code is always 0.

basic-code:extended-code

Specify the basic and extended code for each event ID, using no more than 8 hexadecimal digits each, using a colon to separate the two codes.

alt-userid alternate-user-ID alternate-group-ID

Specify a value to be set in the event data, replacing the numerical user ID or group ID which are not recognized in the Windows and Java execution environment.

In alternate-user-ID and alternate-group-ID, specify a number from -1 to 65,535. If a value is not specified, -1 is used for both values.

forward-limit retry-time

Specify the retry timeout period for forwarding JP1 events that have failed to be sent. The system resends the JP1 events specified in the forwarding settings file (forward) at regular intervals, specified by the retry-interval parameter, until the transfer succeeds or the specified time elapses. Specify a number from 0 to 86400 (seconds). When no time limit has been specified, the default is 0 (i.e. no retries). When you specify the forward-limit parameter, specify a value greater than the retry interval specified for the retry-interval parameter.

after-error forwarding-suspension-period

Specify the length of time that JP1 event transfer will be suspended after it fails to be forwarded to a remote server. During the specified time, the remote server is assumed to be in an error state and, as a result, no JP1 events will be forwarded to that server. Specify a number from 0 to 2147483647 (seconds). The value must be less than the retry-interval parameter. The default is 30.

retry-interval transfer-retry-interval

Specify the interval at which the system will attempt to resend JP1 events that failed. Specify a number from 60 to 2147483647 (seconds). The value must be greater than the after-error parameter. The default is 600.

Correlation between the parameters related to retrying

The parameters related to retrying JP1 event transfers are forward-limit, after-error, and retry-interval. By default, if a JP1 event fails to forward, JP1/Base will retry at 600-second intervals for a maximum of 3,600 seconds.

In a cluster system, if a failover occurs on the sending or receiving host while a JP1 event is being transferred, the transfer will fail. In the JP1/Base settings, always enable retries to ensure that JP1 events will be forwarded successfully.

The following figure shows the correlation between the parameters related to retrying JP1 event transfers:

Figure 14-2 Correlation between the parameters related to retrying JP1 event transfers

If another JP1 event is transferred within the retry interval not within the after-error suspension period, at the same time, JP1/Base will also reattempt to transfer the event that failed to transfer before.

If the event service is restarted or reloaded while JP1/Base is reattempting to transfer a JP1 event, the JP1 event will be resent after the event service is restarted, provided the forward-limit time has not elapsed.

buffnum SES-event-count

This parameter links the JP1/SES event with the product to use. For details on this parameter, see J. Linking with Products That Use JP1/SES Events.

include ses-conf file-name

This parameter links the JP1/SES event with the product to use. For details on this parameter, see J. Linking with Products That Use JP1/SES Events.

include ajs-conf

This parameter links the JP1/SES event with the product to use. For details on this parameter, see J. Linking with Products That Use JP1/SES Events.

expire event-expiration-time

Specify the length of time for storing issued JP1 events in the event database. JP1 events are stored in the event database for the specified time and while they are in the database, they can be viewed from JP1/IM - View. If the JP1 events stored in the database reach the capacity specified in the db-size parameter, events might be deleted even though the expiration time has not yet been reached. Specify a number from 0 to 2147483647 (seconds). If an expiration time is not specified, the default is 31536000 (365 days).

db-size event-database-capacity

Specify the event database capacity. When the specified size is reached, JP1 events might be deleted, starting from the oldest ones, even though the expiration time specified in the expire parameter has not been reached. The JP1/Base event service occupies up to twice the amount of disk space specified in this parameter. Specify a number from 0 to 2147483647 (bytes). The default is 2147483647.

The following is the formula for calculating the capacity required for the event database in respect to the number of days for which events are stored. Use this formula as a guide for specifying the capacity:

[a x (b + 64) + (c x 64)}x d]/2 (bytes)

a: Number of events registered per day^#

b: Average size per event. (You must actually measure this size.)

c: Number of events transferred per day

d: Number of days for storage

#: The events registered daily include those generated on the local host, JP1/SES events, JP1 events received from other hosts, and transferred events.

remote-server event-server-name communication-type [address [port]]

Specify the method for connecting to a remote server for event transfers. You can specify multiple remote-server parameters if the value in event-server-name is different in each case.

event-server-name

Specify the event server name in either of the following ways:

• event-server-name
  Specify a specific event server name that is no more than 255 bytes.
  
• *
  Specify an asterisk to indicate all of the event servers, other than those that have been individually specified.
  When this specification is omitted, events can be forwarded only to event servers that are explicitly specified.
  

communication-type

Specify the method for connecting to the specified remote server:

• keep-alive
  When you need to forward a JP1 event to a remote server, establish a TCP/IP connection from the sending server, and forward the event. After the event transfer, keep the connection open so it can be reused until the remote event server shuts down.
  Note
  When a connection is severed, and then recovered, the first attempt to transfer a JP1 event after the connection is recovered might fail. A connection might be severed, either because the firewall is set up to do so when there is no communication between the servers, or because a temporary communication error occurred.
  
• close
  When you need to forward a JP1 event to a remote server, establish a TCP/IP connection from the sending server, and forward the event. End the connection three seconds after the event transfer.
  
• ses
  This parameter links the JP1/SES event with the product to use. For details on this parameter, see J. Linking with Products That Use JP1/SES Events.
  

address

Specify the IP address using either of the following methods:

• IP-address
  Specify numbers separated by periods (example: 172.16.50.50).
  
• host-name
  Specify a name that is no more than 255 bytes and that can be converted into an IP address by the system's hosts file or name server.
  

The specified address must match the value set in the ports parameter for the event server specified in the event server settings file (conf).

The default host name is the event server name.

port

Specify the port number using one of the following methods:

• port-number
  Use numbers to specify the port number.
  
• Service name
  Specify the tcp service name defined in the system's services file.
  

The specified address must match the value set in the ports parameter for the event server specified in the event server settings file (conf).

The default is the same value as the transfer port of the local event server.

forward-timeout amount-of-time-to-wait

Specify the length of time to wait for a response from the destination server when forwarding a JP1 event. If no response is received within the specified time, the system assumes that the transfer failed.

Specify a number from 10 to 600 (seconds). The default is 90.

options [no-sync | sync] [remote-receive] [conv-off] [v5-unused] [KAJP1037-hntroff] [KAJP1037-syslogoff] [save-rep]

Specify option flags. You can specify the parameter and a flag on different lines.

no-sync | sync

After the no-sync flag is specified, the system is allowed to buffer JP1 events written to the database. Specifying this flag might improve performance when JP1 events are generated. However, issued JP1 events might be lost if the system shuts down unexpectedly due to a failure. The purpose of using JP1/Base in a cluster system is to enhance reliability, so do not specify this option.

Specifying sync flag ensures that each JP1 event will be written to disk when the event is issued. You can thus acquire all of the events after restarting the system. Writing each JP1 event to disk at the time it is issued might, however, cause a performance decrease when issuing JP1 events.

If you specify neither the no-sync flag nor the sync flag, events are written to the disks at regular intervals (every 10 seconds), so only some of the issued JP1 events might be lost.

remote-receive

Allows JP1 events to be acquired by a program running on a remote host over a network.

You must specify this flag to search for JP1 events on a remote host using the JP1/IM - View GUI connected to that host, and to view information in the pre-Version 6 program JP1/AOM-EE.

conv-off

This flag links the JP1/SES event with the product to use. For details on this flag, see J. Linking with Products That Use JP1/SES Events.

v5-unused

Suppresses the use of all of the functions related to the compatibility with the pre-Version 6 programs, JP1/SES and JP1/AJS. When you specify this flag, the processes used for the compatibility with JP1/SES and JP1/AJS will not start. Therefore, sending or receiving events to or from JP1/OJE and other products by using the JP1/SES protocol is not possible.

Do not remove this flag unless it is linked with the programs that are compatible to pre-version 6. For details on the linkage with pre-Version 6 products, see J. Linking with Products That Use JP1/SES Events.

KAJP1037-hntroff

Suppresses output of the KAJP1037-E (event transfer failure) message to the integrated trace log.

KAJP1037-syslogoff

Suppresses the KAJP1037-E (event transfer failure) message being output to the syslog (in UNIX) or the event log (in Windows).

save-rep

Keeps the event database duplication prevention table in a file. The duplication prevention table prevents JP1 events from being registered twice.

If you specify the save-rep flag, make sure that the directory that stores the event database has a minimum capacity of 32 + total number of the source event servers x 288 bytes. For details on the duplication prevention table, see 1.4.2 Event database.

Note

The KAJP1017-E message informing a transfer error will be output to the integrated trace log and syslog (in UNIX) or the event log (in Windows), even if you have specified KAJP1037-hntroff or KAJP1037-syslogoff. Monitor for transfer errors by checking the KAJP1017-E message.

The KAJP1037-E message can also be checked by the event service transfer error log (fwderr.*).

error-size file-size

Specify the maximum size that will be used for the event service error log files (error.*). When a file exceeds the specified size, it is overwritten starting from the beginning. Specify a number from 65536 to 2147483647 (bytes). The default is 500000.

The following shows the formula for calculating the required capacity of an event service error log file in relation to the number of days for which events are stored. Use this formula as a guide for specifying the file size.

a + (b x c) x d (bytes)

a: Basic part (1 KB)

b: Average error message size (approx. 120 bytes)

c: Number of errors per day

d: Number of days for storage

trace-size file-size

Specify the maximum size of an event transfer trace log file (trace.*). When a file exceeds the specified size, it is overwritten from the beginning. Specify a number from 65536 to 2147483647 (bytes). The default is 1000000.

The following shows the formula for calculating the required capacity of an event transfer trace log file in relation to the number of days for which you want to store events. When specifying the file size, consider the amount of log data output per day and the number of events acquired per day.

a + (b + c + d) x e (bytes)

a: Basic part (1 KB)

b: Amount of output log data necessary to register one event x Number of events registered per day

c: Amount of output log data necessary to acquire one event x Number of events acquired per day

d: Amount of output log data necessary to transfer one event x Number of events transferred per day

e: Number of days for storage

The amount of output log data differs according to the operation of the event service; however, the following can be used as a reference value for the amount of output log data.

Table 14-6 Amount of log output (event transfer trace log)

Amount of log output (in bytes)
Registering an event	Acquiring an event#1	Transferring an event#2 (retries if the transfer fails)
Approx. 150#3	Approx. 150#3	Approx. 1,500

#1: Event acquisition includes JP1 events acquired by other applications. The value above comes from the amount of data output to a log when the 10th JP1 event is acquired from an event database containing ten events. The output amount varies depending on the number of JP1 events registered in an event database and where a JP1 event is registered.

#2: When transferring a JP1 event, the amount of data output to a log is the maximum if the transfer fails and is performed again.

#3: The amount of data output to a log when the communication type is set to close in the API settings file (api).

The number of events acquired per day represents how often events are acquired via the event acquisition function from the user application or JP1 series programs. You can use the following formula as a guideline for the number of events JP1 series products acquire per day.

  
Number-of-events-acquired#1 x number-of-events-registered-in-event-database + number-of-events-registered-per-day#2
  

#1: The number of JP1/IM events acquired from the event database is equivalent to the sum of the following numbers:

• Number of times JP1/IM - View is started
• Number of times JP1/IM - View searches for events

#2: If event reception jobs for JP1/AJS are registered for execution, JP1/AJS acquires events that are newly registered with the event database. JP1/AJS acquires a registered event only once even if multiple event reception jobs are registered.

evtlog-size file-size

Specify the maximum size (in bytes) of an event service trace log file (imevterr.*). When a file exceeds the specified size, it is overwritten from the beginning. Specify a number from 65536 to 2147483647 (bytes). The default is 1000000.

The following is the formula for calculating the capacity required for an event service trace log in respect to the number of days for which events are stored. When specifying the file size, consider the amount of log output per day and the number of events acquired per day.

a + (b + c + d) x e (bytes)

a: Basic part (1 KB)

b: Amount of log output necessary to register one event x Number of events registered per day

c: Amount of log output necessary to acquire one event x Number of events acquired per day

d: Amount of log output necessary to transfer one event x Number of events transferred per day

e: Number of days for storage

The amount of output log data differs according to the operation of the event service; however, the following can be used as a reference value for the amount of output log data. An event service trace log file is not affected by the log level defined in the log-level parameter.

Table 14-7 Amount of log output (event service trace log)

Amount of log output (in bytes)
Registering an event	Acquiring an event#1	Transferring an event#2 (retries the transfer if it fails)
Approx. 3,000	Approx. 7,000	Approx. 3,000

#1: Event acquisition includes JP1 events acquired by other applications. The value above comes from the amount of data output to a log when the 10th JP1 event is acquired from an event database containing ten events. The output amount varies depending on the number of JP1 events registered in an event database and where a JP1 event is registered.

#2: When transferring a JP1 event, the amount of data output to a log is the maximum if the transfer fails and is performed again.

The number of events acquired per day represents how often events are acquired via the event acquisition function from the user application or JP1 series programs. You can use the following formula as a guideline for the number of events JP1 series products acquire per day.

  
Number-of-events-acquired#1 x number-of-events-registered-in-event-database + number-of-events-registered-per-day#2
  

#1: The number of JP1/IM events acquired from the event database is equivalent to the sum of the following numbers:

• Number of times JP1/IM - View is started
• Number of times JP1/IM - View searches for events

#2: If event reception jobs for JP1/AJS are registered for execution, JP1/AJS acquires events that are newly registered with the event database. JP1/AJS acquires a registered event only once even if multiple event reception jobs are registered.

fwderr-size file-size

Specify the maximum size of an event service transfer error log file (fwderr.*). When a file exceeds the specified size, it is overwritten starting from the beginning. Specify a number from 65536 to 2147483647 (bytes). The default is 1000000.

The following shows the formula for calculating the required capacity of an event transfer error log file in relation to the number of transfer failures for which you want to store events.

 
Number-of event-transfer-failure-to-store x ( 150 + length-of-event-server-name + length-of-destination-event server-name)
 

If there are multiple destination servers, the length of the destination event server name is equal to the length of the longest server name among the destination event server names.

log-keep number-of- log-files.

Specify the maximum number of event service error log files, event transfer trace log files, and event service trace log files that can be created. A log file is created when the event service starts. If the number of log files at event service startup exceeds the specified count, files are deleted, starting from the oldest. Specify a number from 0 to 50. The default is 5. When 0 is specified, logs are not kept.

log-level level

For JP1/Base versions 06-51 and earlier, specify a level for output to syslog, the event log, event service error log files, and event transfer trace log files. Specify a number from 1 to 10. The default is 1. Specify 1 as a general rule. Specify 2 or a higher level to output more detailed messages in the event of an error or attempting to recover from an error.

For JP1/Base version 06-71 and later, you do not need to specify this value because detailed log data is output regardless of the value.

repetition-noncheck-server { * | event-server-name } ...

Specify the name of the event server that suppresses the duplication registration check. The duplication registration check checks whether a JP1 event has already been registered when receiving a JP1 event. A JP1 event is a duplicate of another if its source event server name, source event database serial number, and the time of registration are the same as the other one.

You can use the duplication check to prevent an event from being lost when forwarding a JP1/SES protocol event through several routes.

You can specify this parameter multiple times. The event servers that suppress duplication registration are equivalent to the sum of all the specifications. When this parameter is omitted, the duplication registration check is performed on the JP1 events from all source event servers.

*

In this case, the duplication registration checks from all source event servers are suppressed.

event-server-name

Specify the name of each event server that suppresses the duplication registration check. Event server names are case sensitive.

restart number-of-restart retry-interval reset time

Set the JP1/Base to restart if an error occurs in the event service process on the physical host. To restart JP1/Base, specify the number of restarts, the interval at which the system will attempt to restart, and the restart count reset time. The process will restart only if the number of abnormal terminations during the period specified by the reset time is less than the number of restart times. The recovery message (KAJP1072-I) is output when the process restarts. The message is also sent out as a JP1 event (event ID: 00003D04). Therefore, if you see this JP1 event, then you know that the event service process was restarted. This parameter is valid only in the UNIX version of JP1/Base, not in the Windows version. If you omit this parameter, the process will not restart even after the event service process has been abnormally terminated. Instead, the event service will stop.

Also, when an event service is restarting, the JP1 event transferred from the sending host will not be received. JP1/Base will try to re-send the JP1 event, assuming that JP1/Base is set to do so on the sending host. However, if the retry interval is exceeded, the transfer will fail. To prevent such failures, make sure that the value you set for number of restarts x retry interval is less than the retry limit for forwarding JP1 events (forward-limit parameter) in the conf parameter on the sending host.

Number of restarts

Specify how many times the system will attempt to restart. The recommended value is 4. Specify a number from 0 to 99. If 0 is specified, the process does not restart. If you specify a number less than 0, the system uses 0. If you specify a number greater than 99, the system uses 99.

Retry interval

Specify how long an event service process will wait to restart after it ends abnormally. If a restart fails, the process will wait until the specified interval elapsed before another attempt is made to restart the service. The recommended value is 15 (seconds). Specify a number from 0 to 3600. If you specify a number less than 0, the system uses 0. If you specify a number greater than 3600, the system uses 3600.

Reset time

Specify the number of seconds that will elapse after the process is restarted, before the number of restarts is reset. The number of restarts is reset the specified time after the process is restarted. The recommended reset time is 3600 (seconds). Specify a number from 3600 to 2147483647 (seconds). If you specify a number less than 3600, the system uses 3600. If you specify a number greater than 2147483647, the system uses 2147483647.

The following figure illustrates the process action using the recommended values (the number of retries is 4, the retry interval is 15, and the reset time is 3600).

Figure 14-3 Example of action when an event service process ends abnormally

In this example, the number of restarts is reset 3,600 seconds after the process is restarted if the process does not end abnormally within 3,600 seconds. Then, the next time the process ends abnormally, the restart count starts from 1. If the process ends abnormally again within 3,600 seconds after the reset, the restart count is not reset. If the number of restarts reaches the specified value, the system no longer attempts to restart the process.

Notes

• Only the child processes of the jevservice process, whose process ID can be confirmed in the jevstat command, can be restarted by specifying the restart parameter.
• If the parent process ends abnormally, the event service stops.
• A separate retry count is used for each child process.

The jevservice process has the following 6 types of child processes.

Table 14-8 Event service process composition

Parent process name	Child process name	Overview
jevservice	jevservice (LogTrc)	Outputs the messages recorded in syslog or the integrated trace log.
	jevservice (DBMngr)	Manages the event database.
	jevservice (SESEmu)	This is the SES compatibility function. When the v5-unused flag is specified in the options parameter, this function is not used.
	jevservice (EvtAPI)	Accepts registration or acquisition requests of JP1 events.
	jevservice (FwdRcv)	Receives the forwarded JP1 events.
	jevservice (FwdMgr)	Forwards JP1 events.

Definition examples

The following shows examples of settings in the event server settings file (conf):

 
# For port number, use jp1imevt and jp1imevtapi defined 
# in the system services file.
ports 0.0.0.0 jp1imevt jp1imevtapi
# Programs executed only in user root and adm can acquire 
# JP1 events.
users root adm 
# Only the JP1 events that have an ID of 2000, 2001, 3000, 
# or 3001 can be issued and acquired by API of JP1/SES.
# Programs compatible to JP1/Base can issue and acquire all 
# JP1 events.
eventids *
eventids 2000 2001 3000 3001
# If you are using Windows on your local computer, or 
# if you are using UNIX on your
# local computer but JP1 events are issued by Java,
# when you forward JP1 events in UNIX environment, user ID 
# or Group ID will be interpreted as 1001 and 100.
alt-userid 1001 100
# If forwarding of a JP1 event fails, JP1/Base will retry 
# forwarding. 
# Retry will continue until either the JP1 event is sent 
# successfully or one hour 
#(3600 seconds) elapses.
forward-limit 3600
# If forwarding events to a remote host fails, to prevent 
# network load from increasing, no events will be sent to 
# this host within the next 300 seconds.
after-error 300 
# To add settings to the above userids and evendids, 
# see JP1/SES environment settings 
# file /usr/bin/jp1_ses/jpevent.conf.
include ses-conf /usr/bin/jp1_ses/jpevent.conf 
# JP1 events received 31 days (2,678,400 seconds) ago 
# will be deleted.
# Also, if data amount of the stored JP1 events reaches 
# 1,000,000 bytes, JP1 events will be deleted from 
# the oldest ones.
expire 2678400
db-size 1000000
# JP1 events can be acquired from a remote host.
# (Make sure to specify the host if you want to refer to the 
# JP1/AOM - EE information from JP1/M-Console View that is 
# connected to another computer.)
options remote-receive 
# Allows the OS to buffer JP1 events written to the disk.
options no-sync 
# Host 1 and host 2 are within the local LAN, so you can 
# leaving them connecting to TCP/IP.
# Other computers (except host 3) are connected by phone 
# line dial ups, so the connections will be frequently interrupted.
# Host 3 uses JP1/SES, not JP1/Base.
remote-server host1 keep-alive 
remote-server host2 keep-alive 
remote-server host3 ses 
remote-server *    close 
# Set the maximum size of the error log file to 500,000 bytes,
# and the trace log file to 1,000,000 bytes.
# If the capacity exceeds the specified size, data will be 
# overwritten starting from the top the file.
# If there are five or more log files, files will be deleted 
# from the older ones.
error-size 500000 
trace-size 1000000 
log-keep 5  

[Contents][Back][Next]

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