runivt: IBM MQ transport for SOAP installation verification test

An installation verification test suite (IVT) is provided with IBM MQ transport for SOAP. runivt runs a number of demonstration applications and ensures that the environment is correctly set up after installation.


Purpose

The runivt command uses the sample programs provided with the IBM MQ transport for SOAP to send web service requests from clients to services. It runs tests for Axis 1.4, .NET Framework 1, and .NET Framework 2. The tests are configured in a test script file. The default test script file for Windows runs a combination of tests between Java and .NET clients and services.


Description

runivt must be run from its own directory.

The command starts listeners in a different command window. For this reason, you must run the command from an X Window System session on UNIX and Linux systems.


runivt syntax

runivt -v

  • -c ivttests.txt1
  • -c ivttests_unix.txt2
  • -cconfigFile
  • holdkillall
  • /testName
  • Notes:

    • 1 Default on Windows
    • 2 Default on UNIX and Linux systems


    runivt parameters

      -v
      Verbose mode. Write fuller error messages to the console.
      -c configFile
      A configuration file defining the tests to be run. The default configuration file supplied with Windows, UNIX or Linux systems is used by default.
      hold
      Leave the listener running after the tests complete
      killall
      End the listener when the tests complete
      testName
      A space separated list of the tests to run. The test names are selected from the configuration file. If no names are specified then all the tests in the configuration file are run.


    Configuration file

    Each configuration file parameter is a separate line of the file. Leave a blank line between each group of parameters.

    The parameters in the ivttests.txt parameter file are listed.

    configFile syntax

    testNametestDescriptiontestCommandtestResponsetestListener
  • AxisWsdltDjava soap.clients.WsdlClientResponse: 55.25JMSax
  • AxisProxytDjava soap.clients.SQAxis2AxisResponse: 55.25JMSax
  • AxisProxyClienttDjava soap.clients.SQAxis2AxisURLClient2AxisResponse: 55.25JMSax
  • DotnettDSQCS2DotNetURL2.NETRPC reply is: 88.88DOC reply is: 77.77
  • dotnet
  • DotnetClienttDSQCS2DotNetURLClient2.NETRPC reply is: 88.88dotnet
  • DotnetVBtDSQVB2DotNetSQVB2DotNet: reply is: '88.88'dotnet
  • Dotnet2AxistDSQCS2AxisSQCS2Axis RPC reply is: 55.25JMSax
  • Dotnet2AxisClienttDSQCS2AxisURLClient2AxisSQCS2Axis RPC reply is: 55.25JMSax
  • DotnetVB2AxistDSQCS2AxisSQCS2Axis RPC reply is: 55.25JMSax
  • Axis2DotNetWsdltDjava soap.clients.WsdlClient -DResponse: 88.88dotnet
  • Axis2DotNetProxytDjava soap.clients.SQAxis2DotNetURL2.NETResponse: 77.77dotnet
  • URLClient2AxisCommon URLClient connection
  • URL2.NETCommon URLTarget service
  • URLClient2.NETCommon URLTarget serviceClient connection
  • Common URL jms:/queue?destination=SOAPJ.demos@WMQSOAP.DEMO.QM & initialContextFactory = com.ibm.mq.jms.Nojndi & connectionFactory = connectQueueManager(WMQSOAP.DEMO.QM)
  • Client connection clientConnection ( localhost%25289414WMQSOAP.DEMO.QM%2529 ) clientChannel ( TESTCHANNEL )
  • Target service & targetService = StockQuoteDotNet.asmx


  • configFile parameters

      testName
      The name of the test. Use testName in the runivt command
      testDescription
      Documentation about the test
      testCommand
      The command executed by the runivt command to make the client request.
      testResponse
      The exact response string returned by the client request to the console. For the test to succeed testResponse must match the actual response.
      testListener
      The name of the IBM MQ SOAP listener that is started by runivt to process the SOAP request. dotnet and JMSax are synonyms for the supplied listeners, amqwSOAPNETlistener and SimpleJavaListener.


    Examples

    Figure 1. run all the default tests
    runivt
    Figure 2. run a specific test from the default tests
    runivt dotnet
    Figure 3. run a set of custom tests
    runivt -c mytests.txt