dosexecve

Purpose

     Executes a program with a DOS path name.

Library

     DOS Services Library (libdos.a)

Syntax

     #include <dos.h>

     int dosexecve (path, argv, envp)
     char *path, *argv[ ], *envp[ ];

Description

     The  dosexecve   subroutine  invokes   an  AIX-executable
     program  identified by  a DOS  path name.   The dosexecve
     subroutine corresponds  to the execve system  call except
     that the  path parameter  is interpreted with  respect to
     the configured DOS file system.

     The path parameter must  identify an AIX-executable file.
     It  cannot refer  to a  DOS-executable file,  such as  an
     .EXE,  .COM,  or .BAT  file.   See  the instructions  for
     running a .BAT file.

     The  new  program  started by  the  dosexecve  subroutine
     inherits the AIX run-time environment, which includes the
     AIX open  file descriptors  and other  information.  (See
     "fork" and "exec:  execl,  execv, execle, execve, execlp,
     execvp" for a complete description of the AIX environment
     that is inherited after these system calls.)

     However, the  new program does not  automatically inherit
     the DOS Services environment.  See "dosunopen, dosreopen"
     for details about passing the DOS Services environment to
     a child process.

Return Value

     Upon successful completion, a value of 0 is returned.  If
     the dosexecve subroutine fails, a value of -1 is returned
     and doserrno is set to indicate the error.

Related Information

     In  this  book:    "DOS  services  library,"  "dosinit,"
     "dosunopen,  dosreopen,"  "exec:  execl,  execv,  execle,
     execve, execlp, execvp,"  "fork," and  "wait."