jcfallogreload
- Organization of this page
Function
Reloads the action definition file of a remote monitoring log file trap.
The only definition information you can reload is that specified by the MARKSTR and ACTDEF parameter values of the action definition file. If a value other than the MARKST and ACTDEF parameter values is changed by using the jcfallogdef command or the Display/Edit Profiles window, the change is not applied by reloading the definition file. Restart the system to apply the change. Also, if the reload command is executed at the same time trap processing is executed, the information to be reloaded is applied to the trap processing.
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 being started.
Format
jcfallogreload {-o monitored-host-name [-a monitoring-name] | ALL} [-h logical-host-name]
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 reload.
- -a monitoring-name
-
Specifies the monitoring name of a remote monitoring log file trap you want to reload.
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
-
Reloads the action definition file of each remote monitoring log file trap.
- -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.
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 |
Reloading 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 |
11 |
Invalid action definition file |
12 |
Invalid authentication definition file |
13 |
Communication error |
14 |
Invalid DB |
15 |
The specified remote monitoring log file trap is already ended |
17 |
Invalid permission |
18 |
Input/output error |
21 |
Upper limit for number of concurrent executions reached |
255 |
Internal error |
Other values |
Other error |
Example
Reload the remote monitoring log file trap name1 on host1:
jcfallogreload -o host1 -a name1