home *** CD-ROM | disk | FTP | other *** search
/ Chip 1998 February / CHIP_2_98.iso / software / pelne / optionp / iis4_06.cab / samp6qzp.asp < prev    next >
Text File  |  1997-10-15  |  4KB  |  48 lines
  1.  <% If Request("DontFrame")<>1 Then Response.Redirect "/iissamples/sdk/asp/docs/SampFram.asp?ovfile=/iishelp/iis/htm/sdk/samp6qzp.asp&srcfile=Queuing/TransactedDelivery" %>
  2. <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
  3. <HTML>
  4. <HEAD>
  5. <META HTTP-EQUIV="Content-Type" Content="text-html; charset=Windows-1252">
  6. <title>Transacted Message</title>
  7. <script language="JavaScript">
  8.  
  9.     szNavVersion = navigator.appVersion
  10.  
  11.     if (navigator.appName == "Microsoft Internet Explorer") {
  12.     if (szNavVersion.indexOf ("4.") >= 0) {
  13.         document.writeln('<link rel="stylesheet" type="text/css" href="/iishelp/common/spidie4.css">');
  14.     } else {
  15.         document.writeln('<link rel="stylesheet" type="text/css" href="/iishelp/common/spidie3.css">');
  16.     }
  17.     }
  18.     else if (navigator.appName == "Netscape") {
  19.     document.writeln('<link rel="stylesheet" type="text/css" href="/iishelp/common/spidie4.css">');
  20.     }
  21.     else {
  22.     document.writeln('<link rel="stylesheet" type="text/css" href="/iishelp/common/spidie3.css">');
  23.     }
  24.  
  25. </script>
  26. <META NAME="DESCRIPTION" CONTENT="Internet Information Server reference information"></HEAD>
  27. <BODY BGCOLOR=#FFFFFF TEXT=#000000>
  28. <font face="Verdana, Arial, Helvetica">
  29. <h3><a name="_transacted_message"></a>Transacted Message</h3>
  30. <p>
  31. MSMQ message delivery can be wrapped as an MTS transaction, just as any other ASP script. This sample illustrates how to open a transacted queue, and send a simple message to it, all within a transaction wrapper.</p>
  32. <p>
  33. Like any other transacted Web page, this sample starts with the @TRANSACTION=REQUIRED directive. All actions taken by the script, such as an MSMQ message transmission, will be grouped together as one single, indivisible transaction that either is completed or aborted in its entirety. </p>
  34. <p>
  35. This example then creates an instance of the <b>MSMQQueueInfo</b> object, which will be used as a template for the actual queue object instances. <b>MSMQQueueInfo</b> contains a number of properties that can be used to configure the queue instances it will create, but in this sample, only the <b>PathName</b> property is set. <b>PathName</b> specifies the MSMQ pathname of the queue, and is given in the general form <i>MachineName\QueueName</i>. Note that in this example, the <i>MachineName</i> part of the MSMQ pathname is a period (.), which indicates that the queue is located on the local computer.</p>
  36. <p>
  37. The <b>MSMQQueueInfo.Open</b> method is used to create an instance of the actual queue object, <b>MSMQQueue</b>, and the variable <i>Queue</i> is set to refer to the new queue instance. </p>
  38. <p>
  39. At this point, having gained access to the IIS_SDK_TRANSACTED queue, this sample now creates a new message object by instantiating <b>MSMQMessage</b>. The reference to the instance, <i>Msg</i>, is used to set the description and content of the message using the <b>Label</b> and <b>Body</b> properties. The <b>Delivery</b> property, which indicates whether express or recoverable delivery is used, is also set at this time. For this demonstration, it has been set to indicate that MSMQ is to use recoverable delivery. </p>
  40. <p>
  41. With the message complete and the queue configured, the script is ready to send the message. The <b>MSMQMessage.Send</b> method is called to send the message to the queue pointed to by the reference <i>Queue</i>, and the queue is closed with the <b>Close</b> method. If the script, and hence the transaction, completed without error, the <b>OnTransactionCommit</b> method is executed, and you are notified of the success. Any errors encountered in the execution of the sample will cause <b>OnTransactionAbort</b> to be called instead. </p>
  42. <p>
  43. <b>Note</b>  This sample requires that MSMQ be installed on your host machine. It also requires, prior to running this sample for the first time, that you start MSMQ Explorer and create a new transacted queue named IIS_SDK_TRANSACTED. MSMQ Explorer can also be used after the sample is run so that you can examine the results of the script's execution.</p>
  44. <hr class="iis" size="1">
  45. <p align="center"><em><a href="/iishelp/common/colegal.htm">© 1997 by Microsoft Corporation. All rights reserved.</a></em></p>
  46. </BODY>
  47. </HTML>
  48.