Top
Systemwalker Service Quality Coordinator Reference Guide
Systemwalker

1.6.1 sqcRemoteCheck (Agent for Agentless Monitoring Management Communication Confirmation Command)

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 Managers and Proxy Managers.


Format

[Windows]

<Installation directory>\bin\sqcRemoteCheck.exe [-h <hostname>]

[UNIX]

/opt/FJSVssqc/bin/sqcRemoteCheck.sh [-h <hostname>]


Function

The agent for Agentless Monitoring management communication confirmation command confirms whether communication is possible between a managed server that has been set up using agent for Agentless Monitoring management and a Manager or Proxy Manager.

The -h option can be used to specify the managed server for which communication is to be confirmed.

Note

Do not execute multiple sqcRemoteCheck command simultaneously.


Options

-h <host name>

Specifies the identifier of the managed server for which communication is to be confirmed.

If this option is omitted, all managed servers being managed using agent for Agentless Monitoring management will be targetted by the command.

Point

In the identifier of the managed server, specify the HOSTNAME string in the remote monitoring configuration file (remoteAgent.txt).


Return values

Normal termination: 0

Abnormal termination: 1

Execution results/Output format

Normal termination

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

(Success): sqcRemoteCheck succeeded.

Example of execution: communication confirmation

C:\Program Files\SystemwalkerSQC\bin>sqcRemoteCheck.exe

Server1 OK

Server2 OK

Server3 NG detail=*****dsa_telnet***** ===== Connect Error =====

server: TestServer3 [Server3]

SOCKET Message: The requested name is valid, but no data of the requested type was found.

State: Start connection: Resolve host address

(Success): sqcRemoteCheck.exe succeeded.

Abnormal termination

An error message will be sent to standard error output:

(Error error number):Message

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

Error number

Message

Content

Corrective measure

010

Parameter error.

Parameter specification error

Correct the parameter and re-execute the command.

020

invalid argument to '-h'

-h option specification error

Correct -h option's parameter and re-execute the command.

100

System error.

Other error

Collect maintenance information and contact a Fujitsu SE.

Example of execution

If the agent for Agentless Monitoring management communication confirmation command is performed using the following definition

[Identifier of the managed server]

server1
server2
server3

[Sample error]

If the sqcRemoteCheck command ends with an error

(Error 100):System error.

Usage example

[Windows]

C:\Program Files\SystemwalkerSQC\bin>sqcRemoteCheck.exe

Server1 OK

Server2 OK

Server3 NG detail=*****dsa_telnet***** ===== Connect Error =====

server: TestServer3 [Server3]

SOCKET Message: The requested name is valid, but no data of the requested type was found.

State: Start connection: Resolve host address

(Success):sqcRemoteCheck.exe succeeded.

[UNIX]

#cd /opt/FJSVssqc/bin

#./sqcRemoteCheck.sh

Server1 OK

Server2 OK

Server3 NG detail=*****dsa_telnet***** ===== Connect Error =====

server: TestServer3 [Server3]

SOCKET Message: Temporary failure in name resolution

State: Start connection: Resolve host address

(Success):sqcRemoteCheck succeeded.