Retaining An Execute License During A NX Session
History
The original release for the UGII_UGOPEN_SESSION variable was in V14.0.
A environment variable, UGII_UGOPEN_SESSION, enables a user to retain
the Open C API (User Function) execute license for an entire NX
session for both Internal and External mode Open C API programs.
You can find this variable in the .ugii_env (Linux) file or the ugii_env.dat
(Windows) file.
You set the UGII_UGOPEN_SESSION to true (lower case only) to
enable the ability to check out an Open C API execute license for the duration
of a NX session. Use the following statement to set this environment
variable:
UGII_UGOPEN_SESSION=true
You must set this variable before you start your NX session
or external Open C API program. You check out an execute license when
you call the UF_initialize function. The license is not returned
to ACS (Access Control System) until the NX session terminates.
Once you have already set this variable, you can turn the environment
variable off by setting its value to false or any value other than
true. If you change this variable during a NX session it
has no effect on that session.
You set the environment variable before you check out an Open C
API execute license.
Setting the variable prevents the problem of prematurely returning an
execute license when it is still required. For example, a workstation (with
only a single execute license available to it) checks out an Open C API
execute license and registers a callback function (e.g. UF_UNDO_register_misc_cb).
While waiting for the callback to occur, this workstation returns the license
to ACS with a call to UF_terminate and someone else checks out the
license (making it unavailable). When the callback occurs the license is
not available since it is in use by another user.