<!--
 -  
 -  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-5">
  <refmeta>
    <refentrytitle>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 event trigger SMS messages 
    that are relayed via a  .NET DOM frameworks based C# SOAP Client. It also 
    demonstrates Virtuoso Server Pages session management.</refpurpose>
  </refnamediv>

    <refsect1 id="HO-S-5a_overview"><title>Overview</title>
    <para>HO-S-5 is a variation of HO-S-3 that makes use of VSPX session management</para>
    </refsect1>

    <refsect1 id="HO-S-5a_prerequisites">
    <title>Prerequisites</title>
    <para>The following prerequisites ensure the usability of these  
    tutorial demos on Windows or Linux (and in other future Mono implementations): </para>
<itemizedlist>
 <listitem>Linux
   <itemizedlist>
     <listitem>Mono Runtime and Frameworks (ideally the version bundled with Virtuoso)</listitem>
     <listitem>Mono SDK (if you seek to write your own Objects for integration with Virtuoso)</listitem>
     <listitem>Virtuoso Universal Server for Linux with Mono Hosting</listitem>
     </itemizedlist></listitem>
<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-5a">
    <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_dom.cs is an HttpWebRequest SOAP client using DOM to process SOAP result.</listitem>
      <listitem>The redcoalsms_dom.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>
      <listitem>This service is compatible with Mono (http://go-mono.com)</listitem>
    </itemizedlist> 
    </refsect1>
</refentry>
