IBM Tivoli Monitoring > Version 6.3 Fix Pack 2 > Administrator's Guide > IBM Tivoli Monitoring Web Services for the SOAP server > Start the SOAP client and making a request
IBM Tivoli Monitoring, Version 6.3 Fix Pack 2
Use the SOAP client command-line utility (kshsoap)
The SOAP client command-line utility, kshsoap, is an http client. It issues direct SOAP requests and displays the output at the command line.
Complete these steps to create a SOAP request file and a SOAP URL receiver file and send the request.
Procedure
- On the Tivoli Enterprise Monitoring Server system where the SOAP server is installed, change to the install_dir\cms directory.
- Create a text file named SOAPREQ.txtand type the following SOAP request:
<CT_Get><object>ManagedSystem</object></CT_Get>or, if security has been enabled:
<CT_Get><userid>logonid</userid><password>password</password> <object>ManagedSystem</object></CT_Get>
Create another text file named URLS.txt containing the URLs to receive the SOAP request. In this example, affiliatecompanylocalhost is the name of the receiving system and where the hub monitoring server is installed: http://affiliatecompanylocalhost:1920///cms/soap
At the command line, enter kshsoap SOAPREQ.txt URLS.txt
Run the kshsoap script located in the install_dir/interp/ms/bin directory. The monitoring server configuration settings must be incorporated into your current shell before you invoke the kshsoap client. Incorporate the settings by entering the following command: . install_dir/config/hostname_ms_temsname.config. To verify this step, you can use the *env* command to show your environment variables and compare the entries to those in the .config file.
When running the kshsoap command on systems that have APPN installed, you might encounter an error message stating that an APPN file needs to be configured. To resolve this situation, modify the environment variable KDE_WAPPC32 from the command line window that you are going to run the kshsoap command in: SET KDE_WAPPC32=none
Results
The kshsoap utility processes the SOAPREQ file and displays the URL destination and request. It sends the SOAP request to each URL listed in the URLS file, then displays the URL and the response message received.
Parent topic:
Start the SOAP client and making a request