Embedded Licensing

An embedded license allows your application to run without an IDL license. It can be distributed to multiple users and will run on any system supported by IDL. Licensing an IDL application with an embedded license is the simplest form of licensing.

Note
It is beyond the scope of this manual to discuss the creation of Callable IDL applications. See Callable IDL (External Development Guide) for details.

In order to create applications with embedded licenses, you must purchase a special IDL Developer's Kit license from ITT Visual Information Solutions. If you specify that you will be distributing a Callable IDL application when you purchase your Developer's Kit license, ITT Visual Information Solutions will provide you with a license string and some initialization code to be embedded into your application code before the application's initial call to IDL.

Obtaining Your Licensing Information

Contact ITT Visual Information Solutions for your license information. You will need to provide the following information:

The license installation number for your embedded license. Note that this number is different from the installation number for IDL itself.

Your company name.

Application title (e.g., My App).

Name of the application executable (e.g., myapp).

IDL interface being called (Callable IDL).

Calling program language (e.g., VB, C++, C, Fortran).

You will receive a text file containing a function that IDL uses to retrieve the licensing information.

Modifying Your Application Code

After you receive your license information, make the following changes to your application code, in the module from which you are initializing IDL. These instructions assume your code is written in C.

Define the licensing information for your application. Although your licensing information is individualized, it will resemble the following:

/* Callable Application license for: myapp, My App */   
/* License built for IDL Version 7.1 */   
static char *initStr[] = {   
   "12345678abcdabcd", 
   "12345678abcdabcd", 
   "12345678abcdabcd", 
   "12345678abcdabcd", 
   "12345678abcdabcd", 
   "" };

Allocate the following structure in the callable application.:

IDL_INIT_DATA init_data;

Initialize the structure in the callable application before IDL initialization:

init_data.applic = initStr; 
init_data.options |= IDL_INIT_APPLIC;

Initialize IDL with the following statement (all platforms):

if (!IDL_Initialize(&init_data))
   return(FALSE);