jcastatus
- Organization of this page
Function
Using standard output, this command displays the status (stopped, running, standby) of the automated action function that is running, and the contents of the automated action definition file that is loaded by the active automated action function.
Note that you can execute multiple instances of this command concurrently.
Format
jcastatus [-h logical-host-name]
[-d]
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 logical-host-name
-
When you are operating in a cluster system, this option specifies the logical host name. The command displays the status of the automated action function (Event Base Service) that corresponds to the specified logical host. 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.
- -d (at Event Base Service)
-
Specifies that the contents of the automated action definition file that is loaded by the automated action function is displayed to standard output. The command displays the information in the same format as in the automated action definition file.
Even when all automated action definitions are disabled, the contents of the automated action definition file that is loaded by the active automated action function are displayed to standard output.
Return values
|
0 |
Normal termination |
|
4 |
No response from the automated action function (Event Base Service) |
|
5 |
Command cannot display the contents of the automated action definition file because the automated action function (Event Base Service) is stopped or on standby |
|
6 |
System error (at the command) |
|
152 |
System error (at Event Base Service) (in UNIX) |
|
154 |
Input/output error (in UNIX) |
|
243 |
A specified argument value was invalid (in UNIX) |
|
-13 |
A specified argument value was invalid (in Windows) |
|
-102 |
Input/output error (in Windows) |
|
-104 |
System error (at Event Base Service) (in Windows) |
Output format
When you execute the jcastatus command, the status of the automated action function is output in the following format:
Status : status
The following table describes the character strings that can be displayed as status.
|
Character string displayed in status |
Status |
Description |
|---|---|---|
|
STOP |
Stopped |
The automated action function (Event Base Service) is stopped. |
|
RUNNING |
Running |
The automated action function (Event Base Service) is running and available for use. |
|
STANDBY |
Standby |
The Event Base Service is running, but the automated action function is in the standby mode. In this status, events are still received, but no action is taken on the received events. If the status changes from standby to running, action is not taken on the events that were received while in the standby mode. |
Example output
The automated action function is in the standby mode:
Status : STANDBY