<!--
 -  
 -  This file is part of the OpenLink Software Virtuoso Open-Source (VOS)
 -  project.
 -  
 -  Copyright (C) 1998-2018 OpenLink Software
 -  
 -  This project is free software; you can redistribute it and/or modify it
 -  under the terms of the GNU General Public License as published by the
 -  Free Software Foundation; only version 2 of the License, dated June 1991.
 -  
 -  This program is distributed in the hope that it will be useful, but
 -  WITHOUT ANY WARRANTY; without even the implied warranty of
 -  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
 -  General Public License for more details.
 -  
 -  You should have received a copy of the GNU General Public License along
 -  with this program; if not, write to the Free Software Foundation, Inc.,
 -  51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
 -  
 -  
-->
<?xml version="1.0" encoding="ISO-8859-1"?>
<refentry id="HO-S-4">
  <refmeta>
    <refentrytitle>3rd Party Runtime Hosting</refentrytitle>
    <refmiscinfo>tutorial</refmiscinfo>
  </refmeta>
  <refnamediv>
    <refname>Hosting CLR types using VSPX session management</refname>
    <refpurpose>Demonstrating the use of C# to create Virtuoso hosted Stored 
    Procedures and Triggers.  In this demo a database events trigger SMS 
    messages that are relayed via a C# based SOAP Client.  It also demonstrates 
    Virtuoso Server Pages session management.</refpurpose>
  </refnamediv>

    <refsect1 id="HO-S-4a_overview"><title>Overview</title>
    <para>This is a variation of HO-S-3 with the SOAP client implemented ASP.NET and also demonstrates Virtuoso Server Pages for XML (VSPX) session management.</para>
    </refsect1>

    <refsect1 id="HO-S-4a_prerequisites">
    <title>Prerequisites</title>
    <para>This demo currently works only on a Virtuoso server running under Microsoft Windows with following components installed:</para>
    <itemizedlist>
      <listitem>Windows
        <itemizedlist>
          <listitem>.NET Runtime and Frameworks</listitem>
          <listitem>.Net Runtime and Framework SDK (if you seek to write your own Objects for integration with Virtuoso)</listitem>
          <listitem>Virtuoso Universal Server for Windows with .NET CLR Hosting.</listitem>
        </itemizedlist>
      </listitem>
    </itemizedlist>
    </refsect1>

    <refsect1 id="HO-S-4a">
    <title>Tutorial Example</title>
    <itemizedlist mark="bullet">
      <listitem>The setup_sms.vspx sets up the SMS sending unit.</listitem>
      <listitem>The handler.vspx does inserts/deletes/updates to demonstrate the SMS sending from triggers.</listitem>
      <listitem>The redcoalsms*.cs is an MS Visual Studio.NET generated SOAP client.</listitem>
      <listitem>The redcoalsms.dll should be installed as a private assembly (not as CodeBase) because of permissions.</listitem>
      <listitem>For details of the Redcoal SOAP service see it's description in http://www.xmethods.com</listitem>
    </itemizedlist> 
    </refsect1>
</refentry>
