Hitachi

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


jcoegsstart

Organization of this page

Function

This command changes the status of the correlation event generation function from standby to running. When the correlation event generation function is placed in running status, it starts processing in accordance with the correlation event generation definitions.

You can use the jcoegsstart command only after you have used the jcoegsstop command to place the correlation event generation function on standby status. The jcoegsstart command cannot start the correlation event generation function when it is stopped (service start and stop are controlled by process management (jco_spmd)).

When the status is changed successfully by the jcoegsstart command, a JP1 event (00003F25) is issued. For details about the 00003F25 JP1 event, see 3.2.2 Details of JP1 events.

If the correlation event generation function is already in running status when the jcoegsstart command is executed, the status remains unchanged.

Format

jcoegsstart [-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

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.

Return values

0

Correlation event generation function restarted successfully

1

Restart of the correlation event generation function failed

2

A timeout occurred during communication with the correlation event generation function

100

No execution permissions (Windows only).

In UNIX, execution permissions are only granted to root.

101

Argument error

102

Communication error

255

Other abnormal termination (system error)

Example

Restart the correlation event generation function at the physical host hostP:
Input value:
jcoegsstart
Result:
KAJV3291-I The correlation event generation function for hostP has restarted.