jcochafmode (UNIX only)
- Organization of this page
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.
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
Superuser permissions
Storage directory
/opt/jp1cons/bin/
Note: This command is not included in JP1/IM - Manager for Linux.
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.