A-Shell Reference

? tab(-10, AG_GETENV);"var,1"; chr(127);

AG_GETENV (45) will return (in the keyboard buffer) the definition of the specified environment variable as defined to the ATE client (or A-Shell/Windows).

This function has both a subroutine and a print tab implementation.

In addition to the proper environment variables, the command will also recognize two special ones that are only understood by this command within the ATE client: %ATEEXE% (the full filespec of the client executable, e.g. c:\Program Files\MicroSabio\ATE\bin\ashw32.exe) and %ATEVER% (the version string for the client executable, e.g. "4.9(930)-1").

If the ",1" is appended to the environment variable name, as shown above, then the result will be "de-mangled" (i.e. converted from the DOS 8.3 compressed format to the full long format), if possible. For example:

? TAB(-10,AG_GETENV);"TEMP",chr(127);

The above command (without the ,1) might return something like:

C:\DOCUME~1\yourname\LOCALS~1\Temp

Using the new syntax, with the,1, the command:

? TAB(-10,AG_GETENV);"TEMP,1",chr(127);

might return something like:

C:\DOCUMENTS AND SETTINGS\yourname\LOCAL SETTINGS\Temp

See Also

History

2009 October, A-Shell 5.1.1163:  The pseudo-environment variable ATELICMODE is supported in AG_GETENV to return a single decimal value containing flags indicating how the ATE workstation was licensed. The bottom 8 bits of the value are 0 if successfully licensed, else one of the LICF_xxx flags from ASHINC:ASHELL.DEF. The next byte(s) contain one or more bit flags from ATELF_xxx: