jcochafmode

Function

This command changes the location of the event acquisition filter from Event Console Service to Event Base Service.

If you execute this command while you are using an event acquisition filter (for compatibility), the filter becomes applicable to the automated action functions and to Central Scope, as well as to JP1 event monitoring. You can then define detailed filter conditions. However, if you want to use the event acquisition filter (for compatibility) as is, there is no need to change the filter location.

Information specified in the event acquisition filter version 07-00 or earlier, or the event acquisition filter (for compatibility) is inherited as shown in the table below. Change the settings and condition group names as appropriate to your operation.

To Page Top

Format

jcochafmode [-h logical-host-name]

To Page Top

Execution permission

In Windows: Administrator permissions (if the Windows UAC feature is enabled, the command is executed from the administrator console)

In UNIX: Superuser permissions

To Page Top

Storage directory

In Windows:

Console-path\bin\

In UNIX:

/opt/jp1cons/bin/

Note: This command is not included in JP1/IM - Manager for Windows Server 2012, Windows Server 2008, HP-UX (IPF), and JP1/IM - Manager for Linux.

To Page Top

Arguments

-h logical-host-name

Specifies the logical host name for the event acquisition filter (for compatibility). If this option is omitted, the command assumes the physical host. If you do not use a cluster system, specification of this option is not needed.

To Page Top

Notes

• If you wish to execute this command to change the location and definitions of an event acquisition filter, you must first terminate JP1/IM - Manager at the target host whose event acquisition filter is to be changed. If this command is executed while the JP1/IM - Manager is running, an error results.

• If you execute this command more than once, the converted event acquisition filter is overwritten and the customized condition definitions are discarded. Execute this filter only once when you convert an event acquisition filter.

• Once you convert an event acquisition filter, you can no longer restore the previous event acquisition filter or event acquisition filter (for compatibility) to the filter location and definitions existing before upgrading.

• An event acquisition filter version 08-01 or later cannot be converted to an event acquisition filter (for compatibility).

• If you have newly installed JP1/IM - Manager, there is no need to execute this command.

• If you change the location of an event acquisition filter to Event Base Service by executing this command, that filter becomes applicable to the correlation event generation function thereafter.

To Page Top

Return values

To Page Top

Example

Convert the event acquisition filter (for compatibility) at the logical host01 to the event acquisition filter that is run on Event Base Service:

jcochafmode -h host01

To Page Top

Output example 1

JP1/IM - Manager at the target host whose event acquisition filter is to be changed is not running:

KAVB1005-I The command (jcochafmode) has started.
KAVB0836-I The event acquisition filter was switched from interchangeability to the ordinary mode.
KAVB1002-I The command (jcochafmode) terminates normally.

To Page Top

Output example 2

JP1/IM - Manager at the target host whose event acquisition filter is to be changed is running:

KAVB1005-I The command (jcochafmode) has started.
KAVB0831-E JP1/IM - Manager has started.
KAVB1003-I The command (jcochafmode) terminates abnormally.

To Page Top