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, and Proxy Manager.
Response and operation information collection policies are created using the following two types of information.
Managed object configuration information (response and managed object configuration information)
Response information relates to Browser Agents. Operational information relates to managed services such as HTTP and DNS.
Make these definitions in the following configuration file:
[Windows]
<Variable file storage directory>\control\ServiceConf.xml |
[UNIX]
/etc/opt/FJSVssqc/ServiceConf.xml |
A sample file named "ServiceConf.sample" is located in the above directory. Make a backup copy of this file, then rename it as "ServiceConf.xml" and edit it to suit the environment.
Refer to "Response and Managed Object Configuration Information (ServiceConf.xml)" in the User's Guide for details on how to edit this configuration information file.
Point
To remove response information or service operational information that is currently being managed from the management target, delete entries from the managed object configuration information above, and recollect configuration information using the sqcAPolicy and sqcSetPolicy commands and the Setting View.
Template
This template defines the performance items for which information will be always collected. It is provided as the following file when this product is installed:
[Windows]
<Variable file storage directory>\control\template.dat |
[UNIX]
/opt/FJSVssqc/control/template.dat |
Syntax
[Windows]
<Installation directory>\bin\sqcAPolicy.bat |
[UNIX]
/opt/FJSVssqc/bin/sqcAPolicy.sh |
Function
This command creates response and operation information collection policies by importing a predefined managed object configuration information file (response and managed object configuration information).
Note
Do not execute multiple sqcAPolicy commands simultaneously.
Options
None.
Return values
Normal termination:0
Abnormal termination:1
When this command is executed, it checks the operational information for the services being monitored, based on the contents of the managed object configuration information file, and displays the results. Then there is a prompt that provides an opportunity to correct any errors in the settings.
If the results displayed are correct, select "yes", otherwise select "no."
If this command is used incorrectly, it will terminate with error code 1.
If any other kind of error occurs, the command will terminate with error code -1.
If this command terminates normally, the following message will be output:
sqcAPolicy succeeded. |
If this command terminates abnormally, the following message will be output:
sqcAPolicy ServiceConf.xml error. |
(There is an error in the content of ServiceConf.xml.)
Usage example
[Windows]
C:\>cd C:\Program Files\SystemwalkerSQC\bin C:\Program Files\SystemwalkerSQC\bin>sqcAPolicy HTTP_1,23 DNS_1,24 PORT_1,1 Do you apply to these configurations? (yes/no) yes SqcAPolicy succeeded. C:\Program Files\SystemwalkerSQC\bin> |
[UNIX]
# cd /opt/FJSVssqc/bin/ # ./sqcAPolicy.sh HTTP_1,23 DNS_1,24 PORT_1,1 Do you apply to these configurations? (yes/no) Yes SqcAPolicy succeeded. # |
Point
The service name ("HTTP_1" in this example) is followed by a comma and then a number. This number indicates the response time of the service being monitored. Any number other than -1 indicates that the service is operating correctly. If -1 is displayed, then either the service being monitored is not running, or there may be an error with the content of the managed object configuration information file. In this case, correct the file and execute the command again.
File
If this command is successful, the following files will be created according to the content of the managed object configuration information file.
[Windows]
<Variable file storage directory>\control\WSLM.ini |
[UNIX]
/opt/FJSVssqc/control/HTTPPING.ini /opt/FJSVssqc/control/DNSPING.ini /opt/FJSVssqc/control/PORTPING.ini /opt/FJSVssqc/control/SMTPPING.ini /opt/FJSVssqc/control/AlertTarget.csv |
After creating a response/operation information collection policy, run the sqcSetPolicy command by referring to "1.1.3 sqcSetPolicy (Policy Application Command)" below.