SQLTrans Module - Feb 99 - by Christophe LOREK
--------------------------------------------

The function of this module is to provide a way of committing a bundle of SQL 
requests to an SQL Database. If no error happens during the transaction, the
modifications will be committed, otherwise a rollback will occur, therefore 
keeping the integrity of the SQL database.

The parameters necessary to access the Database must be provided in the 
editor interface (DMI). The required parameters are :
   Database name : the name of the Database defined in ODBC.
   Login         : The name of the user to access the database, if omitted,
                   "Admin" is used by default.
   Password      : the password corresponding to the Login, "" by default.

------------------------------------------------------------------------------

Actions :
- Transaction : this action expects to receive a list of requests and their 
                parameters. the transaction must be specified as in the 
                following example.                  
		  _DMSevent this cli "callSQL1" 
		    strbuild 
		     ((linebuild "UPDATE User SET Tel=? WHERE Login=?;"::nil)::
		      (linebuild "SQL_INTEGER"::"10"::nil)                   ::
		      (linebuild "SQL_CHAR"::"Boris"::nil)                   ::
		      nil)::
		     ((linebuild "UPDATE User SET Tel=? WHERE Login=?;"::nil)::
		      (linebuild "SQL_INTEGER"::"10"::nil)                   ::
		      (linebuild "SQL_CHAR"::"Catherine"::nil)               ::
		      nil)::
		     ((linebuild "UPDATE User SET Tel=? WHERE Login=?;"::nil)::
		      (linebuild "SQL_INTEGER"::"10"::nil)                   ::
		      (linebuild "SQL_CHAR"::"Christophe"::nil)              ::
		      nil)::nil 
		   nil;
		  0     
------------------------------------------------------------------------------

Events :
- log        : Server status of the request.

------------------------------------------------------------------------------
Result of the SQL request :

Returned SqlCod :
 The SqlCod giving the status of the SQL transaction (SQL_SUCCESS, SQL_ERROR)
 will be sent to the action of the calling module (DMI) specified in the reply.
 it's a string containing an integer.
