ATELICMODE

Added November 2010

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