Hitachi

JP1 Version 12 JP1/Integrated Management 2 - Manager Command and Definition File Reference


jcochstat

Organization of this page

Function

This command changes information about the response status for severe events.

The command accesses the event database on the host specified in -h and changes the response status of the JP1 events whose serial numbers are specified in -n.

When a response status is changed, the change is also applied to the response status displayed by other JP1/IM - Views that are logged in to the same manager. If a JP1 event whose response status is to be changed has been forwarded from another host or is set to be forwarded to another host, the response status is not changed at the source or target host.

This command can also be used to change the response status of JP1 events that are not displayed on the Severe Events page in the Event Console window. In such a case, you must use one of the following methods to check the change:

You can use this command while JP1/IM - Manager is running.

Format

jcochstat [-h manager-host-name]
          {-k severe-event-response-status-key | -d |
           -k severe-event-response-status-key -d}
           -n serial-number-1[,...,serial-number-100]

Execution permission

In Windows: Administrator permissions (If the Windows UAC feature is enabled, the command must be executed from the administrator console.)

In UNIX: None

Storage directory

In Windows:

Console-path\bin\

In UNIX:

/opt/jp1cons/bin/

Arguments

-h manager-host-name

Specifies the manager that has the event database in which the severe events are registered. You can specify host names, domain names, and IPv4 addresses. If this option is omitted, the command assumes the logical host. If this option is omitted during cluster system operation, the command assumes the name of the physical host where the command is executed. If JP1/IM - Manager is not running at the specified manager, an error results.

Specify the manager host name as a string of from 1 to 255 characters.

Note that the ability to specify the manager of another host in manager-host-name is supported for compatibility with version 6.

-k severe-event-response-status-key

Specifies the key value that represents the new severe event response status. The severe event response status of the severe events specified in the -n option is changed to the response status indicated by this key. If you use JP1/IM - View to display the status, the response status symbol changes.

A severe event response status key is case sensitive.

You must specify one or both of the -k and -d options. When both options are specified, the command changes the response status and then deletes the events from the JP1/IM - View window. The -k and -d options cannot both be omitted.

Table 1‒30: Severe event response status keys

Key value

Response status

Response status symbol displayed in JP1/IM - View

PROCESSED

Processed

[Figure]

PROCESSING

Being processed

[Figure]

HELD

On hold

[Figure]

UNPROCESSED

Unprocessed

(No symbol)

-d

Deletes the severe events specified in the -n option on the Severe Events page of the Event Console window. These events are not deleted from the event database.

A deleted event can no longer be displayed on the Severe Events page.

You must specify either the -k or -d option, or both.

If you specify both options, change the response status first, and then delete the event on the Severe Events page of the Event Console window. You cannot omit both the -k and -d options.

-n serial-number

Specifies the serial number of a severe event whose response status is to be changed. This option is mandatory. The permitted value is a decimal integer in the range from 0 to 2,147,483,647.

You can specify a maximum of 100 serial numbers. Separate multiple serial numbers with the comma. Do not specify any spaces before or after a delimiter comma.

Return values

0

Normal termination

1

Argument error

2

Network failure

3

Updating of the event database failed

4

Specified key is not supported

5

A specified event cannot be updated

7

No permission to execute the command (Windows)

255

Other error

Example

Change to processed status the response status of the events that are registered in the event database on the host01 manager and whose serial numbers are 35 and 400, and then delete those events from the window:

jcochstat -h host01 -k PROCESSED -n 35,400 -d