Extended TAB function SHLEXEC has been upgraded to support all of the features of MIAMEX,MX_SHELLEX. The main motivation for this is to allow it to be used in place of TAB(-10,AG_WINEXEC) under Vista when the command being launched requires "elevation" to administrator privileges. (AG_WINEXEC will just abort with a "requires elevation" dialog in such a case, whereas AG_SHELLEX will prompt the user for permission.)
New syntax:
? TAB(-10,AG_SHLEXEC); spec$;","; action$;","; parms$;","; dir$;","; showflags;","; waitflag;chr(127);
All arguments are optional except spec$. parms$, dir$, showflags and waitflag are new, and correspond to the arguments of the same names in xcall MIAMEX,MX_SHELLEX. (Except waitflag, which is totally new; if non-zero, it causes A-Shell (or ATE) to wait for the launched program to exit before returning to the application. (This is needed in order to emulate the default behavior for HOSTEX.SBR and AG_WINEXEC).
Note that although AG_SHLEXEC was traditionally used with a spec$ indicating some kind of object other than an executable (e.g. a URL, or a DOC file), it may also contain an ordinary executable spec. In comparison to AG_WINEXEC, which puts the entire command line in a single argument, AG_SHLEXEC puts just the executable spec in the spec$ parameter, and the remainder of the command line, if any, in the parms$ argument.