Function
This command checks whether the definition of the threshold definition (alertconfig.txt) is correct.
If you want to check because the threshold monitoring function doesn't behave as expected or if you want to check whether the setting for threshold monitoring is correct, you can use this command to check whether there are syntax errors.
Execute this command on the system where the definition is performed.
Note
Do not execute multiple sqcCheckAlertconfig command simultaneously.
Privileges required for execution
[Windows]
The privileges of a user belonging to the "Administrators" group are required to execute this command.
[UNIX]
The privileges of a system administrator (superuser) are required to execute this command.
Execution environment
This command can be executed on Enterprise Manager, Manager, Proxy Manager, and Agent.
Syntax
[Windows]
<installation directory>\bin\sqcCheckAlertconfig.bat <installation directory>\bin\sqcCheckAlertconfig.bat -f <full path of the threshold definition file (alertconfig.txt)> |
[UNIX]
/opt/FJSVssqc/bin/sqcCheckAlertconfig.sh /opt/FJSVssqc/bin/sqcCheckAlertconfig.sh -f <full path of the threshold definition file (alertconfig.txt)> |
Options
Specify the threshold definition file you want to check by full path. If this option is not specified, the currently set threshold definition file (alertconfig.txt) will be checked. Refer to the [Threshold Monitoring Defintion] of Users Guide for the location of currently set threshold monitoring definition.
Return values
Normal termination (including the case there is error in threshold definition): 0
Abnormal termination (failed to check the threshold monitoring definition.): 1
Execution results/Output format
The following normal completion message will be sent to standard output.
C:\> "C:\Program Files\SystemwalkerSQC\bin\sqcCheckAlertconfig.bat" Check alertconfig file. ------------------------------------------------------------------------------- The definition of alertconfig file is correct. ------------------------------------------------------------------------------- Command succeeded. |
An error message will be sent to standard error output: The message indicates the place of the error first encountered.
Message | Content | Corrective measure |
|---|---|---|
ERROR: <conffilename>:( detailed message) | Because of "detailed messages", failed to open <conffilename> | Correct the problem indicated by "detailed message" and try again. |
ERROR: <conffilename>, line <N>, col <C>, value = <value>:(wrong definition content) | There is a mistake indicated by "wrong definition content" in file <conffilename> line <N> item <C> definition <value> | Modify the definition indicated by "wrong definition content" and try again. |
ERROR: <conffilename>, line <N>, col <C>:(wrong definition content) | There is a mistake indicated by "wrong definition content" in file <conffilename> line <N> item <C> | Modify the definition indicated by "wrong definition content" and try again. |
ERROR: <conffilename>, line <N>:( wrong definition content) | There is a mistake indicated by "wrong definition content" in file <conffilename> line <N> | Modify the definition indicated by "wrong definition content" and try again. |
"<conffilename>" is not exist or file. | The specified <conffilename> is not found, or is not a file. | Confirm whether the file name specified is correct or is full path, correct it and try again. |
(Error) : Parameter error. Usage : sqcCheckAlertconfig.bat [-f <alertconfig>] | There is mistake in the parameter specified. | Confirm and modify the parameter specified and try again. |
<conffilename>, <N>, <C>, <value>, (wrong definition content) are variable.
C:\>"C:\Program Files\SystemwalkerSQC\bin\sqcCheckAlertconfig.bat" -f c:\alerconfig.txt "c:/alertconfig.txt" is not exist or file. (Error) : Parameter error. Usage : sqcCheckAlertconfig.bat [-f <alertconfig>] |
C:\> "C:\Program Files\SystemwalkerSQC\bin\sqcCheckAlertconfig.bat" Check alertconfig file. ------------------------------------------------------------------------------- ERROR: alertconfig.txt, line 82, col 1, value = AlertId1: Alert Id is not unique. ------------------------------------------------------------------------------- Command succeeded. |
Usage Example 1
The setting for threshold monitoring was made however no messages were noticed at expected timing. Execute the command as follows. At the example below, the [AlertId1] at item 1, line 82 in currently set threshold definition is not unique. Make sure the Alert Id is unique.
[Windows]
C:\> "C:\Program Files\SystemwalkerSQC\bin\sqcCheckAlertconfig.bat" Check alertconfig file. ------------------------------------------------------------------------------- ERROR: alertconfig.txt, line 82, col 1, value = AlertId1: Alert Id is not unique. ------------------------------------------------------------------------------- Command succeeded. |
[UNIX]
# /opt/FJSVssqc/bin/sqcCheckAlertconfig.sh Check alertconfig file. ------------------------------------------------------------------------------- ERROR: alertconfig.txt, line 82, col 1, value = AlertId1: Alert Id is not unique. ------------------------------------------------------------------------------- Command succeeded. |
Usage Example 2
In case you want to check the threshold monitoring definition that will be used later, execute the command as follows. At the example below, the [01:00:00] of item 7, line 84 of the threshold monitoring definition is before start time (Start time). Make sure end time (End time) must be after the start time (Start time).
[Windows]
C:\> "C:\Program Files\SystemwalkerSQC\bin\sqcCheckAlertconfig.bat"-f c:\alertconfig.txt Check alertconfig file. ------------------------------------------------------------------------------- ERROR: c:/alertconfig.txt, line 84, col 7, value = 01:00:00: End time must be >= Start time. ------------------------------------------------------------------------------- Command succeeded. |
[UNIX]
# /opt/FJSVssqc/bin/sqcCheckAlertconfig.sh -f /tmp/alertconfig.txt Check alertconfig file. ------------------------------------------------------------------------------- ERROR: /tmp/alertconfig.txt, line 84, col 7, value = 01:00:00: End time must be >= Start time. ------------------------------------------------------------------------------- Command succeeded. |
