Communication environment definition file (console.conf.update)

Format

[logical-host-name\JP1CONSOLEMANAGER\EVCONS]
"COM_SO_TIMEOUT"=dword:hexadecimal-value
 
[JP1_DEFAULT\JP1CONSOLE_CMD]
"COM_SO_TIMEOUT"=dword:hexadecimal-value
"COM_RETRY_COUNT"=dword:hexadecimal-value
"COM_RETRY_INTERVAL"=dword:hexadecimal-value
"COM_RMI_TIMEOUT"=dword:hexadecimal-value

To Page Top

File

console.conf.update (model file for the communication environment definition file)

To Page Top

Storage directory

In Windows

Console-path\default\

In UNIX

/etc/opt/jp1cons/default/

To Page Top

Description

This file defines communication processing (timeout period) among JP1/IM - Manager, the viewer, and the jcochstat command.

When a low-speed line is used in the network for communication between the viewer and JP1/IM - Manager or when the viewer's workload is high, timeouts might occur during the viewer's communication processing, resulting in communication errors. You can prevent such communication errors by modifying the timeout period.

When the jcochstat command is used from another manager to change the action status of a JP1 event at the local host, a communication error might occur due to a timeout during communication processing. Modifying the timeout period and the connection retry count might resolve the problem, preventing a recurrence of the communication error.

If you are using JP1/IM - View (event console), you must also change the communication environment definition file for JP1/IM - View (event console) (view.conf.update).

The required definition is provided as a model file. To change the settings, copy the model file and then edit the copy.

To Page Top

When the definitions are applied

The definition takes effect after JP1/IM - Manager is restarted by executing the jbssetcnf command.

To Page Top

Information that is specified

[logical-host-name\JP1CONSOLEMANAGER\EVCONS]

Specifies the key name for Event Console Service environment settings.

For logical-host-name, specify JP1_DEFAULT for the physical host and logical-host-name for a logical host.

"COM_SO_TIMEOUT"=dword:hexadecimal-value

Specifies as a hexadecimal value the timeout period in milliseconds. The default value is dword:0000EA60 (60,000 milliseconds).

The range of values that can be specified is from 0x00000001 to 0x0036EE80 (3,600,000 milliseconds).

The specified value must not exceed the value specified for COM_RMI_TIMEOUT (default: 0000EA60) in the console.conf.update communication environment definition file and the view.conf.update communication environment definition file. Additionally, check the setting value (timeout period) on the connection source.

[JP1_DEFAULT\JP1CONSOLE_CMD]

Specifies the key name for the jcochstat command environment settings.

"COM_SO_TIMEOUT"=dword:hexadecimal-value

Specifies as a hexadecimal value the timeout period in milliseconds. The default value is dword:0000EA60 (60,000 milliseconds).

The range of values that can be specified is from 0x00000001 to 0x0036EE80 (3,600,000 milliseconds).

The specified value must not exceed the value specified for COM_RMI_TIMEOUT (default: 0000EA60) in the communication environment definition file (view.conf.update).

"COM_RETRY_COUNT"=dword:hexadecimal-value

Specifies as a hexadecimal value the retry count to be applied in the event of a communication error. The default is dword:00000003 (3 times).

The range of values that can be specified is from 0x00000001 to 0x7fffffff (2,147,483,647 times).

"COM_RETRY_INTERVAL"=dword:hexadecimal-value

Specifies as a hexadecimal value the wait time in milliseconds between retry attempts. The default is dword:00000BB8 (3,000 milliseconds).

The range of values that can be specified is from 0x00000001 to 0x7fffffff (2,147,483,647 milliseconds).

"COM_RMI_TIMEOUT"=dword:hexadecimal-value

Specifies as a hexadecimal value the timeout period in milliseconds for the event action status to change. The permitted value range is from 0000EA60 to 0036EE80 (from 60,000 to 3,600,000 milliseconds). The default is dword:0000EA60 (60,000 milliseconds).

If the KAVB1205-E message is displayed frequently, set a longer timeout period.

To Page Top

Example definition

[JP1_DEFAULT\JP1CONSOLEMANAGER\EVCONS]
"COM_SO_TIMEOUT"=dword:000009C4
 
[JP1_DEFAULT\JP1CONSOLE_CMD]
"COM_SO_TIMEOUT"=dword:0000EA60
"COM_RETRY_COUNT"=dword:00000003
"COM_RETRY_INTERVAL"=dword:00000BB8

Make sure that the end of the file is at the beginning of the last line.

To Page Top