IRISLIB database
Manager Class Reference

Static Public Member Functions

_.Library.Status Import (_.Library.String pDialect, _.Library.RawString pInputFile, _.Library.RawString pLogFile, _.Library.Integer pRunMode, _.Library.Integer pErrorPause, _.Library.RawString pQSpec)
 Import a file of TSQL statement batches. More...
 
_.Library.Status interactive (_.Library.RawString DDLMode, _.Library.RawString logFile, _.Library.Integer runtimeMode, _.Library.RawString qspec)
 interactive() More...
 
_.Library.Status load (_.Library.RawString DDLMode, _.Library.RawString scriptFile, _.Library.RawString logFile, _.Library.Integer runtimeMode, _.Library.RawString qspec)
 load() More...
 

Detailed Description

TSQL.Manager is deprecated. Use $system.SQL.TSQL(), $system.SQL.Shell() with dialect set to either Sybase or MSSQL, or $system.SQL.DDLImport() instead. The simplest method for importing a file containing T/SQL statements is to use the SQL Shell with the dialect set to Sybase or MSSQL. $system.SQL.TSQL() is a simple shortcut to launch the SQL shell using the default dialect as defined in the system configuration. In the SQL Shell simply execute the RUN command with the name of the file to be executed. This will initiate a dialog to set various RUN options and then the statements in the file will be executed.

TSQL.Manager implements several utility methods for importing and executing files/streams containing TSQL statements.

Member Function Documentation

◆ Import()

_.Library.Status Import ( _.Library.String  pDialect,
_.Library.RawString  pInputFile,
_.Library.RawString  pLogFile,
_.Library.Integer  pRunMode,
_.Library.Integer  pErrorPause,
_.Library.RawString  pQSpec 
)
static

Import a file of TSQL statement batches.

TSQL.Manager is deprecated. Use $system.SQL.TSQL(), $system.SQL.Shell() with dialect set to either Sybase or MSSQL, or $system.SQL.DDLImport() instead. The simplest method for importing a file containing T/SQL statements is to use the SQL Shell with the dialect set to Sybase or MSSQL. $system.SQL.TSQL() is a simple shortcut to launch the SQL shell using the default dialect as defined in the system configuration. In the SQL Shell simply execute the RUN command with the name of the file to be executed. This will initiate a dialog to set various RUN options and then the statements in the file will be executed.

TSQL.Manager implements several utility methods for importing and executing files/streams containing TSQL statements.

This should be called 'Load' but for PPCF we need to maintain the 'load' method interface and 'Load' is a name conflict.

Parameters:

pDialect - The dialect of TSQL contained in the input file. Values are MSSQL or Sybase, Sybase is the default; pInputFile - The name of the TSQL source file; pLogFile - The name of the log file. Input source statements and the result of execution are logged; pRunMode - The SQL Statement runtime mode; 0 - Logical (default) 1 - ODBC 2 - Display pErrorPause - The number of seconds to pause after encountering an error. Not all errors will pause. Default is 5 seconds. Specifying 0 will disable all pauses. pQSpec - Runtime options and flags. The only option relevant to TSQL import is 'displaylog'. If it is false, no logging will be done.

◆ interactive()

_.Library.Status interactive ( _.Library.RawString  DDLMode,
_.Library.RawString  logFile,
_.Library.Integer  runtimeMode,
_.Library.RawString  qspec 
)
static

interactive()

        DDLMode     - The dialect of the source statements. Supported dialects are Sybase and MSSQL
        logFile     - the name of a file to send log output to
        runtimeMode - the mode in which SQL statements are to be executed. "" means use the default, 0 is logical, 1 is ODBC and 2 is DISPLAY
        qspec       - flags and options. If displayLog is true then all output is routed to logFile.

    This method reads source from the principle device. Execution of individual batches of statements
    is triggered when a "GO" statement is processed. CREATE PROCEDURE|FUNCTION|TRIGGER will also trigger execution of previously entered lines.

◆ load()

_.Library.Status load ( _.Library.RawString  DDLMode,
_.Library.RawString  scriptFile,
_.Library.RawString  logFile,
_.Library.Integer  runtimeMode,
_.Library.RawString  qspec 
)
static

load()

        This method loads and executes TSQL statements from a file. Execution of individuals batches
        of statements is triggered when a "GO" statement is processed.
arguments:

        DDLMode     - The dialect of the source statements. Supported dialects are Sybase and MSSQL
        scriptFile  - the file containing SQL statements to be executed;
        logFile     - the file to log executed statements and results;
        runtimeMode - the mode in which SQL statements are to be executed. "" means use the default, 0 is logical, 1 is ODBC and 2 is DISPLAY
        qspec       - option flags and qualifiers