Name

run_executable — spawn an external program and return its exit status

Synopsis

integer run_executable( in command varchar,
  in argv any,
  in env any);
 

Description

run_executable spawns an external program identified by command with the supplied argument vector argv and optional environment vector env. Returns the child's exit status. Requires DBA privileges; non-DBA callers raise SQL state 42000. The function is intended for administrative use (backup orchestration, OS tooling); never invoke it with unsanitised user input.

Parameters

command

Path or name of the executable to run.

argv

Optional argument vector passed to the child process.

env

Optional environment vector for the child process.

Return Types

An integer exit status from the child process.


© 1992 - OpenLink Software. All rights reserved.

Making Technology Work for You®