jpc_service
- Organization of this page
Function
This command turns Setup Enable and disable of add-on program of JP1/IM - Agent.
Format
jpc_service {-on | -off} service-name
[-h logical-hostname]
Execution permission
In Windows: Administrator permissions (if the Windows UAC feature is enabled, the command is executed from the administrator console)
In Linux: Superuser permissions
Storage directory
- In Windows:
-
Agent-path\tools\
- In Linuix:
-
/opt/jp1ima/tools/
Arguments
- -on service-name
-
Enable add-on program specified in service name.
Logical host's Service name is jpc_add-on-directory-name#_logical-hostname, but specify -on option is jpc_add-on-directory-name#.
- -off service-name
-
Disablee add-on program specified in service name.
Logical host's Service name is jpc_add-on-directory-name#_logical-hostname, but specify -on option is jpc_add-on-directory-name#.
- -h logical-hostname
-
Specifies logical host name when operating on a cluster system.
- #
-
For the value specified in the add-on-directory-name, see A.4 (5) About the Add-On Directory in JP1/Integrated Management 3 - Manager Overview and System Design Guide.
Notes
If the string that you specify in the argument contains spaces or special characters, you must enclose them in " " and escape them. In addition, the following characters cannot be used:
-
"" (double quotation mark)
-
"!" (exclamation)
-
"%" (percent)
-
"^" (Circumflex)
Return values
|
0 |
Service Enable activated/deactivated successfully |
|
1 |
The service is already Enable or disabled. |
|
10 |
Invalid argument |
|
11 |
You do not have Execution permissions. |
|
12 |
Service is running |
|
13 |
Other commands are executing |
|
251 |
Service name is invalid |
|
252 |
Mandatory-services (imagent, imagentproxy, imagentaction) are specified |
|
254 |
Service definition file not found |
|
255 |
Failed to activate/deactivate serviced Enable |
Log output
-
Output destination
- In Windows:
Agent-path\logs\tools\
- In Linux:
/opt/jp1ima/logs/tools/
Example
jpc_service -on jpc_prometheus