Job Management Partner 1/Integrated Management - Manager Command and Definition File Reference

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 event acquisition filter version 07-01 or earlier is inherited into the event acquisition filter (for compatibility) as shown in the table below. Change the settings and condition group names as appropriate to your operation.

Table 1-10 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.

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.

Format

jcochafmode [-h logical-host-name]

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

Storage directory

In Windows:
Console-path\bin\
In UNIX:
/opt/jp1cons/bin/

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.

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.

Return values

0 Normal termination

1 Abnormal termination

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
 

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.

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.

[Contents][Back][Next]

[Trademarks]