Developing a .NET 1 or 2 service for IBM MQ transport for SOAP using Microsoft Visual Studio 2012

Develop the SampleStockQuote web service for .NET 1 or .NET 2 using Microsoft Visual Studio 2012.

Create the StockQuote service with a code-behind implementation using Microsoft Visual Studio 2012.

Procedure

1. Create a template for the service, and check that it runs on HTTP.
   1. Start Visual Studio 2012 > File > New > Project.... Select C# Project Type, ,NET Framework 2, and ASP.NET Web Service Application. Type the Name: and Solution Name: StockQuoteDotNet > OK
   2. Right click Service1.asmx in the Solution Explorer > Rename > StockQuote.asmx.
   3. Change the code fragment public class Service1 to public class StockQuote.
   4. Right click StockQuote.asmx in the Solution Explorer > Open with... > XML Editor. Change Class=StockQuoteDotNet.Service1 to Class=StockQuoteDotNet.StockQuote
   5. Change the code fragment [WebService(Namespace = "http://tempuri.org/")] to [WebService(Namespace = "http://stock.samples/")].
   6. Remove the line of code [ToolboxItem(false)].
   7. Check everything is correct so far: Debug > Start Debugging (F5). Verify the output in Explorer.
2. Add the methods from the sample SQDNNonInline.asmx.cs, and test the service on HTTP.
   1. Open MQ_INSTALLATION_PATH \tools\soap\samples\dotnet\SQDNNonInline.asmx.cs and replace the HelloWorld method with the four Quote methods; see Figure 1. MQ_INSTALLATION_PATH represents the directory where IBM MQ is installed.
   2. Build > Rebuild the solution > Right click one of the Thread in error > Resolve > Using System.Threading.
   3. Press F5 to start debugging. The service is not conformant to WS-I Basic Profile v1.1. You have the choice of either changing the WebMethod annotation from [SoapRpcMethod] to [SoapDocumentMethod], or removing the annotation [WebServiceBinding(ConformsTo = WsiProfiles.BasicProfile1_1)].
   4. Press F5 to verify the implementation using HTTP.
3. Generate WSDL, clients, and run the service using IBM MQ transport for SOAP.
   1. Open a command window in the project directory tree, where the StockQuote.asmx is stored.
   2. (Optional) Use amqwdeployWMQService to generate artifacts. The queue manager must be started:

      amqswdeployWMQService -f StockQuote.asmx
      -u "jms:/queue?initialContextFactory=com.ibm.mq.jms.Nojndi
      &connectionFactory=()
      &destination=REQUESTDOTNET@QM1
      &targetService=StockQuote.asmx"
      StockQuote.asmx StockQuote.wsdl
      

      All artifacts are created in the ./generated directory tree.
   3. (Optional) Generate just the WSDL for calling the service using IBM MQ transport for SOAP.

      amqswsdl -u "jms:/queue?initialContextFactory=com.ibm.mq.jms.Nojndi
      &connectionFactory=()
      &destination=REQUESTDOTNET@QM1
      &targetService=StockQuote.asmx"
      StockQuote.asmx StockQuote.wsdl
      

   1. Run the .NET listener. Either use .\generated\server\startWMQNListener.cmd or type the command:

      amqSOAPNETListener -u "jms:/queue?initialContextFactory=com.ibm.mq.jms.Nojndi
      &connectionFactory=()
      &destination=REQUESTDOTNET@QM1
      &targetService=StockQuote.asmx"
      

4. Test the service using a client generated from the WSDL, or using the clients generated by amqwdeployWMQService.

Sample code

The sample .NET web service, StockQuoteDotNet, is installed in MQ_INSTALLATION_PATH \tools\soap\samples\dotnet. MQ_INSTALLATION_PATH is the directory where IBM MQ is installed. The web service binding of the published samples differ slightly from the binding used in the task. The task uses the defaults used in Microsoft Visual Studio 2012.

There are two examples of .NET Framework 1 and .NET Framework 2 web services. StockQuoteDotNet.asmx, is an inline service. SQDNNoninline.asmx, is a code-behind web service implemented by SQDNNoninline.asmx.cs.

1. float getQuote(String symbol)
2. void getQuoteOneWay(String symbol).
3. int asyncQuote(int delay)
4. float getQuoteDOC(String symbol)

<%@ WebService Language="C#" Class="StockQuoteDotNet" %>
using System;
using System.Web.Services;
using System.Web.Services.Protocols;
using System.Web.Services.Description;
using System.Threading;
[WebService (Namespace="http://stock.samples")]
public class StockQuoteDotNet {
     [WebMethod] [ SoapRpcMethod(OneWay=true) ]
     public void getQuoteOneWay(String symbol) {
          if (symbol.ToUpper().Equals("DELAY")) Thread.Sleep(5000);
          System.Console.WriteLine("getQuoteOneWay was invoked.");
     [WebMethod] [SoapRpcMethod] 
     public float getQuote(String symbol) {
          if (symbol.ToUpper().Equals("DELAY")) Thread.Sleep(10000);
          return 88.88F;
     }    
     [WebMethod] [SoapRpcMethod] 
     public int asyncQuote(int delay) {
          Thread.Sleep(delay);
          return delay;
     [WebMethod] 
     public float getQuoteDOC(String symbol) {
          return 77.77F;
}

<%@ WebService Language="C#" Codebehind="SQDNNonInline.asmx.cs" Class="SQDNNonInline" %>

using System;
using System.Web.Services;
using System.Web.Services.Protocols;
using System.Web.Services.Description;
using System.Threading;

[WebService(Namespace = "http://stock.samples")]
public class SQDNNonInline : System.Web.Services.Protocols.SoapHttpClientProtocol
{

    [WebMethod]
    [SoapRpcMethod(OneWay = true)]
    public void getNonInlineQuoteOneWay(String symbol)
    {
        if (symbol.ToUpper().Equals("DELAY")) Thread.Sleep(5000);
        System.Console.WriteLine("getNonInlineQuoteOneWay was invoked.");
    }

    [WebMethod]
    [SoapRpcMethod]
    public float getNonInlineQuote(String symbol)
    {
        if (symbol.ToUpper().Equals("DELAY")) Thread.Sleep(10000);
        return 88.88F;
    }

    [WebMethod]
    [SoapRpcMethod]
    public int asyncNonInlineQuote(int delay)
    {
        Thread.Sleep(delay);
        return delay;
    }
    [WebMethod]
    public float getNonInlineQuoteDOC(String symbol)
    {
        return 77.77F;
    }
}