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:
Symbol |
Value |
Meaning |
---|---|---|
ATELF_PROTO |
&h0100 |
ATE handshake was initiated, and also that the ATE client is at least 5.1.1164.0. (Prior to that, command TAB(-10,AG_GETENV);"ATELICMODE";chr(127) will return an empty string. |
ATELF_PC |
&h0200 |
ATE client has a local license. |
ATELF_SRV1 |
&h0400 |
The server attempted to pass the ATE license via the new streamlined protocol (1162+) |
ATELF_SRV2 |
&h0800 |
The server attempted to pass the ATE license via the LICENS/ATESRV mechanism. This also implies that the server is less than 5.1.1162.0 and/or that the passed license wasn't valid (in which case the lower byte should be <>0). |
ATELF_AUX |
&h1000 |
The server attempted to pass an auxiliary license to the client. (Will always be combined with ATELF_SRV2.) |
History
2009 October, A-Shell 1164: Function added to A-Shell