***       . ***

-------------------------------------------------------------------
Name: 		cstConnections
BaseClass:	Custiom
Description:       ODBC DSN.
Note:		   .  
			 - - .
-------------------------------------------------------------------

	  :
-      ODBC  (DSN).
-      DSN.
-   DSN    .
-      AcivateDSN(), 
      DSN,    , 
      "ActiveDSN"*,    
    .         
   **. 
-       AfterConnect(),
         .
-  DSN   "ActiveDSN"*   , 
   SQLGETPROP() | SQLSETPROP().   , 
      .
-   ()    DeactivateDSN()
         **  DSN, 
      "ActiveDSN"*.    (   )
     DSN   "ActiveDSN"*.
-         .
-     BeforeDisconnect(),
         .
-  ODBC    ERROR().
-   ERROR() cMethod="ODBC error" ( ODBC ).
----------------------------------------------------------
  * "ActiveDSN" -  , ,    
     -  (  ).
         .
	  **  DSN -    ,  
    DSN,    .
----------------------------------------------------------
		 :
	:
	-------
Log  ActivateDSN( cDsnName | nDsnIndex ) -   DSN
	    "ActiveDSN".    
	   .
Void AfterConnect( cDsnname ) - ,    .
Log  DeactivateDSN( cDsnName | nDsnIndex ) -   DSN.
 	       .
Void BeforeDisconnect( cDsnName, nConnectionTime ) - ,  
	 . 
		nConnectionTime - ,     (  )
Log  GetDsnArray( @aDsnList ) -      
	DSN,   . 
		aDsnList[ i, 1 ] -  DSN
		aDsnList[ i, 2 ] -   DSN
Char GetDsnDriver( cDsnName | nDsnIndex ) -     DSN.
Int  GetDsnIndex( cDsnName ) -    DSN.
Void Release() -  .

	:
	---------
Char ActiveDSNname (RO) -  DSN,   "ActiveDSN"
Char ActiveDSNdriver (RO) -   DSN,   "ActiveDSN"
Int  ActiveDSNhandle (RO) -    DSN,   "ActiveDSN"
Int  ActiveDSNindex (RO) -  DSN,   "ActiveDSN"
Num  ActiveDSNconTime (RO) -    DSN,   "ActiveDSN" (.  )
Char ErrorMessage (RO) -    e ( ODBC )
Char OdbcErrorMessage (RO) - ODBC    e ( ODBC )
Int  OdbcErrorNumber (RO) -  ODBC 

--- SQLGETPROP() | SQLSETPROP()  ---
Log  Asyncronous (R/W) -    
Log  Batchmode (R/W)-    SQL    (SQLMORERESULTS())
Log  Connectbusy (RO) -   
Char Connectstring (RO) -   
Int  Connecttimeout (R/W) -   
Char Datasource (RO) -    ODBC.ini
Log  Displogin (R/W) -    
Log  Dispwarnings (R/W) -    ODBC 
Int  Idletimeout (R/W) -   ()
Int  ODBChdbc (RO) -  
Int  ODBChstmt (RO) -   
Int  Packetsize (R/W) -    ()
Char Password (RO) - ,  
Int  Querytimeout (R/W) -      ()
Int  Transactions (R/W) -  
Char Userid (RO) -  ,  
Int  Waittime (R/W) - ,   VFP     ()

-----------------------------------------------------------------------------------------
Name:		cstSqlPassTrought
Baseclass:	Custom
Description:    SQL pass-trought +  
Note:		,   , ..  ,    .
			  MS SQL Server 7.    ()  
			 ExecScriptAsSP( ) -     T-SQL.
-----------------------------------------------------------------------------------------

	  :
-   SQL pass-trought ,   ;
-   ODBC  (  THIS.Error());
-     (txt    SQL );
-    ,   : 
	-     ,      
	-  ;
	-  
-      -   , 
        (  ).
          
     .
-   ,      SQL   ;
-          .

	 
	:
	-------
Void AfterExec() - ,      ;
Log  Cancel() -    ( . ) (SQLCANCEL());
Log  Commit() -   (SQLCOMMIT());
Char CreateParmString( @aParms ) -  	  ( )
      .     THIS.DblQuote ;
Int  Exec( [ cSqlCommand ], [ cCursorName ]) -  SQL  (SQLEXEC()).
        ,   THIS.SqlCommand  THIS.CursorName,
       ,      -;
Int  ExecScript( cFileName ) -   ( SQL );
Int  ExecScriptAsSP( cFileName ) -  ,   ;
Int  ExecSp( cSpName, [ @aParameters ] ) -  .   
      THIS.CursorName;
Char GenSpName() -    ;
Log  GetTables( [ cCursorName ] ) -      .
         (SQLTABLES()).    ,  
      THIS.CursorName,   ,    
      - THIS.CursorName,   THIS.SqlCommand = "";
Log  GetViews( [ cCursorName ] ) -      
         (SQLTABLES()).    ,  
      THIS.CursorName,   ,    
      - THIS.CursorName,   THIS.SqlCommand = "";
Log  MoreResults() -       (SQLMORERESULTS());
Void Release() -  ;
Log  Rollback() -   (SQLROLLBACK()).
----------------------------------------------------------------------------------------
1. Exec*()  Get*()   - THIS.SqlCommand  THIS.CursorName, 
  , ..      ,  
 .
2. Exec*()     ,  
 THIS.Exec().
----------------------------------------------------------------------------------------
	:
	---------
Int  ConHandle (R/W) -  ODBC ;
Char CursorName (R/W) -    ;
Log  DblQuote (R/W) -       
       THIS.CreateParmString();
Char ErrorMessage (RO) -   ;
Char OdbcErrorMessage (RO) - ODBC   ;
Int  OdbcErrorNumber (RO) -  ODBC ;
Char SqlCommand (R/W) -  SQL ,  THIS.Exec().
