FLEXLM_DIAGNOSTICS is an environment variable that will cause the application to produce diagnostic information when a checkout is denied. The format of the diagnostic information may change over time.

To set FLEXLM_DIAGNOSTICS, on Linux:

 

csh:% setenv FLEXLM_DIAGNOSTICS 1 
sh:$ FLEXLM_DIAGNOSTICS=1; export FLEXLM_DIAGNOSTICS

 

On Windows, go to the System Control Panel applet to change the global environment, adding FLEXLM_DIAGNOSTICS to 1.

On Linux, the diagnostic output goes to stderr.

On Windows, the output is a file in the current directory called 'flexnnn.log', where nnn is the application's process ID.


The output file is called 'flex_err.log'.

FLEXLM_DIAGNOSTICS - Level 1 Content

If FLEXLM_DIAGNOSTICS is set to 1, then the standard FLEXlm error message will be presented, plus a complete list of license files that the application tried to use. For example:

 

% setenv FLEXLM_DIAGNOSTICS 1
FLEXlm checkout error: Cannot find license file (-1,73:2) 
No such file or directory license file(s): 
/usr/myproduct/licenses/testing.dat license.dat

 

FLEXLM_DIAGNOSTICS - Level 2 Content

If FLEXLM_DIAGNOSTICS is set to 2, then, in addition to level 1 output, the checkout arguments are presented. For example:

 

% setenv FLEXLM_DIAGNOSTICS 2FLEXlm checkout error: 
No such feature exists (-5,116:2) No such file or directory license file(s): 
/usr/myproduct/licenses/testing.dat license.dat
lm_checkout("f1", 1.0, 1, 0x0, ..., 0x4000)

 

Note that the error message actually contains 2 separate problems, which both occurred during the checkout: there's no such feature in the license it did find, and it was unable to find the other license file, which is what produces the message 'No such file or directory'.

Following is a description of the arguments to lm_checkout()

lm_checkout(feature_name, version, nlic, queue_flag, ..., dupgroup_mask)

feature_name:

  • the requested feature

version:

  • requested version. The license file must contain a version >= the requested version.

nlic:

  • number of licenses requested. Usually 1.

queue_flag:

  • If 0, no queueing If 1, queue for license (`blocking' queue) If 2, queue for licenses, but return to application (`non-blocking' queue)

dupgroup_mask

  • Indicates duplicate grouping, also called license sharing. User, host and display are as shown by lmstat -a.

FLEXLM_DIAGNOSTICS - Level 3 Content

If FLEXLM_DIAGNOSTICS is set to 3, then, in addition to level 1 and 2 output, if a checkout is successful, information is printed explaining how the license was granted:

 

% setenv FLEXLM_DIAGNOSTICS 3

 

application1

 

Checkout succeeded: f0/14263EAEA8E0 
License file: ./servtest.lic
No server used

 

application2

 

Checkout succeeded: f1/BC64A7B120AE
License file: @localhost
License Server: @localhost

 

application3

 

Checkout succeeded: f1/BC64A7B120AE
License file: servtest.lic
License Server: @speedy

 

Note that the feature name and license key are printed, along with the license file location (or hostname if @host were used) and hostname of the server, where applicable.