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

jcochfilter

Function

This command switches the event acquisition filter that is enabled in the correlation event generation function and Event Base Service of JP1/IM - Manager to the event acquisition filter indicated by a specified filter ID. This command can also enable the specified common exclusion conditions.

The command can display a list of the event acquisition filter's filter IDs, filter names, common exclusion-conditions group IDs, and common exclusion-conditions group names.

Format

jcochfilter [-i filter-ID]
            [-h logical-host-name]
            [-e [common-exclusion-conditions-group-ID
            [,common-exclusion-conditions-group-ID...]|ALL]]

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

-i filter-ID

Specifies the filter ID of the event acquisition filter to be switched.

-h logical-host-name

When you are operating in a cluster system, this option specifies the logical host name. If this option is omitted, the logical host name specified in the JP1_HOSTNAME environment variable is assumed. If the JP1_HOSTNAME environment variable is not specified, the physical host name is assumed. If you are not using a cluster system, specification of this option is not needed.

-e [common-exclusion-conditions-group-ID[,common-exclusion-conditions-group-ID...]|ALL]

Specifies the IDs of the common exclusion-conditions groups that you want to enable. The common exclusion conditions whose group IDs are not specified will be disabled. Separate multiple IDs with the comma. To enable all common exclusion conditions, specify ALL. Note that if you specify nothing following -e, all common exclusion conditions will be disabled.

Notes

• If -i and -e are both omitted, the command displays the following information in list format:
  
  • Filter IDs and filter names of the event acquisition filters that are currently enabled
  • IDs and names of the common exclusion-conditions groups currently enabled
  • Filter IDs and filter names of the event acquisition filters that have been set
  • IDs and names of the common exclusion-conditions groups that have been set
• If JP1/IM - Manager is not running at the specified host and the event acquisition filter is used for compatibility, the jcochfilter command cannot be executed.

Return values

0	Normal termination
1	Argument error
2	Connection cannot be established with JP1/IM - Manager (JP1/IM - Central Console) (communication error)
3	Operating status of JP1/IM - Manager cannot be verified
4	There was no response from JP1/IM - Manager within a specific amount of time
5	Event acquisition filter is running in the compatibility mode
6	Error from JP1/IM - Manager
7	Filter ID specified in the -i option does not exist
8	User does not have permissions to execute the jcochfilter command (Windows only)
9	The maximum length for an event acquisition filter was exceeded
10	The common exclusion conditions specified in the -e option do not exist
255	Other error

Example 1

List the event acquisition filters on logical host hostA:

jcochfilter -h hostA

Example 2

Change the filter ID of the event acquisition filter on logical host hostA to 3:

jcochfilter -i 3 -h hostA

Example 3

Enable common exclusion-conditions groups (IDs: 0, 2) for the event acquisition filters on logical host hostA:

jcochfilter -e 0,2 -h hostA

[Contents][Back][Next]

All Rights Reserved. Copyright (C) 2009, Hitachi, Ltd.