A-Shell Reference

2006 October, A-Shell 4.9.969:  Two new macros have been added:

TAB(-10,AG_WINEXEC);"$COPY ";src$;" ";dst$;"~";flags;chr(127);

TAB(-10,AG_WINEXEC);"$MOVE ";src$;" ";dst$;"~";flags;chr(127);

These macros provide a clean way to move or copy a file. They are both equivalent to the MX_COPYFILE function and they share the same flags (0=copy, +1=move, +2=overwrite existing destination). The only difference between $MOVE and $COPY is in how the flags argument is defaulted if not specified. Note that this is a deviation from the usual behavior where an omitted numeric argument is equivalent to an explicit zero. In this case, specifying a flags value of 0 or 2 would override $MOVE, converting it to $COPY.

2005 May, A-Shell 4.9.932: AG_WINEXEC now supports a new macro $DEL to delete a file. For example:

? TAB(-10,AG_WINEXEC);"$DEL %ATELOCALDIR%\myfile.dat";chr(127);

input "",A

This would delete myfile.dat from the directory specified by the environment variable ATELOCALDIR (which is set by ATE to point to its FTP Local Directory). The return code is CR for success or ^C for failure. Note that a non-existent file is treated as success, so the only error would be if the file existed but could not be deleted.

2005 April, A-Shell 4.9.926:  A special symbol, "$ATE", may now be used with AG_WINEXEC to make it easier to launch another ATE session. For example:

? TAB(-10,AG_WINEXEC);"$ATE";chr(127);

? TAB(-10,AG_WINEXEC);"$ATE ";cmdlin;chr(127);

The first example above ($ATE with no other argument) launches another ATE connection to the current server using the current profile, without suspending the current connection.

The second example ($ATE following by additional arguments) launches another A-Shell/Windows session on the local ATE client and passes it the command line cmdlin. You could use this format to launch a connection to some other server, assuming you knew the profile name, for example:

? TAB(-10,AG_WINEXEC);"$ATE telnet ";CFG$;chr(127);

Since ATE connections are established with the telnet command, the above command would launch a new ATE connection using the profile CFG$. Note that by default, AG_WINEXEC suspends the current session until the child session completes. If you don't want that, you must append the special suffix characters used by HOSTEX.SBR. For example, to not suspend the current session, the above command could be amended to add " $", i.e.:

? TAB(-10,AG_WINEXEC);"$ATE telnet ";CFG$;" $";chr(127);

Or you could execute any valid A-Shell command in the child session, for example:

? TAB(-10,AG_WINEXEC);"$ATE VUE %MIAMEFILE%";chr(127);

This would launch VUE to edit ATE's copy of miame.ini. Or:

? TAB(-10,AG_WINEXEC);"$ATE VUE %MIAME%\ashlog.log";chr(127);

The above command would VUE ATE's log file.