SOAP calls can be run against the ITM TEMS to query data that is stored either centrally or query a managed system. There is a reference to various XML based SOAP calls here on the Orb Data web-site, but how can you run those calls from the command-line?
ITM ships with the "kshsoap" binary that enables an administrator to execute the soap calls on Windows, UNIX and Linux systems. The basic syntax is:
The <xml_file> reference in the above command is the fully-qualified XML file that includes the SOAP call. The <url_file> reference is the URL of the TEMS in the format "http:<TEMS_hostname>:1920///cms/soap".
On Windows systems the executable is located in the directory %CANDLE_HOME%/cms. On a Linux/UNIX system it is found in the path $CANDLEHOME/<platform>/ms/bin/. Note that on UNIX/Linux platforms you will need to set-up the TEMS configuration settings prior to running the binary. Execute the following command:
Replace the references to <hostname> and <temsname> with the values of the hostname and TEMS name as relevant to your environment. Failure to set the environment will result in an error similar to "error while loading shared libraries: libksh.so: cannot open shared object file: No such file or directory".
As an example, to list the status of managed systems running "kshsoap" on a Linux system, create a file including the Agent Status XML from here and also create a text file to include the TEMS URL details. The following commands detail the steps:
> cd /opt/IBM/ITM
#Verify the URL text file
> cat /tmp/soap.url
> . config/vm60_ms_HUBTEMS01.config
#Run the SOAP call
The output includes the XML request, RAS1 information before the XML return. An extract of the output is below.
Similarly on Windows, this time using the list situations SOAP call detailed here, the command can be run as demonstrated in the figure below.
Note that this commd was run from the directory %CANDLE_HOME%/cms to prevent the error "kshsoap.exe - Unable to Locate Component. This application has failed to start because gsk7ssl.dll was not found.", as per the figure below.