jcochafmode (UNIX only)

Organization of this page

Function
Format
Execution permission
Storage directory
Arguments
Notes
Return values
Example
Output example 1
Output example 2

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.

Table 1‒29: Inheritance of event acquisition filter settings
Settings before execution of jcochafmode command	After execution of jcochafmode command
None	Inherited as `Existing conditions group` with no settings
Only event IDs are set	Inherited as `Existing conditions group`
Only event levels are set	Inherited as `Existing conditions group`
Only JP1/SES events are set	Inherited as `Existing conditions group_SES`
JP1/SES events and event IDs are set	The JP1/SES event and event ID^# settings are inherited as `Existing conditions group_SES`. The event ID^# settings are inherited as `Existing conditions group`.
Event levels and event IDs are set	Inherited as `Existing conditions group`
JP1/SES events and event levels are set	The JP1/SES event settings are inherited as `Existing conditions group_SES`. The event level settings are inherited as `Existing conditions group`.
JP1/SES events, event levels, and event IDs are set	The JP1/SES event and event ID^# settings are inherited as `Existing conditions group_SES`. The event level and event ID^# settings are inherited as `Existing conditions group`.

#: The event ID settings are inherited to both condition groups.

To Page Top

Format

jcochafmode [-h logical-host-name]

To Page Top

Execution permission

Superuser permissions

To Page Top

Storage directory

/opt/jp1cons/bin/

Note: This command is not included in 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

`0`	Normal termination
`1`	Abnormal termination

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