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.