jcfallogstop
- Organization of this page
Function
Stops remote monitoring log file traps.
The following options are provided:
-
Period of time that traps stop (individually or batched)
-
Whether stopped remote monitoring log file traps should be deleted
Note that a maximum of five commands can be executed concurrently.
The following conditions must be satisfied to execute this command:
-
The IM Configuration Management service is running
-
There is a remotely monitored host in the remote monitoring configuration.
-
A remotely monitored host has already collected host information.
-
For SSH communication, SSH authentication can be performed by using the applicable remotely monitored host and public key encryption.
-
For NetBIOS (NetBIOS over TCP/IP) communication, the log file to be monitored is shared.
-
A remote monitoring log file trap is running.
Format
jcfallogstop {-o monitored-host-name [-a monitoring-name] | ALL} [-d] [-h logical-host-name] [-q]
Execution permission
In Windows: Administrator permissions
In UNIX: Superuser permissions
Storage directory
- In Windows:
-
Manager-path\bin\imcf\
- In UNIX:
-
/opt/jp1imm/bin/imcf/
Arguments
- -o monitored-host-name
-
Specifies the name of the monitored host for a remote monitoring log file trap you want to stop.
- -a monitoring-name
-
Specifies the monitoring name of a remote monitoring log file trap you want to stop.
Specify a character string with a maximum of 30 bytes for the monitoring name. Alphanumeric characters, hyphens (-), and underlines can be used. The first character must be an alphanumeric character. The monitoring name is not case sensitive.
- ALL
-
Stops all remote monitoring log file traps.
- -d
-
Specifying this option deletes the entry for the remote monitoring log file trap you want to stop from the profile tree.
If this option is used together with the -a, -o, or ALL option, multiple remote monitoring log file traps are removed from the profile tree. In this case, a message is output to confirm that there is no problem. If this option is used together with any other option, it is ignored.
- -h logical-host-name
-
Specifies the name of the logical host on which you want to execute the command. If this option is omitted, the logical host name specified for the JP1_HOSTNAME environment variable is set. If no logical host name is set for JP1_HOSTNAME, the physical host name is set.
- -q
-
If this option is specified, a confirmation message is not displayed when the -d option is specified. If -d option has not been specified, this option is ignored.
Return values
0 |
Stopping or deletion successful |
2 |
Partial or total failure |
4 |
Invalid argument |
6 |
Unable to connect to the server |
7 |
Invalid host information |
10 |
Error in obtaining exclusive edit rights |
12 |
Invalid authentication definition file |
13 |
Communication error |
14 |
Invalid DB |
15 |
The specified remote monitoring log file trap has already stopped (when the -d option is not specified) |
17 |
Invalid permission |
18 |
Input/output error |
21 |
Upper limit for number of concurrent executions reached |
255 |
Internal error |
Other values |
Other error |
Example 1
Stop the remote monitoring log file trap name1 on host1:
jcfallogstop -o host1 -a name1
Example 2
Stop and then delete all remote monitoring log file traps:
jcfallogstop ALL -d