[Enterprise Extensions only]

IDL-to-Java: Specifying alternative locations for include files

If My.idl included another IDL file, MyOther.idl, the compiler assumes that MyOther.idl resides in the local directory. If it resides in directory /includes, for example, you would invoke the compiler with the following command:

idlj -i /includes My.idl

If My.idl also included Another.idl that resided in /moreIncludes, then you would invoke the compiler as:

idlj -i /includes -i /moreIncludes My.idl

You can begin to see that if you have a number of places where included files can come from, the command will become long and unmanageable. So there is another means of indicating to the compiler where to search for included files. This technique is very similar to the idea of an environment variable. You must create a file called idl.config in a directory that is listed in your CLASSPATH. Inside of idl.config you must provide a line of the following form:

includes=/includes;/moreIncludes

The compiler take the first version of the file it locates and read in its includes list. Notice that in this example, the separator character between the two directories is a semicolon (;). This separator character is platform-dependent. The separator character is a semicolon (;) on Windows NT, and it is a colon (:) on AIX.

Note: Some platforms will fail when issuing a long command line. If the command line to invoke the compiler becomes too long, use the idl.config file.