1.8.1 sqcSetMgrInfo(for Agent/Proxy Manager)

Function

This command sets and displays host name or IP address of Manager recognized by the Agent/Proxy Manager.

Note

Do not execute multiple sqcSetMgrInfo 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

Proxy Manager/Agent

Before performing this procedure

If the Proxy Manager/Agent resident processes are running, then stop the service/daemon. Additionally, make sure that the resident processes have stopped correctly.

Format

To change the manager recognized by the Proxy Manager/Agent:

[Windows]

<installation directory>\bin\sqcSetMgrInfo.bat -h <host name/IP address>

[UNIX]

/opt/FJSVssqc/bin/sqcSetMgrInfo.sh -h <host name/IP address>

To display the manager recognized by the Proxy Manager/Agent:

[Windows]

<installation directory>\bin\sqcSetMgrInfo.bat -v

[UNIX]

/opt/FJSVssqc/bin/sqcSetMgrInfo.sh -v

Options

-h <host name/IP address>: Specify the host name or IP address of the Manager recognized by the Proxy Manager/Agent.

-v: Use this option to display the host name or the IP address of the Manager that is currently set.

Return values

Normal termination: 0

Abnormal termination: 1

Usage example

To set the manager recognized by the Proxy Manager/Agent:

[Windows]

C:\>cd C:\Program Files\SystemwalkerSQC\bin

C:\Program Files\SystemwalkerSQC\bin>sqcSetMgrInfo.bat -h new_manager

[UNIX]

/opt/FJSVssqc/bin/sqcSetMgrInfo.sh -h new_manager

To display the manager recognized by the Proxy Manager/Agent:

[Windows]

C:\>cd C:\Program Files\SystemwalkerSQC\bin

C:\Program Files\SystemwalkerSQC\bin>sqcSetMgrInfo.bat -v

[UNIX]

/opt/FJSVssqc/bin/sqcSetMgrInfo.sh -v

Execution results/Output format

Normal termination (with -h option)

The following normal completion message will be sent to standard output.

(Success) sqcSetMgrInfo succeeded.

Normal termination (with -v option)

The following normal completion message will be sent to standard output.

Manager IP Address/Hostname : new_manager

(Success) sqcSetMgrInfo succeeded.

Abnormal termination

An error message will be sent to standard error output.

(Error) error number,Message

The error numbers, messages, and content corresponding to the error messages are as shown below.

Error number	Message	Content
010	Parameter error.( Error detail code)	Parameter specification error
100	System error.( Error detail code)	Other error