How to work with includes

How do one work with includes? I've seen a script which were using .inc files but even if I include them I wouldn't know what is in these libraries.

Is this documented somewhere? Or is there a way to read these files?

 

Thanks!


KaplanA - Fri Jun 29 09:50:53 EDT 2018

Re: How to work with includes
Mike.Scharnow - Fri Jun 29 10:03:56 EDT 2018

// code line A

#include <path/to/file>

// code line B

 

is not much more than asking the DXL preprocesser to include the contents of the file between lines A and B. So, if you have functions that you include in many DXL files and that you want to maintain centrally, create a file e.g. lib/myCompany/myCoolFunctions.inc and put your code there. So, in essence, the include file contains regular DXL code

- If the path to the include file is not absolute, there are some places where the preprocessor looks for the file, read the forum posts , look for key words like DOORSADDINS, this has been discussed lots of times here.

- it is possible to encrypt DXL code, if you want to deploy code to your customer and do not want to show him your code. The #include directive will decrypt the code. So, when you look at the include files inside your DOORSHOME directory, you will see some readable include files and some that look like binary files.

Re: How to work with includes
KaplanA - Fri Jun 29 10:10:32 EDT 2018

Mike.Scharnow - Fri Jun 29 10:03:56 EDT 2018

// code line A

#include <path/to/file>

// code line B

 

is not much more than asking the DXL preprocesser to include the contents of the file between lines A and B. So, if you have functions that you include in many DXL files and that you want to maintain centrally, create a file e.g. lib/myCompany/myCoolFunctions.inc and put your code there. So, in essence, the include file contains regular DXL code

- If the path to the include file is not absolute, there are some places where the preprocessor looks for the file, read the forum posts , look for key words like DOORSADDINS, this has been discussed lots of times here.

- it is possible to encrypt DXL code, if you want to deploy code to your customer and do not want to show him your code. The #include directive will decrypt the code. So, when you look at the include files inside your DOORSHOME directory, you will see some readable include files and some that look like binary files.

So is there a way to decrypt an existing include file to make it readable for me?

Re: How to work with includes
Mike.Scharnow - Fri Jun 29 12:31:39 EDT 2018

KaplanA - Fri Jun 29 10:10:32 EDT 2018

So is there a way to decrypt an existing include file to make it readable for me?

Well, feel free to analyze the encrypted files, but beware that such a decrypter would probably be illegal under German laws. Besides, if it were easy to decrypt these files, IBM would have made a bad job. After all, the encryption mechanism has been created to secure intellectual property rights.