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.
Notes
-
Execute this command only on the active host. Make sure that the shared disk is mounted when the command executes.
-
Do not execute this command on the standby host.
If you execute with standby host in UNIX / Linux, an unwanted directory named /shared-directory-name is created under the root directory of standby host local disk, and further unwanted directory and Files are created under that directory as follows.
-
/shared-directory-name/jp1imm
-
/shared-directory-name/jp1imm/log
-
/shared-directory-name/jp1imm/log/imcf
Delete these unwanted directory and files, they will never to be used. To prevent from mistakenly deleting the directory from shared directory, make sure that shared disk is not mounted on standby host before deleting the directory.
-
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