<< ibec_url_DownloadToVar | IBEBlock | ibec_ExecScript >>

ibec_Exec

Syntax

     function ibec_Exec(CommandLine : string; Options : string;
     CallbackBlock : string) : variant;

Description

The ibec_Exec function runs the specified application.

Parameters

CommandLineThe command line (filename plus optional parameters) for the application to be executed.
OptionsString containing additional options delimited with semicolon; possible options are:
OutFile=<file_name>Name of the file where the output of the application will be stored.
ConvertToANSIIf specified, the output will be translated from the OEM-defined character set into an ANSI string.
CallbackBlockA callback IBEBlock which will be executed for each output line. The callback IBEBlock must have at least one input parameter, which will be used to pass an output line within it. If there is no callback block use NULL or an empty string as a value of this parameter.
NoWaitImplemented in IBExpert version 2016.11.11. If specified, the callback block and the OutFile option will be ignored. ibec_Exec with the NoWait option just starts the process and returns immediately.
ShowWindow/HideWindowImplemented in IBExpert version 2016.11.11. By default the ibec_Exec function creates the process with a hidden window, if the NoWait option is not specified. Use the ShowWindow option if you don't need to hide the process window.

Example

The following example uses the ibec_Exec function to restore a database from a backup copy using GBAK.EXE:

     execute ibeblock
     as
     begin

       cbb = 'execute ibeblock (LogStr variant)
              as
              begin
                ibec_Progress(LogStr);
              end';

       res = ibec_Exec('C:\Program Files\Firebird\Bin\gbak.exe
                          -r -v -rep -user SYSDBA -pas masterkey
                          E:\test_db.fbk E:\test_db.fdb',
                       'OutFile=E:\Restore.log; ConvertToANSI',  cbb);

       if (res = 0) then
         ibec_ShowMessage('Restore process completed successfully');
       else
         ibec_ShowMessage('Restore process failed with exit code = '||res);
     end

back to top of page
<< ibec_url_DownloadToVar | IBEBlock | ibec_ExecScript >>