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 upper byte(s) contain one or more bit flags from the ATELF_xxx table below, and the bottom eight bits of the value will match one of the LICF_xxx values below.
Symbol |
Value |
Description* |
---|---|---|
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.) |
Definition file: ashell.def |
Symbol |
Value |
Description* |
---|---|---|
LICF_NORMAL |
0 |
normal (licensed mode) |
LICF_DEMO |
1 |
demo mode |
LICF_BADKEY |
2 |
bad key |
LICF_BADCO |
3 |
bad company name |
LICF_NONODE |
4 |
no nodes |
LICF_PSHELL |
5 |
PolyShell not licensed |
LICF_BADOS |
6 |
license for other (wrong) operating system |
LICF_EXPIRED |
7 |
maintenance expiration |
LICF_EXPEXE |
8 |
run-time expiration |
LICF_OLDKEY |
9 |
old (and invalid) key format |
LICF_ATSD |
10 |
ATSD not licensed |
LICF_SUPPORT |
11 |
support use only |
LICF_BADMAC |
12 |
bad MAC address |
LICF_SERIAL |
13 |
invalid serial number |
Definition file: ashell.def |
History
2009 October, A-Shell 1164: Function added to A-Shell