Policies can be created and applied to distribution destination servers remotely from the operation management client. Use the sqcCtrlPolicy command (Policy Remote Operation Command) to create and apply policies. Explanation of the sqcCtrlPolicy (Remote Policy Operation Command) is as follows.
Privileges required for execution
The privileges of a user belonging to the "Administrators" group are required to execute this command.
Note
To execute this command under Windows Server 2008/Windows Vista and later, execute with the administrator privilege.
For Windows Server 2012/Windows 8
Right-click the Start menu (located at the bottom-left corner of the Desktop) and select Command Prompt (Admin). Run the command from the Command Prompt.
For Windows Server 2008/Windows 7/Windows Vista
From the Start menu, select All Programs - Accessories, then right-click Command Prompt, and select Run as administrator. Run the command from the Command Prompt.
Execution environment
This command can be executed on an operation management client
Format
<operation management client installation directory>\bin\sqcCtrlPolicy.exe | -e < operation command type> {-g <policy distribution group>,... | -s <Server name>,...} |
Function
Policies can be created and applied to distribution destination servers remotely from the operation management client. Creating a collection policy (sqcRPolicy: Server resource information collection policy)
Creating a collection policy (sqcAPolicy: Response/operation information collection policy)
Applying a collection policy (sqcSetPolicy)
Note
Do not execute multiple sqcCtrlPolicy command simultaneously.
Point
From Systemwalker Service Quality Coordinator V13.3.0 onwards, it is no longer necessary to stop the service or daemon before running the Policy Application Command.
However, if the services or daemons are running and performance data for various middleware is being collected when the Policy Application Command is executed, then the collection of this performance data will be temporarily suspended while policies are applied. Collection of this performance data will start again after the policies have been finished being applied.
Options
Specifies the type of command to be operated remotely.
AP: Collection Policy Creation Command (sqcAPolicy: Response/operation information collection policy)
RP: Collection Policy Creation Command (sqcRPolicy: Server resource information collection policy)
SP: Collection Policy Application Command (sqcSetPolicy)
Specifies the name of the policy distribution group folder.
Specifies the server where remote operation will take place.
Return values
0: Normal termination
1: Parameter error
2: Server processing error
3: Communication error
10: Other error
Refer to the error messages for error details.
If more than one error occurs, the maximum return value will be returned.
For example, if a server processing error occurs on Remote Execution Server A and another error occurs on Remote Execution Server B, 10 will be the value that is returned.
Example
Remote policy operation is performed using the following definition:
[Server]
wasabi
[Command]
Collection Policy Creation Command (sqcRPolicy)
C:\Program Files\SystemwalkerSQC-C\bin\sqcCtrlPolicy.exe -e RP -s wasabi |
Execution results/Output format
Normal termination
A normal completion message is output to standard output.
(Success) : sqcCtrlPolicy succeeded.,000, Server name, time. -- Name of remotely executed command Command Log Start ---- Command execution result -- Name of remotely executed command Command Log End ---- |
Remote policy operation is performed using the following definition:
[Server]
wasabi1, wasabi2
[Command]
Collection Policy Creation Command (sqcRPolicy)
(Success) : sqcCtrlPolicy succeeded.,000,wasabi1,2007-12-25 00:00:00 -- sqcRPolicy Command Log Start ---- (Success) : Middleware product <Interstage Application Server> has been detected. The configuration definitions for the detected middleware has been added. (Success) : sqcRPolicy succeeded. -- sqcRPolicy Command Log End ---- (Success) : sqcCtrlPolicy succeeded.,000,wasabi2,2007-12-25 00:00:00 -- sqcRPolicy Command Log Start ---- (Success) : Middleware product <Interstage Application Server> has been detected. The configuration definitions for the detected middleware has been added. (Success) : sqcRPolicy succeeded. -- sqcRPolicy Command Log End ---- |
Abnormal termination
An error message will be sent to standard error output:
(Error) : message, error number, server name, time -- Name of remotely executed command Command Log Start ---- Command execution result -- Name of remotely executed command Command Log End ---- |
Error numbers and corresponding error messages
Error number | Message | Content |
|---|---|---|
010 | Parameter error. ( Error detail code) | Parameter specification error |
020 | Server access error. (Error detail code) | Server processing error |
030 | Aborted connection error. (Error detail code) | Communication error |
100 | System error. ( Error detail code) | Other error |
Remote policy operation is performed using the following definition:
[Server]
wasabi1
[Command]
Collection Policy Application Command (sqcSetPolicy)
[Sample error]
File manipulation failure
(Error) : system error.(????),100, wasabi1,2007-12-25 00:00:00 -- sqcSetPolicy Command Log Start ---- (Error ) : The file was not able to be created because of insufficient file access rights or disk space. -- sqcSetPolicy Command Log End ---- |
Note: ???? indicates the detailed code.
Correcting errors
Perform the corrective measure that is appropriate for the situation where the error occurred.
Error number | Content | Corrective measure |
|---|---|---|
010 | Parameter error | Correct the parameter and re-execute the command. |
020 | Server processing error | Check the connection with the Manager and the destination server and then re-execute the command. |
030 | Communication error | Check the connection with the Manager and the destination server and then re-execute the command. |
100 | System error | Collect maintenance information, and contact a Fujitsu SE. |
