Top
Systemwalker Service Quality Coordinator Reference Guide
Systemwalker

1.1.6 sqcSendPolicy (Policy Definition Information Distribution Command)

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 alater, 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

<installation directory>\bin \sqcSendPolicy.exe

-g <policy distribution group name>

-g <policy distribution group name> [-s <server name>,...]


Function

This command distributes policy definition information to a specified server.

Note

Do not execute multiple sqcSendPolicy command simultaneously.


Options

-g <policy distribution group name>

Specify the name of the policy distribution group.

The policy definition information file created in the policy distribution group folder specified by -g will be distributed to the server defined by the policy distribution definition file (Distribute.ini).


-s <server name>

Specifies the name of the server to which a policy is to be distributed.

If the -s option is specified, the policy distribution definition file (Distribute.ini) of the policy distribution group specified by the -g option will be disabled and all the stored policy definition information files will be distributed to the specified server.

If the -s option is specified, only one policy distribution group will be specified by the -g option.


Example 1

Distribution is performed using the following definition:

[Policy distribution group]

USER_DEFINE_FOLDER1

[The destination servers defined by the policy distribution definition file (Distribute.ini)]

wasabi1,wasabi2

[Policy definition information file]

Threshold monitoring definition

C:\Program Files\SystemwalkerSQC-C\bin\sqcSendPolicy.exe -g USER_DEFINE_FOLDER1

Explanation 1

When USER_DEFINE_FOLDER1 is specified with -g, the policy definition information file (threshold monitoring definition) will be distributed to the destination servers (wasabi1, wasabi2) defined by the policy distribution definition file (Distribute.ini).


Example 2

Distribution is performed using the following definition:

[Policy distribution group]

USER_DEFINE_FOLDER

[The destination servers defined by the policy distribution definition file (Distribute.ini)]

wasabi1,wasabi2

[Policy definition information file]

Threshold monitoring definition

C:\Program Files\SystemwalkerSQC-C\bin\sqcSendPolicy -g USER_DEFINE_FOLDER -s wasabi3,wasabi4

Explanation 2

If wasabi3 and wasabi4 are specified with -s, the destination servers wasabi1 and wasabi2 defined by the policy distribution definition file (Distribute.ini) will be disabled and the policy definition information file (threshold monitoring definition) will be distributed to wasabi3 and wasabi4.


Execution results/Output format

Normal termination

  1. A normal completion message together with the distribution destination server and distribution definition information will be sent to standard output.

    (Success) : 000,sqcSendPolicy succeeded., error number,server name,time,definition file

    :

    Execution example

    Remote policy operation (distribution) is performed using the following definition:

    [Distribution destination servers]

    wasabi1,wasabi2

    [Policy definition information file]

    Threshold value

    (Success) : sqcSendPolicy succeeded.,000,wasabi1,2007-12-25 00:00,alertconfig.txt

    (Success) : sqcSendPolicy succeeded.,000,wasabi2,2007-12-25 00:00,alertconfig.txt


Abnormal termination

  1. An error message will be sent to standard error output:

    (Error) :error message, error number, server name, time, definition file

    Error numbers and corresponding error messages

    Error number

    Message

    Content

    010

    Parameter error. (Error detail code)

    Parameter specification error

    011

    Not found file

    There are no files that can be distributed

    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

    Execution example

    Remote policy operation is performed using the following definition:

    [Distribution destination servers]

    wasabi1,wasabi2

    [Policy definition information file]

    Threshold value

    [Sample error]

    When a communication error occurred during distribution to wasabi1

    (Error) : abort connection error.(????),030,wasabi1,2007-12-25 00:00,alertconfig.txt

    (Success) : sqcSendPolicy succeeded.,000,wasabi2,2007-12-25 00:00,alertconfig.txt

    Note: ???? indicates the detailed code.


  2. 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.

    011

    There are no files that can be distributed

    Check that the file corresponding to the type of destination server is registered with the policy distribution group folder.

    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.